Sierra Wireless RavenXTV Instruction Manual

RavenXTV CDMA
Sierra Wireless Cellular Modem
Revision: 9/11
Copyright © 2006-2011
Campbell Scientific, Inc.
Warranty
Assistance
Products may not be returned without prior authorization. The following contact information is for US and International customers residing in countries served by Campbell Scientific, Inc. directly. Affiliate companies handle repairs for customers within their territories. Please visit
www.campbellsci.com to determine which Campbell Scientific company serves
your country.
To obtain a Returned Materials Authorization (RMA), contact CAMPBELL SCIENTIFIC, INC., phone (435) 227-2342. After an applications engineer determines the nature of the problem, an RMA number will be issued. Please write this number clearly on the outside of the shipping container. Campbell Scientific's shipping address is:
CAMPBELL SCIENTIFIC, INC. RMA#_____ 815 West 1800 North Logan, Utah 84321-1784
For all returns, the customer must fill out a "Statement of Product Cleanliness and Decontamination" form and comply with the requirements specified in it. The form is available from our web site at www.campbellsci.com/repair. A completed form must be either emailed to repair@campbellsci.com or faxed to 435-227-9579. Campbell Scientific is unable to process any returns until we receive this form. If the form is not received within three days of product receipt or is incomplete, the product will be returned to the customer at the customer's expense. Campbell Scientific reserves the right to refuse service on products that were exposed to contaminants that may cause health or safety concerns for our employees.
RavenXTV Table of Contents
PDF viewers note: These page numbers refer to the printed version of this document. Use the Adobe Acrobat® bookmarks tab for links to specific sections.
1. General Description.....................................................1
2. Establish Cellular Service...........................................1
2.1 RavenXTV Cellular Coverage/Service Requirements..............................1
3. Specifications ..............................................................2
3.1 RavenXTV Specifications ........................................................................2
4. Configuration ...............................................................2
4.1 Base Station Requirements for RavenXTV..............................................2
4.2 Datalogger Site Equipment.......................................................................3
4.3 Power Considerations ...............................................................................9
4.4 Automatic Provisioning (Activation)........................................................9
5. Program the RavenXTV Modem ...............................10
5.1 Using AceManager to Configure the Modem.........................................11
5.2 Configuring the Raven for Dynamic IP..................................................14
6. LoggerNet/PC400 Software Setup............................ 15
7. Troubleshooting ........................................................18
Appendices
A. AceManager Setup without Template File ............ A-1
B. Configuring the Raven Modem for PPP ................ B-1
C. EmailSend Using the Gmail Outgoing SMTP
Server .................................................................... C-1
C.1 Setting up a Gmail Account .................................................................C-1
C.2 Sending to Multiple Addresses ............................................................C-1
C.3 Sending a Text Message to a Phone.....................................................C-1
i
RavenXTV Table of Contents
Figures
4.2-1. Modem Interface Options................................................................. 4-6
4.2-2. Antennas for Use with the Raven Modems ......................................... 8
7-1. Device Port Configuration.................................................................... 20
7-2. AceManager status page showing communications with modem ........ 22
ii
RavenXTV CDMA Sierra Wireless Cellular Modem
1. General Description
This manual provides information for interfacing the Sierra Wireless RavenXTV cellular modem to Campbell Scientific dataloggers. A Sierra Wireless CD ships with the modem that includes Sierra Wireless manuals and software utilities. Sierra Wireless manuals referenced in this manual include:
AceManagerGuide.pdf Raven_XT_UserGuide.pdf Raven_XT_QuickStart.pdf
The RavenXTV digital cellular modem is manufactured by Sierra Wireless for use on the Verizon Wireless Code Division Multiple Access (CDMA)/1xRTT network. The modem is accessed through the Internet using TCP/IP communications protocol using a Static or Dynamic IP address.
A Static IP address is permanently assigned to a particular account and
will always be used whenever the Raven connects to the Internet.
A Dynamic IP address is assigned on a “need to have” basis. A dynamic
IP address is used with a service such as IP Manager (Section 5.2) to translate domain name to a dynamic IP address, so that the Raven can be contacted by name as if it had a static IP.
A Verizon account can be setup for a Static or Dynamic IP address; a Static IP is preferred. Generally, there is a one-time per customer charge to activate a Static IP account. Once activated, additional Static IP accounts may be added at no additional charge.
2. Establish Cellular Service
2.1 RavenXTV Cellular Coverage/Service Requirements
What you need:
Verizon Wireless CDMA/1xRTT/EVDO coverage at the datalogger site. For a coverage map, refer to: www.verizonwireless.com
CDMA/1xRTT/EVDO Static IP or Dynamic IP account established at Verizon Wireless. Verizon’s Broadband Access Plan is recommended. You will need to request ‘unrestricted IP’.
To setup an account you will need the ESN number of the modem. The ESN number is listed on a label on the modem, and also on the box. To setup an account with Verizon Wireless, call:
888-384-1775 for Business Sales 800-256-4646 for Personal Sales
plans / coverage maps.
1
RavenXTV CDMA Sierra Wireless Cellular Modem
What you receive from Verizon:
10-digit Mobile Directory Number (MDN) IP address (for a Static IP account only)
3. Specifications
3.1 RavenXTV Specifications
Sierra Wireless RavenXT, model 2227-V
Technology: CDMA 1xRTT, EVDO Rev. A, CDMA IS-95
Bands: 800 MHz Cellular, 1900 MHz PCS
Transmit Frequency: 1850 to 1910 MHz and 824 to 849 MHz
Transmit Power: 1.0 W for 1900 MHz; 0.8 W for 850 MHz
Receiver Frequency: 1930 to 1990 MHz and 869 to 894 MHz
CDMA Throughput: up to 80 kbps
4. Configuration
RS-232 Data Rates: 1200 bps to 115.2 kbps
Serial Interface: RS-232, DB9-F
Serial Protocols: AT Commands, PPP, SLIP, UDP/IP, TCP/IP
RF Antenna Connector: 50 Ohm SMA (female)
Input Current Range: 50 to 250 mA
Typical Current Drain (at 12 Vdc): 50 mA dormant (idle for 10 to 20 seconds), 120 mA transmit/receive
Input Voltage Range: 6 to 28 Vdc
Operating Temperature Range: -30° to +70°C
Operating Humidity Range: 5% to 95% RH non-condensing
Status LEDs: Power, Network, Signal, Activity
Dimensions: 3”W x 1”D x 4”L (7.6 x 2.5 x 10 cm)
Weight: <1 lb (<0.5 kg)
4.1 Base Station Requirements for RavenXTV
PC running Campbell Scientifics’ LoggerNet or PC400 software, with access to the internet.
2
RavenXTV CDMA Sierra Wireless Cellular Modem
4.2 Datalogger Site Equipment
Raven modem with power cable (included with modem).
Datalogger—21X, CR510, CR10(X), CR23X, CR7, CR1000, CR5000,
CR3000, CR800.
SC105 or SC932A Interface—connects the modem to the 21X, CR510,
CR10(X), CR7, or other dataloggers’ CS I/O port.
The SC105 must be configured for use with the modem using the Device
Configuration Utility. Settings should be:
CS I/O Mode: SDC Address 7 RS-232 Mode: Modem Baud Rate: 115.2K or 9600 baud depending on datalogger model 8 data bits, 1 stop bit, no parity
PN 18663 Null Modem Cable—connects the modem to the CR23X,
CR3000, CR800, CR2XX, CR1000 or CR5000 RS-232 port.
NOTE
If you have a black SC12 cable that is not Rev 1 or newer (as indicated on cable), it is a CS I/O cable only and will not work for RS-232. Connect the black SC12 cable between the datalogger and the SC932A. Use a 9-pin serial cable or a blue ribbon cable between the phone and the SC932A.
3
RavenXTV CDMA Sierra Wireless Cellular Modem
Wiring:
Red 12V (or switched 12V)
Black G
White Not Used
PN 18663
PN 18663 Null Modem Cable—connects the modem to the CR23X, CR3000, CR800, CR2XX, CR1000
or CR5000 RS-232 port
(not compatible with the 21X, CR510, CR10X, or CR7 dataloggers).
4
RavenXTV CDMA Sierra Wireless Cellular Modem
Wiring:
Red 12V (or switched 12V)
Black G
White Not Used
10873 serial cable provided with the SC105
SC105 Settings:
CS I/O Mode: SDC Address 7 RS-232 Mode: Modem Baud Rate: 115.2K or 9600 baud depending on datalogger model 8 data bits, 1 stop bit, no parity
SC105 interface connects the modem to a datalogger’s CS I/O port;
recommended for dataloggers with the PakBus Operating System.
5
RavenXTV CDMA Sierra Wireless Cellular Modem
Wiring:
Red 12V (or switched 12V)
Black G
White Not Used
SC932A interface connects the modem to the CS I/O port;
recommended for dataloggers with the Mixed-Array Operating System.
FIGURE 4.2-1. Modem Interface Options.
6
10873 serial cable provided with the SC932A
RavenXTV CDMA Sierra Wireless Cellular Modem
PN 13494 Raven Mounting Kit—includes mounting hardware for securing
the modem to below referenced environmental enclosure and a 9-pin male to 9-pin female cable.
Antenna—the following antennas are available from Campbell
Scientific. Contact a Campbell Scientific Applications Technician for help in determining the best antenna for your application.
o The 20679 is a dual-band, omnidirectional antenna for our
CDMA and GPRS digital-cellular modems. It covers both the 800-MHz band and the 1.9-GHz band. For the 800-MHz band, the 20679 provides a 0-dBd gain. For the 1.9-GHz band, the 20679 provides a 3-dBd gain. This antenna is recommended for locations where cellular coverage is strong.
The 20679 includes a mount/u-bolt assembly that allows the antenna to be mounted to a mast, crossarm, or user-supplied pole (outer diameter of up to 1.5" (3.8 cm)).
o The 18285 1 dBd omnidirectional antenna. This antenna is dual
band, covering both the 800 MHz and 1.9 GHz bands, and is strongly recommended where cellular coverage is strong. The 18285 includes a mount/u-bolt assembly for attaching the antenna to a mast, post, or crossarm up to 1.5" (3.8 cm) in diameter.
o The 14454 9dBd Yagi Antenna is a higher gain antenna that
should be "aimed" at the service provider's antenna. The 14454 is a 800 MHz antenna and bracket/u-bolt assembly for attaching the antenna to a mast or post. This antenna is recommended for fringe areas that require a higher gain antenna.
o The 21831 Half-Wave Dipole Whip Antenna is a lower gain
antenna used in transmitting short distances. It is an 800 MHz cellular antenna that terminates in a SMA Male connector for attachment to the modem. This antenna is intended for use inside the enclosure. Please note that the backplate of the enclosure is a grounded plane. If it is interposed between the antenna and the cell tower, it may attenuate the strength of the transmission signal. Simply turning the enclosure 90 to 180 degrees on its mounting mast may solve weak transmission issues.
7
RavenXTV CDMA Sierra Wireless Cellular Modem
PN 20679 Omni Directional Antenna
PN 18285 1 dBd Omni Directional Antenna
PN 14454 9dBd Directional Yagi Antenna
PN 21831 Half-Wave Dipole Whip Antenna
8
FIGURE 4.2-2. Antennas for Use with the Raven Modems
RavenXTV CDMA Sierra Wireless Cellular Modem
Power Supply (see power considerations).
Environmental Enclosure— ENC 10/12, ENC 12/14, or ENC 16/18.
4.3 Power Considerations
A power cable included with the modem connects to the datalogger's 12 V
or switched 12 V terminal. Connection to the switched 12 V terminal allows the datalogger to switch power to the modem during scheduled transmission intervals if desired. Connect the red lead wire to 12 V, and the black lead to G (ground). The white wire lead has no function and can be ignored.
When using the switched 12 V terminal, the modem can typically be
powered with a BP12 battery, CH100 charger/regulator, and MSX10 solar panel.
4.4 Automatic Provisioning (Activation)
NOTE
CAUTION
It is recommended that the modem be provisioned and tested in the office (assuming there is cellular coverage) rather than in the field.
One of the special features of your RavenXTV is the ability to activate itself automatically. When you first power on the RavenXTV, it will check to see if it has been activated with account data. If it finds that it has not yet been activated, the RavenXTV will attempt to retrieve the account data from the Verizon network using Over-the-Air Service Provisioning (OTASP).
You need to have an account with Verizon before you attempt automatic activation. If you have not ordered an account from Verizon for your RavenXTV, it will not succeed at activating.
a. Attach the antenna to your RavenXTV.
b. Plug the RavenXTV into power.
c. While the LED lights cycle from the outside to the inside, the RavenXTV
is attempting to download its account information. The download process may take one to two minutes to complete.
CAUTION
Do not move your RavenXTV while it is being programmed.
d. When the Network lights illuminate, your RavenXTV has successfully
completed OTASP and is registered on the Verizon network.
9
RavenXTV CDMA Sierra Wireless Cellular Modem
5. Program the RavenXTV Modem
Use the following software to program the modem for use with your datalogger.
AceManager is used to configure settings in the modem and to load the Campbell Scientific Raven CDMA template file. The AceManager utility is available from Sierra Wireless’s website (www.sierrawireless.com/support The CD that ships with the modem also includes AceManager and Sierra Wireless manuals.
Campbell Scientific’s “Raven CDMA Template 115200” file is for dataloggers that support 115200 baud (e.g. CR1000), the “Raven CDMA Template 9600” file is for dataloggers that support a maximum baud rate of 9600 (e.g. CR10X). The template file configures the modem to be compatible with CSI dataloggers. Template files are available from Campbell Scientific’s Website:
www.campbellsci.com/downloads
Indicator Lights
When your RavenXTV is connected to power and an antenna, there is a specific pattern to the lights to indicate its operation mode.
.
).
Network—Indicates a successful connection to the cellular network with
an IP address given and a channel acquired.
Signal—Light shows the strength of the signal and may be nearly solid
(strong signal) or flashing (weaker signal). A slow flash indicates a very weak signal.
Activity—Lights will flash as data is transferred to and from the PinPoint
modem on the remote network.
Power—Indicates the power adapter is connected and there is power
getting to the RavenXTV.
The Reset button (on the left side of the RavenXTV) has two functions.
If it is quickly depressed and released, the modem will simply power cycle the internal hardware. If, however, the reset is depressed and held for several seconds (count 10 slowly, and wait for the power light to go off after the light pattern stops), the ALEOS configuration settings will return to the factory defaults.
10
RavenXTV CDMA Sierra Wireless Cellular Modem
Light Patterns
The LEDs on the front of the modem will respond in different patterns to indicate modem states.
Normal—Each LED, mentioned above, lit as applicable.
Start up—The LEDs will cycle from left to right.
PassThru mode—Network and Signal LEDs will blink in tandem. The
Activity LED will blink when transmitting or receiving data.
SOS—The Network LED blinks.
Configuration Reset—The LEDs will cycle left to right and then right to
left 4 times.
Authentication Failure—The Network, Signal, and Activity LEDs blink
every 2 seconds.
Data Retry—The Network, Signal, and Activity LEDs blink every 3
seconds.
5.1 Using AceManager to Configure the Modem
After the Raven has been provisioned, certain settings have to be changed for the modem to be compatible with CSI dataloggers. The recommended way to change the settings is to send a template file to the modem using the AceManager utility.
The AceManager utility is on the CD that ships with the Raven modem, and is also available from Sierra Wireless (http://www.sierrawireless.com/support
To install AceManager from the Sierra Wireless CD, click on the “AceManager” link under Modem Utilities and follow the prompts. Once the application has been installed, it can be run from the Windows Start menu, or from the icon on the desktop.
Campbell Scientific’s “Raven CDMA Template 115200” file is for dataloggers
that support 115200 baud (e.g. CR1000), the “Raven CDMA Template 9600” file is for dataloggers that support a maximum baud rate of 9600 (e.g. CR10X). The template file configures the modem to be compatible with CSI dataloggers. Template files are available from Campbell Scientific’s Website:
www.campbellsci.com/downloads
Connect the Raven to a COM port on the PC with a direct RS-232 cable. Also connect the antenna, and 12V power.
.
).
11
RavenXTV CDMA Sierra Wireless Cellular Modem
Run AceManager to get the following screen:
Click the Connect icon in the Configuration Panel to open the connection options dialogue box. Select PPP, and the COM port the modem is connected to. Do not change the Password (the default password is 12345). Click OK to continue.
If the modem has been configured for “PPP” (see appendix B), then you may have to check the “Use SOS Mode” box.
12
RavenXTV CDMA Sierra Wireless Cellular Modem
Click the Load icon in the Configuration Panel. When prompted for a template file name, select ravencdma_115200.xml or ravencdma_9600.xml file (downloaded from the CSI website). The following screens show the settings for the Miscellaneous and Serial settings after the template file has been loaded.
Change “AT Verbose Mode” to “Numeric” for use with CR10(X), CR510, and CR23X dataloggers.
Click the Write icon to save the changes made by the template file
.
Click the Reset icon to restart the modem. The other ways to reset the modem are by pressing the reset button on the front of the modem or removing the power from the modem.
13
RavenXTV CDMA Sierra Wireless Cellular Modem
Click the Disconnect icon to terminate communications with the modem.
WARNING
Unless you Write the commands, the changes made in New Value will not be sent to the modem. For some commands unless you Reset the modem, the newly written values will not take effect.
5.2 Configuring the Raven for Dynamic IP
Dynamic IP addresses are granted only when a modem or other device is connected and can change each time the modem or device reconnects to the network.
IP Manager is a free service provided by Sierra Wireless for the Raven to translate a dynamic IP address into a fully qualified domain name so it can be contacted directly on the Internet. IP Manager translates a dynamic IP address to a fully qualified domain name so you can contact your Raven by name as if it had a static IP.
If the Raven is configured for Dynamic IP, when the Raven first connects to the Internet, it sends an IP change notification to IP Manager. IP Manager will acknowledge the change and update the DNS record. The changed IP address will then be the address for the Raven’s configured name. Once the Raven’s IP has been updated in IP Manager, it can be contacted via name.
AceManager is used to configure the Dynamic IP settings in your Raven so that it will use IP Manager as described below.
Connect with modem using AceManager. Select the Dynamic IP group to configure your modem to use IP Manager.
To configure your Sierra Wireless modem to be addressed by name, the modem needs to have four elements configured.
Enter names in the New Value fields for MODEMNAME, DOMAIN, IPMANAGER1, IPMANAGER2, and IPMGRUPDATE1.
14
RavenXTV CDMA Sierra Wireless Cellular Modem
1. Modem name: A unique name for the modem (the 10-digit MDN number is recommended).
2. Domain: The domain name to be used by the modem (eairlink.com).
3. IP Manager IP Address: The IP or domain name of the dynamic DNS server which is running IP Manager.
IPMANAGER1: edns2.eairlink.com IPMANAGER2: eairlink.com
4. IP Manager update interval: How often you want the address sent to IP Manager. If this is set to zero, the modem will only send an update if the IP changes (i.e. if the modem is reset or is assigned a different IP). The value can be set from 0 - 255 minutes.
Restrictions for Modem Name
Must begin with a letter or number
Can include a hyphen (-)
Cannot contain spaces
Must be no longer than 20 characters total
Click the Write icon to save the changes
Click the Reset icon to restart the modem.
Click the Disconnect icon to terminate communications with the modem.
.
6. LoggerNet/PC400 Software Setup
The Device Map is configured from the “Setup” button on the LoggerNet/PC400 Toolbar. Configure the Device Map as described below.
1. Select Add Root | IPPort.
2. Add a datalogger to the IPPort (PakBus dataloggers, e.g. the CR1000, require a PakBusPort).
3. On the IPPort page, add the IP address/domain name and the Port number (the Raven template file configures the port to be 3001). Add four seconds of extra response time.
4. For PakBus dataloggers, leave the default settings on the PakBusPort page.
5. For PakBus dataloggers, set the PakBus address to match that of the datalogger (default address in the datalogger is 1). Make sure that “PakBus Always Open” is unchecked.
15
RavenXTV CDMA Sierra Wireless Cellular Modem
LoggerNet Device Map
Preceding zeros are not entered in the Internet IP Address (e.g.
070.218.074.247 is entered as 70.218.74.247).
For a Dynamic IP using Sierra Wireless’s IP Manager, enter the internet IP address as:
xxxx.yyyy:3001, where xxxx is the modem name, yyyy is the Domain name, and 3001 is the port number.
16
RavenXTV CDMA Sierra Wireless Cellular Modem
Uncheck “PakBus Port Always Open”.
Enter PakBus address that has been set in the datalogger (default is 1, change the address using DevConfig).
17
RavenXTV CDMA Sierra Wireless Cellular Modem
7. Troubleshooting
If LoggerNet/PC400 software is unable to establish a connection with the modem:
1. Check your account information (you may have to call your provider for this or look at your agreement).
a. Verify there is coverage at your location.
b. Check the Network light. Network – indicates a successful
connection to the cellular network with an IP Address given and a channel acquired.
c. Make sure the modem has sufficient power.
d. Check the signal strength using AceManager (make sure your antenna
is properly connected and oriented). Signal strength should be in the
-51 to -90 range (-51 is a strong signal, -90 is a weak signal).
e. Make sure you have digital (not analog) coverage. For the
RavenXTV this should be a CDMA/1xRTT/EVDO account.
f. If you have a Static IP account, verify the Static IP Address.
Preceding zeros in the IP address are not entered in LoggerNet/PC400.
g. If you have a Dynamic IP account, you will need to have a DDNS
(dynamic domain name server) name that LoggerNet can reference to make the connection (Section 5.2).
h. Connect with the modem through the serial port using AceManager.
If the modem has been configured for “PPP” (see appendix B), then you may have to check the “Use SOS Mode” box.
i. From the “Status” group, make sure the “Network State” is “Network
Ready”, and note the “Network IP” address. This is the current IP address for the modem (a dynamic IP address will change each time the modem is reset). Try connecting to this IP address using LoggerNet. If LoggerNet connects with the IP address, but not with the modem name.domain name, then there may be a problem with the Dynamic IP setup in the modem (Section 5.2).
18
RavenXTV CDMA Sierra Wireless Cellular Modem
Select the “Serial” Group, and make sure the “AT Verbose Mode” is set to “Numeric” for use with the CR10(X), CR510, and CR23X dataloggers, or “Verbose” for other dataloggers (e.g. CR1000).
If the modem answers but you do not get a connection to the datalogger:
1. Check your connection to the datalogger.
a. a. An SC932A or SC105 interface is required to connect the modem
to a datalogger’s CS I/O port (Section 4). The default settings for SC105 (OS > 4) can be used with the RavenXTV when the modem is configured for 115200 baud (baud rate is set by the template file).
19
RavenXTV CDMA Sierra Wireless Cellular Modem
Baud rate of the SC105 must match the baud rate in the modem (which has to be supported by the datalogger). SC105 settings for use with the RavenXT are listed below, which are configured using the DevConfig utility.
SC105 settings for the RavenXT:
CS I/O Mode: SDC Address 7 RS-232 Mode: Modem Baud Rate: 115.2K or 9600 baud depending on datalogger model 8 data bits, 1 stop bit, no parity
b. Make sure the modem is connected to the “DCE Device” connector
on the SC932A, or the “Modem” connector on the SC105.
A null modem cable is required to connect the modem to a datalogger’s RS-232 port. No other interface is required.
2. Check your LoggerNet setup.
a. Make sure the port number at the end of the IP address matches the
port number of the Raven (e.g. 3001, see Figure 7-1).
20
FIGURE 7-1. Device Port Configuration
RavenXTV CDMA Sierra Wireless Cellular Modem
b. Try adding a few seconds to the extra response time on the IP Port in
LoggerNet (you should not need more than 5 seconds).
c. If you are trying to communicate to a PakBus datalogger:
i. Verify the PakBus address in the setup screen matches that of the
datalogger.
ii. If you have multiple PakBus networks/ports setup in LoggerNet,
uncheck the ‘PakBus Port Always Open’ options on all PakBus ports.
3. Use AceManager to check modem communications with datalogger.
The modem’s “Host Serial Bytes Sent” and “Host Serial Bytes Received” windows can indicate whether or not the modem is communicating with the datalogger.
Establish a connection with the modem through the cellular network using AceManager (click on the Modem menu item, Connect, UDP. Enter the IP address, and click OK). Go to the Status group and note the “Host Serial Bytes Sent” and “Host Serial Bytes Received” values (Figure 7-2). Try connecting with the datalogger using LoggerNet/PC400. If a connection cannot be established, close LoggerNet and reconnect with AceManager and compare the current values with the previous values.
NOTE
If the values are the same, the modem is not attempting to make a connection with the datalogger. Check that the ravencdma_XXX.xml template file has been loaded (Section 5.1).
If the “Host Serial Bytes Sent” increased, the modem attempted to connect to the datalogger, but the response from the datalogger did not make it back to the modem. Check the interface between the modem and the datalogger (Section
4.2).
If both values incremented, the modem and the datalogger are communicating. Try adding some extra response time in LoggerNet.
Baud rate changes require the modem to be reset before the change takes affect. Click the Reset icon in AceManager to the reset the modem and implement the change.
21
RavenXTV CDMA Sierra Wireless Cellular Modem
FIGURE 7-2. AceManager status page showing communications
with modem.
22
Appendix A. AceManager Setup without Template File
AceManager is used to program settings in the RavenXT modems to make the modems compatible with CSI dataloggers. Sierra Wireless CDMA and GPRS template files to send the modems are available on the CSI website (http://www.campbellsci.com/downloads template files is described in Section 5.3.
When the template files are not available, AceManager can be used to change the settings described below.
For a direct connection on a COM port use PPP.
). The procedure for sending the
Make a note of the Device port (*DPORT). The default is 12345 and we use 3001 in our template. Any valid port can be used. This is the port number used in LoggerNet to get to the datalogger.
A-1
Appendix A. AceManager Setup without Template File
S23 – Configure Serial Port – The baud rate needs to be configured to
match a valid datalogger baud rate. For a CR10X: 9600,8N1 and for a CR1000: 115200,8N1.
\Q – Serial Port Flow Control – This should be set to None.
V – AT Verbose Mode – Set this to Verbose for CR800, CR1000,
CR3000; Numeric for CR10(X), CR510, CR23X.
&D – DTR Mode – Set to Ignore DTR
S211 – DTR Mode – Set to Ignore DTR
A-2
Appendix A. AceManager Setup without Template File
S0 – TCP Auto Answer – Set to On
TCPT – TCP Idle Timeout -- Set to a reasonable value like 2 min.
A-3
Appendix A. AceManager Setup without Template File
This is a blank page.
A-4
Appendix B. Configuring the Raven Modem for PPP
The Raven template file configures the Raven to function as a serial server. As a serial server, the modem has an IP address, and port number (3001) for the Raven’s RS232 port.
LoggerNet sends data via TCP/IP over the internet to the datalogger. The modem removes the data from the TCP packet and sends the data out the RS232 port to the datalogger. Returning data is put into a TCP packet by the modem and sent back to LoggerNet.
Settings in the Raven and datalogger (CR800, CR1000, and CR3000), can be changed to configure the RS232 serial ports for Point-to-Point (PPP) protocol. When configured as PPP, the Raven functions as a router, routing TCP/IP communications to the IP stack of the datalogger. PPP enables the datalogger to send/receive messages via email, HTTP, FTP to and from the datalogger, and allows concurrent communications between networked dataloggers and LoggerNet.
The default datalogger port number for PakBus/TCP communications is 6785. The datalogger will also respond to port 80 for HTTP, 23 for Telnet, and 21 for FTP. These ports can be disabled in the dataloggers configuration.
NOTE
After the RS232 port on the modem has been configured as PPP, use AceManager with a TCP or UDP connection to establish communications with the modem. It may also be possible to connect with the modem through its RS232 port using the “SOS” mode.
Raven Settings for PPP Mode:
Download the current RavenCDMA AceManager template file from
http://www.campbellsci.com/downloads
and make the following changes in steps 1 and 2 before writing them to the Raven modem.
Use AceManager to configure the following PPP settings:
HOSTPRIVMODE = 1
HOSTPRIVIP = 192.168.1.1
This will configure the Raven to use NAT (Network Address Translation). These settings should have been configured by the template.
. Load the template into AceManager
B-1
Appendix B. Configuring the Raven Modem for PPP
Use AceManager to configure the following UDP setting:
MD = 02-PPP
Datalogger Settings:
Using the Device Configuration Utility, configure the following setting on the TCP/IP tab:
Config Port Used = RS232
IP Address = 0.0.0.0
Modem Dial String = PPP
Modem Dial Response = CONNECT
User Name and Password are blank
NOTE
These settings are case sensitive and need to be upper case.
B-2
Appendix B. Configuring the Raven Modem for PPP
Using the Device Configuration Utility, select the “Net Services” tab. The “PakBus/TCP Service Port” default is 6785. This is the “Port” number that will follow the “IP address” for LoggerNet to communicate with the datalogger.
B-3
Appendix B. Configuring the Raven Modem for PPP
Using the Device Configuration Utility, fix the RS232 Baud Rate to “115200 Fixed” from the “Port Settings” tab.
LoggerNet Settings:
Enter the IP address of the Raven, and the PakBus/TCP Service Port number of the datalogger (e.g. 6785 as explained above).
B-4
Appendix C. EmailSend Using the Gmail Outgoing SMTP Server
The datalogger has a mail client in it similar to a mail client on a computer. For the datalogger to send an email, it needs an SMTP server to send through like any other mail client. The Gmail SMTP server can be used for sending outgoing email from the datalogger. Both the modem and the datalogger must be configured for PPP as described in Appendix B.
C.1 Setting up a Gmail Account
First you need to create a Gmail account if you do not already have one. To create one go to www.gmail.com from your PC to create an account. Gmail accounts are free of charge.
The credentials to access the mail server will be the user name and password used when creating the Gmail account.
In the following example program you will see:
ServerAddr set to smtp.gmail.com
UserName set to (the gmail account user name).
Password (the one you established at gmail)
NOTE
Gmail requires Transport Layer Security (TLS) to connect to their mail server. You must go into the Settings Editor in the Device Configuration Utility to enable TLS in the datalogger.
C.2 Sending to Multiple Addresses
Sending to multiple email address can be done by using a comma to separate the email addresses (4355551212@hotmail.com, 4355551234@vtext.com).
C.3 Sending a Text Message to a Phone
To send a text message to a phone, the email needs to be converted to a text message via an email to text message gateway. Most cellular providers have an email to text message service for their phone subscribers. To send a text message to Verizon Wireless phone subscribers, you send an email to the (10 digit phone number of the person’s phone)@vtext.com (4355551234@vtext.com).
Most text messages are limited to 160 characters so any email messages greater than 160 characters will be truncated.
C-1
Appendix C. EmailSend Using the Gmail Outgoing SMTP Server
Email to Text Message Gateways
T-Mobile: phonenumber@tmomail.net Virgin Mobile: phonenumber@vmobl.com AT&T: phonenumber@txt.att.net Sprint: phonenumber@messaging.sprintpcs.com Verizon: phonenumber@vtext.com
EmailSend Program Example
The following example sends an email message when an alarm condition is True. Both the CR1000 and Raven modem must be configured as PPP as
described in Appendix B. Transport Layer Security (TLS) must be enabled in the datalogger to use the Gmail mail server.
'Main program variables
Public Batt, RefTemp, Temp Public Socket AS Long
'declare Email parameter strings (as constants), Message String & Result Variable
Const ServerAddr="smtp.gmail.com" Const UserName="gmail account name" Const Password="datalogger" Const ToAddr="datalogger@hotmail.com, 4355551234@vtext.com" Const FromAddr="gmailaccount@gmail.com" Const Subject="Email Message Test" Const Attach="" Const CRLF = CHR(13)+CHR(10) Public Result as String * 100 Public AlarmTrigger As Boolean Public Message As String * 250 Public EmailSuccess As Boolean DataTable (TenSecData,True,-1) DataInterval (0,10,Sec,10) Sample (1,Batt,FP2) Sample (1,Temp,FP2) EndTable BeginProg Scan (1,Sec,3,0) Battery (Batt) PanelTemp (RefTemp,250) TCDiff (Temp,1,mV2_5C,1,TypeT,RefTemp,True ,0,250,1.0,0) CallTable TenSecData NextScan SlowSequence Scan(1,sec,1,0) If AlarmTrigger = False Then If Temp > 27 Then AlarmTrigger = True If AlarmTrigger Then Message = "Warning!" + CRLF + CRLF Message = Message + "An alarm condition has been identified. " Message = Message + "The temperature is " + Temp + " degrees C." + CRLF + CRLF Message = Message + "Datalogger time is " + Status.Timestamp EmailSuccess=EmailSend (ServerAddr,ToAddr,FromAddr,Subject,Message,Attach,UserName,Password,Result) EndIf EndIf If Temp < 27 Then AlarmTrigger=False NextScan EndProg
C-2
Campbell Scientific Companies
Campbell Scientific, Inc. (CSI)
815 West 1800 North
Logan, Utah 84321
UNITED STATES
www.campbellsci.com • info@campbellsci.com
Campbell Scientific Africa Pty. Ltd. (CSAf)
PO Box 2450
Somerset West 7129
SOUTH AFRICA
www.csafrica.co.za • cleroux@csafrica.co.za
Campbell Scientific Australia Pty. Ltd. (CSA)
PO Box 444
Thuringowa Central
QLD 4812 AUSTRALIA
www.campbellsci.com.au • info@campbellsci.com.au
Campbell Scientific do Brazil Ltda. (CSB)
Rua Luisa Crapsi Orsi, 15 Butantã
CEP: 005543-000 São Paulo SP BRAZIL
www.campbellsci.com.br • suporte@campbellsci.com.br
Campbell Scientific Canada Corp. (CSC)
11564 - 149th Street NW
Edmonton, Alberta T5M 1W7
CANADA
www.campbellsci.ca • dataloggers@campbellsci.ca
Campbell Scientific Centro Caribe S.A. (CSCC)
300 N Cementerio, Edificio Breller
Santo Domingo, Heredia 40305
COSTA RICA
www.campbellsci.cc • info@campbellsci.cc
Campbell Scientific Ltd. (CSL)
Campbell Park
80 Hathern Road
Shepshed, Loughborough LE12 9GX
UNITED KINGDOM
www.campbellsci.co.uk • sales@campbellsci.co.uk
Campbell Scientific Ltd. (France)
3 Avenue de la Division Leclerc
92160 ANTONY
FRANCE
www.campbellsci.fr • info@campbellsci.fr
Campbell Scientific Spain, S. L.
Avda. Pompeu Fabra 7-9, local 1
08024 Barcelona
SPAIN
www.campbellsci.es • info@campbellsci.es
Please visit www.campbellsci.com to obtain contact information for your local US or International representative.
Loading...