Raven-E 1x for Alltel User Guide 20070914 Rev 3.0B...
Page 2
POWERED OFF. When operating, the Sierra Wireless AirLink Raven‐E can transmit signals that could interfere with various onboard systems. Note: Some airlines may permit the use of cellular phones while the aircraft is on the ground and the door is open. Sierra Wireless AirLink Raven-E may be used at this time. The driver or operator of any vehicle should not operate the Sierra Wireless AirLink Raven‐E while in control of a vehicle. Doing so will detract from the driver or operatorʹs control and operation of that vehicle. In some states and provinces, ...
Page 3
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. Notwithstanding the foregoing, in no event shall Sierra Wireless and/or its affiliates aggregate liability arising under or in connection with the Sierra Wireless product, regardless of the number of events, occurrences, or claims giving rise to liability, be in excess of the price paid by the purchaser for the Sierra Wireless product. Patents Portions of this product may be covered by some or all of the following US patents: 5,515,013 5,629,960 5,845,216 5,847,553 5,878,234 5,890,057 5,929,815 6,169,884 6,191,741 6,199,168 6,339,405 6,359,591 6,400,336 6,516,204 6,561,851 6,643,501 6,653,979 6,697,030 6,785,830 6,845,249 6,847,830 6,876,697 6,879,585 6,886,049...
Monday to Friday, except US Holidays support@sierrawireless.com E-mail: Sales Desk: Phone: 1-510-781-4200 1-604-232-1488 Hours: 8:00 to 5:00 Pacific Time MobileandM2Msales@sierrawireless.com E-mail: Post: Sierra Wireless America 3159 Corporate Place Hayward, CA 94545 Sierra Wireless 13811 Wireless Way Richmond, BC Canada V6V 3A4 Fax: 1-510-781-4299 1-604-231-1109 www.sierrawireless.com...
Q2: 2005-Q2: AirLink Communications documentation - CDMA, EV-DO, EDGE, and 2007 HSDPA. in draft 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 3.0B Feb.08...
Page 6
Contents Introduction to the Raven-E ......... . .1 ALEOS™...
Page 7
Contents Configuring your Raven-E ......... . .31 Using AceManager .
Page 8
Contents SNMP Configuration ............59 Listening Port .
Page 9
Contents D[method][d.d.d.d][/ppppp] or D[method][@name][/ppppp] ......74 DS=n ................74 Hn.
• AceWare™ • Connecting to the The Raven‐E is an intelligent wireless gateway, powered by Alltel Network ALEOS™, and optimal for providing primary or backup • 1x Communication network connectivity for any high‐reliability/ high‐availability applications. The Raven‐E is the perfect solution for any device with an Ethernet connection that requires pervasive connectivity including PCs, routers, network equipment and POS/ATMs as well as commercial automation equipment. Figure 1-1: Sierra Wireless AirLink Raven-E ALEOS™ ALEOS, the embedded core technology of the Sierra Wireless AirLink products simplifies installation, operation and mainte‐ nance of any solution, and provides an always‐on, always‐ aware intelligent connection for mission‐critical applications. ALEOS enables: • Persistent Network Connectivity • Over‐The‐Air (OTA) Upgrades • Wireless Optimized TCP/IP • Real‐Time Notification •...
Introduction to the Raven-E 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 • Setup Wizard • Modem Doctor These modem utilities, except AceNet, are free of charge to those who own Sierra Wireless AirLink modems. You can download the applications and their user guides from the Sierra Wireless AirLink Solutions web site: http:// www.sierrawireless.com/support. Contact your dealer or Sierra Wireless representative for information on AceNet. Note: AceView, AceManager, and AceNet require the Microsoft .NET Framework v.
Introduction to the Raven-E Figure 1-3: AceManager Simplified Deployment AceManger 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. Monitor and Control AceManger allows an administrator to remotely monitor a modem’s status, health and configuration settings. The user interface displays signal strength, cell site information, byte counters and error conditions, enabling you to pinpoint any issues and troubleshoot immediately. AceManager enables remote configuration and parameter settings to be changed or reset instantly over the air, change a device’s port configuration, IP address settings, and much more. After configuring one modem, use the template feature to copy that device configuration to other modems. Tip: Configuration steps and examples in this guide use AceManager. Rev 3.0B Feb.08...
Introduction to the Raven-E AceNet AceNet, the enterprise grade productivity enhancing tool, enables you to efficiently deploy and monitor Sierra Wireless AirLink products on a large scale. 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 AceManger. To ensure your implementation is optimal, users can easily see when modems are out of contact and periodically poll each device for performance statistics. AceView AceView is an efficient status and connection monitoring application with a low‐profile, easy to read interface. Figure 1-5: AceView Rev 3.0B Feb.08...
Introduction to the Raven-E Setup Wizard A quick and easy way to activate and configure your Raven‐E to connect to the Alltel cellular network is by using the AceWare Setup Wizard. Modem Doctor Modem Doctor is a troubleshooting and diagnostics utility. This utility will allow you to get a log file of the Raven‐E activity which you can then send to Sierra Wireless support, erase the current configuration completely. Rev 3.0B Feb.08...
Introduction to the Raven-E Figure 1-6: Modem Doctor Modem Doctor USB Open the ModemDoctorUSB.exe. 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”.
Introduction to the Raven-E Figure 1-7: Modem Doctor: USB connection Connecting to the Alltel Network The Raven‐E uses Alltel as an ISP (Internet Service Provider) to connect you to the Internet. Steps of a connection: When your Raven‐E is powered on, it automatically searches for cellular service using 1x. Your Raven‐E establishes a PPP (Point to Point Protocol or “dial” up connection) link to the Alltel network, also called registering on the network, and receives an IP address. When your Raven‐E has received its IP address from Alltel, a connection to the Internet or the cellular network is also available for a computer or other device connected directly to the Raven‐E. Figure 1-8: Connecting to the Internet Rev 3.0B Feb.08...
Introduction to the Raven-E The Raven‐E 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‐E will provide a connection for one device to the Internet at a time. In Private Mode, the Raven‐E will provide NAT (Network Address Translation) for the computer or other end device. Note: The Raven-E does not provide advanced routing required by one-to-many (several devices connected to one port). If you need to have more than one device connected to the Internet through your Raven-E, you will need to have a router connected to the modem.
Introduction to the Raven-E Caution: If you want to connect remotely to your Raven-E using TCP/IP, the IP address given to your modem by Alltel cannot be a private or internal IP address (such asspecial private network) unless you are on the same network or inside that network’s firewall (such as with frame relay).
3: Activating your Raven-E on the Alltel Network • Setup Wizard • Activating Using AT This chapter provides step‐by‐step directions for activating Commands your Raven‐E on the Alltel cellular network. Setup Wizard You can find the Setup Wizard installation on the CD which came with your Raven‐E or on the Sierra Wireless website: http://www.sierrawireless.com/support/AirLink/ default.aspx.Use only the Setup Wizard for Alltel for best results. Note: The Setup Wizard requires the Microsoft .NET 1. Starting the Setup Wizard framework v. 1.1 and Microsoft Windows 98, Windows 2000, Connect the Raven‐E to your computer using an ...
Page 24
Raven-E 1x Figure 3-1: Setup Wizard Click Next to start the Wizard process. 2. Connecting to the Modem If you connected your Raven‐E to the port on your computer, sSelect Connected to an Ethernet/USB Port and use the drop down menu to select the Ethernet adapter or USB/net connec‐ tionon your computer to which the modem is connected (most computers only have one adapter which will be selected for you). The default password for the modem is entered for you. Click Next. Note: If you want to use USB with the Setup Wizard you will need to first install the driver, refer to Installing the USB driver section in this Chapter.
Page 25
Activating your Raven-E on the Alltel Network Figure 3-2: Setup Wizard : Ethernet Connection Figure 3-3: Ethernet Port Tip: If the Setup Wizard is unable to detect the Raven-E, check the green link LED on the Ethernet port of the modem to see if it is lit to indicate an Ethernet connection with your computer.
Page 26
Note: While checking for ALEOS Firmware updates, the Setup Wizard uses the Internet connection on your computer to connect to the Sierra Wireless server. Your Raven-E is not connected to the wireless network for this process. If you need to remove the Ethernet...
Page 27
Activating your Raven-E on the Alltel Network cable from your modem to connect to your usual Internet connection to Check for Updates, be sure to reconnect the Product Name before you select Update Now. Figure 3-6: ALEOS Update Tip: You can download current ALEOS firmware from the Sierra Wireless web site and install it separately.
Page 28
Raven-E 1x Figure 3-7: Setup Wizard MDN and MIN/MSID • Static IP ‐ If you have a cellular account with a static IP address, check this box if it is displayed. Caution: If you do not have a static IP account and check the Static IP box, you may not be able to activate your Raven-E or register on the Alltel network.
Page 29
Activating your Raven-E on the Alltel Network Figure 3-9: Setup Wizard : Signal Test Tip: 6. Test Modem Setup Your connection of your Raven‐E to the Internet is tested using the Alltel cellular network. Figure 3-10: Setup Wizard: Connection Test Green checks in the boxes indicate the tests were successful and your Raven‐E is functioning properly. At this point your modem is configured and activated to work on the Alltel network. Note: These tests, depending on the strength of your signal, may take a few minutes.
Page 30
Raven-E 1x If Test Modem Settings shows the status of your modem is “Data Connection Failed ‐ Waiting for Retry”, “No Service”, “No Carrier”, “Network Negotiation Failed”, “Network Authentication Failed”, “Modem Not Registered”, or the Reg Net light on the modem is not lit, double‐check your device activation information and return to the Activate Modem step to reconfigure your Raven‐E. 7. Setup Private Networking (C3x10) 8. Data Link Configuration Private Networking Data Link is a special account configu‐ Note: These screens will only be ration that provides a more secure connection for your Raven‐ displayed if Private Networking E and often provides a static IP with authentication on an Data Link is selected. exclusive server. Consult your Alltel representative for details about Private Networking Data Link if it’s something you need for your account. Before you start the configuration for Private Networking, Data Link, the connection to the network may be checked. Caution: Ensure the Raven-E has been activated before you proceed with the Private Networking Data Link steps.
Page 31
Activating your Raven-E on the Alltel Network Figure 3-12: Setup Wizard : Primary and Secondardy HA • HA SPI and AAA SPI, required for authentication on the Primary and Secondary Home Agents, is provided by Alltel. Figure 3-13: Setup Wizard : SPI • HA Shared Secret Password is used for both Home Agent’s. This may be filled in for you with a password created for your Raven‐E for the Alltel network. Rev 3.0B Feb.08...
Raven-E 1x • The AAA/Vision Password is required by the Authenti‐ cation, Authorization and Accounting server. This may be filled in for you with default for Alltel. Figure 3-14: Setup Wizard : Passwords When the Private Networking Data Link configuration is completed, the connection to the network will be tested again. Activating Using AT Commands An alternate method to configure and activate your Raven‐E is by using AT commands sent directly to the modem with a terminal application (refer to the troubleshooting section). This method is recommended only in situations where the Setup Wizard is not available and/or when the configuration for the Raven‐E is unusual. Caution: It is not possible to activate the Raven-E using either AceManager or AceNet. Set telnet timeout in to 20 minutes. AT*TELNETTIMEOUT=20 Save the telnet setting.
Page 33
Activating your Raven-E on the Alltel Network Enter the activation command appropriate for your type of account. The SID and NID are optional and only required if your account type uses them. · If you have the same number for the MIN and MDN or MSID: AT*PROVISION=MSL,MDN[,SID,NID] · If you have the different numbers for the MIN and MDN or MSID: AT*PROVISION2=MSL,MDN,MIN/MSID[,SID,NID] Rev 3.0B Feb.08...
4: Hardware Installation of the Raven-E • Connecting to Power • Connecting to a Your Raven‐E should be mounted in a position that allows Computer or other easy access for the cables so they are not bent, constricted, in Device close proximity to high amperage, or exposed to extreme • Indicator Lights temperatures. The LEDs on the front panel should be visible for ease of operational verification. You should ensure that • Mounting there is adequate airflow around the modem but that it is kept free from direct exposure to the elements, such as sun, rain, dust, etc. In a mobile location, such as a car or truck, ensure the location is secure both against abrupt movements of the vehicle and from other items coming into contact with the modem. Caution: The Raven-E is in a hardened case and designed for use in industrial and extreme environments.
The DC power cable positive lead should be connected to the Note: When using a DC power battery or power source positive terminal. The power cable source (such as a car battery or negative lead should be connected to the battery or power solar cell), Sierra Wireless source negative terminal. recommends placing a fuse (1-2 Amp) on the line close to the power source to protect your power source from possible surges due to shorts or other line issues.
Hardware Installation of the Raven-E Connecting to a Computer or other Device Figure 4-2: Ethernet The Ethernet port of your Raven‐E 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‐E is auto‐sensing and connects at 10baseT. If you are connecting the modem to a hub or switch you should use a straight through cable or use the uplink port on the hub or switch with a cross‐over cable. Tip: On some computers, the TCP receive window may be set to 16 kbytes. To optimize the throughput of your Raven-E, it is recom- mended that you change the TCP window to 128 kbytes to 256 kbytes using a TCP Optimizer.
Hardware Installation of the Raven-E • RSSI (signal level) ‐ 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. RSSI LED Ranges RSSI/Signal LED Status Ranges of RSSI (dBm) On Solid Equal to or stronger than -69 Fast Blink -70 to -79 Normal blink -80 to -89 Slow Blink -90 to -99 Extinguished Equal to or weaker than -100 •...
Page 39
Hardware Installation of the Raven-E Figure 4-4: Optional Mounting Bracket Rev 3.0B Feb.08...
Page 40
Hardware Installation of the Raven-E Figure 4-5: 100-170-1009 : Mounting Bracket for Raven-E Rev 3.0B Feb.08...
Page 41
Hardware Installation of the Raven-E Figure 4-6: 100-170-1006 : Mounting Bracket for Raven-E Rev 3.0B Feb.08...
5: Configuring your Raven-E • Using AceManager • Using Templates With ALEOS as its “brain”, the Raven‐E is a highly configu‐ • Using a Terminal rable device, more than just a “dumb” modem. Application with AT To configure your Raven‐E, you have two options. You can use Commands the configuration and management applications of the AceWare suite or you can use a terminal emulator application such as HyperTerminal, PuTTY, or many others. Since the AceWare applications are designed for ease of use, nearly all descriptions and screen shots of Raven‐E configu‐ ration in this guide and Application Notes are done with AceManager. In addition to the various chapters in this guide giving information and directions about using the features of your Raven‐E, the Configuration Commands appendix briefly describes all the commands available. To get a more expanded view of the other AceManager features, refer to the AceManager Guide. A full listing of all the configuration commands for you modem are in Appendix A. Using AceManager AceManager is a free utility and is available on the product CD or can be downloaded from the Sierra Wireless America website:http://www.sierrawireless.com/support/AirLink/ default.aspx.
Page 43
Configuring your Raven-E Figure 5-1: AceManager 2. Connect to your Raven-E Click the Connect button. Figure 5-2: AceManager : Connect to Modem 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. Enter the connection information. · For UDP or TCP, if you are connecting locally, use the *HOSTPEERIP of the modem to connect. The default for the *HOSTPEERIP is 192.168.13.31. · For SMS, enter the phone number of the modem and select your wireless carrier. · For PPP, select the COM port to which the modem is ...
Page 44
Configuring your Raven-E Select OK. Figure 5-3: AceManager : Connected 3. Enter the configuration options On the left side of AceManager is the Groups menu. Select the appropriate group as needed or directed. Enter your changes in the New Value column by typing in the desired change or using the drop down menus. The current configuration is shown in the Value column. Figure 5-4: AceManager : Changing values Rev 3.0B Feb.08...
Configuring your Raven-E 4. Write the changes to the modem Click the Write button on the tool bar of AceManager. 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.
Page 46
Configuring your Raven-E 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. ·...
Page 47
Configuring your Raven-E 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. Load the template. Connect to the modem you want to configure using AceManager. Click on the Load button on the toolbar. Figure 5-8: AceManager : Load Select the template you have saved (you may need to change folders if you saved it to a different location). Verify the configuration settings. Tip: After you load the template, it’s best to go back over the AceManager groups to make sure all the settings are what you require.
Page 48
Configuring your Raven-E 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-E. Settings not applicable to the modem on which you are loading the template, will be discarded.
Page 49
Configuring your Raven-E 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. Select the Modem option in the tool bar and then select Apply AceManager Template. Figure 5-11: AceNet : Modem menu 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). Figure 5-12: AceNet : Template select Set the Retry Interval and check if you want to have ...
Configuring your Raven-E Using a Terminal Application with AT Commands You can access and configure your Raven‐E 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. Start > All Programs > Accessories > Communications > HyperTer‐ minal Figure 5-13: HyperTerminal 1. Choose a name and icon for your connection. Choose a name for your connection, such as Raven‐E 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.
Page 51
Configuring your Raven-E 2. Connect To Select TCP/IP (Winsock) for “Connect Using”. Type in 192.169.13.31 for Host Address. Change the “Port Number” to 2332. Select OK. 3. Connected Figure 5-14: HyperTerminal : TCP/IP connected If you are prompted for a password, enter 12345. Rev 3.0B Feb.08...
Configuring your Raven-E 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. 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. AT Commands When using a terminal application, you will need to manually type in each command. • For most commands, when you are entering them using a terminal connection, you will need to preface the command with AT (exceptions are noted), i.e. ATA which is listed as A. • Some commands have specific parameters while other commands will take whatever you type. • Required variable parameters are denoted with italicized text, example, Dn. The n is variable. • Acceptable parameters and/or specific formats are listed with each command. • 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). • Optional parameters are denoted with square brackets [ ]. • AT Commands are not case sensitive. A capital “E” is the same as a lower‐case “e”. • When you are using a terminal connection, if you enter a command which is recognized by the Raven‐E, it will ...
6: Data Communication and Host Modes • Basic Modes • Data Communication The Raven‐E 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-E 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. Tip: If you need to have one-to-many routing, you can connect the Raven-E to a router.
Data Communication and Host Modes Basic Modes AT Mode Using a terminal connection, AT commands are used to configure the modem, command it to do something, or query a setting. For a full listing of the AT commands, refer to the appendix. AceManager is a graphical user interface for most AT Commands. • AT commands must always be terminated by <CR> (ASCII character 0x0D), a carriage return (pressing enter on the keyboard). Some may also include a new line or line feed <LF>. • If E=1 (Echo On), the AT command (including the termi‐ nating <carriage return) will be displayed (output) before any responses. • Two settings affect the format of AT command output: V (Verbose) and Q (Quiet). • 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 sur‐ rounded by a carriage return and new line. Any AT query response is also surrounded by a carriage return and new line. For V=0 (Terse mode), a numeric result code is output with a single trailing carriage return (no new line is output), while any AT query response is followed by a ...
Data Communication and Host Modes PassThru Mode In PassThru mode, the Raven‐E does not behave normally, all port communication is passed directly between the internal hardware and the computer connected directly to the modem. This mode can be used to configure hardware‐specific settings. For example, provisioning, troubleshooting, communicating with legacy equipment, etc. Caution: ALEOS is disabled in PassThru Mode. You cannot use most ALEOS specific commands while the modem is in PassThru Mode. While in PassThru mode, you also cannot use AceManager to connect with the PinPoint.
Data Communication and Host Modes Telnet Mode In AceManager you can configure Telnet operation. Figure 6-2: 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-3: AceManager : Other - *TPORT, *TELNETTIMEOUT. UDP and UDP Pad TCP and TCP Pad Hybrid Modes AT Command Hybrid Mod Hybrid Mode2 (MD5) (MD6)
Tip: When using Public mode, Sierra Wireless recommends connecting the modem directly to the computer or other end device. Using a hub or switch may prevent the Raven-E from updating the IP address of the end device when an IP address is received from the cellular network.
Data Communication and Host Modes Figure 6-4: AceManager : PPP/Ethernet • *HOSTPRIVMODE ‐ Set to 1 to enable the explicit IP addresses. • *HOSTPRIVIP ‐ Set to the IP address you want the Raven‐ E to give to your device. • *HOSTPEERIP ‐ Set to the IP address you want for the Raven‐E. • *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.
Data Communication and Host Modes When the Raven‐E registers on the cellular network, it is assigned an IP address from Alltel, let’s say A.B.C.D. Acting as a DHCP server, in Public Mode, when the Raven‐E receives a DHCP request from an Ethernet device, it hands off the assigned address to the device and sets up the default gateway address as A.B.C.1. If the fourth octet is already a 1, it assigns A.B.C.2 as the router address. The Raven‐E also sends a /24 netmask (255.255.255.0 by default) and sets up a static route which maps 192.168.13.31 (or the address configured with *HOSTPEERIP if it is changed) to A.B.C.1 (or A.B.C.2 if that was what the gateway address was given as). Tip: When PPPoE is used with the Raven-E, DHCP is not needed. A tunnel is set up connecting a device (such as your computer or a router) with the modem.
Data Communication and Host Modes Figure 6-5: 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). Note: 15 minutes is the minimum time which can be set for Keepalive. If you set *IPPING for a value less than the minimum, the minimum value will be set.
7: IP Manager • Understanding Domain Names • Using IP Manager with If you have a fleet of Sierra Wireless AirLink modems or even your Raven-E if you only have one, it can be difficult to keep track of the • Understanding DNS 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?). Reasons to contact the modem and/or the connected device: • Requesting a location update from a delivery truck. • Contacting a surveillance camera to download logs or survey a specific area. • An oil derek that needs to be triggered to begin pumping. •...
IP Manager • Dynamic IP addresses are granted only when your Raven‐ E 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‐E 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. dynamic accounts, Sierra Wireless AirLink Solutions developed IP Manager to work with a Dynamic DNS server to receive notification from Sierra Wireless AirLink modems to translate the modem’s dynamic IP address to a fully qualified domain name. Thus, you can contact your Raven‐E directly from the Internet using a domain name. Understanding Domain Names 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. While contacting you at your house address or with your phone number employ different methods, using a domain name instead of the IP address actually uses the same method, just a word based name is commonly easier to remember for most people than a string of numbers. Understanding the parts of a domain name can help to under‐ stand how IP Manager works and what you need to be able to configure the modem. A fully qualified domain name (FQDN) generally has several parts. • Top Level Domain (TLD): The TLD is the ending suffix for a domain name (.com, .net, .org, etc.) • Country Code Top Level Domain (ccTLD): This suffix is often used after the TLD for most countries except the US ...
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. In this example, the country code (.ca) is for Canada. Tip: A URL (Universal Resource Locator) is different from a domain name in that it also indicates information on the protocol used by a web browser to contact that address, such as http:// www.sierrawireless.com.
IP Manager Note: The fully qualified domain name of your Raven-E will be a subdomain of the domain used by the IP Manager server. Using IP Manager with your Raven-E 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 •...
IP Manager the IP address changes (example, if your Raven‐E is reset or is assigned a different IP address). • *IPMGRKEY1 and *IPMGRKEY2: User defined password key which is used instead of AirLink secret key when using an IP Manager server other than the one provided by Sierra Wireless. Restrictions for Modem Name For the Modem Name, you should use something which is unique but also easy to remember. Your company name or the intended function of the modem are recommended. If you have more than one modem and want to name them the same, you can append a number for each. Since it is an Internet domain name, there are some restrictions for the name. • Must begin with a letter or number • Can include a hyphen (‐) • Cannot contain spaces • Must be no longer than 20 characters total Data Usage for IP Manager Server Updates The IP Manager update is a small packet sent to the server with a response sent back to the modem. If you have *IPMGRUPDATE1 or *IPMGRUPDATE2 set to any number but zero, the modem will send the update not only when it receives a new IP address but at the time interval as well. The data traffic could be billed by your carrier. Each update is a total of 68 bytes from the modem with a 50 ...
24/7. Tip: When using the IP Manager service offered by Sierra Wireless, since there are many modems using the service, it is even more imperative to have a unique name for your modem.
IP Manager Figure 7-2: AceManager: DNS *DNS1 and *DNS2 ‐ The primary and secondary DNS • servers set by Provider when your Raven‐E gets its IP address. • *DNSUSER ‐ Set this, if desired, to an additional DNS server to query first before the primary or secondary (just as a hosts file is queried first on a computer). If *DNSUSER is set to 0.0.0.0, it will be ignored. • *DNSUPDATE ‐ This command sets how often you want DNS Updates to be requested. Otherwise the Raven‐E will only send updates when it is reset, powered up, or the IP address is granted by network changes. The “PPP-Peer” Domain Name The Raven‐E 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‐E is not in PPP or SLIP address mode, “ppp‐peer” will resolve to 0.0.0.0. Rev 3.0B Feb.08...
8: SNMP : Simple Network Management Protocol • SNMP Configuration • SNMP MIB Definition The Simple Network Management Protocol (SNMP) was Sample 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‐E, 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. Using the management information base (MIB), an NMS can include reporting, network topology mapping, tools to allow traffic monitoring and trend analysis, and device monitoring. Authentication ensures SNMP messages coming from the agent, such as the Raven‐E, have not been modified and the agent may not be queried by unauthorized users. SNMPv3 uses a User‐Based Security Model (USM) to authenticate and, if desired or supported, message encryption. USM uses a user name and password specific to each device. The Raven‐E can be configured as an SNMP agent and supports SNMPv2c and SNMPv3. Management Information Base (MIB) The management information base (MIB) is a type of database used to compile the information from the various SNMP agents. Reports from various agents, such as the Raven‐E, are ...
SNMP : Simple Network Management Protocol SNMP Configuration To configure your Raven‐E 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‐ E: the listening port, the security level, and the trap desti‐ nation. Figure 8-1: AceManager : Common > Other Listening Port sets the port for the SNMP agent to listen on. If set *SNMPPORT 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.
SNMP : Simple Network Management Protocol User Name and Password The user name is ʹuserʹ. The user name cannot be changed. The Raven‐Eʹs password is used as the SNMP password (default is ʹ12345ʹ). Tip: The eight-character password requirement for SMNPv3 is not enforced by the PinPoint X Agent to allow the default password to function. Your SNMP administrator or MIS may require you to change to a more secure and/or longer password.
SNMP : Simple Network Management Protocol Trap Destination *SNMPTRAPDEST needs to be set with the destination IP and port. If either are set to zero or empty, SNMP traps are disabled. Note: 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 supported is LinkUp. Community String The community string can be configured using *SNMPCOM‐...
Page 73
SNMP : Simple Network Management Protocol electronicID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 3 } modemType OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 4 } aleosSWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 5 } aleosHWVer OBJECT-TYPE SYNTAX DisplayString...
Page 74
SNMP : Simple Network Management Protocol STATUS current ::= { common 2 } devicePort OBJECT-TYPE SYNTAX INTEGER(0..65535) MAX-ACCESS read-only STATUS current ::= { common 3 } netUID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 4 } netPW OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current...
Page 75
SNMP : Simple Network Management Protocol 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 STATUS current ::= { status 2 } netChannel OBJECT-TYPE...
A: Configuration Commands • Info (information) • Status • Common The configuration commands (AT commands) in this chapter • Logging are arranged according to their placement in AceManager. • 1x/EV-DO The commands available in AceManager will depend of the model number of your Raven‐E 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. Tip: You can use a fully qualified domain name instead of an IP address for most configuration options calling for an IP address if your Raven-E is configured to use DNS.
Raven-E 1x 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. • n=0 : Product name (for example, Raven‐E). • n=1 : The Raven‐E’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 identification number or serial number (ESN). • n=5 : View active profile (the contents of the active registers). Not displayed with AceManager. 20070914...
Configuration Commands 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. The Status Group has more fields that can be displayed on most screens. You can either resize your window or use the scroll bar on the side to display the remainder. Figure 1-2: AceManager : Status *HOSTMODE? The current host mode (AT, PPP, UDP, etc.). If the Raven‐E 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. Rev 3.0B Feb.08...
Raven-E 1x *NETIP? The current IP address of the modem reported by the internal Note: If there is no current module, generally obtained from Alltel. This is the address can network IP address, 0.0.0.0 may contact the Raven‐E from the Internet. be displayed. Tip: Use *NETALLOWZEROIP if you need to allow the display of an IP ending in a zero. *NETOP? The current cellular carrier from the modemʹs firmware version, for example, Alltel. *NETRSSI? The current RSSI (Receive Signal Strength Indicator) of the ...
Configuration Commands • Hardware Reset: The internal module is being reset. This is a temporary state. *PRLSTATUS? The status of the most recent PRL Update. • 0 : None • 1 : In Progress • 2 : Success • Any other value : Failure +HWTEMP? Displays the internal temperature of the radio module in degrees Centigrade. +PRL? Preferred Roaming List (PRL) version. Information Displayed in AceManager without AT Commands Listed • Bytes and Packets Received and Sent: Network traffic for the applicable port. • Number of System Resets: Counter of the number of system resets over the life of the modem or since the configuration was reset. • Bad Password Count: Counter of the number of bad password attempts. • IP Reject Count or Log: Rejected IP Data. •...
Raven-E 1x +CMIP Mobile Station IP Address. +CSQ Received Signal Strength and Channel Frame Error Rate. +CSSN? Serving System. +ECIO? Indicates the signal‐to‐noise ratio, essentially the quality of the signal. +GSN ESN (Electronic Serial Number) of the internal hardware module. +WHWV Serial number of the module. +WPRL? Preferred Roaming List (PRL) version. +WSSW Software version of the internal hardware module. !RSSI Received Signal Strength Indicator. C3x10 or C3x10E. !STATUS Displays the current modem status. C3x10 or C3x10E. Format of response: • Current band: <band> • Current channel: <chan> • SID:<sid> NID:<nid> Roaming:<n> • Temp:<temp> • Pilot [NOT] acquired • Modem has [NOT] registered Common 20070914...
Configuration Commands The groups under the heading Common encompass those commands that are common to most Sierra Wireless AirLink modems. Misc (Miscellaneous) The commands of the “Misc” group are a variety of commands that don’t directly fit in other categories. Figure 1-3: AceManager : Misc AT Escape sequence. If the Raven‐E is in a data mode (any Note: +++ is not proceeded by mode other than PassThru), this command causes the modem AT nor does it require a carriage to re‐enter AT command mode. The “+” is ASCII 0x2B. return (enter). There must be an +++ is idle time (set by S50) on the not available in AceManager.
Raven-E 1x 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.31/2332 - Dial (establish) UDP session to 192.168.13.31, at port 2332. To end the connection, issue the +++ escape sequence or drop the DTR line (if Ignore DTR S211=0 or &D2). The default connection is set in S53. If the method, IP address, or port is omitted, the values from S53 are used. If a telnet connection is requested (N) and the ...
Configuration Commands With an AT telnet connection, this command will terminate the host data mode and return the Raven‐E to an AT mode. Cannot be accessed in AceManager. Online (Remote): Causes the Raven 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‐E. When Sierra Wireless releases a new version of ALEOS, you can upgrade your remote modems with OPRG enabled. • n=0 : Disables • n=1 : Enables S53=[method][d.d.d.d][/ppppp] Destination IP address, port, and method. These are used as defaults for the D (Dial) AT command. • method= P : UDP • method=T : TCP • method=N : Telnet • d.d.d.d=IP address or domain name • ppppp=the port address 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. Command Response Mode. • n=0 : Terse (numeric) command responses •...
Raven-E 1x Tip: *DATZ=1 will disable Z. &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. +CICB=n Mode for answering data with the A (answer) or via auto answer (S0=1). Cannot be configured in AceManager. C3x11 or C3x11E only. • n=0 : Data • n=1 : Speech • n=2 : Data once (10 minute timeout). *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. • mm/dd/yyyy=date in month/day/year notation • hh:mm:ss=time in 24‐hour notation *DPORT=n The modemʹs Device Port which the modem is listening on for inbound packets/data/polls. Can also be set with the command S110. • n=1‐65535 *HOSTPAP=n Use PAP to request the user login and password during PPP negotiation on the host connection. • n=0 : Disable PAP request (Default). ...
Configuration Commands *NETPW=pw The password that is used to login to the cellular network, when required. • pw=password (30 characters maximum) *NETPHONE? The modem’s phone number, if applicable or obtainable. *NETROAMPREF=n Allow configuration of the roaming preference. • n=0 : Restrict to home network only. • n=1‐3 : Allow roaming to affiliated networks. *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.23 Caution: STATICIP does not set the IP address of the modem, it merely tells the modem which IP address to expect.
Raven-E 1x +IPR=n I/O Port Rate: Sets the data rate for the serial port (DTE‐DCE). C3x11 or C3x11E only. Default is 115200. Cannot be configured in AceManager. • n=port rate (45 | 50 | 75 | 110 | 300 | 600 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200 | 230400) $QCVAD=n Mode for answering data or fax with the A (answer) or via auto answer (S0=1). C3x10 or C3x10E only. Cannot be configured in AceManager. • n=0 : Disable • n=3 : Data for one call. • n=4 : Data for all calls (default). *MODEMHISPEED Set the internal serial link speed to the internal (radio) module. • n=0 : 115200 (default) • n=1 : 230400 This group includes commands specific to the modem being able to use domain names instead of IP addresses for other configuration options. Figure 1-4: 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.
Configuration Commands *DNSUPDATE=n Indicates whether the modem should send DNS updates to the DNS server specified by *DNSUSER. These updates are as per RFC2136. They are not secure and are recommended only for a private network. In a public network, the IP Logger services should be used instead. • n=0 : DNS updates disabled (Default). • n=1 : DNS updates enabled. *DNSUSER=d.d.d.d Sets a user‐provided DNS to query first when performing name resolutions in the modem. • d.d.d.d=IP address of domain server Dynamic IP This group includes commands specific to dynamic DNS. Dynamic DNS allows the Raven‐E to use a dynamic IP address account, with an IP address that can change each time you connect, and still allow you to use a fully qualified domain name to contact the Raven‐E using IP Manager running on a server with a dynamic DNS updater. Figure 1-5: AceManager : Dynamic IP *DOMAIN=name Domain (or domain zone) of which the Raven‐E 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 ...
Raven-E 1x Tip: Only letters, numbers, hyphens, and periods can be used in a domain name. *IPMANAGERn=[name][IP address] Sets a domain name or IP address to send IP change notifica‐ tions to. Up to two independent IP Manager servers can be set, using either AT*IPMANAGER1 or AT*IPMANAGER2. Updates to a server can be disabled by setting that entry to nothing (for example, “AT*IPMANAGER1=”). • n=1 : First IP Manager server. • n=2 : Second IP Manager server. • name=domain name *IPMGRKEYn=key Sets the 128‐bit key to use to authenticate the IP update notifi‐ cations. 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. ...
Configuration Commands Example: if *MODEMNAME=mymodem and *DOMAIN=eairlink.com, then the modemʹs fully qualified domain name is mymodem.eairlink.com. Automatically Generated Names: #I3 ‐ The ESN/IMEI will be used as the name. #CCID ‐ The CCID will be used as the name. #NETPHONE ‐ The phone number will be used as the name. Tip: Each modem using IP Manager needs a unique name. Two modems cannot be called “mymodem”. One could be “mymodem1” with the other as “mymodem”. PPP/Ethernet This group includes commands specific to PPP (serial) or Ethernet connections between the Raven‐E and a connected device. Figure 1-6: AceManager : PPP/Ethernet *DHCPSERVER=n •...
Raven-E 1x requests.n=0 : Disabled. The Raven X will not send out replies to DHCP requests. Tip: For PPPoE, set *DHCPSERVER=0. *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.n = subnet mask, example 255.255.255.0. *HOSTPEERIP=d.d.d.d Set or query the IP address that can be used to directly contact the Raven‐E once a cellular connection is established. If this value is not specified, 192.168.13.31 will be used. • d.d.d.d=local or peer IP address of the modem. Note: This is not normally used nor needed by user applications. *HOSTPRIVIP=d.d.d.d Set or query the private IP address that is to be negotiated by ...
Configuration Commands address, the cellular connection will be closed (since the IP address has changed) and has to be re‐initiated. (default). • n=1 : Private IP Mode: When the Host initiates a 1x connection, the host will be given the IP address specified in *HOSTPRIVIP. The modem will then perform 1 to 1 NAT‐like address translation, which shields the Host from network IP changes. *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‐ E internal hardware. Caution: While the modem is in PassThru mode, ALEOS is disabled. If you need to connect to the Raven-E while it is in PassThru mode, you will need to do so with a terminal application.
Raven-E 1x Note: It may take up to 30 seconds for the hardware module to respond after CONNECT is output. *CSX1=n PassThru Echo : Echo data to the host. • 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.
Configuration Commands SMS (Short Message Service) is another way to send messages via the cellular network. Most SMS commands require the modem to be in PassThru mode. Note: SMS may not be supported by your account with your cellular carrier. Figure 1-8: 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. • email=email address (maximum: 30 characters).
Raven-E 1x *SMTPSEND=email[body] Sends an email to the address specified, followed by the body of the email message. The email message is terminated and sent by entering a . or Ctrl‐Z on an empty line. Cannot be configured with AceManager. • email=email address • body=message body *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. Example: 354 = send in progress 250 = sent ok *SMTPSUBJ=subject Allows configuration of the default Subject to use if one isnʹt specified in the message by providing a “Subject: xxx” line as the initial message line. • subject=message subject *SMTPUSER=user The email account username to authenticate with the SMTP server (*SMTPADDR) for sending email. • user=username (maximum: 40 characters). Note: Not required to use SMTP settings but may be required by your cellular carrier.
Configuration Commands • flag=3 : Delete All READ, SENT and UNSENT messages. • flag=4 : Delete All messages. Caution: There is no confirmation required. +CMGR=n Read a message for C3x11 or C3x11E only. Requires PassThru mode. • n=0‐9 Index number of the message (location). +CMGS= phone[body] Sends an email using SMS. The phone number is specified first. Then the body of the mes‐ sage is entered. The message is terminated and sent by entering Ctrl‐ Z on an empty line. • phone= phone number • body= message body Note: E-mail is available if *NETSMS2EMAIL has been configured. Use the email address instead of the phone number. !CNTSMS Reports the number of messages stored. C3x10 or C3x10E only. ...
Raven-E 1x !GSMS?index,message Read an SMS message from the modem. C3x10 or C3x10E only. Requires PassThru mode. • index= index list (0, 1, 2) • message= message number The message number is a base 0 index into the list, where 0 is the oldest message, and the number reported by !CNTSMS minus one, is the most recent message. !SSMS=priority,destination,[cb],”text” Send an SMS message. C3x10 or C3x10E only. Requires PassThru mode. • priority=0, 1, 2 • destination=phone number of destination • cb=call back number • text=text of message enclosed in quotes Note: The text is enclosed in quotations. The quote character cannot appear in the body text. Messages with over 160 bytes of body text will be truncated and sent anyway.
Configuration Commands Other Figure 1-9: AceManager : Other 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.
Raven-E 1x *IPPINGADDR=[d.d.d.d][name] Set the IP address or valid internet domain name for the Raven‐E to ping to keep itself alive (online). *IPPING must to be set to a value other than 0 to enable pinging. • d.d.d.d=IP address • name=domain name *MSCIUPDADDR=name[/port] Modem Status Update Address ‐ where Name/Port is the domain name and port of the machine where the modem status updates will be sent. The status parameters of the Raven‐E are sent in an XML format. • name=domain name • port=port *MSCIUPDPERIOD=n Modem Status Update Period ‐ where n defines the update period in seconds. • n=0 : Disabled. • n=1‐255 seconds *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‐E 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.
Configuration Commands • n=0 : SNMP is disabled. • n=1‐65535 *SNMPSECLVL=n Selects the security level requirements for SNMP communica‐ tions. • n=0 : No security required. SNMPv2c and SNMPv3 communications are allowed. • n=1 : Authentication equivalent to “authNoPriv” setting in SNMPv3. SNMPv3 is required to do 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. *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.d][name] SNTP Server IP address, or fully‐qualified domain name, to ...
Raven-E 1x *TPORT=n Sets or queries the port used for the AT Telnet server. If 0 is specified, the AT Telnet server will be disabled. The default value is 2332. • n=0 : Disabled. • n=1‐65535 Tip: Many networks have the ports below 1024 blocked. It is recom- mended to use a higher numbered port. *TQUIT Disconnects the telnet session. Not available in AceManager.. Friends Friends Mode can limit access to the Raven‐E from the cellular network and the Internet. Friends mode is a basic firewall. Caution: If you are using Friends 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.
Configuration Commands FM=n Friends Mode ‐ Only allow specified IPs to access the Raven‐E modem. • n=0 : Disable Friends mode • n=1 : Enable Friends mode ‐ Only packets from friends will be accepted, packets from other IP addresses are ignored. Fn=[d.d.d.d] Friends mode 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. 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.
Raven-E 1x *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. • n=0 : No logging • n=1 : Log errors: invalid/corrupt packets, etc. • n=2 : Log the header of all received packets. Note that this can quickly exhaust available space for the event log. *DBGIPLVL=n Sets the logging level for the IP subsystem. • n=0 : No logging • n=1 : Log errors (i.e. invalid/corrupt packets, etc.). • 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. • n=0 : No logging • n=1 : Log client events (default) • n=2 : Log server events • n=3 : Log client and Server events 1x/EV-DO This group includes commands specific to 1x and EV‐DO. If ...
If the number is rejected, the ERROR result is returned. If three successive Errors are returned, the modem must be reset by Sierra Wireless AirLink Solutions to allow any further attempts. The modem permits 99 failures of this command during its lifetime.
Raven-E 1x Provision the modem with the lock code and phone number. Cannot be configured in AceManager. • MSL=master lockcode • MDN/MIN=phone number • SID=system ID • NID=network ID *PROVISION2=MSL,MDN,MIN[,SID][,NID] Tip: It is recommended to use the Setup Wizard for your carrier to provision the modem. 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 +WSPC=[lock],[nnnnnn] Service Programming Code. C3x11 and C3x11E only. Upon ...
Configuration Commands +WMDN=num Set the Mobile Directory Number (MDN). C3x11 and C3x11E only. • num=phone number (Valid numbers are between 10 and 15 digits in length.) For support of Wireless Number Portability in all non‐RUIM software versions, changes to the MDN will update the IMSI_M portion (least significant 10 digits) of the IMSI. Changes to the MDN will also automatically update the Access Overload Class values unless specifically modified using the +WAOC command. The new IMSI_M and Access Overload Class values will not be visible in the WIMI and WAOC commands until after the changes are committed with the WCMT command. +WIMI=num Set the IMSI (MIN/MSID preceded by the country code, Inter‐ national Mobile Subscriber Identity). C3x11 and C3x11E only. • num=MIN/MSID preceded by the country code The MIN/MSID preceded by the country code is 15 digits in length; MCC (3), MNC (2), MIN2 (3), MIN1 (7). For support of Wireless Number Portability, changes to this number will NOT update the MDN. Changes will automatically update the Access Overload Class values unless specifically modified using +WAOC command. +WSID=[idx],[SID],[NID] Set SID and NID. C3x11 and C3x11E only. • idx=The location in the SID/NID list to store the values. • sid=system ID • nid=network ID The new SID/NID values are committed to NV with the +WCMT command (AT+WCMT=1). A maximum of 20 index locations (0‐19) are supported. Error 22 is returned if the specified index value is not in the valid range. ~NAMVAL=nam[,min,msid,sid,nid] Tip: It is recommended to use the Setup Wizard for your carrier to provision the modem.
Page 109
Raven-E 1x • min=phone number • msid=second number • sid=0 or the system ID • nid=63355 or the network ID Note: If ~NAMLCK has not been successfully executed, the modem returns ERROR. • nam=0 • min=phone number • msid=second number • sid=0 or the system ID • nid=63355 or the network ID 20070914...
B: PPP over Ethernet (PPPoE) • Configuring the Raven-E for PPPoE • Configuring a PPPoE PPPoE (Point‐to‐Point Protocol over Ethernet) allows a point‐ Connection in to‐point connection while using Ethernet. Just like the dial up Windows protocol on which it is based, PPPoE uses traditional user name and password authentication to establish a direct • Connecting to the connection between two Ethernet devices on a network (such Internet with PPPoE as your Raven‐E and your computer or router). Application examples for PPPoE with your Raven‐E: • Backup connectivity solution for your network. • Individualized Internet connection on a LAN. • Password restricted Internet connection. Only one computer, router, or other network device at a time can connect to the Raven‐E using PPPoE.If you are using the Raven‐E connected to a router as a back up Internet connection ...
Page 111
PPP over Ethernet (PPPoE) 1. Configure your Raven-E to support PPPoE Connect your Raven‐E directly to your computer and start AceManager. From the groups on the left, select PPP/Ethernet under Common. Figure 2-1: AceManager : PPP/Ethernet Change *HOSTAUTH to 2. Enter a user name for *HOSTUID for the PPPoE connection. Enter a password for *HOSTPW for the PPPoE to connection. Change *DHCPSERVER to 0 Tip: If you leave *HOSTUID and *HOSTPW blank, any computer or device can connect to the PinPoint modem using PPPoE. Note: AceManager shows the existing values for *HOSTUID and *HOSTPW encrypted and character padded.
PPP over Ethernet (PPPoE) Enter a name for *MODEMNAME, such as Raven‐E 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-E. 3.
Page 113
PPP over Ethernet (PPPoE) Figure 2-4: Windows : Start menu 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 Click Next on the opening screen to begin creating a PPPoE connection. Next. Rev 3.0B Feb.08...
Page 114
PPP over Ethernet (PPPoE) Figure 2-6: New Connection Wizard Select Connect to the Internet. Select Next. Figure 2-7: New Connection: Type Select Set up my connection manually. Select Next. Figure 2-8: New Connection: How do you want to connect? Rev 3.0B Feb.08...
Page 115
PPP over Ethernet (PPPoE) Select Connect using a broadband connection. Select Next. Figure 2-9: New Connection : Connect using broadband Type in a name for the connection, such as Sierra Wireless AirLink Modem. 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. It can be the name of your wireless service provider (Provider), your modem (Raven-E), or any other designation for the connection.
Page 116
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 configu- ration, 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.
Page 117
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. Select Properties. Figure 2-13: PPPoE Connection 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 Select Networking. Select Settings. Rev 3.0B Feb.08...
Page 118
PPP over Ethernet (PPPoE) Figure 2-15: PPPoE : Networking Remove the checks from all three PPP settings. 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.
PPP over Ethernet (PPPoE) Connecting to the Internet with PPPoE Now the PPPoE connection can be run and a data connection can be established. 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. Start the PPPoE by Start > Connect To > Sierra Wireless AirLink Modem (or whatever you named the connection). It will be listed on your Network Connec‐ tions window under the heading Broadband. Same *HOSTUID as configured earlier Same *HOSTPW as configured earlier Figure 2-17: PPPoE Connection Enter the User name and Password you configured for ...
Need help?
Do you have a question about the AirLink Raven-E 1 series and is the answer not in the manual?
Questions and answers