Table of Contents

Advertisement

Quick Links

Raven EDGE/GPRS
User Guide
Version 2.31 - February 2007
Copyright © 1993-2007 AirLink Communications, Inc. All rights reserved.

Advertisement

Table of Contents
loading

Summary of Contents for Airlink101 Raven EDGE/GPRS

  • Page 1 Raven EDGE/GPRS User Guide Version 2.31 - February 2007 Copyright © 1993-2007 AirLink Communications, Inc. All rights reserved.
  • Page 2: Important Notice

    OR THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY. Warranty Summary For the full and complete text, refer to the warranty appendix in the modem user guide or to the AirLink website (http://www.airlink.com) for the full text of the warranty.
  • Page 3: Table Of Contents

    Contents Introduction to Raven EDGE/GPRS ......1 EDGE/GPRS Overview........... .1 Establishing an Internet Connection .
  • Page 4 Contents TCP PAD ............. .27 TCP Auto Answer .
  • Page 5 SNMP MIB Definition for AirLink ........
  • Page 6: Introduction To Raven Edge/Gprs

    Introduction to Raven EDGE/GPRS CHAPTER 1 The Raven's rugged form factor is ideal for industrial and commercial applications that require real-time communications. The Raven provides cellular data communications for a variety of applications, such as telemetry, public safety, SCADA, traffic control, traffic metering, and more. Raven front and back FIGURE 1.
  • Page 7: Establishing An Internet Connection

    Introduction to Raven EDGE/GPRS Establishing an Internet Connection The Raven uses Cingular as an ISP (Internet Service Provider) to connect you to the Internet. Steps of a connection: When your Raven is powered on, it automatically searches for cellular service using EDGE/ GPRS.
  • Page 8: Using Your Raven To Connect To The Internet

    Introduction to Raven EDGE/GPRS If you need to contact your Raven, a device connected to the modem, or a host system using the modem from the Internet, 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 9 Introduction to Raven EDGE/GPRS Backup connection to the Internet FIGURE 3. Financial Point of Sale and Kiosk FIGURE 4. Automation and Telemetry FIGURE 5. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 10: Activation Of The Raven

    Activation of the Raven CHAPTER 2 To install the SIM, you will only need a small phillips head screw driver. Opening the Case a. Unplug the Raven’s power and all cables. b. Using a small phillips head screw driver, remove the screws on the back of the Raven. c.
  • Page 11: Inserting The Sim

    Activation of the Raven Empty SIM Tray FIGURE 3. Inserting the SIM a. Place the SIM into the tray and gently press to click it into place. SIM Tray with a SIM FIGURE 4. The SIM may be a different color than this example.
  • Page 12 Powere on your Raven and connect directly to the serial port on your computer. Start Wireless Ace and connect to your modem. Start > All Programs > AirLink Communications > Wireless Ace 3G > Wireless Ace 3G Click on Connect.
  • Page 13 Activation of the Raven Wireless Ace: *NETAPN FIGURE 8. Internet For most Cingular accounts the APN for your modem will be Internet or Proxy. Consult with your account representative on which APN to use. If you need to configure your modem for a custom APN, after entering the APN, there is additional information you will need to enter.
  • Page 14 Activation of the Raven It is recommended that you reset your modem after configuring the APN. Either click the Reset button in Wireless Ace or press the reset button on the modem. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 15: Utilities For The Raven

    Microsoft .NET Framework from Microsoft at: http:// www.microsoft.com/. AceView AceView is a low-profile monitoring tool to view the status of your AirLink Raven and display net- work status, IP address, RSSI strength, and other basic connection information. AceView FIGURE 1.
  • Page 16: Wireless Ace

    Utilities for the Raven You can connect to your Raven locally using a DUN connection . The display is dynamically updated with the current status of the modem. The GPS features are available only for PinPoint X, PinPoint-E, and PinPoint modems. When you use DUN to connect to your Raven, AceView can monitor and maintain the DUN con- nection.
  • Page 17: Acenet

    Utilities for the Raven AceNet AceNet is a full featured application that you can use to monitor several AirLink modems at the same time, use a template from Wireless Ace to change the configuration in all of them simulta- neously, keep the modems up-to-date with the latest firmware by updating them over the air, peri- odically log the modems’...
  • Page 18: Modem Doctor

    Modem Doctor is a troubleshooting and diagnostics 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 configura- tion completely, and temporarily set the Raven to a known configuration to aid in trouble shooting (SOS mode).
  • Page 19: Ip Manager And Dns

    CHAPTER 4 If you have a fleet of AirLink modems or even if you only have one, it can be difficult to keep track of the current IP addresses, especially if the addresses aren’t static but change every time the modem connects to Cingular.
  • Page 20: Fully Qualified Domain Name

    A URL (Universal Resource Locator) is different from a domain name in that it also indicates information on the protocol used by a web browser to contact that address, such as http://www.airlink.com. www.airlink.com is a fully qualified domain name, but the http://, the protocol identifier, is what makes the whole thing a URL.
  • Page 21: Dynamic Names

    Wireless Ace or a terminal application to enter the commands (page 50). To configure your AirLink modem to be addressed by name, the modem needs to have 4 elements configured. You can configure a second dynamic server as a backup, secondary, or alternate server.
  • Page 22: Eairlink.com

    Can include a hyphen (-) • Cannot contain spaces • Must be no longer than 20 characters total Eairlink.com As a service, Airlink maintains a IP Manager servers which can be used for any AirLink modem. • *DOMAIN: eairlink.com • *IPMANAGER1 : edns2.eairlink.com...
  • Page 23: Configuring Dns

    If the Raven will be communicating with a device that has a domain name but changes its IP address frequently (such as another AirLink modem using IP Manager) or is on a network where devices are accessed by names rather than IP addresses, you will want to put in an alternate DNS (*DNSUSER) where that domain is updated, such as the IP Manager server the remote modem is using or the listing of IP addresses to names is kept.
  • Page 24 IP Manager and DNS Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 25: Data Communication And Host Modes

    Data Communication and Host Modes CHAPTER 5 The Raven plays the part of a HOST when a computer or another device is connected to its serial port. The Raven can also route data to/from the connected device to the cellular network. The Raven moves data from one port to the cellular network in a simple one- Note: to-one routing.
  • Page 26: At Mode

    Data Communication and Host Modes The serial port of the Raven can be configured to enter any of the modes automatically on power up (in most cases, this is also after it has registered on the cellular network). This is done by set- ting the Startup Mode Default (refer to MD in the AT Command listing, page 87) to the desired mode.
  • Page 27: Passthru Mode

    Data Communication and Host Modes If Q=1 (Quiet On), no result codes are output whatsoever, so there is no response generated by a (non query) command. If Q=0 (Quiet Off), result codes are output. The format of this output is then affected by the Verbose setting.
  • Page 28: Telnet

    Data Communication and Host Modes Wireless Ace: MD FIGURE 3. Some internal hardware requires upwards of 20 seconds before AT commands can be entered, so be patient if there seems to be no response to AT commands. PassThru can only be exited by resetting or power-cycling the modem. Caution: This mode cannot be entered via a remote Telnet session.
  • Page 29: Ppp

    Data Communication and Host Modes Wireless Ace: Telnet Configuration FIGURE 5. In PPP mode, the Raven acts as a PPP server, providing an IP address, and DNS servers (if avail- able) to the Host. PPP mode is entered from the AT mode by using any of the following commands: AT\APPP ATDT10.0.0.1 ATDT10001...
  • Page 30: Slip

    Data Communication and Host Modes Slip SLIP mode is entered be using the "AT\ASLIP" command. As in PPP Mode, the IP address that the host assumes is affected by the setting of *HOSTPRIVMODE. SLIP does not negotiate the IP with the host, so before making a SLIP connection, the host SLIP driver must be configured to use the IP specified by querying S110.
  • Page 31: Reliable Udp

    Data Communication and Host Modes When idle, after the time-out has occurred, the is in AT command mode on the serial port, and any valid AT command may be entered during this time. The Normal UDP Mode (MD3) can be combined with UDP auto answer to cause the incoming serial data to be sent in UDP packets (instead of being treated as AT commands), while allowing sessions to be established from different UDP sources.
  • Page 32: Tcp Pad

    Data Communication and Host Modes UDP Multicast mode results in any data received from the host serial port being sent to all the cli- ents in the address 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 33: Hybrid Modes

    Data Communication and Host Modes UDP auto answer may also be set simultaneously with TCP auto answer. Note: Then, when in the idle state, the modem will accept either a TCP connection request or UDP incoming packet, and enter a TCP or UDP session as appropriate. Hybrid Modes Some previous hybrid modes (MD=5, 6) are no longer implemented as special, unique modes.
  • Page 34: Keepalive

    Data Communication and Host Modes • *HOSTPRIVIP - Set to the IP address you want the Raven to give to your device. • *HOSTPEERIP - Set to the IP address you want for the Raven. • *HOSTNETMASK - Set to the subnetmask (generally, 255.255.255.0). If you are using Private Mode (*HOSTPRIVMODE=1), you will need to Note: make sure that *HOSTPRIVIP and *HOSTPEERIP are on the same subnet.
  • Page 35: Data Usage Using Keepalive

    Data Communication and Host Modes If *IPPINGADDR is left blank or is set to an invalid IP address (example, Caution: an IP which is unreachable or one which is not a valid IP address), modem perfor- mance will be adversely affected. Data usage using Keepalive Keepalive is an optional feature.
  • Page 36: Modbus/Bsap Configuration

    Modbus/BSAP Configuration CHAPTER 6 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 37: Supervisory Control And Data Acquisition (Scada)

    Modbus TCP/IP uses standard Ethernet equipment. Raven Modbus on UDP When AirLink modems are used in place of radios, a Raven is connected to the central station (host) and a Raven is connected to each remote unit. When the Raven is configured for Modbus with UDP, the Raven connected to the host can store a list of IP addresses or names with matching IDs.
  • Page 38: Configuring The Raven

    Modbus/BSAP Configuration Automation and Telemetry FIGURE 1. Configuring the Raven You can use either Wireless Ace, direct serial communication, or Telnet to configure your modem using AT commands (page 50). Configuring the Raven at the Polling Host for Modbus on UDP This section covers a Polling Host with standard Modbus, variations may need additional AT com- mands.
  • Page 39 Modbus/BSAP Configuration Wireless Ace: Device Port FIGURE 3. Configure the default mode for start-up. will need to be set. In Wireless Ace, select UDP in the side menu. Select default start-up mode the appropriate MD mode from the drop down menu. Wireless Ace: MD Configuration FIGURE 4.
  • Page 40: Dynamic Ip

    Modbus/BSAP Configuration Wireless Ace: Addr List FIGURE 5. Addresses can be entered in decimal or hex. Wireless Ace will translate hex entries into decimal. The number before the “=” is ID, the number after is the IP address. There can be a total of 100 remote ID/Local addresses entered into the modem.
  • Page 41: Configuring The Remote Modems For Modbus With Udp

    Modbus/BSAP Configuration With names instead of IP addresses for the Address List, the host modem will query the DNS server for the current IP address assigned to the specific name of a remote modem to send a mes- sage corresponding to the ID. When you use names instead of IP adrresses, to ensure your modems are updated quickly with the correct IP addresses for the names, you will want to set the DNS settings as well.
  • Page 42: Dynamic Ips

    Modbus/BSAP Configuration Wireless Ace: UDP Power-up Mode FIGURE 8. 2 - Enable Configure IP addresses for the host. If the Host modem has a static IP address, enter it in the Destination Address for S53. In Wireless Ace, select Misc in the side menu. Setting the Host modem IP address as the S53 Destination Address provides a low level security.
  • Page 43 Modbus/BSAP Configuration 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. Mount the modem at the host or with the RTU. Raven mounted in an enclosure with an RTU FIGURE 10.
  • Page 44 Modbus/BSAP Configuration Power Connections FIGURE 11. RTU to Raven setup FIGURE 12. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 45: Hardware Installation

    Hardware Installation CHAPTER 7 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.
  • Page 46: Connecting The Raven To A Computer Or Other Device

    The power cable negative lead should be connected to the battery or power source negative ter- minal. When using a DC power source (such as a car battery or solar cell), AirLink Note: recommends placing a fuse (1-2 Amp) on the line close to the power source to pro- tect your power source from possible surges due to shorts or other line issues.
  • Page 47 Hardware Installation The Reset button performs the same function as unplugging power from the modem and plugging it back in. Reset will not alter any saved configuration settings. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 48: Modem Placement

    Modem Placement APPENDIX 8 When decided on a location to install your Raven, make sure the modem will be away from direct exposure to the elements (sun, rain, etc.). Excess cables can be bundled and tied with twist-ties or other appropriate binders, but the less the cable is wrapped and bound together, the better the modem will perform.
  • Page 49 Modem Placement Raven Mounting Bracket, part number 100-170-1009 A FIGURE 2. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 50 Modem Placement Raven Mounting Bracket, part number 100-170-1006 A FIGURE 3. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 51: Installing A Raven With An Rtu

    Modem Placement Installing a Raven with an RTU The Raven can be installed in the same enclosure with an RTU and share the power supply. The power cable positive lead should be connected to the battery or power source positive terminal. The power cable negative lead should be connected to the battery or power source negative termi- nal.
  • Page 52 Modem Placement Raven mounted in an enclosure with RTU FIGURE 6. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 53: Specifications For The Raven Edge/Gprs

    Specifications for the Raven EDGE/ APPENDIX 1 GPRS Physical Characteristics: • Weight: < 1 lb • RF Antenna Connector: 50 Ohm TNC • Serial Interface: RS232 DB-9F with 1200-115200 bps (see below for diagram) • Status LEDs Data Services & RF Features •...
  • Page 54: Power Management

    Specifications for the Raven EDGE/GPRS Power Management: • Low power consumption • Dormant connection (idle for 10-20 seconds): at 12 VDC • Input Voltage: 9 VDC to 28 VDC • Input Current: 20 mA to 350 mA Power consumption Modem Idle Transmitting Raven...
  • Page 55: At Commands

    AT Commands APPENDIX 2 Wireless Ace is a graphical interface for configuring your It is highly recommended that Raven. you use this utility to modify any parameters, however a terminal emulation application, such as HyperTerminal, see below, can be used instead with typed AT commands. Some commands can only be configured using a terminal emulation and Note: typed AT commands.
  • Page 56 AT Commands Wireless Ace: Tool bar FIGURE 2. For more information on using Wireless Ace, please refer to the Wireless Ace User Guide. With Wireless Ace, you can create a template from one modem and then use that template to configure other modems in the exact same way. You can use the tem- plate in AceNet, too, to configure several modems at the same time with the same parameters.
  • Page 57: Using Telnet Terminal Emulation

    Start>All Programs>Accessories>Communications>HyperTerminal Choose a name for your connection, such as or AirLink. The name and icon are only for Raven your own reference so you can find the connection at a later date (if you want to have a connec- tion saved for both local and remote, it is recommended the connection name reflect the con- nection type (example, Raven Remote).
  • Page 58: Direct Serial Connection

    Using HyperTerminal, included with most installations of Microsoft Windows: Start>All Programs>Accessories>Communications>HyperTerminal Choose a name for your connection, such as Raven or AirLink (if you want to have a connec- tion saved for both local and remote, it is recommended the connection name reflect the con- nection type, i.e.
  • Page 59: Using At Commands With A Terminal Application

    AT Commands HyperTerminal: Connection Name FIGURE 8. Select COM1 (or the comport to which the modem is connected) for the Connect Using. HyperTerminal: Comport Setting FIGURE 9. Change the Bits per Second to 115200 (default), Data Bits to 8, Parity to None, Stop Bits to 1, and Flow Control to Hardware.
  • Page 60 AT Commands • Required variable parameters are denoted with italicized text, example, Dn. The is variable and noted in the parameters column. • Optional parameters are denoted with square brackets • Most commands with parameters can be entered with to read the current value (for example, AT&D? will respond with “2”...
  • Page 61: At Command Listing

    AT Commands AT Command Listing *NUMTOIP ..70 Symbols MLIST ..91 *PTINIT ..81 MLISTX ..91 &C .
  • Page 62: Information And Status

    AT Commands: Information and Status Information and Status Most of the commands in the “Info” and “Status” groups as well as other groups have read-only parameters. They only provide information and cannot be changed using Wireless Ace (some can be changed using AT Commands with a terminal application). The commands displayed in Wireless Ace and the results of those commands depends on the model of the modem.
  • Page 63 AT Commands: Information and Status Status Group FIGURE 2. I[n] example, Raven Raven-E) n=0 Product name (for n=1 The Raven’s firmware (ALEOS) version, hardware ID, and copyright. n=2 The internal hardware's firmware version and relevant hardware ID. n=3 The hardware module's unique ID (ESN). n=5 View active profile (the contents of the active registers).
  • Page 64 AT Commands: Information and Status *NETIP? The current IP address of the modem reported by the embedded OEM module (generally obtained from Cingular your cellular carrier). This is the address to which packets can be sent in order to contact the modem from the Internet.
  • Page 65 AT Commands: Information and Status • Hardware Reset The hardware module is being reset. This is a temporary state. &V View active profile (the contents of the active registers). Not displayed with Wireless Ace. +CCID Subscriber Identity Module ID +CIMI International Mobile Subscriber Identity +ICCID Subscriber Identity Module ID...
  • Page 66 Common : Misc FIGURE 1. OPRG=n Raven Enables/disables over-the-air firmware upgrading of the When AirLink releases a new verison of ALEOS, you can upgrade your remote modems with OPRG enabled. n=0 : Disables n=1: Enables S53=[method][d.d.d.d][/ppppp] Destination IP address, port, and method. These are used as defaults for the D (Dial) AT com- mand.
  • Page 67 AT Commands: Examples: ATS53=T192.168.100.23/12345 ATS53=foo.earlink.com Telnet to the specified IP at port 12345. ATS53=192.168.100.23/12345 Query the specified IP at port 12345. ATS53=/12345 Query port 12345. *DATE=[mm/dd/yyyy],[hh:mm:ss] Sets and queries the clock in the unit. Either the date and time can be specified, or simply one of the two can be specified in which case the unspecified value will remain unchanged.
  • Page 68 AT Commands: uid=user id (up to 64 bytes) *STATICIP=d.d.d.d Set the static IP required to be received from the network. If the modem does not get this IP address from the network, it will reset the internal hardware and try again. The default is 0.0.0.0, which allows any IP address from the network.
  • Page 69: Serial

    AT Commands: Serial Serial This group includes commands specific to the serial port. The commands displayed in Wireless Ace and the results of those commands depends on the model of the modem. Some of the commands in this section, as noted, are not available in Wire- less Ace.
  • Page 70 AT Commands: Serial This command is not proceeded by AT. Note: Re-execute last command. Cannot be configured in Wireless Ace. Manually answer an incoming connection. Cannot be configured in Wireless Ace. D[method][d.d.d.d][/ppppp] or D[method][@name][/ppppp] Dial a connection to a remote IP and Port using method. Cannot be configured in Wireless Ace.
  • Page 71 AT Commands: Serial DS=n Allows a PPP connection to be initiated on the host port. n=2 : Initiates the PPP connection. Cannot be configured in Wireless Ace. Toggle AT command echo mode. n=0 : Echo Off n=1 : Echo On Hang-Up Command.
  • Page 72 AT Commands: Serial The standard line feed character sent by the modem to the host at the end of a response or return code in command state. Cannot be configured in Wireless Ace. S5=n Backspace Character n=0-127 (ASCII character number ) This register sets the character recognized as a backspace during command entry.
  • Page 73 AT Commands: Serial n=0 : No forwarding character. Used in UDP or TCP PAD mode. S211=n For applications or situations where hardware control of the DTR signal is not possible, the modem can be configured to ignore DTR. When Ignore DTR is enabled, the modem operates as if the DTR signal is always asserted.
  • Page 74 AT Commands: Serial &Sn Set DSR mode. n=0 : Always assert DSR. n=1 : Assert DSR when in a data mode (UDP, TCP, PPP, or SLIP) (Default). n=2 : Assert DSR when the modem has network coverage. S211 can also be used to request that DSR is always asserted. If S211 is set to Note: 3 and &S is changed to a non-zero value, S211 will be changed to 1.
  • Page 75 AT Commands: Serial *MODEMHISPEED Set the internal serial link speed to the radio (modem) module. May not be available for all modem models. *NUMTOIP=n Convert 12 digit number to IP. n=0 : Use as name. n=1 : Use as IP address. Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 76: Tcp

    AT Commands: TCP This group includes commands specific to TCP communications. Common : TCP FIGURE 1. S0=n This register determines how the Raven responds to an incoming TCP connection request. The Raven remains in AT Command mode until a connection request is received. DTR must be asserted (S211=1 or &D0) and the Raven must be set for a successful TCP connection.
  • Page 77 AT Commands: TCP S221=n Connect Delay: n= 0 - 255 Number of seconds to delay the “CONNECT' response upon establishing a TCP connection. Number of tenths of seconds to delay before outputting ENQ on the serial port after the CON- NECT when the ENQ feature is enabled (see *ENQ).
  • Page 78: Udp

    AT Commands: UDP This group includes commands specific to UDP communications. Common : UDP FIGURE 1. AIP=n Allow IP address. n=0 Allow only the IP address specified in S53 to connect when UDP auto answer is enabled (S82=2). n=1 Allow any incoming IP address to connect when UDP auto answer is enabled (S82=2). Always subject to any Friends filters that may be defined.
  • Page 79 AT Commands: UDP hh=01 : SLIP mode hh=02 : PPP mode hh=03 : UDP mode hh=04 : TCP mode hh=07 : PassThru mode hh=0F : PinPoint MDT hh=13 : Modbus ASCII hh=23 : Modbus RTU (Binary) hh=33 : BSAP hh=63 : Variable Modbus hh=73 : Reliable UDP hh=83 : UDP Multicast See also S53 to set the port for UDP or TCP.
  • Page 80 AT Commands: UDP *UDPLAST=n If enabled, sets S53 to the last accepted IP address through UDP auto answer. This can be used in conjunction with MD3 so that when there is no UDP session, new ethernet host data will cause a connection to be restored to the last IP accepted through UDP auto answer. . n=0 : Does not change S53 setting.
  • Page 81: Dns

    AT Commands: DNS This group includes commands specific to the modem being able to use domain names instead of IP addresses for other configuration options. Common : DNS FIGURE 1. *DNSn Queries the DNS addresses. Cingular provides the DNS addresses while your modem is regis- tring on their network.
  • Page 82: Dynamic Ip

    AT Commands: Dynamic IP Dynamic IP This group includes commands specific to dynamic DNS. Dynamic DNS allows the Raven to use a dynamic IP (can change each time you connect) account but still allow you to use a fully qualified domain name to contact the Raven using IP Manager (page 14) running on a server with a dynamic DNS updater.
  • Page 83 AT Commands: Dynamic IP *IPMGRKEYn=[key] Sets the 128-bit key to use to authenticate the IP update notifications. If the key's value is all zeros, a default key will be used. If all the bytes in the key are set to FF, then no key will be used (i.e.
  • Page 84: Ppp/Ethernet

    AT Commands: PPP/Ethernet PPP/Ethernet This group includes commands specific to PPP or Ethernet connections between the Raven and a connected device. Common : PPP/Ethernet FIGURE 1. *HOSTAUTH=n Host Authentication Mode: Use PAP or CHAP to request the user login and password during PPP or CHAP negotiation on the host connection.
  • Page 85 AT Commands: PPP/Ethernet d.d.d.d=IP Address *HOSTPRIVMODE=n Set or query whether a private or public (network) IP is to be used when the Host initiates a EDGE/GPRS connection to the modem. n=0 : Public (network) IP Mode: When the Host initiates a PPP connection, the host will be given the network IP address that was obtained from Cingular while registering on the network.
  • Page 86: Passthru

    AT Commands: PassThru PassThru PassThru Mode is used to communicate directly to the Raven’s internal hardware. While the modem is in PassThru mode, ALEOS is disabled. If you need Caution: to connect to the Raven while it is in PassThru mode, you will need to do so with a terminal application.
  • Page 87 AT Commands: PassThru \APASSTHRU Caution: This mode is not available through the remote AT telnet server. You will need to Raven connect to the with it connected directly to your computer. Sets the modem operation to pass through mode. This mode will pass any characters received on the serial port directly to the internal hardware module and output any characters from the internal hardware module out the serial port.
  • Page 88: Smtp (Including Sms)

    AT Commands: SMTP (including SMS) SMTP (including SMS) This group includes commands specific to messaging. SMTP (Simple Mail Transfer Protocol) is the de facto standard for email transmission across the Internet. The can send messages using SMTP if it has been configured to use a mail server. Raven SMS (Short Message Service) is another way to send messages via Cingular’s cellular network.
  • Page 89 AT Commands: SMTP (including SMS) *SMTPSUBJ=subject Allows configuration of the default Subject to use if one isn't specified in the message by providing a “Subject: xxx” line as the initial message line. subject= SMTP message subject *SMTPUSER=user The email account username to authenticate with the SMTP server (*SMTPADDR) for sending email. user= username Maximum: 40 characters.
  • Page 90: Other

    AT Commands: Other Other The commands in this group are not specific to the other group categories. The commands displayed in Wireless Ace and the results of those commands depends on the model of the modem. Common : Other FIGURE 1. DAE=n Disable AT Escape Sequence detection.
  • Page 91 AT Commands: Other *IPPING=n Set the period to ping (if no valid packets have been received) a specified address (*IPPIN- GADDR) to keep the modem alive (online). n=15-255 minutes n=0 : Disable pinging (default) 15 minutes is the minimum interval which can be set for Keepalive. See also *MINXMIT which can override this value.
  • Page 92 AT Commands: Other *SNMPSECLVL=n Selects the security level requirements for SNMP communications as follows: n=0 : No security required. SNMPv2c and SNMPv3 communications are allowed. n=1 : Authentication equivalent to “authNoPriv” setting in SNMPv3. SNMPv3 is required to do authen- tication, SNMPv2c transmissions will be silently discarded.
  • Page 93: Friends

    AT Commands: Friends Friends Friends Mode can limit access to the from Cingular’s network and the Internet. Friends Raven Mode is a limited form of security, a basic firewall. Friends mode does not block any traffic from the cellular network, wanted or Note: not.
  • Page 94: Logging

    AT Commands: Logging Logging This group includes commands specific to the internal log. The commands displayed in Wireless Ace and the results of those commands depends on the model of the modem. Logging FIGURE 1. *DBGCOMMLVL=n Set the logging level for the host or module COM port. n=0 : No logging n=1 : Host COM n=2 : Module COM...
  • Page 95: Telemetry And Addr List (Address List)

    AT Commands: Telemetry and Addr List (Address List) Telemetry and Addr List (Address List) Modbus, commonly used with telemetry devices, allows a connection via serial port to the modem (page 31). Telemetry and Addr List commands are only used when the modem is in one of the Modbus start-up modes.
  • Page 96 AT Commands: Telemetry and Addr List (Address List) Addr List FIGURE 3. IPL=n IP List Dial This allows access the Modbus IP list using the first two digits of the dial string. Example: ATDT1234567 would go to ID "12" on the Modbus list and use the associated IP as the destination. n=0 : Disabled n=1 : Enabled MLISTid=d.d.d.d...
  • Page 97 AT Commands: Telemetry and Addr List (Address List) This parameter is used to define the length of the RTU ID in Modbus-like protocol data packets. This parameter is used when the when the MD is set to hex 63. MVMSK=hh Modbus Variant ID Mask: Byte hex mask to use when extracting the ID.
  • Page 98 AT Commands: Telemetry and Addr List (Address List) Commands in other groups associtated with Telemetry Only the settings associated with telemetry are explained in this section. This command can be found in the UDP group. Set to the appropriate start up mode for your telemetry configuration. MD menu FIGURE 4.
  • Page 99 AT Commands: Telemetry and Addr List (Address List) Destination Address For the remote Ravens, set the destination address to the IP address or domain name (if you are using IP Manager with a dynamic IP) of the host Raven. Destination Port and *DPORT The destination port (S53) for the Raven at the host needs to match the device port in use on all the Ravens at the remote sites (*DPORT), and the destination port (S53) for all the Ravens at the remote sites need to match the device port in use on the Ravens at the host (*DPORT).
  • Page 100: Edge/Hsdpa

    AT Commands: EDGE/HSDPA EDGE/HSDPA This group includes commands specific to EDGE and GPRS. The commands displayed in Wireless Ace and the results of those commands depends on the model of the modem. EDGE/HSDPA FIGURE 1. *NETAPN=apn Easy entry of the APN. apn=access If left blank, the modem will attempt to use the default subscriber value as defined by the account.
  • Page 101: Windows Dial-Up Networking (Dun)

    Windows Dial-up Networking (DUN) APPENDIX 3 Dial-up Networking (DUN) allows a computer or other device to use the serial port on your Raven to connect to the Internet or private network using PPP just like an analog modem using a standard phone line.
  • Page 102 Windows Dial-up Networking (DUN) Phone and Modem Options FIGURE 1. b.In the Phone And Modem Options dialog box. Select the Modems tab. Select Add. Modems FIGURE 2. Install New Modem FIGURE 3. c. Check Don’t detect my modem; I will select it from a list and select Next. d.
  • Page 103 Windows Dial-up Networking (DUN) Modem Driver FIGURE 4. e. Check Selected Ports, select the COM port the modem is connected to (commonly COM1), and select Next. Modem Port FIGURE 5. f. Once the modem driver is installed, select Finish. Finish FIGURE 6.
  • Page 104: Dial-Up Networking (Ppp) Configuration For Microsoft Windows

    Windows Dial-up Networking (DUN) Modems FIGURE 7. b. Select the Modem tab. Maximum Port Speed should be set to 115200 (default). Select OK to exit. Setting Maximum Port Speed Maximum Port Speed FIGURE 8. c. Select OK again to exit out of the Phone and Modem Options. Dial-Up Networking (PPP) Configuration for Microsoft Windows Once you have a driver for the modem installed on your computer, you can set up and configure...
  • Page 105 Windows Dial-up Networking (DUN) If you have an existing LAN connection, installing DUN for the modem Caution: may interfere with the LAN connection. It's recommended to disconnect your LAN connection before using a PPP connection with your Raven. Once the DUN connection is initiated, by default, it will take over as the “default route”...
  • Page 106 (Raven), or any other designation for the connection. Connection Name FIGURE 13. AirLink 3G Connection Optional: If you have multiple modems installed on your computer, you may be prompted to select the modem to be used. Check Standard 33600 bps Modem and select Next.
  • Page 107 Windows Dial-up Networking (DUN) Phone Number FIGURE 14. 10001 Optional: If you have multiple users configured for your computer, you may be prompted for Connection Availability. If you select My use only, the account currently logged on will be the only one able to use this DUN connection. h.
  • Page 108 Windows Dial-up Networking (DUN) Finish FIGURE 16. Configure the connection. After you complete the New Connection Wizard, there are a few more things you will want to con- figure in the connection. a. When the Connect window opens, select Properties. Connect FIGURE 17.
  • Page 109 Windows Dial-up Networking (DUN) Modem Properties FIGURE 18. c. Select 115200 as the Maximum speed. Check Enable hardware flow control. Do not check any other option. Select OK. Modem Configuration FIGURE 19. Optional: You may want to check the Options tab and change the settings for applications you might be using.
  • Page 110: Making A Dun Connection

    Making a DUN Connection Establishing a DUN Connection using AceView This guide assumes you have a default installation of AceView. Start AceView. Start > All Programs > AirLink Communications > AceView Raven EDGE/GPRS for Cingular - User Guide, version 2.31...
  • Page 111: Establishing A Dun Connection With Windows Networking

    Windows Dial-up Networking (DUN) Right-click on the AceView window to open the menu and select Connection Settings. AceView: Menu FIGURE 22. a. Select Auto Start in the DUN section. b. Select the DUN connection you have already installed on your computer from the drop down menu once you select Auto Start (you may only have 1 selection which would be prese- lected for you).
  • Page 112 Windows Dial-up Networking (DUN) Start the DUN session. Start > Connect To > AirLink 3G Connection (or whatever you named the connection). MS Windows XP: Connect FIGURE 24. For some accounts, you need to enter the User name and Password provided by Cingular for the cellular account.
  • Page 113: Simple Network Management Protocol (Snmp)

    Simple Network Management APPENDIX 4 Protocol (SNMP) The Raven can be configured as an SNMP agent and supports SNMPv2c and SNMPv3. SNMP Overview The Simple Network Management Protocol (SNMP) was designed to allow remote management and monitoring of a variety of devices from a central location. 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 Network Management Station (NMS) which monitors all the agents on a specific network.
  • Page 114: Listening Port

    Simple Network Management Protocol (SNMP) There are only three commands to set for SNMP in the Raven: the listening port, the security level, and the trap destination. Listening Port sets the port for the SNMP agent to listen on. If set to zero, default, SNMP is dis- *SNMPPORT abled.
  • Page 115: Trap Destination

    Traps are sent out according to the SNMP security level (i.e. if the security Note: level is 2, traps will be authenticated and encrypted). Currently, the only trap sup- ported is LinkUp. SNMP MIB Definition for AirLink AIRLINK-MIB DEFINITIONS ::= BEGIN IMPORTS ObjectName FROM SNMPv2-SMI MODULE-COMPLIANCE FROM SNMPv2-CONF;...
  • Page 116 OBJECT IDENTIFIER ::= { internet 4 } enterprises OBJECT IDENTIFIER ::= { private 1 } airlink OBJECT IDENTIFIER ::= { enterprises 20542 } general OBJECT IDENTIFIER ::= { airlink 1 } common OBJECT IDENTIFIER ::= { airlink 2 }...
  • Page 117 Simple Network Management Protocol (SNMP) SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 5 } aleosHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 6 } modemSWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 7 } modemHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only...
  • Page 118 Simple Network Management Protocol (SNMP) ::= { common 2 } devicePort OBJECT-TYPE SYNTAX INTEGER(0..65535) MAX-ACCESS read-only STATUS current ::= { common 3 } netUID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 4 } netPW OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 5 }...
  • Page 119 Simple Network Management Protocol (SNMP) MAX-ACCESS read-only STATUS current ::= { common 8 } 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...
  • Page 120 Simple Network Management Protocol (SNMP) ::= { status 3 } rssi OBJECT-TYPE SYNTAX INTEGER(-125..-50) MAX-ACCESS read-only STATUS current ::= { status 4 } serialSent OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 5 } serialReceived OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 6 }...
  • Page 121 Simple Network Management Protocol (SNMP) MAX-ACCESS read-only STATUS current ::= { gps 1 } satelliteCount OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { gps 2 } latitude OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { gps 3 } longitude OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only...
  • Page 122: Warranty Terms And Conditions

    The following terms and conditions ("Warranty Terms") govern the warranty services offered to you ("Customer") by AIRLINK COMMUNICATIONS, INC. ("AirLink"), located at 3159 Corpo- rate Place, Hayward, CA 94545, in connection with the sale and licensing of AirLink software and hardware.
  • Page 123: Warranty Conditions

    510-781-9760 to obtain an RMA number. Products deemed by AirLink to be DOA (dead on arrival) may be returned to Air- Link for repair, at AirLink's expense, using the standard RMA procedures. WARRANTY DISCLAIMER THE WARRANTIES SET FORTH ABOVE ARE IN LIEU OF ALL OTHER WARRANTIES OF...
  • Page 124: General Conditions

    OF ANY EXCLUSIVE REMEDY AND THE EXPIRATION OF THESE WARRANTY TERMS. General Conditions AirLink shall have the right to assign any or all components of these Warranty Terms without the prior written consent of the other party. AirLink shall not be liable to Customer for any alleged...
  • Page 125: Frequently Asked Questions And Technical Support

    Frequently Asked Questions and APPENDIX 6 Technical Support Many of these questions and solutions in the following sections come from AirLink Support. Solutions should only be performed if you are experiencing the specific Caution: problem indicated and have the specific modem model number indicated. Some solutions are very specific to model numbers due to differing internal hardware.
  • Page 126 What is the Proper RF Coverage for my Raven? The optimal range for AirLink modems is an RF Coverage (RSSI value) of -60 to -95. RF coverage between -95 to -105 DBm will often still register, however functionality at this range can be greatly reduced and registration can become difficult.
  • Page 127: The Raven's Ip Addresses And Local Networking

    Can I use a portable battery to power my Raven ? It is possible to use a portable battery for your AirLink modem, however, you most likely need to make the connector from the battery to the modem yourself. The battery also needs to have enough power to be able to handle the power consumption of the modem.
  • Page 128 Frequently Asked Questions and Technical Support However, if you need to be able to contact your Raven (or the devices behind it) directly, instead of a Restricted IP (also called Private IP, Non-Routable IP, or Proxy APN), you will need to contact Cingular your cellular provider to get your account changed to an Unrestricted IP (also called Public IP or Internet APN).
  • Page 129: Security For The Raven

    Ace. You will be asked to send this information in an email to support@airlink.com along with your name and company. Password resets are tracked. Start Wireless ACE: Start > All Programs > AirLink Communications > Wirelss ACE 3G > Wireless ACE 3G Select Modem > Reset Password.
  • Page 130 Note the Challenge Code shown (will be different than this screenshot). Wireless Ace: Challenge Code FIGURE 2. Enter the Daily Password provided by the AirLink support technician. The Daily Password will only work for the modem you requested, the copy Note: of Wireless Ace you used to obtain the Challenge Code, and only for the specific time (approximately 24 hours).
  • Page 131: Airlink Technical Support

    Setup Wizard or other steps as applicable. • Utility Guides - These guides focus on the features of one of the AirLink modem utilities: Wireless Ace, AceView, AceNet, Modem Doctor, etc. •...

Table of Contents