WWW.INFOPULSAS.LT / info@infopulsas.lt ALEOS 4.2.3 Configuration User Guide 20080616 Rev 2.
Preface Important Notice Safety and Hazards 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.
ALEOS 4.2.3 User Guide Patents Copyright Trademarks This product may contain technology developed by or for Sierra Wireless Inc. This product includes technology licensed from QUALCOMM® 3G. This product is manufactured or sold by Sierra Wireless Inc. or its affiliates under one or more patents licensed from InterDigital Group. © 2012 Sierra Wireless. All rights reserved. AirCard® and Watcher® are registered trademarks of Sierra Wireless.
Preface Revision History Revision number Release date Changes 1.x Q3: 2010 ALEOS 4.2 Configuration User Guide created and edited. 1.0 D March 2011 ALEOS 4.2 Configuration User Guide released. 2.0 A April 2011 ALEOS 4.2 Configuration User Guide updated. 2.1 June 2011 ALEOS 4.2 Configuration User Guide updated and released as version 4.2.1. 2.2 September 2011 ALEOS 4.2.1 Configuration User Guide updated and released as version 4.2.2. 2.3 February 2012 ALEOS 4.2.
ALEOS 4.2.
Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 About Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Tools and Reference Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Configuring the AirLink Device . . . . . . . . . . . . . . . . .
Contents WAN/Cellular Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41 Keepalive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Data Usage Using Keepalive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Re-Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48 LAN Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Port Forwarding and DMZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Port Filtering - Inbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Port Filtering - Outbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Trusted IPs - Inbound (Friends) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Trusted IPs - Outbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ALEOS 4.2.3 User Guide GPS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 GPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 GPS Overview {Eliminate? Too Generic?} . . . . . . . . . . . . . . . . . . . . . . 119 AirLink Device Supported Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Remote Access Protocol (RAP) . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Application Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Data Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Garmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 I/O Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 Current State . . . . . . . . . . . . . . . . . . . .
ALEOS 4.2.3 User Guide SNMP Traps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 SNMP MIB Definition Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 Global Positioning System (GPS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 GPS Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 AirLink Device Supported Protocols . . . . . . . . . . . . . . . . . . . .
Contents NMEA Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Messages Over-The-Air (Remote) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Local Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Streaming Messages (Local) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 Persistent Streaming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ALEOS 4.2.3 User Guide Common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 Misc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 USB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 Serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 TCP . . . . . . . . . . . . . . . . . .
1 1: Introduction Overview • Overview • About Documentation • Tools and Reference Documents ACEmanager™ is the free utility used to manage and configure the AirLink device. It is a web application integrated in the ALEOS firmware. ACEmanager™ provides comprehensive configuration and control functionality to all AirLink gateways and routers.
ALEOS 4.2.3 User Guide No.
Introduction Tools and Reference Documents Document AirLink Device User Guide Description This is the hardware document that describes how to: • Install the AirLink device hardware • Connect the radio antennas • Connect a notebook computer and other input/output (I/O) devices • Install the software • Interpret the LEDs and indicators on the AirLink device.
ALEOS 4.2.
2 2: Configuring the AirLink Device • • • • Main Menu Tabs Configuring Operation Modes Creating a Template • Applying a Template After powering on the AirLink device, and ensuring that you have an IP-based connection set up (Ethernet or USB/net), you can log on to ACEmanager. In your browser, either enter http://192.168.13.31:9191 or another IP address depending on the interface you select. (See table below.) Note: The connected device for Ethernet is not always .100.
ALEOS 4.2.3 User Guide Main Menu Tabs The main menu for ACEmanager, across the top of the display, is as follows: • Firmware: Upgrades the firmware • Upload: Loads configured information, in the form of a template, to the device • Download: Saves and copies checked configuration to create a template. If none of the fields are checked, all fields are selected and saved automatically • Reboot: Reboots the device • Refresh All: Refreshes all the pages.
Configuring the AirLink Device AT Mode Using a terminal connection, AT commands can be used to configure the device, command it to do something, or query a setting. ACEmanager is a graphical user interface for most AT Commands and includes other parameters without AT counterparts. • AT commands must always be terminated by a carriage return (ASCII character 0x0D), i.e., pressing enter on the keyboard. Some may also include a new line or line feed .
ALEOS 4.2.3 User Guide Telnet/SSH Mode In ACEmanager you can configure Telnet operation. If you need to change the port for Telnet (for example, you have the default port blocked on your firewall), the option is on the Services-Telnet tab. The default telnet port is 2332. You can also change the Telnet timeout; if the connection is idle, default timeout is 2 minutes. This is the internal telnet on the modem to pass AT commands and not TCP pad.
Configuring the AirLink Device Creating a Template If you have a device configuration that works well for your needs, you can use ACEmanager to save that device’s configuration as a template and then apply it to other Sierra Wireless AirLink devices. Templates can be created as either feature-specific or for all configurable features. Feature-specific templates are quicker and more reliable to apply from one device to another.
ALEOS 4.2.3 User Guide Figure 2-4: ACEmanager: File Download Box 5. Click on Save (or OK depending on your system browser). Note: Some of the configuration settings are specific to individual devices. Avoid having those settings in your saved template as the devices you configure with the template could cease to work with the cellular or local network. A feature specific template allows you to omit configuration elements which need to be specific to a device. 6.
Configuring the AirLink Device Figure 2-6: ACEmanager: Select and Upload Template 4. Click on Upload File to Modem. 5. Click on Load Template. As in the template creation process, there will be a time delay as the template downloads. Tip: After you load the template, it’s best to go back over the ACEmanager tabs to make sure all the settings are what you require. Red asterisks (*) will display on the tabs that have been changed. Make any adjustments to the settings as needed. 6.
ALEOS 4.2.3 User Guide Tip: Use the common settings on one device to configure those same settings on another device. For example, use the serial settings of one device to configure the serial settings of another device.
3 3: Status • • • • • • • • • • Home WAN/Cellular LAN VPN Security Services GPS Serial Applications About The Status tab that displays in ACEmanager is applicable to all Sierra Wireless AirLink devices. All of the fields in the “Status” group have read-only parameters and provide information about the AirLink Device. Depending on the individual settings and the onboard cellular module of the AirLink Device, the actual status pages may look different than the screenshots listed here.
ALEOS 4.2.3 User Guide Figure 3-2: ACEmanager: Status - Home - GSM Status Field Description Phone Number The phone number (programmed into the device) associated with the carrier account. IP Address The current IP address of the device reported by the internal module, generally obtained from your carrier. This is the address you can use to contact the AirLink device from the Internet if you have a mobile terminated or Internet accessible account.
Status WAN/Cellular WAN/Cellular status provides specific information about the cellular connection including IP address and how much data has been transmitted or received. Some of the information on this page is repeated on the Home page for quick reference. Figure 3-3: ACEmanager: Status - WAN/Cellular - CDMA Status Field Description Cellular IP Address Cellular WAN IP Address. ESN/EID/IMEI Electronic Serial Number for the internal radio.
ALEOS 4.2.3 User Guide Status Field Description Bytes Received Number of bytes received from the network since system startup or reboot. Packets Sent Number of packets sent to the network since system startup or reboot. Packets Received Number of packets received from the network since system startup or reboot. Figure 3-4: ACEmanager: Status - WAN/Cellular - GSM Status Field Description Cellular IP Address Provides the cellular WAN IP Address.
Status Status Field Description DNS Server 1 1st DNS server IP address currently in use by the Network connection to resolve domain names into IP addresses. DNS Server 2 2nd DNS server IP address. Current WAN Time in Use (mins) Provides the time (in minutes) that the WAN has been in use. Bytes Sent Number of bytes sent to the cellular network, since the system startup. Bytes Received Number of bytes received from the network, since system startup.
ALEOS 4.2.3 User Guide LAN This is the status of the local network. It lists information about the network and connected clients. Figure 3-5: ACEmanager: Status - LAN Status Field Description USB Mode Indicates which mode of the USB port is set: USBnet or USB serial. Connected Clients Displays the number of connected clients. LAN IP Packets Sent Number of IP packets sent to the host interface since the system startup.
Status VPN The VPN section gives an overview of the VPN settings and indicates whether a VPN connection has been made. Figure 3-6: ACEmanager: Status - VPN Status Field Description Incoming out of band Indicates whether incoming out of band traffic is allowed or blocked. Outgoing out of band Indicates whether outgoing ALEOS out of band traffic is allowed or blocked. Outgoing Host out of band Indicates whether Outgoing Host out of band traffic is allowed or blocked.
ALEOS 4.2.3 User Guide Security The security section provides an overview of the security settings on the AirLink device. Figure 3-7: ACEmanager: Status - Security Status Field Description DMZ Options: Automatic, Manual, or Disabled. DMZ defines a single LAN connected device where all unsolicited data should be routed. Port Forwarding Options: Enabled or Disabled. Show status of port forwarding. Port Filtering Inbound Options: Allowed Ports, Blocked Ports, or Not Used.
Status Services This section shows the status of AirLink services, including the ACEmanager access level. Figure 3-8: ACEmanager: Status - Services Status Field Description AMS Indicates the status of the connection to the AirLink Management Service. This field is blank if the AMS configuration is disabled. ACEmanager The ACEmanager access mode. Options are Tethered Host and OTA or Tethered Host Only. Dynamic DNS Service Indicates the service in use for Dynamic DNS translation.
ALEOS 4.2.3 User Guide GPS The GPS (Global Positioning System) tab provides AirLink device location and movement information for use with tracking applications. Figure 3-9: ACEmanager: Status - GPS Status Field Description GPS Fix 0 = No Fix, 1 = GPS Fix, 2 = WAAS Satellite Count Displays how many satellites the GPS receiver detects. Latitude Latitude of the GPS receiver. Longitude Longitude of the GPS receiver. Heading The direction in which the AirLink device is moving.
Status Serial Note: The Serial section that displays in ACEmanager is applicable to all Sierra Wireless AirLink devices. Figure 3-10: ACEmanager: Status - Serial Status Field Description Serial Reserved by External Application Indicates whether the serial port has been reserved by an external application. Serial Port Mode Default power-up mode for the serial port: When the AirLink device is power-cycled, the serial port enters the mode specified by this command after 5 seconds.
ALEOS 4.2.3 User Guide Applications The Application section of the Status group provides information on the status of the Garmin device and data service. Figure 3-11: ACEmanager: Status- Applications Status Field Description Garmin Status The state of the connection to the Garmin device when it is enabled. This field is blank when the Garmin device is disabled. Data Service The Data Service field displays “Available (under usage limit)” if the configured usage limit has not been exceeded.
Status Figure 3-13: ACEmanager: Status - About - GSM Status Field Description Device Model Indicates the model of the device (e.g., GX400). Radio Module Type MC5728 or MC8705. The model number of the internal cellular radio module. Radio Firmware Version Displays the firmware version in the radio module. Global ID The device ID used by ALEOS 4.2 to identify itself for various management applications. GPS/RAP Device ID Displays the device ID of GPS/RAP.
ALEOS 4.2.
4 4: WAN/Cellular Configuration The WAN/Cellular tab that displays in ACEmanager is applicable across all Sierra Wireless AirLink GX400/440 devices. The WAN/Cellular section allows changes to the cellular connection and main operating mode of the AirLink device. Figure 4-1: ACEmanager: WAN/Cellular - Network Credentials 1x/EV-DO Rev 2.3 Feb.
ALEOS 4.2.
WAN/Cellular Configuration CarrierType Command Description Network Credentials - 1xEVDO, GSM, and LTE 1x/EV-DO Dormancy Idle Timer (secs) Inactivity timer, in seconds. Typical network settings cause a link to go dormant after 10 to 20 seconds of inactivity with no packets transmitted or received. This time can be shortened to release the physical RF link sooner when the application only transmits short bursts. • n=0: Allows the cellular network to determine the inactivity timer.
ALEOS 4.2.3 User Guide CarrierType Command Description HSPA/ GPRS Select From List If the APN type is “Select from List,” a list of APNs based on the SIM in use will be available as a drop-down list. HSPA/ GPRS Rx Diversity Allows two antennas to provide a more consistent connection. Options: • Disable Enable (default) If you are not using a diversity antenna, diversity should be disabled. • HSPA/ GPRS SIM PIN Enter the SIM PIN.
WAN/Cellular Configuration CarrierType Command Description Advanced 1x/EV-DO and HSPA/ GPRS Response to Incoming Ping When a ping is received by the device from a remote location, the Response to Incoming Ping will redirect it to the selected location. • No response: the incoming ping will be completely ignored • ALEOS Responds (default): ALEOS will return to the Ping response.
ALEOS 4.2.3 User Guide CarrierType HSPA/ GPRS Command Set Carrier (Operator) Selection Description Manually specify an operator. (Refer also to *NETOP.) • mode= 0: Automatic - any affiliated carrier [default] • mode= 1: Manual - use only the operator specified. • mode= 4: Manual/Automatic - if manual selection fails, goes to automatic mode • format= 0: Alphanumeric ("name") (G3x10 must use this format) format= 2: Numeric.
WAN/Cellular Configuration 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 device that infrequently communicates to the network or if you have experienced issues over time where the device can no longer be reached remotely. When Keepalive pings the IP address, an acknowledgement indicates there is an active connection to the network.
ALEOS 4.2.3 User Guide Re-Activation The Re-Activation section of the WAN/Cellular tab only appears for EV-DO/1X devices. The Re-Activation feature can only be used when a particular device that has already been activated needs re-activation. If your device needs to be reactivated, click on the button labeled "Re-Activate Cellular Account". When you click on this button, the status will show the progress of the re-activation. Note: If the provision fails, an error message will display.
5 5: LAN Configuration • • • • • • • • DHCP/Addressing Ethernet USB Host Port Routing Global DNS PPPOE VLAN VRRP The LAN tab that displays in ACEmanager is applicable across all Sierra Wireless AirLink devices. The primary purpose of the AirLink device is to route data from one or more devices connected to one or more of the ports to the cellular network and, ultimately, under most circumstances, to the Internet.
ALEOS 4.2.3 User Guide DHCP/Addressing This section is primarily a status display of the configurations with a few options which are global to all interface types. Interfaces which are enabled in the current configuration will be displayed with their configured settings. DHCP addresses and subnets are assigned to the physical LAN side interfaces display. When WiFi is bridged to Ethernet, Ethernet and WiFi are on the same subnet display.
LAN Configuration Field Description Interface The physical interface port or VLAN ID. Device IP The IP address of the AirLink device for the specified interface port.. By default, this is set to 192.168.13.31 for Ethernet/WiFi and 192.168.14.31 for USB/net. Subnet Mask The subnet mask indicates the range of host IP addresses which can be reached directly. Changing this will limit or expand the number of clients that can connect to the AirLink device. The default is 255.255.255.
ALEOS 4.2.3 User Guide Internal DHCP Server DHCP (Dynamic Host Configuration Protocol) has become a primary component of today’s network environments. DHCP allows one server to automatically and dynamically allocate network IP addresses and other network related settings (such as subnet masks, routers, etc.) to each computer or device without the need to set up each specifically or keep track of what addresses have already been used.
LAN Configuration Ethernet The AirLink device is equipped with an Ethernet port which can be enabled or disabled as needed. When the Ethernet port is disabled, no host can use the device on the Ethernet port with either a DHCP address or a statically assigned address. No ARP queries will receive a response on the Ethernet port. Figure 5-2: ACEmanager: LAN - Ethernet Field Description General Ethernet Port Enabled or disabled. Device IP The Ethernet IP address of the AirLink device.
ALEOS 4.2.3 User Guide USB The AirLink device is equipped with a USB port which increases the methods by which you can send and receive data from a connected computer. The USB port can be set to work as either a virtual Ethernet port or a virtual serial port, or be disabled to prevent access by USB. A driver installation is required to use the USB port in either mode. By default, the port is set to work as a virtual Ethernet port. Note: It is recommended that you use a USB 2.
LAN Configuration Field Description Host USB IP The IP for the computer or device connected to the USB port. USB Serial Echo Toggle AT command echo mode when the USB is configured for virtual serial. 0 = OFF; 1 = ON USBNET Internet Enabled (default) or Disabled. Advanced Link Radio Coverage to Interface This disables the specified port when there is no cellular coverage.
ALEOS 4.2.3 User Guide Figure 5-5: Hardware Wizard: Location options a. Select and/or enter the location of the driver. · If the driver is on the CD and the CD is in your drive, you can just select Search removable media. · If you have installed ACEmanager or the Setup Wizard, the drivers have been conveniently copied to your hard drive. Enter C:\Program Files\Common Files\AirLink as the location to search.
LAN Configuration Virtual Ethernet The USB Ethernet connection will show up in your Network Connections window as a Local Area Connection. Tip: If you also have an Ethernet card on the computer or have installed the USB Ethernet to more than one USB port on your computer, the USB Ethernet may show up with a number. Figure 5-9: Network Connections Note: By default, your Host IP for USB/net is 192.168.14.100. You can also verify the installation by looking in the Device Manager. a.
ALEOS 4.2.3 User Guide Figure 5-10: System Properties d. Click on the + in front of Network Adapters. The newly installed driver, AirLink USB Ethernet/RNDIS, should display. If the driver is displayed with a # and number behind the driver name (e.g., AirLink USB Ethernet/RNDIS #2), it means more than one is installed on your computer, most likely for a different USB port. More than one copy of the driver should not cause any problems since only the connected port and its driver would be active.
LAN Configuration Virtual Serial Verify the installation by looking in the Device Manager. a. Click on Start > Control Panel. b. Double-click on the System icon. c. Select the Hardware tab, and click the Device Manager button. Figure 5-12: System Properties d. Click on the + in front of devices. The newly installed driver, AirLink USB Serial Port, should display. Tip: If the driver is displayed with a number sign (#) and number behind the driver name (e.g.
ALEOS 4.2.3 User Guide Figure 5-13: Device Manager - Serial To connect to the device using the USB virtual serial, most applications or utilities will require you to select or enter the serial (COM) port number. The USB connection will appear as a standard serial port, so you will need to determine its number to connect to it. The driver installation will automatically assign a port, or you can change it if you wish to another unused port. a.
LAN Configuration Figure 5-15: Driver Properties c. At the bottom of the screen, the current port used will be listed. Use the drop down menu to select an available COM port number if you need to change it. Figure 5-16: Advanced Settings Note: The COM port number assigned by driver installation is the next port that is available.The port number might vary depending on the number of devices connected (using serial or virtual serial).
ALEOS 4.2.3 User Guide Host Port Routing The “Host Network” is the equivalent of the IP route command. Figure 5-17: ACEmanager: LAN - Host Port Routing Field Description Primary Gateway When enabled, your device is the Primary Gateway for the network behind a router connected to it. ALEOS responds to ARPs for all non-host Ethernet subnets. Host Network 2 and Host Network 3 Network to route to host interface connected to Ethernet.
LAN Configuration Global DNS When the cellular network grants the IP address to the device, it includes the IP addresses to its DNS servers. Global DNS allows you to override the carrier’s DNS settings for all connected devices. This is useful when the connected devices need to use a private network. Note: If there are no alternate DNS defined, the default is the cellular network DNS sever. Figure 5-18: ACEmanager: LAN - Global DNS Field Description Primary DNS Primary carrier DNS IP Address.
ALEOS 4.2.3 User Guide PPPOE PPPoE (Point-to-Point Protocol over Ethernet) allows a point-to-point connection while using Ethernet. Just like the dial up protocol on which it is based, PPPoE uses traditional user name and password authentication to establish a direct connection between two Ethernet devices on a network (e.g., your AirLink device and your computer or router). Application examples for PPPoE with your AirLink device: • Backup connectivity solution for your network.
LAN Configuration Field Host Authentication Mode Description 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. • NONE (Default) • PAP and CHAP • CHAP Host User ID Host User ID for PAP or CHAP. • user id (up to 64 bytes) Host Password Host Password for PAP or CHAP.
ALEOS 4.2.3 User Guide VLAN Figure 5-20: ACEmanager: LAN - VLAN Field Description Interface Displays three VLAN IDs. VLAN ID Displays the VLAN ID. Device IP The IP address of the AirLink device for that VLAN interface. Subnet Mask The subnet mask indicates the range of host IP addresses which can be reached directly. Changing this will limit or expand the number of clients that can connect to the AirLink device. Access Internet Choose access to the internet. Scroll down options: “Yes” or “No.
LAN Configuration VRRP VRRP (Virtual Router Redundancy Protocol) allows multiple routers to act as the default gateway router for a subnet, thereby reducing the possibility of a single point of failure. Figure 5-21: ACEmanager: LAN - VRRP Field VRRP Enabled Description Allows you to activate VRRP. Options: • Enable • Disable (default) VRRP Interface Displays Ethernet and three VLAN IDs. VLAN ID Displays the VLAN ID. Group ID Enter the VRRP Group ID.
ALEOS 4.2.
6 6: VPN Configuration • Split Tunnel • VPN 1 • VPN 2 to VPN 5 The VPN tab that displays in ACEmanager is applicable across all Sierra Wireless AirLink devices. The AirLink device acts as a Virtual Private Network (VPN) device, providing enterprise VPN access to any device connected to the AirLink device even when a device has no VPN client capability on its own. The AirLink device supports four types of VPN: IPsec, GRE, SSL, and L2TP+IPsec.
ALEOS 4.2.3 User Guide Split Tunnel The AirLink device supports Global settings with one encrypted tunnel and one open tunnel. A sample server subnet for a Global setting would be 172.16.1.0/24. Global settings VPNs should be set up with care, as a Global settings configuration with both an enterprise VPN and access to the public Internet can inadvertently expose company resources.
VPN Configuration VPN 1 The VPN 1 tunnel can be configured as IPsec, GRE, SSL, or L2TP+IPsec. Enabling any of these tunnels will expose other options for configuring the tunnel. Figure 6-2: ACEmanager: VPN - VPN 1 IPsec The IPsec architecture model includes the Sierra Wireless AirLink gateway as a remote gateway at one end communicating, through a VPN tunnel, with a VPN gateway at the other end. The remote gateway is connected to a Remote network and the VPN is connected to the Local network.
ALEOS 4.2.3 User Guide Figure 6-3: ACEmanager: VPN 1 - VPN - IPsec Tunnel Field VPN # Type Description Use this field to enable or disable the VPN # tunnel. If custom settings are used, they will be saved and the tunnel can be disabled and re-enabled without needing to reenter any of the settings. For a successful configuration, all settings for the VPN tunnel must be identical between the AirLink Device VPN and the enterprise VPN server.
VPN Configuration Field My Identity Type Description Options: • IP (default) - The My Identity - IP field displays with the WAN IP address assigned by the carrier • FQDN - The My Identity - FQDN field displays. Enter a fully qualified domain name (FQDN) e. g., modemname.domainname.com • User FQDN - The My Identity - FQDN field displays. Enter a User FQDN whose values should include a username (E.g., user@domain.com).
ALEOS 4.2.3 User Guide Field Description Remote Address Netmask Remote subnet mask information. 24-bit netmask. Default: 255.255.255.0 Perfect Forward Secrecy Provides additional security through a DH shared secret value. When this feature is enabled, one key cannot be derived from another. This ensures previous and subsequent encryption keys are secure even if one key is compromised. Options: Yes or No.
VPN Configuration Field Description VPN # Type Options: Tunnel Disabled or GRE Tunnel. Enabling the GRE Tunnel will expose other options for configuring the tunnel. VPN # Status Indicates the status of the GRE tunnel on the device. Options: Disabled, Connected or Not Connected. VPN Gateway Address The IP address of the device that this client connects to. This IP address must be open to connections from the device.
ALEOS 4.2.3 User Guide SSL Tunnel The SSL tunnel allows the device and the server to communicate across a network securely. SSL provides endpoint authentication and secure communications over the Internet. If the SSL tunnel is selected, the user can opt to secure remote communications via SSL. The AirLink device client will authenticate the server using a PKI certificate. The server will authenticate the client via username and password.
VPN Configuration Field Description Protocol Displays the protocol used for configuration. Only supports UDP. Peer Port The Peer Port is the UPD port on the peer device. Peer Identity Enter the IP address or Fully Qualified Domain Name (FQDN) of the peer device. Encryption Algorithm Options: DES, Blowfish, DES, Cast128, AES-128, and AES-256 Authentication Algorithm Options: MD5, SHA-1, and SHA-256. Compression Options: LZ0 or NONE.
ALEOS 4.2.3 User Guide Load Root Certificate Once an user accepts the default certificate, the SSL connection can be completed. To load a root certificate, 1. Click on Load Root Certificate. 2. A dialog-box displays. Select a SSL Certificate File. 3. Click on Upload File to Device. L2TP+IPsec Layer 2 Tunneling Protocol (L2TP) is an standard protocol for encapsulating PPP data packets and passing them transparently across an IP network. Typically, L2TP is used as a tunneling protocol to support VPNs.
VPN Configuration Figure 6-6: ACEmanager: VPN - VPN1- L2TP+IPsec To configure each LTTP tunnel: 1. Configure PPP instance 2. Configure L2TP • Local Address Type field changes to single address. • Local Address will be carrier given address of the device (with a 24-bit Netmask). • Remote Address will be VPN gateway address with 24-bit Netmask. 3. Configure IPsec route 4. Configure static route - PPP Network IP and PPP Network Mask Rev 2.3 Feb.
ALEOS 4.2.3 User Guide Field Description General VPN # Type Use this field to enable or disable the VPN # tunnel. If custom settings are used, they will be saved and the tunnel can be disabled and re-enabled without needing to reenter any of the settings. For a successful configuration, all settings for the VPN tunnel must be identical between the AirLink Device VPN and the enterprise VPN server.
VPN Configuration Field Description Remote Address The IP address of the device behind the gateway. Remote Address Netmask Remote subnet mask information. 24-bit netmask. Default: 255.255.255.0 Perfect Forward Secrecy Provides additional security through a DH shared secret value. When this feature is enabled, one key cannot be derived from another. This ensures previous and subsequent encryption keys are secure even if one key is compromised. Options: Yes or No.
ALEOS 4.2.3 User Guide Field Description PPP Network IP IPsec server network behind the IPsec concentrator. The network connected to the remote end of the PPP connection. PPP network Mask The network mask of the remote PPP network. VPN 2 to VPN 5 The VPN 2 through VPN 5 sections only allow configuration of the IPsec and GRE tunnels on the device. Figure 6-3 shows the screen display for the VPN 2 submenu; screen data fields for the VPN 3, 4, and 5 submenus are identical.
7 7: Security Configuration • Port Forwarding and DMZ • Port Filtering Inbound • Port Filtering Outbound • Trusted IPs Inbound (Friends) • Trusted IPs Outbound • MAC Filtering • Packet Inspection The Security tab that displays in ACEmanager is applicable to Sierra Wireless AirLink GX400/440 devices. The security tab covers firewall-type functions. These functions include how data is routed or restricted from one side of the device to the other, i.e.
ALEOS 4.2.3 User Guide Port Forwarding and DMZ In Port Forwarding, any unsolicited data coming in on a defined Public Port will be routed to the corresponding Private Port and Host IP of a device connected to the specified Physical Interface. In addition to a single port forwarded, you can also forward a range of ports. The DMZ is used to direct unsolicited inbound traffic to a specific LAN connected host, such as a computer running a web server or other internal application.
Security Configuration Field DMZ Enabled Description The AirLink device allows a single client to connect to the Internet through a demilitarized zone (DMZ). Options are Automatic, Manual, and Disable. Default: Automatic. • Automatic - enables the first connected host or the Public Mode interface as the DMZ. • Manual - inserts a specific IP address in the DMZ IP field • Disable - no connected host receives unsolicited traffic from the cellular network or Internet.
ALEOS 4.2.3 User Guide Port Filtering - Inbound Port Filtering - Inbound restricts unsolicited access to the AirLink device and all LAN connected devices. Port Filtering can be enabled to either block or allow ports specified. When enabled, all ports not matching the rule will be allowed or blocked depending on the mode. Port Filtering can be configured either on individual ports or for a port range. Click Add More for each port filtering rule you want to add.
Security Configuration Port Filtering - Outbound Port Filtering - Outbound restricts LAN access to the external network, i.e. the Internet. Port Filtering can be enabled to block ports specified or allow ports specified. When enabled, all ports not matching the rule will be allowed or blocked depending on the mode. Port Filtering can be configured on individual ports or for a port range. Click Add More for each port filtering rule you want to add.
ALEOS 4.2.3 User Guide Trusted IPs - Inbound (Friends) Trusted IPs - Inbound restricts unsolicited access to the AirLink device and all LAN connected devices. Tip: Trusted IPs-Inbound was called Friends List in legacy AirLink products. When enabled, only packets with source IP addresses matching those in the list or range of trusted hosts will have unrestricted access to the AirLink device and/or LAN connected devices. Note: Inbound restrictions do not apply to responses to outbound data requests.
Security Configuration Trusted IPs - Outbound Trusted IPs-Outbound restricts LAN access to the external network (Internet). When enabled, only packets with the destination IP addresses matching those in the list of trusted hosts will be routed from the LAN to the external location. Note: Outbound restrictions do not apply to responses to inbound data requests. To restrict inbound access, you need to set the applicable inbound filter.
ALEOS 4.2.3 User Guide MAC Filtering MAC filtering restricts LAN connection access. You can block or allow a connection from a computer or other device by blocking or allowing the MAC address of its network interface adapter. Figure 7-7: ACEmanager: Security - MAC Filtering Field Description MAC Filtering Enable or disable filtering of LAN packets based on the MAC Address. Options: Disable (default) and Enable. MAC Address allowed List Allows or blocks the MAC Addresses listed.
Security Configuration Packet Inspection The Packet Inspection group supports two modes of security: Normal (default) and High Security. A Stateful Packet Inspection (SPI) firewall is a firewall that tracks the states of network connections and makes decisions on packet forwarding based on the states defined in the accept or reject policy rules. Use of an SPI firewall allows for additional device security by implementing default packet state filtering policies.
ALEOS 4.2.
8 8: Services Configuration • AMS (AirLink Management Services) • ACEmanager • Low Power • Dynamic DNS • SMS • Telnet/SSH • Email (SMTP) • Management (SNMP) • Time (SNTP) The Services tab that displays in ACEmanager is applicable to all Sierra Wireless AirLink devices. The sections of the Services tab allow the configuration of external services that extend the functionality of the AirLink device.
ALEOS 4.2.3 User Guide Field Description Device Initiated Interval (mins) This field determines how often the AirLink device checks for software updates and settings changes from AMS. AMS can also query the AirLink device at a regular interval if settings allow. Refer to AirLink Management Services documentation for more information. Default: 15 minutes. Account Name Displays your account name. Identity Displays the identity number. Status Displays the status of the AMS connection.
Services Configuration Low Power The AirLink device switches into Low Power mode when configured events occur. Low Power mode is a standby mode in which the device uses minimal power while being ready to activate quickly. Figure 8-3: ACEmanager: Services - Low Power Field Description Low Power Low Power Mode Allows you to set one of the following low power mode parameters: • None • Time Delay • Low Voltage • Time Delay + Low voltage • Periodic Timer Periodic Timer Daily Mode Default: None.
ALEOS 4.2.3 User Guide Field Time Delay Description Time delay in minutes (max 255). The AirLink device will monitor the ignition sense on the power connector and enter the low power consumption stand-by mode when the ignition is turned-off. Low Power Mode Delay (Minutes): The number of minutes after one of the Low Power events happens until the AirLink device enters the low power mode. Low Voltage If you select Low Voltage, you need to set the Low Voltage Threshold.
Services Configuration Field Time Delay + Low Voltage Description If you select this option, the device will delay going into Low Power mode caused by a low voltage drop (below threshold) or ignition off. Low Voltage Threshold: Set the voltage level at which the device goes into low power mode (threshold in tenths of volts). Example: VLTG=130 would place the device in a low power standby state if the voltage goes below 13.0V.
ALEOS 4.2.3 User Guide Field Periodic Timer Daily Mode Description This mode allows you to specify when the device should be active and when it should be in Low Power mode on a daily basis. If you select the Periodic Timer Daily Mode, two fields display: • Periodic Timer Start Time (00:00-23:59 UTC) - Enter the time to start the AirLink device in the Active mode. Period Timer Active Duration (00:00-23:59 UTC) - Enter the time for how long the device should be active.
Services Configuration Dynamic DNS Dynamic DNS allows an AirLink device WAN IP address to be published to a proprietary Sierra Wireless dynamic DNS service called IP Manager, or to an alternate third party service provider. If you have one Sierra Wireless AirLink device, or a fleet of devices, it can be difficult to keep track of the current IP addresses, especially if the addresses are not static but change every time the devices connect to the cellular network.
ALEOS 4.2.3 User Guide Figure 8-4: ACEmanager: Services - Dynamic DNS Service Field Service Description Allows you to select a Dynamic DNS service provider. Options are: • dyndns.org • noip.org • ods.org • regfish.com • tzo.com • IP Manager Default: Disable.
Services Configuration Figure 8-5 is a sample third party service information screen. The third party service selected from the Service drop down menu in this example is “dyndns.org.” These same fields will be displayed for all Service selections other than IP Manager and disabled. Field Description Service Allows you to select a Dynamic DNS service provider. Options are: • dyndns.org • noip.org • ods.org • regfish.com • tzo.com • IP Manager Default: Disable.
ALEOS 4.2.3 User Guide Figure 8-6 shows the Dynamic IP fields that appear after selecting IP Manager as your Dynamic DNS Service. Field Description Device Name The name you want for the device. There are some restrictions listed below for the device name. Domain The domain name to be used by the device.
Services Configuration ccTLD (i.e., if a domain is part of the .ca TLD, it would be registered with the Canadian domain registry). It is necessary to have a name registered before it can be used. • Sub-domain or server name: A domain name can have many sub-domain or server names associated with it. Sub-domains need to be registered with the domain, but do not need to be registered with ICANN or any other registry. It is the responsibility of a domain to keep track of its own subs. car54.mydomain.com • .
ALEOS 4.2.3 User Guide SMS ALEOS has the ability to: • Receive commands via SMS message • Act as an SMS gateway for a host connected to a local interface. Warning: To use SMS with your AirLink device, you will need an account with SMS enabled, and your carrier cannot block SMS for data accounts.
Services Configuration Control Only The ALEOS SMS Mode Control Only feature allows some remote management of the AirLink device with SMS messaging. SMS allows users to: • Retrieve current device status • Reset the AirLink device • Control the relay I/O. When an SMS command is received, the AirLink device performs the action requested and sends a response back to that same phone number from which it received the SMS.
ALEOS 4.2.3 User Guide Figure 8-8: ACEmanager: Services - SMS - Control Only Field ALEOS Command Prefix Description The ALEOS Command Prefix is a configurable string of characters that can be configured if you choose Control Only or Control and Gateway mode. Any SMS command sent to the device needs to be prepended by the prefix. For example, “&&&Status” sent to device will receive the status command response. Note: ALEOS Command Prefix can be blank in Control Only mode.
Services Configuration Gateway Only The SMS gateway feature allows a locally connected host to use SMS for over the air transmission. SMS messages received by the device (inbound) will be sent on to the configured host. Messages sent by the host to a configured port on the device will be sent out as an SMS by the device (outbound). Essentially, the device will forward SMS messages between the cellular radio and the connected host.
ALEOS 4.2.3 User Guide Control and Gateway This SMS Mode allows both Control and Gateway messages. • Control Messages: These are mobile terminated messages intended to configure ALEOS or to obtain ALEOS status. • Gateway Messages: These messages may be mobile terminated or mobile originated and ALEOS acts as a gateway. In either case, the actual message origin or destination is the device connected to a local port, and ALEOS relays the message contents through the radio SMS interface.
Services Configuration Field SMS Mode ALEOS Command Prefix Description There are four SMS message modes that the user can select in the SMS Mode section. The options are: • Not Enabled (Default) • Control Only • Gateway Only • Control and Gateway The ALEOS Command Prefix is a configurable string of characters that shows up if you chose Control Only mode or Control and Gateway mode. This field does not display if Gateway Only mode is selected.
ALEOS 4.2.3 User Guide SMS Security- Inbound SMS Messages When Trusted Phone Number security is enabled, incoming messages coming from the phone numbers in the Trusted Phone Number list, are the only ones for which commands will be performed (relay, response etc) or gateway messages forwarded. Incoming messages from all other phone numbers will be ignored.
Services Configuration Trusted Phone Number Follow the instructions below to add a Trusted Phone Number on the SMS page. 1. Send an SMS command to the device and hit Refresh. If Trusted Phone Number is enabled, no will be performed on the message. 2. Once you have the Last incoming Phone number, that shows up on the SMS screen in ACEmanager, note the exact phone number displayed. 3. Click on Add More to add the Trusted Phone Number.
ALEOS 4.2.3 User Guide Telnet/SSH Use the Telnet or SSH protocol to connect to any AirLink device and send AT commands. A secure mechanism to connect remote clients is a requirement for many users. In ACEmanager now, Secure Shell (SSH) is supported which will ensure confidentiality of the information and make the communication less susceptible to snooping and man-in-the-middle attacks. SSH also provides for mutual authentication of the data connection.
Services Configuration Email (SMTP) For some functions, the device needs to be able to send email. Since it does not have an embedded email server, you need to specify the settings for a relay server for the device to use. Note: The SMTP function will only work with a mail server that will allow relay email from the ALEOS device’s Net IP.
ALEOS 4.2.3 User Guide Management (SNMP) The Simple Network Management Protocol (SNMP) was designed to allow the 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 device, 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.
Services Configuration Field Description SNMP Contact This is a personal identifier of the contact person you want to address queries to. This is a customer defined field. SNMP Name This is the name of the device you want to refer to. This is a customer defined field. SNMP Location Location of where your device is stored. This is a customer defined field. Read Only SNMP User Community Name Allows all SNMP users to view but not change the network configuration. Default: public.
ALEOS 4.2.3 User Guide Field Description SNMP Configuration Enable SNMP Allows you to setup your SNMP configuration. Default: Disable. SNMP Version Allows you to select either SNMP protocol Version 2 or Version 3 communications. Default: Version 3. SNMP Port This controls which port the SNMP Agent listens on: • SNMP is disabled • 65535. SNMP Contact This is a personal identifier of the contact person you want to address queries to. This is a customer defined field.
Services Configuration Time (SNTP) The device can be configured to synchronize it's internal clock with a time server on the Internet using the Simple Network Time Protocol. Normally your device will synchronize with the cellular network or GPS. Figure 8-16: ACEmanager: Services - Time (SNTP) Field Description Enable time update Enables daily SNTP update of the system time. Options: Enable or disable (default).
ALEOS 4.2.
9 9: GPS Configuration • • • • • GPS Server 1 Server 2 to Server 4 Local/Streaming Global Settings The GPS tab that displays in ACEmanager is applicable across the Sierra Wireless AirLink GX400/GX440. GPS This group includes commands specific to GPS features and the AirLink device. The AirLink device is equipped with a Global Positioning System receiver (GPS) to ascertain its position and track the movements of a vehicle or other devices which move.
ALEOS 4.2.3 User Guide computes the distance to each satellite from the difference between local time and the time the satellite signals were sent (this distance is called psuedoorange). The locations of the satellites are decoded from their radio signals and a database internal to the receiver. This process yields the location of the receiver.
GPS Configuration National Marine Electronics Association (NMEA) National Marine Electronics Association (NMEA) is a protocol by which marine instruments and most GPS receivers can communicate with each other. NMEA defines the format of many different GPS message (sentence) types, which are intended for use by navigational equipment. An example of a tracking application using NMEA is Microsoft Streets and Trips.
ALEOS 4.2.3 User Guide Server 1 GPS data configured for your AirLink device is sent to Server 1. Figure 9-1: ACEmanager: GPS Server 1 Table 9-1: GPS: Server 1 Field Description Events Report Interval Time (secs) GPS Report Time Interval. See also *PPMINTIME, *PPTSV, +CTA. n=seconds (1 - 65535) Note: Your cellular carrier may impose a minimum transmit time. Report Interval Distance (100 meters) GPS Report Distance Interval in 100 meter units (kilometers). 1 mile is approximately 1.61 kilometers.
GPS Configuration Table 9-1: GPS: Server 1 Field Stationary Vehicle Timer (mins) Description Timer for Stationary Vehicles. Time interval in minutes that the AirLink device will send in reports when it is stationary. • n=0: Disabled n=1-255 minutes For example, if *PPTIME=10, the AirLink device will send in reports at least every 10 seconds while it is moving; however, once it stops moving, it will slow the reports down to this *PPTSV value.
ALEOS 4.2.3 User Guide Table 9-1: GPS: Server 1 Field Description Servers Report Server IP Address IP address or FQDN (fully qualified domain name) where GPS reports are sent (ATS Server IP). Also see *PPPORT. • d.d.d.d=IP address Example: AT*PPIP=192.100.100.100 Report Server Port Number Port where GPS reports are sent. • n=1-65535 Default: 22335 Redundant Server 1 IP Address IP address or FQDN of redundant Server 1. Redundant Server 1 Port Number Port number of redundant Server 1.
GPS Configuration Table 9-1: GPS: Server 1 Field Description Additional Data Report Odometer Enables odometer reporting. Options: • Disable Enable Default: Disable • Report Digital Inputs Enables input reporting. Options: • Disable Enable Default: Disable • Redundant Server When a redundant server is enabled, each time a message is sent out to the main server a second identical message will be sent to the redundant server. This can allow the data to be used by two or more different applications.
ALEOS 4.2.3 User Guide Server 2 to Server 4 GPS data can be sent to multiple servers. The GPS configuration screens for Server 2, Server 3, and Server 4 are identical to the configuration screen for Server 1 except for the elimination of the four redundant server fields in the Servers submenu section. Figure 9-2: ACEmanager: GPS - Server 2 Store and Forward Store and Forward will store reports when the primary Reports Server is unavailable and forwards them when the server is available again.
GPS Configuration Reliability Modes Reliability Modes provide methods for the AirLink device to receive an acknowledgement from the Reports Server to determine if a sent message was received. • Reliable Mode - The AirLink device will transmit a sequence number (1 to 127) as part of a packet of messages that may contain one or more reports. To reduce overhead, the server only acknowledges receipt after every eighth packet. The AirLink device considers the eight packets a “window” of outstanding packets.
ALEOS 4.2.3 User Guide Local/Streaming Figure 9-3: ACEmanager: GPS - Local/Streaming Table 9-2: GPS: Local/Streaming Field Description Serial GPS Reports port Send GPS strings out serial or USB serial link.
GPS Configuration Table 9-2: GPS: Local/Streaming Field Description Advanced GPS Coverage Allows an AirLink device to be configured to send GPS sentences out of the serial port when the device loses cellular coverage. This feature is configured by 2 fields. This field controls the status of the sentences.
ALEOS 4.2.3 User Guide Table 9-2: GPS: Local/Streaming Field Report Odometer Description Enables odometer reporting. Options: • Disable Enable Default: Disable • Report Digital Inputs Enables input reporting. Options: • Disable Enable Default: Disable • Global Settings Figure 9-4: ACEmanager: GPS - Global Settings Table 9-3: GPS: Global Settings Field Description General Odometer Value (meters) The current odometer value (in meters) of the AirLink device. Maximum value is approximately 4.
GPS Configuration Table 9-3: GPS: Global Settings Field Send SnF Buffer immediately on input Description Flushes store and forward buffer when an input event (digital inputs, stationary events, and maximum speed events) occurs. • Disable (default) • Use Device ID in Location Reports Enable Enable input reporting. • None (default) • Phone Number • ESN/IMEI Advanced TCP GPS Port Specifies the port to listen on for TCP GPS report polling.
ALEOS 4.2.
10 10: Events Reporting Configuration • Introduction • Configuration Overview • Action Description • Configure Events The Events Reporting tab that displays in ACEmanager is applicable across all Sierra Wireless AirLink devices. Introduction Events Reporting allows the users to generate reports or perform actions in response to the events that are configured in the ALEOS software. An Event is a measurement of a physical property AND a state change or a threshold crossing.
ALEOS 4.2.3 User Guide 1) User Configuration of Events And Actions Physical Input 2) Measure Physical Input N 3) Threshold Exceeded or State Change? One of the following : RSSI, Digital Input , Speed , Heading , etc. 4) Perform Activity Y Event Send Report , change digital signal , turn off services, etc Action Figure 10-1: Events Reporting Concept The procedure of how Events Reporting works is described below: 1. The user configures the events and actions. 2.
Events Reporting Configuration Configuration Overview To configure Events and Actions, the user must go through the following steps which are illustrated in the sections below. 1. Define an Event – Events can be configured using the ACEmanager User Interface. Select the Events Reporting Tab, and then select the Add New subtab to add an event (e.g., RSSI). Remember to select the Apply button when the Event Details fields have been filled out.
ALEOS 4.2.3 User Guide 3. Associate the Action with the Event – This is done by clicking on the Events group. On the Events page, note that the new Action (Low Signal) is displayed in the Action Description frame. Users can check the box to associate this action with the Cell Radio Sign Event.
Events Reporting Configuration Table 10-1: Events Types Other Report Types Periodic Reports Threshold Crossing (Time) Period to compare (seconds) Power In Threshold Crossing Power threshold (volts) Board Temperature Threshold Crossing Degrees Celsius CDMA Radio Module Threshold Crossing Degrees Celsius Daily Data Usage Threshold Crossing Percentage of daily threshold Monthly Data Usage Threshold Crossing Percentage of monthly threshold Data Usage Action Description Select a name for the
ALEOS 4.2.
Events Reporting Configuration • SNMP Trap notification · Destination IP is configured in the SNMP location. Figure 10-8: ACEmanager: Events Reporting - Action Type - SNMP TRAP • Relay Link · Select the relay to link to, and Invert if necessary. Figure 10-9: ACEmanager: Events Reporting - Action Type - Relay Link • GPS RAP/Report 13 message · Destination report server and report type is configured in the AirLink Device Menu.
ALEOS 4.2.3 User Guide • Events Protocol message to a server · Destination report server is configured · Report format – TLV (Type, Length and Value), Binary, ASCII, XML. See Events Protocol (Appendix A) for details. Figure 10-11: ACEmanager: Events Reporting - Action Type - Type, Length, Value • Turn-Off Services - This is also an option in the scroll-down list of the Action Type field.
Events Reporting Configuration Report Groups You can select the data you want to be included in the report groups. The options are displayed. Check the box corresponding to the data displayed. By default, all the boxes are checked. Figure 10-13: ACEmanager: Events Reporting - Actions - Reports The reports attributes are: • Digital I/O The Digital I/O group includes the status both the digital inputs and the relay outputs as well as the pulse count on the digital inputs.
ALEOS 4.2.3 User Guide · Enable for Device ID - The device ID (ESN or EID/IMEI) of the AirLink device. This should be enabled for a cellular account with a dynamic IP address. · Enable for Phone Number - The phone number of the AirLink device. · Enable for Device Name - The device Name of the AirLink device. · Enable for MAC Address - The MAC Address of the Ethernet port of the AirLink device. · Enable for SIM ID - The SIM ID of the AirLink device.
Events Reporting Configuration Miscellaneous Data includes temperature rates and other information that does not fit in the other categories. · Enable for Power In - The voltage level of the power coming in to the AirLink device at the time of the report. · Enable for Board Temperature - The temperature of the internal hardware of the AirLink device at the time of the report. · Enable for Host Comm State - The signal level between the AirLink device and the connected device(s).
ALEOS 4.2.3 User Guide • 4 - XML - An XML form of the data will be sent. Tip: Because of its flexibility and robustness, the TLV message type is recommended for most reports using the Events Protocol. The Binary and ASCII forms do not contain “A type field” which can result in misinterpretation of data. Since the TLV and XML forms always includes the type as well as the data, an unintentional type can be identified much easier.
11 11: Serial Configuration • Port Configuration • MODBUS Address List The Serial tab that displays in ACEmanager is applicable to all AirLink devices with a serial port. Most AirLink devices are equipped with a serial port. This port can be used to connect devices or computers using a DB9-RS232 connection. Note: These commands are specific to the RS232 port and generally do not apply to the USB/serial. Port Configuration The Serial group includes commands specific to general use of the serial port.
ALEOS 4.2.
Serial Configuration Table 11-1: Serial Port Configuration Field Description Port Configuration Startup Mode Default Default power-up mode for the serial port: When the AirLink device is power-cycled, the serial port enters the mode specified by this command after 5 seconds. On startup, typing ATMD0 into a terminal application connected to the serial port within 5 seconds changes the mode to normal (AT command) mode. See also S53 to set the port for UDP.
ALEOS 4.2.3 User Guide Table 11-1: Serial Port Configuration Field Description Advanced Assert DSR Assert DSR always when the device is in a data mode (UDP, TCP, etc.), or when the device is in network coverage. Options are: • Always • In Data Mode In Coverage Default: Always • Assert DCD Assert DCD always, or when the device is in a data mode (UDP, TCP, etc.) or when the device is in network coverage.
Serial Configuration Table 11-1: Serial Port Configuration Field ATZ Reset Description When set to Enable, +++ ATZ will reset the device. Options: • Disable Enable Default: Enable • IP List Dial This allows access to the Modbus IP Address using the first two digits of the dial string. E.g., ATDT1234567 would imply ID index 12 on the Modbus Address list and use the associated IP Address as the destination.
ALEOS 4.2.3 User Guide Table 11-1: Serial Port Configuration Field UDP Connect Last Description If enabled, sets S53 to the last accepted IP address through UDP auto answer. This can be used in conjunction with MD3 so that when there is no UDP session, new ethernet host data will cause a connection to be restored to the last IP accepted through UDP auto answer.
Serial Configuration MODBUS Address List To add a MODBUS Address Entry, click on Add More. Figure 11-3: ACEmanager: MODBUS Address List Rev 2.3 Feb.
ALEOS 4.2.
12 12: Application Configuration • Data Usage • Garmin The Application tab that displays in ACEmanager is applicable to all AirLink GX400/440 devices. The Applications tab consists of a Data Usage section and a Garmin application section. Data Usage The Data Usage feature available in the Application tab provides users with a way to actively monitor cellular data usage.
ALEOS 4.2.3 User Guide Field Description General Data Service If Data Service is on, “Available” displays on the user interface. If data usage exceeds the configured data limit, “Not Available” displays on the screen. Daily Limit Daily Limit (MB) This is the user specified daily data usage (in MBs) limit (24 hour limit). The user can specify data usage limits on a daily or monthly basis.
Application Configuration 2. Select the Events Reporting tab and configure a data usage threshold. The threshold is specified as a percentage value of the monthly or daily limit. For example, if the you have specified 5 GB as the monthly limit, and the threshold is set at 80%, then the threshold is reached when 4 GB of data usage is reached. Figure 12-2: ACEmanager: Events Reporting - Events 3.
ALEOS 4.2.3 User Guide 4. Select the Events group page again to associate the Data Usage Action with the Data Usage Event. Figure 12-4: ACEmanager: Events Reporting - Events Note: Daily and monthly limits will reset at the end of the billing cycle. Once the data plan limit is reached, the user may desire to turn off cellular communication with any user devices connected to the host port until the next billing cycle starts.
Application Configuration 2. Create an action to turn off the services. When triggered, this action will prevent cellular communication to any user device connected to a host port. Figure 12-6: ACEmanager: Events Reporting - Actions - Add New Garmin Garmin provides navigation devices for versatile fleet monitoring solutions. AirLink devices provide an internet access to Garmin devices and a mechanism to enable via cellular.
ALEOS 4.2.3 User Guide 2. Set the Host Mode to TCP. Under the Serial – Port Configuration tab, set the Startup Mode Default parameter to TCP. Figure 12-8: ACEmanager: Serial - Port Configuration 3. Set the Server Address and Port for TCP. Under the Serial – Port Configuration tab, set the Destination Port and the Destination Address to the port and address of the AVL server that the TCP application will be communicating with.
Application Configuration 4. Configure the serial port. To communicate with Garmin: · Input 9600, 8N1 in Configure Serial Port · Select None in Flow Control · Select Ignore DTR in DTR Mode. Figure 12-10: ACEmanager: Serial - Port Configuration parameters Rev 2.3 Feb.
ALEOS 4.2.3 User Guide 5. Check the Garmin’s communications status under the Status - Applications tab. Garmin data service states are: · Not Enabled - Not acknowledged by the AVL server · Enabled - Acknowledged by the AVL server. Figure 12-11: ACEmanager: Status - Applications - Garmin Status 6. Reboot the AirLink device to apply the changes. The “Garmin Status” now displays: · Enabled - Acknowledged by the AVL server. Note: The Garmin Status field displays only if the Garmin application is Connected.
13 13: I/O Configuration The I/O tab that displays in ACEmanager is applicable across all Sierra Wireless AirLink devices which feature I/O ports. This group includes configuration commands for the digital inputs and outputs as applicable to an AirLink device. Some of the values shown as a part of this group are not changeable but reflect the current status. Only those devices with available inputs and outputs will display this group.
ALEOS 4.2.3 User Guide Pulse Count Following are some Pulse Count details: • 162 The AirLink device has one digital input and one pulse count. • Pulses are counted on falling edge (high - >low). This can be added. • Pulses can not be counted when the device is powered off, or being reset. However, a single state change while off or reset will be properly counted.
14 14: Admin • • • • Change Password Advanced Radio Passthru Log The Admin tab that displays in ACEmanager is applicable to all Sierra Wireless AirLink GX400/440 devices. The Admin section contains features which are intended for Administrator configuration only. Change Password It is highly recommended to change the default password of the AirLink device. Figure 14-1: ACEmanager: Admin To change the default password, 1. Select the User Name: user or viewer 2. Enter the old password 3.
ALEOS 4.2.3 User Guide Advanced Features which should be rarely changed and will affect the operation of the device are present on the Advanced screen. Figure 14-2: ACEmanager: Admin - Default Field Date and Time Description Queries the internal clock. The date and time are always specified in 24-hour notation (UTC). • mm/dd/yyyy= date in month/day/year notation • Enable Over-the-Air Programming hh:mm:ss= time in 24-hour notation.
Admin Radio Passthru Radio Passthru allows a direct connection, using USB, to the internal radio. Normal cellular radio operation is suspended while Radio Passthru is enabled. Radio Passthru is generally used only in certain troubleshooting scenarios. The hardware bypass will remain in effect until the ALEOS software resets either via ACEmanager command or the hardware Reset button. Note: Special drivers are required to connect to the radio.
ALEOS 4.2.3 User Guide Log The Log file is a system log of the AirLink device. The Logging configuration screen enables the user to configure log verbosity and display filtering. The View Log screen enables the user to view and save logs. The logs are in clear text. The Configure Logging group is organized by Subsystems. Separate filters, based on subsystem and severity, are applied when the messages are generated and when the messages are displayed.
Admin Field Logging Description Logging enables the user to configure log verbosity and display filtering for various subsystems. Sub System fields are: • WAN/Cellular • LAN • VPN • Security • Services • Events Reporting/OPS • Serial • Applications • UI • AMS • Admin System Separate filters, based on subsystem and severity, are applied when the messages are generated and when the messages are displayed.
ALEOS 4.2.3 User Guide Figure 14-5: ACEmanager: Admin - Log, View Log To view a log: 1. Select a Verbosity severity level, and choose “Yes” from Display in Log? 2. Apply Refresh. 3. Go to the View Log menu item, and select Refresh. 4. Select Save. A window appears with a text file. User action options on the View Log screen include: 168 • Auto Refresh - The drop-down menu allows the user to set up an automatic log page refresh, and the interval between refreshes: 30 secs, 1 minute, or 2 minutes.
A A: Modbus/BSAP Configuration The AirLink device supports Modbus ASCII, Modbus RTU, and BSAP, and can also emulate other protocols like DF1 or others using the 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.
ALEOS 4.2.3 User Guide 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 encompasses multiple RTUs, a central control room with a host computer (or network), and some sort of communication infrastructure.
Modbus/BSAP Configuration Configuring the AirLink Device at the Polling Host for Modbus on UDP This section covers a Polling Host with standard Modbus. Variations may need additional AT commands. 1. Configure the ports. 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”.
ALEOS 4.2.3 User Guide Configuring the Remote AirLink Devices for Modbus with UDP This section covers standard Modbus settings for the AirLink device at the remote unit; variations may need additional commands. 1. Configure the ports In ACEmanager, select Port Configuration in the side menu. The destination port for the device at the host needs to match the device port in use on all the devices at the remote sites.
Modbus/BSAP Configuration When you configure Dynamic DNS for the host device, make note of your device name and domain setting in ACEmanager in the menu selection Dynamic IP to be used with the remote devices. When you use names instead of IP addresses, to ensure your devices are updated quickly with the correct IP addresses for the names, you will want to set the DNS settings as well. Configure *DNSUSER to the same IP address as the Dynamic DNS (*IPMANAGER1).
ALEOS 4.2.
B B: PPP over Ethernet (PPPoE) • Configuring a PPPoE Connection in Windows • Connecting to the Internet with PPPoE Note: These directions listed are for Windows XP. Configuring a PPPoE Connection in Windows 1. Create a new network connection a. Select Start > Connect To > Show all connections. This will open the Network Connections window. Figure B-1: Windows: Start menu b. Select Create a New Connection under Network Tasks in the menu area on the left.
ALEOS 4.2.3 User Guide Figure B-2: Windows: Network Connections c. Click Next on the opening screen to begin creating a PPPoE connection. d. Next. Figure B-3: New Connection Wizard e. Select Connect to the Internet. f. 176 Select Next.
PPP over Ethernet (PPPoE) Figure B-4: New Connection: Type g. Select Set up my connection manually. h. Select Next. Figure B-5: New Connection: How do you want to connect? i. Select Connect using a broadband connection. j. Select Next. Figure B-6: New Connection: Connect using broadband k. Type in a name for the connection, such as Sierra Wireless AirLink Modem. l. Select Next. Figure B-7: New Connection: Connection Name Rev 2.3 Feb.
ALEOS 4.2.3 User Guide 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 (AirLink device), or any other designation for the connection. m. Optional: If multiple users are configured for your computer, you may be prompted for Connection Availability. If you select My use only, the account currently logged on will be the only one able to use this connection. n.
PPP over Ethernet (PPPoE) Figure B-9: New Connection: Finish 2. Configure the PPPoE connection. After you complete the New Connection Wizard, there are a few more things you will want to configure in the connection. a. Select Properties. Figure B-10: PPPoE Connection b. Optional: On the General tab, if you gave the modem a name with *MODEMNAME above, you can type in that name as the Service Name. Rev 2.3 Feb.
ALEOS 4.2.3 User Guide Same as *MODEMNAME configured earlier Figure B-11: PPPoE Connection: Service Name c. Select Networking, and select Settings. Figure B-12: PPPoE: Networking d. Remove the checks from all three PPP settings, and select OK. Figure B-13: PPP Settings Tip: You may want to check the Options tab and change the settings for applications you might be using. The default options are generally applicable for most uses.
PPP over Ethernet (PPPoE) Connecting to the Internet with PPPoE Now the PPPoE connection can be run and a data connection can be established. a. Connect your computer and the modem to the same local network using a hub or a switch. Note: It is not recommended to connect your computer directly to the modem without a hub or switch. b. Start the PPPoE by Start > Connect To > Sierra Wireless AirLink Modem (or whatever you named the connection).
ALEOS 4.2.
C: SNMP : Simple Network Management Protocol • Management Information Base (MIB) • SNMP Traps • SNMP MIB Definition Sample Management Information Base (MIB) The ALEOS 4.2.3 management information base (MIB) is a type of database used to compile information from various SNMP agents. Reports from these agents, such as the AirLink device, are sent as data in a form designed to be parsed by the NMS into its MIB. The data is hierarchical with entries addressed through object identifiers.
ALEOS 4.2.3 User Guide DESCRIPTION "This file defines the private Sierra MIB extensions.
SNMP : Simple Network Management Protocol networkState OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { home 259 } RSSI OBJECT-TYPE SYNTAX INTEGER(-125..
ALEOS 4.2.
SNMP : Simple Network Management Protocol IMSI OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { cellular 785 } keepAliveIpAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current ::= { cellular 1105 } keepAlivePingTime OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { cellular 1104 } DNSServer1 OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { cellular 1082 } DNSServer2 OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-onl
ALEOS 4.2.
SNMP : Simple Network Management Protocol baseClass OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { cellular 651 } -- LAN status elements usbMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { lan 1130 } vrrpEnabled OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { lan 9001 } lanpacketsSent OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { lan 279 } lanpacketsRecvd OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-
ALEOS 4.2.
SNMP : Simple Network Management Protocol portFilteringOut OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { security 3506 } trustedHosts OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { security 1062 } macFiltering OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { security 3509 } badPasswdCount OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { security 385 } ipRejectCount OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS r
ALEOS 4.2.
SNMP : Simple Network Management Protocol SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { gps 906 } -- Serial status elements serialPortMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { serial 1043 } tcpAutoAnswer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { serial 1048 } udpAutoAnswer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { serial 1054 } serialPacketsSent OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only
ALEOS 4.2.
SNMP : Simple Network Management Protocol snmpv3(3)} MAX-ACCESS read-write STATUS current ::= { snmpconfig 10041 } snmpport OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-write STATUS current ::= { snmpconfig 10042 } snmpContact OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-write STATUS current ::= { snmpconfig 2730 } snmpName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-write STATUS current ::= { snmpconfig 2731 } snmpLocation OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-write STATUS current ::= {
ALEOS 4.2.
SNMP : Simple Network Management Protocol authpriv(2)} MAX-ACCESS read-write STATUS current ::= { snmpconfig 10052 } rwauthtype OBJECT-TYPE SYNTAX INTEGER { MD5(0), SHA(1) } MAX-ACCESS read-write STATUS current ::= { snmpconfig 10053 } rwauthkey OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-write STATUS current ::= { snmpconfig 10054 } rwprivtype OBJECT-TYPE SYNTAX INTEGER { AES(0), DES(1) } MAX-ACCESS read-write STATUS current ::= { snmpconfig 10055 } rwprivkey OBJECT-TYPE SYNTAX DisplayString MAX-ACC
ALEOS 4.2.
SNMP : Simple Network Management Protocol trapprivkey OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-write STATUS current ::= { snmpconfig 10062 } rebootmodem OBJECT-TYPE SYNTAX INTEGER { nop(0), reboot(1) } MAX-ACCESS read-write STATUS current ::= { snmpconfig 65001 } -- Notifications starting at 1000 modemNotifications OBJECT IDENTIFIER ::= { mibversion1 1000 } Value OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS accessible-for-notify STATUS current DESCRIPTION "value of MSCIID that triggered this
ALEOS 4.2.
SNMP : Simple Network Management Protocol STATUS current DESCRIPTION "Analog Input 2 MSCIID 856" ::= { modemNotifications 10 } AnalogInput3 NOTIFICATION-TYPE OBJECTS { Value } STATUS current DESCRIPTION "Analog Input 3 MSCIID 857" ::= { modemNotifications 11 } AnalogInput4 NOTIFICATION-TYPE OBJECTS { Value } STATUS current DESCRIPTION "Analog Input 4 MSCIID 858" ::= { modemNotifications 12 } ScaledAnalogInput1 NOTIFICATION-TYPE OBJECTS { Value } STATUS current DESCRIPTION "Scaled Analog Inpu
ALEOS 4.2.
SNMP : Simple Network Management Protocol DESCRIPTION "Network Error Rate MSCIID 263" ::= { modemNotifications 24 } PeriodicReports NOTIFICATION-TYPE OBJECTS { Value } STATUS current DESCRIPTION "Periodic Reports MSCIID 270" ::= { modemNotifications 25 } PowerIn NOTIFICATION-TYPE OBJECTS { Value } STATUS current DESCRIPTION "Power In MSCIID 266" ::= { modemNotifications 26 } BoardTemp NOTIFICATION-TYPE OBJECTS { Value } STATUS current DESCRIPTION "Board Temperature MSCIID 267" ::= { modemNotif
ALEOS 4.2.
D : Global Positioning System (GPS) • Configuring the AirLink Device for GPS • RAP Configuration • NMEA Configuration • TAIP Emulation Configuration The AirLink device is equipped with a Global Positioning System receiver (GPS) to ascertain its position and track the movements of a vehicle or other devices which move. The AirLink device relays the information of its location as well as other data for use with tracking applications.
ALEOS 4.2.3 User Guide information from fewer than four satellites, using imprecise time, using satellites too closely positioned together, or using satellites too close to the Earth’s curve will yield inaccurate data. The GPS data is then transmitted to a central location which uses a tracking application to compile information about location, movement rates, and other pertinent data.
Global Positioning System (GPS) National Marine Electronics Association (NMEA) National Marine Electronics Association (NMEA) is a protocol by which marine instruments and most GPS receivers can communicate with each other. NMEA defines the format of many different GPS message (sentence) types, which are intended for use by navigational equipment.
ALEOS 4.2.3 User Guide Configuring the AirLink Device for GPS This section covers general configuration. Configurations for specific protocols are covered in later sections. To configure your modem’s GPS settings, you can use either ACEmanager or a terminal connection to configure the modem using AT commands. The configuration examples in this chapter all use ACEmanager. Most of the settings are in the group: PinPoint.
Global Positioning System (GPS) Local Host To set the AirLink device to report to a local host, one directly connected to the serial port, configure the port to be used with S53 - Destination Port. The local IP address will automatically be used for local reports. S53, in ACEmanager, is part of the GPS group. If you need to send reports to additional local ports, you can specify other ports with *PPLATSEXTRA. Local Reports can be sent to up to 7 additional ports consecutively following the S53 port.
ALEOS 4.2.3 User Guide Sending Reports Automatically Remote You can configure the AirLink device to send reports based on a time interval and on the movement of a vehicle (based on it’s position from one time to the next). • *PPTIME - Location report sent every set time interval (seconds). • *PPDIST - Location report sent only if the position is more than the set distance (x 100 meters).
Global Positioning System (GPS) Store and Forward Reliable Mode The Store and Forward Reliable Mode allows the AirLink device to ensure all messages are received by the server even if the connection between them goes down for a period of time (such when a vehicle passes through a location where the cellular signal is weak or non-existent). With Reliable Mode, *PPSNFR, enabled, the AirLink device will transmit a sequence number (1 to 127) as part of a packet of messages (may contain one or more reports).
ALEOS 4.2.3 User Guide Flush on Event If you have events enabled, with *PPFLUSHONEVT, you can configure the AirLink device to flush the SnF buffer when an event occurs. This will immediately send all pending SnF messages to the host. This allows an event, such as a vehicle being powered on or a tow bar activated, to be immediately sent, so its cause can be acted on without delay.
Global Positioning System (GPS) RAP Reports over a Local Connection Local reports are sent to the local IP address of the computer or device connected directly to a port on the AirLink device. The reports are sent using PPP or SLIP for serial or USB virtual serial. To configure the modem to send reports to the local IP address, you will need to set 3 commands: S53 in the GPS group and *PPLATS and *PPLATSR in the PinPoint group. a. Set the S53 port to the local port to which you want the reports sent.
ALEOS 4.2.3 User Guide manual synchronization of the AirLink device odometer with the current vehicle odometer. Note: The odometer calculations of the AirLink device may not match the odometer in the vehicle itself. The AirLink device odometer is not connected to the vehicle’s, it is entirely based on calculations of GPS readings. I/O Event Reports You can configure the AirLink device to send reports to the AVL Host based on the state of the digital inputs, analogue inputs, and relay outputs.
Global Positioning System (GPS) NMEA Configuration Messages Over-The-Air (Remote) To configure the AirLink device to send NMEA reports to a remote server, you will need to set 3 commands: *PPIP, *PPPORT, and *PPGPSR. a. Set *PPIP and *PPPORT to the IP address and port of the server to which you want the reports sent. b. Set the GPS Report Type (*PPGPSR) to your preferred NMEA sentence format. • E0 - NMEA GGA and VTG sentences. • E1 - NMEA GGA, RMC, and VTG sentences.
ALEOS 4.2.3 User Guide Streaming Messages (Local) The AirLink device can be configured to send standard NMEA messages (sentences) in ASCII over the serial port and/or USB port without a PPP connection to the local computer. Send the command ATGPS1 to the serial port, ATGPS2 to the USB port, or ATGPS3 for both to begin the NMEA stream. The example below shows the stream in HyperTerminal connecting directly to a AirLink device via the comport and/or USB port.
Global Positioning System (GPS) TAIP Emulation Configuration The TAIP emulation functionality allows the AirLink device to operate in a limited manner with clients which only understand the Trimble ASCII Interface Protocol (TAIP). This emulation is enabled by setting the GPS report format, directing the modem to listen for TAIP messages, and disabling RAP formatted messages to the same interface. TAIP ID TAIP messages can be configured to send the user specified identification number (ID).
ALEOS 4.2.3 User Guide The TAIP emulation will generate the following reports corresponding to the appropriate event (either a query for it, echoed due to a set, or due to an automatic reporting event): • RRM (Report Reporting Mode) reports the reporting mode configuration. • RID (Report ID) reports the TAIP ID. • RPV (Report Position/Velocity) reports Position/Velocity.
Global Positioning System (GPS) Sending Unsolicited TAIP Messages Over the Local Connection Standard TAIP requires a request before GPS reports are sent. The AirLink device, however, can be configured to allow TAIP formatted messages to be sent over any UDP Port without request commands. This is useful for those applications which can listen for TAIP messages but cannot send UDP request packets. a. Set the S53 port to 1000. The local IP address will automatically be used. b.
ALEOS 4.2.
E: AT Commands • AT Command Set Summary • Reference Tables • Common AT Command Set Summary The reference tables are presented in strict ASCII alphabetical order (including prefixes). This format allows quick look-up of each command to verify syntax, parameters, and behaviors. It does not lend itself to finding whether or not the AirLink Device has a command to perform a particular service or setting.
ALEOS 4.2.3 User Guide Table E-1: Info Commands (Continued) Command Description *DEVICEID? The commands displayed in AceManager and the results of those commands depends on the model of the device. This command will retrieve the 64-bit device ID the device uses to identify itself to the cellular network.
Table E-2: Status: Network (Continued) Command Description *NETSTATE? The current network state: • Connecting To Network: The device 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 device. Data Connection Failed: The device failed to connect, and it is now waiting a set time interval before it attempts to reconnect. Verify settings to activate the device.
ALEOS 4.2.3 User Guide CPU Status Table E-4: Status: CPU Status Command Description *POWERIN The voltage input to the internal hardware. *BoardTemp The temperature, in Celsius, of the internal hardware. *POWERMODE Displays the current power state/mode.
Table E-5: Common: Misc (Continued) *OPRG Enables/disables over-the-air firmware upgrading of the MP. When Sierra Wireless releases a new version of ALEOS, you can upgrade your remote devices with OPRG enabled. • n=0 : Disables • n=1 : Enables *DPORT The device's Device Port which the device is listening on for inbound packets/ data/polls. Can also be set with the command S110. • n=1-65535 *NETUID Network User ID The login that is used to login to the cellular network, when required.
ALEOS 4.2.3 User Guide Table E-5: Common: Misc (Continued) *NETPHONE? Phone Number The device’s phone number, if applicable or obtainable. *HOSTPAP Request PAP 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 connection and copies to *NETUID and *NETPW.
Table E-7: Common: Serial (Continued) Command Description &D Set DTR mode. n=0 : Ignore DTR, same effect as HW DTR always asserted (same as S211=1). n=2 : Use hardware DTR (same as S211=0). S211 For applications or situations where hardware control of the DTR signal is not possible, the device can be configured to ignore DTR. When Ignore DTR is enabled, the device operates as if the DTR signal is always asserted. • n=0 : Use hardware DTR. (default). Q • n=1 : Ignore DTR.
ALEOS 4.2.3 User Guide Table E-7: Common: Serial (Continued) Command Description CTSE Clear To Send Enable: This feature asserts CTS when there is a network connection. • n=0 : Disabled (Default). n=1 : Enable assertion of CTS when there is network coverage. RS232 voltage levels: • Positive = Network coverage. • Negative = No coverage. 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).
Table E-8: Common: TCP (Continued) Command Description TCPS TCP connection time-out (TCPS) units. Specifies a time interval upon which if there is no in or outbound traffic through a TCP connection, the connection will be terminated. • n=0 : minutes S221 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.
ALEOS 4.2.3 User Guide UDP Table E-9: Common: UDP Command MD S82 Description Default power-up mode for the serial port: When the device 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.
Table E-9: Common: UDP (Continued) Command Description UALL Accepts UDP packets from any IP address when a UDP session is active. If there is no UDP session active, an incoming UDP packet will be treated according to the UDP auto answer and AIP settings. • n=0 : No effect (Default). • HOR n=1 : Accept UDP data from all IP addresses when in a UDP session. Half-Open Response - In UDP auto answer (half-open) mode. • n=0 : No response codes when UDP session is initiated.
ALEOS 4.2.3 User Guide Table E-10: Common: DNS Command Description *DNSUSER Sets a user-provided DNS to query first when performing name resolutions in the device. • d.d.d.d=IP address of domain server Note: You can set up a second DNS User, if you have two DNS users. *DNSUPDATE Indicates whether the device 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.
Table E-11: Common: Dynamic IP (Continued) Command Description *IPMANAGER1 *IPMANAGER2 Sets a domain name or IP address to send IP change notifications to. Up to two independent IP Manager servers can be set, using either AT*IPMANAGER1 or AT*IPMANAGER2. Updates to a server can be disabled by setting that entry to nothing (for example, “AT*IPMANAGER1=”). • n=1 : First IP Manager server. • *IPMGRUPDATE1 *IPMGRUPDATE2 *IPMGRKEY1 n=2 : Second IP Manager server.
ALEOS 4.2.3 User Guide Table E-12: Common: PPP/Ethernet (Continued) Command Description *HOSTPEERIP Set or query the IP address that can be used to directly contact the MP device 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 device. Note: This is not normally used nor needed by user applications. *HOSTNETMASK Subnet mask for the host interface.
Table E-13: Common: PassThru (Continued) Command Description *RESETPERIOD In PASSTHRU mode, device will be reset after this period if no data has been sent or received. Value is in hours. • n=0 : Disabled • *CSX1 n=1-255 hours 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 device while the device is not asserting DCD.
ALEOS 4.2.3 User Guide Other Table E-15: Common: Other Command *IPPING Description Set the period to ping (if no valid packets have been received) a specified address (*IPPINGADDR) to keep the device alive (online). • n=0 : Disable pinging (default) • n=15-255 minutes Note: 15 minutes is the minimum interval which can be set for Keep Alive. If you set *IPPING for a value between 0 and 15, the minimum value of 15 will be set.
Table E-15: Common: Other (Continued) Command *MSCIUPADDR Description Device Status Update Address - where Name/Port is the domain name and port of the machine where the device status updates will be sent. The status parameters of the device are sent in an XML format. • name=domain name • *MSCIUPDPERIOD Device Status Update Period - where n defines the update period in seconds. • n=0 : Disabled • *DAE *SNMPTRAPDEST Rev 2.3 Feb.
ALEOS 4.2.3 User Guide Low Power Table E-16: Common: Low Power Command Description VLTG Set or query the voltage level at which the device goes into low power mode. • n=0 : Ignore voltage for power control. n=threshhold in tenths of volts Example: ATVLTG=130 would place the device in a low power use, standby state if the voltage goes below 13.0V. • PTMR Number of minutes after the VTLG power down event happens until the device enters the low power mode. If VLTG is 0 (zero), this setting does nothing.
Logging This group includes commands specific to the internal log. Table E-18: Logging Command Description *DBGPPPLVL Sets the logging level for the PPP stack. • n=0 : No logging *DBGIPLVL • n=1 : Log client events (default) • n=2 : Log server events • n=3 : Log client and Server events Sets the logging level for the IP subsystem. • n=0 : No logging *DBGCOMMLVL *DBGETHLVL • n=1 : Log errors (i.e. invalid/corrupt packets, etc.). • n=2 : Log the header of all received packets.
ALEOS 4.2.3 User Guide GPS This group includes commands specific to GPS features and the device line. Table E-19: GPS: Server 1 Command Description *PPIP 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.100 *PPPORT Port where GPS reports are sent. • n=1-65535 *PPTIME GPS Report Time Interval. See also *PPMINTIME, *PPTSV, +CTA. n=seconds (1 - 65535) Note: Your cellular carrier may impose a minimum transmit time.
Table E-19: GPS: Server 1 (Continued) Command *PPGPSR *PPSNF Description GPS report type. • n=0 : Use legacy reports specified in *MF value. Note: Must also have *PPDEVID=0. • n=0x11 : Standard GPS Report • n=0x12 : Standard GPS Report + UTC Date • n=0x13 : Standard GPS Report + UTC Date + RF data • n=0xD0 : Xora reports.
ALEOS 4.2.3 User Guide Table E-19: GPS: Server 1 (Continued) Command Description *PPSNFM Store and Forward Minimum Reports. Specifies the minimum number of reports that must be stored before they are forwarded to the server. The data is then sent to the server in packets that contain at least this number of reports. • n=0-255 *PPMAXRETRIES Maximum number retries when in Simple Reliable Mode.
Table E-20: GPS: Misc (Continued) Command *PPREPORTINPUTS Description Enable input reporting. • n=0 : Disabled • n=1 : Enabled Note: If both AT*PPCOM1000=1 and AT*PPREPORTINPUTS=1 are enabled, the AirLink Device digital inputs will be reported and the COM1000 inputs will be ignored. *PPGPSDATUM *PPTCPPOLL Specifies the GPS datum to use for position reports. For accurate results, this value should match the datum used by receiving mapping application.
ALEOS 4.2.3 User Guide Serial Port Table E-21: GPS: Serial Port Command *PPLATS Description Local ATS - Causes GPS reports to also be sent out the serial or Ethernet link every n seconds, when there is a PPP connection to the serial host or a connection to the Ethernet port is established. • n=0 : Disable • n=1-255 seconds Tip: Sends to the PPP peer IP S110 with the Destination Port number S53. *PPLATSR *PPLATSEXTRA Indicates the type of GPS report to send to the local client (PPP/SLIP peer).
Table E-21: GPS: Serial Port (Continued) Command *PGPSD Description 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. • Any messages put into SnF during this switchover delay period will be sent OTA, when coverage is re-acquired.
ALEOS 4.2.3 User Guide Table E-22: CDMA (Continued) Command ~NAMLCK Description The NAMLCK is the device'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 Note: If the number is accepted by the device, the OK result code is returned. If the number is rejected, the ERROR result is returned.
I/O I/O includes configuration commands for the digital inputs and relay outputs. Some values shown as a part of this group are not changeable but reflect the current status. Only those devices with available inputs and outputs will display this group. Table E-23: I/O Command Description *DIGITALIN1 Query individual digital inputs. The digital inputs report either a 0 (open) or 1 (closed). • n=1-4 Input number *DIGITALIN2 *DIGITALIN2 *DIGITALIN4 *RELAYOUT1 Set or query the relay outputs.
ALEOS 4.2.
