Raven CDMA/1x User Guide AirLink Communications, Inc. version 2.
Information in this document is subject to change without notice ©Copyright AirLink Communications, Inc., 1993-2006. All rights reserved. WARNING The antenna(s) used for this transmitter must be installed to provide a separation distance of at least 20 cm from all persons and must not be co-located or operating in conjunction with any other antenna or transmitter. Important Notice Because of the nature of wireless communications, transmission and reception of data can never be guaranteed.
Contents CHAPTER 1 Introduction to Raven CDMA . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 CDMA Overview ............................................. 2 Establishing a Internet Connection ............................... 2 Using CDMA to Communicate with Your Equipment Common Uses for the Raven CHAPTER 2 Activation of the Raven CDMA . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Connecting the Raven to your computer Quick Start Guide and Setup Wizard Raven Indicator Lights ..........
Contents CHAPTER 4 IP Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Fully Qualified Domain Name Dynamic Name Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Configuring the Raven for Dynamic IP Restrictions for Modem Name . . . . . . . . . . . . . . . . . . . . . . . . . . .17 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents IDs to IPs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Dynamic IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Configuring the Remote Ravens for Modbus with UDP . . . . . . . . . . . . . . 37 Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Power-up Mode . . . . . . . . . . . . . . .
Contents Basic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cellular Network ................................................ Local Network and Host Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PassThru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CHAPTER 1 Introduction to Raven CDMA The Raven's rugged form factor is ideal for industrial and commercial applications that require real-time communications. The Raven provides cellular data communications for a variety of applications, such as telemetry, public safety, SCADA, traffic control, traffic metering, transit arrival systems and more. FIGURE 1. Raven front and back Raven CDMA User Guide for Verizon, version 2.
Introduction to Raven CDMA CDMA Overview Code Division Multiple Access (CDMA) provides a digital cellular telephony system provides wireless Internet access at speeds between 60 and 80 kbps, with bursts up to 144 kbps. Establishing a Internet Connection The Internet Service Provider (ISP) from you to the Internet is Verizon with your Raven as the connection to Verizon.
Introduction to Raven CDMA Note: Private network connections are unique for each configu- ration and not covered as part of the standard installation. Using CDMA to Communicate with Your Equipment There are two types of addresses in TCP/IP, dynamic and static. • Dynamic addresses are assigned on a “need to have” basis. Your Raven might not always receive the same address each time it connects with Verizon.
Introduction to Raven CDMA Common Uses for the Raven The Raven’s rugged construction and cellular connection make it ideal for use in remote and/or industrial locations. The Raven can be used for telemetry and for more advanced communication to the device or devices behind it. 4 FIGURE 3. Financial Point of Sale and Kiosk FIGURE 4. Automation and Telemetry Raven CDMA User Guide for Verizon, version 2.
Introduction to Raven CDMA FIGURE 5. Backup connection to the Internet Raven CDMA User Guide for Verizon, version 2.
CHAPTER 2 Activation of the Raven CDMA Your Raven needs specific parameters before it can operate on the CDMA network. Generally Verizon will provide you with the necessary parameters to get the Raven configured. Connecting the Raven to your computer Your Raven’s serial port can be connected directly to most computers or devices using a standard straight through serial cable.
Activation of the Raven CDMA Note: The web site may have a more recent Setup Wizard and Quick Start Guide than those included with your Raven. It is recommended that you check with the web site for the latest version before installing your Raven. You will need to look for Verizon, CDMA, and the Raven. Other Setup Wizards may not work to connect you to Verizon. To run the Setup Wizard, you will need the Microsoft .
Activation of the Raven CDMA Activating the Raven using AT Commands An alternate method to configure and activate your Raven is by AT commands (full listing beginning on page 53) sent directly to the modem via a terminal application. This method is recommended only in situations where the Setup Wizard is not available and/or the configuration for the Raven is unusual.
Activation of the Raven CDMA Pwr - Indicates the power adapter is connected and there is power getting to the modem. The Reset button performs the same function as unplugging power from the modem and plugging it back in. Reset will not alter any saved configuration settings. Raven CDMA User Guide for Verizon, version 2.
CHAPTER 3 Utilities for the Raven AirLink offers a suite of utilities to optimize your Raven’s performance, allowing you to remotely view status and make changes to the configuration as needed. • • • • AceView Wireless ACE 3G AceNet Modem Doctor This section of the Raven User Guide covers basic information about these utilities. For additional information on a specific utility, please refer to the user guide for that utility.
Utilities for the Raven You can obtain the Microsoft .Net Framework, Microsoft Internet Explorer, and/or the latest ActiveX updates for Internet Explorer from Microsoft at: http://www.microsoft.com/. AirLink Configuration Executive (ACE) The AirLink Configuration Executive provides a user friendly interaction with ALEOS, the brains of your Raven. Wireless ACE 3G Wireless ACE 3G allow you to monitor your Raven either remotely or locally with a direct connection to the modem.
Utilities for the Raven AceNet With AceNet you can monitor several AirLink modems at the same time. The modems can be connected locally or remote. Several features can be displayed and logged. AceNet is a seperate product which can be purchased from AirLink. FIGURE 2. AceNet Using a template from Wireless ACE, you can change the configuration in several modems at the same time and can check and update their firmware as well.
Utilities for the Raven FIGURE 3. AceView You can connect to your Raven locally or remotely using a known IP address or a fully qualified domain name. The display is updated periodically as AceView polls the Raven at a specified interval. GPS is available only for PinPoint and PinPointE modems. FIGURE 4. AceView: About Modem Raven CDMA User Guide for Verizon, version 2.
Utilities for the Raven Modem Doctor Modem Doctor is a troubleshooting utility. This utility will allow you to get a log file of the Raven activity which you can then send to AirLink support, erase the current configuration completely, and temporarily set the Raven to a known serial configuration to aid in trouble shooting. FIGURE 5. 14 Modem Doctor Raven CDMA User Guide for Verizon, version 2.
CHAPTER 4 IP Manager 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. Since Wireless Service Providers frequently do not offer static IP addresses, IP Manager is a free service provided by AirLink for your Raven to translate a dynamic IP address into a fully qualified domain name so it can be contacted directly on the Internet.
IP Manager Fully Qualified Domain Name A fully qualified domain name (FQDN) generally has several parts. • Top Level Domain (TLD): The TLD is the ending suffix for a domain name (.com, .net, .org, etc.) • Country Code Top Level Domain (ccTLD): This suffix is often used after the TLD for most countries except the US (.ca, .uk, .au, etc.) • Domain name: This is the name registered with ICANN (Internet Corporation for Assigned Names and Numbers) or the registry for a the country of the ccTLD (i.e.
IP Manager If the Raven is configured for Dynamic IP, when the Raven first connects to the Internet, it sends a IP change notification to IP Manager. IP Manger 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. If the IP address is needed, you can use the domain name to determine the IP address.
IP Manager FIGURE 1. Wireless ACE: Dynamic IP (IP Manager configuration) 1. Modem name: The name you want for the modem. 2. Domain: The domain name to be used by the modem. 3. IP Manager IP Address: The IP or domain name of the dynamic DNS server which is running IP Manager. Note: To use the name here instead of the IP, you need to have DNS set up in your Raven (page 19). 4. IP Manager update interval: How often you want the address sent to IP Manager.
IP Manager DNS: Using Names Instead of IP addresses A domain name is a name of a server or device on the Internet which is associated, generally, with an IP address. In a way, a domain name is like the street address of your house with the phone number being like the IP address. You can contact the house either by going to the address (name) or by calling the phone number (IP address).
IP Manager *DNSUSER - Set this, if desired, to an additional DNS server to query first before the primary or secondary (just as a hosts file is queried first on a computer). If *DNSUSER is set to 0.0.0.0, it will be ignored. *DNSUPDATE - This command sets how often you want DNS Updates to be forced. Otherwise the Raven will only send updates when it is reset, powered up, or the IP address granted by the network changes.
CHAPTER 5 Keepalive It is not uncommon for your Raven to be disconnected from Verizon after an extended period of inactivity. This is generally a feature intended to reduce your charges for inactive use. Keepalive is used to test and maintain the Raven’s connection to Verizon by pinging an IP address after a specified period of inactivity. Keepalive is recommended for users who have a remote terminated modem that infrequently communicates to the network.
Keepalive To set the Keepalive using Wireless ACE, select Other from the menu on the left. FIGURE 1. Wireless ACE: Keepalive Configuration *IPPING sets the interval, in minutes, you want Keepalive to test the network connection. To disable Keepalive, set *IPPING to 0 (default setting). Note: 15 minutes is the minimum time which can be set for Keepalive. *IPPINGADDR sets the IP address you want to use for the test. If *PPINGADDR is left blank or is set to an invalid IP address (i.e.
CHAPTER 6 Host Modes The Raven plays the part of a host when its serial port is connected to a computer or another device. As the host, the Raven can be in one of six communication modes. AT: The Raven accepts and responds to standard, Hayes-style AT commands. PassThru: Direct connection to internal hardware (OEM Module) of the Raven. PPP: The Raven uses PPP to communicate. SLIP: The Raven uses SLIP to communicate.
Host Modes in the AT Command listing, page 66) to the desired mode. If this setting is nonzero, the modem will enter the specified mode after 5 seconds. If you want to cancel this behavior, the ATMD0 command can be used before the 5-second time-out expires. If the modem is in any mode other than AT or PassThru, the AT command mode can be re-entered by: • Deactivating DTR (if &D2 or Ignore DTR, S211, is not set). • Issuing the +++ escape sequence (if Disable AT Escape, DAE, is not set).
Host Modes For V=0 (Terse mode), a numeric result code is output with a single trailing (no is output), while any AT query response is followed by (there is no preceding output).
Host Modes PPP Mode In PPP mode, the Raven acts as a PPP server, providing an IP address, and DNS servers (if available) to the Host. PPP mode is entered from the AT mode by using any of the following commands: AT\APPP ATDT10.0.0.1 ATDT10001 ATD#19788 CLIENT In response to any of the preceding commands, the modem will respond with CONNECT and is ready for the host to begin PPP negotiations.
Host Modes SLIP does not negotiate the IP with the host, so before making a SLIP connection, the host SLIP driver must be configured to use the IP specified by querying S110.
Host Modes When idle, after the time-out has occurred, the Raven is in AT command mode on the serial port, and any valid AT command may be entered during this time. The Normal UDP Mode (MD3) can be combined with UDP auto answer to cause the incoming serial data to be sent in UDP packets (instead of being treated as AT commands), while allowing sessions to be established from different UDP sources. A UDP session will be initiated either by incoming serial data or by an incoming UDP packet.
Host Modes Note: Although it adds reliability, the simple implementation of the Reliable UDP mode in the Raven does not check for duplicate packets. Multicast UDP Multicast UDP results in any data received from the host serial port being sent to all the clients in the Modbus list. The remote port number is taken from S53. To avoid flooding the network, the packets are sent to each client with a 20ms pause in between. The receipt of UDP packets works as in normal UDP mode (i.e.
Host Modes The value of S7 (TCP Connection Time-out) specifies the number of seconds to wait, after initiating a TCP connection attempt, for a successful connection to be established. If the connection has not been successfully established before the timeout occurs, ERROR/BUSY is returned. TCP packet assembly is affected by the values of S50 (PAD Forwarding Time-out) and S51 (PAD Forwarding Character).
Host Modes as MD5 and MD6 previously accomplished. Setting MD5 and MD6 are still supported, but not recommended. TABLE 1. Hybrid Mode Settings AT Hybrid (MD5) Hybrid2 (MD6) MD 3 3 S82 2 2 S0 1 1 *UDPLAST 0 1 Raven CDMA User Guide for Verizon, version 2.
CHAPTER 7 Modbus/BSAP Configuration The Raven supports Modbus ASCII, Modbus RTU, BSAP, and can also emulate other protocols like DF1 or others using its Modbus Variable feature. Modbus Overview The Modbus Protocol, developed by Modicon in 1979, provides for client-server (also referred to as master-slave) communications between intelligent devices.
Modbus/BSAP Configuration Telemetry Telemetry is an automated communications process by which data is collected from instruments located at remote or inaccessible points and transmitted to receiving equipment for measurement, monitoring, display, and recording. Transmission of the information may be over physical pairs of wires, telecommunication circuits, radios or satellite.
Modbus/BSAP Configuration motion control, process control, Distributed Control System and complex networking. Modbus TCP/IP Modbus TCP/IP simply takes the Modbus instruction set and wraps TCP/IP around it. Since TCP/IP is the communications standard for the Internet and most networked computers, this provides a simpler installation. Modbus TCP/IP uses standard Ethernet equipment.
Modbus/BSAP Configuration Configuring the Raven at the Polling Host for Modbus on UDP You can use either Wireless ACE (page 10) or direct serial communication or Telnet (page 53) to configure the modem using AT commands (page 53). This section covers standard Modbus, variations may need additional commands. Port The destination port for the Raven at the host needs to match the device port in use on all the Ravens at the remote sites.
Modbus/BSAP Configuration FIGURE 4. • • • • Wireless ACE: MD Configuration ATMD13: Modbus ASCII ATMD23: Modbus RTU (Binary) ATMD33: BSAP ATMD63: Variable Modbus (individual parameters are set up manually) IDs to IPs The last step of configuring the Raven at the host is setting the IDs to their specific IPs. In Wireless ACE, select the menu option Addr List. FIGURE 5. Wireless ACE: Addr List Addresses can be entered in decimal or hex. Wireless ACE will translate hex entries into decimal.
Modbus/BSAP Configuration In the Host Raven’s configuration, instead of IP address for the Addr List (ATMLIST or ATMLISTX), substitute a single unique name for each modem, i.e. remote1, remote2, etc. When you configure IPManager for the host Raven, make note of your modem name and domain setting in Wireless ACE in the menu selection Dynamic IP to be used with the remote modems.
Modbus/BSAP Configuration In Wireless ACE, select Misc in the side menu. Set the destination port (S53) to match the device port of the host Raven (*DPORT, above). Make sure the device port of the remote Raven (*DPORT) matches the destination port of the host Raven (S53, above). Default Power-up Mode Each Raven at the remote locations will need to be configured to communicate with the Raven at the host. In Wireless ACE, select UDP in the side menu. Select 03UDP (normal UDP operation) as the value for MD.
Modbus/BSAP Configuration RTU settings Other parameters may need to be changed, but this is dependent on the RTU type being used. As a minimum, this typically involves setting the proper serial settings to match your RTU. FIGURE 9. Raven mounted in an enclosure with an RTU Raven CDMA User Guide for Verizon, version 2.
Modbus/BSAP Configuration 40 FIGURE 10. RTU to Raven setup FIGURE 11. Power Connections Raven CDMA User Guide for Verizon, version 2.
CHAPTER 8 Simple Network Management Protocol (SNMP) The Raven can be configured as an SNMP agent and supports SNMPv2c and SNMPv3. SNMP Overview The Simple Network Management Protocol (SNMP) was designed to allow remote management and monitoring of a variety of devices from a central location.
Simple Network Management Protocol (SNMP) Management Information Base (MIB) The management information base (MIB) is a type of database used to compile the information from the various SNMP agents. Reports from various agents, such as the Raven, are sent as data in form designed to be parsed by the NMS into its MIB. The data is hierarchical with entries addressed through object identifiers.
Simple Network Management Protocol (SNMP) Security Level *SNMPSECLVL sets the security level and which version of SNMP communications are used. FIGURE 2. Wireless ACE: *SNMPSECLVL 0 - No security required. SNMPv2c and SMNPv3 communications are allowed. 1 - Authentication required. SNMPv3 is required to do authentication and SNMPv2c transmissions will be silently discarded. Authentication is equivalent to the authNoPriv setting in SNMPv3. 2 - Authentication required and messages are encrypted.
Simple Network Management Protocol (SNMP) FIGURE 3. Wireless ACE: Changing the Raven Password - Menu Option The current password will be pre-entered. As you type the new password and confirm it, the characters you type will be obscured by “x”. FIGURE 4. Wireless ACE: Changing the Raven Password For the password, you can use numbers, letters, and/or punctuation. Caution: The password is case sensitive. “drowssaP” is not the same as “drowssap”. 44 Raven CDMA User Guide for Verizon, version 2.
Simple Network Management Protocol (SNMP) Trap Destination *SNMPTRAPDEST needs to be set with the destination IP and port. If either are set to zero or empty, SNMP traps are disabled. FIGURE 5. Wireless ACE: *SNMPPORT Note: Traps are sent out according to the SNMP security level (i.e. if the security level is 2, traps will be authenticated and encrypted). Currently, the only trap supported is LinkUp. Raven CDMA User Guide for Verizon, version 2.
CHAPTER 9 Hardware Installation Your AirLink Raven should be mounted in a position that allows easy access for the cables so they are not bent or constricted. The LEDs on the front panel should be visible for ease of operational verification. You should ensure that there is adequate airflow around the modem but that it is kept free from direct exposure to the elements (sun, rain, etc.). The exterior of the case should also be grounded. An optional accessory for your modem is a mounting kit.
Hardware Installation Connecting power Your Raven can be used with either DC (available in most automobiles) or 110 AC (standard US wall power) with the appropriate power adapter (available from AirLink). The power cable positive lead should be connected to the battery or power source positive terminal. The power cable negative lead should be connected to the battery or power source negative terminal. The Raven has an internal polysilicon circuit breaker that opens at 0.5 to 1.0 amps of current.
APPENDIX 1 Specifications for the Raven CDMA Physical Characteristics: • • • • • Weight: < 1 lb. Size: 3” x 1.1” x 5.1" RF Antenna Connector: 50 Ohm TNC Serial Interface: RS232 DB-9F with 1200-115200 bps Status LEDs Data Services & RF Features: CDMA • • • • • • Full duplex transceiver Dual-band support for both 800 MHz cellular and 1.9 GHz PCS bands Dual band Receive Diversity Adheres to CDMA authentication as specified in CDMA2000 1X 224 mW RF output (+23.5 dBm) Data rates up to 153.
• Humidity: 5%-95% Non-condensing Power Management: • • • • • Low power consumption Dormant connection (idle for 10-20 seconds): at 12 VDC Input Voltage: 10 VDC to 28 VDC Input Current: 20 mA to 350 mA Low power mode: at 12 VDC Power consumption Modem Idle Transmitting Raven C3211 50 mAh 200-300 mAh Raven C3210 50 mAh 250-300 mAh Serial Port Pin-outs The cable between the modem and a computer or other serial device needs to be wired straight-through (pin 1 goes to pin 1, pin 2 to pin 2, etc).
50 Raven CDMA User Guide for Verizon, version 2.
APPENDIX 2 Mounting Kit An optional accessory for your modem is a mounting kit. The bracket is designed to snugly cradle the modem and hold it in place where you need it. The Raven “snaps” into place in the bracket locking into the grooves on the Raven case. The bracket can be further secured with a twist-tie set into the grooves on the top for situations where the modem may be subjected to violent movement, such as in the back of an automobile.
52 Raven CDMA User Guide for Verizon, version 2.
APPENDIX 3 AT Commands Just as with a Hayes compatible analog modem, the Raven parameters can all be configured with AT commands. Using Wireless Ace Wireless ACE is a graphical interface for the AT commands and it is highly recommended that you this utility to modify any parameters, however a terminal emulation application, such as Telnet, see below, can be used instead. With Wireless ACE, you only need to find the command listed and then enter the new value in the space provided.
FIGURE 1. Wireless ACE: Using AT Commands To set or commit the changes in the modem, use the Write button at the top of Wireless ACE interface. FIGURE 2. Wireless ACE: Toolbar For more information on using Wireless ACE 3G or Wireless ACE Web, please refer to the Wireless ACE 3G User Guide. Note: Some of the AT Commands are not able to be configured in Wireless ACE 3G. With Wireless ACE, you can create a template from one modem and then use that template to configure other modems in the exact same way.
Start>All Programs>Accessories>Communications>HyperTerminal 1. Choose a name for your connection, such as Raven or AirLink. The name and icon are only for your own reference so you can find the connection at a later date (if you want to have a connection saved for both local and remote, it is recommended the connection name reflect the connection type, i.e. Raven Remote). FIGURE 3. 2. Select TCP/IP (Winsock) for Connect Using.
FIGURE 5. HyperTerminal: AT mode via Telnet 4. Type AT and press Enter. You should get a reply of “OK” or “0”. 5. To see what you are typing as you type it, you will need to turn on the echo and verbose mode. Type ATE1V1 and press Enter. If you get a reply of “OK”, then you entered the command successfully. If you get a reply of “0” or “ERROR”, try entering the command again.
2. Select COM1 for the Connect Using. FIGURE 7. 3. HyperTerminal: Comport Setting Change the Bits per Second to 115200 (default), Data Bits to 8, Parity to None, Stop Bits to 1, and Flow Control to Hardware. FIGURE 8. HyperTerminal: Comport Settings 4. Type AT and press Enter. You should get a reply of “OK” or “0”. . 5. To see what you are typing as you type it, you will need to turn on the echo and verbose mode. Type ATE1V1 and press Enter. 6.
• Some commands have specific parameters while other commands will take whatever your type. • Acceptable parameters and/or specific formats are in the parameters column. • Required variable parameters are denoted with italicized text, ex. Dn. The n is variable and noted in the parameters column. • Optional parameters are denoted with square brackets [ ].
TABLE 1. Information and Status Command Details I[n] n=0 Product name (for example, Raven). n=1 The Raven’s firmware (ALEOS) version, hardware ID, and copyright. n=2 The internal hardware's firmware version and relevant hardware ID. n=3 The hardware module's unique ID (ESN). n=5 View active profile (the contents of the active registers). &V View active profile (the contents of the active registers). *HOSTMODE? The current host mode (AT, PPP, UDP, etc.).
TABLE 1. Information and Status Command Details *NETSTATE? The current network state: Connecting To Network = The Raven is in the process of trying to connect to the CDMA network. Network Authentication Fail = Authentication to the CDMA network has failed. Verify settings to activate the Raven. Network Negotiation Fail = Network connection negotiation failed. This is usually temporary and often clears up during a subsequent attempt.
Basic Commands These commands are common to most communication devices using AT Commands. TABLE 3. Basic Commands (common AT commands) Command Parameters Details +++ none AT Escape sequence. The "+" is ASCII 0x2B. Not proceeded by AT. If the Raven is in a data mode (any mode other than PassThru), this command causes the modem to re-enter AT command mode. There must be an idle time (set by S50) on the serial port before and after this command. The detection of +++ is disabled if DAE=1.
TABLE 3. Basic Commands (common AT commands) Command Parameters Details Qn n=0 or 1 The AT quiet-mode setting. If quiet mode is set, there will be no responses to AT commands except for data queried. 0 : Off (Default) 1 : Quiet-mode on Vn n=0 or 1 Command Response Mode. 0 : Terse (numeric) command responses 1 : Verbose command responses (Default). Xn n=0 or 1 Extended Call Progress Result mode. 0 : Turn off extended result codes (Default). 1 : Turn on result codes.
TABLE 4. Activation (Provisioning) Command Parameters Details OPRG=n n=0 or 1 Enables/disables over-the-air firmware upgrading of the Raven. 0 : Disables over-the-air programming. 1 : Enables over-the-air programming. *DEVICEID=n n=number string Sets or queries the 64-bit Device ID that is used by the modem to identify itself to the server. The default is a value that depends on the underlying communications technology being used.
Cellular Network The Raven’s cellular network is the connection to CDMA and remote devices or computers. TABLE 5. Cellular Network (Verizon’s CDMA) Command Parameters Details *NETALLOWZEROIP=n n=0 or 1 Allows the displayed IP address in *NETIP to end in zero (ex. 192.168.1.0). 0 : Do not allow 1 : Allow *NETCHAN? none The current active CDMA channel number. *NETERR? none The EVDO or CDMA network frame error rate.
TABLE 5. Cellular Network (Verizon’s CDMA) Command Parameters Details !STATUS none Displays the current modem status. Format of response: Current band: C3210 Current channel: SID: NID: Roaming: Temp: Pilot [NOT] acquired Modem has [NOT] registered !RSSI C3210 none Received Signal Strength Indicator Puissance du signal reçu. +CBIP? none Mobile Station IP Address. +CGSN none ESN (Electronic Serial Number).
TABLE 6. Local Network and Host Modes Command Parameters Details +++ none AT Escape sequence. If the Raven is in a data mode (any mode other than PassThru), this command causes the modem to re-enter AT command mode. The "+" is ASCII 0x2B. This command is not proceeded by AT. Note: There must be an idle time (set by S50) on the serial port before and after this command. The detection of +++ is disabled if DAE=1.
TABLE 6. Local Network and Host Modes Command Parameters Details S0=n n=0 | 1 | 2 | 3 This register determines how the Raven responds to an incoming TCP connection request. The Raven remains in AT Command mode until a connection request is received. DTR must be asserted (S211=1 or &D0) and the Raven must be set for a successful TCP connection. The modem will send a "RING" string to the host.
TABLE 6. Local Network and Host Modes Command Parameters Details S51=n n=0 | ASCII code PAD data forwarding character. 0 : No forwarding character. ASCII code of character that will cause data to be forwarded. (Used in UDP or TCP PAD mode.) S82=n n=0 or 2 Enables UDP auto answer (half-open) mode. 0 : Normal mode 2 : Enable UDP auto answer mode. S83=n n=0-255 Set or query UDP auto answer idle time-out.
TABLE 6. Local Network and Host Modes Command Parameters Details TCPS=n n = minutes (TCPS=0) or seconds (TCPS=1) TCP connection time-out (TCPS) units. Specifies a time interval upon which if there is no in or outbound traffic through a TCP connection, the connection will be terminated. TCPT=n n = minutes (TCPT=0) or seconds (TCPT=1) TCP connection time-out (TCPT) units.
TABLE 6. Local Network and Host Modes Command Parameters Details *CTSE=n n=0 or 1 Clear To Send Enable This feature asserts CTS when there is a network connection. 0 : Disabled (Default). 1 : Enable assertion of CTS when there is network coverage. Note: Flow control (AT\Q) will override this indication, so if you want to use CTS to indicate network coverage, flow control has to be off (AT\Q0). RS232 voltage levels: Positive = Network coverage. Negative = No coverage.
TABLE 6. Local Network and Host Modes Command Parameters Details *HOSTPEERIP =d.d.d.d d.d.d.d=local or peer IP of modem Set or query the IP address that can be used to directly contact the Raven once a PPP connection is established. If this value is not specified, 192.168.13.31 will be used. Note: This is not normally used nor needed by user applications. PPP *HOSTPRIVIP =d.d.d.d d.d.d.d=IP Set or query the private IP address that is to be negotiated by the PPP connection if *HOSTPRIVMODE =1.
TABLE 6. Local Network and Host Modes Command Parameters Details *UDPLAST=n n=0 or 1 If enabled, sets S53 to the last accepted IP address through UDP auto answer. This can be used in conjunction with MD3 so that when there is no UDP session, new ethernet host data will cause a connection to be restored to the last IP accepted through UDP auto answer. . 0 : Does not change S53 setting. (Default). 1 : Set S53 to the last accepted IP. Note: This does not change the S53 setting in NVRAM.
TABLE 7. PassThru Mode Command Parameters Details \APASSTHRU none Set modem operation to pass through mode. This will pass any characters received on the serial port directly to the internal hardware module and output any characters from the internal hardware module out the serial port. This allows direct access/configuration of the hardware module. Once this mode is entered, the unit must be physically reset to return to normal operation.
TABLE 8. Direct Communication Command Parameters Details D[method][d.d.d.d][/ppppp] method = P, T, N or d.d.d.d = IP address to contact Dial a connection to a remote IP and Port using method. P - Establish a UDP connection D[method][@name][/ppppp] name = domain name to contact ppppp = IP port to contact D continued see above T - Establish a TCP connection N - Establish a Telnet connection ATD - Dial (establish) default connection. ATDP192.168.13.31/2332 - Dial (establish) UDP session to 192.
TABLE 8. Direct Communication Command Parameters Details S53=[method][d.d.d.d][/ ppppp] method = P - UDP Destination IP address, port, and method. These are used as defaults for the D (Dial) AT command. T - TCP Examples: N - Telnet ATS53=T192.168.100.23/12345 d.d.d.d = IP address or name ATS53=foo.earlink.com ppppp = the port address ATS53=192.168.100.23/12345 Telnet to the specified IP at port 12345. Query the specified IP at port 12345. ATS53=/12345 Query port 12345.
TABLE 9. Telnet Command Parameters Details *TELNETTIMEOUT=n n=minutes Telnet port inactivity time out. By default, this value is set to close the AT telnet connection if no data is received for 2 minutes. *TPORT=p p=0-65535 Sets or queries the port used for the AT Telnet server. If 0 is specified, the AT Telnet server will be disabled. The default value is 2332. Time/Date Time and Date in the Raven is set to UTC (Coordinated Universal Time). Time is expressed in 24-hour format, i.e.
Friends Mode Friends Mode can limit access to the Raven from the Carrier network and the Internet. Friends Mode is a limited form of security. TABLE 11. Friends Mode Command Parameters Details FM=[n] n=0 or 1 Friends Mode - Only allow specified IPs to access the Raven. 0 : Disable Friends mode 1 : Enable Friends mode - Only packets from friends will be accepted (see below); packets from other IP addresses are ignored. Fn=[d.d.d.d] n = Friends list index [0 - 9] Friends mode IP address. d.d.d.
TABLE 12. DNS Command Parameters Details *DNSUPDATE=n n=0 or 1 Indicates whether the modem should send DNS updates to the DNS server specified by *DNSUSER. These updates are as per RFC2136. They are not secure and are recommended only for a private network. In a public network, the IP Logger services should be used instead. 0 : DNS updates disabled (Default). 1 : DNS updates enabled. *DNSUSER=d.d.d.d d.d.d.
TABLE 13. Keepalive Command Parameters Details *MINXMIT=n n=seconds Minimum transmit period enforcement. When set to n seconds, will not let the *IPPING, *PPMINTIME, and the *MSCIUPDPERIOD timers to be set less than n seconds. Note that the *PPTIME can still be set to less than *MINXMIT, but the packets will still be transmitted no more often than the *PPMINTIME. Warning: The *MINXMIT value is can only be set one time and AirLink must be contacted to reset it.
TABLE 14. IP Manager Command Parameters Details *IPMGRKEYn=[key] n= 1 or 2 Sets the 128-bit key to use to authenticate the IP update notifications. If the key's value is all zeros, a default key will be used. If all the bytes in the key are set to FF, then no key will be used (i.e. the IP change notifications will not be authenticated). AT*IPMGRKEY1 is used to set the key to use with AT*IPMANAGER1, while AT*IPMGRKEY2 is used to the key with AT*IPMANAGER2.
Raven CDMA User Guide for Verizon, version 2.
Logging The Raven allows several different levels of logging. TABLE 15. Logging Command Parameters Details *DBGCOM1000=n n=0 or 1 Turn on debugging for COM1000. 0 : No logging 1 : Logging *DBGCOMLVL=n n=0 | 1 | 2 Set the logging level for the host or module COM port. 0 : No logging 1 : Host COM 2 : Module COM *DBGEVTLOGCLEAR none Clears the content of the logs in the modem. *DBGIPLVL=n n=0 | 1 | 2 Sets the logging level for the IP subsystem. 0 : No logging 1 : Log errors (i.e.
TABLE 16. Modbus Settings Command Parameters Details IPL=n n=0 or 1 IP List Dial This allows access the Modbus IP list using the first two digits of the dial string. Example: ATDT1234567 would go to ID "12" on the Modbus list and use the associated IP as the destination. 0 : Disabled 1 : Enabled Cannot be configured in Wireless ACE. MDhh hh (hex byte) = Default power-up mode. 00 - normal mode When the PinPoint is power-cycled, it may enter the mode specified by this command after 5 seconds.
TABLE 16. Modbus Settings Command Parameters Details MVMSK=hh hh=hex value Modbus Variant ID Mask. 00 - no mask, all 8 bits (default) Byte hex mask to use when extracting the ID. Specify which bits in the ID field to use. This parameter is used when the when the Mode Default (MD) is set to hex 63. 0F - only the low order 4 bits MVOFF=n n = 0 - 255 Cannot be configured in Wireless ACE. Modbus (variable mode) Offset. Indicates the offset in the data of where the Modbus ID starts.
TABLE 16. Modbus Settings Command Parameters Details RKEY=n n= 0 or Radio Transceiver Keying. 0 : Off (Default) 1 : On Enable/disable MDS Radio transceiver keying. Radio keying is designed to assert CTS when a packet is received, delay the time as specified, send the data out the serial port, wait the same amount time, drop CTS. This way, the CTS signal can be used to key a transmitter on and give it time to reach its power level before data is sent to it. Delay interval is specified in S221.
TABLE 17. SNMP Command Parameters Details \ACEPW=pw pw=password Change the ACE password to a new value. Password is case-sensitive. Default password is 12345. Example: AT\ACEPAW=new123 *SNMPPORT=n n=0-65535 This controls which port the SNMP Agent listens on. 0 : SNMP is disabled. Port for SNMP agent to listen on. *SNMPSECLVL=n n=0 | 1 | 2 Selects the security level requirements for SNMP communications as follows: 0 : No security required. SNMPv2c and SNMPv3 communications are allowed.
Caution: Your account with Verizon may not support message sending. For most SMS commands (those not preceeded by *), you will need to have the modem in PassThru mode. TABLE 18. SMTP (email) and SMS (messaging) Command Parameters Details *NETSMS2EMAIL= [number] number= SMS/ E-mail server Specify the SMS/E-mail server number. This is necessary to send an SMS message to an email address (+CMGS). *SMTPADDR= d.d.d.d=IP [d.d.d.
TABLE 18. SMTP (email) and SMS (messaging) Command Parameters Details *SMTPUSER=[user]Maximum: 40 characters user= username The email account username to authenticate with the SMTP server (*SMTPADDR) for sending email. Note: not required to use SMTP settings but may be required by carrier. +CMGD=index[,flag] index=0-9 C3211 This command is used to delete one or several messages. flag=0 Delete message at location. flag=1 Delete All READ messages. flag=2 Delete All READ and SENT messages.
TABLE 18. SMTP (email) and SMS (messaging) Command Parameters Details !DSMS =index[,message] index= index list (0, 1, 2) Deletes one or all messages from one of the index lists. C3210 message=message number The message number is a base 0 index into the list, where 0 is the oldest message, and the number reported by !CNTSMS minus one, is the most recent message. If the message number parameter is omitted, then all messages in the index list are deleted. Note: There is no confirmation required.
TABLE 19. Other Settings Command Parameters Details *NUMTOIP=n n=0 or 1 Convert 12 digit number to IP. 0 : Use as name. 1 : Use as IP. +CTA=n n=seconds Inactivity timer, in seconds. Typical network settings cause a link to go dormant after 10 to 20 seconds of inactivity, no packets transmitted or received. This time can be shortened to release the physical RF link sooner when the application only transmits short bursts. 90 Raven CDMA User Guide for Verizon, version 2.
APPENDIX 4 Example of the MIB trap AIRLINK-MIB DEFINITIONS ::= BEGIN IMPORTS ObjectNameFROM SNMPv2-SMI MODULE-COMPLIANCEFROM SNMPv2-CONF; org OBJECT IDENTIFIER ::= { iso 3 } dod OBJECT IDENTIFIER ::= { org 6 } internet OBJECT IDENTIFIER ::= { dod 1 } private OBJECT IDENTIFIER ::= { internet 4 } enterprises OBJECT IDENTIFIER ::= { private 1 } airlink OBJECT IDENTIFIER ::= { enterprises 20542 } general OBJECT IDENTIFIER ::= { airlink 1 } common OBJECT IDENTIFIER ::= { airlink 2 } Raven CDMA User Guide f
status OBJECT IDENTIFIER ::= { airlink 3 } gps OBJECT IDENTIFIER ::= { airlink 4 } -- GENERAL -phoneNumber OBJECT-TYPE SYNTAX DisplayString (SIZE (10)) MAX-ACCESS read-only STATUS current ::= { general 1 } deviceID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 2 } electronicID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 3 } modemType OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 4 } 92 Rave
aleosSWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 5 } aleosHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 6 } modemSWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 7 } modemHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 8 } -- COMMON -date OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only Raven CDMA User Guide for Verizon, version 2.
STATUS current ::= { common 1 } otaProgrammingEnable OBJECT-TYPE SYNTAX INTEGER { disabled(0), enabled(1) } MAX-ACCESS read-only STATUS current ::= { common 2 } devicePort OBJECT-TYPE SYNTAX INTEGER(0..65535) MAX-ACCESS read-only STATUS current ::= { common 3 } netUID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 4 } netPW OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 5 } 94 Raven CDMA User Guide for Verizon, version 2.
requestPAP OBJECT-TYPE SYNTAX INTEGER { no(0), yes(1) } MAX-ACCESS read-only STATUS current ::= { common 6 } destinationAddress OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 7 } destinationPort OBJECT-TYPE SYNTAX INTEGER(0..65535) MAX-ACCESS read-only STATUS current ::= { common 8 } serialPortSettings OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 9 } serialPortFlowControl OBJECT-TYPE Raven CDMA User Guide for Verizon, version 2.
SYNTAX INTEGER { none(0), hardware(2), software(4) } MAX-ACCESS read-only STATUS current ::= { common 10 } -- STATUS -ipAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current ::= { status 1 } netState OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 2 } netChannel OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 3 } rssi OBJECT-TYPE 96 Raven CDMA User Guide for Verizon, version 2.
SYNTAX INTEGER(-125..-50) MAX-ACCESS read-only STATUS current ::= { status 4 } serialSent OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 5 } serialReceived OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 6 } hostMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 7 } powerMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 8 } Raven CDMA User Guide for Verizon, version 2.
fixObtained OBJECT-TYPE SYNTAX INTEGER { no(0), yes(1) } MAX-ACCESS read-only STATUS current ::= { gps 1 } satelliteCount OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { gps 2 } latitude OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { gps 3 } longitude OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { gps 4 } END 98 Raven CDMA User Guide for Verizon, version 2.
Raven CDMA User Guide for Verizon, version 2.
Troubleshooting Frequently Asked Questions (FAQ) and Solutions Many of these questions and solutions come from AirLink Support. Caution: Solutions should only be performed if you are experi- encing the specific problem indicated and have the specific modem model number indicated. Some solutions are very specific to model numbers due to differing internal hardware.
AirLink modems optimally have an RSSI value of -60 to -95. What is the Proper RF Coverage for my Raven? Optimal RF coverage (RSSI) for your Raven is between -60 to -95 DBm. RF coverage between -95 to -105 DBm will generally still register, however functionality at this range can be impeded and registration can become temperamental. Any devices with an RSSI below -105 DBm will likely fail to register on a regular basis.
The short dipole antenna (also known as a “rubber duck”) is a good desktop, portable antenna for use in areas with good signal strength and low electrical interference.
the modem. You can contact AirLink Support for a Guide on how to use your AirLink modem with a portable battery. I’m Having Problems getting my Raven registered (activated or provisioned) with Verizon, what could be the problem? There are several error messages that might appear during the registration process: • No Service • Network Negotiation Failed • Network Authentication Failed These problems are frequently caused by account related issues.
Public Mode (*HOSTPRIVMODE=0) : The IP address assigned by Verizon is passed on to the devices connected to the modem. If there is a computer or device connected to the serial port of your modem, there are actually two PPP sessions taking place. After your AirLink modem receives the cellular provider’s assigned IP address, a second PPP session established between your computer or device and the modem ultimately assigns that IP address to that computer or device connected to the serial port.
*HOSTPRIVMODE=1 - Private Mode turned on. *HOSTPRIVIP=[IP address] - IP address assigned to computer or other device connected directly to the modem (example, 192.168.1.8). *HOSTPEERIP=[IP address] - IP address assigned to modem for local, not cellular, communication (example, 192.168.1.9). *HOSTNETMASK=[subnet mask] - Subnet Mask setting (example, 255.255.255.0). The IP addresses configured need to be appropriate for your network. For most internal networks, using the IP range of 192.168.x.
“The COM1000 provides you with a single device that can be seamlessly integrated into LAN, WAN, and WIRELESS projects. Its embedded applications provide quick and easy means of connecting serial devices to IP networks, Internet enabling legacy devices, or integrating remote devices with today's advanced 3G wireless data networks.
FIGURE 3. Wireless ACE: Update PRL interface Generally the PRL will be updated to the one present in the “PRL” folder of the Wireless ACE installed folder (i.e. C:\Program Files\AirLink\Wireless Ace 3G\PRL). If the PRL version to apply is displayed as ONLINE, then the PRL will be updated Over-the-Air (OTA) directly from Verizon.
Modem has not registered: This can be a transitory state. Wait 30 to 60 seconds and attempt the command again. Modem is registering: Generally, this indicates the Raven is attempting to contact Verizon’syour cellular provider’s network. Wait 30 to 60 seconds and attempt again. Modem has registered: When you see this message, the Raven is registered on Verizon’s network . Continue on to the next step. . FIGURE 4. 5. Type AT+GMR and press Enter. You should get a long output response.
Support web site The Airlink web site is updated frequently with Setup Wizards, Utilities, FAQs, and other documentation: http://www.airlink.com/support Contacting Technical Support For support assistance please email support@airlink.com or call 510-781-9760 Monday through Friday 5 AM to 5 PM Pacific Time (8 AM to 8 PM Eastern Time). Support is not available weekends or holidays. Raven CDMA User Guide for Verizon, version 2.
