USAT USATCORP.COM Contact USATCORP.COM for more information or quantity pricing 1-888-550-8728 Raven X 1x/EV-DO User Guide 20070914 Rev 1.
Raven X 1x/EV-DO User Guide 20070914 Rev 1.
Preface Important Notice Due to the nature of wireless communications, transmission and reception of data can never be guaranteed. Data may be delayed, corrupted (i.e., have errors) or be totally lost.
Preface DIRECT, INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS OR REVENUE OR ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE USE OR INABILITY TO USE ANY SIERRA WIRELESS PRODUCT, EVEN IF SIERRA WIRELESS AND/OR ITS AFFILIATES HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY.
Preface AirLink™ and AceWare™ are trademarks of Sierra Wireless. Sierra Wireless, the Sierra Wireless logo, the red wave design, and the red‐tipped antenna are trademarks of Sierra Wireless. Windows® is a registered trademark of Microsoft Corporation. QUALCOMM® is a registered trademark of QUALCOMM Incorporated. Used under license. Other trademarks are the property of the respective owners.
Preface Revision number Release date Changes 1.x 2003-2005 AirLink Communications documentation - CDPD, CDMA, and GPRS. 2.x Q2: 2005-Q2: 2007 AirLink Communications documentation - CDMA, EV-DO, EDGE, and HSUPA/HSDPA. 3.0 Q2: 2008 Converted documentation from AirLink Communications documentation format into Sierra Wireless documentation format. Phase II of the conversion completed. Raven modem line documentation is revised. Rev 1.0C Jul.
Contents Introduction to the Raven X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 ALEOS™ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 AceWare™. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 AceManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Connecting to a Computer or other Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Indicator Lights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Light Patterns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Mounting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents IP Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69 Reasons to contact the modem and/or the connected device: . . . . . . . . . . . . . . . . . . . . . . . . . 69 Understanding Domain Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 car54.mydomain.com . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents *NETPHONE?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 &V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents S6=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 S8=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 S9=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 S10=n . . . . . . . . . . . . . . . .
Contents *HOSTPRIVIP=d.d.d.d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 *HOSTPRIVMODE=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 *HOSTPW=string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 *HOSTUID=string. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents *DBGPPPLVL=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 IPL=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 MVLEN=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 MVMSK=hh . . . . . . . . . . . . . . . . . . . . . . .
1: Introduction to the Raven X 1 • ALEOS™ • AceWare™ • Connecting to your cellular Network • EV-DO The Raven X is equipped with a robust ARM9 processor and embedded ALEOS™ technology to optimize performance on todayʹs high speed data networks. The high‐speed interface and 3G‐optimized architecture make the Raven X ideal for various commercial mobile or portable network connectivity applications. Embedded machine protocols make it equally suited for remote industrial and M2M deployments.
Introduction to the Raven X • Protocol Spoofing Figure 1-2: Powered by ALEOS AceWare™ A wireless solution is not complete until you have software tools to manage the devices monitoring your valuable equipment. AceWare™ is the device management and monitoring application suite for Sierra Wireless AirLink products powered by ALEOS. • AceManager • AceNet • AceView • Modem Doctor These modem utilities, except AceNet, are free of charge to those who own Sierra Wireless AirLink modems.
Introduction to the Raven X Figure 1-3: AceManager Simplified Deployment AceManager provides the ability to remotely set up and configure your Sierra Wireless AirLink products. Remote device setup and configuration reduces the deployment timeline of your wireless solution and provides a quicker path to ROI. Templates allow you to easily configure other devices in your fleet with identical settings, ensuring a simple, accurate deployment.
Introduction to the Raven X Figure 1-4: AceNet Network Monitoring AceNet allows you to efficiently deploy, monitor, and maintain wireless networks of any size by enabling you to quickly configure an entire group of Sierra Wireless AirLink modems to the same parameter settings using templates built with AceManager. To ensure your implementation is optimal, users can easily see when modems are out of contact and periodically poll each device for performance statistics.
Introduction to the Raven X erase the current configuration completely., and temporarily set the Raven X to a known configuration to aid in trouble shooting (SOS mode). Figure 1-6: Modem Doctor Modem Doctor USB 1. Open the ModemDoctorUSB.exe. 2. Select any one option. Note: If you are using USB port as serial, then USB device is set to “o” and if you are using the default option then the USB device is set to “1”. The available port is automatically detected. Passsword is the fault password. 3.
Introduction to the Raven X Figure 1-7: Modem Doctor: USB connection Connecting to your cellular Network The Raven X uses your cellular Network as an ISP (Internet Service Provider) to connect you to the Internet. Steps of a connection: Rev 1.0C Jul.09 1. When your Raven X is powered on, it automatically searches for cellular service using CDMA. 2.
Introduction to the Raven X Figure 1-8: Connecting to the Internet The Raven X will perform a one‐to‐one routing for all internet traffic to and from the computer or other end device. One‐to‐ one means that your Raven X will provide a connection for one device to the Internet at a time. In Private Mode, the Raven X will provide NAT (Network Address Translation) for the computer or other end device.
Introduction to the Raven X 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). Tip: If your account with your cellular Network includes a dynamic IP address and you need a static IP, please consult your your cellular Network Representative for more information about changing your account for static IP support.
Introduction to the Raven X Security 1x data transmissions are highly secure. Originally developed based upon the “spread spectrum” pioneered by the US Department of Defense, security in CDMA technologies is obtained by spreading the digital information contained in a particular signal of interest over multiple coded paths, over a much greater bandwidth than the original signal. Rev 1.0C Jul.
2: Specifications 2 • Interface Port Pin-Outs • Power Connector Features and Benefits • Embedded Intelligence • Low Power Consumption • High‐Speed Processor • High‐Speed 2‐way Data • Ethernet and Serial Port • Machine Protocols • Persistent Network Connectivity • Remote Management and Configuration • Class I Div 2 Certified Technology • CDMA EV‐DO Revision A With Fallback to: · CDMA 1x EV‐DO (Revision 0) · CDMA 1xRTT · CDMA IS‐95 Bands • 800 Mhz Cellular • 1900 Mhz PCS Environmenta
Specifications • Industry Canada • This apparatus is suitable for use in Class I, Division 2, Groups A, B, C, D or unclassified or non‐hazardous locations. Warning: Explosion Hazard - Substitution of any components may impair suitability for Class I, Division 2.
Specifications Interface Port Pin-Outs Serial Port Unused CTS (Clear to Send) < RTS (Request to Send) - > DSR (Data to Send) < - 9 5 4 8 3 7 2 6 1 < - > GND (Ground) < - DTR Data Terminal Ready) < - Rx (Receive) - > Tx (Transmit) - > DCD (Data Carrier Detect) Figure 2-1: Serial Port Diagram: Female DB-9 DCE (not to scale) Power Connector Not Used Ground (black) Not Used Power (red) Figure 2-2: Power Connector (not to scale) Rev 1.0C Jul.
3: Activating your Raven X on your cellular Network • Activating Using AT Commands 3 This chapter provides step‐by‐step directions for activating your Raven X on your cellular Network’s network. H Activating Using AT Commands An alternate method to configure and activate your Raven X is by using AT commands sent directly to the modem with a terminal application. Caution: It is not possible to activate the Raven X using either Aceweb or AceNet. 1. Set telnet timeout in to 20 minutes. 2.
Raven X 1x/EV-DO Using Direct Commands to the Internal Hardware Use only if the ALEOS method is unsuccessful. Activating the Modem 1. Set telnet timeout in to 20 minutes. 2. Save the telnet setting. 3. Verify ALEOS has established communication to the internal hardware. 4. Enter the user name of your account (NAI). The user name is usually expressed as an email address with phone number of the account (example, 1234567@carrier.com). This information should be provided by your carrier.
Activating your Raven X on your cellular Network 12. Reset the module. AT!RESET 13. Press the reset button on the front of the modem. When the modem restarts, it should register on the network. Private Networking Note: Please activate the modem first, before following the Private Networking steps. Note: These AT commands are only needed if your cellular account supports Private Networking . Not all of the parameters are required. Please check with your carrier, which parameters need to be set. 1.
Raven X 1x/EV-DO 23 20070914
4: Hardware Installation of the Raven X 4 • Connecting to Power • Connecting to a Computer or other Device • Indicator Lights • Mounting Note: During installation, please be sure that the cables are secure but do not bear any additional weight that could loosen the connector from the unit. Your Raven X should be mounted in a position that allows easy access for the cables so they are not bent, constricted, in close proximity to high amperage, or exposed to extreme temperatures.
Hardware Installation of the Raven X radio communications regulations of the Federal Communica‐ tions Commission (FCC), Industry Canada, or your country’s regulatory body (if used outside the US). Your Raven X will work with most cellular antennas with a SMA connector. Connect the primary antenna or primary RF cable directly to the antenna connector on the back of the Raven X. Tip: When using a cable to an antenna placed away from the modem, minimize the length of your cable.
Hardware Installation of the Raven X Connecting to a Computer or other Device Figure 4-2: Ethernet The Ethernet port of your Raven X can be connected directly to a computer or other Ethernet device with either a cross‐over cable or a straight‐through cable. The Ethernet port on the Raven X is auto‐sensing and will auto‐detect the speed of the connecting device for 100baseTX or 10baseT.
Hardware Installation of the Raven X • Network ‐ Indicates a successful connection to the cellular network with an IP address given and a channel acquired. • Signal ‐ Light shows the strength of the signal and may be nearly solid (strong signal) or flashing (weaker signal). A slow flash indicates a very weak signal.
Hardware Installation of the Raven X • SOS ‐ The Network and Service Err or Service LEDs will blink alternate to each other. • Configuration Reset ‐ The LEDs will cycle left to right and then right to left 4 times. • Authentication Failure ‐ The Network, Signal, and Activity LEDs blink every 2 seconds. • Data Retry ‐ The Network, Signal, and Activity LEDs blink every 3 seconds. • Invalid MAC Address or Ethernet Initiation Fail ‐ The Service LED will blink.
5: Configuring your Raven X • Using AceManager • Using Templates • Using a Terminal Application with AT Commands 5 With ALEOS as its “brain”, the Raven X is a highly configu‐ rable device, more than just a “dumb” modem. To configure your Raven X, you have two options. You can use the configuration and management applications of the AceWare suite or you can use a terminal emulator application such as HyperTerminal, PuTTY, or many others.
Configuring your Raven X 2. Connect to your Raven X a. Click the Connect button. Figure 5-2: AceManager : Connect to Modem b. Select a connection method: · If you are connecting remotely, you can use UDP, TCP, or SMS. · If you are connecting locally with the modem connected directly to your computer using a serial cable, you can use PPP. · If you are connecting locally with the modem connected directly to your computer using an Ethernet cable, you can use UDP, TCP, or Ethernet. c.
Configuring your Raven X Figure 5-3: AceManager : Connected 3. Enter the configuration options a. On the left side of AceManager is the Groups menu. Select the appropriate group as needed or directed. b. Enter your changes in the New Value column by typing in the desired change or using the drop down menus. c. The current configuration is shown in the Value column. Figure 5-4: AceManager : Changing values Rev 1.0C Jul.
Configuring your Raven X 4. Write the changes to the modem a. Click the Write button on the tool bar of AceManager. b. Wait for the message “Write Successful” to appear in the status bar. Figure 5-5: AceManager : Write Tip: Some configuration settings will require you to reset the modem before they will take effect. You can reset the modem by using the Reset button in AceManager or by using the reset button on the modem. You can also reset the modem by cycling the power.
Configuring your Raven X Note: Some of the configuration settings are specific to individual modems. You do not want to have those settings in your saved template otherwise the modems you configure with the template could cease to work with the cellular or local network. · Cellular Technology specific settings (the CDMA/EV‐DO group) · *MODEMNAME · *HOSTPRIVIP · *HOSTPEERIP · *HOSTUID · *HOSTPW d. Click the Save button on the toolbar. e.
Configuring your Raven X 2. Applying a Template to one modem with AceManager You can use a template you created yourself, using the steps above, or a template provided by your AirLink representative or someone in your company who has set up a modem template. The template you wish to apply must be saved to your hard drive. a. Load the template. 1. Connect to the modem you want to configure using AceManager. 2. Click on the Load button on the toolbar. Figure 5-8: AceManager : Load 3.
Configuring your Raven X Tip: You can use common settings on one modem to configure those same settings on another modem even of a different type. For example, you can use the serial settings of a modem (such as PinPoint X or Raven X) to configure the serial settings of a Raven X. Settings not applicable to the modem on which you are loading the template, will be discarded. 3.
Configuring your Raven X Figure 5-10: AceNet : Selected modems Tip: Click on the first with your mouse and, with the control button held down, click the additional modem. b. Select the Modem option in the tool bar and then select Apply AceManager Template. Figure 5-11: AceNet : Modem menu c. Rev 1.0C Jul.09 Either type in the Template file name, or click browse and select the template file you want to apply (you may need to change folders).
Configuring your Raven X Figure 5-12: AceNet : Template select d. Set the Retry Interval and check if you want to have the modems Reset when the template has been applied. Using a Terminal Application with AT Commands You can access and configure your Raven X using a terminal application such as Microsoft HyperTerminal, PuTTY, or similar. The following directions are for HyperTerminal which is part of a standard installation of Windows XP.
Configuring your Raven X Figure 5-13: HyperTerminal 1. Choose a name and icon for your connection. a. Choose a name for your connection, such as Raven X or Sierra Wireless AirLink Solutions. The name and icon are only for your own reference so you can find the connection at a later date. Tip: If you want to have a connection saved for both local and remote, it is recommended the connection name reflect the connection type, i.e. Raven X local. b. Select OK. 2. Connect To Using Serial: a.
Configuring your Raven X Figure 5-14: Connect To Using Ethernet: a. Select TCP/IP (Winsock) for “Connect Using”. b. Type in 192.169.13.31 for Host Address. c. Change the “Port Number” to 2332. d. Select OK. 3. Port Settings (serial only) a. Change or verify the settings: · Bits per Second: 115200 (default) · Data Bits: 8 · Parity: None · Stop Bits: 1 · Flow Control: Hardware. Rev 1.0C Jul.
Configuring your Raven X Figure 5-15: Port Settings Tip: 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. b. Select OK. 4. Connected Figure 5-16: HyperTerminal : TCP/IP connected a. If you are prompted for a password, enter 12345. Rev 1.0C Jul.
Configuring your Raven X Tip: You will not be prompted for a password if you connect using a COM port. b. Type AT and press Enter. You should get a reply of “OK” or “0”. c. 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. d. If you get a reply of “OK”, then you entered the command successfully. If you get a reply of “0” or “ERROR”, try entering the command again.
6: Data Communication and Host Modes • Basic Modes • Serial Modes • Data Communication 6 The Raven X plays the part of a HOST when a computer or another device is connected directly to its port and routes data to/from the connected device to the cellular network. Caution: 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.
Data Communication and Host Modes • UDP and UDP PAD: Any data received on the serial port is assembled into UDP packets and sent to the session’s associated IP address and Port (described later). Any responses received from the associated IP address and port destined for the Device Port are unwrapped and sent out the serial port. • TCP and TCP PAD: Any data received on the serial port is packaged into TCP messages and sent to the associated connection’s IP address and Port (described later).
Data Communication and Host Modes If the serial port of the Raven X is in any mode other than AT or PassThru, the AT command mode can be re‐entered by: • Deactivating DTR (if &D2 or Ignore DTR, S211, is not set). • Issuing the +++ escape sequence (if Disable AT Escape, DAE, is not set). • Resetting or Power cycling the modem. Note: DTR needs to be asserted (S211=1 or &D0) by the host before PPP Mode, SLIP Mode, UDP PAD Mode, or TCP PAD Mode can be entered.
Data Communication and Host Modes carriage return ‐ if V=0 carriage return and new line OK another carriage return and new line ‐ if V=1 Note: These commands work for the port on which they are executed. For example, if the user types ATE1 and then AT&W using a serial port connection, it will set the serial port to Echo On.
Data Communication and Host Modes Figure 6-2: AceManager : PassThru PassThru Mode allows only specific AT commands. Some ALEOS commands will be unavailable when the Raven X is in PassThru mode. The commands usable also depend heavily on the modem model number (found on the label on the top of the Raven X). Note: 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.
Data Communication and Host Modes Figure 6-3: AceManager : S0 If you need to change the port for Telnet (for example, you have the default port blocked on your firewall), the option is on the Other tab. The default telnet port is 2332. You can also change the Telnet timeout, if the connection is idle, default 2 minutes. Figure 6-4: AceManager : Other - *TPORT, *TELNETTIMEOUT.
Data Communication and Host Modes • AT\APPP • ATDT10.0.0.1 • ATDT10001 • ATD#19788 or #777 *99***1# • CLIENT In response to any of the preceding commands, the Raven X will respond with CONNECT a carriage return and new line and is ready for the host to begin PPP negotiations. The IP received by the host in the resulting negotiation will either be a private (non‐routable) IP address or a public (network‐ routable) IP address provided by the network, depending on the settings of *HOSTPRIVMODE.
Data Communication and Host Modes Link Radio Coverage There are three options for the “Link Radio Coverage to” field. You can link radio coverage to either Ethernet or USB (USBnet or USBserial)or disable the specified port. Hence, when not in coverage, the specified host port is turned off. Minimum off‐ time of 10 seconds apply for both USB and Ethernet. Note: When the cellular connection is down, the port is also down. SLIP SLIP mode is entered be using the “AT\ASLIP” command.
Data Communication and Host Modes idle inter‐character time‐out specified in S50 (in tenths of seconds) occurs or when a character is received that matches S51 (if non‐zero). UDP Auto Answer UDP auto answer (previously called UDP half‐open) is set with S82=2. When set, the Raven X will automatically establish a UDP session to the source IP address and port of the UDP packet received.
Data Communication and Host Modes Tip: TCP auto answer (S0) may also be set simultaneously with UDP auto answer. Then, when in the idle state, the modem will accept either a TCP or UDP incoming packet, and enter a TCP or UDP session as appropriate. Reliable UDP Reliable UDP adds a simple protocol on top of UDP to provide reliable delivery of data. When data is received from the host serial port, a 2 byte header is added to the data, containing a message type and a sequence number.
Data Communication and Host Modes When the Raven X is in a TCP session, all characters received on the serial port are assembled into TCP packets and sent to the modeʹs remote IP address/port, and any packets received from the remote end of the TCP connection are disassembled and dumped onto the serial line. A TCP connection is established by one of the following methods: • Using the Dial TCP (DT) AT command. For example, ATDT192.168.3.23/3456.
Data Communication and Host Modes Hybrid Modes Hybrid modes are supported mainly for legacy implementa‐ tions. Some previous hybrid modes (MD=5, 6) are no longer implemented as special, unique modes. Now that UDP auto answer (UDP Half‐open, S82=2) can be enabled in conjunction with UDP PAD mode (MD3), effectively this is the same as MD5 and MD6 previously accomplished. Setting MD5 and MD6 are still supported, but not recommended.
Data Communication and Host Modes If you need more control over which gateway address, device address, and netmask that is given out by the internal DHCP server, you can use the private host mode, *HOSTPRIVMODE, and set the internal network IP addresses. The Raven X will use NAT to forward packets to the end device. Tip: When using Public mode, Sierra Wireless recommends connecting the modem directly to the computer or other end device.
Data Communication and Host Modes • *HOSTPEERIP ‐ Set to the IP address you want for the Raven X. • *HOSTNETMASK ‐ Set to the subnetmask, generally 255.255.255.0. Tip: If you are using Private Mode (*HOSTPRIVMODE=1), you will need to make sure that *HOSTPRIVIP and *HOSTPEERIP are on the same subnet. If the subnet mask is 255.255.255.0, it is safe to use 192.168.x.
Data Communication and Host Modes *HOSTPEERIP if it is changed) to 10.1.2.1 (or 10.1.2.2 if that was what the gateway address was given as). Tip: When PPPoE is used with the Raven X, DHCP is not needed. A tunnel is set up connecting a device (such as your computer or a router) with the modem. The device will then simply use the MAC address of the Raven X to send all outgoing packets.
Data Communication and Host Modes Figure 6-7: AceManager: Port Forwarding Figure 6-8: Port Forwarding In AceManager, enter the fields in the Port Forwarding group. Rev 1.0C Jul.09 • Number of PF Entries: Set value to number of used Port forward rules for performance gain. Each forwarding entry has four parameters: · Public Port: Port number of the Modem/Gateway. · Host/IF: Physical connection type to the modem. (USB, Ethernet). · Host IP: IP address of the connected device/computer.
Data Communication and Host Modes ports to be forwarded, and or changed without individual entry. For example, if Public range is 8080 ‐ 8090 to 80, this will cause 8086 to be forwarded to 86. You can set a default in the PPP/Ethernet group, if you do not need: • To forward to specific ports on your connected device, but you want all data to be directly used by ALEOS, or otherwise forwarded. • To pass to only one connected device.
Data Communication and Host Modes Note: In addition to the security settings in ALEOS, Inbound connections also require mobile terminated or Internet routable WAN/Cellular account. Figure 6-9: Outbound IP Filtering Rev 1.0C Jul.
Data Communication and Host Modes Figure 6-10: AceManager: Firewall - IP Note: Port Filtering Mode does not require to be set when you enable Non-Friends Port Forwarding. Rev 1.0C Jul.09 • Port Filtering Mode: Independent of the IP filtering, this mode can be enabled to block ports specified or allow ports specified. When enabled, all ports not matching the rule will be allowed or blocked depending on the mode.
Data Communication and Host Modes Figure 6-11: AceManager: Firewall Ports • Firewall Port: Specify the port you wish to have blocked or allowed, depending on the mode configured. • Packet Filtering: Not available at this time. Figure 6-12: AceManager: Firewall VPN Sierra Wireless AirLink modems with IPSec are designed to support the gateway‐to‐gateway security model. IPsec is the most general security model, in that it allows either side to initiate a VPN session. Rev 1.0C Jul.
Data Communication and Host Modes Split Tunnel Figure 6-13: GRE in AceManager: Default Configuration Name Default Value Description Incoming Out of Band 0 Enable (1) or Disable (0) access to modem remotely from machines that are not part of the IPSec network. Outgoing Aleos Out of Band 1 Enable (1) or Disable (0) sending of ALEOS traffic over the IPSec tunnel to a remote location. This option allows ALEOS generated data (E.g. RAP) to be sent outside the IPSec tunnel.
Data Communication and Host Modes VPN 1 The VPN group tab will show IPSec and GRE related param‐ eters and configuration fields on the right side of the pane Figure 6-14: AceManager: VPN 1 Rev 1.0C Jul.
Data Communication and Host Modes Table 6-1: Configuration Parameters in AceManager Name Tunnel Type Default Value 0 Description There are three options for each VPN tunnel and they are as follows: • Feature not used • IPSec • GRE • GRE and IPSec IPSec Status Disconnected Shows the status of IPSec. IPSec Gateway 64.163.70.30 Fill in the IPSec of the VPN concentrator. When GRE is enabled - Enter GRE gateway address, for example, 64.163.70.115.
Data Communication and Host Modes Table 6-1: Configuration Parameters in AceManager Name Local Address Type Default Value 1 Description Choose from drop-down menu. • “1” indicates Modem Public IP. It is the IP of the device behind the modem, when the modem is in public mode. • “2” indicates Host Private Subnet of the device behind the modem on the same subnet, when the modem is in private mode. • “5” indicates Single Address. • “17” indicates Subnet Address. Local Address 0.0.0.
Data Communication and Host Modes Table 6-1: Configuration Parameters in AceManager Name Default Value Description IPSec Key Group 2 Different Key Groups are, 1-DH1, 2-DH2 and 5-DH5. DH5 denotes highest security IPSec SA Life Time 7200 (seconds) This indicates how often the modem renegotiates the IKE SA. While the renegotiation happens the VPN tunnel gets disconnected temporarily. Note: For further information on IPSec, please refer to the IPSec User Guide.
Data Communication and Host Modes properly. If it determines the connection is not functioning, the modem will then attempt to reconnect to your cellular Network to reestablish IP connectivity. Configuring Keepalive In AceManager, the Keepalive settings are part of the Other group. Figure 6-15: AceManager : Other • *IPPING sets the interval, in minutes, you want Keepalive to test the network connection. To disable Keepalive, set *IPPING to 0 (default setting).
Data Communication and Host Modes • *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. If you frequently pass data with your modem, you most likely do not need to have Keepalive enabled.
7: IP Manager • Understanding Domain Names • Using IP Manager with your Raven X • Understanding DNS 7 If you have a fleet of Sierra Wireless 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 modems connect to Provider. If you need to connect to a modem, or the device behind it, it is so much easier when you have a domain name (car54.mydomain.com, where are you?).
IP Manager • Dynamic IP addresses are granted only when your Raven X is connected and can change each time the modem reconnects to the network. • Static IP addresses are granted the same address every time your Raven X is connected and are not in use when your modem is not connected. Since many cellular providers, like wire‐based ISPs, do not offer static IP addresses or static address accounts cost a premium vs.
IP Manager need to be registered with ICANN or any other registry. It is the responsibility of a domain to keep track of its own subs. car54.mydomain.com • .com is the TLD • mydomain is the domain (usually noted as mydomain.com since the domain is specific to the TLD) • car54 is the subdomain or server name associated with the device, computer, or modem registered with mydomain.com car54.mydomain.com.ca This would be the same as above, but with the addition of the country code.
IP Manager Note: The fully qualified domain name of your Raven X will be a subdomain of the domain used by the IP Manager server. Using IP Manager with your Raven X To allow your Sierra Wireless AirLink modem to be addressed by name, the modem needs to have a minimum of three elements configured. You can also configure a second dynamic server as a backup, secondary, or alternate server. In AceManager, select Dynamic IP. Figure 7-1: AceManager: Dynamic IP Rev 1.0C Jul.
IP Manager • *MODEMNAME : The name you want for the modem. There are some restrictions listed below for the modem name. • *DOMAIN : The domain name to be used by the modem. This is the domain name of the server configured for *IPMANAGER1. • *IPMANAGER1 : The IP address or domain name of the dynamic DNS server which is running IP Manager. • *IPMANAGER2 : The secondary server for the domain. While it is optional to have two servers configured, it is highly recommended.
IP Manager Each update is a total of 68 bytes from the modem with a 50 byte total response from the server for a round trip update of 118 bytes. interval (minutes) total bytes per day (24 hours) 10 16992 bytes 30 5664 bytes 60 2832 bytes 500 339.84 bytes Eairlink.com As a service, Sierra Wireless maintains a IP Manager servers which can be used for any AirLink modem.
IP Manager internal to the local network or frequently changing IP addresses, the DNS servers provided by Provider should be all you need.
IP Manager The “PPP-Peer” Domain Name The Raven X uses the unqualified domain name of “ppp‐peer” when it is in PPP or SLIP address mode to resolve the address of the device or computer connected via PPP or SLIP address. If the Raven X is not in PPP or SLIP address mode, “ppp‐peer” will resolve to 0.0.0.0. Rev 1.0C Jul.
8: Configuring Modbus/BSAP • Configuring the Raven X at the Polling Host for Modbus on UDP • Configuring the Remote Raven Xs for Modbus with UDP 8 The Raven X 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.
Raven X 1x/EV-DO The RTU connects to physical equipment such as switches, pumps, and other devices and monitors and controls these devices. The RTU can be part of a network set up for Super‐ visory Control and Data Acquisition. Supervisory Control and Data Acquisition (SCADA) Supervisory Control and Data Acquisition (SCADA) describes solutions across a large variety of industries and is used in industrial and engineering applications to monitor and control distributed systems from a master location.
Configuring Modbus/BSAP matching the RTU ID. The remote Raven X then disassembles the packet before transmitting the RTU ID and serial data to the remote unit. The remote units operate in normal UDP mode and their data is sent to the host via the remote Raven X and host Raven X. Configuring the Raven X at the Polling Host for Modbus on UDP This section covers a Polling Host with standard Modbus, variations may need additional AT commands. 1.
Raven X 1x/EV-DO 2. Configure the default mode for start-up. In AceManager, select UDP in the side menu. Select the appro‐ priate MD mode from the drop down menu. Figure 8-2: AceManager: UDP - MD • MD13: Modbus ASCII • MD23 : Modbus RTU (Binary) • MD33: BSAP • MD63: Variable Modbus ‐ individual parameters are set up manually. 3. Configure IP addresses for the Modbus IDs. The last step of configuring the modem at the host is setting the IDs to their specific IPs.
Configuring Modbus/BSAP Addresses can be entered in decimal or hex. AceManager 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. When using AT commands via telnet or direct serial connection, use ATMLIST for decimal IDs and ATMLISTX for hexidecimal. For example, if the ID is 27 and the IP is 123.123.123.124, you would enter it as ATMLIST27=123.123.123.
Raven X 1x/EV-DO Figure 8-5: AceManager: DNS Configure *DNSUSER to the same IP address as the IP Manager (*IPMANAGER1). If your modems have dynamic IP addresses and not static (the IP address can change when it is powered up), configure *DNSUPDATE to a low interval to allow frequent updates. Configuring the Remote Raven Xs for Modbus with UDP This section covers standard Modbus settings for the Raven X at the remote unit, variations may need additional commands. 1.
Configuring Modbus/BSAP The destination port for the modem at the host needs to match the device port in use on all the modems at the remote sites. For example, if the remote modem’s device port (see below) is “12345”, then the Modbus host modem’s S53 destination port should be set to “12345”. Set the destination port (S53) to match the device port of the host modem (*DPORT). Make sure the device port of the remote modem (*DPORT) matches the destination port of the host modem (S53). 2.
Raven X 1x/EV-DO a. Enable S82, UDP auto answer. b. Set S83 to the idle time‐out applicable to your appli‐ cation, commonly 20. 4. Configure other RTU settings. Other parameters may need to be changed, but this is dependent on the RTU type being used. As a minimum, this typically involves setting the proper serial settings to match your RTU. 5.
Configuring Modbus/BSAP Figure 8-9: AceManager: DNS Configure *DNSUSER to the same IP address as the IP Manager (*IPMANAGER1). If your modems have dynamic IP addresses and not static (the IP address can change when it is powered up), configure *DNSUPDATE to a low interval to allow frequent updates. Rev 1.0C Jul.
Raven X 1x/EV-DO 86 20070914
9: SNMP : Simple Network Management Protocol • SNMP Configuration • SNMP MIB Definition Sample 9 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 X, 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.
SNMP : Simple Network Management Protocol SNMP Configuration To configure your Raven X to work as an SNMP agent, you can use either AceManager, or a terminal connection to configure the modem using AT commands. In AceManager, the SNMP commands are all part of the Other group under the Common group. There are only three commands to set for SNMP in the Raven X: the listening port, the security level, and the trap desti‐ nation. Figure 9-1: AceManager : Common > Other Rev 1.0C Jul.
SNMP : Simple Network Management Protocol Listening Port *SNMPPORT sets the port for the SNMP agent to listen on. If set to zero, default, SNMP is disabled. Tip: SNMP generally uses port 161, however most Internet providers (including cellular) block all ports below 1024 as a security measure. You should be able to use a higher numbered port such as 10161. Security Level *SNMPSECLVL sets the security level and which version of SNMP communications are used. • 0 ‐ No security required.
SNMP : Simple Network Management Protocol Figure 9-2: AceManager : Change 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. Figure 9-3: Change Password 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.
SNMP : Simple Network Management Protocol Community String The community string can be configured using *SNMPCOM‐ MUNITY. The default is “public”.
SNMP : Simple Network Management Protocol ::= { general 4 } aleosSWVer OBJECT-TYPE 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-AC
SNMP : Simple Network Management Protocol MAX-ACCESS read-only STATUS current ::= { common 4 } netPW OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 5 } requestPAP OBJECT-TYPE SYNTAX INTEGER { no(0), yes(1) } MAX-ACCESS read-only STATUS current ::= { common 6 } destinationAddress OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 7 } destinationPort OBJECT-TYPE SYNTAX INTEGER(0..
SNMP : Simple Network Management Protocol STATUS current ::= { status 1 } netState OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 2 } netChannel OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 3 } rssi OBJECT-TYPE SYNTAX INTEGER(-125..
SNMP : Simple Network Management Protocol 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 Display Responses The string that is displayed for these objects is the same display for the corresponding AT Command. Object Rev 1.
SNMP : Simple Network Management Protocol Object AT Command netPW *NETPW? requestPAP *HOSTPAP? destinationAddress S53 destinationPort S53 serialPortSettings S23 serialPortFlowControl \Q ipAddress *NETIP? netState *NETSTATE? netChannel *NETCHAN? rssi *NETRSSI? hostMode *HOSTMODE? powerMode *POWERMODE? PinPoint line modems only fixObtained PinPoint line modems only satelliteCount PinPoint line modems only latitude PinPoint line modems only longitude PinPoint line modems only
A: Configuration Commands • • • • • Info (information) Status Common Logging 1x/EV-DO A The configuration commands (AT commands) in this chapter are arranged according to their placement in AceManager. The commands available in AceManager will depend of the model number of your Raven X and, in some cases, the version of the ALEOS firmware installed. Note: Some commands can only be configured using a terminal emulation and typed AT commands. Some commands also require PassThru mode.
Raven X 1x/EV-DO Figure 1-1: AceManager : Info *DEVICEID? The 64‐bit device ID the modem uses to identify itself to the cellular network. *ETHMAC? The MAC address of the Ethernet port. *NETPHONE? The modemʹs phone number, if applicable or obtainable. &V View active profile, the contents of the active registers. Not displayed with AceManager. In 98 • n=0 : Product name (for example, Raven X). • n=1 : The Raven X’s firmware (ALEOS) version, hardware ID, and copyright.
Configuration Commands • n=3 : The hardware moduleʹs unique identification number or serial number (ESN). • n=5 : View active profile (the contents of the active registers). Not displayed with AceManager. Information Displayed in AceManager without AT Commands Listed • Versions of ALEOS, internal hardware, boot, and MSCI: Versions of internally configured hardware and software. Status Most of the commands in the “Status” group have read‐only parameters and provide information about the modem.
Raven X 1x/EV-DO Figure 1-2: AceManager : Status *BOARDTEMP? The temperature, in Celsius, of the internal hardware. *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. *NETCHAN? The current active 1x/CDMA channel number. *NETERR? The EVDO or CDMA network frame error rate. *NETIP? Note: If there is no current network IP address, 0.0.0.0 may be displayed.
Configuration Commands • Network Authentication Fail: Authentication to the cellular network has failed. Verify settings to activate the Raven X. • Data Connection Failed: The Raven X failed to connect, and it is now waiting a set time interval before it attempts to reconnect. Verify settings to activate the Raven X. • Network Negotiation Fail: Network connection negoti‐ ation failed. This is usually temporary and often clears up during a subsequent attempt.
Raven X 1x/EV-DO • IP Reject Count or Log: Rejected IP Data. • Temperature of the Internal Hardware Module: The temperature of the internal radio module. AT Commands Requiring PassThru mode These commands are not displayed in AceManager. +GSN ESN (Electronic Serial Number) of the internal hardware module. Common The groups under the heading Common encompass those commands that are common to most Sierra Wireless AirLink modems.
Configuration Commands A Manually answer an incoming connection. A is not used in AceManager. 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 AceManager. • method=P : Establish a UDP connection • method=T : Establish a TCP connection • method=N : Establish a Telnet connection • d.d.d.d= IP address to contact • ppppp= port to contact Examples: ATD - Dial (establish) default connection. ATDP192.168.13.
Raven X 1x/EV-DO Hn Hang‐Up Command. • n=1 : Hang‐up With an AT telnet connection, this command will terminate the host data mode and return the Raven X to an AT mode. Cannot be accessed in AceManager. O Online (Remote): Causes the Raven X to go from Command State to data state. Cannot be configured in AceManager. OPRG=n Enables/disables over‐the‐air firmware upgrading of the Raven X. When Sierra Wireless releases a new version of ALEOS, you can upgrade your remote modems with OPRG enabled.
Configuration Commands &W Writes all changed modem settings. If this command is not issued, any modified values will revert back to their previous values at modem reset. Cannot be configured in AceManager. *DATE=[mm/dd/yyyy],[hh:mm:ss] Sets and queries the internal clock. 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.
Raven X 1x/EV-DO n=3 *NETUID=uid The login that is used to login to the cellular network, when required. • 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.
Configuration Commands Figure 1-4: AceManager : Serial En Toggle AT command echo mode. • n=0 : Echo Off. • n=1 : Echo On. Note: With more than one connection types (serial and Telnet) the echo command can be set differently on each interface. 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. S3=n The standard end of line character used to indicate the end of an AT command.
Raven X 1x/EV-DO S5=n This register sets the character recognized as a backspace during command entry. Cannot be configured in AceManager. S6=n This register denotes the wait time, in seconds, before a blind dial (no dial tone detection). Cannot be configured in AceManager. S8=n Whenever a dial command contains the comma character, the contents of this register specify the pause time for each comma. Cannot be configured in AceManager.
Configuration Commands Tip: Can also be set using &L=[speed],[databits] [parity][stop bits] S50=n Data forwarding idle time‐out. If set to 0, a forwarding time‐ out of 10ms is used. Used in UDP or TCP PAD mode. • n=tenths of a second S51=n PAD data forwarding character. ASCII code of character that will cause data to be forwarded. Used in UDP or TCP PAD mode. • n=0 : No forwarding character.
Raven X 1x/EV-DO &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) (Default). • n=2 : Assert DSR when the modem has network coverage. Tip: S211 can also be used to request that DSR is always asserted. If S211 is set to 3 and &S is changed to a non-zero value, S211 will be changed to 1.
Configuration Commands Tip: Flow control (AT\Q) will override this indication, so if you want to use CTS to indicate network coverage, flow control has to be off (AT\Q0). *NUMTOIP=n Convert 12 digit number to IP. • n=0 : Use as name. • n=1 : Use as IP address. *PPPNOCARRIER=n Provides a “No Carrier” message to a device connected to the serial port using PPP or CHAP when the cellular connection becomes unavailable. • n=0 : Disabled (Default). • n=1 : Enabled.
Raven X 1x/EV-DO • n=3 : With a Telnet connection, overrides the clientʹs default echo, allowing the server on the host port to perform the echo. CRLF sequences from the telnet client will also be edited to simply pass CRs to the server on the host port. S7=n Specifies the number of seconds to wait for a TCP connection to be established when dialing out. S60=n Telnet Client Echo Mode.
Configuration Commands UDP This group includes commands specific to UDP serial commu‐ nications. Figure 1-6: AceManager : 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.
Raven X 1x/EV-DO • n=0 : Normal mode • n=2 : Enable UDP auto answer mode. S83=n Set or query UDP auto answer idle time‐out. If no data is sent or received before the time‐out occurs, the current UDP session will be terminated. While a session is active, packets from other IP addresses will be discarded (unless *UALL is set). • n=0 : No idle time‐out (Default). • n=1 ‐ 255 : Time‐out in seconds. *DU=n The dial command always uses UDP, even when using ATDT.
Configuration Commands 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-7: AceManager : DNS *DNSn=d.d.d.d Queries the DNS addresses. Your cellular carrier provides the DNS addresses while your modem is registering on their network. • n=1 or 2 : First and second DNS address. • d.d.d.d=IP address of domain server.
Raven X 1x/EV-DO Figure 1-8: AceManager : Dynamic IP *DOMAIN=name Domain (or domain zone) of which the Raven X is a part. This value is used during name resolutions if a fully qualified name is not provided and also for DNS updates. This value can be up to 20 characters long. • name=domain name (i.e. eairlink.com) If *DOMAIN=eairlink.com, then when ATDT@remote1 is entered, the fully qualified name remote1.eairlink.com will be used to perform a DNS query to resolve the name to an IP address.
Configuration Commands • n=2 : Second IP Manager server. • key=128‐bit key in hexadecimal [32 hex characters] *IPMGRUPDATEn=m Sets the number of minutes to periodically send an IP update notification to the corresponding server. This will occur even if the IP address of the Raven X doesnʹt change. *IPMGRUPDATE1 is used to set the refresh rate to *IPMANAGER1, while *IPMGRUPDATE2 is used with *IPMANAGER2. If the value is set to 0, then periodic updates will not be issued (i.e.
Raven X 1x/EV-DO Figure 1-9: AceManager : PPP/Ethernet *DHCPSERVER=n • Act as a DHCP server for any Ethernet device connecting to the Raven X. DHCP (Dynamic Host Configuration Protocol) allows one device, the DHCP server, to provide dynamic IP addresses to any other device which requests them. • n=0 : Disabled (cannot be configured in AceManager). • n=1 : Enabled. The modem will act as the primary DHCP server for the network. • n=2 : Enabled if no other DHCP server is detected (default).
Configuration Commands *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 Tip: For PPPoE, set *HOSTAUTH=1 or *HOSTAUTH=2. *HOSTNETMASK=n.n.n.n Subnet mask for the host interface. Allows communication with a subnet behind the host interface. • n.n.n.
Raven X 1x/EV-DO *HOSTPW=string Host Password for PAP, CHAP, or PPPoE. • string=password *HOSTUID=string Host User ID for PAP, CHAP, or PPPoE. • string=user id (up to 64 bytes) PassThru PassThru Mode is used to communicate directly to the Raven X 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.
Configuration Commands • n=0 : Data will be passed to the host. • n=1 : PASSTHRU mode will echo all host received data and will not pass the data to the modem while the modem is not asserting DCD. Note: If the modem is asserting DCD, data will be passed from the host to the modem as it normally is when *CSX1=0. *PTINIT=string Any AT Command string to be passed to the OEM module before entering PASSTHRU mode, e.g. AT&S1V1, etc.
Raven X 1x/EV-DO Figure 1-11: AceManager : SMTP *NETSMS2EMAIL=n Specify the SMS/E‐mail server number. This maybe necessary to send an SMS message to an email address. Cannot be used with AceManager. • n=SMS/E‐mail server number *SMTPADDR=[d.d.d.d][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). *SMTPFROM=email Sets the email address from which the SMTP message is being sent.
Configuration Commands *SMTPSTATUS? Returns the status of the last issued SMTP message (*SMTPSEND). If no status is available 0 is returned. Once read, the status is cleared out. The status codes returned come from the SMTP server to which that the modem sent the request. Unless the receiving server is not standard, they follow the RFC for SMTP. Cannot be used with AceManager.
Raven X 1x/EV-DO DAE=n AT Escape Sequence detection. • n=0 : Enable • n=1 : Disable *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). • n=0 : Disable pinging (default) • n=15‐255 minutes Note: 15 minutes is the minimum interval which can be set for Keepalive.
Configuration Commands *NETWDOG=n Network connection watchdog: The number of minutes to wait for a network connection. If no connection is established within the set number of minutes, the Raven X modem resets. • n=0 : Disabled. • n=minutes : Default = 120 min. *RESETCFG Wipe the non‐volatile data in the modem. Cannot be used with AceManager. Caution: You may need to reactivate your modem if you erase the non-volatile data.
Raven X 1x/EV-DO *SNMPTRAPDEST=host/[port] Controls destination for SNMP Trap messages. If port is 0 or host is empty, traps are disabled. Traps are sent out according to the SNMP security level (i.e. if the security level is 2, traps will be authenticated and encrypted). Currently, the only trap that can be generated is linkup. • host=IP address • port=TCP port *SNTP=n Enables daily SNTP update of the system time. • n=0 : Off • n=1 : On *SNTPADDR=[d.d.d.
Configuration Commands Firewall Firewall Mode can limit access to the Raven X from the cellular network and the Internet. Basic Firewall functions are available via AceManager. Caution: If you are using Firewall mode you will not be able to use AceManager remotely or Telnet to the modem unless you are contacting the modem from one of the configured IP addresses. Note: Firewall mode will only prevent the Raven X modem from receiving data from those IP addresses not on the Friends List.
Raven X 1x/EV-DO • n=1 : Enable Firewall mode ‐ Only packets from friends will be accepted, packets from other IP addresses are ignored. Fn=[d.d.d.d] Friends List IP address. • n=0‐9 Friends list index • d.d.d.d = IP address Using 255 in the IP address will allow any number. Example: 166.129.2.255 allows access by all IPs in the range 166.129.2.0‐166.129.2.255. Tip: ATF? will return a list of all the current Fn settings. Firewall Range You can define three different ranges of start and end.
Configuration Commands Figure 1-14: AceManager: Port Forwarding Note: There are no AT commands for Port Forwarding parameters, they need to be configured using AceManager. Number of PF Enteries = n Set value to number of used Port forward rules for perfor‐ mance gain. Each forwarding entry has four parameters. • n = 1‐5 Public Port = n Port number of the Modem/Gateway. • n = 8090 Host/IF = n Physical connection type to the modem. (USB, Ethernet). • Host IP = d.d.d.
Raven X 1x/EV-DO Logging This group includes commands specific to the internal log. Caution: Logging is intended for diagnostic purposes only. Extensive use of logging features can cause degraded modem performance. Figure 1-15: AceManager : Logging *DBGCOMMLVL=n Set the logging level for the host or module COM port. • n=0 : No logging • n=1 : Host COM Port • n=2 : Module COM Port *DBGDHCPLVL=n Enable or disable internal DHCP logging. • n=0 : No logging • n=1 : Log DHCP events.
Configuration Commands • n=2 : Log the header of all received packets. Note that this can quickly exhaust available space for the event log. • 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.
Raven X 1x/EV-DO IPL=n IP List Dial 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 MVLEN=n Modbus Variant ID Length: Length of the RTU ID in a modbus‐variant protocol, in bytes. • n=1 : This parameter is used to define the length of the RTU ID in Modbus‐like protocol data packets.
Configuration Commands • n=1 : ASCII Hex • n=2 : ASCII Decimal • n=3 : Binary Little Endian RKEY=n Enable/disable MDS Radio transceiver keying. Radio keying is designed to assert CTS when a packet is received, delay the time as specified, send the data out the serial port, wait the same amount time, drop CTS. This way, the CTS signal can be used to key a transmitter on and give it time to reach its power level before data is sent to it. Delay interval is specified in S221. • n=0 : Off (Default).
Raven X 1x/EV-DO 1x/EV-DO This group includes commands specific to 1x and EV‐DO. If you are not connecting to a modem which uses EV‐DO or 1x, you will not see this group in the menu. Figure 1-18: AceManager : 1x/EV-DO +CTA=n Inactivity timer, in seconds. Typical network settings cause a link to go dormant after 10 to 20 seconds of inactivity, no packets transmitted or received. This time can be shortened to release the physical RF link sooner when the application only transmits short bursts.
Configuration Commands Note: Your account with your cellular carrier may not support Mobile IP. ~NAMLCK=nnnnnn The NAMLCK is the modemʹs 6‐digit OTSL (One Time Subsidy Lock), MSL (Master Subsidy Lock), or SPC (Service Provisioning Code). Your cellular carrier will provide the unlock code. • nnnnnn=6 digit unlock code Caution: If the number is accepted by the modem, the OK result code is returned. If the number is rejected, the ERROR result is returned.
Raven X 1x/EV-DO A second set of modem provision parameters, when the MDN and MIN (MSID) are different or “split”. Cannot be configured in AceManager. • MSL=master lockcode • MDN/MIN=phone number • SID=system ID • NID=network ID ~NAMVAL=nam[,min,msid,sid,nid] Tip: It is recommended to use the Setup Wizard for your carrier to provision the modem. Write account activation data. Following writing the values, the modem must be reset.
B: PPP over Ethernet (PPPoE) • Configuring the Raven X for PPPoE • Configuring a PPPoE Connection in Windows • Connecting to the Internet with PPPoE B PPPoE (Point‐to‐Point Protocol over Ethernet) allows a point‐ to‐point connection while using . Just like the dial up protocol on which it is based, PPPoE uses traditional user name 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).
PPP over Ethernet (PPPoE) 1. Configure your Raven X to support PPPoE a. Connect your Raven X directly to your computer and start AceManager. b. From the groups on the left, select PPP/Ethernet under Common. Figure 2-1: AceManager : PPP/Ethernet c. Change *HOSTAUTH to 2. d. Enter a user name for *HOSTUID for the PPPoE connection. e. Enter a password for *HOSTPW for the PPPoE to connection. f.
PPP over Ethernet (PPPoE) b. Enter a name for *MODEMNAME, such as Raven X or the ESN. Figure 2-2: AceManager : Dynamic IP Tip: The name you choose will not affect the connection but may need to be configured in PPPoE settings for the router, device or computer you will be connecting to your Raven X. 3. Write the configured settings to your Raven X a. Click the Write button on the tool bar of AceManager and wait for the message “Write Successful” to appear in the status bar.
PPP over Ethernet (PPPoE) Figure 2-4: Windows : Start menu 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 2-5: Windows : Network Connections c. Click Next on the opening screen to begin creating a PPPoE connection. d. Next. Rev 1.0C Jul.
PPP over Ethernet (PPPoE) Figure 2-6: New Connection Wizard e. Select Connect to the Internet. f. Select Next. Figure 2-7: New Connection: Type g. Select Set up my connection manually. h. Select Next. Figure 2-8: New Connection: How do you want to connect? Rev 1.0C Jul.
PPP over Ethernet (PPPoE) i. Select Connect using a broadband connection. j. Select Next. Figure 2-9: New Connection : Connect using broadband k. Type in a name for the connection, such as Sierra Wireless AirLink Modem. l. Select Next. Figure 2-10: New Connection: Connection Name Tip: The name provided here will not effect the connection in any way. It is only a label for the icon.
PPP over Ethernet (PPPoE) Same *HOSTUID as configured earlier Same *HOSTPW as configured earlier Figure 2-11: New Connection: Connection Information Caution: If you have a LAN connection to the Internet and select Make this the default Internet Connection for the PPPoE configuration, you will not be able to use the LAN to connect to the Internet and may also affect the network connection on your computer to the rest of the LAN. Select this option ONLY if the Raven X will be your sole network connection.
PPP over Ethernet (PPPoE) 2. Configure the PPPoE connection After you complete the New Connection Wizard, there are a few more things you will want to configure in the connection. a. Select Properties. Figure 2-13: PPPoE Connection b. 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. Same as *MODEMNAME configured earlier Figure 2-14: PPPoE Connection : Service Name c. Select Networking. d. Select Settings. Rev 1.0C Jul.
PPP over Ethernet (PPPoE) Figure 2-15: PPPoE : Networking e. Remove the checks from all three PPP settings. f. Select OK. Figure 2-16: PPP Settings Tip: 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. Caution: Unless specifically directed to do so by Support or your network administrator, you do not need to make any changes to the options on the Security tab. g.
PPP over Ethernet (PPPoE) Connecting to the Internet with PPPoE Now the PPPoE connection can be run and a data connection can be established. a. Connect your computer and the modem to the same local network using a hub or a switch. Note: It is not recommended to connect your computer directly to the modem without a hub or switch. b. Start the PPPoE by Start > Connect To > Sierra Wireless AirLink Modem (or whatever you named the connection).
C: Windows Dial-up Networking (DUN) • Installing a modem driver for Raven X • Creating a Dial-Up Networking (PPP) Connection • Connecting to the Internet Using DUN C Dial‐up Networking (DUN) allows a computer or other device to use the serial port on your Raven X to connect to the Internet or private network using PPP just like an analog modem using a standard phone line.
Windows Dial-up Networking (DUN) Figure 3-1: Phone and Modem Options b. Select the Modems tab. Figure 3-2: Phone and Modem Options: Modems c. Rev 1.0C Jul.09 Select Add.
Windows Dial-up Networking (DUN) Figure 3-3: Add Hardware Wizard d. Check Don’t detect my modem; I will select it from a list. e. Select Next. Figure 3-4: Add Hardware Wizard: Install New Modem f. Select (Standard Modem Types) from the Manufacturers column. g. Select Standard 33600 bps Modem from the Models column. Rev 1.0C Jul.
Windows Dial-up Networking (DUN) Tip: If you have the speed for your modem configured as something other than the default, use the Standard Modem that matches the speed you configured. h. Select Next. Figure 3-5: Add Hardware Wizard: Select Ports i. Check Selected Ports. j. Select the COM port the modem is connected to (commonly COM1). k. Select Next. Figure 3-6: Add Hardware Wizard: Finish l. Rev 1.0C Jul.09 Once the modem driver is installed, select Finish.
Windows Dial-up Networking (DUN) 3. Configure the driver. When you return to the Phone and Modem Options window, you should see the newly installed modem “attached to” the correct COM port. Figure 3-7: Phone and Modem Options: Modems a. Highlight the modem and select Properties. Figure 3-8: Modem Properties Rev 1.0C Jul.
Windows Dial-up Networking (DUN) b. Select the Modem tab. Figure 3-9: Modem Properties: Modem c. Maximum Port Speed should be set to 115200 (default). d. Select OK to exit. e. Select OK again to exit out of the Phone and Modem Options. Creating a Dial-Up Networking (PPP) Connection Once you have the driver for the modem installed on your computer, you can set up and configure Dial Up Networking (DUN) to use the modem as your connection to the Internet using PPP.
Windows Dial-up Networking (DUN) Caution: If you have an existing LAN connection, installing DUN for the modem may interfere with the LAN connection. It's recommended to disconnect your LAN connection before using a PPP connection with your Raven X. Once the DUN connection is initiated, by default, it will take over as the “default route” for network communication and specifically for Internet access.
Windows Dial-up Networking (DUN) b. Select Create a New Connection under Network Tasks in the menu area on the left. Figure 3-11: Create New Connection c. Select Next to start installing and configuring the DUN connection. Figure 3-12: New Connection Wizard d. Select Connect to the Internet. e. Select Next. Rev 1.0C Jul.
Windows Dial-up Networking (DUN) Figure 3-13: New Connection: Type f. Select Set up my connection manually. g. Select Next. Figure 3-14: New Connection: How do you want to connect? h. Select Connect using a dial‐up modem. i. Select Next. Figure 3-15: New Connection: Connect using... j. Optional: If you have multiple modems installed on your computer, you may be prompted to select the modem to be used. If you only have one modem installed, this option will be omitted. k.
Windows Dial-up Networking (DUN) Figure 3-16: New Connection: Select Modem m. Type in a name for the connection, such as Sierra Wireless AirLink Modem. n. Select Next. Figure 3-17: New Connection: Connection Name Tip: 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 (Provider), your modem (Raven X), or any other designation for the connection. o.
Windows Dial-up Networking (DUN) Figure 3-19: New Connection: Permissions Generally the modem takes care of the Account Information, User name and Password, for the connection, so you can leave the fields blank (unless otherwise instructed by Support). s. If you want to allow others to use the same login for the modem, select Use this account name and password.... t. Select Next.
Windows Dial-up Networking (DUN) Figure 3-21: New Connection: Finish 2. Configure the DUN connection After you complete the New Connection Wizard, there are a few more things you will want to configure in the connection. a. Select Properties. Figure 3-22: DUN Connection b. Uncheck Use dialing rules. Rev 1.0C Jul.
Windows Dial-up Networking (DUN) c. Check Show icon...when connected. d. Select Configure, below the Connect using line. Figure 3-23: DUN Properties e. Select 115200 as the Maximum speed. f. Check Enable hardware flow control. g. Do not check any other option. h. Select OK. Rev 1.0C Jul.
Windows Dial-up Networking (DUN) Figure 3-24: Modem Configuration i. Back at the main properties screen, select the Networking tab. Figure 3-25: Networking j. Select Settings. k. Remove the checks from all three PPP settings. l. Rev 1.0C Jul.09 Select OK.
Windows Dial-up Networking (DUN) Figure 3-26: PPP Settings m. Select (highlight) Internet Protocol (TCP/IP) and then select Properties. Tip: For most configurations, you will be obtaining the IP address and the DNS server address automatically. n. Select Advanced. Figure 3-27: TCP/IP Properties o. Uncheck Use IP header compression. p. Check Use default gateway on remote network. q. Select OK. Rev 1.0C Jul.
Windows Dial-up Networking (DUN) Figure 3-28: Advanced TCP/IP Tip: 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. Caution: Unless specifically directed to do so by Support or your network administrator, you do not need to make any changes to the options on the Security tab. r. Select OK until you return to the Connect window.
Windows Dial-up Networking (DUN) 2. Enable the Connection. Figure 3-29: AceView: Menu a. Right‐click on the AceView window to open the menu. b. Select Connection Settings. Figure 3-30: AceView: Connection Settings c. Select Auto Start in the DUN section. d. Select Maintain Persistent Connection. When checked, AceView will continually check the DUN connection to ensure it is not down. If so, AceView will attempt to connect again.
Windows Dial-up Networking (DUN) 1. Start the DUN session. Start > Connect To > Prosoft Technology RadioLinx Modem If you named the connection differently, use the name of the PPP connection you made earlier. Figure 3-31: DUN Connection Tip: Generally you will not need to enter a Username or Password. If you do need to enter either, you can enter these parameters beforehand using *NETUID and *NETPW. 2. Select Dial to connect to the modem and the cellular network.
Windows Dial-up Networking (DUN) Caution: For DUN connections on a Windows Mobility or other nonpersonal computer, the DNS settings may not be configured with the DUN connection. You may need to go into the network settings and add DNS servers manually. Rev 1.0C Jul.
