Sierra Wireless RAVEN IDEN 20070914 User Manual

Sierra Wireless RAVEN IDEN 20070914 User Manual

Sierra wireless modem user manual
Table of Contents

Advertisement

Quick Links

Raven iDEN
for TELUS
User Guide
20070914
Rev 3.0B

Advertisement

Table of Contents
loading

Summary of Contents for Sierra Wireless RAVEN IDEN 20070914

  • Page 1 Raven iDEN for TELUS User Guide 20070914 Rev 3.0B...
  • Page 2 POWERED OFF. When operating, the Sierra Wireless AirLink  Raven 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 may be used at this time. The driver or operator of any vehicle should not operate the  Sierra Wireless AirLink Raven 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: Contact Information

    Patents Copyright Trademarks Contact Information Rev 3.0B Feb.08 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. 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,890,057 5,929,815 6,169,884 6,339,405 6,359,591 6,400,336 6,643,501 6,653,979 6,697,030 6,847,830 6,876,697 6,879,585 6,985,757 7,023,878 7,053,843...
  • Page 4 Hours: 5:00 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 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...
  • Page 5: Revision History

    AirLink Communications documentation - CDPD, CDMA, and GPRS. AirLink Communications documentation - CDMA, EV-DO, EDGE, and HSDPA. Converted documentation from AirLink Communications documentation format into Sierra Wireless documentation format. Phase II of the conversion completed. Raven modem line documentation is revised. Preface...
  • Page 6: Table Of Contents

    Modem Doctor USB ........
  • Page 7 IP Manager ............61 Reasons to contact the modem and/or the connected device: ......61 Understanding Domain Names.
  • Page 8 Restrictions for Modem Name........
  • Page 9 \APPP ............... . 100 Set modem operation to PPP mode. Cannot be configured in AceManager.\ASLIP ..100 \Qn .
  • Page 10 +WVLASS=n ..............100 *CTSE=n.
  • Page 11 *RESETPERIOD=n ............. 112 SMTP .
  • Page 12 Installing a modem driver for Raven........
  • Page 13: Introduction To The Raven

    Connecting to the TELUS Network • iDEN Communication Rev 3.0B Feb.08 Powered by ALEOS™, Raven modems are designed to  maintain a reliable, consistent network connection. With a  serial interface and a vast library of machine protocols, the  Raven is a workhorse for industrial and mission critical appli‐ cations. Class I Divison 2 certified as nonincendive equipment,  the Raven Series is ideally suited for use in hazardous environ‐ ments. Key applications include utilities, manufacturing, automation,  oil and gas, SCADA, telemetry, Homeland Security and asset  monitoring.  Figure 1-1: Sierra Wireless AirLink Raven 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 •...
  • Page 14: Aceware

    AceManager • • AceNet • AceView • 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. 1.1 and Microsoft Windows 98, Windows 2000, Windows XP, or later. You can obtain the Microsoft .NET Framework from Microsoft at: http://www.microsoft.com/.
  • Page 15: Simplified Deployment

    Introduction to the Raven 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...
  • Page 16: Acenet

    Introduction to the Raven 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...
  • Page 17: Modem Doctor

    Introduction to the Raven Modem Doctor Modem Doctor is a troubleshooting and diagnostics utility.  This utility will allow you to get a log file of the Raven activity  which you can then send to Sierra Wireless support, erase the  current configuration completely., and temporarily set the  Raven to a known configuration to aid in trouble shooting  (SOS mode). Rev 3.0B Feb.08...
  • Page 18: Modem Doctor Usb

    Rev 3.0B Feb.08 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”.
  • Page 19: Connecting To The Telus Network

    Rev 3.0B Feb.08 Figure 1-7: Modem Doctor: USB connection Connecting to the TELUS Network The Raven uses TELUS as an ISP (Internet Service Provider) to  connect you to the Internet. Steps of a connection: When your Raven is powered on, it automatically searches  for cellular service using iDEN. Your Raven establishes a PPP (Point to Point Protocol or  “dial” up connection) link to the TELUS network, also  called registering on the network, and receives an IP  address. When your Raven has received its IP address from TELUS,  a connection to the Internet or the cellular network is also  available for a computer or other device connected directly  to the Raven. Introduction to the Raven...
  • Page 20: Dynamic Vs. Static Ip Addresses

    (several devices connected to one port). If you need to have more than one device connected to the Internet through your Raven, you will need to have a router connected to the modem. The modem would provide the one-to-one connection to the router with the router configured to provide a broader NAT service to the other devices connected to it.
  • Page 21: Iden Communication

    Caution: If you want to connect remotely to your Raven using TCP/ IP, the IP address given to your modem by TELUS 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).
  • Page 22: Specifications

    2: Specifications • Interface Port Pin-Outs • Power Connector Rev 3.0B Feb.08 Features and Benefits • Embedded Intelligence • Low Power Consumption • Serial Port • Machine Protocols • Simple Integration with Legacy Equipment • Persistent Network Connectivity • Remote Management and Configuration • Class I Div 2 Certified Technology • iDEN Bands • 800 Mhz Cellular Environmental • Operating Temperature: ·...
  • Page 23: Dimensions

    Rev 3.0B Feb.08 Dimensions • 76mm x 25mm x 129mm • 317 grams Application Interfaces TCP/IP, UDP/IP, DHCP, HTTP, SNMP, SMTP, SMS, MSCI,  • Binary,  Modbus, and more LED Indicators • Channel • Link • Registration • RSSI • Transmission/Receive • Power Interface Port Pin-Outs Serial Port Unused < - CTS (Clear to Send) - > RTS (Request to Send) <...
  • Page 24: Activating Raven On Telus Network

    3: Activating Raven on TELUS Network • Installing the SIM • Master Reset Rev 3.0B Feb.08 This chapter provides step‐by‐step directions for activating  your Raven on the TELUS cellular network. Installing the SIM The SIM in the Raven is a smartcard securely storing the key  identifying a cellular subscriber. Generally, you will only need  to install a SIM once in the life of the modem and it may be  pre‐installed by your Sierra Wireless Representative. 1. Before you start If the SIM was pre‐installed activation of your modem is  complete. Cellular Account Required • Cellular account ‐ To use your modem you need to have a  SIM (Subscriber Identity Module) with an active account  with an iDEN cellular provider. Software Required •...
  • Page 25: Opening The Case

    Raven iDEN Note: The card and SIM may be a different color than these examples. 1. Opening the Case Unplug the Raven power and all cables. Using a small phillips head screw driver, remove the  screws on the back of the Raven.  Slide the case off of the Raven and set it aside. Figure 3-1: Partially removed case Carefully remove the SIM card from the card you got  from TELUS. 3. Ejecting the SIM tray Tip: The button is between two boards. Figure 3-2: SIM tray button 4.
  • Page 26 Figure 3-4: Insert SIM in to the modem Place the SIM into the tray and gently press to click it  into place. Figure 3-5: Empty SIM Tray and a Tray with a Sample SIM 5. Insert the Tray and SIM Slide the tray back into the modem. Gently press to click it into place.  Tip: The top of the card faces the bottom of the modem.
  • Page 27: Master Reset

    Raven iDEN Figure 3-6: Inserting the SIM 6. Finishing the SIM installation Slide the Raven back into the case. Secure the back of the Raven with the screws.  Master Reset Once you have the SIM installed, the final step for it to work  with your Raven is issuing a master reset. You will need to  connect to the Raven using a terminal application such as  HyperTerminal with the Raven connected directly to your  computer. You can access and configure your Raven 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 20070914...
  • Page 28 1. Choose a name and icon for your connection. Choose a name for your connection, such as Raven 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 local. Select OK. 2. Connect To Using Serial: Select COM1, or the comport to which the modem is  connected, for the “Connect Using”. ...
  • Page 29 Raven iDEN Figure 3-8: Connect To Type in 192.169.13.31 for Host Address. Change the “Port Number” to 2332. Select OK. 3. Port Settings (serial only) Change or verify the settings:  · Bits per Second: 115200 (default) · Data Bits: 8 · Parity: None · Stop Bits: 1 · Flow Control: Hardware.  20070914...
  • Page 30 Activating Raven on TELUS Network Figure 3-9: Port Settings Tip: If you have configured the Raven 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. Select OK.
  • Page 31 Raven iDEN Figure 3-11: HyperTerminal : connected Tip: You will not be prompted for a password if you connect using a COM port. 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.  5. Enter the Master Reset Command for iDEN Type AT*PROVISION=000000, 0123456789 The Raven should respond with: “Master Reset ...
  • Page 32: Hardware Installation Of The Raven

    • Mounting Rev 3.0B Feb.08 Your Raven 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 tempera‐ tures. The LEDs on the front panel should be visible for ease of  operational verification. You should ensure that there is  adequate airflow around the modem but that it is kept free  from direct exposure to the elements, 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 is in a hardened case and designed for use in industrial and extreme environments. However, unless you are using cables expressly designed for such environments, they can fail if exposed to the same conditions the Raven can withstand.
  • Page 33: Connecting To Power

    Tip: When using a cable to an antenna placed away from the modem, minimize the length of your cable. All gain from a more advantageous antenna placement can be lost with a long cable to the modem. Connecting to Power Your Raven can be used with either DC, available in most ...
  • Page 34: Connecting To A Computer Or Other Device

    Rev 3.0B Feb.08 Hardware Installation of the Raven Connecting to a Computer or other Device Figure 4-2: Serial The serial port of your Raven can be connected directly to most  computers or other devices using a standard straight through  cable. If you have a DCE device, you will need a null modem  or null modem cable.  Indicator Lights When your Raven is connected to power and an antenna, there  is a specific pattern to the lights to indicate its operation mode. Figure 4-3: Raven Indicator lights • Chan (channel) ‐ Indicates the modem has acquired a  network channel. • Link ‐ Indicates a successful connection to the cellular  network. • Reg (registration) ‐ Indicates the Raven has acquired an IP  fromTELUS.
  • Page 35: Light Patterns

    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 • TxRx (transmit/receive) ‐ The light will flash as data is  transferred to and from the Raven‐E modem on the remote  network. • Pwr (power) ‐ Indicates the power adapter is connected  and there is power getting to the Raven. • The Reset button performs the same function as  unplugging power from the modem and plugging it back  in. Reset will not alter any saved configuration settings.  Light Patterns The LEDs on the front of the modem will respond in different ...
  • Page 36 Hardware Installation of the Raven Figure 4-4: Optional Mounting Bracket Rev 3.0B Feb.08...
  • Page 37 Hardware Installation of the Raven Figure 4-5: 100-170-1009 : Mounting Bracket for Raven Rev 3.0B Feb.08...
  • Page 38 Hardware Installation of the Raven Figure 4-6: 100-170-1006 : Mounting Bracket for Raven Rev 3.0B Feb.08...
  • Page 39: Configuring Your Raven

    5: Configuring your Raven • Using AceManager • Using Templates • Using a Terminal Application with AT Commands Rev 3.0B Feb.08 With ALEOS as its “brain”, the Raven is a highly configurable  device, more than just a “dumb” modem.   To configure your Raven, 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.  Since the AceWare applications are designed for ease of use,  nearly all descriptions and screen shots of Raven configuration  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, 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 ...
  • Page 40 Rev 3.0B Feb.08 Figure 5-1: AceManager 2. Connect to your Raven 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. ·...
  • Page 41: Enter The Configuration Options

    Rev 3.0B Feb.08 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 Configuring your Raven...
  • Page 42: Using Templates

    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 43 Rev 3.0B Feb.08 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 44: Applying A Template To One Modem With Acemanager

    Rev 3.0B Feb.08 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 45 Configuring your Raven 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.
  • Page 46 Rev 3.0B Feb.08 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 ...
  • Page 47: Using A Terminal Application With At Commands

    Rev 3.0B Feb.08 Using a Terminal Application with AT Commands You can access and configure your Raven 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 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 48 Rev 3.0B Feb.08 2. Connect To Select COM1, or the comport to which the modem is  connected, for the “Connect Using”.  Figure 5-14: Connect To Type in 192.169.13.31 for Host Address. Change the “Port Number” to 2332. Select OK. 3. Port Settings (serial only) Change or verify the settings:  · Bits per Second: 115200 (default) · Data Bits: 8 · Parity: None · Stop Bits: 1 Configuring your Raven...
  • Page 49 Rev 3.0B Feb.08 · Flow Control: Hardware.  Figure 5-15: Port Settings Tip: If you have configured the Raven 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. Select OK.
  • Page 50: At Commands

    Rev 3.0B Feb.08 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, it will ...
  • Page 51: Data Communication And Host Modes

    6: Data Communication and Host Modes • Basic Modes • Serial Modes • Data Communication Rev 3.0B Feb.08 The Raven 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 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.
  • Page 52: Data Communication

    • 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). Any  data received from the TCP peer is unwrapped and sent  out the serial. Data Communication • Public and Private Modes: The method used by the Raven  to pass an IP address to a connected device. • Keepalive: How the Raven maintains its connection to the  cellular network. Basic Modes Start up Mode The serial port of the Raven can be configured to enter any of  the modes automatically on power up (in most cases, this is  also after it has registered on the cellular network). This is  done by setting the Startup Mode Default to the desired mode.  If this setting is non‐zero, the modem will enter the specified  mode after 5 seconds. If you want to cancel this behavior, the  ATMD0 command can be used before the 5‐second time‐out  expires. You can configure the Startup Mode in AceManager at part of  the UDP group. Figure 6-1: AceManager : UDP - MD...
  • Page 53: At Mode

    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. 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 ...
  • Page 54: Passthru Mode

    Mode. While in PassThru mode, you also cannot use AceManager to connect with the PinPoint. Issuing the “AT\APASSTHRU” from a terminal emulation  enters this mode. The modem responds with OK, at which  point a direct connection to the internal hardware is estab‐ lished. You can also configure the modem to enter PassThru  mode on start up using MD. Tip: PassThru can only be exited by resetting or power-cycling the modem. This mode cannot be entered via a remote Telnet session. You can configure a string of AT commands to be sent to the  Raven when it enters PassThru and other PassThru settings.  Figure 6-2: AceManager : PassThru...
  • Page 55: Telnet Mode

    Data Communication and Host Modes PassThru Mode allows only specific AT commands. Some  ALEOS commands will be unavailable when the Raven 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).  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. Telnet Mode In AceManager you can configure Telnet operation.
  • Page 56 Data Communication and Host Modes PPP mode is entered from the AT mode by using any of the  following commands: • AT\APPP  • ATDT10.0.0.1  • ATDT10001  • ATD#19788 or #777 *99***1#  • CLIENT  In response to any of the preceding commands, the Raven 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. If *HOSTPRIVMODE=1, the value of  the private IP address can be determined beforehand by  querying S110. The private IP address to be used can be  defined with the command AT*HOSTPRIVIP=192.168.100.33,  substituting the desired IP address. Figure 6-5: AceManager : PPP/Ethernet Using a private IP insulates the PPP client from changes in IP  addresses of the underlying network. The will perform basic  NAT‐like address translation on all packets.  If a public IP address is being used, any changes in the IP (as  determined by the wireless network) will result in the PPP link  to the host being disconnected, requiring the host to reinitiate  it. The public IP is passed to the host in the PPP negotiations,  so when the network forces a change, the modem has to force  the host to renegotiate the PPP link to make this happen.
  • Page 57: Slip

    Rev 3.0B Feb.08 Data Communication and Host Modes SLIP SLIP mode is entered be using the “AT\ASLIP” command. As  in PPP Mode, the IP address that the host assumes is affected  by the setting of *HOSTPRIVMODE. SLIP does not negotiate  the IP address with the connected device or computer, so  before making a SLIP connection, the SLIP driver on that  device or computer must be configured to use the IP address  specified by querying S110. UDP and UDP Pad When the modem is in UDP PAD (Packet Assembly and Disas‐ sembly) Mode, all characters received on the serial port are  assembled into UDP packets and sent to the remote IP  address/port or the Raven, and any packets received from the  same IP/port‐destined for the device port of Raven (see  *DPORT)‐‐are disassembled and dumped onto the serial line.  A UDP session is initiated by one of the following events: • Using the Dial UDP (DP) AT command (example,  ATDP192.168.3.23/3456). • Setting the Startup Mode Default (MD) to 3 (UDP) so that  a UDP session is entered automatically when the modem  registers onto the network. Serial data will be sent to the  IP/port specified in S53. Incoming UDP packets will be processed out the serial port if  • UDP auto answer is enabled (S82=2); • The destination IP address matches that in S53 (if Friends ...
  • Page 58: Reliable Udp

    Tip: It is best to ensure the idle time-outs for TCP and UDP are never 0 if you're going to be using auto-answer, or either PAD mode. In those circumstances, you will want the modem to close the socket if the connection goes idle for too long, particularly if the other side doesn’t normally close the connection.
  • Page 59: Udp Multicast Mode

    Rev 3.0B Feb.08 Data Communication and Host Modes until it receives an acknowledgement with this sequence  number. If an acknowledgement is not received within the  time‐out period (specified in S7), the data will be retrans‐ mitted. This will continue until an acknowledgement is  received or the modem is reset. Likewise any UDP packets  received by the Raven are expected to have this simple header.  The Raven will issue an acknowledgement for any valid  packets which are received. To configure the Raven for a normal UDP session, you need to  set the Startup Mode Default to 73 (ATMD73). If you are using  two modems, configure the Destination IP and Port in each to  point to each other. Serial data will then be sent reliably  between the two. Caution: Although it adds reliability, the simple implementation of the Reliable UDP mode in the does not check for duplicate packets.
  • Page 60: Tcp Auto Answer

    TCPT is the number of minutes (TCPS=0) or seconds (TCPS=1)  used for this idle time‐out.  Caution: TCPT should never be 0 when using the TCP mode. A broken TCP session can result in the modem being left with a TCP half-open connection that can only be terminated with a reset. TCP Auto Answer TCP auto answer (S0=1|2) also allows a TCP connection ...
  • Page 61 Rev 3.0B Feb.08 Data Communication and Host Modes 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. AT Command Hybrid Mod (MD5) *UDPLAST Hybrid Mode2 (MD6)
  • Page 62: Data Communication

    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. Using a hub or switch may prevent the Raven from updating the IP address of the end device when an IP address is received from the cellular network.
  • Page 63: Keepalive

    192.168.x.y for each as long as the x is the same number (0 in the example screen shot above) and the y is different (1 and 2 in the example) and between 0 and 254. Keepalive Keepalive is used to test the connection to the cellular network  by pinging an IP address after a specified period of inactivity.  Keepalive is only recommended for users who have a remote  terminated modem that infrequently communicates to the  network or if you have experienced issues over time where the  modem can no longer be reached remotely. When Keepalive pings the IP address, an acknowledgement  indicates there is an active connection to the network. If the  Raven does not receive a response from the IP address, it will  make additional attempts according to a backoff algorithm ...
  • Page 64: Configuring Keepalive

    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 ...
  • Page 65 Rev 3.0B Feb.08 Data Communication and Host Modes and is billable by TELUS.   The following *IPPING settings will  incur approximate monthly data usage in addition to any other  data usage:  *IPPING Estimated Usage 15 minutes 400k / month 30 minutes 200k / month 60 minutes 100k / month 120 minutes 50k / month...
  • Page 66: Ip Manager

    • Using IP Manager with your Raven • Understanding DNS Rev 3.0B Feb.08 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?).  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. • Sending text to be displayed by a road sign. • Updating the songs to be played on a juke box.
  • Page 67: Understanding Domain Names

    Rev 3.0B Feb.08 • Dynamic IP addresses are granted only when your Raven  is connected and can change each time the modem recon‐ nects to the network. • Static IP addresses are granted the same address every  time your Raven 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 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.) •...
  • Page 68: 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.
  • Page 69: Using Ip Manager With Your Raven

    Rev 3.0B Feb.08 Note: The fully qualified domain name of your Raven will be a subdomain of the domain used by the IP Manager server. Using IP Manager with your Raven 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 •...
  • Page 70: Restrictions For Modem Name

    Rev 3.0B Feb.08 the IP address changes (example, if your Raven 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 ...
  • Page 71: Understanding Dns

    *DOMAIN : eairlink.com  • *IPMANAGER1 : edns2.eairlink.com • *IPMANAGER2 : eairlink.com 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. Understanding DNS The Raven has the ability to query DNS servers in order to ...
  • Page 72: The "Ppp-Peer" Domain Name

    Rev 3.0B Feb.08 Figure 7-2: AceManager: DNS *DNS1 and *DNS2 ‐ The primary and secondary DNS  • servers set by Provider when your Raven 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 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 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 is not in PPP or SLIP address mode, “ppp‐peer”  will resolve to 0.0.0.0. IP Manager...
  • Page 73: Configuring Modbus/Bsap

    8: Configuring Modbus/BSAP • Configuring the Raven at the Polling Host for Modbus on UDP • Configuring the Remote Ravens for Modbus with UDP Rev 3.0B Feb.08 The Raven supports Modbus ASCII, Modbus RTU, BSAP, and  can also emulate other protocols like DF1 or others using its  Modbus Variable feature. Modbus Overview The Modbus Protocol, developed by Modicon in 1979,  provides for client‐server (also referred to as master‐slave)  communications between intelligent devices. As a de facto  standard, it is the most widely used network protocol in the  industrial manufacturing environment to transfer discrete/ analog I/O and register data between control devices. Modbus,  BSAP, and other Modbus variations are often used in  conjunction with telemetry devices. Tip: This section is just a brief overview of Modbus.
  • Page 74: Supervisory Control And Data Acquisition (Scada)

    Raven iDEN 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. SCADA encom‐ passes multiple RTUs, a central control room with a host  computer (or network), and some sort of communication infra‐ structure. SCADA allows for “supervisory” control of remote devices as  well as acquiring data from the remote locations. Program‐ mable Logic Controllers allow for a higher degree of  automated SCADA. Programmable Logic Controller (PLC) A Programmable Logic Controller (PLC) is a small industrial  computer which generally monitors several connected sensor  inputs and controls attached devices (motor starters, solenoids,  pilot lights/displays, speed drives, valves, etc.) according to a  user‐created program stored in its memory. Containing inputs  and outputs similar to an RTU, PLCs are frequently used for  typical relay control, sophisticated motion control, process  control, Distributed Control System and complex networking.  Modbus TCP/IP Modbus TCP/IP simply takes the Modbus instruction set and  wraps TCP/IP around it. Since TCP/IP is the communications  standard for the Internet and most networked computers, this  provides a simpler installation. Modbus TCP/IP uses standard ...
  • Page 75: Configuring The Raven At The Polling Host For Modbus On Udp

    Configuring Modbus/BSAP The remote Raven then disassembles the packet before trans‐ mitting 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 and host Raven. Configuring the Raven at the Polling Host for Modbus on This section covers a Polling Host with standard Modbus,  variations may need additional AT commands. 1. Configure the listening/device ports In AceManager, select Misc in the side menu. Figure 8-1: AceManager: Misc The destination port for the modem at the host needs to match  the device port (*DPORT) in use on all the modems at the  remote sites. For example, if the remote modem’s device port  (*DPORT) is “12345”, then the Modbus host modemʹs S53  destination port should be set to “12345”.  Take note of (or set) the Device Port setting in *DPORT to  configure the destination port on the remote modems. Rev 3.0B Feb.08...
  • Page 76 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. In AceManager, select the menu  option Addr List. Figure 8-3: AceManager: Addr List. 20070914...
  • Page 77 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.124 or ATMLISTX1B=123.123.123.124. 4. Optional: Dynamic IP Address If you do not have a static IP, the host modem should be  configured to report its current IP to a Dynamic DNS (DDNS)  server with IP Manager.  In the Host modem’s configuration, instead of IP address for  the Addr List (ATMLIST or ATMLISTX), substitute a single  unique name for each modem, i.e. remote1, remote2, etc. When you configure IP Manager for the host modem, make  note of your modem name and domain setting in AceManager  in the menu selection Dynamic IP to be used with the remote  modems. Figure 8-4: AceManager: Dynamic IP With names instead of IP addresses for the Address List, the  host modem will query the DNS server for the current IP  address assigned to the specific name of a remote modem to  send a message corresponding to the ID.  When you use names instead of IP addresses, to ensure your  modems are updated quickly with the correct IP addresses for  the names, you will want to set the DNS settings as well. In  AceManager, select DNS. Rev 3.0B Feb.08...
  • Page 78: Configuring The Remote Ravens For Modbus With Udp

    Raven iDEN 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 Ravens for Modbus with UDP This section covers standard Modbus settings for the Raven at  the remote unit, variations may need additional commands. 1. Configure the ports In AceManager, select Misc in the side menu. Figure 8-6: AceManager: Misc 20070914...
  • Page 79: Configure Ip Addresses For The Host

    UDP traffic unless the source IP/port matches what is in S53. However, if you set *AIP=1, the modem will forward UDP traffic from any source IP address as long as it is accessing the modem on the configured *DPORT. 3. Configure the default mode for start-up.
  • Page 80 Raven iDEN Enable S82, UDP auto answer.  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. Optional: Dynamic IP Address If you do not have a static IP, the host modem should be  configured to report its current IP to a Dynamic DNS (DDNS)  server with IP Manager.  You will need to match the name of the modem to the names  specified in the host modem’s MLIST or MLISTX for the  connected RTU. When you configure IP Manager for the host modem, make  note of your modem name and domain setting in AceManager  in the menu selection Dynamic IP to be used with the remote  modems. Figure 8-8: AceManager: Dynamic IP When you use names instead of IP addresses, to ensure your  modems are updated quickly with the correct IP addresses for  the names, you will want to set the DNS settings as well. In  AceManager, select DNS. 20070914...
  • Page 81 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 3.0B Feb.08...
  • Page 82 Raven iDEN 20070914...
  • Page 83: Snmp : Simple Network Management Protocol

    9: SNMP : Simple Network Management Protocol • SNMP Configuration • SNMP MIB Definition Sample Rev 3.0B Feb.08 The Simple Network Management Protocol (SNMP) was  designed to allow remote management and monitoring of a  variety of devices from a central location. The SNMP  management system is generally composed of agents (such as  your Raven, a router, a UPS, a web server, a file server, or other  computer equipment) and a Network Management Station  (NMS) which monitors all the agents on a specific network.  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, 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 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 ...
  • Page 84: Snmp Configuration

    Rev 3.0B Feb.08 SNMP : Simple Network Management Protocol SNMP Configuration To configure your Raven 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:  the listening port, the security level, and the trap destination. Figure 9-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.
  • Page 85: User Name And Password

    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. To change the password in the Raven, select Modem from the  top menu line in AceManager. Figure 9-2: AceManager : Change Password menu option The current password will be pre‐entered. As you type the ...
  • Page 86: Trap Destination

    Rev 3.0B Feb.08 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 87 Rev 3.0B Feb.08 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...
  • Page 88 Rev 3.0B Feb.08 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...
  • Page 89 Rev 3.0B Feb.08 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...
  • Page 90: Display Responses

    Rev 3.0B Feb.08 SNMP : Simple Network Management Protocol powerMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 8 } fixObtained OBJECT-TYPE SYNTAX INTEGER { no(0), yes(1) } MAX-ACCESS read-only STATUS current ::= { gps 1 } satelliteCount OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current...
  • Page 91: Product Id

    Raven-E 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 Product ID Each modem type has a unique ID associated with it so you  can more easily identify the modem from its type on your  network.  AT Command...
  • Page 92: Configuration Commands

    IP address if your Raven is configured to use DNS. DNS settings frequently come directly from TELUS while your Raven is registering on the cellular network and receiving it’s IP address. Info (information) The commands in the “Info” group have read‐only param‐ eters. They only provide information about the modem. Some  of the information displayed in this group does not correspond  directly to AT commands.
  • Page 93: Deviceid

    Raven iDEN Figure 1-1: AceManager : Info *DEVICEID? The 64‐bit device ID the modem uses to identify itself to the  cellular network.  *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). • n=1 : The Raven’s firmware (ALEOS) version, hardware ID,  and copyright.  • n=2 : The internal hardwareʹs firmware version and  relevant hardware ID.  • n=3 : The hardware moduleʹs unique identification number  or serial number. • 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.
  • Page 94: Status

    Note: If there is no current network IP address, 0.0.0.0 may be displayed. Rev 3.0B Feb.08 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 is not  in AT mode, telnet into the modem to execute this command.  *NETIP? The current IP address of the modem reported by the internal  module, generally obtained from TELUS. This is the address  can contact the Raven from the Internet.  Tip: Use *NETALLOWZEROIP if you need to allow the display of an IP ending in a zero.
  • Page 95: Netserv

    Raven iDEN Tip: The same information is displayed with the command S202?. *NETSERV? The type of service being used by the modem, for example  Tech. *NETSTATE? The current network state: • Connecting To Network: The Raven is in the process of  trying to connect to the cellular network.  • Network Authentication Fail: Authentication to the  cellular network has failed. Verify settings to activate the  Raven. • Data Connection Failed: The Raven failed to connect, and  it is now waiting a set time interval before it attempts to  reconnect. Verify settings to activate the Raven. • Network Negotiation Fail: Network connection negoti‐ ation failed. This is usually temporary and often clears up  during a subsequent attempt. • Network Ready: The Raven is connected to the 1x cellular  network and ready to send data. • Network Dormant: The Ravenis connected to the 1x  cellular network, but the link is dormant. It will be woken  up when data is sent or received. •...
  • Page 96: At Commands Requiring Passthru Mode

    Rev 3.0B Feb.08 • 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. • 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.  Configuration Commands...
  • Page 97: Common

    Note: A/ is not proceeded by AT. Common 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 is in a data mode (any mode  other than PassThru), this command causes the modem to re‐ enter AT command mode. The “+” is ASCII 0x2B.   available in AceManager. Tip: DAE=1 disables the +++ command. Re‐execute last command. A/ is not used in AceManager.  Manually answer an incoming connection. A is not used in  AceManager. +++ is not 20070914...
  • Page 98: D[Method][D.d.d.d][/Ppppp] Or D[Method][@Name][/Ppppp]

    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  port is not supplied, port 23 will be used instead of the value  from S53.  If a domain name is specified, the ʹ@ʹ symbol can be used to  explicitly indicate the start of the name. For example, if  ATDPHONY is issued, this will be interpreted as dial a UDP  connection to “HONY”. To dial using the default method to  host “PHONY”, one would issue ATD@PHONY.  Several special dialing numbers exist to make it easy to  establish a PPP or SLIP connection with the modem.  ATD#19788 or ATDT#19788 will establish a PPP connection  (see \APPP) and ATDT#7547 will establish a SLIP connection  (see \ASLIP).  Tip: The source port of the session is the Device Port (set by S110 or *DPORT). DS=n Allows a PPP connection to be initiated on the host port. • n=2 : Initiates the PPP connection. Cannot be configured in AceManager.  Hang‐Up Command.  •...
  • Page 99: Oprg=N

    Enables/disables over‐the‐air firmware upgrading of the  Raven. 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.  Reset the Raven. In AceManager, this command is performed  with the Reset option on the toolbar.  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. 20070914...
  • Page 100: Date=[Mm/Dd/Yyyy],[Hh:mm:ss]

    Rev 3.0B Feb.08 *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).  • n=1 : Takes user login and password from Windows DUN  connection and copies to *NETUID and *NETPW.  *NETALLOWZEROIP=n Allows the displayed IP address in *NETIP to end in zero (ex.  192.168.1.0).  • n=0 : Do not allow. • n=1 : Allow. *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.
  • Page 101: Staticip=D.d.d.d

    IP address to expect. If the expected IP address is not granted while registering on the cellular network, the modem will try to register on the network again until it receives that IP address. If your account is set up for a dynamic IP address and you...
  • Page 102: S3=N

    Rev 3.0B Feb.08 Toggle AT command echo mode.  n=0 : Echo Off. • • n=1 : Echo On. 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. This character is also used as the carriage  return character for framing responses and result codes in  command state. Cannot be configured in AceManager.  • n=0‐127 (ASCII character number) S4=n The standard line feed character sent by the modem to the host  at the end of a response or return code in command state.  Cannot be configured in AceManager.  • n=0‐127 (ASCII character number) S5=n This register sets the character recognized as a backspace  during command entry. Cannot be configured in AceManager. • n=0‐127 (ASCII character number) S6=n This register denotes the wait time, in seconds, before a blind  dial (no dial tone detection). Cannot be configured in  AceManager.  • n=2‐10 seconds 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. ...
  • Page 103: S9=N

    Raven iDEN S9=n Specifies the time that the received carrier must be present for  the modem to recognize it and turn on Data Carrier Detect  (DCD) if applicable. The implementation is entirely at the IWF  modem. Cannot be configured in AceManager.  • n=0‐255 S10=n Specifies the amount of time that the carrier from the remote  modem can be lost before the modem goes on‐hook. This  allows temporary disruptions to carrier without disconnecting.  A setting of 255 causes the modem to disable Carrier Detect  and presume carrier is always present. Cannot be configured  in AceManager. • n=1‐2545 S23=[speed],[databits][parity][stop bits] Serial line parameters. The settings take affect after reset. • speed=300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 |  57600 | 115200 | 230400 • databits=7 or 8    (Databits MUST be 8 data bits for PPP  mode.)  • parity=O : Odd • parity=E : Even  • parity=N : None • parity=M : Mark  • stopbits=1 | 1.5 | 2 Example:  ATS23=19200,8N1 Sets modem to 19200, 8 databits, no parity, and 1 stop bit. ...
  • Page 104: S211=N

    Rev 3.0B Feb.08 • n=0 : No forwarding character.  S211=n For applications or situations where hardware control of the  DTR signal is not possible, the modem can be configured to  ignore DTR. When Ignore DTR is enabled, the modem  operates as if the DTR signal is always asserted.  • n=0 : Use hardware DTR. (default). • n=1 : Ignore DTR.  • n=3 : Ignore DTR and assert DSR. This value is deprecated,  and it is recommended to use &S to control the DSR  instead. When this value is set to 3, &S will automatically  be set to 0. See also: &D and &S.  Command Response Mode.  • n=0 : Terse (numeric) command responses  • n=1 : Verbose command responses (Default).  Extended Call Progress Result mode.  • n=0 : Turn off extended result codes (Default).  • n=1 : Turn on result codes. This adds the text 19200 to the  CONNECT response.  &Cn Set DCD mode.  • n=0 : Always assert DCD.  • n=1 : Assert DCD when in a data mode (UDP, TCP, PPP, or  SLIP) (Default).  n=2 : Assert DCD when the modem has network coverage.  • &Dn Set DTR mode. ...
  • Page 105: Appp

    Raven iDEN • 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. \APPP Set modem operation to PPP mode. Cannot be configured in  AceManager.\ASLIP Set modem operation to SLIP mode. DTR must be asserted ...
  • Page 106: Modemhispeed

    Rev 3.0B Feb.08 • n=0 : Disabled (Default).  • n=1 : Enable assertion of CTS when there is network  coverage.  RS232 voltage levels:  Positive = Network coverage. Negative = No coverage. 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).
  • Page 107: S0=N

    Raven iDEN S0=n This register determines how the Raven responds to an  incoming TCP connection request. The Raven remains in AT  Command mode until a connection request is received. DTR  must be asserted (S211=1 or &D0) and the Raven must be set  for a successful TCP connection. The Raven will send a  “RING” string to the host. A “CONNECT” sent to the host  indicates acknowledgement of the connection request and the  TCP session is established.  • n=0 : Off (Default). • n=1 : On. • n=2 : Use Telnet server mode on TCP connections.  • 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. • n=seconds S60=n Telnet Client Echo Mode.  • n=0 : No Echo  • n=1 : Local Echo (Default) • n=2 : Remote Echo S221=n Connect Delay: Number of seconds to delay the “CONNECTʹ  response upon establishing a TCP connection. OR Number of  tenths of seconds to delay before outputting ENQ on the serial  port after the CONNECT when the ENQ feature is enabled ...
  • Page 108: Tcpt=N

    TCP PAD mode. • n=interval Caution: TCPT should never be 0 when using the TCP mode. A broken TCP session can result in the modem being left with a TCP half-open connection that can only be terminated with a reset. *ENQ=n Outputs an ENQ [0x05] after the TCP CONNECT delayed by ...
  • Page 109: Hor=N

    Raven iDEN HOR=n Half‐Open Response ‐ In UDP auto answer (half‐open) mode.  • n=0 : No response codes when UDP session is initiated. • n=1 : RING CONNECT response codes sent out serial link  before the data from the first UDP packet.  Note: Quiet Mode must be Off. MDhh Default power‐up mode for the serial port: When the Raven  modem is power‐cycled, the serial port enters the mode  specified by this command after 5 seconds. On startup, typing  ATMD0 within 5 seconds changes the mode to normal (AT  command) mode. See also S53 to set the port for UDP or TCP.  • hh (hex byte)=00 : normal • hh=01 : SLIP • hh=02 : PPP • hh=03 : UDP • hh=04 : TCP • hh=07 : PassThru • hh=0F : PinPoint MDT • hh=13 : Modbus ASCII • hh=23 : Modbus RTU (Binary) •...
  • Page 110: Du=N

    Note: *UDPLAST does not change the S53 setting in NVRAM. If the modem is reset, the original S53 setting will be restored from NVRAM. Rev 3.0B Feb.08 *DU=n The dial command always uses UDP, even when using ATDT. n=0 : Dial using the means specified (default).  • • n=1 : Dial UDP always, even when using ATDT. Note: When this parameter is set you cannot establish a TCP PAD connection.
  • Page 111: Dnsn=D.d.d.d

    Raven iDEN 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. *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 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 using IP Manager running on a  server with a dynamic DNS updater.  20070914...
  • Page 112: Domain=Name

    Rev 3.0B Feb.08 Figure 1-8: AceManager : Dynamic IP *DOMAIN=name Domain (or domain zone) of which the Raven 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.  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=”).
  • Page 113: Ipmgrupdaten=M

    • name=modem name (for example, mymodem)  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 and a connected  device. 20070914...
  • Page 114: Dhcpserver=N

    Rev 3.0B Feb.08 Figure 1-9: AceManager : PPP/Ethernet *DHCPSERVER=n • Act as a DHCP server for any Ethernet device connecting  to the Raven. DHCP (Dynamic Host Configuration  Protocol) allows one device, the DHCP server, to provide  dynamic IP addresses to any other device which requests  them. • 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). If another DHCP server is detected on the  network, the Raven will not send out replies to DHCP  requests.n=0 : Disabled.  The Raven X will not send out  replies to DHCP requests. *HOSTAUTH=n Host Authentication Mode: Use PAP or CHAP to request the  user login and password during PPP or CHAP negotiation on  the host connection. The username and password set in  *HOSTUID and *HOSTPW will be used.  • n=0 : Disable PAP or CHAP request (Default).  • n=1 : PAP and CHAP.   • n=2 : CHAP *HOSTNETMASK=n.n.n.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.
  • Page 115: Hostpeerip=D.d.d.d

    Raven iDEN *HOSTPEERIP=d.d.d.d Set or query the IP address that can be used to directly contact  the Raven 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  the 1x connection if *HOSTPRIVMODE =1.  • d.d.d.d=IP Address *HOSTPRIVMODE=n Set or query whether a private or public (network) IP is to be  used when the Host initiates a 1x connection to the modem. • n=0 : Public (network) IP Mode: When the Host initiates a  PPP connection, the host will be given the network IP  address that was obtained from the cellular carrier while  registering on the network. If the network issues a new IP  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. ...
  • Page 116: Idenudpfwd=Ppppp[,Ppppp][,Ppppp][,Ppppp][,Ppppp][,Ppppp][,Ppppp] [,Ppppp]

    Rev 3.0B Feb.08 Tip: The modem should be reset upon configuring these so that the new values will be applied. The AT*DPORT value can also be used to specify one port (both UDP and TCP) to be forwarded. *IDENUDPFWD=ppppp[,ppppp][,ppppp][,ppppp][,ppppp] [,ppppp][,ppppp] [,ppppp][,ppppp][,ppppp] Port Forwarding of custom UDP ports. Up to 10 (comma ...
  • Page 117: Apassthru

    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. *PTINIT=string Any AT Command string to be passed to the OEM module  before entering PASSTHRU mode, e.g. AT&S1V1, etc.  • string=AT command(s) *PTREFRESH=n Number of minutes of inactivity in PASSTHRU mode to ...
  • Page 118: Smtp

    Raven as a relay host. Talk to your network administrator to ensure you can send email through the email server using your Raven. 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-11: AceManager : SMTP *NETSMS2EMAIL=n Specify the SMS/E‐mail server number. This maybe necessary ...
  • Page 119: Smtppw=Pw

    Note: Not required to use SMTP settings but may be required by your cellular carrier. *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. ...
  • Page 120: Other

    *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. If you set *IPPING for a value between 0 and 15, the minimum value of 15 will be set.
  • Page 121: Ippingaddr=[D.d.d.d][Name]

    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 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. *SNMPCOMMUNITY=string The SNMP Community String acts like a password to limit  access to the modem’s SNMP data. • string =string of no more than 20 characters (default =  public). *SNMPPORT=n This controls which port the SNMP Agent listens on. 20070914...
  • Page 122: Snmpseclvl=N

    Rev 3.0B Feb.08 • 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 ...
  • Page 123: Tport=N

    IP addresses not on the Friends List. It cannot prevent data, such as pings, from traversing the network to the modem which may billable traffic even though the modem does not receive the data. Figure 1-13: AceManager : Friends...
  • Page 124: Fm=N

    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. Figure 1-14: AceManager : Logging *DBGCOMMLVL=n Set the logging level for the host or module COM port.  •...
  • Page 125: Dbgiplvl=N

    *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  Telemetry/Addr List Modbus, commonly used with telemetry devices, allows a  connection via serial port to the modem. Telemetry and Addr  List commands are only used when the modem is in one of the  Modbus start‐up modes. Further, Telemetry and the Addr List  are available with all Raven line modems which have a serial  port, such as the Raven X and the Raven XT.  Figure 1-15: AceManager : Telemetry IPL=n IP List Dial allows access the Modbus IP list using the first two  digits of the dial string.  20070914...
  • Page 126: Mvlen=N

    Rev 3.0B Feb.08 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.  • n=2 : This parameter is used when the when the MD is set  to hex 63.  MVMSK=hh Modbus Variant ID Mask: Byte hex mask to use when  extracting the ID. Specify which bits in the ID field to use. This  parameter is used when the when the Mode Default (MD) is  set to hex 63.  • hh=hex value  · 00 ‐ no mask, all 8 bits (default)  · 0F ‐ only the low order 4 bits  MVOFF=n Modbus (variable mode) Offset: Indicates the offset in the data  of where the Modbus ID starts.  • n=0 ‐ 255 MVOPT=n Modbus Variant Option: Sets various behavioral options when  dealing with a Modbus‐variant protocol. This parameter is  used when the when MD is set to hex 63. Cannot be configured  in AceManager. • n=0 : No special action (Default).
  • Page 127: Rkey=N

    Raven iDEN 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). • n=1 : On. Addr List Figure 1-16: AceManager : Addr List MLIST and MLISTX are configured by the fields available in  the Addr List group. AceManager automatically differentiates  between them to enter the correct command for the modem. MLISTid=d.d.d.d Enters an ID and IP address into the Modbus List. ID is a  decimal value (1 to 100).  • id=ID • d.d.d.d=IP address or name MLISTXhexid=d.d.d.d Enters an ID and IP address into the Modbus List. ID is a  hexadecimal value (0 to 64).  • hexid=ID • d.d.d.d=IP address or name 20070914...
  • Page 128: Circuit Switch Communications

    Configuration Note: When the Raven is used for circuit switch, the circuit switch configuration will disable all ALEOS features except for serial port communication. Rev 3.0B Feb.08 Circuit‐switch communication requires the Raven to be in  PassThru mode, communicating directly with the internal  hardware.  PassThru mode disables the use of ALEOS in the modem. Any  features available using ALEOS are not usable when the  modem is in PassThru mode. In PassThru mode, the settings  available are those of the internal hardware. The Raven N3213  in PassThru mode can not. The best machines for use in circuit‐switched mode are ones  that can provide their own INIT or setup strings and/or issue  AT commands. For customers who have unintelligent  machines who still need to have the modem ʹreadyʹ to behave  in a certain way (such as Auto‐Answering circuit‐switched ...
  • Page 129: At Commands And The Command String

    Raven iDEN Figure 2-1: AceManager : UDP > MD The Raven needs a command string sent to the modem after it  is initialized. The command string will need to be tailored for  your application. Different models of the Raven may respond  differently to some of the commands. In the PassThru group,  type your command string in the input field for *PTINIT. Figure 2-2: AceManager: PassThru AT Commands and the Command String Each modem requires a command string that is a combination  of AT commands limited to a maximum of 40 characters. The  command string will vary depending on the needs of the  connected device. For example, some devices need DTR to be  high while others need DTR to be ignored. For a full listing as  well as parameters and defaults, refer the AT Command  appendix. Caution: The only commands that can be used in the string are those which do not require ALEOS.
  • Page 130: Common At Commands

    Table 2-1: Example for the Raven C3211 AT*PTINIT=ATS0=1;+WS46=23;+WS45=0;+WVCLA SS=9 Rev 3.0B Feb.08 Command AT*PTINIT= Include this portion only if you will not be entering the command using a AceManager. The remainder of the example is the command string. All AT commands must start with “AT”. S0=1;+WS46=23;+WS45=0;+WVCLASS=9 The string is a combination of AT Commands limited to a maximum of 40 characters.
  • Page 131: Hardware Required

    • Modem Doctor ‐ Utility to conduct diagnostics and to  bring your modem to a base‐level of configuration. You  can download Modem Doctor from the Sierra Wireless  AirLink Solutions website: http://www.airlink.com. This  utility does not need to be installed; it is run directly.  Remember where you downloaded it to, so you can run it  as part of the instructions below. AceManager ‐ Graphical interface for entering most AT  • Commands. You can download AceManager from the  Sierra Wireless AirLink Solutions website: http:// www.airlink.com/. A default installation of this utility is  assumed later in these directions. • Raven Templates for Circuit‐Switch ‐ These templates are  provided by your Sierra Wireless AirLink Solutions repre‐ sentative and have a .xml extension. You can also  download the appropriate template from: http:// www.airlink.com/docs/AppNotes/CircuitSwitchTem‐ plates/. You should only download the template which  matches your modem model and/or configuration needs. 2. Connect the modem to your computer Using the RS232 cable, connect the modem to the computer  and apply power to the modem.  3. Erase the internal memory The Raven should have the internal memory erased to bring  the modem to a known starting point without any configu‐ ration or account programming.  20070914...
  • Page 132 Rev 3.0B Feb.08 Circuit Switch Communications Start Modem Doctor. Select Erase the modemʹs non‐volatile data. Figure 2-3: Modem Doctor Select Serial from the Interface options and select the  Port on your computer to which the Raven is  connected. Leave the Baud setting at 115200. Figure 2-4: Modem Doctor: Interface Click the Next button and press the modem Reset  button when prompted. The modem Reset button is  located on the front panel of the modem and can be  accessed with the point of a pen or similar tool. Figure 2-5: Raven: Reset button  Click the Exit button in Modem Doctor when the  process is complete.
  • Page 133 4. Activate the Raven Insert the SIM in the Raven iDEN modem.  Refer to the Raven iDEN Quick Start guide (available  on the AirLink website: http://www.airlink.com) or the  Activation chapter in this guide (page 4),for instruc‐ tions on how to install the SIM in your modem. The modem should come up and register on the iDEN  network in packet‐switched mode as indicated by the  illumination of the Reg LED on the front of the  modem.  5. Start AceManager. Start > All Programs > AirLink Communications > AceManager 3G  > AceManager 3G Click the Connect button.  Figure 2-6: AceManager Select PPP. Select COM1 for the Port. Enter 12345 for the Password. Click OK. Figure 2-7: AceManager : Connect to Modem using PPP 6. Configure serial port speed. On the left, under the GROUPS heading, select Serial.  20070914...
  • Page 134 Rev 3.0B Feb.08 Circuit Switch Communications Figure 2-8: AceManager : Serial - *MODEMHISPEED Change the *MODEMHISPEED setting to “0”. 7. Save the serial setting. Click the Write button on the tool bar of AceManager  and wait for the message “Write Successful” to appear  in the status bar. Figure 2-9: AceManager : Write Click the Clear button. Figure 2-10: AceManager : Clear Click the Disconnect button.  Figure 2-11: AceManager : Disconnect Press the modem Reset button on the front of the  modem. ...
  • Page 135 Raven iDEN Figure 2-12: Raven: Reset Wait until the modem REG indicator is lit and then  proceed to the next step.  8. Configure the Raven using a AceManager template. Caution: Do not proceed to this step before the REG indicator light is lit.  Click the Refresh All button on the tool bar of  AceManager and wait until all of the modem infor‐ mation is loaded into the AceManager application. Figure 2-13: AceManager : Refresh All  Click the Load button on the tool bar. ...
  • Page 136 Rev 3.0B Feb.08 Circuit Switch Communications Figure 2-15: AceManager : Template 9. Configure additional PassThru settings. On the left, under the GROUPS heading, select  PassThru.  Figure 2-16: AceManager : PassThru  For *PTREFRESH, enter a value of 15. For *RESETPERIOD, enter a value of 6. 10. Save the configuration settings. Click the Write button on the tool bar of AceManager and wait  for the message “Write Successful” to appear in the status bar.
  • Page 137 Make any appropriate changes to the serial port  parameters to match your equipment. These changes  are made under the group Serial.  Caution: Do not under any circumstances change the *MODEMHISPEED setting from the template configuration, the only recommended setting to change is the S23 setting. Follow the directions above to Write the changes to the  modem.  12. Reset the Raven. Click the Disconnect button.  Press the modem Reset button on the front of the  modem.  Wait until the modem REG indicator is lit.  Disconnect the Raven from your computer. 13. Test the Raven Configuration.
  • Page 138 Rev 3.0B Feb.08 Circuit Switch Communications Figure 2-17: HyperTerminal Enter the command: AT+WVCLASS?. Confirm  that a response of ʺ+WVCLASS: 9ʺ is returned.  Enter the command: ATS0?. Confirm that a  response of ʺ001ʺ is returned.  Dial the Raven modem telephone number from a land  line and verify that the modem automatically answers  the call with modem tones.  Verify outgoing calls. Connect the modem to your computer with a  serial cable. Using a terminal emulation program  (HyperTerminal) set up for 9600bps, 8 data bits, no  parity and 1 stop bit.  Enter the command:  [phone number], enter a known phone number  including the area code for which you can hear  ring (such as your office phone).    14. Commission the Raven Modem on Site. The following steps represent a guideline and makes assump‐ tions that the modem has been verified previously in a  controlled environment.  Install the Raven modem verifying that all power and  antenna cables are correctly secured. . For the  ATD[phone number]...
  • Page 139 Raven iDEN Verify that the Raven modem powers up and that the  Chan, Link and Reg lights blink in unison. Connect the Raven modem to the laptop computer via  a straight through RS232 cable or connect the serial  cable from the modem to a USB to serial device that  has been previously installed on the laptop. Remove the connection to the Laptop PC and connect  your equipment to the Raven Modem. Have the actual application call your equipment via  the modem telephone number and verify communica‐ tions. 20070914...
  • Page 140: Windows Dial-Up Networking (Dun)

    Caution: To install any driver on your computer, you may need to be logged in as Administrator or have Administrator privileges for your login. Microsoft Windows XP is used in the examples below. The  modem driver installation and DUN setup and configuration  is similar in Microsoft Windows products. Examples are not  provided here for installing the driver or configuring DUN for  any other operating system.  Installing a modem driver for Raven Standard installations of Microsoft Windows XP and 2000  include a generic modem driver which will work with your  Raven.  1. Connect the Raven.  Connect the modem to the computer with a DB‐9  cable or the USB port in serial mode. . ...
  • Page 141 Rev 3.0B Feb.08 Windows Dial-up Networking (DUN) Figure 3-1: Phone and Modem Options Select the Modems tab.  Figure 3-2: Phone and Modem Options: Modems Select Add.
  • Page 142 Rev 3.0B Feb.08 Windows Dial-up Networking (DUN) Figure 3-3: Add Hardware Wizard Check Don’t detect my modem; I will select it from a list. Select Next. Figure 3-4: Add Hardware Wizard: Install New Modem Select (Standard Modem Types) from the Manufacturers  column. Select Standard 33600 bps Modem from the Models  column.
  • Page 143 Rev 3.0B Feb.08 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. Select Next.  Figure 3-5: Add Hardware Wizard: Select Ports Check Selected Ports...
  • Page 144 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 Highlight the modem and select Properties.  Figure 3-8: Modem Properties Rev 3.0B Feb.08...
  • Page 145: Creating A Dial-Up Networking (Ppp) Connection

    Figure 3-9: Modem Properties: Modem Maximum Port Speed should be set to 115200  (default).  Select OK to exit.  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. Note: No other device or program can be using the same COM port (serial port) configured for the modem driver.
  • Page 146 Rev 3.0B Feb.08 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.
  • Page 147 Rev 3.0B Feb.08 Windows Dial-up Networking (DUN) Select Create a New Connection under Network Tasks in  the menu area on the left.  Figure 3-11: Create New Connection Select Next to start installing and configuring the DUN  connection.  Figure 3-12: New Connection Wizard  Select Connect to the Internet. Select Next. ...
  • Page 148 Rev 3.0B Feb.08 Windows Dial-up Networking (DUN) Figure 3-13: New Connection: Type Select Set up my connection manually. Select Next.  Figure 3-14: New Connection: How do you want to connect? Select Connect using a dial‐up modem. Select Next.  Figure 3-15: New Connection: Connect using... 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.  Check Standard 33600 bps Modem. Select Next. ...
  • Page 149 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), or any other desig- nation for the connection.
  • Page 150 Rev 3.0B Feb.08 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).  If you want to allow others to use the same login for  the modem, select Use this account name and password... Select Next. Figure 3-20: New Connection: Connection Information Caution: If you have a LAN connection to the Internet and select Make this the default Internet Connection for the DUN configuration,...
  • Page 151 Rev 3.0B Feb.08 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.  Select Properties.  Figure 3-22: DUN Connection Uncheck Use dialing rules. ...
  • Page 152 Rev 3.0B Feb.08 Windows Dial-up Networking (DUN) Check Show icon...when connected. Select Configure, below the Connect using line. Figure 3-23: DUN Properties Select 115200 as the Maximum speed.  Check Enable hardware flow control.  Do not check any other option.  Select OK. ...
  • Page 153 Rev 3.0B Feb.08 Windows Dial-up Networking (DUN) Figure 3-24: Modem Configuration Back at the main properties screen, select the  Networking tab. Figure 3-25: Networking Select Settings. Remove the checks from all three PPP settings.  Select OK. ...
  • Page 154 Rev 3.0B Feb.08 Windows Dial-up Networking (DUN) Figure 3-26: PPP Settings 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. Select Advanced.  Figure 3-27: TCP/IP Properties Uncheck Use IP header compression.  Check Use default gateway on remote network. Select OK.
  • Page 155: Connecting To The Internet Using Dun

    Note: The direct DUN connection features of AceView are not available in Windows 98 or Windows NT. Rev 3.0B Feb.08 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.
  • Page 156: Windows Dun

    Select Connection Settings.  Figure 3-30: AceView: Connection Settings Select Auto Start in the DUN section.  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.  Tip: When using the DUN connection, make sure the IP Address is set to the local IP address of the modem, 192.168.13.31 by default. Select OK.  OK. Windows DUN You can directly use the Dial‐up link for the DUN connection.
  • Page 157 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. When you’re connected, an icon should appear in the system ...
  • Page 158 Windows Dial-up Networking (DUN) Caution: For DUN connections on a Windows Mobility or other non- personal 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 3.0B Feb.08...

This manual is also suitable for:

Raven idenTelus

Table of Contents