AirLink Communications Raven GPRS User Manual

Airlink communications raven gprs user guide
Hide thumbs Also See for Raven GPRS:
Table of Contents

Advertisement

Quick Links

Raven
GPRS

User Guide

AirLink Communications, Inc.
Version 2.01
October 2005

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Raven GPRS and is the answer not in the manual?

Questions and answers

Summary of Contents for AirLink Communications Raven GPRS

  • Page 1: User Guide

    Raven GPRS User Guide AirLink Communications, Inc. Version 2.01 October 2005...
  • Page 2 Do not operate the AirLink Communications modem in any aircraft, whether the aircraft is on the ground or in flight. In aircraft, the AirLink Commu- nications modem MUST BE POWERED OFF. When operating, the AirLink Communications modem can transmit signals that could interfere with various on board systems.
  • Page 3: Table Of Contents

    Contents Introduction to Raven GPRS 1 CHAPTER 1 Raven Overview 1 Raven face and back 1 GPRS Overview 2 Connecting to Cingular using Serial 2 Establishing a Connection with GPRS 2 Using the Raven to connect to the Internet 3...
  • Page 4 Modem partially slid from case 8 Ejecting the SIM tray 8 Tray button 8 Empty SIM Tray 9 Inserting the SIM 9 SIM Tray with a SIM 9 Inserting the SIM 9 Raven Activation 10 CHAPTER 3 Connecting the Raven to your computer 10 Quick Start Guide and Setup Wizard 10 Setup Wizard Menu 11 Configuring the Raven using AT Commands 12...
  • Page 5 Dynamic Name Resolution 21 Configuring the Raven for Dynamic IP 22 Wireless ACE: Dynamic IP (IP Manager configuration) 22 Restrictions for Modem Name 23 Keepalive 24 CHAPTER 7 Configuring Keepalive 24 Keepalive Configuration in Wireless ACE 25 Data usage using Keepalive. 25 Host Modes 26 CHAPTER 8 AT Mode 27...
  • Page 6: Simple Network Management Protocol (Snmp)

    Port 38 Wireless ACE: Destination Port 38 Wireless ACE: Device Port 38 Default Power-up Mode 38 Wireless ACE: MD Configuration 38 IDs to IPs 39 Wireless ACE: Addr List 39 Dynamic IP 39 Wireless ACE: Modem Name and Domain 40 Configuring the Remote Ravens for Modbus with UDP 40 Port 40 Default Power-up Mode 41...
  • Page 7 Hardware Installation 53 CHAPTER 11 Raven Mounting Kit 53 Raven Mounting Bracket, part number 100-170-1009 A 54 Connecting the Antenna 55 Raven connectors 55 Connecting power 55 Connecting the Raven to a computer or other device 55 AT Commands 57 CHAPTER 12 Using Wireless Ace 57 Wireless ACE: Using AT Commands 57...
  • Page 8 Other Settings 90 Commands Usable with PassThru 91 Raven Specifications 97 CHAPTER 13 Physical Characteristics: 97 Data Services & RF Features: 97 Environmental: 98 Power Management: 98 Troubleshooting 99 Support web site 99 Contacting Technical Support 99 Cingular GPRS Raven User Guide Version 2.01...
  • Page 9: Introduction To Raven Gprs

    Introduction to Raven CHAPTER 1 GPRS The AirLink Raven uses serial to connect to a computer or other device and GPRS to connect to Cingular’s cellular network to allow cellular communication to the Internet or other network. Raven Overview The Raven's rugged form factor is ideal for industrial and commercial applications that require real-time communications.
  • Page 10: Chapter 1 Introduction To Raven Gprs

    The Raven has several built in features to make it more effective in a variety of set- tings. In addition, Airlink provides several modem tools to further enhance the capabilities of the Raven. These features and tools are introduced in this User Guide.
  • Page 11: Using The Raven To Connect To The Internet

    Introduction to Raven GPRS When your Raven is powered on, it automatically searches for cellular service using GPRS and establishes a PPP (Point to Point Protocol or “dial” up connection) link to Cingular’s network. As soon as the Raven receives its IP, it’s ready to create a TCP/IP network between your computer or device and Cingular’s network so you...
  • Page 12: Common Uses For The Raven

    Introduction to Raven GPRS If you need to contact the Raven, a device connected to the modem, or a host sys- tem using the modem, you need to have a known IP (such as one which is static) or domain name (an IP address which is converted by a DNS server into a word based name).
  • Page 13: Automation And Telemetry

    Introduction to Raven GPRS Automation and Telemetry FIGURE 4. Backup connection to the Internet FIGURE 5. Cingular GPRS Raven User Guide Version 2.01...
  • Page 14 Introduction to Raven GPRS Cingular GPRS Raven User Guide Version 2.01...
  • Page 15: Subscriber Identity Module (Sim)

    Subscriber Identity CHAPTER 2 Module (SIM) The Subscriber Identity Module (SIM) in the Raven 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 and it may be pre-installed by Cingular or Air- Link.
  • Page 16: Modem Back

    Subscriber Identity Module (SIM) Ejecting the SIM tray Cingular GPRS Raven User Guide Version 2.01 Modem back FIGURE 1. Slide the casing off of the modem and set it aside. Modem partially slid from case FIGURE 2. Using the tip of a closed pen, a paper clip, or PDA stylus, press the yellow but- ton between the two cards.
  • Page 17: Empty Sim Tray

    Subscriber Identity Module (SIM) Slide the tray out of the slot. Empty SIM Tray FIGURE 4. Inserting the SIM Place the SIM into the tray and gently press to click it into place. SIM Tray with a SIM FIGURE 5. Slide the tray back into the modem and gently press to click it into place.
  • Page 18: Chapter 3 Raven Activation

    Quick Start Guide and Setup Wizard The preferred way to configure and activate your Raven is via the AirLink Setup Wizard for Cingular GPRS. The Quick Start Guide will lead you through the using the Setup Wizard.
  • Page 19: Setup Wizard Menu

    Raven Activation • The Cingular GPRS Raven Quick Start Guide is also available at the AirLink web site. 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.
  • Page 20: Configuring The Raven Using At Commands

    Raven Activation Configuring the Raven using AT Commands An alternate method to configure and activate your Raven is by AT commands (full listing beginning on page 61) sent directly to the modem via a terminal application (page 58). This method is recommended only in situations where the Setup Wizard is not available and/or the configuration for the Raven is unusual.You can also con- figure your modem using Wireless ACE (page 15) or AceNet (page 16) using a template built in Wireless ACE.
  • Page 21: Chapter 4 Raven Utilities

    For additional information on a specific utility, please refer to the user guide for that utility. These utilities, except AceNet, are free of charge to those who own AirLink modems. You can download them and their user guides from the AirLink web site: http://www.airlink.com/support. Contact your dealer or AirLink for information on AceNet.
  • Page 22: Aceview

    Raven Utilities AceView AceView is a low-profile monitoring tool to view the status of your AirLink Raven and display network status, IP address, RSSI strength, firmware version, and other basic information. You can connect to your Raven locally or remotely using a known IP address or a fully qualified domain name.
  • Page 23: Wireless Ace And Wireless Ace Web

    Raven Utilities Wireless ACE and Wireless ACE Web Wireless AirLink Configuration Executive (ACE) and Wireless Ace Web allow you to monitor your Raven remotely. Wireless ACE Web has a web-based interface and covers nearly the same range of features a Wireless ACE. Features discussed in this section apply to both versions unless otherwise noted.
  • Page 24: Acenet

    Raven Utilities 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.
  • Page 25: 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 set the Raven to only respond to a serial con- nection.
  • Page 26: Dns: Using Names Instead Of Ips

    DNS: Using Names CHAPTER 5 Instead of IPs 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.
  • Page 27: Chapter 5 Dns: Using Names Instead Of Ips

    DNS: Using Names Instead of IPs You can use AT commands (page 61), Wireless ACE (page 15), and ACE Net (page 16) using a template built from Wireless ACE to configure DNS in your Raven. Wireless ACE: DNS FIGURE 1. *DNS1 and *DNS2 - Set these to your primary and secondary DNS servers.
  • Page 28: Chapter 6 Ip Manager

    Since Cingular frequently does 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.
  • Page 29: Fully Qualified Domain Name

    AirLink.com • http:// is the protocol (html or web) used to access the webpage for AirLink Dynamic Name Resolution When an IP address is not expected to change, the DNS server can indicate to all queries that the address can be cached and not looked up for a long period of time.
  • Page 30: Configuring The Raven For Dynamic Ip

    (page 58), Wireless ACE (page 15), and ACE Net (page 16) using a template built from Wireless ACE. To configure your AirLink modem to be addressed by name, the modem needs to have 4 elements configured. Cingular GPRS Raven User Guide Version 2.01 Note: Earlink.com is a domain name owned and registered by AirLink...
  • Page 31: Restrictions For Modem Name

    IP Manager IP Address: The IP or domain name of the dynamic DNS server. Earlink.com is the IP Manger server provided by AirLink. Note: To use the name here instead of the IP, you need to have DNS set up in your Raven. See “DNS: Using Names Instead of IPs”...
  • Page 32: Chapter 7 Keepalive

    Keepalive CHAPTER 7 It is not uncommon for your Raven to be disconnected from Cingular 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 Cingular by ping- ing an IP address after a specified period of inactivity.
  • Page 33: Keepalive Configuration In Wireless Ace

    Keepalive To set the Keepalive using Wireless ACE, select Other from the menu on the left. Keepalive Configuration in Wireless ACE FIGURE 1. *IPPING sets the interval, in minutes, you want Keepalive to test the network con- nection. To disable Keepalive, set *IPPING to 0 (default setting). *IPPINGADDR sets the IP address you want to use for the test.
  • Page 34: Chapter 8 Host Modes

    Host Modes CHAPTER 8 The Raven can be in one of six communication modes as the Host to the computer or other device attached to the serial port of the Raven. AT: The Raven accepts and responds to standard, Hayes-style AT commands. This is enabled by default.
  • Page 35: At Mode

    Host Modes in the AT Command listing, page 69) to the desired mode. If this setting is non- zero, the modem will enter the specified mode after 5 seconds. If you want to can- cel this behavior, the ATMD0 command can be used before the 5-second time-out expires.
  • Page 36: Passthru Mode

    Host Modes For example, possible output to the AT command "AT<CR>" (assuming quiet mode is not on) is: PassThru Mode In PassThru mode, the Raven does not behave normally, all serial communication is passed directly between the internal hardware and the computer connected directly to the modem.
  • Page 37: Ppp Mode

    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<CR>...
  • Page 38: Udp Pad Mode

    Host Modes UDP Pad Mode When the modem is in UDP PAD (Packet Assembly and Disassembly) Mode, all characters received on the serial port are assembled into UDP packets and sent to the Raven’s remote IP address/port, and any packets received from the same IP/ port-destined for the Raven’s Device Port (see *DPORT)--are disassembled and dumped onto the serial line.
  • Page 39: Reliable Udp

    Host Modes 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. The session, started by either method, will be terminated when no data has been sent or received for the S82 period.
  • Page 40: Multicast Udp

    Host Modes 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.
  • Page 41: Tcp Auto Answer

    Host Modes TCP packet assembly is affected by the values of S50 (PAD Forwarding Time-out) and S51 (PAD Forwarding Character). Data received in the serial buffer will be transmitted when the idle inter-character time-out specified in S50 (in tenths of sec- onds) occurs or when a character is received that matches S51 (if non-zero).
  • Page 42: Hybrid Mode Settings

    Host Modes Cingular GPRS Raven User Guide Version 2.01 Hybrid Mode Settings TABLE 1. AT Setting Hybrid (MD5) Hybrid2 (MD6) *UDPLAST...
  • Page 43: Modbus/Bsap Configuration

    Modbus/BSAP CHAPTER 9 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.
  • Page 44: Telemetry

    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.
  • Page 45: Modbus Tcp/Ip

    Modbus/BSAP Configuration to a user-created program stored in its memory. Containing inputs and outputs sim- ilar to an RTU, PLCs are frequently used for typical relay control, sophisticated motion control, process control, Distributed Control System and complex network- ing. Modbus TCP/IP Modbus TCP/IP simply takes the Modbus instruction set and wraps TCP/IP around it.
  • Page 46: Configuring The Raven At The Polling Host For Modbus On Udp

    Modbus/BSAP Configuration Configuring the Raven at the Polling Host for Modbus on UDP You can use either Wireless ACE (page 15 and page 57), direct serial communica- tion or Telnet (page 58) to configure the modem using AT commands (page 61). This section covers standard Modbus, variations may need additional commands (AT Commands: page 87).
  • Page 47: Ids To Ips

    Modbus/BSAP 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.
  • Page 48: Wireless Ace: Modem Name And Domain

    Modbus/BSAP Configuration 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. Wireless ACE: Modem Name and Domain FIGURE 6.
  • Page 49: Default Power-Up Mode

    Modbus/BSAP Configuration 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 03- UDP (normal UDP operation) as the value for MD. Wireless ACE: UDP Power-up Mode FIGURE 7.
  • Page 50: Rtu Settings

    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. Raven mounted in an enclosure with an RTU FIGURE 9.
  • Page 51: Rtu To Raven Setup

    Modbus/BSAP Configuration RTU to Raven setup FIGURE 10. Power Connections FIGURE 11. Cingular GPRS Raven User Guide Version 2.01...
  • Page 52: Simple Network Management Protocol (Snmp)

    Simple Network CHAPTER 10 Management Protocol (SNMP) The Raven is 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. The SNMP management system is generally composed of agents (such as your Raven, a router, a UPS, a web server, a file server, or other computer equipment) and a Net- work Management Station (NMS) which monitors all the agents on a specific net-...
  • Page 53: Management Information Base (Mib)

    The trap is a “snap-shot” of the settings and status of the Agent’s device which is sent as a report to the NMS in a form that can be parsed and stored in the MIB. See below (page 48) for an example of the trap from an AirLink modem. Raven SNMP Configuration...
  • Page 54: Security Level

    Simple Network Management Protocol (SNMP) Security Level *SNMPSECLVL sets the security level and which version of SNMP communica- tions are used. User Name and Password The user name is 'user'. The user name cannot be changed. The Raven's password is used as the SNMP password (default is '12345'). To change the password in the Raven, select Modem from the top menu line in Wireless ACE.
  • Page 55: Wireless Ace: Changing The Raven Password - Menu Option

    Simple Network Management Protocol (SNMP) Wireless ACE: Changing the Raven Password - Menu Option FIGURE 3. The current password will be pre-entered. As you type the new password and con- firm it, the characters you type will be obscured by “x”. Wireless ACE: Changing the Raven Password FIGURE 4.
  • Page 56: Trap Destination

    OBJECT IDENTIFIER ::= { internet 4 } enterprises OBJECT IDENTIFIER ::= { private 1 } airlink OBJECT IDENTIFIER ::= { enterprises 20542 } general OBJECT IDENTIFIER ::= { airlink 1 } common OBJECT IDENTIFIER ::= { airlink 2 } status OBJECT IDENTIFIER ::= { airlink 3 }...
  • Page 57 Simple Network Management Protocol (SNMP) 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 } aleosSWVer OBJECT-TYPE SYNTAX DisplayString...
  • Page 58 Simple Network Management Protocol (SNMP) Cingular GPRS Raven User Guide Version 2.01 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...
  • Page 59 Simple Network Management Protocol (SNMP) serialPortSettings OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 9 } serialPortFlowControl OBJECT-TYPE SYNTAX INTEGER { none(0), hardware(2), software(4) } MAX-ACCESS read-only STATUS current ::= { common 10 } -- STATUS -- ipAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS...
  • Page 60 Simple Network Management Protocol (SNMP) Cingular GPRS Raven User Guide Version 2.01 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...
  • Page 61: Chapter 11 Hardware Installation

    Hardware Installation CHAPTER 11 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 ele- ments (sun, rain, etc.).
  • Page 62: Raven Mounting Bracket, Part Number 100-170-1009 A

    Hardware Installation Raven Mounting Bracket, part number 100-170-1009 A FIGURE 1. Cingular GPRS Raven User Guide Version 2.01...
  • Page 63: Connecting The Antenna

    Hardware Installation Connecting the Antenna Your Raven will work with most standard cellular antennas with a TNC connector and rated to work with GPRS technology. Connect the antenna or RF cable directly to the TNC connector on the back of the Raven. Raven connectors FIGURE 2.
  • Page 64 Hardware Installation Your Raven can also be connected to a serial cable that is connected to a USB to serial device connected to a computer or other device which does not have an avail- able serial port but does have USB. Cingular GPRS Raven User Guide Version 2.01...
  • Page 65: Chapter 12 At Commands

    AT Commands CHAPTER 12 Just as with a Hayes compatible analog modem, the Raven parameters can all be configured with AT commands. Wireless ACE and Wireless ACE Web (See “Wire- less ACE and Wireless ACE Web” on page 15. and below) are a graphical interface for the AT commands and it is highly recommended that you use one of them to modify any parameters, however a terminal emulation application, such as Telnet, can be used instead.
  • Page 66: Wireless Ace: Toolbar

    AT Commands For more information on using Wireless ACE or Wireless ACE Web, please refer to the Wireless ACE User Guide. Using Telnet Terminal Emulation Most installations of Microsoft Windows come with a version of HyperTerminal. Start>All Programs>Accessories>Communications>HyperTerminal Cingular GPRS Raven User Guide Version 2.01 To set or commit the changes in the modem, use the Write button at the top of Wireless ACE interface.
  • Page 67: Hyperterminal: Tcp/Ip Settings

    AT Commands HyperTerminal: TCP/IP Settings FIGURE 4. When HyperTerminal connects to the Raven, you may be prompted for a pass- word. The default password is 12345. When you press Enter, you should get back a reply of “OK”. HyperTerminal: AT mode via Telnet FIGURE 5.
  • Page 68: Hyperterminal: Connection Name

    AT Commands Cingular GPRS Raven User Guide Version 2.01 Choose a name for your connection, such as Raven. The name and icon are only for your own reference so you can find the connection at a later date. HyperTerminal: Connection Name FIGURE 6.
  • Page 69: At Commands

    AT Commands 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. AT Commands The tables below list the AT commands, their parameters, and explain what they do. •...
  • Page 70: Information And Status

    AT Commands Cingular GPRS Raven User Guide Version 2.01 Information and Status TABLE 1. Command Details I[n] n=0 Product name ( n=1 The Raven’s firmware (ALEOS) version, hardware ID, and copyright. n=2 The OEM module's firmware version and relevant hardware ID. n=3 The OEM module's unique ID (ESN).
  • Page 71 AT Commands Information and Status TABLE 1. Command Details *NETSTATE? The current network state: Connecting To Network = The Raven is in the process of trying to connect to the GPRS network. Network Authentication Fail = Authentication to the GPRS network has failed. Verify settings to activate the Raven.
  • Page 72: Basic Commands

    AT Commands For most of the commands in the rest of the tables, you can query the current status of the associated register by substituting a “?” for any parameters, omitting the “=” if there is one, i.e. for the command *DPORT=n, you would enter AT*DPORT?. Command The "+"...
  • Page 73: Activating (Provisioning)

    AT Commands Basic Commands TABLE 2. Command Parameters none *DATZ=n The preferred method of activating (provisioning) the modem is using the Setup Wizard. However, there are special circumstances when commands may be used instead. Note: You may need go into PassThru mode to activate the will need to refer to the PassThru Mode table (page 76) and the Commands Usable with PassThru table (page 91).
  • Page 74 AT Commands *NETUID=uid OPRG=n Cingular GPRS Raven User Guide Version 2.01 Activating (Provisioning) TABLE 3. uid=user id (up The login that is used to login to the Cingular to 64 bytes.) network Enables/disables over-the-air firmware upgrading of the Raven. Disables over-the-air programming. Enables over-the-air programming.
  • Page 75: Cellular Network (Cingular Gprs)

    AT Commands The Raven’s cellular network is the connection to Cingular GPRS and remote devices or computers. Cellular Network (Cingular GPRS) TABLE 4. Command Parameters *NETALLOWZEROIP=n *NETCHAN? none *NETERR? none *NETIP? none *NETOK? none *NETOP? none *NETRSSI? none *NETSTATE? none *NETWDOG=n n=minutes Cingular GPRS Raven User Guide Version 2.01...
  • Page 76 AT Commands Command +COPS=mode,[format] [,oper] Cingular GPRS Raven User Guide Version 2.01 Cellular Network (Cingular GPRS) TABLE 4. Parameters Details Manually specify an operator. mode=0 automatic - any affiliated carrier [default] mode=1 manual - use only the operator <oper> specified mode=4 manual/automatic - if manual selection fails, goes to automatic mode...
  • Page 77: Local Network And Host Modes

    AT Commands The Local network for the Raven is the one to which it is connected physically via the serial port to your computer, device, hub, or switch. The Raven has the ability to provide some NAT (network address translation) to pass communication from the GPRS network and the Internet to the local device(s) and network.
  • Page 78 AT Commands Command S0=n S7=n S23=[speed],[databits] [parity][stop bits] S50=n Cingular GPRS Raven User Guide Version 2.01 Local Network and Host Modes TABLE 5. Parameters Details 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.
  • Page 79 AT Commands Local Network and Host Modes TABLE 5. Command Parameters S51=n n=ASCII code S82=n S83=n S211=n S221=n n = 0 - 255 Cingular GPRS Raven User Guide Version 2.01 Details PAD data forwarding character. no forwarding character ASCII code of character that will cause data to be for- warded.
  • Page 80 AT Commands Command TCPS=n TCPT=n &Cn &Dn &Sn Cingular GPRS Raven User Guide Version 2.01 Local Network and Host Modes TABLE 5. Parameters Details TCP connection time-out (TCPT) units. TCPT specifies minutes. TCPT specifies seconds. n = minutes TCP connection time-out. Specifies a time interval upon (TCPS=0) or which if there is no in or outbound traffic through a TCP seconds...
  • Page 81 AT Commands Local Network and Host Modes TABLE 5. Command Parameters *CTSE=n *DU=n *ENQ=n *HOSTMODE? none *HOSTNETMASK=n.n.n.n n.n.n.n = subnet mask, i.e. 255.255.255.0 *HOSTPAP=n Cingular GPRS Raven User Guide Version 2.01 Details Clear To Send Enable This feature asserts CTS when there is a network con- nection.
  • Page 82 AT Commands Command *HOSTPEERIP =d.d.d.d *HOSTPRIVIP =d.d.d.d *HOSTPRIVMODE =n *MODEMHISPEED=n *UALL=n Cingular GPRS Raven User Guide Version 2.01 Local Network and Host Modes TABLE 5. Parameters Details d.d.d.d=local or Set or query the IP address that can be used to directly peer IP of contact the Raven once a PPP connection is established.
  • Page 83 AT Commands Local Network and Host Modes TABLE 5. Command Parameters *UDPLAST=n *USD=n \APPP none \ASLIP none PassThru Mode is used to communicate directly to the Raven’s internal hardware (OEM module). Cingular GPRS Raven User Guide Version 2.01 Details If enabled, sets S53 to the last accepted IP address through UDP auto answer.
  • Page 84: Passthru Mode

    AT Commands Command \APASSTHRU Note: This mode is not available through the remote AT telnet server. *CSX1=n *PTINIT=n *PTREFRESH=n *RESETPERIOD=n Cingular GPRS Raven User Guide Version 2.01 PassThru Mode TABLE 6. Parameters Details none Set modem operation to pass through mode. This will pass any characters received on the serial port directly to the internal OEM module and output any characters from the internal OEM module out the serial port.
  • Page 85: Telnet

    AT Commands It is possible to communicate with the Raven across a TCP/IP network (using Cin- gular’s network and the Internet). Telnet provides a terminal style connection to the Raven. Note: Telnet is not a secure communications protocol. Telnet TABLE 7. Command Parameters S60=n...
  • Page 86: Time And Date

    AT Commands Time and Date in the Raven is set to UTC (Coordinated Universal Time) and then adjusted for local time (i.e. California is UTC-8 and New York is UTC-5). Time is expressed in 24-hour format, date manually or you can have it set automatically with a regular query to an Inter- net time server (such as time.nist.gov) using SNTP (Simple Network Time Proto- col).
  • Page 87: Dns

    AT Commands Logging TABLE 10. Command Parameters *DBGCOMLVL=n *DBGEVTLOGCLEAR none *DBGIPLVL=n *DBGPPPLVL=n n=1-3 DNS settings in the Raven allow the modem to use domain names instead of IPs to contact other Internet hosts. TABLE 11. Command Parameters *DNSn=d.d.d.d n=1 or 2 d.d.d.d = IP of domain server *DNSUPDATE=n...
  • Page 88: Ipmanager

    Raven by name as if it had a static IP.” on page 20.) is a service from AirLink which allows a Raven with a dynamic IP to be contacted as if it had a static IP by using a Fully Qualified Domain Name.
  • Page 89: Keepalive

    AT Commands IPManager TABLE 12. Command Parameters *IPMGRUPDATEn=m n= 1 or 2 m=5-255 *MODEMNAME=[name] name = domain name (i.e. eair- link.com) Caution: Only letters, num- bers, and hyphens can be used. Keepalive (See “Keepalive” on page 24.) allows the Raven to stay connected to the cellular network even when there are periods of inactivity.
  • Page 90 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.
  • Page 91: Direct Communication

    AT Commands Direct Communication can be used with the Raven to contact other Internet devices to pass information or other tasks. Direct Communication TABLE 14. Command Parameters D[method][d.d.d.d][/ppppp] method = P - Establish a UDP connection D[method][@name][/ppppp] T - Establish a TCP connection N - Establish a Telnet connec-...
  • Page 92 AT Commands Command S53=[method][d.d.d.d][/ ppppp] *DPORT=n *MSCIUPDADDR=name [/port] *MSCIUPDPERIOD=n Cingular GPRS Raven User Guide Version 2.01 Direct Communication TABLE 14. Parameters Details method = Destination IP address, port, and method. These are used as defaults for the D (Dial) AT command. P - UDP Examples: T - TCP...
  • Page 93: Smtp (Email)

    AT Commands SMTP (Simple Mail Transfer Protocol) is the de facto standard for email transmis- sion across the Internet. The Raven can send messages using SMTP if it has been configured to use a mail server. SMS (Simple Message Service) is another way to send messages via Cingular’s cellular network.
  • Page 94 AT Commands Command *SMTPSUBJ=[subject] *SMTPUSER=[user] Cingular GPRS Raven User Guide Version 2.01 SMTP (email) TABLE 15. Parameters Details subject=SMTP Allows configuration of the default Subject to use if one message subject isn't specified in the message by providing a "Subject: xxx"...
  • Page 95: Modbus Settings

    AT Commands Modbus, commonly used with telemetry devices, allows a connection via serial port to the modem. See “Modbus/BSAP Configuration” on page 35. Modbus Settings TABLE 16. Command Parameters IPL=n MDhh hh (hex byte) = 00 - normal 01 - SLIP mode 02 - PPP mode 03 - UDP mode 04 - TCP mode...
  • Page 96 AT Commands Command MVMSK=hh MVOFF=n MVOPT=n MVTYP=n Cingular GPRS Raven User Guide Version 2.01 Modbus Settings TABLE 16. Parameters Details hh=hex value Modbus Variant ID Mask (00 [default] no Byte hex mask to use when extracting the ID. Specify mask, all 8 bits which bits in the ID field to use.
  • Page 97 AT Commands Modbus Settings TABLE 16. Command Parameters RKEY=n S53=[method][d.d.d.d][/ method = ppppp] P - UDP T - TCP N - Telnet d.d.d.d = IP address or name ppppp = the port address *DPORT=n n=1-65535 Simple Network Management Protocol (SNMP) can be used to monitor devices connected to a network for any conditions which warrant administration attention.
  • Page 98: Snmp

    AT Commands Command \ACEPW=pw *SNMPPORT=n *SNMPSECLVL=n *SNMPTRAPDEST=[host]/ [port] Command *NUMTOIP=n \ACEPW=pw Cingular GPRS Raven User Guide Version 2.01 SNMP TABLE 17. Parameters Details pw=password Change the ACE password to a new value. Password is case-sensitive. Default password is 12345. Ex. AT\ACEPAW=new123 This controls which port the SNMP Agent listens on.
  • Page 99: Commands Usable With Passthru

    AT Commands When the Raven nications, are disabled. When the modem is in PassThru mode, you are communi- cating directly to the OEM module. Only this subset of AT commands will work while in PassThru mode. It is also necessary to note the model number of your modem, since the model number corresponds to the internal module.
  • Page 100 AT Commands Command S3=n S4=n S5=n S6=n S7=n S8=n S9=n S10=n Cingular GPRS Raven User Guide Version 2.01 Commands Usable with PassThru TABLE 19. Parameters Details Carriage Return Character n=0-127 The standard end of line character used to indicate the end of an AT command.
  • Page 101 AT Commands Commands Usable with PassThru TABLE 19. Command Parameters S11=n none &F none &V none &W none !STATUS none C3210 !RSSI C3210 none +CBIP? none +CGSN none +CICB C3211 Cingular GPRS Raven User Guide Version 2.01 Details n=50-255 DTMF Dialing Speed (Remote) This specifies the duration of tones in DTMF dialing.
  • Page 102 AT Commands Command +CIMI +CMIP? +CSQ +CSS? +GCAP +WGMM +WHWV +WIMI=[num] C3211 +WMDN=[num] C3211 +WSID=[idx], [SID],[NID] C3211 Cingular GPRS Raven User Guide Version 2.01 Commands Usable with PassThru TABLE 19. Parameters Details none Mobile Station IP Address none Received Signal Strength and Channel Frame Error Rate none Serving System none...
  • Page 103 AT Commands Commands Usable with PassThru TABLE 19. Command Parameters +WSPC=[lock],[nnnnnn] lock= 0 - OTKSL(One Time Key Sub- C3211 sidy Lock) 1 - MSL (Master Subsidy Lock) nnnnnn=6 digit unlock code +WSSW none +WVSS=[n] n=roam type 0 - Home Only C3211 1 - Automatic 2- Automatic A...
  • Page 104 AT Commands Command ~NAMLCK=nnnnnn C3210 ~NAMVAL= nam[,num,sid,nid] C3210 Cingular GPRS Raven User Guide Version 2.01 Commands Usable with PassThru TABLE 19. Parameters Details nnnnnn=6 digit The NAMLCK is the modem's 6-digit OTSL (One Time unlock code Subsidy Lock), MSL (Master Subsidy Lock), or SPC (Service Provisioning Code).
  • Page 105: Raven Specifications

    Raven Specifications CHAPTER 13 Physical Characteristics: • • • • • • Data Services & RF Features: • • • • • • Cingular GPRS Raven User Guide Version 2.01 Weight: < 1 lb. Size: 3” wide x 1.1” high x 5.1" long Status LEDs RF Antenna Connector: 50 Ohm TNC Receive Diversity RF Antenna Connector: 50 Ohm SMA...
  • Page 106: Environmental

    Raven Specifications • • Environmental: • • • Power Management: • • • Cingular GPRS Raven User Guide Version 2.01 Multislot Class 8 Circuit Switched Data Capable (14,400 Transparent and Non-Transparent Modes) Operating ranges: -30°C to +°C 10% duty cycle limit above 60°C Humidity: 5%-95% Non-condensing Low power consumption Input Voltage: 10 VDC to 28 VDC...
  • Page 107: Troubleshooting

    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 6 AM to 5 PM Pacific Standard Time. Support is not available weekends or holidays.

Table of Contents

Save PDF