Airlink Raven GPRS manual

Raven GPRS User Guide AirLink Communications, Inc. V ersion 2.01 October 2005[...]

i Cingular GPRS Raven Us er Guide V ersion 2.01 Information in this do cument is subject to change without notice ©Copyright AirLink Communications , In c., 1993- 2005. All rights reserv ed. • W ARNING The antenna(s) used for this transmitte r must be installed to provide a separa tion distance of at least 20 cm from all persons and mu st not be[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 ii Contents CHAPTER 1 Intr oduction to Raven GPRS 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 Using GPRS to Communicat e directly to your Device 3 Common Uses for the Rav[...]

Cingular GPRS Raven User Gui de V ersion 2.01 iii 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 CHAPTER 3 Raven Activation 10 Connecting the Raven to your compu ter 10 Quick Start Guide and Setup W izard 10 Setup Wizard Menu 11 Configuring the Ra[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 iv Dynamic Name Resolution 21 Configuring the Raven for Dynamic IP 22 Wireless ACE: Dynamic IP (IP Manager configuration) 22 Restrictions for Modem Name 23 CHAPTER 7 Keepalive 24 Configuring Keepalive 24 Keepalive Configuratio n in Wireless ACE 25 Data usage using Keepalive. 25 CHAPTER 8 Host Modes 26 A[...]

Cingular GPRS Raven User Gui de V ersion 2.01 v 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 Raven s for Modbus with UDP 40 Port 40 Default Power -[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 vi CHAPTER 1 1 Har dwar e Installation 53 Raven Mounting Kit 53 Raven Mounting Bracket, part number 100-1 70-1009 A 54 Connecting the Antenna 55 Raven connectors 55 Connecting power 55 Connecting the Raven to a computer or other device 55 CHAPTER 12 A T Commands 57 Using W ireless Ace 57 Wireless ACE: U[...]

Cingular GPRS Raven User Gui de V ersion 2.01 vii Other Settings 90 Commands Usable with PassThru 91 CHAPTER 13 Raven Specifications 97 Physical Chara cteristics: 97 Data Services & RF Featur es: 97 Enviro nmental: 98 Power Management: 98 Troubleshooting 99 Support web site 99 Contacting T echnical Support 99[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 1 CHAPTER 1 Intr oduction to Raven GPRS The AirLink Raven uses serial to connect to a computer or other device and GPRS to connect to Cingular’ s cellu lar net work to allo w cellular communication to the Internet or other network. Raven Overview The Raven's rugged form fact or is ideal for indus[...]

Introduction to Rave n GPRS 2 Cingular GPRS Raven Us er Guide V ersion 2.01 The Raven has several built in featu res to make it more effective in a variety of set- tings. In additi on, Airlink provides several modem tools to further en hance the capabilities of the Raven. These features and tools are introduced in this User Guide. • W ireless ACE[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 3 Introduction to Rav en GPRS When your Raven is p owered on, it auto matically searches for cellular service using GPRS and establishes a PPP (Poin t 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 ne[...]

Introduction to Rave n GPRS 4 Cingular GPRS Raven Us er Guide V ersion 2.01 If you need to cont act 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 conver ted by a DNS server into a word based name). Most ISPs (cellular i[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 5 Introduction to Rav en GPRS FIGURE 4. Automation and T elemetry FIGURE 5. Backup connection to the Internet[...]

Introduction to Rave n GPRS 6 Cingular GPRS Raven Us er Guide V ersion 2.01[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 7 CHAPTER 2 Subscriber Identity Module (SIM) The Subscriber Identity Modu le (SIM) in th e Raven is a smartcard securely storing the key identifying a mo bile subscriber . Generally , you wi ll only need to install the SIM once in the life of the modem and it may be pre-installed by C ingular or Air- Li[...]

Subscriber Identity Module (SIM) 8 Cingular GPRS Raven Us er Guide V ersion 2.01 FIGURE 1. Modem ba ck 3. Slide the casing of f of the modem and set it as ide. FIGURE 2. Modem partially slid from case Ejecting the SIM tray 4. Using the tip of a closed pen, a paper clip, or PDA stylus, press the yellow but- ton between the two cards. FIGURE 3. Tr a [...]

Cingular GPRS Raven Us er Guide V ersion 2.01 9 Subscriber Identity Module (SIM) 5. Slide the tray out of the slot. FIGURE 4. Empty SIM T ray Inserting the SIM 6. Place the SIM into the tray and gently press to click it into place. FIGURE 5. SIM T ra y with a SIM 7. Slide the tray back into the modem a nd gently pres s to click it into place. FIGUR[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 10 CHAPTER 3 Raven Activation Y our Raven needs specific parameters before it can operate on the Cingular GPRS network. Cing ular will provide you with the necessary p arameters to get the Raven configured. Connecting the Raven to your computer Y our Raven’ s serial port can be connected directly to m[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 11 Raven Activation • The Cingular GPRS Raven Quick Start Gu ide is also available at the AirLink web site. Note: The web site may have a more recent Setup W izard and Quick Start Guide than those included with your Raven. It is recommended that you check with the web site for the latest version befor[...]

Raven Activation 12 Cingular GPRS Raven Us er Guide V ersion 2.01 Configuring the Rave n using A T Commands An alternate method to configure and activ ate y our Raven is by A T commands (full listing beginning on page 61) sent direct ly to the mo dem via a terminal application (page 58). This method is recommended only in situations where the Setup[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 13 CHAPTER 4 Raven Utilities AirLink offers a suite of utilities to o ptimize your Raven’ s performance, allowing you to remo tely view stat us and make changes to the confi guration as needed. • AceV iew • W irel ess ACE and Wireless ACE W eb • AceNet • Modem Doctor This section of the Raven [...]

Raven Utilities 14 Cingular GPRS Raven Us er Guide V ersion 2.01 AceV iew AceV iew is a low-profile monitoring tool to view the status of your AirLink Raven and display network status, IP address, RS SI strength, firmware versio n, and other basic information. FIGURE 1. AceV iew Y ou can connect to your Raven locally or remotely using a known IP ad[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 15 Raven Utilities W ir eless ACE and W ir eless ACE W eb W ireless AirLink Configuration Executive (ACE) and Wi reless A ce W eb allow you to monitor your Raven remotely . W ireless ACE W eb has a web-based interface and covers nearly the same range of features a W ireless ACE. Features discussed in th[...]

Raven Utilities 16 Cingular GPRS Raven Us er Guide V ersion 2.01 AceNet W ith AceNet you can mo nitor several AirLink modems at the same time. The modems can be connecte d locally or remote. Several features can be displayed and logged. AceNet is a sepera te product wh ich can be pur chased from AirLink. FIGURE 4. AceNet Using a template from W ire[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 17 Raven Utilities Modem Doctor Modem Doctor is a troubleshooting uti lity . This utility will allow you to get a log file of the Raven activity which you can th en send to AirLink support, erase th e current configuration completely , and set the Raven to only respon d to a serial con - nection. FIGURE[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 18 CHAPTER 5 DNS: Using Names 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 nu mber being like the IP . Y ou can contact the house either b[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 19 DNS: Using Names Instead of IPs Y ou can use A T commands (page 61), W ireless ACE (page 15), and ACE Net (page 16) using a template built from W i reless ACE to configure DNS in y our Raven. FIGURE 1. Wireless ACE: DNS *DNS1 and *DNS2 - Set these to your primary and second ary DN S servers. These ma[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 20 CHAPTER 6 IP Manager IP Manager translates a dynamic IP addres s to a fully qualified domain name so you can contact the Raven by name as if it had a static IP . Since Cingular frequently does not offer st atic IP addresses, IP Manager is a free service provided by AirLink for your Raven to translate[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 21 IP Manager Fully Qualified Domain Name A fully qualified domain name (FQDN ) generally has several parts. • T op Level Domain (TDL): The TDL is the ending suffix for a domain name (.com, .net, .or g, etc.) • Country Code T op Level Domain (ccTDL): This suf fix is often used after the TDL for most[...]

IP Manager 22 Cingular GPRS Raven Us er Guide V ersion 2.01 If the Raven is configured for Dynamic IP , when the Raven first connects to the Internet, it sends a IP cha nge notification to IP Manager . IP Manger will acknowl- edge the change and update the DNS record. The changed IP address will then be the address for the Raven’ s configured nam[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 23 IP Manager 3. IP Manager IP Addr ess: The IP or domain name of the dynamic DNS server . Earlink.com is the IP Manger server provided by AirLink. Note: T o use the name her e in stead of the IP , you need to have DNS set up in your Raven . See “DNS: Using Names Instead of IPs” on page 18. 4. IP Ma[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 24 CHAPTER 7 Keepalive It is not uncommon for you r 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 I[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 25 Keepalive T o set the Keepalive using Wi reless ACE, select Other from the menu on the left. FIGURE 1. Keepaliv e Configuration in Wireless ACE *IPPING sets the interval, in minutes, you want Keepaliv e to test the network con- nection. T o disable Keepal ive, set *IPPING to 0 (defaul t settin g). *I[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 26 CHAPTER 8 Host Modes The Raven can be in one of six communication modes as the Host to the computer or other device attached to th e serial port of the Raven. AT: The Raven accepts and responds to standard, Hayes-style A T commands. This is enabled by default. PassThru: Direct connection to internal [...]

Cingular GPRS Raven Us er Guide V ersion 2.01 27 Host Modes in the A T Command listing, p age 69) to t he desired mode. If t his setting is n on- zero, the modem will enter th e specified mode after 5 seconds. If you want to can- cel this behavior , the AT M D 0 command can be used befo re the 5-second time-out expires. If the modem is in any mode [...]

Host Modes 28 Cingular GPRS Raven Us er Guide V ersion 2.01 For V=0 , (T erse mode), a num eri c result code is output with a single trail ing <CR> (no <LF> is output), while any A T query response is followed by <CR><LF> (there is no preceding output). For example, possible output to th e A T command "A T<CR>&quo[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 29 Host Modes PPP Mode In PPP mode, the Raven acts as a PPP serv er , providing an IP address, and DNS servers (if available) to the Host. PPP mode is entered from the A T mode by using any of the following commands: AT A P P P <CR> A TDT10.0.0.1 <CR> A TDT1000 1 <CR> A TD# 19788 <[...]

Host Modes 30 Cingular GPRS Raven Us er Guide V ersion 2.01 UDP Pad Mode When the modem is in UDP P AD (Packet As sembly 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 Devic[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 31 Host Modes commands), while allowing sessions to be establis hed 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 me thod, will be term inated when no da ta has been sent or received for the S82 per[...]

Host Modes 32 Cingular GPRS Raven Us er Guide V ersion 2.01 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 . T o avoid flooding the network, the packets are sent to each client with a 20ms pause in between. The receipt of U[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 33 Host Modes TCP packet assembly is af fected by the values of S50 (P AD Forwarding T ime-out) and S51 (P AD Forwarding Character). Data received in the serial buf fer will be transmitted when t he idle inter- character time-out specified in S50 (in tenth s of sec- onds) occurs or when a charact er is [...]

Host Modes 34 Cingular GPRS Raven Us er Guide V ersion 2.01 T ABLE 1. Hybrid Mode Settings A T S etting Hybrid (MD5) Hybrid2 (MD6) MD 3 3 S82 2 2 S0 1 1 *UDPLAST 0 1[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 35 CHAPTER 9 Modbus/BSAP Configuration The Raven supports Modbus ASCII, Modbus R TU, BSAP , and can also emulate other protocols like DF1 or others using its Modbus V ariable feature. Modbus Overview The Modbus Protocol, developed by Modic on in 19 79, provides for client-server (also referred to as mas[...]

Modbus/BSAP Configuration 36 Cingular GPRS Raven Us er Guide V ersion 2.01 Te l e m e t r y T elem etry is an automate d communications pr ocess by which data is collected from instruments located at remote or inacces sible points and tran smitted to receiving equipment for measurement, moni toring , display , and recordi ng. Transmission of the in[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 37 Modbus/BSAP Configuration to a user-created program stored in its memory . Containing inputs and outputs sim - ilar to an R TU, PLCs are frequently used for typical relay control, sophisticated motion control, process control, Distri but ed Control System and complex network - ing. Modbus TCP/IP Modb[...]

Modbus/BSAP Configuration 38 Cingular GPRS Raven Us er Guide V ersion 2.01 Configuring the Raven at the Polling Host for Modbus on UDP Y ou can use either W ireless ACE (page 15 and page 57), direct serial communica - tion or T elnet ( page 58 ) to configure the mode m using A T com mand s ( page 61 ). This section covers standard Modbus, variation[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 39 Modbus/BSAP Configuration • AT M D 1 3 : Modbus ASCII • AT M D 2 3 : Modbus R TU (Binary) • AT M D 3 3 : BSAP • AT M D 6 3 : V ariable Modbus (indivi dual parameters are set up manually) IDs to IPs The last step of configuring the Raven at th e host is setting the IDs to their specific IPs. I[...]

Modbus/BSAP Configuration 40 Cingular GPRS Raven Us er Guide V ersion 2.01 When you configure IPManager for the hos t Raven, make note of your modem name and domain setting in W ireless ACE in the men u selection Dynamic IP to be used with the r emote modems. FIGURE 6. Wireless ACE: Modem Name and Domain W ith nam es instead of IPs for the Address [...]

Cingular GPRS Raven Us er Guide V ersion 2.01 41 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 W i reless ACE, select UDP in the side menu. Select 03- UDP (normal UDP operation) as the value for MD. FIGURE 7. Wir eless ACE: UDP Power -up M[...]

Modbus/BSAP Configuration 42 Cingular GPRS Raven Us er Guide V ersion 2.01 R TU settings Other parameters may need to be changed, but this is dependent on the R TU type being used. As a minimum, this typically in volves setting the proper serial settings to match your R TU. FIGURE 9. Raven mounted in an enclosure with an R TU[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 43 Modbus/BSAP Configuration FIGURE 10. RTU to Raven setup FIGURE 1 1. Power Connections[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 44 CHAPTER 10 Simple Network Management Pr otocol (SNMP) The Raven is can be configured as an SNMP agent and supports SNMPv2c and SNMPv3. SNMP Overview The Simple Network Managem ent Protocol (SNMP) was designed to al low remote management and monitori ng of a variety of devi ces from a central lo cat i[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 45 Simple Network Management Pro tocol (SNMP) Management Information Base (MIB) The management information base (MIB) is a type o f database used to compile the information from the various SNMP agents. Reports fro m variou s agen ts, such as the Raven, are sent as data in form designe d to be parsed by[...]

Simple Network Management Pro tocol (SNMP) 46 Cingular GPRS Raven Us er Guide V ersion 2.01 Security Level *SNMPSECL VL sets the security level and which versio n of SNMP comm unica- tions are used. FIGURE 2. Wire less ACE: *SNMPPOR T 0 - No security required. SNMPv2c and SMNPv3 communications are allowed. 1 - Authentication required. SNMPv3 is req[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 47 Simple Network Management Pro tocol (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 con- firm it, the characters you type will be ob scured by “x ”. FIGURE 4. Wireless ACE: Changing the Raven Passw[...]

Simple Network Management Pro tocol (SNMP) 48 Cingular GPRS Raven Us er Guide V ersion 2.01 T rap Destination *SNMP TRAPDEST needs to be set with the de stination IP and port . If either are set to zero or empty , SNMP traps are disabled. FIGURE 5. Wire less ACE: *SNMPPOR T Note: T raps are sent out according to th e SNMP security level (i.e. if th[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 49 Simple Network Management Pro tocol (SNMP) SYNT A X DisplayString MAX-ACCESS read-only ST A TUS current ::= { general 2 } electronicID OBJECT -TYPE SYNT A X DisplayString MAX-ACCESS read-only ST A TUS current ::= { general 3 } modemT ype OBJECT -TYPE SYNT A X DisplayString MAX-ACCESS read-only ST A T[...]

Simple Network Management Pro tocol (SNMP) 50 Cingular GPRS Raven Us er Guide V ersion 2.01 otaProgrammingEnable OBJECT -TYPE SYNT AX INTEGER { disabled(0), enabled(1) } MAX-ACCESS read-only ST A TUS current ::= { common 2 } devicePort OBJECT -TYPE SYNT AX INTEGER(0..65535) MAX-ACCESS read-only ST A TUS current ::= { common 3 } netUID OBJECT -TYPE [...]

Cingular GPRS Raven Us er Guide V ersion 2.01 51 Simple Network Management Pro tocol (SNMP) serialPortSetting s OBJEC T -TYPE SYNT A X DisplayString MAX-ACCESS read-only ST A TUS current ::= { common 9 } serialPortFlowControl OBJECT -TYPE SYNT AX INTEGER { none(0), hardware(2), software(4) } MAX-ACCESS read-only ST A TUS current ::= { common 10 } -[...]

Simple Network Management Pro tocol (SNMP) 52 Cingular GPRS Raven Us er Guide V ersion 2.01 serialReceived OBJECT -TYPE SYNT AX INTEGER MAX-ACCESS read-only ST A TUS current ::= { status 6 } hostMode OBJECT -TYPE SYNT A X DisplayString MAX-ACCESS read-only ST A TUS current ::= { status 7 } powerMode OBJECT -TYPE SYNT A X DisplayString MAX-ACCESS re[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 53 CHAPTER 1 1 H a rd w a re I n s t a l l a t i o n Y our 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. Y o u should ensure that there is adequ[...]

Hardware Installation 54 Cingular GPRS Raven Us er Guide V ersion 2.01 FIGURE 1. Raven Mounting B racket, part number 100-170-10 09 A[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 55 Hardware Installation Connecting the Antenna Y our Raven will work w ith most standard cellu lar antennas with a TNC connector and rated to work with GPRS techno logy . Connect the antenna or RF cable directly to the TNC connector on the back of the Raven. FIGURE 2. Raven connectors Connecting power [...]

Hardware Installation 56 Cingular GPRS Raven Us er Guide V ersion 2.01 Y our Raven can also be connected to a seri al 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 Us er Guide V ersion 2.01 57 CHAPTER 12 A T Commands Just as with a Hayes compa tible analog modem, the Raven parameters can all be configured with A T commands. W ireless ACE and W ireless ACE W eb (See “Wire- less ACE and W ireless ACE W eb” on page 15. and below) are a graphical interface for the A T commands and it is hi[...]

AT C o m m a n d s 58 Cingular GPRS Raven Us er Guide V ersion 2.01 T o set or commit th e changes in the modem, use the Wri t e button at the top of W ireless ACE interface. FIGURE 2. W ireless ACE: toolbar For more informatio n on using W ireless ACE or W ireless ACE W eb, please refer to the Wir eless ACE User Guide . Note: Some of the A T Comma[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 59 AT C o m m a n d s FIGURE 4. HyperT erminal: TCP/IP Settings 3. When HyperT erminal connects to th e Raven, you may b e prompted for a pass- word. The default password is 12345 . When you press Enter , you s hould ge t back a reply of “OK”. FIGURE 5. HyperT erminal: A T mode via T elnet 4. Ty p e[...]

AT C o m m a n d s 60 Cingular GPRS Raven Us er Guide V ersion 2.01 1. Choose a name for your co nnection, such as Raven . The name and icon are only for your own reference so you can find the connect ion at a later date. FIGURE 6. HyperT erminal: Connection Name 2. Select COM1 for the Connect Using . FIGURE 7. HyperT erminal: Comport Setting 3. Ch[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 61 AT C o m m a n d s 6. If you get a reply of “OK”, then you entered the command successfully . If you get a reply of “0” or “ERROR”, try entering th e command again. A T Commands The tables below list the A T commands, th eir parameters, and explain w hat they do. • For most commands, yo[...]

AT C o m m a n d s 62 Cingular GPRS Raven Us er Guide V ersion 2.01 T ABLE 1. Information and S tatus Command Details I[ n ] n =0 Product name ( i.e. Raven ) . n =1 The Raven’ s firmware (A LEOS) 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). &[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 63 AT C o m m a n d s *NETST A TE? The curre nt network state: Connecting T o Network = The Raven is in the process of trying to connect to the GPRS network. Network Authenticati on Fail = Authe ntication to t he GPRS network has failed. V erify settings to a ctivate the Raven. Network Negotiation Fail [...]

AT C o m m a n d s 64 Cingular GPRS Raven Us er Guide V ersion 2.01 For most of the com mands 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 *DPOR T= n , you would enter A T*DPOR T? . T ABLE 2. Basic Com[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 65 AT C o m m a n d s The preferred method of activating (provisio ning ) the m odem is using the Setup W izard. However , there are special circ umstances when commands may be used instead. Note: Y ou may need go into PassThru mode to activate the Raven . In that case, you will need to refer to the Pas[...]

AT C o m m a n d s 66 Cingular GPRS Raven Us er Guide V ersion 2.01 *NETUID= uid uid =user id (up to 64 bytes.) The login that is used to login to the Cingular ’ s cellular network , when required. OPRG= n n =0 n =1 Enables/disables over-the-ai r firmware upgr ading of the Raven. Disables over-the-air programming. Enables over-the-air programming[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 67 AT C o m m a n d s The Raven’ s cellular network is the c onnection t o Cingular GPRS and remote devices or computers. T ABLE 4. Cellular Network (Cingu lar GPRS) Command Parameters Details *NET AL LOWZEROIP= n n =0 n =1 Allows the displayed IP addr ess in *NETIP to end in zero (ex. 192.168.1.0). A[...]

AT C o m m a n d s 68 Cingular GPRS Raven Us er Guide V ersion 2.01 +COPS= mode ,[ format ] [, oper ] mode =0 mode =1 mode =4 format =0 format =2 oper =”name” Manually specify an operator . automatic - any af filiated carrier [def aul t] manual - use only the operator <oper> specified manual/automatic - if manua l selec ti on f ail s, goe[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 69 AT C o m m a n d s The Local network for the Raven is the one to which it is connect ed physically via the serial port to your computer , device, hub, or switch. The Raven has the ability to provide some NA T (network address translation) to pass communication from the GPRS network and the Internet t[...]

AT C o m m a n d s 70 Cingular GPRS Raven Us er Guide V ersion 2.01 S0= n n =0 n =1 n =2 n =3 This register determines how the Raven responds to an incoming TCP connection request. The Raven remains in A T 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 c[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 71 AT C o m m a n d s S51= n n =0 n =ASCII code P AD data forwarding character . no forwarding character ASCII code of character that will cause data to be for - warded. (Used in UDP or TCP P AD mode.) S82= n n =0 n =2 Enables UDP auto answer (half-open) mode. Normal mode Enable UDP auto answer mode . S[...]

AT C o m m a n d s 72 Cingular GPRS Raven Us er Guide V ersion 2.01 TCPS= n n =0 n =1 TCP connection time -out (T CP T) units. TCP T specifies minutes. TCP T specifies seconds. TCP T= n n = minutes (TCPS=0) or seconds (TCPS=1) TCP connection time-out. Spec ifies a time interval upon which if there is no in or outbound traf fic through a TCP connect[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 73 AT C o m m a n d s *CTSE= n n =0 n =1 Clear T o Send Enabl e This feature asser ts CTS when there is a network con - nection. Disabled (Default). Enable assertion of CTS wh en there is network cover - age. Note: Flow control ( AT Q ) will override this indication, so if you want to use CTS to indic[...]

AT C o m m a n d s 74 Cingular GPRS Raven Us er Guide V ersion 2.01 *HOSTPEERIP = d.d.d.d d.d.d.d =local or peer IP of modem Set or query the IP address th at can be used to directly contact the Raven once a PPP conn ection 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[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 75 AT C o m m a n d s PassThru Mode is used to communicate dir ectly to the Raven’ s internal hardware (OEM module). *UDPLAST= n n =0 n =1 If enabled, sets S53 to the last accepted IP address through UDP auto answer . This can be used in conjunc - tion with MD3 so that when there is no UDP session, ne[...]

AT C o m m a n d s 76 Cingular GPRS Raven Us er Guide V ersion 2.01 T ABLE 6. PassThru Mode Command Parameters Details AP ASSTHRU Note: This mode is not available throug h the re mote A T telnet server . none Set modem operation to pass throug h mode. This will pass any characters rec eived on the serial port directly to the internal OEM module a [...]

Cingular GPRS Raven Us er Guide V ersion 2.01 77 AT C o m m a n d s It is possible to communicate with th e Raven across a TCP/IP network (using Cin - gular’ s network and the Internet ). T elnet provides a termin al style connection to the Raven. Note: T elnet is not a secure communications protocol. Friends Mode can limit access to the Rave n f[...]

AT C o m m a n d s 78 Cingular GPRS Raven Us er Guide V ersion 2.01 T ime 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 Y ork is UTC-5). T ime is expressed in 24-hour format, i.e. 13:23:57 would be 1:23pm . Y ou can set time and date manually or you can have it se[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 79 AT C o m m a n d s DNS settings in the Raven allow the modem to use doma in names instead of IPs to contact other Internet hosts. *DBGCOML VL= n n =0 n =1 n =2 Set the logging level for the host or module COM port. No logging Host COM. Module COM. *DBGEVTLOGCLEAR none Clears the content of the logs i[...]

AT C o m m a n d s 80 Cingular GPRS Raven Us er Guide V ersion 2.01 IPManager (See “IP Manager translates a dy namic IP address to a fully qualified domain name so you can contact the Raven by name as if it had a st atic IP .” on page 20.) is a service from AirLink which allo ws a Raven with a dynamic IP to be contacted as if it had a static IP[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 81 AT C o m m a n d s Keepalive (See “Keepalive” on page 24.) allows the Raven to stay c onnected to the cellular network even when th ere are periods of inactivity . *IPMGRUPDA TE n = m n = 1 or 2 m =5-255 Sets the number of minutes to period ically send an IP update notification to the co rrespond[...]

AT C o m m a n d s 82 Cingular GPRS Raven Us er Guide V ersion 2.01 *IPPINGADDR= [ d.d.d.d ][ name ] d.d.d.d = IP name =domain name Set the IP address or valid internet domain name for the Raven to ping to keep itse lf alive (online). *IPPING must to be set t o a value ot her than 0 to enable pinging. *IPINGFORCE= n n =0 n =1 Have IP pings be alway[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 83 AT C o m m a n d s Direct Communication can be used with the Raven t o contact other Internet devices to pass information or other tasks. T ABLE 14. Direct Communication Command Parameters Details D[ method ][ d.d.d.d ][/ ppppp ] or D[ method ][@ name ][/ ppppp ] method = P - Establish a UDP connecti[...]

AT C o m m a n d s 84 Cingular GPRS Raven Us er Guide V ersion 2.01 S53=[ method ][ d.d.d.d] [/ ppppp ] method = P - UDP T - TCP N - T elnet d.d.d.d = IP address or name ppppp = the port address Destination IP address, port, and method. These are used as defaults for the D (Dial) A T command. Examples: A TS53=T192.168.100.23/12345 A TS53=foo.earlin[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 85 AT C o m m a n d s SMTP (Simple Mail T ransfer Protocol) is the de facto standard for email transmis - sion across the Internet. The Raven can se nd messag es using SMTP if it has been configured to use a mail server . SMS (S imple Message Service) is another way to send messages via Cingular’ s ce[...]

AT C o m m a n d s 86 Cingular GPRS Raven Us er Guide V ersion 2.01 *SMTPSUBJ=[ subject ] subject =SMTP message subject Allows configuration of the de fault Subject to use if one isn't specified in the messa ge by providing a "Subject: xxx" line as the in itial message line. *SMTPUSER=[ user ] user =username The email account usernam[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 87 AT C o m m a n d s Modbus, commonly u sed with telemet ry de vices, allows a connection via serial port to the modem. See “Modbus/BSAP Configurat ion” on page 35. T ABLE 16. Modbus Settings Command Parameters Details IPL= n n =0 n =1 IP List Dial This allows access the Modbus IP list using the fi[...]

AT C o m m a n d s 88 Cingular GPRS Raven Us er Guide V ersion 2.01 MVMSK= hh hh =hex value (00 [default] no mask, all 8 bits 0F only the lo w order 4 bits) Modbus V ariant ID Mask 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. Cann[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 89 AT C o m m a n d s Simple Network Management Protocol (SNMP) can be used to monit or devices connected to a network for any conditions wh ich warrant administration attention. By default, SNMP uses port 161, however mo st Internet providers (including cellu - lar) block all ports below 1024 as a secu[...]

AT C o m m a n d s 90 Cingular GPRS Raven Us er Guide V ersion 2.01 T ABLE 17. SNMP Command Parameters Details ACEPW= pw pw=pa ssword Change the ACE password to a new value. Password is case-sensitive. Default password is 12345. Ex. A TACEP A W=new123 *SNMPPOR T= n n =0 n =1-65535 This controls which port the SNMP Agent listens on. SNMP is disabl[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 91 AT C o m m a n d s When the Raven is in PassThru mode, the featur es of ALEOS, except serial commu - nications, are disabled. When the modem is in PassThru mode, you are communi - cating directly to t he OEM module. On ly this subset of A T com mands will work while in PassThru mode. It is also neces[...]

AT C o m m a n d s 92 Cingular GPRS Raven Us er Guide V ersion 2.01 S3= n n =0-127 (ASCII charac - ter number) Carriage Return Character The standard end of line char acter used to indicate the end of an A T command. This character is also used as the carriage return characte r for framing r esponses and result codes in command state. S4= n n =0-12[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 93 AT C o m m a n d s S1 1= n n =50-255 DTMF Dialing Speed (Remote) This specifies the dura tion of tones in DTMF dialing. V n n =0 n =1 Command Response Mode. T erse (numeric) command respo nses V erbose command responses (Default). X n n =0 n =1 Extended Call Progress Result mo de. T urn off extended [...]

AT C o m m a n d s 94 Cingular GPRS Raven Us er Guide V ersion 2.01 +CIMI none Mobile Station IP Address +CMIP? none Received Signal Strength a nd Channel Frame Err or Rate +CSQ none Serving System +CSS? none Capabilities +GCAP none Model identification with suppo rted frequency bands. +WGMM none Serial number of the module. +WHWV none PRL version [...]

Cingular GPRS Raven Us er Guide V ersion 2.01 95 AT C o m m a n d s +WSPC=[ lock ],[ nnnnnn ] C321 1 lock = 0 - OTKSL(One T i me Key Sub - sidy Lock) 1 - MSL (Master Subsidy Lock) nnnnnn =6 digit unlock code Service Programming Code Upon successful entry of this code, all other service pro - visioning A T commands may be used. Cingular will provide[...]

AT C o m m a n d s 96 Cingular GPRS Raven Us er Guide V ersion 2.01 ~NAMLCK= nnnnnn C3210 nnnnnn =6 digit unlock code The NAMLCK is the modem's 6-digit OTSL (One T ime Subsidy Lock), MSL (Maste r Subsidy Lock), or SPC (Service Provisioning Code). Cingu lar will provide the unlock code. If the number i s accepted by the modem, the OK result cod[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 97 CHAPTER 13 Raven Specifications Physical Characteristics: • W eight: < 1 lb. • Size: 3” wide x 1.1” high x 5.1" long • Sta tu s L ED s • RF Antenna Connector: 5 0 Ohm TNC • Receive Diversity RF Ante nna Connector: 50 Ohm SMA • Serial Interface: RS232 DB-9F with Data Services &[...]

Raven Specifications 98 Cingular GPRS Raven Us er Guide V ersion 2.01 • Multislot Class 8 • Circuit Switched Data Capabl e (1 4, 400 Transparent and Non-T ransparent Modes) Environmental: • Operating ranges: -30°C to +°C • 10% duty cycle limit above 60°C • Humidity: 5%-95% No n-co ndensing Power Management: • Low power consumption ?[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 99 T roubleshooting Support web site The Airlink web site is updated frequent ly with Setup W izards, Utilities, F AQs, and other documentatio n. http://www .airlink.com/sup port Contacting T echnical Support For support assist ance please email supp ort@airlink.com or call 510-781-9760 Monday through F[...]