AceManager User Guide 20070914 Rev 3.
Preface Important Notice Due to the nature of wireless communications, transmission and reception of data can never be guaranteed. Data may be delayed, corrupted (i.e., have errors) or be totally lost.
Preface DIRECT, INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS OR REVENUE OR ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE USE OR INABILITY TO USE ANY SIERRA WIRELESS PRODUCT, EVEN IF SIERRA WIRELESS AND/OR ITS AFFILIATES HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY.
Preface Contact Information Support Desk: Phone: 1-877-231-1144 Hours: 5:00 AM to 5:00 PM Pacific Time, Monday to Friday, except US Holidays E-mail: support@sierrawireless.com Sales Desk: Phone: 1-510-781-4200 1-604-232-1488 Hours: 8:00 AM to 5:00 PM Pacific Time E-mail: MobileandM2Msales@sierrawireless.com Post: Sierra Wireless AirLink Solutions 3159 Corporate Place Hayward, CA USA 94545 Sierra Wireless 13811 Wireless Way Richmond, BC Canada V6V 3A4 Fax: 1-510-781-4299 1-604-231-1109 Web: www.
Contents AceManager and Sierra Wireless AirLink Modems . . . . . . . . . . . . . . . . . . . . . .7 ALEOS™ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Installing and Running AceManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Configuration Panel . . . . . . . . . . . . . . . . . .
Ace Manager Information (Info)Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 *DEVICEID? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 *NETPHONE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Common Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 Misc (Miscellaneous) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 OPRG=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 S53=[method][d.d.d.d][/ppppp] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ace Manager *SMTPFROM=email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . *SMTPPW=pw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . *SMTPSUBJ=subject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . *SMTPUSER=user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents PinPoint Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49 DTRI=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 RTSI=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 #IG=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 *MF=hh . . . . . . . . . . . . . . .
Ace Manager Telemetry and Addr List Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57 IPL=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 MVLEN=n. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 MVMSK=hh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 MVOFF=n. . . . . . . . . . . . . . . . . . . . . . . . .
1: AceManager and Sierra Wireless AirLink Modems • ALEOS™ • Installing and Running AceManager • Menus 1 AceManager provides a graphical user interface to the configu‐ ration options of Sierra Wireless AirLink modems. With AceManager, you don’t need a terminal connection or to remember AT commands and their parameters or even which commands are applicable to which modem model.
Ace Manager • Packet Level Diagnostics • Device Management & Control • Protocol Spoofing Figure 1-1: Powered by ALEOS Installing and Running AceManager AceManager is available for free from AirLink and can be downloaded from http://www.sierrawireless.com/support/ AirLink/Wireless_Ace.aspx. Once the application is installed, you can run it from your Start menu or from the icon on the desktop. 1.
AceManager and Sierra Wireless AirLink Modems Configuration Panel The icon menu across the top is the Configuration Panel with smaller text menu of additional options above. Figure 1-2: Configuration Panel The chapter layout of this guide corresponds to the main group tabs: • Info and Status • PinPoint • Common • I/O • Logging • Telemetry and Address List • Cellular Technology (CDMA, EV‐DO, HSDPA, EDGE/GPRS, etc.
Ace Manager Figure 1-3: Groups • The first column of the display for each tab is the AT Command. • The second column of the display is the name of the command. • The third column of the display is the current value in the modem. • The last column is where you would enter the new value for the modem’s configuration. Some commands can be changed with a value typed into the New Value column. Other commands, those with specific parameters, offer a drop down menu for in the New Value column.
2: Connecting to an AirLink Modem with AceManager • • • • • • 2 Using UDP Using TCP Using SMS Using PPP Using Ethernet Connecting One of the first things you will generally want to do after starting AceManager is connect to a modem. Click the Connect icon in the Configuration Panel to open the connection options dialogue box. You can also use Connect from the Modem menu option.
Ace Manager Tip: If you want to connect to your modem remotely, you will need to make sure your computer can access the cellular network to which you modem is connected. To test if you can reach the modem you can Ping the IP or fully qualified domain name of the modem (i.e. if you are using IP Manager). Ping is a command used from your computer.
Connecting to an AirLink Modem with AceManager Figure 2-3: UDP Using TCP If your modem is not connected to your computer directly, you can use this option to connect remotely through your cellular service. Type in the IP Address or domain name of your modem and enter the password. If you have used AceManager before, you can select a previously used IP or name from the drop down menu.
Ace Manager Using SMS If your modem is not connected to your computer directly, you can access it remotely using the Simple Message protocol (SMS) through your cellular service using a valid email account on your computer. Select your cellular carrier from the list and type in your modem’s phone number (MDN) and password. If you have used AceManager before, you can select a previously used phone number from the drop down menu or type in a new one. Note: .
Connecting to an AirLink Modem with AceManager Figure 2-6: Tools > Options Figure 2-7: SMS: SMTP Configuration To set up the SMS Access, you will need to know the SMTP or email settings for your own email account. You may be able to find many of these settings in your email application (such as Outlook or Outlook Express) or from your Network Adminis‐ trator or ISP. Note: The “optional” fields are not required by all mail servers; however they may be required for the one you are using.
Ace Manager The username and password are the user name and password you use to get or send email. This might also be the same password you need to use to log on to the Internet or your local network. For some ISPs or networks, you may not need a password to use the SMTP server for SMS. The Host IP is the IP of the computer you are using to contact the modem. This is for return messages and modem may be able to determine it without the need to set it specifically.
Connecting to an AirLink Modem with AceManager Using Ethernet If your modem is connected to the same Local Area Network (LAN) as your computer, such as in an office with many computers and other devices connected together by hubs and/ or switches, you can use this option to connect to the modem. When you select this option, AceManager will attempt to find the modem by scanning the LAN so you don’t need to know the IP of the modem. Enter the password after the modem is “discovered”.
Ace Manager existing configuration information have been downloaded from the modem. When the modem is connected, the status bar will become blank and the page for the Info group will be displayed.
3: Configuration Panel and Top Menu 3 • Refresh and Refresh All • Write • Reset • Change Password, Reset Password • Disconnect • Load, Save, Copy • Clear • Update PRL • Printable view • Auto Refresh • Help The Configuration Panel, the row of icons at the top of the interface and menu across the top, has basic options which are available for all modem types.
Ace Manager Write To save any changed values, click the Write button. This will write any parameters entered in the New Value fields of all tabs into the modem configuration, not just the tab or page you are currently viewing. You can also use Write from the Modem menu option. Reset Reset will restart the modem. The other ways to reset the modem are by pressing the reset button on the front of the modem or removing the power from the modem.
Configuration Panel and Top Menu Reset Password Reset Password, while you are connected to the modem, will reset the password to the default: 12345. If, however, you are not connected to a modem, you can use Reset Password to obtain daily password in order to access a modem for which you have forgotten the password. When you select Reset Password while not connected to a modem, you will be shown a challenge code. You need to contact SierraWireless Support, either by phone or email.
Ace Manager Load, Save, Copy You can save the values currently present in your modem to a Template. The template is an XML file. You can use the template to save current values before making changes or use the saved settings from one modem to import to into another. With Copy, all of the values currently configured in the modem are copied into the New Value fields allowing all the current values to be saved to a template. All tabs will be copied, not just the one currently in view.
Configuration Panel and Top Menu Tip: AceManager templates can also be used with Ace Net to configure several modems at the same time. Ace Net is a separate application available from your Airlink representative. Figure 3-5: AceNet: Load Template Load Template, Save Template, and Copy All are also options from the Template menu option. Clear Clear will remove all values from the New Value fields. All tabs will be cleared, not just the one currently in view.
Ace Manager Figure 3-6: Update PRL If the PRL version to apply is displayed as ONLINE, the PRL will be updated Over‐the‐Air (OTA) directly from the carrier. Not all carriers support OTA PRL Updates. Otherwise, the PRL will be updated to the one present in the “PRL” folder of the AceManager installed folder (i.e. C:\Program Files\AirLink\AceManager\PRL). You can also use Update PRL from the Modem menu option.
4: Information (Info)Group 4 The commands in the “Info” group have read‐only param‐ eters. They only provide information about the modem. The commands displayed in AceManager and the results of those commands depends on the model of the modem. Some of the information displayed in this group does not correspond directly to AT commands. Figure 4-1: AceManager : Info *DEVICEID? The 64‐bit device ID the modem uses to identify itself to the cellular network.
Ace Manager Information Displayed in AceManager without AT Commands Listed • 26 Versions of ALEOS, internal hardware, boot, and MSCI: Versions of internally configured hardware and software.
5: Status Group 5 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 5-1: AceManager : Status *BOARDTEMP? The temperature, in Celsius, of the internal hardware. *HOSTMODE? The current host mode (AT, PPP, UDP, etc.).
Ace Manager *NETIP? Note: If there is no current network IP address, 0.0.0.0 may be displayed. The current IP address of the modem reported by the internal module, generally obtained from your cellular carrier. This is the address can contact the modem from the Internet. Tip: Use *NETALLOWZEROIP if you need to allow the display of an IP ending in a zero. *NETOP? The current cellular carrier from the modemʹs firmware version, for example, Sprint, Verizon, AT&T, TELUS, Bell Mobility, etc.
Status Group • Hardware Reset: The internal module is being reset. This is a temporary state. *PRLSTATUS? The status of the most recent PRL Update. CDMA or EV‐DO Only. • 0 : None • 1 : In Progress • 2 : Success • Any other value : Failure +HWTEMP? Displays the internal temperature of the radio module in degrees Centigrade. 1x and EV‐DO Only. +ICCID Subscriber Identity Module ID. GPRS or EDGE Only. +PRL? Preferred Roaming List (PRL) version. CDMA or EV‐DO Only. +RCIQ Current Cell Info Information.
Ace Manager • Temperature of the Internal Hardware Module: The temperature of the internal radio module. • GPS information: Number of satellites, GPS Fix (0 = No Fix, 1 = GPS Fix, 2 = WAAS), latitude, and longitude. GPS Status and Map Link (PinPoint line modems only) Note: The map feature will only work if you have access to the Internet on your computer either through the modem or separate from the modem.
6: Common Group 6 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 6-1: AceManager : Misc OPRG=n Enables/disables over‐the‐air firmware upgrading of the your modem. When Sierra Wireless releases a new version of ALEOS, you can upgrade your remote modems with OPRG enabled.
Ace Manager 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. Z Reset the your modem. 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.
Common Group *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. • *NETUID=uid The login that is used to login to the cellular network, when required. • uid=user id (up to 64 bytes) *STATICIP=d.d.d.
Ace Manager DNS This group includes commands specific to the modem being able to use domain names instead of IP addresses for other configuration options. Figure 6-2: 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.
Common Group Figure 6-3: AceManager : Dynamic IP *DOMAIN=name Domain (or domain zone) of which the your modem 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.
Ace Manager • n=2 : Second IP Manager server. • key=128‐bit key in hexadecimal [32 hex characters] *IPMGRUPDATEn=m Sets the number of minutes to periodically send an IP update notification to the corresponding server. This will occur even if the IP address of the your modem doesnʹt change. *IPMGRUPDATE1 is used to set the refresh rate to *IPMANAGER1, while *IPMGRUPDATE2 is used with *IPMANAGER2. If the value is set to 0, then periodic updates will not be issued (i.e.
Common Group Figure 6-4: AceManager : PPP/Ethernet • *HOSTAUTH=n Host Authentication Mode: Use PAP or CHAP to request the user login and password during PPP or CHAP negotiation on the host connection. The username and password set in *HOSTUID and *HOSTPW will be used. • n=0 : Disable PAP or CHAP request (Default). • n=1 : PAP and CHAP. • n=2 : CHAP *HOSTNETMASK=n.n.n.n Subnet mask for the host interface. Allows communication with a subnet behind the host interface. • n.n.n.
Ace Manager *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).
Common Group • 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.
Ace Manager Figure 6-6: AceManager : SMTP *SMTPADDR=[d.d.d.d][name] Specify the IP address or Fully Qualified Domain Name (FQDN) of the SMTP server to use. • d.d.d.d=IP Address • name=domain name (maximum: 40 characters). *SMTPFROM=email Sets the email address from which the SMTP message is being sent. • email=email address (maximum: 30 characters). *SMTPPW=pw Sets the password to use when authenticating the email account (*SMTPFROM) with the server (*SMTPADDR).
Common Group Remarque : Other Figure 6-7: AceManager : Other DAE=n AT Escape Sequence detection. • n=0 : Enable • n=1 : Disable *DATZ=n Enables or disables reset on ATZ. • n=0 : Normal Reset (Default). • n=1 : Disable Reset on ATZ. *IPPING=n Set the period to ping (if no valid packets have been received) a specified address (*IPPINGADDR) to keep the modem alive (online).
Ace Manager *IPPINGADDR=[d.d.d.d][name] Set the IP address or valid internet domain name for the your modem to ping to keep itself alive (online). *IPPING must to be set to a value other than 0 to enable pinging. • d.d.d.d=IP address • name=domain name *MSCIUPDADDR=name[/port] Modem Status Update Address ‐ where Name/Port is the domain name and port of the machine where the modem status updates will be sent. The status parameters of the your modem are sent in an XML format.
Common Group • 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.
Ace Manager Tip: Many networks have the ports below 1024 blocked. It is recommended to use a higher numbered port. *TQUIT Disconnects the telnet session. Not available in AceManager.. Friends Friends Mode can limit access to the your modem from the cellular network and the Internet. Friends mode is a basic firewall. Caution: If you are using Friends Mode you will not be able to use AceManager remotely or Telnet to the modem unless you are contacting the modem from one of the configured IP addresses.
Common Group Fn=[d.d.d.d] Friends mode IP address. • n=0‐9 Friends list index • d.d.d.d = IP address Using 255 in the IP address will allow any number. Example: 166.129.2.255 allows access by all IPs in the range 166.129.2.0‐166.129.2.255. Tip: ATF? will return a list of all the current Fn settings. Rev 3.0C Apr.
Ace Manager 46 20070914
7: Logging 7 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 7-1: AceManager : Logging *DBGCOMMLVL=n Set the logging level for the host or module COM port. • n=0 : No logging • n=1 : Host COM Port • n=2 : Module COM Port *DBGIPLVL=n Sets the logging level for the IP subsystem. • n=0 : No logging • n=1 : Log errors (i.e. invalid/corrupt packets, etc.
Ace Manager 48 20070914
8: PinPoint Group 8 This group includes commands specific to GPS features and the PinPoint modem line. If you are not connecting to a modem of the PinPoint line, you will not see this group in the menu. Figure 8-1: AceManager : PinPoint DTRI=n Enable monitoring the DTR signal as in input event. PinPoint and PinPoint‐E only. • n=0 : Disable DTR input monitoring. • n=1 : Enable DTR input monitoring. Caution: If DTR is used as an input, DTR cannot be used for lowpower control.
Ace Manager Caution: If RTS is used as an input, hardware flow control cannot be enabled. #IG=n Time in seconds to wait for GPS acquisition before trans‐ mitting at high rates. • n=seconds *MF=hh Set or query GPS format, where hh is a hex value; 8E (transmit Latitude/Longitude/Direction/Velocity/Time in binary) or 8F. *MF is support for legacy GPS reports which are rarely used by current tracking applications. • hh=hex value *PGPS=n Send NMEA GPS strings out serial link.
PinPoint Group *PPDIST=n GPS Report Distance Interval in 100 Meter Units (kilometer). 1 mile is approximately 1600 kilometers. • n=0 : Disabled • n=1‐65535 *PPFLUSHONEVT=n Flushes store and forward buffer when an input event (DTR/ RTS) occurs. • n=0 : Disable • n=1 : Enable *PPGPSDATUM=n Specifies the GPS datum to use for position reports. For accurate results, this value should match the datum used by receiving mapping application.
Ace Manager *PPIGNOREIP=n When enabled, ignore ATS Server IP (*PPIP) updates in RAP. • n=0 : Use ATS Server IP updates. • n=1 : Ignore ATS Server IP updates. *PPINPUTEVT=n Enable sending input changes as events (different report types). • n=0 : Disable • n=1 : Enable *PPIP=d.d.d.d IP address where GPS reports are sent (ATS Server IP). Also see *PPPORT. • d.d.d.d=IP address Example: AT*PPIP=192.100.100.
PinPoint Group • n=0x13 : Standard GPS Report + UTC Date + RF data • n=0xE0 : GGA and VTG NMEA reports • n=0xE1 : GGA, VTG and RMC NMEA reports • n=0xF0 : TAIP reports • n=0xF1 : Compact TAIP data *PPMAXRETRIES=n Maximum number retries when in Simple Reliable Mode. PinPoint X only. • n=0 : Disabled • n=1‐255 retries *PPMINTIME=n Specifies the minimum amount of time between reports generated due to either the time interval (*PPTIME) or the distance interval (*PPDIST).
Ace Manager Note: If both AT*PPCOM1000=1 and AT*PPREPORTINPUTS=1 are enabled, the PinPoint X digital inputs will be reported and the COM1000 inputs will be ignored. *PPSNF=n Store and Forward will cause GPS reports to be stored up if the your modem goes out of network coverage. Once the vehicle is in coverage the GPS reports will be sent en masse to the server. • n=0 : Disabled • n=1 : Enabled (default) *PPSNFB=n Store and Forward Behavior.
PinPoint Group • nnnn=TAIP ID (4 characters) *PPTCPPOLL=n Specifies the port to listen on for TCP GPS report polling. The request to this port needs to come from the same IP address in *PPIP. • n=0 : Disabled • n=1‐65535 (default 9494) *PPTIME=n GPS Report Time Interval. See also *PPMINTIME, *PPTSV, +CTA. • Note: Your cellular carrier may impose a minimum transmit time. n=seconds (1 ‐ 65535) Caution: A report time of less than 30 seconds can possibly keep an RF link up continuously.
Ace Manager • n=1: Sent when out of cellular coverage Note: When set to 1, no reports are saved in SnF. *PGPSD PGPSD is a 16‐bit value that is the number of seconds to wait when ʺOut of Coverageʺ occurs before switching to, sending the messages out the serial port and not into SnF. Note: Any messages put into SnF during this switchover delay period will be sent OTA, when coverage is re-acquired.
9: Telemetry and Addr List Group 9 • 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. The Raven line modem User Guides explain in more detail how to use these telemetry related commands.
Ace Manager 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 MVTYP=n Modbus Variant Type: The data‐type of the RTU ID in a modbus‐variant protocol.
Telemetry and Addr List Group Addr List Figure 9-2: 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). Rev 3.
Ace Manager 60 20070914
10: I/O Group 10 This group includes configuration commands for the digital and analog inputs and relay outputs. Some of the values shown as a part of this group are not changeable but reflect the current status. Only those modems with available inputs and outputs will display this group. Figure 10-1: AceManager : I/O *ANALOGINn? Query individual analog inputs. The analog inputs report the voltage in volts. • n=1‐4 Input number *DIGITALINn? Query individual digital inputs.
Ace Manager 62 20070914
11: 1x/EV-DO Group 11 This group includes commands specific to 1x and EV‐DO. If you are not connecting to a modem which uses EV‐DO or 1x, you will not see this group in the menu. Figure 11-1: AceManager : 1x/EV-DO +CTA=n Inactivity timer, in seconds. Typical network settings cause a link to go dormant after 10 to 20 seconds of inactivity, no packets transmitted or received. This time can be shortened to release the physical RF link sooner when the application only transmits short bursts.
Ace Manager • n=2 : MIP only Note: Your account with your cellular carrier may not support Mobile IP. ~NAMLCK=nnnnnn The NAMLCK is the modemʹs 6‐digit OTSL (One Time Subsidy Lock), MSL (Master Subsidy Lock), or SPC (Service Provisioning Code). Your cellular carrier will provide the unlock code. • nnnnnn=6 digit unlock code Caution: If the number is accepted by the modem, the OK result code is returned. If the number is rejected, the ERROR result is returned.
12: HSDPA/EDGE/GPRS Group 12 This group includes commands specific to HSDPA, EDGE and GPRS. If you are not connecting to a modem which uses HSDPA, EDGE, or GPRS, you will not see this group in the menu. Figure 12-1: AceManager : EDGE/HSDPA *NETAPN=apn Easy entry of the APN. If left blank, the modem will attempt to use the default subscriber value as defined by the account. • apn=access point name +CGQMIN Minimum Acceptable Quality of Service Profile. Change should be at carrierʹs request.
Ace Manager 66 20070914
13: Modem Doctor • Running Modem Doctor • Download Diagnostics Data • Erase the Modem’s Non-Volatile Data • Put the Modem in SOS mode • Advanced SMS Settings 13 Modem Doctor is a diagnostic tool for AirLink modems. Modem Doctor is a small self‐contained application that doesn’t require installation. Running Modem Doctor You can download the latest version of Modem Doctor from the AirLink web site: http://www.sierrawireless.com/support/ AirLink/Modem_Doctor.aspx.
Ace Manager Caution: Some of the options of Modem Doctor can cause your modem to cease working with your carrier’s network. Download Diagnostics Data Modem Doctor will connect to the modem and download diagnostic data in a file which you can send to AirLink support to help them troubleshoot your problem. You can connect to the modem either remotely, across the Internet, or locally with the modem connected directly to your computer with a serial cable or Ethernet cable.
Modem Doctor Note: If it is the first time you’re using SMS to connect to a modem, you will need to configure your computer to send SMS messages to the modem using email. See “Advanced SMS Settings” on page 5. Boot: If your computer is connected directly to the modem with a serial cable, you can use this option to access the modem. Select the COM port to which the modem is connected. Select the baud rate to communicate with the modem (modem default: 115200).
Ace Manager Figure 13-6: Modem Reset button (PinPoint X, Raven X, Raven, and PinPointE shown Figure 13-7: Download When the download is complete, you will have the option of saving the file to your own hard drive and/or e‐mailing it directly to Sierra Wireless support. Figure 13-8: Data Options If you select E‐mail, you will be prompted to enter additional information. If you select Save to disk, you can change the location and file name if you select the button.
Modem Doctor Figure 13-9: E-mail Information • Name: Your name or the name of the person who is the primary contact for the modem. • Company: The company which owns the modem. • E‐Mail: Your e‐mail address or the e‐mail address of the primary contact. • Phone: Your phone number (or the phone number of the primary contact). In many cases, AirLink support will contact you (or the primary contact) directly to resolve the issue.
Ace Manager In some extreme circumstances, support technician will ask you to use this option to return the modem to it’s pre‐configu‐ ration factory settings. You must be able to connect your computer to the modem directly with either a serial cable or an Ethernet cable. Caution: You cannot use a USB connection to erase the Non-volatile data with the standard Modem Doctor. You will need Modem Doctor USB, covered below.
Modem Doctor 3. Press Erase. The modem will then reset. Note: If you erase the fatory defaults will be restored. USBnet is the factory default port. Figure 13-12: Modem Doctor: USB connection Put the Modem in SOS mode This option will return your modem to AT mode and reset the serial port to 115200, 8N1. This will allow you to connect to the modem using AceManager or any other direct serial communication. You only have one option to connect to the modem.
Ace Manager Advanced SMS Settings If you haven’t used SMS to connect to your modem with Modem Doctor before, you will need to set up email settings. Click Advanced after selecting SMS as the connection method. Figure 13-14: SMS Connect Figure 13-15: SMS Advanced Setting SMTP Server: This is the server to which you normally send your e‐mail. Your E‐mail Address: The e‐mail address you normally use. Your Public IP Addr: The Internet accessible IP address of your computer.
Modem Doctor Tip: You can find many of these settings in the e-mail application installed on your computer. Rev 3.0C Apr.
Ace Manager 76 20070914
