Airlink101 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., 19 93- 2005. All rights re serv 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 an d mu st not[...]

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 G PRS 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 R[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 iv Dynamic Name Resolution 21 Configuring the Rav en 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 [...]

Cingular G PRS 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 Rem ote 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 comput er or other device 55 CHAPTER 12 A T Commands 57 Using W ireless Ace 57 Wireless ACE: [...]

Cingular G PRS 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 netw ork. Raven Overview The Raven's rugged form fact or is ideal for indu[...]

Introduction t o 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 t o further enhance the capabilities of the Raven. These features and tools are introduced in this User Guide. • W ireless AC[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 3 Introduction t o Raven GPRS When your Raven is powered on, it auto matically searches for cellular serv ice using GPRS and establish es 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 ne[...]

Introduction t o 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[...]

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

Introduction t o 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 aside. 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 y[...]

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 ray with a SIM 7. Slide the tray back into the modem a nd gently pres s to click it into place. FIGURE[...]

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 Rave n configured. Connecting the Raven to your computer Y our Raven’ s serial port can be connected directly to [...]

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 i zard and Quick Start Guide than those included with your Raven. It i s recommended that you check with the web site for the latest version bef[...]

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) sen t direct ly to the mo dem via a terminal application (page 58). This meth od is recommended only in situations where the Set[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 13 CHAPTER 4 Raven Utilities AirLink offers a suite of utilities t o optimize your Raven’ s performance, allowing you to re motely view st atus 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 W ireless A ce W eb allow yo u 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 t[...]

Raven Utilities 16 Cingular GPRS Raven Us er Guide V ersion 2.01 AceNet W ith AceNet you can mo nit or several AirLink modems at the same time. The modems can be connect ed locally or remote. Several features can be displayed and logged. A ceNet is a seper ate product w hich can be pu rchased from AirLink. FIGURE 4. AceNet Using a template from W i[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 17 Raven Utilities Modem Doctor Modem Doctor is a troubleshooti ng 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 the current configuration completely , and set the Raven to only respond 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 nam e 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 th e house either[...]

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 bui lt from W ireless ACE to co nfigure DNS in y our Raven. FIGURE 1. Wir eless ACE: DNS *DNS1 and *DNS2 - Set these to your primary and second ary DNS servers. These m[...]

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 Co de T op Level Domain (ccTDL) : This suf fix is often used after the TDL for mo[...]

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 notificati on 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 na[...]

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 dynam ic 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 M[...]

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 Cingul ar 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 [...]

Cingular GPRS Raven Us er Guide V ersion 2.01 25 Keepalive T o set the Keepalive using W ireless ACE, select Other from the menu on the left. FIGURE 1. Keepaliv e Configuration in Wir eless ACE *IPPING sets the interval, in minutes, you want Keepalive 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 inte rnal[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 27 Host Modes in the A T Command listin g, page 69) to t he desired mode. If t his setting is non- 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 before the 5-second time-out expires. If the modem is in any mode ot[...]

Host Modes 28 Cingular GPRS Raven Us er Guide V ersion 2.01 For V=0 , (T erse mode), a numeric result code is output with a single trailing <CR> (no <LF> is output), while any A T query respo nse is followed by <CR><LF> (there is no preceding output). For example, possible output to th e A T comm and "A T<C R>&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 mo de by using any of the following commands: AT A P P P <CR> A TDT10.0.0.1 <CR> A TDT1 0001 <CR> A TD# 19788 &l[...]

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 establi shed from different UDP sources. A UDP session will be initiated either by incom ing seri al data or by an incom ing UDP packet. The session, started by either me thod, will be terminated when no d ata has been sent or received for the S82 p[...]

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 the idle inter- character time-out specified in S50 (in tent hs o f 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 Setting 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 Modi c on in 19 79, provides for client-server (also referred to as ma[...]

Modbus/BSAP Configuration 36 Cingular GPRS Raven Us er Guide V ersion 2.01 Te l e m e t r y T e lemetry is an automat ed 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, disp lay , and recording. Transmission of the inf[...]

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 con trol, sophisticated motion control, process contro l, Distri but ed Control System and complex network - ing. Modbus TCP/IP Mo[...]

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 mands ( page 61 ). This section covers standard Modbus, variati on[...]

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 (individual 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. In[...]

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 ir eless ACE in the menu sel ection Dynamic IP to be used with th e remote 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 ireless 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 th is is dependent on the R TU type being used. As a minimum, this typical ly involves 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 Ma nagement Protocol (SNMP) was designed to al low remote management and monitori ng of a variety of devices from a central location.[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 45 Simple Netw ork Management Protocol (SNMP) Management Information Base (MIB) The management information ba se (MIB) is a type of database used to compile the information from the various SNMP agents. Reports fro m various agents, such as the Raven, are sent as data in form designe d to be parsed by t[...]

Simple Netw ork Management Protocol (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 communica- tions are used. FIGURE 2. Wir eless ACE: *SNMPPOR T 0 - No security required. SNMPv2c and SMNPv3 communications are allowed. 1 - Authentication required. SNMPv3 is requ[...]

Cingular GPRS Raven Us er Guide V ersion 2.01 47 Simple Netw ork 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 con- firm it, the characters you type will be obscured by “x ”. FIGURE 4. Wireless ACE: Changing the Raven Passwo[...]

Simple Netw ork Management Protocol (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. Wir eless 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 Netw ork Management Protocol (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 Netw ork Management Protocol (SNMP) 50 Cingular GPRS Raven Us er Guide V ersion 2.01 otaProgrammingEnable OBJECT -TYPE SYNT AX INTEGE R { 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 Netw ork Management Protocol (SNMP) serialPortSetting s OB JEC T -TYPE SYNT A X DisplayString MAX-ACCESS read-only ST A TUS current ::= { common 9 } serialPortFlowControl OBJECT -TYPE SYNT AX INTEGE R { none(0), hardware(2), software(4) } MAX-ACCESS read-only ST A TUS current ::= { common 10 }[...]

Simple Netw ork Management Protocol (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 M ounting Bracket, part number 100-170 -1009 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 cellular 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 Y[...]

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 “W ire- 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 h[...]

AT C o m m a n d s 58 Cingular GPRS Raven Us er Guide V ersion 2.01 T o set or comm it th e changes in the modem, use the Wri t e button at the top of W ireless ACE interface. FIGURE 2. Wir eless ACE: toolb ar For more inform ation 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 Com[...]

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 connection at a later date. FIGURE 6. HyperT erminal: Connection Name 2. Select COM1 for the Connect Using . FIGURE 7. HyperT erminal: Comport Setting 3. Cha[...]

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 Authentic ation Fail = Authe ntication to t he GPRS network has failed. V erify settings to activate th e 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 ent er A T*DPOR T? . T ABLE 2. Basic Co[...]

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 modem 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 PassT[...]

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 th e Cingular ’ s cellular network , when required. OPRG= n n =0 n =1 Enables/disables over-the-ai r firmware upgrading of the Raven. Disables over-the-air programming. Enables over -the-air programmin[...]

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 (Cin gular GPRS) Command Parameters Details *NET ALLOWZEROIP= n n =0 n =1 Allows the displayed IP addr ess in *NETIP to end in zero (ex. 192.168.1.0). Al[...]

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 [de faul t] manual - use only the operator <oper> specified manual/automat ic - if manua l selec ti on f ail s, go[...]

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 whi ch 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 [...]

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 mu st be asserted ( S21 1=1 or &D0 ) and the Raven must be set for a successful TCP[...]

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) mo de. Normal mode Enable UDP auto answe r mode .[...]

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 (TCP 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 connectio[...]

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 ass er ts CTS when there is a network con - nection. Disabled (Defaul t). 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 ind[...]

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 us[...]

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 accepte d IP address through UDP auto answer . This can be used in conjunc - tion with MD3 so that when there is no UDP session, n[...]

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 telne t server . none Set modem operation to pass through 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 [...]

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 dom ain 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 full y 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 wh ich allo ws a Raven with a dynamic IP to be contacted as if it had a static [...]

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 connected 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 rrespondi[...]

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 to a value ot her than 0 to enable pinging. *IPINGFORCE= n n =0 n =1 Have IP pings be always[...]

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 messages 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 cel[...]

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 Config urat 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 f[...]

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 l ow 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 Managemen t Protocol (SNMP) can be used to monit or devices connected to a network for any condition s 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 se[...]

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=password 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 l istens 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 commands will w ork 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 responses V erbose command responses (Default). X n n =0 n =1 Extended Call Pro gress Result mo de. T u rn 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 St rength 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). Cingular will provide the unlock code. If the number is accepted b y the modem, t he 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: 50 Ohm TNC • Receive Diversity RF Ante nna Connector: 50 Ohm SMA • Serial Interface: RS232 DB-9F with Data Services &a[...]

Raven Specifications 98 Cingular GPRS Raven Us er Guide V ersion 2.01 • Multislot Class 8 • Circuit Switched Data Capabl e (1 4, 400 Trans parent 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 freq uently 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 su pport@airlink.com or call 510-781-9760 Monday through F[...]