ALEOS Configuration User Guide 20080616 Rev 2.
Preface Important Notice Due to the nature of wireless communications, transmission and reception of data can never be guaranteed. Data may be delayed, corrupted (i.e., have errors) or be totally lost.
ALEOS User Guide Notwithstanding the foregoing, in no event shall Sierra Wireless and/or its affiliates aggregate liability arising under or in connection with the Sierra Wireless product, regardless of the number of events, occurrences, or claims giving rise to liability, be in excess of the price paid by the purchaser for the Sierra Wireless product. Patents This product includes technology licensed from QUALCOMM® 3G. Manufactured or sold by Sierra Wireless Inc.
Preface Consult our website for up-to-date product descriptions, documentation, application notes, firmware upgrades, troubleshooting tips, and press releases: www.sierrawireless.com Revision History Revision number Release date Changes 1.x 2009 ALEOS 4.0 documentation draft created. 2.x 2010 User Guide rebranded to current standards. ALEOS 4.0.7 release udates incorporated in this guide. Rev 2.0 C Aug.
ALEOS User Guide 6 20080616
Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 About Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Tools and Reference Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Configuring your AirLink device . . . . . . . . . . . . . . . . .
Contents WAN/Cellular Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33 SIM PIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Keepalive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Data usage using Keepalive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 LAN/WiFi Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Trusted IPs - Inbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Trusted IPs - Oubound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 MAC Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Services Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 ACEmanager . . . . . . . . . . . . . . . . . . . . . . . . . . .
ALEOS User Guide GPS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 GPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 GPS Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 AirLink device Supported Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Remote Access Protocol (RAP) . . . . . . . . . . . . . . . . .
Contents Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Change Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Advanced . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Events Reporting Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125 Event Trigger . . . . . . . . . . . . . . . . . . . . . . .
ALEOS User Guide Windows Dial-up Networking (DUN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Installing a device driver for AirLink device . . . . . . . . . . . . . . . . . . . . . . . . 143 Creating a Dial-Up Networking (PPP) Connection . . . . . . . . . . . . . . . . . . . 148 Connecting to the Internet Using DUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 ACEview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Global Positioning System (GPS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 GPS Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 AirLink device Supported Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Remote Access Protocol (RAP) . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 National Marine Electronics Association (NMEA) . . . . . . . . . . . . . .
ALEOS User Guide TAIP Emulation Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 TAIP ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 TAIP Command Emulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 Supported TAIP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 Messages Over-the-Air (Remote) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents GPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 Misc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 Serial Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 Cellular . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 CDMA. . . . . . . . . . . . . . . . . . . . .
ALEOS User Guide 10 20080616
1 1: Introduction Overview • Overview • About Documentation • Tools and Reference Documents ACEmanager™ is the free utility used to manage and configure the AirLink 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 User Guide No.
Introduction Tools and Reference Documents Command 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 on the AirLink device and the indicators.
ALEOS User Guide 14 20080616
2 2: Configuring your AirLink device • • • • Main Menu Tabs Configuring Operation Modes Applying Templates After powering on the AirLink Device and ensuring that you have an IP-based connection set up (Ethernet, USB/net, DUN, etc). You can log on to ACEmanager by entering http://192.168.13.31:9191 in your browser or enter other IP addresses depending on the interface you select (As shown in the table below). Interface AirLink device Connected Device Ethernet Private default 192.168.13.31* 192.168.
ALEOS User Guide • 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 To configure your AirLink device, you have two options.
Configuring your AirLink device and port destined for the Device Port are unwrapped and sent out the serial port. • TCP and TCP PAD: Any data received on the serial port is packaged into TCP messages and sent to the associated connection’s IP address and Port (described later). Any data received from the TCP peer is unwrapped and sent out the serial port. Data Communication • Public and Private Modes: The method used by the AirLink device to pass an IP address to a connected device.
ALEOS User Guide Note: AT commands work for the port on which they are executed. For example, if the user types ATE1 and then AT&W using a USB/serial port connection, it will set the USB/ serial port to Echo On but not the telnet connection or the RS232 serial port. PassThru Mode In PassThru mode, the AirLink device does not behave normally, all port communication is passed directly between the internal hardware and the computer connected directly to the device.
Configuring your AirLink device a. Configure your AirLink device in ACEmanager. b. Click on Apply (upper right hand) so that the conifguration settings write to the device. c. Click on Download (menu tab) to save the template. A confirmation dialog box comes. Figure 2-3: ACEmanager: Downlod template message d. Click on Ok. e. Click on Save button, once the File Download box displays. Figure 2-4: ACEmanager: File Download box Note: Some of the configuration settings are specific to individual devices.
ALEOS User Guide Figure 2-5: ACEmanager : Load 3. Browse and Select the template you have saved (you may need to change folders if you saved it to a different location). Figure 2-6: ACEmanager: select and load template 4. Click on Upload File to device. 5. Click on Load Template. 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. 6. Click the Apply button on the toolbar to write the configuration to the device.
Configuring your AirLink device Caution: Many of the configuration settings will not take effect until the device has been reset. Tip: You can use common settings on one device to configure those same settings on another device even of a different type. For example, you can use the serial settings of a device (such as PinPoint X or Raven X) to configure the serial settings of a AirLink device.
ALEOS User Guide 22 20080616
3 3: View Status • • • • • • • • • • Home WAN/Cellular LAN/WiFi VPN Security Services GPS Serial Applications About The Status tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink devices. Note: Categories not applicable to a device line will not appear as selectable. For example, Status>GPS will only be available for devices with the GPS feature set. All of the fields in the “Status” group have read-only parameters and provide information about the AirLink Device.
ALEOS User Guide Figure 3-1: ACEmanager: Status - Home Phone Number The phone number (programmed into the device) is part of 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 contact the AirLink device from the Internet if you have a mobile terminated or Internet accessible account. Network State Not Connected or Connected. Current state of the cellular radio.
View Status Figure 3-2: ACEmanager: Status - WAN/Cellular Command Description Cellular IP Address Cellular WAN IP Address. Ethernet IP Address Ethernet IP Address. This is present in WAN failover mode only. Keepalive IP Address The IP address that WAN keepalive uses to test cellular connectivity. Keepalive Ping Time The amount of time between keepalive pings in seconds. DNS Server 1 First DNS IP addresses of cellular or Ethernet network.
ALEOS User Guide Figure 3-3: ACEmanager: Status - LAN/WiFi Command Description USB Mode Indicates which virtual mode of the USB port is set. LAN IP Packets Sent Number of IP packets sent to the host interface since the system startup. LAN IP Packets Received Number of IP packets received from the host interface since the system startup. VPN The VPN section gives an overview of the VPN settings and indicates whether a VPN connection has been made.
View Status Command Description Incoming out of band Incoming out of band. Outgoing out of band Outgoing ALEOS out of band. Outgoing Host out of band Outgoing Host out of band. VPN 1 to 5 Disabled, Enabled, Connected. The status of the IPSec VPN client or GRE client. Security The security section provides an overview of the security settings on the AirLink Device. Figure 3-5: ACEmanager: Status - Security Command Description Port Filtering Inbound Enabled or disabled.
ALEOS User Guide Figure 3-6: ACEmanager: Status - Services Command Description ACEmanager ACEmanager access mode. Enable time update Daily SNTP updates of the system time.
View Status GPS Note: The GPS tab that displays in ACEmanager, is applicable to PinPoint line and MP line devices. Figure 3-7: ACEmanager: Status - GPS Command Description GPS Fix 0 = No Fix, 1 = GPS Fix, 2 = WAAS Satellite Count Shows how many satellites the GPS receiver can detect. Latitude Latitude of the GPS receiver. Longitude Longitude of the GPS receiver. Heading The direction in which the AirLink device is moving.
ALEOS User Guide Serial Note: The Serial tab that displays in ACEmanager, is applicable to all Sierra Wireless AirLink devices except Raven XE. Command Figure 3-8: ACEmanager: Status - Serial Description 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. On startup, typing ATMD0 within 5 seconds changes the mode to normal (AT command) mode.
View Status Applications The Application section of the Status group provides information on status of Garmin device. Figure 3-9: ACEmanager: Status- Applications About The About section of the Status group provides basic information about the cellular device. Figure 3-10: ACEmanager: Status - About Command Description device name Name of the AirLink device (up to 20 characters long) to use when performing IP address change notifications to IP Manager.
ALEOS User Guide Command Description Ethernet Mac Address The MAC address of the Ethernet port. ALEOS Software Version Displays version of ALEOS software running on the AirLink Device. device Hardware Configuration Indication of the internally configured hardware. Boot Version The version of boot code installed in the device.
4 4: WAN/Cellular Configuration The WAN/Cellular tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink devices. The WAN/Cellular section allows changes to the cellular connection and main operating mode of the AirLink Device. Note: The Network Credential and Advanced settings will appear differently and is dependent on cellular carrier settings. HSPA/GPRS only EV-DO/1x only Figure 4-1: ACEmanager: WAN/Cellular - EV-DO /1X Rev 2.0 C Aug.
ALEOS User Guide Carrier type EV-DO/1X Command Dormancy Idle Timer (secs) Description Inactivity timer, in seconds. Typical network settings cause a link to go dormant after 10 to 20 seconds of inactivity, no packets transmitted or received. This time can be shortened to release the physical RF link sooner when the application only transmits short bursts. • n=0 : Allows the cellular network to determine the inactivity timer.
WAN/Cellular Configuration Carrier type Command Description EV-DO/1X Network Roaming Preference Automatially allows home and roaming network preference. EV-DO/1X Auto PRL Schedule (days) Indicates PRL update schedule. 0 = Disable. Check profile 1 Params Enables checking and updating the Profile 1 Parameters. NAI Sets the Network Access ID. EV-DO/1X EV-DO/1X Not all carriers support this feature. Not all carriers support this feature. Not all carriers support this feature.
ALEOS User Guide Carrier type All Command Keepalive IP Address Description The IP address that the AirLink Device will ping to determine if there is internet connectivity and make sure this IP address is accessible. Set the IP address or valid internet domain name for the AirLink device to ping to keep itself alive (online). *IPPING must to be set to a value other than 0 to enable pinging. • d.d.d.d=IP address • name=domain name *IPPINGADDR sets the IP address you want to use for the connection test.
WAN/Cellular Configuration Carrier type HSPA/ GPRS Command Description Set carrier Operator selection 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).
ALEOS User Guide 2. Click on Save. 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.
5 5: LAN/WiFi Configuration • • • • • • Addressing Host Port Routing Wi-Fi devices USB Global DNS PPPOE 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 User Guide Figure 5-1: ACEmanager: LAN/WiFi - Addressing Command Host Public Mode Description Sets the Host Interface that uses the Public IP address grated by the cellular network or if all should use private IP addresses. All host interfaces which are not using the public IP address will use private IP addresses. 0 = Ethernet Uses Public IP ; 1 = All Hosts Use Private IP's - This is the default.
LAN/WiFi Configuration Tip: If you are using Private Mode for all hosts (*HOSTPRIVMODE=1), you will need to make sure that device IP, Starting IP and Ending IP are on the same subnet defined by the DHCP network mask. If the subnet mask is 255.255.255.0, it is safe to use 192.168.x.y for each as long as the x is the same number (0 in the example screen shot above) and the y is different (1 and 2 in the example) and between 0 and 254.
ALEOS User Guide Figure 5-2: ACEmanager: LAN/WiFi - Host Port Routing Command Description Primary Gateway Your device is the Primary Gateway for the network behind a router connected to it and ALEOS responds to ARPs for all non-host ethernet subnets. Host Network 2 and Host Network 3 Network to route to host IF. Host Network 2 and 3 are secondary networks connected to the AirLink device. For example, 192.168.10.0.
LAN/WiFi Configuration Figure 5-3: ACEmanager: LAN/WIFI Command Description Enable Wireless Access Point WI-Fi on or Wi-fi off. Allows you to disable or enable the Wi-Fi access point. If you are using the MP in an environment wheres security or safety require that you disable Wi-Fi, you can turn Wi-Fi off here. The WAN and Ethernet LAN connections will remain active. SSID/Network Name The default network name is 'MP'. Hide SSID Hide or Show.
ALEOS User Guide Open Open Wi-Fi protocol is not password protected and has no additional conifguration requirements in ACEmanager. Note: Selecting the encryption type will enable additional configuration option Shared WEP WEP or Wireless Encryption Protocol is the least secure, but most supported encryption method. Figure 5-4: ACEmanager: WIFI - Shared WEP Command Description Key Length 64 bit, 128 bit, Custom. WEP is available with shorter 64 bit keys or longer 128 bit keys.
LAN/WiFi Configuration Note: WPA or WPA2 is determined by the encryption scheme selected. TKIP is WPA. AES is WPA2. Figure 5-5: ACEmanager: WiFi - WPA/WPA2 Personal Command Description WiFi Encryption TKIP or AES. Defines what encryption scheme to use under WPA. Options are Temporal Key Integrity Protocol (TKIP) and Advanced Encryption Standard (AES). WPA Passphrase By default this is 'DeviceWPAPassphrase'.
ALEOS User Guide Figure 5-6: ACEmanager: WiFi - WPA/WPA 2 Enterprise Command Description WiFi Encryption TKIP or AES. Defines what encryption scheme to use under WPA. Options are Temporal Key Integrity Protocol (TKIP) and Advanced Encryption Standard (AES). Primary or Secondary Radius Server IP This is the IP address of your enterprise RADIUS server. These servers must be accessible ALL the time or clients will not be able to connect via Wi-Fi.
LAN/WiFi Configuration Figure 5-7: ACEmanager : LAN/WiFi - USB Note: There is a USBnet/ USBserial driver for the Win7 64 bit USB. Command Note: The change to the USB mode is immediate and generally does not require a reboot.. Description USB Device Mode *USBDEVICE=n This parameter alters the default startup data mode for the USB port. Device USB IP The USB/net IP address of the AirLink Device. By default this is set to 192.168.14.31.
ALEOS User Guide Figure 5-8: Found New Hardware Wizard a. To start the install of the USB virtual Ethernet driver, select No, not this time and click Next. b. Select Install from a list of specific location and click Next. Figure 5-9: 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.
LAN/WiFi Configuration Figure 5-11: Hardware Wizard : Installing c. Click Finish to complete the installation. The driver should be enabled without any need to reboot your computer. Figure 5-12: Hardware Wizard : Finish Virtual Ethernet The USB Ethernet connection will show up in your Network Connections as a Local Area Connection.
ALEOS User Guide You can also 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-14: System Properties d. Click on the + in front of Network Adapters. The newly installed driver, AirLink USB Ethernet/RNDIS, should be displayed.
LAN/WiFi Configuration Once the driver is installed, you can use the USB port just like a standard Ethernet port. Virtual Serial You can 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-16: System Properties d. Click on the + in front of devices. The newly installed driver, AirLink USB Serial Port, should be displayed.
ALEOS User Guide Figure 5-17: 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/WiFi Configuration Figure 5-19: 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-20: 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 User Guide Note: If there are no alternate DNS defined, the default is the cellular network DNS sever. Figure 5-21: ACEmanager: LAN /WiFi- Global DNS Command Description DNS Updates Disabled or Enabled. By default this is set to Disabled. Primary DNS Primary carrier DNS IP Address. Secondary DNS Secondary carrier DNS IP Address. Alternate Primary DNS Alternate primary DNS address. This is optional. If the primary DNS is unavailable, this DNS address will be used.
LAN/WiFi Configuration Tip: You may need to use Private Mode to configure the IP address of your AirLink device to be available on a LAN. Note: To configure a PPPoE connection on Microsoft Windows XP, 2000 or NT, you will need administrator privileges to the computer you are configuring or access granted by an administrator on the network to add/remove devices to your computer.
ALEOS User Guide Note: ACEmanager shows the existing values for PPP User ID and PPP password encrypted and character padded. Optional: Configure *Device Name a. In ACEmanager, select Dynamic DNS from the groups on the left, under Services. b. Enter a name for device Name, such as AirLink device or the ESN. The name you choose for device Name will not affect the connection but may need to be configured in PPPoE settings for the router, device or computer you will be connecting to your AirLink device.
6 6: VPN Configuration • Global Settings • VPN 1 to 5 • Log The VPN tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink devices. The AirLink Device can act as a Virtual Private Network (VPN) client, 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 two tunneling protocols, IPsec and GRE. Both can be used at the same time.
ALEOS User Guide Figure 6-1: ACEmanager:VPN - Global settings Command Description Incoming out of Band Disabled or Enabled. Disables or Enables port forwarding rules. Outgoing Management Out of Band Outgoing ALEOS out of band can be blocked or allowed. Outgoing Host Out of Band Outgoing Host out of band can be blocked or allowed. NAT-T NAT-T Enable is disabled by default. VPN 1 to 5 Each of the VPN tunnels 1 to 5, can be configured as IPSec, GRE or IPSec and GRE.
VPN Configuration Figure 6-2: ACEmanager: VPN 1 - VPN Command Description VPN # Type Tunnel Disabled or IPsec tunnel. Use this option to enable or disable the VPN tunnel. If custom settings are used, they will be saved and the tunnel can be disabled and reenabled without needing to reenter any of the settings. The IPsec VPN employs the IKE (Internet Key Exchange) protocol to set up a Security Association (SA) between the AirLink Device and a Cisco (or Cisco compatible) enterprise VPN server.
ALEOS User Guide Command Description My Identity If these fields are left blank, My Identity will default to the WAN IP address assigned by the carrier and Peer Identity will default to the VPN Server IP. For a fully qualified domain name (FQDN), these values should be preceded by an ‘@’character (@www.domain.com). For user-FQDN, these values should include a username (user@domain.com) Peer Identity Required in some configurations to identify the client or peer side of a VPN connection.
VPN Configuration Command Description NAT-T Keep Alive Interval Length of time between NAT-T keep alive packets. The default is set to 20 seconds. Users who have devices behind the carrier firewall, and who need to use IPSec, NAT-T feature is useful in such scenarios. As the carrier is performing NAT on the IP traffic, the key exchange required for IPSec cannot be performed, preventing operation of IPSec behind the firewall.
ALEOS User Guide Figure 6-4: ACEmanager: VPN - Log 62 20080616
7 7: Security Configuration • Port Forwarding and DMZ • Port FilteringInbound • Port FilteringOutbound • Trusted IPs Inbound • Trusted IPs Oubound • MAC Filtering The Security tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink devices.
ALEOS User Guide Note: Port Forwarding and DMZ require Private Mode. Figure 7-1: Port Forwarding Figure 7-2: ACEmanager: Security - Port Forwarding Note: The total number of port forwarding supported is 19. Command Description DMZ IP IP address of a DMZ. The AirLink Device allows a single client to connect to the Internet through a demilitarized zone (DMZ). The DMZ is particularly useful for certain services like VPN, NetMeeting, and streaming video that may not work well with a NAT router.
Security Configuration Command Description Host IP IP address of a device connected to the Host I/F interface. Private Port The single or starting port on the device at the Host IP. If a public end port is defined, the private port range will be the difference of the public start and end point. Example of configuring a port forward rule for port forwarding range of 5 ports on an Ethernet connected device: 1. Set number of PF entries to 1. 2. Click on “Add More” to display a rule line. 3.
ALEOS User Guide Figure 7-3: ACEmanager: Security - Port FIltering-Inbound Command Description Inbound Port Filtering Mode 0 = Not Used; 1 = Blocked Ports; 2 = Allowed Ports Allowed Ports - All ports through which traffic is allowed are listed below. Blocked Ports - All ports though which traffic is blocked are listed below. Start Port The first of a range or a single port on the public network (cellular network accessible).
Security Configuration Figure 7-4: ACEmanager: Security - Port Filtering-outbound Command Outbound Port Filtering Mode Description Allowed and blocked ports through which traffic is either allowed or blocked (respectively) are listed. Note: Outbound IP filter supports up to 9 ports. Start Port The first of a range or a single port on the LAN. End Port The end of the range on the LAN.
ALEOS User Guide Figure 7-5: ACEmanager: Security - Trusted IPs - Inbound (Friends) Command Description Inbound Trusted IP (Friend’s List) Mode Disabled or Enabled. Disables or Enables port forwarding rules. Non-Friends Port Forwarding Non-Friends port forwarding is like an allow rule for any of the forwarded ports. If it is enabled, the port forwarding rules apply to all incoming packets. If it is diabled, only Friends List IPs get through.
Security Configuration Figure 7-6: ACEmanager: Security - Trusted IPs - Outbound Command Description Outbound Firewall Mode Disabled or Enabled. Disables or Enables port forwarding rules. Trusted IP Each entry can be configured to allow a single IP address, for example 64.100.100.2, or the IP addresses from a complete subnet, such as 64.100.10.255 allowing all IP addresses from 64.100.10.0 to 64.100.10.255. MAC Filtering MAC filtering restricts LAN connection access.
ALEOS User Guide Command Description MAC Filtering Enable or disable MAC Filtering. MAC Filtering Mode Allows or blocks the MAC Addresses listed. You can add the MAC addresses by clicking on Add More. MAC Address This is the MAC Address of the interface adapter on a computer or other device.
8 8: Services Configuration • • • • • • • ACEmanager Low Power Dynamic DNS SMS Telnet Email (SMTP) Management (SNMP) • Time (SNTP) • Logging The Services tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink devices. The services sections allows configuration of external services that extend the functionality of the AirLink Device.
ALEOS User Guide Command Description Account Name Your account name Identity Connected or Not Connected. Status Displays the status of ACEnet connection. ACEmanager port Port for ACEmanager, for example, 9191. Reboot the device if you change the port settings. Low Power The AirLink device will put itself into a low power using mode when configured events occur. Low Power mode is essentially a standby mode which uses minimal power while being ready to “come alive” quickly.
Services Configuration Command Voltage Levl Low Power Enable (.1Volt) Description Set or query the voltage level at which the device goes into low power mode. • Ignore voltage for power control. • 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. Note: When Ignition sense is enabled, there is no no need to configure this parameter with ignition sense enable.
ALEOS User Guide Dynamic DNS Dynamic DNS allows a AirLink Device WAN IP address to be published to approprietary Sierra Wireless dynamic DNS service called IP Manager. If you have a fleet of Sierra Wireless AirLink devices or even if you only have one, it can be difficult to keep track of the current IP addresses, especially if the addresses aren’t static but change every time the devices connect to the cellular network.
Services Configuration Figure 8-3: ACEmanager: Services - Dynamic DNS Command 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. This is the domain name of the server configured for *IPMANAGER1 IP Manager 1 The IP address or domain name of the dynamic DNS server which is running IP Manager.
ALEOS User Guide • Top Level Domain (TLD): The TLD is the ending suffix for a domain name (.com, .net, .org, etc.) • Country Code Top Level Domain (ccTLD): This suffix is often used after the TLD for most countries except the US (.ca, .uk, .au, etc.) • Domain name: This is the name registered with ICANN (Internet Corporation for Assigned Names and Numbers) or the registry for a the country of the ccTLD (i.e. if a domain is part of the .ca TLD, it would be registered with the Canadian domain registry).
Services Configuration Once your device’s IP address has been updated in IP Manager, it can be contacted via name. If the IP address is needed, you can use the domain name to determine the IP address. Note: The fully qualified domain name of your AirLink device will be a subdomain of the domain used by the IP Manager server.
ALEOS User Guide SMS Command Device Action SMS Response Note: All responses start with "reply from [modem name]:" status None Raven-line, pinpoint-line or MP-line [Network IP] [Network Status]: [technology type] RSSS [original] PinPoint/MP adds Lat = [Latitude] Long = [Longitutde] Time = [hh:mm:ss] Status reset Resets the device 30 seconds after the first response message is sent. First message: Reset in 30 seconds Second message: Status message when back up.
Services Configuration SMS Gateway The SMS gateway feature allows messages to or from a locally connected host to use SMS for over the air transmission. Figure 8-4: ACEmanager: Services - SMS Rev 2.0 C Aug.
ALEOS User Guide Command SMS Destination Description Allows you to chose where the SMS message is going to be locally received and if it is going to be received by ALEOS command parser or by a host on the other side (Host, USB serial or IP) select the SMS destination. Select your destination for the SMS and based on your selection additional fields may become available. Incoming messages are sent to the specified host. This can be a serial interface or an IP and port.
Services Configuration Command Description SMS Message Body Format The only SMS body format available is the ASCII-Hex. The other types of SMS body format are set SMS protocols. Non Trusted Read Security This refers to the phone numbers entered in the trusted phone number list. Indicate with your selection - Access or No Access if you want to allow or block non trusted and trusted phone numbers to either read or write. Default is “No Access” and trusted phone number gets read or write.
ALEOS User Guide The hex string is converted to bytes before sending. For example: at*smsm2m_8="17604053757 5448495320495320412054455354" sends the message "THIS IS A TEST" but the message is 8 bit data.
Services Configuration Command Description AT Server mode Select either Telnet or SSH mode. AT Telnet/SSH Port Sets or queries the port used for the AT Telnet / SSH server. If 0 is specified, the AT Telnet server will be disabled. The default value is 2332. • n=0 : Disabled. • n=1: 65535 Tip: Many networks have the ports below 1024 blocked. It is recommended to use a higher numbered port. After configuring SSH, apply and rest your device.
ALEOS User Guide Figure 8-6: ACEmanager: Services - Email (SMTP) Command Server IP Address Description Specify the IP address or Fully Qualified Domain Name (FQDN) of the SMTP server to use. • d.d.d.d = IP Address • name = domain name (maximum: 40 characters). From email address Sets the email address from which the SMTP message is being sent. • email = email address (maximum: 30 characters). User Name (Optional) Specifies the username to use when authenticating with the server.
Services Configuration Authentication ensures SNMP messages coming from the agent, such as the PinPoint XT, have not been modified and the agent may not be queried by unauthorized users. SNMPv3 uses a User-Based Security Model (USM) to authenticate and, if desired or supported, message encryption. USM uses a user name and password specific to each device. The PinPoint XT can be configured as an SNMP agent and supports SNMPv2c and SNMPv3.
ALEOS User Guide Command Description 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. 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.
Services Configuration Figure 8-9: ACEmanager: Services - Logging Command PPP Logging Detail IP Logging Detail COM Port Logging Detail Ethernet Logging Detail DHCP Logging Detail Description Sets the logging level for the PPP stack. • No logging • Log client events (default) • Log server events • Log client and Server events Sets the logging level for the IP subsystem.
ALEOS User Guide 88 20080616
9 9: GPS Configuration • • • • • GPS Server 1 Server 2 to Server 4 Misc Local/Streaming The GPS tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink devices. 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 User Guide A GPS receiver, such as the AirLink device, requires signals from four or more satellites in order to determine its own latitude, longitude, and elevation. Using time synced to the satellite system, the receiver 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.
GPS Configuration • HTE • Spillman • and others... 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 User Guide • Protocol: What is the GPS protocol used by your tracking application and what type of reports will you need? • Datum: What is the datum supported by your tracking application? • Dynamic IP Address: Will you need DNS support to handle a dynamic IP address account? • Multiple GPS servers: Will you need to have GPS data send to more than one GPS server? Server 1 Figure 9-1: ACEmanager: GPS Server 1 Table 9-1: GPS: Server 1 Command Description Report Server IP IP address where G
GPS Configuration Table 9-1: GPS: Server 1 Command Report Interval Time Description GPS Report Time Interval. See also *PPMINTIME, *PPTSV, +CTA. n=seconds (1 - 65535) Note: Your cellular carrier may impose a minimum transmit time. Caution: A report time of less than 30 seconds can possibly keep an RF link up continuously. This will eventually cause the AirLink Device to overheat and shutdown. An RF resource may continue be tied up to transfer small amounts of data.
ALEOS User Guide Table 9-1: GPS: Server 1 Command Description Use Device ID in Location Reports Whether or not the AirLink Device should include the 64-bit device ID in its GPS reports. *PPDEVID MUST be 1 if the device uses a Dynamic IP. n=0 : Disable ID. n=1 : Enable/display ID. SNF Reliable Mode Store and Forward Reliability: GPS reports will be retransmitted if not acknowledged by the server.
GPS Configuration Figure 9-2: ACEmanager: GPS - Server 2 Command Description Report Server IP 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 Server Port Port where GPS reports are sent. • n=1-65535 Report Interval Time GPS Report Time Interval. See also *PPMINTIME, *PPTSV, +CTA. n=seconds (1 - 65535) Note: Your cellular carrier may impose a minimum transmit time.
ALEOS User Guide Command Stationary Vehicle Timer (Minutes) Description Timer for Stationary Vehicles. Time interval in minutes that the AirLink Device 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.
GPS Configuration Command SNF Mode Description Store and Forward Behavior. When *PPSNF=1, the type of Store and Forward behavior is defined by: • n=0 : Normal Store and Forward. Data is stored when the AirLink Device is out of cellular coverage; when the AirLink Device is in coverage, data is sent to server as soon as possible. This is the default form AirLink Device devices with RAP version 1.3 or lower. • n=1 : Data sent only when polled.
ALEOS User Guide Misc Figure 9-3: ACEmanager: GPS - Misc Table 9-2: GPS: Misc Command Enable input event reports Description Enable sending input changes as events (different report types). • n=0 : Disable • Odometer Enable n=1 : Enable Enable odometer reporting. • n=0 : Disabled (default) • n=1 : Enabled Odometer Value (meters) The current odometer value of the AirLink Device. The value is in meters. Maximum value is approximately 4.3 billion meters (2.5 million miles).
GPS Configuration Table 9-2: GPS: Misc Command *PPREPORTINPUTSR eport inputs on RAP 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. GPS Datum Mode *PPTCPPOLLTCP GPS Port Specifies the GPS datum to use for position reports. For accurate results, this value should match the datum used by receiving mapping application.
ALEOS User Guide Command Local Reporting Time Interval 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. • Disable • 1-255 seconds Tip: Sends to the PPP peer IP S110 with the Destination Port number S53. Local Report Type Local Extra Report Ports Indicates the type of GPS report to send to the local client (PPP/SLIP peer). See *PPGPSR.
GPS Configuration Command Persistent GPS Repory Delay 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 User Guide 102 20080616
10 10: 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 User Guide Figure 10-1: ACEmanager: Serial - Port Configuration 104 20080616
Serial Configuration Table 10-1: Serial Port Command Startup Mode Default Description 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 User Guide Table 10-1: Serial Port Command Description 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. Enable CTS Assert CTS when there is network coverage. DTR Mode Use DTR from serial device, or ignore DTR. (Same as S211). Quiet Mode Disable or enable display of device responses. AT Verbose Mode Configure AT command responses. Call Progress Result Mode When enabled adds 19200 to CONNECT messages.
Serial Configuration Figure 10-2: ACEmanager: Serial - Port Configuration (Raven line devices only) Command TCP Auto Answer Description This register determines how the MP device responds to an incoming TCP connection request. The MP device remains in AT Command mode until a connection request is received. DTR must be asserted (S211=1 or &D0) and the MP device must be set for a successful TCP connection. The MP device will send a “RING” string to the host.
ALEOS User Guide Command Telnet Echo Mode Enable ENQ on TCP Connect Description Telnet Client Echo Mode. • n=0 : No Echo • n=1 : Local Echo (Default) • n=2 : Remote Echo Outputs an ENQ [0x05] after the TCP CONNECT delayed by the Delay Connect Response time (S221). • n=0 : Disabled (Default). • Command MD UDP Auto Answer Description Default power-up mode for the serial port: When the MP device is power-cycled, the serial port enters the mode specified by this command after 5 seconds.
Serial Configuration Command Allow Any Incoming IP Description Allow IP address. • n=0 : Allow only the IP address specified in S53 to connect when UDP auto answer is enabled (S82=2). • n=1 : Allow any incoming IP address to connect when UDP auto answer is enabled (S82=2). Always subject to any Friends filters that may be defined. Allow All UDP Accepts UDP packets from any IP address when a UDP session is active.
ALEOS User Guide Command Description device PPP IP The IP for the AirLink device when comming through RS232. Host PPP IP The IP for the Host RS232 Interface. Command Description Passthrough Init String Any AT Command string to be passed to the OEM module before entering PASSTHRU mode, e.g. AT&S1V1, etc. • string=AT command(s) Passthrough Init Refresh (Minutes) Number of minutes of inactivity in PASSTHRU mode to resend the *PTINIT string to the hardware module.
Serial Configuration Command Description Variable Mask (hex) 16 bit hex mask to use when extracting the ID. Specify which bits in the ID field to use. This parameter is used when the when the Mode Default (MD) is set to : • hex 63 hh = 00-FFFF hex value • hh = 00 [default] no mask • use all 16 bits hh = 0F • use only the low order 4 bits IP List Dial This allows access the Modbus IP list using the first two digits of the dial string.
ALEOS User Guide 112 20080616
11 11: Application Configuration The Application tab that displays in ACEmanager, is applicable to PinPoint X and PinPoint XT AirLink devices. Garmin provides navigation devices for versatile fleet monitoring solutions. AirLink devices provides an internet access to Garmin devices and a mechanism to enable via cellular. ALEOS also monitors links to the Garmin and communication between the Garmin and the server. Figure 11-1: ACEmanager: Applications To configure in ACEmanager, Set HostMode to TCP mode: 1.
ALEOS User Guide Figure 11-3: ACEmanager: Serial - Port Configuration 3. Configure the serial port. To communicate with Garmin, set it to 9600, 8n1 with No Flow Control and DTR Mode = 0 Figure 11-4: ACEmanager: Serial - Port Configuration parameters 4. Configure the Garmin Parameters. Under the Applications tab, set the Garmin Device Attached to 1 to enable talking to the Garmin. Figure 11-5: ACEmanager: Applications After all the parameters have been set, reboot AirLink device and apply the changes.
12 12: Report Configuration • Server 1 The Report tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink Raven Line devices only. The report server is the main server where the Events Reports will be sent. It is the same as a RAP or “ATS” server. A primary server can be configured without a failover or redundant server which would be the same as a single server.
ALEOS User Guide Command Description Report Server IP IP address where Event Reports are sent (RAP Server IP). Also see *PPPORT. • d.d.d.d=IP address Example: AT*PPIP=192.100.100.100 Server Port Port where GPS reports are sent. • n=1-65535 Minimum Report Time (secs) Report Time Interval. n=seconds (1 - 65535) Note: Your cellular carrier may impose a minimum transmit time. Caution: A report time of less than 30 seconds can possibly keep an RF link up continu- ously.
Report Configuration Command Description SNF Minimum Reports 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 SNF Simple Reliable Max. Retries Maximum number retries when in Simple Reliable Mode.
ALEOS User Guide Reliability Modes Reliability Modes provide methods for the AirLink device and 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 of every eighth packet. The AirLink device considers the eight packets a “window” of outstanding packets.
13 13: I/O Configuration • Current State • 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 and analog inputs and relay and digital outputs as applicable to a specific 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 User Guide Table 13-1: I/O Command Description Digital IN # Query individual digital inputs. The digital inputs report either a 0 (open) or 1 (closed). • n=1-4 Input number Pulse Count On devices with a digital input that can be configured for use as a digital output, the pulse counts will also reflect output changes. *ANALOGIN # Query individual analog inputs. The analog inputs report the voltage in volts.
I/O Configuration Command Relay # Initial Setting Description When the AirLink device reboots, the relay settings you want can be configured here. Relay setting can be: • ON • OFF • Last Value Coefficient for Analog # Coefficient is the multiplier for raw analogs (*ANALOGIN). Offset for Analog # Point at which Transformed Analog starts its count. Units for Analog # This is the label for the Analog measurement. For example, litres or mm etc.
ALEOS User Guide 122 20080616
14 14: Admin • Change Password • Advanced The Admin tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink 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. Enter the user name (admin). 2. Enter the old password. 3. Enter the new password twice. 4.
ALEOS User Guide Figure 14-2: ACEmanager: Admin - Default Command Date and Time Description Sets and queries the internal clock. Either the date and time can be specified, or simply one of the two can be specified in which case the unspecified value will remain unchanged. The date and time are always specified 24 hour notation. • mm/dd/yyyy=date in month/day/year notation • Enable Event Reporting Enable or disable Event Reporting. If you choose to enable, click on Refresh all.
15 15: Events Reporting Configuration • • • • • • • • Digital Inputs Analog Inputs Other Network Configuring Reports Reports Groups Configuring Data The Events Reporting tab that displays in ACEmanager, is applicable across all Sierra Wireless AirLink devices. Events Reporting allows the users to generate reports from the events that take place. Event Reporting Protocol is an intuitive embedded protocol, which automatically formats the messages based on an event trigger.
ALEOS User Guide Data Type Configuration Type Digital Input 1-4 Switch Pulse Accumulator 1-4 Delta Analog Input 1-4 Threshold Scaled Analog 1-4 Threshold GPS Fix GPS Fix Vehicle Speed Threshold Heading Change Delta – zero based Engine Hours Delta RSSI Threshold Network State Network State Network Service Network Service Network Error Rate Delta – zero based Time – Period Report Delta – zero based Power In Threshold Board Temperature Threshold CDMA HW Temp Threshold Event C
Events Reporting Configuration Figure 15-1: ACEmanager: Admin - Advanced Digital Inputs Figure 15-2: ACEmanager: Events Reporting - Events Digital Inputs Each Digital Input (1-4 shown in the figure) will have a Digital Input check on or off box and a category of Reports that you can select or unselect. Analog Inputs Event triggers for the analog inputs and scaled, or transformed, values. Rev 2.0 C Aug.
ALEOS User Guide Figure 15-3: ACEmanager: Events Reporting - Analog Input AVL Event triggers for GPS Fix, Vehicle Speed, and Engine Hours.
Events Reporting Configuration Figure 15-4: ACEmanager: Events Reporting - AVL Network Event triggers for the status of the cellular network connection. Rev 2.0 C Aug.
ALEOS User Guide Figure 15-5: ACEmanager: Events Reporting - Network Other Event triggers for periodic reports, Power, and the temperature of the AirLink device.
Events Reporting Configuration Figure 15-6: ACEmanager: Events Reporting - Other Configuring Reports There are six ways to send a report. The configuration will vary. Rev 2.0 C Aug.10 • Email · Destination email address · Subject, Message · Data groups • SMS text message · Destination Phone number · Message · Data Groups. • SNMP Trap notification · Destination IP is configured in the SNTP menu. • Relay · Select the relay to link to, and Invert if necessary.
ALEOS User Guide • Events Protocol message to a server · Destination report server is configured in the PinPoint Menu · Report format – TLV, Binary, ASCII, XML. See Events Protocol (appendix A) for details. The Reports group allows you to configure whose reports are sent and what date they contain. The Setup page for Reports configures which types of reports will be available. Reports Each report type has its own configuration page.
Events Reporting Configuration Figure 15-8: ACEmanager: Events Reporting - Configure Reports - Reports 7 and 8 Figure 15-9: ACEmanager: Events Reporting - Configure Reports - Report 9 When you allow an additional report type on the Setup page, the sub-group configuration page will be made available. For example, to allow Report 8 and display its configuration page, on the Setup page you would select Allow this Report.
ALEOS User Guide • SNMP - Using the SNMP settings in Common > Other, the report will be included in the SNMP Trap. • Events Protocol - The AirLink device will send out a report to the Reports Server to allow an interface with a wider variety of applications. • Report 7, Report 8, Report 9 - An additional destination for Email, SMS, Relay, or Events Protocol. For the message report types, Email, SMS, and Events Protocol, you will need to select which data you would like included in the report.
Events Reporting Configuration Events Protocol The Events Reporting protocol is a collection of messaging formats. The messages are sent to the Reports Server. The Events Protocol includes four message types. • 1 - Type, Length, Value - The TLV consists of the MSCI ID as the type, the length of the data, and the actual data. • 2 - Binary - A binary condensed form of the TLV message will be sent. • 3 - ASCII - An ASCII condensed and comma deliminated form of the TLV message will be sent.
ALEOS User Guide Groups The data in the device has been put in groups of similar data. For each report, you can specify which groups to included. The groups are: • Standard • AVL • Digital I/O • Analog Input • Network Data • Network Traffic • Device Name • Misc Data For each group you can enable individual fields. The complete list of fields is given in Appendix . Note: Each data item included in a report will add to the size of the report.
Events Reporting Configuration Figure 15-11: ACEmanager: Groups - Analog Input to device Name Rev 2.0 C Aug.
ALEOS User Guide Figure 15-12: ACEmanager: Groups - Network Data to Misc Data Each report type has its own configuration page. If a data group type is not set to be allowed on the Setup page, its configuration page will be hidden. For each data element, select to Include in Report or Don’t Include. The default is for all data to be included. Tip: Excluding data elements can reduce the size of the reports.
Events Reporting Configuration • Enable for Time - The time the report was generated. This will be the same time that is displayed with *DATE. The date will be sent as UTC: month, day, year, hour, minute, seconds. AVL Group GPS data is included in the Automatic Vehicle Location (AVL) data group. • Enable for Satellite Fix - If there is a usable fix with the GPS satellites. • Enable for Latitude - The latitude reported by the GPS. • Enable for Longitude - The longitude reported by the GPS.
ALEOS User Guide • Enable for Network IP - The IP address given by the cellular network. Network Traffic Group The Network Traffic in this group relates to the cellular network and the network between the AirLink device and any directly connected device(s). • Enable for Network Error Rate - The error rate reported by the cellular network. • Enable for Bytes Sent - The number of bytes sent on the cellular network since last reset.
Events Reporting Configuration Miscellaneous (Misc) Data Group The Miscellaneous Data includes temperature rates and other information that does not fit in the other categories. Rev 2.0 C Aug.10 • 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.
ALEOS User Guide 142 20080616
A A: Windows Dial-up Networking (DUN) • Installing a device driver for AirLink device • Creating a Dial-Up Networking (PPP) Connection • Connecting to the Internet Using DUN Dial-up Networking (DUN) allows a computer or other device to use the serial port or ethernet port or USB virtual serial port on your AirLink device to connect to the Internet or private network using PPP just like an analog modem using a standard phone line.
ALEOS User Guide Figure 1-1: Phone and device Options b. Select the devices tab. Figure 1-2: Phone and device Options: devices c. Select Add.
Windows Dial-up Networking (DUN) Figure 1-3: Add Hardware Wizard d. Check Don’t detect my device; I will select it from a list. e. Select Next. Figure 1-4: Add Hardware Wizard: Install New device f. Select (Standard device Types) from the Manufacturers column. g. Select Standard 33600 bps device from the Models column. Tip: If you have the speed for your device configured as something other than the default, use the Standard device that matches the speed you configured. h. Select Next. Rev 2.
ALEOS User Guide Figure 1-5: Add Hardware Wizard: Select Ports i. Check Selected Ports. j. Select the COM port the device is connected to (commonly COM1). k. Select Next. Figure 1-6: Add Hardware Wizard: Finish l. Once the device driver is installed, select Finish. When you return to the Phone and device Options window, you should see the newly installed device “attached to” the correct COM port.
Windows Dial-up Networking (DUN) Figure 1-7: Phone and device Options: devices a. Highlight the device and select Properties. Figure 1-8: device Properties b. Select the device tab. Rev 2.0 C Aug.
ALEOS User Guide Figure 1-9: device Properties: device c. Maximum Port Speed should be set to 115200 (default). d. Select OK to exit. e. Select OK again to exit out of the Phone and device Options. Creating a Dial-Up Networking (PPP) Connection Once you have the driver for the modem installed on your computer, you can set up and configure Dial Up Networking (DUN) to use the modem as your connection to the Internet using PPP.
Windows Dial-up Networking (DUN) 1. Create a new network connection. a. Select Start > Connect To > Show All Connections to open the Network Connections window. Figure 1-10: Windows : Start menu b. Select Create a New Connection under Network Tasks in the menu area on the left. Figure 1-11: Create New Connection c. Select Next to start installing and configuring the DUN connection. Rev 2.0 C Aug.
ALEOS User Guide Figure 1-12: New Connection Wizard d. Select Connect to the Internet. e. Select Next. Figure 1-13: New Connection: Type f. Select Set up my connection manually. g. Select Next. Figure 1-14: New Connection: How do you want to connect? h. Select Connect using a dial-up modem. i. 150 Select Next.
Windows Dial-up Networking (DUN) Figure 1-15: New Connection: Connect using... j. Optional: If you have multiple modems installed on your computer, you may be prompted to select the modem to be used. If you only have one modem installed, this option will be omitted. k. Check Standard 33600 bps Modem. l. Select Next. Figure 1-16: New Connection: Select Modem m. Type in a name for the connection, such as Sierra Wireless AirLink Modem. n. Select Next.
ALEOS User Guide Figure 1-18: New Connection: Phone Number q. Optional: If you have multiple users 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 DUN connection. r. Select Next.
Windows Dial-up Networking (DUN) u. If you want to add a shortcut for this DUN connection to your desktop, check Add a shortcut. v. Select Finish to exit the Network Connection Wizard. Figure 1-21: New Connection: Finish 2. Configure the DUN connection After you complete the New Connection Wizard, there are a few more things you will want to configure in the connection. a. Select Properties. Figure 1-22: DUN Connection Rev 2.0 C Aug.
ALEOS User Guide b. Uncheck Use dialing rules. c. Check Show icon...when connected. d. Select Configure, below the Connect using line. Figure 1-23: DUN Properties e. Select 115200 as the Maximum speed. f. Check Enable hardware flow control. g. Do not check any other option. h. Select OK.
Windows Dial-up Networking (DUN) i. Back at the main properties screen, select the Networking tab. Figure 1-25: Networking j. Select Settings. k. Remove the checks from all three PPP settings. l. Select OK. Figure 1-26: PPP Settings m. Select (highlight) Internet Protocol (TCP/IP) and then select Properties. Tip: For most configurations, you will be obtaining the IP address and the DNS server address automatically. n. Select Advanced. Rev 2.0 C Aug.
ALEOS User Guide Figure 1-27: TCP/IP Properties o. Uncheck Use IP header compression. p. Check Use default gateway on remote network. q. Select OK. Figure 1-28: Advanced TCP/IP Tip: You may want to check the Options tab and change the settings for applications you might be using. The default options are generally applicable for most uses. Caution: Unless specifically directed to do so by Support or your network administrator, you do not need to make any changes to the options on the Security tab. r.
Windows Dial-up Networking (DUN) Connecting to the Internet Using DUN There are two methods you can use to connect with AirLink device to the Internet using DUN, AceView and the Windows DUN connection directly. ACEview ACEview is a small utility which can maintain your DUN connection and monitor the connection of your AirLink device to Provider. If you have not already installed ACEview you can obtain the most recent version from the Sierra Wireless AirLink website.
ALEOS User Guide Tip: When using the DUN connection, make sure the IP Address is set to the local IP address of the modem, 192.168.13.31 by default. e. Select OK. f. OK. Windows DUN You can directly use the Dial-up link for the DUN connection. 1. Start the DUN session. Start > Connect To > Prosoft Technology RadioLinx Modem If you named the connection differently, use the name of the PPP connection you made earlier.
Windows Dial-up Networking (DUN) Note: Select Dial to connect to the modem and the cellular network.The speed shown in the connection is the speed between the modem and your computer, it is not the speed of the modem’s connection to Provider or the Internet. When you’re connected, an icon should appear in the system tray showing the connection status.
ALEOS User Guide 160 20080616
B B: Configuring Modbus/BSAP The AirLink device supports Modbus ASCII, Modbus RTU, BSAP, and can also emulate other protocols like DF1 or others using its Modbus Variable feature. Modbus Overview The Modbus Protocol, developed by Modicon in 1979, provides for client-server (also referred to as master-slave) communications between intelligent devices.
ALEOS 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.
Configuring Modbus/BSAP In ACEmanager, select Port Configuration in the side menu. The destination port for the modem at the host needs to match the device port (*DPORT) in use on all the modems at the remote sites. For example, if the remote modem’s device port (*DPORT) is “12345”, then the Modbus host modem's S53 destination port should be set to “12345”. Take note of (or set) the Device Port setting in *DPORT to configure the destination port on the remote modems.
ALEOS User Guide 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. For example, if the remote device’s device port (see below) is “12345”, then the Modbus host device’s S53 destination port should be set to “12345”.
Configuring Modbus/BSAP Configure *DNSUSER to the same IP address as the Dynamic DNS (*IPMANAGER1). If your devices have dynamic IP addresses and not static (the IP address can change when it is powered up), configure *DNSUPDATE to a low interval to allow frequent updates. Rev 2.0 C Aug.
ALEOS User Guide 166 20080616
C C: PPP over Ethernet (PPPoE) • Configuring a PPPoE Connection in Windows • Connecting to the Internet with PPPoE 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 3-1: Windows : Start menu b. Rev 2.0 C Aug.10 Select Create a New Connection under Network Tasks in the menu area on the left. Select Next to start installing and configuring the PPPoE connection.
ALEOS User Guide Figure 3-2: Windows : Network Connections c. Click Next on the opening screen to begin creating a PPPoE connection. d. Next. Figure 3-3: New Connection Wizard 168 e. Select Connect to the Internet. f. Select Next.
PPP over Ethernet (PPPoE) Figure 3-4: New Connection: Type g. Select Set up my connection manually. h. Select Next. Figure 3-5: New Connection: How do you want to connect? i. Select Connect using a broadband connection. j. Select Next. Figure 3-6: New Connection : Connect using broadband k. Type in a name for the connection, such as Sierra Wireless AirLink Modem. l. Select Next. Figure 3-7: New Connection: Connection Name Rev 2.0 C Aug.
ALEOS 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 you have multiple users 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 3-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 3-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.0 C Aug.
ALEOS User Guide Same as *MODEMNAME configured earlier Figure 3-11: PPPoE Connection : Service Name c. Select Networking. d. Select Settings. Figure 3-12: PPPoE : Networking e. Remove the checks from all three PPP settings. f. Select OK. Figure 3-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) Caution: Unless specifically directed to do so by Support or your network administrator, you do not need to make any changes to the options on the Security tab. g. Select OK until you return to the Connect window. 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.
ALEOS User Guide 174 20080616
D D: SNMP : Simple Network Management Protocol • SNMP MIB Definition Sample Management Information Base (MIB) The management information base (MIB) is a type of database used to compile the information from the various SNMP agents. Reports from various agents, such as the AirLink device, are sent as data in form designed to be parsed by the NMS into its MIB. The data is hierarchical with entries addressed through object identifiers.
ALEOS User Guide User Name and Password The user name is 'user'. The user name cannot be changed. The AirLink device's password is used as the SNMP password (default is '12345'). Tip: The eight-character password requirement for SMNPv3 is not enforced by the PinPoint X Agent to allow the default password to function. Your SNMP administrator or MIS may require you to change to a more secure and/or longer password.
SNMP : Simple Network Management Protocol org OBJECT IDENTIFIER ::= { iso 3 } dod OBJECT IDENTIFIER ::= { org 6 } internet OBJECT IDENTIFIER ::= { dod 1 } private OBJECT IDENTIFIER ::= { internet 4 } enterprises OBJECT IDENTIFIER ::= { private 1 } airlink OBJECT IDENTIFIER ::= { enterprises 20542 } general OBJECT IDENTIFIER ::= { airlink 1 } common OBJECT IDENTIFIER ::= { airlink 2 } status OBJECT IDENTIFIER ::= { airlink 3 } gps OBJECT IDENTIFIER ::= { airlink 4 } -- GENERAL -phoneNumber OBJECT-TYPE SYNTA
ALEOS User Guide MAX-ACCESS read-only STATUS current ::= { general 7 } modemHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 8 } -- COMMON -date OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 1 } otaProgrammingEnable OBJECT-TYPE SYNTAX INTEGER { disabled(0), enabled(1) } MAX-ACCESS read-only STATUS current ::= { common 2 } devicePort OBJECT-TYPE SYNTAX INTEGER(0..
SNMP : Simple Network Management Protocol SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 7 } destinationPort OBJECT-TYPE SYNTAX INTEGER(0..
ALEOS User Guide SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 5 } serialReceived OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current ::= { status 6 } hostMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 7 } powerMode OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 8 } fixObtained OBJECT-TYPE SYNTAX INTEGER { no(0), yes(1) } MAX-ACCESS read-only STATUS current ::= { gps 1 } satelliteCount OBJECT-TYPE SY
SNMP : Simple Network Management Protocol sysUpTimeInstance = Timeticks: (0) 0:00:00.00 enterprises.20542.1.1.0 = "" enterprises.20542.1.2.0 = STRING: "0x01011A50FD74A5F1" enterprises.20542.1.3.0 = STRING: "354220010245369" enterprises.20542.1.4.0 = STRING: "PinPoint X HSUPA" enterprises.20542.1.5.0 = STRING: "H4323_4.0.x.005 Oct 7 2009" enterprises.20542.1.6.0 = STRING: "09110004000300000000000000000000" enterprises.20542.1.7.
ALEOS User Guide Display Responses The string that is displayed for these objects is the same display for the corresponding AT Command.
SNMP : Simple Network Management Protocol Object AT Command serialPortSettings S23 serialPortFlowControl \Q ipAddress *NETIP? netState *NETSTATE? netChannel *NETCHAN? rssi *NETRSSI? hostMode *HOSTMODE? powerMode *POWERMODE? PinPoint line modems only fixObtained PinPoint line modems only satelliteCount PinPoint line modems only latitude PinPoint line modems only longitude PinPoint line modems only ecio +ECIO Operator +NETOP Network Service Type +NETSERV System Reboots Number
ALEOS User Guide 184 20080616
E E: 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 User Guide process yields the location of the receiver. Getting positioning 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 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 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) • Grouped - Reports held until the total is equal or greater than *PPSNFM which sets the packet size of grouped reports. 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).
ALEOS 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) a. Set the S53 port to the local port to which you want the reports sent. The local IP address will automatically be used. b. Set the Local Report Type, using *PPLATSR, to your preferred RAP report type. 11 - GPS - Global Positioning System data 12 - GPS + Date - GPS data with the UTC time and date 13 - GPS + Date + RF - GPS data with the UTC time and date and Radio Frequency information from the antenna. c.
ALEOS User Guide 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. Tip: Setting up the I/O port hardware is covered in the Inputs, Relay Outputs, and Power Status chapter. Enable *PPINPUTEVT to have events sent to the Host server. COM 1000 support Support for a COM1000 is enable with the command *PPCOM1000=1 or *PPREPORTINPUTS=1.
Global Positioning System (GPS) 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. Local Host Local reports are sent to the local IP address of the computer or device connected to the serial port or USB port of the AirLink device using PPP.
ALEOS User Guide Figure 5-2: HyperTerminal : NMEA Streaming Persistent Streaming To have persistent streaming, allowing you to stream the data even after the modem is reset, configure *PGPS and set *PGPSR for NMEA. 196 • 0 - Disable NMEA streaming. • 1 - Stream the NMEA strings out the serial port only. • 2 - Stream the NMEA strings out the USB port only. • 3 - Stream the NMEA strings out both the serial and the USB ports. • E1 - NMEA GGA, RMC, and VTG sentences.
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 User Guide • QPV (Query Position Velocity) responds with a PV (Position/Velocity) report. 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) • F1 - Compact TAIP data (PV): latitude/longitude, speed, and heading. 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.
ALEOS User Guide E1 - Phrases TAIP GGA, RMC et VTG.
F: AT Commands • AT command set summary • Reference tables • Status registers • Stored profile settings 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 User Guide Table 6-1: Info Commands (Continued) Command Description *ETHMAC? The MAC address of the Ethernet port. *I1 ALEOS Software Version Status Most of the commands in the “Status” group have read-only parameters and provide information about the device. Most of the commands in the “Status” group have read-only parameters and provide information about the device. The Status Group has more fields that can be displayed on most screens.
Table 6-2: Status: Network Command *NETSTATE? Description 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 User Guide CDMA Info Table 6-4: Status: CDMA Info Command Description +PRL Preferred Roaming List (PRL) version. CDMA or EV-DO Only. *PRLSTATUS The status of the most recent PRL Update. CDMA or EV-DO Only. • 0 : None CDMA ECIO • 1 : In Progress • 2 : Success • Any other value : Failure . Indicates the signal-to-noise ratio, essentially the quality of the signal. CPU Status Table 6-5: Status: CPU Status Command Description *POWERIN The voltage input to the internal hardware.
Misc Table 6-6: Common: Misc Command Description General *DATE Sets and queries the internal clock. Either the date and time can be specified, or simply one of the two can be specified in which case the unspecified value will remain unchanged. The date and time are always specified 24-hour notation.
ALEOS User Guide Table 6-6: Common: Misc S53 This AT Command applies to: • Destination Address • Destination Port • Default Dial Code Destination IP address, port, and method. These are used as defaults for the D (Dial) AT command. • method= P : UDP • method=T : TCP • method=N : Telnet • d.d.d.d=IP address or domain name • ppppp=the port address Examples: ATS53=T192.168.100.23/12345 ATS53=foo.earlink.com Telnet to the specified IP at port 12345. ATS53=192.168.100.
Serial Table 6-8: Common: Serial Command *S23 \Q Description Configure Serial Port Format: [speed],[data bits][parity][stop bits] Valid speeds are 300-115200, data bits: 7 or 8, parity: O,E,N,M, stop bits: 1,1.5,2 Serial Port Flow Control Set or query the serial port flow control setting. • n=0 : No flow control is being used. • n=1 : RTS/CTS hardware flow control is being used. • n=4 : Transparent software flow control. Uses escaped XON and XOFF for flow control.
ALEOS User Guide Table 6-8: Common: Serial Command Description S51 PAD data forwarding character. ASCII code of character that will cause data to be forwarded. Used in UDP or TCP PAD mode. • n=0 : No forwarding character. E Toggle AT command echo mode. • n=0 : Echo Off. • n=1 : Echo On. With more than one connection types (serial, and Telnet, and USB) the echo command can be set differently on each interface. &S Set DSR mode. • n=0 : Always assert DSR (Default).
TCP Table 6-9: Common: TCP Command Description General S0 This register determines how the device responds to an incoming TCP connection request. The device remains in AT Command mode until a connection request is received. DTR must be asserted (S211=1 or &D0) and the device must be set for a successful TCP connection. The device will send a “RING” string to the host. A “CONNECT” sent to the host indicates acknowledgement of the connection request and the TCP session is established.
ALEOS User Guide UDP Table 6-10: 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 6-10: Common: UDP 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 User Guide Table 6-11: Common: DNS Command *DNSUSER Description 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 6-12: Common: Dynamic IP Command *IPMANAGER1 *IPMANAGER2 Description 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 *IPMGRKEY2 n=2 : Second IP Manager server.
ALEOS User Guide Table 6-13: Common: PPP/Ethernet Command *HOSTPEERIP Description 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. Allows communication with a subnet behind the host interface. • n.n.n.
Table 6-14: Common: PassThru 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 User Guide Other Table 6-16: 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 Keepalive. If you set *IPPING for a value between 0 and 15, the minimum value of 15 will be set.
Table 6-16: Common: Other Command *MSCIUPDPERIOD Description Device Status Update Period - where n defines the update period in seconds. • n=0 : Disabled • DAE AT Escape Sequence detection. • n=0 : Enable • *DATZ *SNMPTRAPDEST Rev 2.0 C Aug.10 n=1-65535 Selects the security level requirements for SNMP communications. • n=0 : No security required. SNMPv2c and SNMPv3 communications are allowed. • n=1 : Authentication equivalent to “authNoPriv” setting in SNMPv3.
ALEOS User Guide Low Power Table 6-17: Common: Low Power Command VLTG Description 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 one of the power down events (VTLG or DTRP) happens until the device enters the low power mode.
Table 6-18: Common: Firewall Command Description FO Friends List IP address. • n=0-9 Friends list index F1 • d.d.d.d = IP address Using 255 in the IP address will allow any number. Example: 166.129.2.255 allows access by all IPs in the range 166.129.2.0166.129.2.255. F2 F3 F4 F5 F6 F7 F8 F9 Logging This group includes commands specific to the internal log. Table 6-19: Logging Command *DBGPPPLVL *DBGIPLVL *DBGCOMMLVL Rev 2.0 C Aug.10 Description Sets the logging level for the PPP stack.
ALEOS User Guide Table 6-19: Logging Command *DBGETHLVL *DBGDHCPLVL Description Sets the logging level for the Ethernet port. • n=0 : No logging • n=1 : Log errors: invalid/corrupt packets, etc. • n=2 : Log the header of all received packets. Note that this can quickly exhaust available space for the event log. Enable or disable internal DHCP logging. • n=0 : No logging • n=1 : Log DHCP events. Caution: Logging is intended for diagnostic purposes only.
Table 6-20: GPS: Server 1 Command *PPTSV Description Timer for Stationary Vehicles. Time interval in minutes that the device will send in reports when it is stationary. • n=0 : Disabled • n=1-255 minutes For example, if *PPTIME=10, the MP 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 User Guide Table 6-20: GPS: Server 1 Command *PPSNFB Description Store and Forward Behavior. When *PPSNF=1, the type of Store and Forward behavior is defined by: • n=0 : Normal Store and Forward. Data is stored when the MP is out of cellular coverage; when the MP is in coverage, data is sent to server as soon as possible. This is the default form devices with RAP version 1.3 or lower. • n=1 : Data sent only when polled. Data is stored until polled using the Poll command sent by a server.
Table 6-21: GPS: Misc Command Description *PPTAIPID Sets/queries the TAIP ID. This ID is returned in TAIP reports if it has been negotiated with the TAIP client. This value is only used in conjunction with TAIP emulation mode (*PPGPSR=F0). • nnnn=TAIP ID (4 characters) *PPFLUSHONEVT Flushes store and forward buffer when an input event (DTR/RTS) occurs. • n=0 : Disable • *PPREPORTINPUTS n=1 : Enable Enable input reporting.
ALEOS User Guide Serial Port Table 6-22: 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). See *PPGPSR.
Table 6-22: GPS: Serial Port 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 User Guide Cellular This group includes commands specific to HSDPA, EDGE and GPRS. If you are not connecting to a which uses HSDPA, EDGE, or GPRS, you will not see this group in the menu. Table 6-23: Cellular Command *NETAPN Description Easy entry of the APN. If left blank, the device will attempt to use the default subscriber value as defined by the account. • apn=access point name 1 and “IP”, are required and not variable. Quotes need to be placed around the APN.
CDMA This group includes commands specific to 1x and EV-DO. If you are not connecting to a device which uses EV-DO or 1x, you will not see this group in AceWeb. Table 6-24: CDMA Command +CTA Description Inactivity timer, in seconds. Typical network settings cause a link to go dormant after 10 to 20 seconds of inactivity, no packets transmitted or received. This time can be shortened to release the physical RF link sooner when the application only transmits short bursts.
ALEOS User Guide Table 6-24: CDMA Command *EVDODIVERSITY Description EV-DO Diversity allows two antennas to provide more consistent connection. • n=0 : Disabled. • n=1 : Allow Note: If you are not using a diversity antenna, *EVDODIVERSITY should be disabled. *EVDODATASERV *PROVISION=MSL,MDN/MIN[,SID][,NID] Tip: It is recommended to use the Setup Wizard for your carrier to provision the device. Provision the device with the lock code and phone number. Cannot be configured in AceManager.
Table 6-25: I/O Command *RELAYOUT1 *RELAYOUT2 Description Set or query the relay outputs. • n=1-2 Input number • s=OPEN or CLOSED SMS Command AT*securemode Description This AT command to enables/disables Services. "AT*securemode=value" 0 - Will be the default, and leave the modem in its normal open state. 1 - Will disable the Aleos Ports for OTA and Wifi access 2 - Will disable the Aleos Ports for OTA and Local Access+ WiFi (All) 3+ - all values larger than 2 will receive an error response.
ALEOS User Guide 230 20080616
