RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Revision: 12/13 C o p y r i g h t © 2 0 0 6 - 2 0 1 3 C a m p b e l l S c i e n t i f i c , I n c .
Warranty “PRODUCTS MANUFACTURED BY CAMPBELL SCIENTIFIC, INC. are warranted by Campbell Scientific, Inc. (“Campbell”) to be free from defects in materials and workmanship under normal use and service for twelve (12) months from date of shipment unless otherwise specified in the corresponding Campbell pricelist or product manual. Products not manufactured, but that are re-sold by Campbell, are warranted only to the limits extended by the original manufacturer.
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-9000.
Table of Contents PDF viewers: These page numbers refer to the printed version of this document. Use the PDF reader bookmarks tab for links to specific sections. 1. General Description....................................................1 2. Establish Cellular Service ..........................................1 2.1 RavenXTG Cellular Coverage/Service Requirements .........................1 3. Specifications .............................................................2 3.1 RavenXTG Specifications.........
Table of Contents D. EmailSend Using the Gmail Outgoing SMTP Server.....................................................................D-1 D.1 D.2 D.3 Setting up a Gmail Account............................................................. D-1 Sending to Multiple Addresses........................................................ D-1 Sending a Text Message to a Phone ................................................ D-2 E. Troubleshooting Flowchart.................................... E-1 Figures 4-1. 4-2.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 1. General Description This manual provides information for interfacing the Sierra Wireless RavenXTG 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.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Blu-Telecommunication is part of the Alliance Channel with AT&T, and can assist any customer nationwide. Blu-Telecommunication will contact AT&T and work with an AT&T account manager to setup an account. Contact information for Blu-Telecommunication: Phone number: (877) 422-2616, or Email box: i2gold@blu-tel.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 4. 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 +65°C Operating Humidity Range: 5% to 95% RH non-condensing Status LEDs: Power, Network, Signal, Activity Dimensions Width: Depth: Length: 7.6 cm (3 in) 2.5 cm (1 in) 10 cm (4 in) Weight: <0.5 kg (<1 lb) Configuration 4.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem • PN 14394 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/EDGE digital-cellular modems.
RavenXTG GPRS/EDGE 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 FIGURE 4-1.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 4.3 • Power Supply (see power considerations). • Environmental Enclosure—ENC10/12, ENC12/14, or ENC16/18. Wiring and Connections 4.3.1 Modem Connections Using PN 18663 Null Modem Cable PN 18663 Null Modem Cable is used to connect the modem to the CR23X, CR3000, CR800, CR2XX, CR1000 or CR5000 RS-232 port (not compatible with the 21X, CR510, CR10X, or CR7 dataloggers). Wiring: Red 12V (or switched 12V) Black G White Not Used PN 18663 FIGURE 4-2.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 4.3.2 .3.2 Modem Connections Using the SC105 The SC105 interface is used to connect the modem to a datalogger’s CS I/O port, and is recommended for dataloggers with the PakBus operating system. 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.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 4.3.3 .3.3 Modem Connections Using the SC932A The SC932A interface is used to connect the modem to the CS I/O port, and is recommended for dataloggers with the mixed-array operating system (e.g., the CR10X). Wiring: Red 12V (or switched 12V) Black G White Not Used 10873 serial cable provided with the SC932A FIGURE 4-4.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 4.4 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 for constant power and to SW12 for program-controlled power, and the black lead to G (ground). The white wire lead has no function and can be ignored.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Indicator Lights When your RavenXTG 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.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 5. • Authentication Failure—The Network, Signal, and Activity LEDs blink every 2 seconds. Contact the cellular provider and have the account information verified, and verify the modem is located in an area covered by cellular service. • Data Retry—The Network, Signal, and Activity LEDs blink every 3 seconds.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Connect the RavenXTG to a COM port on the PC with a direct RS-232 cable. Also connect the antenna and 12V power. 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 choose the COM port the modem is connected to. Do not change the Password (the default password is 12345). Click OK to continue.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Click the Load icon in the Configuration Panel. When prompted for a template file name, select “RavenXTG GPRS/EDGE Template 115200”, “RavenXTG GPRS/EDGE Template 9600”, or “RavenXTG GPRS/EDGE PPP Template 115200”. 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.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Click on EDGE/HSDPA Group to get the following screen: For a data account with the I2GOLD APN, enter the APN as shown in the screen above. The example is for an APN = “I2GOLD”. Account options prior to the “I2Gold” included a data account with “Feature Code G821”. An AT&T account with Feature Code G821 is configured for an Access Point Name (APN) = “internet”.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 5.1 Configuring the RavenXTG for Dynamic IP Accounts with the I2GOLD APN are provided with a Static IP address, and do not require the settings described in Section 5.1, Configuring the RavenXTG for Dynamic IP. Accounts without the I2GOLD APN may be provided with a Dynamic IP address, which will require the IP Manager settings described below. Dynamic IP addresses are granted only when a modem or other device is connected.
RavenXTG GPRS/EDGE 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.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 6. LoggerNet/PC400 Software Setup The Loggernet “Device Map” is configured from the “Setup” button on the LoggerNet Toolbar. NOTE Setup has two options, “EZ (simplified)” and “Standard”. Click on the “View” menu item at the top of the Setup Screen, and select “Standard” view. From the Loggernet Toolbar, click Main | Setup, and configure the Device Map as described below. 1. Select Add Root | IPPort. 2.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Example settings for a “Dynamic IP” address: 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. For modems configured as “PPP” the port number is “:6785”. 4. 18 For PakBus dataloggers, leave the default settings on the PakBusPort page. “PakBus Port Always Open” should not be checked.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 5. 6.1 For PakBus dataloggers, set the PakBus address to match that of the datalogger (default address in the datalogger is 1). Click the “Apply” button to save the changes. Test the Cellular Connection After the Device Map has been configured, test the cellular connection using the “Connect” screen as shown below. Click on the appropriate station, then click the “Connect” button to initiate a call to the datalogger.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 7. Troubleshooting NOTE Please refer to Appendix E, Troubleshooting Flowchart, for additional troubleshooting procedures. If LoggerNet/PC400 software is unable to establish a connection with the modem: 1. 20 Check the GPRS/EDGE cellular account information, and verify there is GPRS/EDGE coverage at the site. Dynamic IP accounts require a Dynamic Domain Name Server (DDNS) (Section 5, Using AceManager to Program the Modem). a.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 2. 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.1, Configuring the RavenXTG for Dynamic IP). Connect with the modem through the serial port using AceManager. a.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem c. 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). The “RavenXTG GPRS/EDGE Template 9600” template file sets the baud rate to 9600, which is the maximum baud rate for the CR10X and older dataloggers. For newer dataloggers, the baud rate can be changed to the highest baud rate supported by the datalogger (e.g.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem Verify the APN has been entered in the NETAPN and +CGDCONT fields as shown above (where I2GOLD is the APN). If the modem answers but you do not get a connection to the datalogger: 1. Check your connection to the datalogger. a. An SC932A or SC105 interface is required to connect the modem to a datalogger’s CS I/O port (Section 4, Configuration).
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 2. Check your LoggerNet setup. a. Make sure the port number at the end of the IP address matches the port number of the RavenXTG (e.g., 3001, see FIGURE 7-1). FIGURE 7-1. Device Port configuration 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.
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 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).
RavenXTG GPRS/EDGE Sierra Wireless Cellular Modem 26
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/EDGE template files to send the modems are available on the CSI website (www.campbellsci.com/downloads). The procedure for sending the template files is described in Section 5, Using AceManager to Program the Modem.
Appendix A. AceManager Setup without Template File A-2 • 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.
Appendix B. Installation of SIM Card in the RavenXTG The Subscriber Identity Module (SIM) in the RavenXTG is a smartcard securely storing the key identifying a mobile subscriber. Generally, you will only need to install the SIM once in the life of the modem. Installing the SIM To install the SIM, you will only need a small Phillips head screw driver. Opening the Case 1. Unplug the modem power and all cables. 2.
Appendix B. Installation of SIM Card in the RavenXTG 4. B-2 Replace the faceplate; the installation of the SIM is complete.
Appendix C. Configuring the RavenXTG Modem for PPP Settings in the RavenXTG and datalogger (CR800, CR1000, and CR3000), can be changed to configure the RS-232 serial ports for Point-to-Point protocol (PPP). When configured as PPP, the RavenXTG functions as a router, routing TCP/IP communications to the IP stack of the datalogger.
Appendix C.
Appendix C. Configuring the RavenXTG Modem for PPP Datalogger Settings: Using the Device Configuration Utility, configure the following setting on the “PPP” tab: • • • • • NOTE Config Port Used = RS-232 IP Address = 0.0.0.0 Modem Dial String = PPP Modem Dial Response = CONNECT User Name and Password are blank These settings are case sensitive and need to be upper case.
Appendix C. Configuring the RavenXTG Modem for PPP Using the Device Configuration Utility, select the “Network 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. Using the Device Configuration Utility, fix the RS-232 Baud Rate to “115200 Fixed” from the “ComPorts Settings” tab.
Appendix C. Configuring the RavenXTG Modem for PPP LoggerNet Settings: Enter the IP address of the RavenXTG, and the PakBus/TCP Service Port number of the datalogger (e.g., 6785 as explained above).
Appendix C.
Appendix D. 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 C, Configuring the RavenXTG Modem for PPP. D.
Appendix D. EmailSend Using the Gmail Outgoing SMTP Server D.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 AT&T Wireless phone subscribers, send an email to the (10 digit phone number of the person’s phone)@vtext.com (4355551234@vtext.com).
Appendix D. EmailSend Using the Gmail Outgoing SMTP Server 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.
Appendix D.
Appendix E. Troubleshooting Flowchart Can’t connect... Is Network LED on solid? Yes Go to page D-2. No Not provisioned/registered on network. Verizon or AT&T? AT&T Go to page D-4. Verizon Check coverage map. Are you in an area that should be covered? Yes May be out of Verizon’s ‘native’ network. Selfprovisioning may not work in this case (though this is increasingly rare). Try setting up the modem in an area with strong cellular coverage and then installing it. No No solution available.
Appendix E. Troubleshooting Flowchart Can’t connect, Network light is solid... Check signal strength (should be between -51 (strong) and -91 (weak). Strong Static or Dynamic IP? Weak Weak signals are more affected by RF noise. This may prevent making a strong enough connection to send/receive data. Static Verify IP entered correctly. Preceding zeros are not entered in LoggerNet or PC400. Dynamic Check dynamic DNS entered correctly.
Appendix E. Troubleshooting Flowchart Can’t connect, Network light is solid... (cont.) Have mobile terminated IP PPP or Serial Server PPP Serial Server Is DPort (AceManager; Misc Group) set to 3001? Or 6785? Is LoggerNet trying to connect to same? Was correct template loaded into AceManager? Yes Could be wrong baud rate. Did you click “Write” and then “Reset”? Yes Verify Dport (AceManager; Misc group) is set to 3001. Verify baud rate is correct for datalogger.
Appendix E. Troubleshooting Flowchart Can’t connect, AT&T... (cont. from page D-1) Was SIM card installed? No Contact AT&T if don’t have. Yes Was correct template loaded in AceManager, written to the modem and the modem reset? Yes Was APN entered and correct? Yes Go to page D-2.
Appendix E. Troubleshooting Flowchart One computer can connect, other(s) cannot... PPP or Serial Server? PPP Serial Server If multiple PCs are trying to connect simultaneously, do they have unique PakBus addresses? In this mode, it’s first come, first serve, so one connection can exclude others.
Appendix E.
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 8108 Garbutt Post Shop QLD 4814 AUSTRALIA www.campbellsci.com.au • info@campbellsci.com.au Campbell Scientific do Brasil Ltda. (CSB) Rua Apinagés, nbr.