Raven X HSDPA User Guide Version 2.33 - February 2007 Copyright © 1993-2007 AirLink Communications, Inc. All rights reserved.
Information in this document is subject to change without notice. ©Copyright AirLink Communications, Inc., 1993-2007. All rights reserved. WARNING The antenna(s) used for this transmitter must be installed to provide a separation distance of at least 20 cm from all persons and must not be co-located or operating in conjunction with any other antenna or transmitter. Important Notice Because of the nature of wireless communications, transmission and reception of data can never be guaranteed.
Contents Introduction to Raven X HSDPA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 HSDPA Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Establishing an Internet Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 Dynamic vs. Static IP Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents PPPoE with DHCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 The AirLink Modem as a Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Keepalive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Configuring Keepalive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Simple Network Management Protocol (SNMP) . . . . . . . . . . . . . . . . . 83 SNMP Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83 Management Information Base (MIB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 SNMP Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Raven X SNMP Configuration . .
CHAPTER 1 Introduction to Raven X HSDPA The Raven X's rugged form factor is ideal for industrial and commercial applications that require real-time communications. The Raven X provides cellular data communications for a variety of applications, such as primary or backup Internet connectivity, public safety, traffic control, traffic metering, and more. FIGURE 1.
Introduction to Raven X HSDPA General Packet Radio Service (GPRS) is packet-switched with many users sharing the same transmission channel, but only transmitting when they have data to send. This means that the total available bandwidth can be immediately dedicated to those users who are actually sending at any given moment, providing higher utilization where users only send or receive data intermittently. GPRS provides speeds of 30–70 kbps with bursts up to 170 kbps.
Introduction to Raven X HSDPA Most ISPs (cellular included) use dynamic IP addresses rather than static IP addresses since it allows them to reuse a smaller number of IP addresses for a large number of customers. A dynamic IP address is suitable for many common Internet uses, such as web browsing, looking up data on another computer system, or other client functions (such as data only being sent out or only being received after an initial request).
Introduction to Raven X HSDPA FIGURE 3. Backup connection to the Internet FIGURE 4. Financial Point of Sale and Kiosk FIGURE 5. Automation and Telemetry Raven X HSDPA for Cingular - User Guide, version 2.
CHAPTER 2 Activation of the Raven X The SIM (Subscriber Identity Module) card in the Raven X is a smartcard securely storing the key identifying a mobile subscriber. Generally, you will only need to install the SIM once in the life of the modem and it may be pre-installed by AirLink. Installing the SIM The Raven X is equipped with an easy insertion SIM slot. 1. Remove the SIM slot cover. Simply remove slot cover on the front of the Raven X to reveal the SIM slot. FIGURE 1. 2.
Activation of the Raven X FIGURE 2. 3. SIM tray button Insert the SIM into the tray. Carefully remove the SIM card from the card you got from Cingular. FIGURE 3. Sample of a Cingular Card with SIM Place the SIM into the tray and gently press to click it into place. FIGURE 4. Empty SIM Tray and a Tray with a Sample SIM The card and SIM may be a different color than these examples. 4. Insert the tray with the SIM back into the Raven X.
Activation of the Raven X FIGURE 5. 5. Inserting the SIM tray Replace the SIM slot cover. Replace the cover to prevent dust or other unwanted particles from entering the Raven X. Once the cover is replaced, the installation is complete. Setting the APN with Wireless Ace The APN (Access Point Name) is the way your modem knows how it will be communicating with the network.
Activation of the Raven X B. Select PPP. C. Select the COM port to which the modem is connected on your computer (commonly COM1). D. Type in the modem’s password (default 12345). FIGURE 6. 3. Select EDGE/HSDPA from the menu on the left side of Wireless Ace (under “Groups”). FIGURE 7. 4. Wireless Ace: Connect Wireless Ace: EDGE/HSDPA Type in the APN in the new value field of *NETAPN. FIGURE 8.
Activation of the Raven X FIGURE 9. B. Wireless Ace: Common - Misc Enter the NAI into the new value field for *NETUID and enter your network password into the new value field for *NETPW. FIGURE 10. Wireless Ace: Common - Misc [ NAI ] [ Password ] 5. When you have finished entering the APN settings, click the Write button on the tool bar of Wireless Ace and wait for the message “Write Successful” to appear in the status bar. FIGURE 11. 6.
CHAPTER 3 Utilities for the Raven X AirLink offers a suite of utilities to optimize your Raven X’s performance, allowing you to remotely view status and make changes to the configuration as needed. • • • • AceView Wireless Ace AceNet Modem Doctor This section of the Raven X User Guide covers basic information about these utilities. For additional information on a specific application and how to use it, please refer to the user guide for the specific utility.
Utilities for the Raven X You can connect to your Raven X locally using a DUN connection or Ethernet across a LAN or connected directly. 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. If you use DUN to connect to your Raven X, AceView can monitor and maintain the DUN connection. The DUN connection features are not available with Windows NT or Windows 98.
Utilities for the Raven X 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 simultaneously, keep the modems up-to-date with the latest firmware by updating them over the air, periodically log the modems’ Status parameters, and even graphically chart the logged parameters to see trends or other over time information. AceNet’s remote connections use TCP/IP, UDP, or SMS.
Utilities for the Raven X Modem Doctor Modem Doctor is a troubleshooting and diagnostics utility. This utility will allow you to get a log file of the Raven X activity which you can then send to AirLink support, erase the current configuration completely, and temporarily set the Raven X to a known configuration to aid in trouble shooting (SOS mode). FIGURE 5. Modem Doctor Raven X HSDPA for Cingular - User Guide, version 2.
CHAPTER 4 IP Manager and DNS 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. If you need to connect to the modem, or the device behind it, it is so much easier to connect when you have a name (car54.mydomain.com, where are you?).
IP Manager and DNS Fully Qualified Domain Name A domain name is a name of a server or device on the Internet which is associated with an IP address. Similar to how the street address of your house is one way to contact you and your phone number is another, both the IP address and the domain name can be used to contact a server or device on the Internet.
IP Manager and DNS Dynamic Names When an IP address is not expected to change, the DNS server can indicate to all queries that the address can be cached and not looked up for a long period of time. Dynamic DNS servers, conversely, have a short caching period for the domain information to prevent other Internet sites or queries from using the old information.
IP Manager and DNS *DOMAIN: The domain name to be used by the modem. *IPMANAGER1 and *IPMANAGER2: The IP address or domain name of the dynamic DNS server which is running IP Manager. Note: To use the name here instead of the IP, you need to have DNS set up in your Raven X (page 17). *IPMGRUPDATE1 and *IPMGRUPDATE2: How often, in minutes, you want the address sent to IP Manager.
IP Manager and DNS Configuring DNS Generally, when your Raven X receives its IP address from Cingular, it will also receive Cingular’s DNS servers to use for resolving (or translating) names to IP addresses which it will automatically configure in the modem settings. Unless your Raven X will be used on a network with other modems or devices which have names internal to the local network or frequently changing IP addresses, the DNS servers provided by Cingular should be all you need.
IP Manager and DNS Raven X HSDPA for Cingular - User Guide, version 2.
CHAPTER 5 Data Communication and Host Modes The Raven X plays the part of a HOST when a computer or another device is connected to its serial or Ethernet port. The Raven X can also route data to/from the connected device to the cellular network. Note: The Raven X moves data from one port to the cellular network in a simple one-to-one routing. It does not employ a routing table or any complicated routing protocol. If you need to have one-to-many routing, you can connect the Raven X to a router.
Data Communication and Host Modes The serial port of the Raven X 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 setting the Startup Mode Default (refer to MD in the AT Command listing, page 87) to the desired mode. If this setting is non-zero, the modem will enter the specified mode after 5 seconds.
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. If Quiet mode is off, the result code is affected as follows: For V=1 (Verbose mode), the textual result code is surrounded by a carriage return and new line. Any AT query response is also surrounded by a carriage return and new line.
Data Communication and Host Modes FIGURE 3. Wireless Ace: MD 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. Caution: PassThru can only be exited by resetting or power-cycling the modem. This mode cannot be entered via a remote Telnet session. PassThru Mode allows only specific AT commands. Some ALEOS commands will be unavailable when the modem is in PassThru mode.
Data Communication and Host Modes FIGURE 5. Wireless Ace: Telnet Configuration Public and Private Mode By default, the Raven X is in Public Mode and will pass the IP address assigned by the Cingular network to the devices connected to its ports. If you need more control over which gateway address, device address, and netmask that is given out by the DHCP server, you can use the private host mode, *HOSTPRIVMODE, and set the internal network IP addresses.
Data Communication and Host Modes Internal DHCP Server DHCP (Dynamic Host Configuration Protocol) has become a primary component of today’s network environments. DHCP allows one server to automatically and dynamically allocate network IP addresses and other network related settings (such as subnet masks, routers, etc.) to each computer or device without the need to set up each specifically or keep track of what addresses have already been used. DHCP and Routing DHCP is built on a client-server model.
Data Communication and Host Modes The AirLink Modem as a Gateway The primary purpose of the Raven X is to forward data from a single device connected to one of the ports to the Cingular’s network and, ultimately, under most circumstances, to the Internet in a one to one gateway configuration. When the Raven X obtains its IP Address from the cellular provider, it also obtains Cingular’s routing information necessary to forward messages to Cingular’s routers which can then forward on from there.
Data Communication and Host Modes Note: 15 minutes is the minimum time which can be set for Keepalive. *IPPINGADDR sets the IP address you want to use for the connection test. Caution: If *IPPINGADDR is left blank or is set to an invalid IP address (example, an IP which is unreachable or one which is not a valid IP address), modem performance will be adversely affected. Data usage using Keepalive Keepalive is an optional feature.
CHAPTER 6 Hardware Installation Your AirLink Raven X should be mounted in a position that allows easy access for the cables so they are not bent or constricted. The LEDs on the front panel should be visible for ease of operational verification. You should ensure that there is adequate airflow around the modem but that it is kept free from direct exposure to the elements (sun, rain, etc.
Hardware Installation Your Raven X can be used with either DC (available in most automobiles) or 110 AC (standard US wall power) with the appropriate power adapter (available from AirLink). The power cable positive lead should be connected to the battery or power source positive terminal. The power cable negative lead should be connected to the battery or power source negative terminal.
Hardware Installation Power- Indicates the power adapter is connected and there is power getting to the modem. . The Reset button (on the left side) has two funtions. If it is quickly depressed and released, the modem will simply power cycle the internal hardware. If, however, the reset is depressed and held for several seconds (count 10 slowly), the ALEOS configuration settings will return to the factory defaults.
APPENDIX 7 Modem Placement When decided on a location to install your Raven X, make sure the modem will be away from direct exposure to the elements (sun, rain, etc.). Excess cables can be bundled and tied with twistties or other appropriate binders, but the less the cable is wrapped and bound together, the better the modem will perform. Built in Mounting Tabs for Raven X The Raven X is equipped with mounting tabs so there is no need for a seperate bracket.
APPENDIX A Specifications for the Raven X HSDPA Physical Characteristics: • Weight: 0.7 lbs • Size: height 1.4" (36mm), length 2.5" (65mm) x width 4.6" (117mm) width with mounting tabs 5.75” (146mm) • Send/Receive RF Antenna Connector: 50 Ohm SMA • Ethernet Interface: RJ-45 Connector, autosensing 100baseTX/10baseT • Serial Interface: RS232 DB-9F with 300-230400 bps (see below for diagram) • Status LEDs Data Services & RF Features • Quad Band GPRS/EDGE (850, 900, 1800 and 1900 MHz) • HSDPA data rates 1.
Specifications for the Raven X HSDPA Power Management: • • • • Low power consumption Dormant connection (idle for 10-20 seconds): 104 mA at 12 VDC Input Voltage: 9 VDC to 28 VDC Input Current: 20 mA to 350 mA Power consumption Modem Dormant/Idle Receiving Transmitting Raven X 85-95 mAh 260-300 mAh mAh Serial Port Pinouts The cable between the Raven X and a computer or other serial device needs to be wired straightthrough (pin 1 goes to pin 1, pin 2 to pin 2, etc.).
APPENDIX B AT Commands Note: Some commands can only be configured using a terminal emulation and typed AT commands. Some commands also require PassThru mode. You can use a fully qualified domain name instead of an IP address for most configuration options calling for an IP address if your is configured to use DNS. DNS settings frequently come directly from Cingular while your is registering on the cellular network and receiving it’s IP address.
AT Commands FIGURE 2. Wireless Ace: Tool bar 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 template in AceNet, too, to configure several modems at the same time with the same parameters. FIGURE 3. Wireless Ace: Save / Load a Template Raven X HSDPA for Cingular - User Guide, version 2.
AT Commands FIGURE 4. AceNet: Load a Template Using Telnet Terminal Emulation It is possible to communicate with the Raven X across a TCP/IP network. Telnet provides a terminal style connection to the Raven X. Most installations of Microsoft Windows come with a version of HyperTerminal (used here for specific directions), but you can use any other Telnet application, such as Putty, Terra Term, etc. Start>All Programs>Accessories>Communications>HyperTerminal 1.
AT Commands FIGURE 6. 3. When HyperTerminal connects to the Raven X, you will be prompted for a password. The default password is 12345. When you press Enter, you should get back a reply of “OK”. FIGURE 7. 4. HyperTerminal: TCP/IP Settings HyperTerminal: AT mode via Telnet Type AT and press Enter. You should get a reply of “OK” or “0”. To see what you are typing as you type it, you will need to turn on the echo and verbose mode. Type ATE1V1 and press Enter.
AT Commands FIGURE 8. 2. Select COM1 (or the comport to which the modem is connected) for the Connect Using. FIGURE 9. 3. HyperTerminal: Connection Name HyperTerminal: Comport Setting Change the Bits per Second to 115200 (default), Data Bits to 8, Parity to None, Stop Bits to 1, and Flow Control to Hardware. Note: If you have configured the Raven X for settings different than the defaults for Bits per Second, Data Bits, Parity, and/or Stop Bits, you will need to use your changed settings. FIGURE 10.
AT Commands • Required variable parameters are denoted with italicized text, example, Dn. The n 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” if the default has not been changed). • AT Commands are not case sensitive. A capital “E” is the same as a lower-case “e”.
AT Commands AT Command Listing Symbols &C . . . . . . . . . . . &D . . . . . . . . . . . &S . . . . . . . . . . . &V . . . . . . . . . . . &W . . . . . . . . . . . *CSX1 . . . . . . . . . *DATE . . . . . . . . . *DATZ . . . . . . . . . *DBGCOMLVL . . . *DBGDHCPLVL . . . *DBGETHLVL . . . . *DBGIPLVL . . . . . *DBGPPPLVL . . . . *DNS . . . . . . . . . *DNSUPDATE . . . . *DNSUSER . . . . . *DOMAIN . . . . . . *DPORT . . . . . . . . *DU . . . . . . . . . . *ENQ . . . . . . . . . *ETHMAC . . . . . .
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). Note: Those commands which are not displayed with Wireless Ace may require PassThru mode. FIGURE 1. Info Group Raven X HSDPA for Cingular - User Guide, version 2.
AT Commands: Information and Status FIGURE 2. Status Group I[n] n=0 Product name (for example, Raven X Raven-E). n=1 The Raven X’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). N=5 is not displayed with Wireless Ace. *DEVICEID? The 64-bit device ID the modem uses to identify itself to the cellular network.
AT Commands: Information and Status *HOSTMODE? The current host mode (AT, PPP, UDP, etc.). If the Raven X is not in AT mode, telnet into the modem to execute this command. *NETOP? The current cellular carrier (for example, Cingular) from the modem's firmware version. *NETPHONE? The modem's phone number (if applicable or obtainable). *NETRSSI? The current RSSI (Receive Signal Strength Indicator) of the Raven X as a negative dBm value. The same information is displayed with the command S202?.
AT Commands: Information and Status &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 Information Displayed in Wireless Ace without AT Commands Listed • Bytes and Packets Received and Sent Network traffic for the applicable port.
AT Commands: Misc (Miscellaneous) This group includes configuration commands which are not specific to other groups. The commands displayed in Wireless Ace and the results of those commands depends on the model of the modem. FIGURE 1. Common : Misc OPRG=n Enables/disables over-the-air firmware upgrading of the Raven X. 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.
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. The date and time are always specified 24-hour notation.
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. d.d.d.d=IP address Example: AT*STATICIP=192.168.1.23 Caution: *STATICIP does not set the IP address of the modem, it merely tells the modem which IP address to expect.
AT Commands: Serial Serial This group includes commands specific to the serial port. FIGURE 1. Common : Serial +++ Note: This command is not proceeded by AT nor does it require a carriage return (enter). There must be an idle time (set by S50) on the serial port before and after this command. The “+” is ASCII 0x2B. AT Escape sequence. If the Raven X is in a data mode (any mode other than PassThru), this command causes the modem to re-enter AT command mode. Cannot be configured in Wireless Ace.
AT Commands: Serial A/ Note: This command is not proceeded by AT. Re-execute last command. Cannot be configured in Wireless Ace. A 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. method=P : Establish a UDP connection method=T : Establish a TCP connection method=N : Establish a Telnet connection d.d.d.
AT Commands: Serial Qn The AT quiet-mode setting. If quiet mode is set, there will be no responses to AT commands except for data queried. n=0 : Off (Default) n=1 : Quiet-mode on S23=[speed],[databits][parity][stop bits] Serial line parameters. The settings take affect after reset. speed=300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200 | 230400 databits=7 or 8 parity=O : Odd parity=E : Even parity=N : None parity=M: Mark stopbits=1 | 1.
AT Commands: Serial n=0 : Always assert DCD. n=1 : Assert DCD when in a data mode (UDP, TCP, PPP, or SLIP) (Default). n=2 : Assert DCD when the modem has network coverage. &Dn Set DTR mode. n=0 : Ignore DTR, same effect as HW DTR always asserted (same as S211=1). n=2 : Use hardware DTR (same as S211=0). &Sn Set DSR mode. n=0 : Always assert DSR (Default). n=1 : Assert DSR when in a data mode (UDP, TCP, PPP, or SLIP) . n=2 : Assert DSR when the modem has network coverage.
AT Commands: TCP TCP This group includes commands specific to TCP communications. FIGURE 1. Common : TCP S0=n This register determines how the Raven X responds to an incoming TCP connection request. The Raven X remains in AT Command mode until a connection request is received. DTR must be asserted (S211=1 or &D0) and the Raven X must be set for a successful TCP connection. The Raven X will send a “RING” string to the host.
AT Commands: TCP S221=n Connect Delay: n= 0 - 255 Number of seconds to delay the “CONNECT' response upon establishing a TCP connection. OR Number of tenths of seconds to delay before outputting ENQ on the serial port after the CONNECT when the ENQ feature is enabled (see *ENQ). TCPS=n TCP connection time-out (TCPS) units. Specifies a time interval upon which if there is no in or outbound traffic through a TCP connection, the connection will be terminated.
AT Commands: UDP UDP This group includes commands specific to UDP communications. FIGURE 1. Common : UDP 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). Note: Always subject to any Friends filters that may be defined. HOR=n Half-Open Response - In UDP auto answer (half-open) mode: n=0 No response codes when UDP session is initiated.
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. S82=n Enables UDP auto answer (half-open) mode. n=0 : Normal mode n=2 : Enable UDP auto answer mode. S83=n Set or query UDP auto answer idle time-out.
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. (Default). n=1 : Set S53 to the last accepted IP. Note: This does not change the S53 setting in NVRAM.
AT Commands: DNS DNS This group includes commands specific to the modem being able to use domain names instead of IP addresses for other configuration options. FIGURE 1. Common : DNS *DNSn Queries the DNS addresses. Cingular provides the DNS addresses while your modem is registring on their network. n=1 or 2 First and second DNS address. d.d.d.d = IP of domain server *DNSUPDATE=n Indicates whether the modem should send DNS updates to the DNS server specified by *DNSUSER.
AT Commands: Dynamic IP Dynamic IP This group includes commands specific to dynamic DNS. Dynamic DNS allows the Raven X 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 X using IP Manager (page 14) running on a server with a dynamic DNS updater. FIGURE 1. Common : Dynamic IP *DOMAIN=[name] Domain (or domain zone) of which the Raven X is a part.
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. the IP change notifications will not be authenticated). AT*IPMGRKEY1 is used to set the key to use with AT*IPMANAGER1, while AT*IPMGRKEY2 is used to the key with AT*IPMANAGER2. n=1 : First IP Manager server. n=2 : Second IP Manager server.
AT Commands: PPP/Ethernet PPP/Ethernet This group includes commands specific to PPP or Ethernet connections between the Raven X and a connected device. FIGURE 1. Common : PPP/Ethernet *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. The username and password set in *HOSTUID and *HOSTPW will be used. n=0 : Disable PAP or CHAP request (Default). n=1 : PAP and CHAP. n=2 : CHAP *HOSTNETMASK=n.n.n.
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 HSDPA 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. If the network issues a new IP address, the HSDPA connection will be closed (since the IP address has changed) and has to be re-initiated.
AT Commands: PassThru PassThru PassThru Mode is used to communicate directly to the Raven X’s internal hardware. Caution: While the modem is in PassThru mode, ALEOS is disabled. If you need to connect to the Raven X while it is in PassThru mode, you will need to do so with a terminal application. Not all commands are available while the modem is in PassThru mode. FIGURE 1. Common : PassThru *CSX1=n n=0 : Data will be passed to the host.
AT Commands: PassThru \APASSTHRU Caution: This mode is not available through the remote AT telnet server. You will need to connect to the Raven X with it connected directly to your computer. Sets the modem operation to pass through mode. This mode will pass any characters received on the Ethernet port directly to the internal hardware module and output any characters from the internal hardware module out the Ethernet port. This allows direct access/configuration of the hardware module.
AT Commands: SMTP (including SMS) SMTP (including SMS) This group includes commands specific to messaging. SMS (Short Message Service) is a way to send messages via Cingular’s cellular network. Caution: Your account with Cingular may not support message sending with SMS. FIGURE 1. Common : SMTP *SMTPADDR=name] Specify the IP address or Fully Qualified Domain Name (FQDN) of the SMTP server to use. d.d.d.d=IP Address name=domain name Maximum: 40 characters.
AT Commands: SMTP (including SMS) Maximum: 40 characters. Note: Not required to use SMTP settings but may be required by Cingular. Messaging related AT Commands not Available through Wireless Ace *NETSMS2EMAIL=n Specify the SMS/E-mail server number. This maybe necessary to send an SMS message to an email address . n=SMS/E-mail server *SMTPSEND=[email][body] Sends an email to the address specified, followed by the body of the email message.
AT Commands: Other Other The commands in this group are not specific to the other group categories. FIGURE 1. Common : Other DAE=n Disable AT Escape Sequence detection. n=0 : Enable +++ AT escape sequence detection. n=1 : Disable +++ AT escape sequence detection. *DATZ=n Enables or disables reset on ATZ. n=0 : Normal Reset (Default) n=1 : Disable Reset on ATZ *IPPING=n Set the period to ping (if no valid packets have been received) a specified address (*IPPINGADDR) to keep the modem alive (online).
AT Commands: Other 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. *IPPINGADDR=[d.d.d.d][name] Set the IP address or valid internet domain name for the Raven X to ping to keep itself alive (online). *IPPING must to be set to a value other than 0 to enable pinging. d.d.d.
AT Commands: Other n=1 : Authentication equivalent to “authNoPriv” setting in SNMPv3. SNMPv3 is required to do authentication, SNMPv2c transmissions will be silently discarded. n=2 : Authentication and encryption, equivalent to “authPriv”' setting in SNMPv3. SNMPv3 is required to do authentication and encryption, SNMPv2c and SNMPv3 authNoPriv transmissions will be silently discarded. Messages are both authenticated and encrypted to prevent a hacker from viewing its contents.
AT Commands: Friends Friends Friends Mode can limit access to the Raven X from Cingular’s network and the Internet. Friends Mode is a limited form of security, a basic firewall. Note: Friends mode does not block any traffic from the cellular network, wanted or not. Friends Mode will only prevent the Raven X from forwarding data from those not on the Friends List. It does not prevent data from traversing the network to the modem which is still billable traffic. FIGURE 1.
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. FIGURE 1. Logging *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 *DBGDHCPLVL=n Enable or disable internal DHCP logging. n=0 : No logging n=1 : Log DHCP events. *DBGETHLVL=n Sets the logging level for the Ethernet port.
AT Commands: Logging n=3 : Log the header of all received and sent packets. Note that this can quickly exhaust available space for the event log. *DBGPPPLVL=n Sets the logging level for the PPP stack. Enables logging at different levels of detail. n=0 : No logging n=1 : Log client events (default) n=2 : Log server events n=3 : Log client and Server events Raven X HSDPA for Cingular - User Guide, version 2.
AT Commands: EDGE/HSDPA EDGE/HSDPA This group includes commands specific to HSDPA, EDGE and GPRS. FIGURE 1. EDGE/HSDPA +CGQMIN Minimum Acceptable Quality of Service Profile. Change should be at carrier's request. Normally not required to be changed. +CGQREQ Set Quality of Service Profile. Change should be at carrier's request. Normally not required to be changed. +COPS=mode,[format][,oper] Manually specify an operator. Refer also to *NETOP. mode=0 : Automatic - any affiliated carrier [default].
APPENDIX C PPPoE: Point to Point Protocol over Ethernet PPPoE (Point-to-Point Protocol over Ethernet) allows a point-to-point connection while using Ethernet. Just like the dial up protocol on which it is based, PPPoE uses traditional username and password authentication to establish a direct connection between two Ethernet devices on a network (such as your Raven X and your computer or router).
PPPoE: Point to Point Protocol over Ethernet FIGURE 1. Wireless Ace: Connect b. When Wireless Ace has connected to your Raven X, from the groups on the left, select PPP/ Ethernet under Common. FIGURE 2. Wireless Ace: PPP/Ethernet 2 - Chap User Name (encrypted) Password (encrypted) 2 - Enabled/LAN Note: Wireless Ace shows the existing values for *HOSTUID and *HOSTPW encrypted and character padded. 3. Configure *HOSTAUTH, *HOSTUID, and *HOSTPW. a. Change *HOSTAUTH to 2. b.
PPPoE: Point to Point Protocol over Ethernet PPPoE connections can use a Service Name to differentiate PPPoE devices. You can use Wireless Ace to give your Raven X a name. a. In Wireless Ace, select Dynamic IP from the groups on the left. b. Enter a name for *MODEMNAME, such as Raven X or the ESN. FIGURE 3.
PPPoE: Point to Point Protocol over Ethernet FIGURE 6. Show All Connections b. Select Create a New Connection under Network Tasks in the menu area on the left. Select Next to start installing and configuring the PPPoE connection. FIGURE 7. Network Connections Raven X HSDPA for Cingular - User Guide, version 2.
PPPoE: Point to Point Protocol over Ethernet FIGURE 8. New Connection c. Select Connect to the Internet and then select Next. FIGURE 9. Connection Type d. Select Set up my connection manually and then select Next. FIGURE 10. Preparing the Internet Connection e. Select Connect using a broadband connection... and select Next. Raven X HSDPA for Cingular - User Guide, version 2.
PPPoE: Point to Point Protocol over Ethernet FIGURE 11. Internet Connection f. Type in a name for the connection, such as AirLink PPPoE Connection. Select Next. PPPoE The name provided here will not effect the connection in any way. It is only a label for the icon. It can be the name of your Wireless Service Provider (Cingular), your modem (Raven X), or any other designation for the connection. FIGURE 12.
PPPoE: Point to Point Protocol over Ethernet h. If you want to add a shortcut for this connection to your desktop, check Add a shortcut... Select Finish to exit the Network Connection Wizard. FIGURE 14. 2. Finish Configure the connection. After you complete the New Connection Wizard, there are a few more things you will want to configure in the connection. Raven X HSDPA for Cingular - User Guide, version 2.
PPPoE: Point to Point Protocol over Ethernet FIGURE 15. Connect a. When the Connect window opens, select Properties. Optional: On the General tab, if you gave the modem a name with *MODEMNAME above, you can type in that name as the Service Name. FIGURE 16. Connection Properties Same as *MODEMNAME configured earlier b. Select Networking. Select Settings. Remove the checks from all three PPP settings. Select OK. FIGURE 17.
PPPoE: Point to Point Protocol over Ethernet Optional: You may want to check the Options tab and change the settings for applications you might be using. The default options are generally applicable for most uses. c. Unless specifically directed to do so by Support or your network administrator, you should not need to make any changes to the options on the Networking, Security, or Advanced tabs.
PPPoE: Point to Point Protocol over Ethernet Configuring your router for PPPoE with the Raven X If your network router has PPPoE discovery, the Raven X will be discovered on the intranet through PPPoE discovery process, which uses broadcast Ethernet packets. Once found, the Raven X can be designated as the primary or failover connection.
APPENDIX D Simple Network Management Protocol (SNMP) The Raven X can be configured as an SNMP agent and supports SNMPv2c and SNMPv3. SNMP Overview The Simple Network Management Protocol (SNMP) was designed to allow remote management and monitoring of a variety of devices from a central location.
Simple Network Management Protocol (SNMP) There are only three commands to set for SNMP in the Raven X: the listening port, the security level, and the trap destination. Listening Port *SNMPPORT sets the port for the SNMP agent to listen on. If set to zero, default, SNMP is dis- abled. FIGURE 1. Wireless Ace: *SNMPPORT Note: SNMP generally uses port 161, however most Internet providers (including cellular) block all ports below 1024 as a security measure.
Simple Network Management Protocol (SNMP) FIGURE 3. Wireless Ace: Changing the Raven X Password - Menu Option The current password will be pre-entered. As you type the new password and confirm it, the characters you type will be obscured by “x”. For the password, you can use numbers, letters, and/or punctuation. Caution: The password is case sensitive. “drowssaP” is not the same as “drowssap”. Trap Destination *SNMPTRAPDEST needs to be set with the destination IP and port.
Simple Network Management Protocol (SNMP) internet OBJECT IDENTIFIER ::= { dod 1 } private OBJECT IDENTIFIER ::= { internet 4 } enterprises OBJECT IDENTIFIER ::= { private 1 } airlink OBJECT IDENTIFIER ::= { enterprises 20542 } general OBJECT IDENTIFIER ::= { airlink 1 } common OBJECT IDENTIFIER ::= { airlink 2 } status OBJECT IDENTIFIER ::= { airlink 3 } gps OBJECT IDENTIFIER ::= { airlink 4 } -- GENERAL -phoneNumber OBJECT-TYPE SYNTAX DisplayString (SIZE (10)) MAX-ACCESS read-only STATUS current ::= {
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 STATUS current ::= { general 8 } -- COMMON -date OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { commo
Simple Network Management Protocol (SNMP) ::= { common 2 } devicePort OBJECT-TYPE SYNTAX INTEGER(0..
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 SYNTAX IpAddress MAX-ACCESS read-only STATUS current ::= { status 1 } netState OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only
Simple Network Management Protocol (SNMP) ::= { status 3 } rssi OBJECT-TYPE SYNTAX INTEGER(-125..
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 STATUS current ::= { gps 4 } END Raven X HSDPA for Cingular - User Guide, version 2.
APPENDIX E 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 Corporate Place, Hayward, CA 94545, in connection with the sale and licensing of AirLink software and hardware.
Warranty Terms and Conditions Warranty Conditions Remedy If under normal use the Software and/or Hardware (collectively, the "Products") prove to have any such defect and the Customer notifies AirLink of such defect within the warranty period, AirLink, at its option, will either repair or replace the same without charge.
Warranty Terms and Conditions DIRECTLY GIVES RISE TO THE CLAIM. THIS CLAUSE WILL SURVIVE THE FAILURE 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.
APPENDIX F Frequently Asked Questions and Technical Support Many of these questions and solutions in the following sections come from AirLink Support. Caution: Solutions should only be performed if you are experiencing the specific problem indicated and have the specific modem model number indicated. Some solutions are very specific to model numbers due to differing internal hardware. FAQ Topics Power, Antennas, and Signal Strength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Frequently Asked Questions and Technical Support What is the Proper RF Coverage for my Raven X? 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. Any devices with an RSSI below -105 DBm will likely fail to register on a regular basis.
Frequently Asked Questions and Technical Support mounted antenna can be placed in locations where the simple, short dipole antenna connected directly to the Raven X may not perform at all. Note: When using a cable with an antenna, there is a dB loss over the distance of the cable. It is possible to lose the full gain of an antenna while using a long cable to the modem.
Frequently Asked Questions and Technical Support What is the difference between Private and Public mode? When your Raven X is powered on, ALEOS, acting as a PPP client, negotiates a PPP session with Cingular’s network at the conclusion of which it is assigned an IP address by your cellular provider. How this address is further acted upon by the modem is determined by Private or Public Mode.
Frequently Asked Questions and Technical Support Unless you are instructed to use a different IP range and subnet by your Network Administrator, using the 192.168.1.x or 192.168.0.x range with a subnet mask of 255.255.255.0 is recommended. Caution: If the IP address of the device or computer connected to the modem is dif- ferent from the one configured in the modem as the *HOSTPEERIP, communications will fail.
Frequently Asked Questions and Technical Support FIGURE 1. 4. Modem Doctor Select Ethernet and enter the MAC address listed on a small sticker on the bottom of your Raven X. Enter the IMEI, found on the label on the top of the Raven X. Security for the Raven X Does HSDPA provide any security? While the structure of the HSDPA network provides data security, it is still recommended you use a VPN for additional data communication security.
Frequently Asked Questions and Technical Support The support technician will ask you for a Challenge Code which you can obtain using Wireless 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. 1. 2. Start Wireless ACE: Start > All Programs > AirLink Communications > Wirelss ACE 3G > Wireless ACE 3G Select Modem > Reset Password. FIGURE 2. 3.
AirLink Technical Support AirLink Technical Support If you encounter problems with operation of your Raven X, AirLink’s support staff can help. AirLink Support Web Site The AirLink web site is updated frequently with Setup Wizards, Utilities, How-To Guides, and other documentation: http://www.airlink.com/support.
