PinPoint CDMA/1xRTT User Guide AirLink Communications, Inc. Version 2.
Information in this document is subject to change without notice ©Copyright AirLink Communications, Inc., 1993-2005. All rights reserved. WARNING The antenna(s) used for this transmitter must be installed to provide a separation distance of at least 20 cm from all persons and must not be co-located or operating in conjunction with any other antenna or transmitter. Important Notice Because of the nature of wireless communications, transmission and reception of data can never be guaranteed.
Contents CHAPTER 1 Introduction to PinPoint CDMA/1xRTT 1 PinPoint Overview 1 PinPoint front and back 1 CDMA/1xRTT Overview 2 Establishing a Internet Connection 2 Using the PinPoint to connect to the Internet 3 Using CDMA/1xRTT to Communicate with Your Equipment Common Uses for the PinPoint CHAPTER 2 PinPoint Activation 3 4 5 Connecting the PinPoint to your computer Quick Start Guide and Setup Wizard 5 5 Setup Wizard Menu 6 Configuring the PinPoint using Wireless ACE PinPoint Indicator Li
Contents CHAPTER 3 PinPoint Utilities AceView 9 10 AceView 10 AceView: About PinPoint 10 Wireless ACE and Wireless ACE Web 11 Wireless ACE 11 AceNet 12 AceNet 12 Modem Doctor 13 Modem Doctor 13 AirLink Tracking System CHAPTER 4 13 DNS: Using Names Instead of IP addresses Configuring DNS 14 14 Wireless ACE: DNS 15 PPP-Peer 15 CHAPTER 5 IP Manager 16 Fully Qualified Domain Name Dynamic Name Resolution 17 17 Configuring the PinPoint for Dynamic IP 18 Wireless ACE: Dynamic IP (IP Ma
Contents PPP Mode 25 Slip Mode 25 UDP Pad Mode 26 UDP Auto Answer 26 Reliable UDP 27 Multicast UDP 28 TCP PAD Mode 28 TCP Auto Answer 29 Hybrid Modes 29 Hybrid Mode Settings 30 CHAPTER 8 External Inputs and Power Control 31 Capturing Events via External Inputs 31 Setting the DTR and RTS 31 Wireless ACE: DTR and RTS 32 Connecting to the Serial Port 32 PinPoint back 32 PinPoint Serial Port Pinouts 33 DTR and RTS switches using Pin 5 (signal GND) as the common ground 33 Power Modes 33 Power
Contents Sending Reports Automatically 39 Wireless ACE: Automatic Reports 39 Wireless ACE: Local Automatic Reports 39 Wireless ACE: GPS Initialization Timer 40 RAP Configuration 40 RAP Reports Over-The-Air (Remote) 40 Wireless ACE: RAP Reports Remote 40 Wireless ACE: *PPIGNOREIP 41 RAP Reports over a Local Connection (PPP or SLIP) 41 Wireless ACE: RAP Local Reports 41 RAP Message format 42 Additional RAP Features 43 Device ID 43 Wireless ACE: Device ID 43 Odometer Data in Reports 44 Wireless ACE: Odo
Contents GGA - Global Positioning System Fix Data 52 RMC - Recommended Minimum Navigation Information 53 VTG = Vector track an Speed over the Ground 54 TAIP Emulation Configuration 54 TAIP Messages Over-the-Air (Remote) 54 Wireless ACE: TAIP Remote Reports 55 TAIP Messages over a Local Connection (PPP or SLIP) 55 Wireless ACE: TAIP Local Reports 55 Sending Unsolicited TAIP Messages over a Local Connection 56 Wireless ACE: TAIP Local Reports, Unsolicited 56 Using TAIP Command Emulation 56 Wireless ACE: TAI
Contents PinPoint connectors 70 Connecting power 70 Connecting the PinPoint to a computer or other device CHAPTER 12 AT Commands 72 Using Wireless Ace 72 Wireless ACE: Using AT Commands 72 Wireless ACE: toolbar 73 Using Telnet Terminal Emulation 73 HyperTerminal: Connection Name 74 HyperTerminal: TCP/IP Settings 74 HyperTerminal: AT mode via Telnet 75 Direct Serial Connection 75 HyperTerminal: Connection Name 75 HyperTerminal: Comport Setting 76 HyperTerminal: Comport Settings 76 AT Command
Contents CHAPTER 13 PinPoint Specifications 111 Physical Characteristics: 111 Data Services & RF Features: 111 Environmental: 111 Power Management: 112 Troubleshooting 113 Support web site 113 Contacting Technical Support 113 TELUS CDMA/1xRTT PinPoint User Guide Version 2.
CHAPTER 1 Introduction to PinPoint CDMA/1xRTT The AirLink PinPoint’s serial port can be connected to a computer or other device. The PinPoint uses CDMA/1xRTT to connect to TELUS’s cellular network to allow communication to the Internet. PinPoint Overview The PinPoint's rugged form factor is ideal for industrial and commercial applications that require real-time communications.
Introduction to PinPoint CDMA/1xRTT The PinPoint has several built in features to make it more effective in a variety of settings. In addition, Airlink provides several modem tools to further enhance the capabilities of the PinPoint. These features and tools are introduced in this User Guide.
Introduction to PinPoint CDMA/1xRTT FIGURE 2. Using the PinPoint to connect to the Internet Note: Private network connections are unique for each configuration and not covered as part of the standard installation. Using CDMA/1xRTT to Communicate with Your Equipment There are two types of addresses in TCP/IP, dynamic and static. • Dynamic addresses are assigned on a “need to have” basis. Your PinPoint might not always receive the same address each time it connects with TELUS.
Introduction to PinPoint CDMA/1xRTT If you have a dynamic IP address for your PinPoint, you can use a service (such as IP Manager, covered later in this User Guide) to translate a dynamic IP address to a fully qualified domain name so you can contact the PinPoint as if it had a static IP. Caution: The IP address given to your PinPoint by TELUS must also be Internet routable if the computer you need to connect to the PinPoint is not connected directly to TELUS's IP network.
CHAPTER 2 PinPoint Activation Your PinPoint needs specific parameters before it can operate on the CDMA/ 1xRTT network. Generally TELUS will provide you with the necessary parameters to get the PinPoint configured. Connecting the PinPoint to your computer Your PinPoint’s serial port can be connected directly to most computers or devices using a standard straight through serial cable.
PinPoint Activation Note: The web site may have a more recent Setup Wizard and Quick Start Guide than those included with your PinPoint. It is recommended that you check with the web site for the latest version before installing your PinPoint. You will need to look for TELUS, CDMA/1xRTT, and the PinPoint. Other Setup Wizards may not work to connect you to TELUS. To run the Setup Wizard, you will need the Microsoft .
PinPoint Activation Configuring the PinPoint using Wireless ACE You can configure your modem using Wireless ACE (page 11) or AceNet (page 12). It is not recommended to activate a modem using either Wireless ACE or AceNet. An alternate method to configure and activate your PinPoint is by AT commands (full listing beginning on page 76) sent directly to the modem via a terminal application (page 73).
PinPoint Activation The Reset button performs the same function as unplugging power from the modem and plugging it back in. Reset will not alter any saved configuration settings. TELUS CDMA/1xRTT PinPoint User Guide Version 2.
CHAPTER 3 PinPoint Utilities AirLink offers a suite of utilities to optimize your PinPoint’s performance, allowing you to remotely view status and make changes to the configuration as needed. • • • • • AceView Wireless ACE and Wireless ACE Web AceNet Modem Doctor AirLink Tracking System This section of the PinPoint User Guide covers basic information about these utilities. For additional information on a specific utility, please refer to the user guide for that utility.
PinPoint Utilities AceView AceView is a low-profile monitoring tool to view the status of your AirLink PinPoint and display network status, IP address, RSSI strength, firmware version, and other basic information. FIGURE 1. AceView You can connect to your PinPoint locally or remotely using a known IP address or a fully qualified domain name. The display is updated periodically as AceView polls the PinPoint at a specified interval. GPS is available only for PinPoint modems. FIGURE 2.
PinPoint Utilities Wireless ACE and Wireless ACE Web Wireless AirLink Configuration Executive (ACE) and Wireless Ace Web allow you to monitor your PinPoint either remotely or locally with a direct connection to the modem. Wireless ACE Web has a web-based interface and covers nearly the same range of features a Wireless ACE. Features discussed in this section apply to both versions unless otherwise noted. FIGURE 3.
PinPoint Utilities AceNet With AceNet you can monitor several AirLink modems at the same time. The modems can be connected locally or remote. Several features can be displayed and logged. AceNet is a seperate product which can be purchased from AirLink. FIGURE 4. AceNet Using a template from Wireless ACE, you can change the configuration in several modems at the same time and can check and update their firmware as well. AceNet also features logging to a database and charting for the monitored modems.
PinPoint Utilities Modem Doctor Modem Doctor is a troubleshooting utility. This utility will allow you to get a log file of the PinPoint activity which you can then send to AirLink support, erase the current configuration completely, and temporarily set the PinPoint to a known serial configuration to aid in trouble shooting. FIGURE 5.
CHAPTER 4 DNS: Using Names Instead of IP addresses A domain name is a name of a server or device on the Internet which is associated, generally, with an IP address. In a way, a domain name is like the street address of your house with the phone number being like the IP address. You can contact the house either by going to the address (name) or by calling the phone number (IP address).
DNS: Using Names Instead of IP addresses You can use AT commands (page 76), Wireless ACE (page 11), and ACE Net (page 12) using a template built from Wireless ACE to configure DNS in your PinPoint. FIGURE 1. Wireless ACE: DNS *DNS1 and *DNS2 - Set these to your primary and secondary DNS servers. These maybe be overwritten by TELUS when your PinPoint gets its IP address.
CHAPTER 5 IP Manager IP Manager translates a dynamic IP address to a fully qualified domain name so you can contact PinPoint by name as if it had a static IP. Since TELUS frequently does not offer static IP addresses, IP Manager is a free service provided by AirLink for your PinPoint to translate a dynamic IP address into a fully qualified domain name so it can be contacted directly on the Internet.
IP Manager Fully Qualified Domain Name A fully qualified domain name (FQDN) generally has several parts. • Top Level Domain (TDL): The TDL is the ending suffix for a domain name (.com, .net, .org, etc.) • Country Code Top Level Domain (ccTDL): This suffix is often used after the TDL 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 ccTDL (i.e.
IP Manager If the PinPoint is configured for Dynamic IP, when the PinPoint first connects to the Internet, it sends a IP change notification to IP Manager. IP Manger will acknowledge the change and update the DNS record. The changed IP address will then be the address for the PinPoint’s configured name. Once the PinPoint’s IP 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.
IP Manager 2. Domain: Eairlink.com is the IP Manager domain provided by AirLink. 3. IP Manager IP Address: The IP or domain name of the dynamic DNS server. Earlink.com is the IP Manger server provided by AirLink. Note: To use the name here instead of the IP, you need to have DNS set up in your PinPoint. See “DNS: Using Names Instead of IP addresses” on page 14. 4. IP Manager update interval: How often you want the address sent to IP Manager.
CHAPTER 6 Keepalive It is not uncommon for your PinPoint to be disconnected from TELUS after an extended period of inactivity. This is generally a feature intended to reduce your charges for inactive use. Keepalive is used to test and maintain the PinPoint’s connection to TELUS by pinging an IP address after a specified period of inactivity. Keepalive is recommended for users who have a remote terminated modem that infrequently communicates to the network.
Keepalive To set the Keepalive using Wireless ACE, select Other from the menu on the left. FIGURE 1. Keepalive Configuration in Wireless ACE *IPPING sets the interval, in minutes, you want Keepalive to test the network connection. To disable Keepalive, set *IPPING to 0 (default setting). *IPPINGADDR sets the IP address you want to use for the test. If *PPINGADDR is left blank or is set to an invalid IP address (i.e.
CHAPTER 7 Host Modes The PinPoint can be in one of six communication modes as the Host to the computer or other device attached to the serial port of the PinPoint. AT: The PinPoint accepts and responds to standard, Hayes-style AT commands. This is enabled by default. PassThru: Direct connection to internal hardware (OEM Module) of the PinPoint. PPP: The PinPoint uses PPP to communicate. SLIP: The PinPoint uses SLIP to communicate.
Host Modes in the AT Command listing, page 84) to the desired mode. If this setting is nonzero, the modem will enter the specified mode after 5 seconds. If you want to cancel this behavior, the ATMD0 command can be used before the 5-second time-out expires. If the modem is in any mode other than AT or PassThru, the AT command mode can be re-entered by: • Deactivating DTR (if &D2 or Ignore DTR, S211, is not set). • Issuing the +++ escape sequence (if Disable AT Escape, DAE, is not set).
Host Modes For V=0, (Terse mode), a numeric result code is output with a single trailing (no is output), while any AT query response is followed by (there is no preceding output).
Host Modes PPP Mode In PPP mode, the PinPoint acts as a PPP server, providing an IP address, and DNS servers (if available) to the Host. PPP mode is entered from the AT mode by using any of the following commands: AT\APPP ATDT10.0.0.1 ATDT10001 ATD#19788 CLIENT In response to any of the preceding commands, the modem will respond with CONNECT and is ready for the host to begin PPP negotiations.
Host Modes UDP Pad Mode When the modem is in UDP PAD (Packet Assembly and Disassembly) Mode, all characters received on the serial port are assembled into UDP packets and sent to the PinPoint’s remote IP address/port, and any packets received from the same IP/ port-destined for the PinPoint’s Device Port (see *DPORT)--are disassembled and dumped onto the serial line. A UDP session is initiated by one of the following events: • Using the Dial UDP (DP) AT command (ex. ATDP192.168.3.
Host Modes commands), while allowing sessions to be established from different UDP sources. A UDP session will be initiated either by incoming serial data or by an incoming UDP packet. The session, started by either method, will be terminated when no data has been sent or received for the S82 period. Once the session terminates, another may be initiated by either means. When the session is initiated by serial data, the new session will be established using the destination address specified in S53.
Host Modes Multicast UDP Multicast UDP results in any data received from the host serial port being sent to all the clients in the Modbus list. The remote port number is taken from S53. To avoid flooding the network, the packets are sent to each client with a 20ms pause in between. The receipt of UDP packets works as in normal UDP mode (i.e. bound by the value S53 and/or AIP).
Host Modes TCP packet assembly is affected by the values of S50 (PAD Forwarding Time-out) and S51 (PAD Forwarding Character). Data received in the serial buffer will be transmitted when the idle inter-character time-out specified in S50 (in tenths of seconds) occurs or when a character is received that matches S51 (if non-zero). The TCP session will be terminated if no data is transmitted or received for the time interval specified in TCPT and TCPS.
Host Modes TABLE 1. Hybrid Mode Settings AT Setting Hybrid (MD5) Hybrid2 (MD6) MD 3 3 S82 2 2 S0 1 1 *UDPLAST 0 1 TELUS CDMA/1xRTT PinPoint User Guide Version 2.
CHAPTER 8 External Inputs and Power Control The PinPoint has special features for use in a mobile environment. The PinPoint can be configured to monitor the inputs on its serial port and respond to specific types of events. The PinPoint can also be configured to change its power mode in order to conserve power.
External Inputs and Power Control FIGURE 1. Wireless ACE: DTR and RTS To turn on the DTR (pin 4) digital sensing in the modem, *DTRI should be set to 1. To turn on the RTS (pin 7) digital sensing, *RTSI should be set to 1. Note: To use only DTR or only RTS, you only need to configure the one you will be using. Connecting to the Serial Port You can connect a standard RS232 serial cable to the The PinPoint serial port.
External Inputs and Power Control FIGURE 3. PinPoint Serial Port Pinouts FIGURE 4. DTR and RTS switches using Pin 5 (signal GND) as the common ground Power Modes The PinPoint can be configured to switch a low-power mode in response to specific events in order to conserve a vehicle's battery life.
External Inputs and Power Control Power Effect on Modem State Once the transition from powered on to low-power mode starts, the modem will change state to AT mode. This results in the current mode (e.g. PPP, TCP, etc.) being gracefully terminated. For the brief period when the modem is preparing for low-power mode, the modem will remain in AT mode (i.e. won't auto-answer, ATD will fail, etc.). Once low-power mode is entered, the modem will then discard any data received on the host port.
CHAPTER 9 Global Positioning System The PinPoint is equipped with a GPS receiver to ascertain its position to track the movements of a vehicle or other devices which move. The PinPoint relays the information of its location as well as other data for use with AirLink Tracking System (ATS) or other such tracking applications.
Global Positioning System A GPS receiver, such as the PinPoint, generally receives signals from four 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.
Global Positioning System Real-Time Clock Sync Every hour, the PinPoint will sync the internal Real Time Clock (RTC) with the Coordinated Universal Time (UTC) received from the GPS satellites. Applications, such as ATS and the Event Browser, will then translate the time reported by the PinPoint as part of the GPS message to the appropriate local time zone using the UTC offset (i.e. California is UTC-8 and New York is UTC-5).
Global Positioning System Local Host To set the PinPoint to report to an local host, one directly connected to the PinPinPoint’s serial port port, configure S53. The local IP will automatically be used for local reports. S53, in Wireless ACE, is part of the Misc menu option. FIGURE 2. Wireless ACE: S53 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.
Global Positioning System F1 - TAIPcompact data Note: The PinPoint can be configured to supply one type of report to a remote host and different a report type locally through the serial port at same time. However, there may be conflicts due to the local and remote reporting being in different modes and not all features to both modes may be available.
Global Positioning System The PinPoint can be configured to wait a specific amount of time after initialization before any reports are sent. FIGURE 7. Wireless ACE: GPS Initialization Timer RAP Configuration RAP is used with AirLink Tracking System and other applications. RAP has additional features which allow reports based on external physical events, input from a COM1000 device, store and forward processing, etc.
Global Positioning System If you need to use a dynamic IP for the ATS server, you can use the RAP configuration command to change the value for *PPIP (see below). Note: If your PinPoint is on a mixed network (some of the fleet on another cellular network), you will need to specify the IP of the server in *PPIP and configure the PinPoint not to change the server IP with a RAP configuration command using *PPIGNOREIP. This will prevent the ATS server configuration packets from changing the *PPIP value.
Global Positioning System 3. Set Local ATS Reporting Time Interval (*PPLATS) to the number of seconds you want as an interval between reports being sent. If *PPLATS is set to 0, reports will only be sent if a poll command is issued by the local client. RAP Message format RAP uses the UDP transport protocol to deliver messages between the Server and the PinPoint. The Server is the master and sends commands to one or more PinPoint devices. Each PinPoint returns command status and responses to the Server.
Global Positioning System GPS Reports 0x11 Simple GPS Report - Report contains GPS latitude and longitude in 1/ 100,000 degrees, GPS velocity in kilometers/hour, GPS Direction in 2 degree increments, UTC time (but not date), GPS satellite count and quality, and optional data 0x12 Simple GPS Report with the addition of the UTC date. 0x13 Simple GPS Report with the addition of the UTC date and including radio frequency data with the GPS point.
Global Positioning System The device ID PinPoint will use is the IP or phone number assigned by TELUS. Odometer Data in Reports When the odometer is enabled, the PinPoint will calculate distance based on GPS data. The modem’s odometer calculations can be included in the RAP message. FIGURE 12. Wireless ACE: Odometer Reports Note: The PinPoint’s odometer calculations may not match the odometer in the vehicle itself.
Global Positioning System FIGURE 14. Wireless ACE: Input Event Reports The report type will indicate the state of change in either RTS or DTR. Input Value Report Type DTR 0 0x20 DTR 1 0x21 RTS 0 0x22 RTS 1 0x23 The contents of the report will be the same as Report Type 0x12 (GPS data with date) with the addition of the event report (See “RAP Message format” on page 42). COM1000 Event Reports Support for the COM1000 is enable with the register *PPCOM1000=1 (0 = off [default], 1 = on).
Global Positioning System Input Value Report Type INPUT3 HI 0x29 INPUT 4 LO 0x2A INPUT 4 HI 0x2B The contents of the report will be the same as Report Type 0x12 (GPS data with date) or 0x13 (GPS data with date and RF data) with the addition of the event report (See “RAP Message format” on page 42). Store and Forward for RAP The Store and Forward (SnF) allows the PinPoint to store messages and send them to the server in a packet rather than individually. FIGURE 16.
Global Positioning System FIGURE 17. Wireless ACE: Store and Forward Reliable Mode With RATS enabled, *PPSNFR, the PinPoint will transmit a sequence number (1 to 127) as part of a packet of messages (may contain one or more reports). To reduce overhead, the server only acknowledges receipt of every eighth packet. The PinPoint considers that 8 a “window” of outstanding packets.
Global Positioning System FIGURE 19. Wireless ACE: Automatic Reports *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) *PPTSV - Location report sent if the vehicle has been in one location (stationary) for more than a set time interval (minutes). *PPMINTIME - Location report sent be sent at no less than this time interval (seconds).
Global Positioning System want to sent the legacy messages locally (over the serial port) you will need to configure *PPLATSR to *MF. IP and port configuration is as above for other RAP configurations. FIGURE 21. Wireless ACE: *PPGPSR and *PPLATSR You will also need to specify the type of Legacy format, *MF, you are using. The format is specified in hex. FIGURE 22.
Global Positioning System Send the command ATGPS1 to the serial port to begin the NMEA stream. The example below shows the stream in HyperTerminal connecting directly to the modem via the comport. FIGURE 23. HyperTerminal: NMEA Stream To stop the stream, use the command ATGPS0 (this can be entered even while data is streaming). You can also use AT*PGPS=1 then AT&W to allow you to stream the data even after the modem is reset.
Global Positioning System FIGURE 25. Wireless ACE: NMEA Remote Reports 1. Set the IP (*PPIP) and port (*PPPORT) to the IP and port of the server to which you want the reports sent. 2. Set the GPS Report Type (*PPGPSR) to your preferred NMEA sentence format. E0 - Output the GGA and VTG sentences. E1 - Output the GGA, RMC, and VTG sentences.
Global Positioning System NMEA Message Description The standard GPS data stream provided by the PinPoint in raw serial (ASCII) format is comprised of (3) GPS NMEA receiver messages (“sentences”): GGA, RMC and VTG. All NMEA messages start with a dollar sign ($) followed by a message type identifier. After the identifier, the fields of the messages are comma deliminated. Example taken from PinPoint output: $GPGGA,173221.428,3505.1435,N,08037.5669,W,1,04,2.2,242.9,M,46.9,M,,0000*1E TABLE 1.
Global Positioning System TABLE 1. GGA - Global Positioning System Fix Data Description Field Contents Differential reference station ID, 0000-1023 0000 Optional checksum field consisting of "*" and two hex digits. *1E Represents the exclusive OR of all characters between, but not including, the "$" and "*". Example taken from PinPoint output: $GPRMC,173219.428,A,3505.1436,N,08037.5669,W,0.09,13.55,040403,,,*2B TABLE 2.
Global Positioning System Example taken from PinPoint output: $GPVTG, 308.49,T,,M,0.05,N,0.1,K,*62 TABLE 3. VTG = Vector track an Speed over the Ground Description Field Contents Global Positioning System (GPS) GP Track made good and Ground speed VTG Track Degrees 308.49 True = T T Track Degrees null field Magnetic = M M Speed Knots 0.05 Knots = N N Speed Kilometers Per Hour 0.1 Kilometers Per Hour = K K FAA mode indicator (NMEA 2.
Global Positioning System FIGURE 27. Wireless ACE: TAIP Remote Reports 1. Set the IP (*PPIP) and port (*PPPORT) to the IP and port of the TAIP server. 2. Set GPS Report Type (*PPGPSR) to F0-TAIP data. Note: Unlike standard TAIP which simply sends to the last client to request automatic reports, the remote reports are sent to the destination address (*PPIP) and destination port (*PPPORT).
Global Positioning System With this configuration, the PinPoint will listen for TAIP requests on the local IP (192,168.13.31 by default) and port 21000. Once a TAIP request command has been received, the PinPoint will begin issuing TAIP reports (e.g. DPVs) to the local IP and port 21000. The client application should be listening for reports on this IP address and port. No unsolicited reports will be sent from the PinPoint to the local client application.
Global Positioning System FIGURE 30. Wireless ACE: TAIP Emulation Note: With TAIP emulation, the PinPoint will listen for TAIP messages on port 21000. AirLink Protocol (RAP) will be disabled and no RAP messages or commands will be sent or received on that port. TAIP ID The TAIP messages can be configured to send the user specified identification number (ID). This greatly enhances the functional capability of the unit in a network environment. Set the ID using *PPTAIPID. FIGURE 31.
Global Positioning System QPV 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 reports the reporting mode configuration. RID reports the TAIP ID. RPV reports Position/Velocity. TAIP Message Description The TAIP data stream provided by the modem will be raw serial (ASCII) format and is always uppercase.
CHAPTER 10 Simple Network Management Protocol (SNMP) The PinPoint is can be configured as an SNMP agent and supports SNMPv2c and SNMPv3. SNMP Overview The Simple Network Management Protocol (SNMP) was designed to allow remote management and monitoring of a variety of devices from a central location.
Simple Network Management Protocol (SNMP) 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 PinPoint, 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.
Simple Network Management Protocol (SNMP) Security Level *SNMPSECLVL sets the security level and which version of SNMP communications are used. FIGURE 2. Wireless ACE: *SNMPPORT 0 - No security required. SNMPv2c and SMNPv3 communications are allowed. 1 - Authentication required. SNMPv3 is required to do authentication and SNMPv2c transmissions will be silently discarded. Authentication is equivalent to the authNoPriv setting in SNMPv3. 2 - Authentication required and messages are encrypted.
Simple Network Management Protocol (SNMP) FIGURE 3. Wireless ACE: Changing the PinPoint Password - Menu Option The current password will be pre-entered. As you type the new password and confirm it, the characters you type will be obscured by “x”. FIGURE 4. Wireless ACE: Changing the PinPoint Password For the password, you can use numbers, letters, and/or punctuation. Caution: The password is case sensitive. “drowssaP” is not the same as “drowssap”. TELUS CDMA/1xRTT PinPoint User Guide Version 2.
Simple Network Management Protocol (SNMP) Trap Destination *SNMPTRAPDEST needs to be set with the destination IP and port. If either are set to zero or empty, SNMP traps are disabled. FIGURE 5. Wireless ACE: *SNMPPORT Note: Traps are sent out according to the SNMP security level (i.e. if the security level is 2, traps will be authenticated and encrypted). Currently, the only trap supported is LinkUp.
Simple Network Management Protocol (SNMP) SYNTAX MAX-ACCESS STATUS ::= { general 2 } DisplayString read-only current electronicID OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 3 } modemType OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 4 } aleosSWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 5 } aleosHWVer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { general 6 }
Simple Network Management Protocol (SNMP) otaProgrammingEnable OBJECT-TYPE SYNTAX INTEGER { disabled(0), enabled(1) } MAX-ACCESS read-only STATUS current ::= { common 2 } devicePort OBJECT-TYPE SYNTAX INTEGER(0..
Simple Network Management Protocol (SNMP) serialPortSettings OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { common 9 } serialPortFlowControl OBJECT-TYPE SYNTAX INTEGER { none(0), hardware(2), software(4) } MAX-ACCESS read-only STATUS current ::= { common 10 } -- STATUS -ipAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current ::= { status 1 } netState OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current ::= { status 2 } netChannel OBJECT-TYPE S
Simple Network Management Protocol (SNMP) 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 SYNTAX INTEGER MAX-ACCESS read-only STATUS curren
CHAPTER 11 Hardware Installation Your AirLink PinPoint should be mounted in a position that allows easy access for the cables so they are not bent or constricted. The LEDs on the front panel should be visible for ease of operational verification. You should ensure that there is adequate airflow around the modem but that it is kept free from direct exposure to the elements (sun, rain, etc.). The exterior of the case should also be grounded.
Hardware Installation such as in the back of an automobile. In most stationary installations, such as in a field or pipe, the PinPoint and bracket shouldn’t require a twist-tie. The bracket can be attached to the location using #6 screws (mounting hole diameter approximately 0.150"). FIGURE 1. 69 PinPoint Mounting Bracket, part number 100-170-1005 TELUS CDMA/1xRTT PinPoint User Guide Version 2.
Hardware Installation Connecting the Antennas Your PinPoint will work with most standard cellular antennas with a TNC connector and rated to work with CDMA/1xRTT technology. Connect the antenna or RF cable directly to the TNC connector on the back of the PinPoint. Your PinPoint will work with most standard GPS antennas. Connect the antenna or cable directly to the threaded connector. FIGURE 2.
Hardware Installation Connecting the PinPoint to a computer or other device Your PinPoint’s serial port can be connected directly to most computers or other devices using a standard straight through cable. If you have a DCE device, you will need a null modem or null modem cable. Your PinPoint can also be connected to a USB to serial port device connected to a computer or other device which does not have an available serial port but does have USB. 71 TELUS CDMA/1xRTT PinPoint User Guide Version 2.
CHAPTER 12 AT Commands Just as with a Hayes compatible analog modem, the PinPoint parameters can all be configured with AT commands. Wireless ACE and Wireless ACE Web (See “Wireless ACE and Wireless ACE Web” on page 11. and below) are a graphical interface for the AT commands and it is highly recommended that you use one of them to modify any parameters, however a terminal emulation application, such as Telnet, can be used instead.
AT Commands To set or commit the changes in the modem, use the Write button at the top of Wireless ACE interface. FIGURE 2. Wireless ACE: toolbar For more information on using Wireless ACE or Wireless ACE Web, please refer to the Wireless ACE User Guide. Note: Some of the AT Commands are not able to be configured in Wireless ACE. Using Telnet Terminal Emulation Most installations of Microsoft Windows come with a version of HyperTerminal. Start>All Programs>Accessories>Communications>HyperTerminal 1.
AT Commands FIGURE 3. 2. Select TCP/IP (Winsock) for Connect Using. If the modem is remote, the host address will be the current Internet IP of the PinPoint. Change the port number to 2332 (default telnet port for the PinPoint). FIGURE 4. 3. HyperTerminal: Connection Name HyperTerminal: TCP/IP Settings When HyperTerminal connects to the PinPoint, you may be prompted for a password. The default password is 12345. When you press Enter, you should get back a reply of “OK”.
AT Commands FIGURE 5. HyperTerminal: AT mode via Telnet 4. Type AT and press Enter. You should get a reply of “OK” or “0”. 5. To see what you are typing as you type it, you will need to turn on the echo and verbose mode. Type ATE1V1 and press Enter. 6. If you get a reply of “OK”, then you entered the command successfully. If you get a reply of “0” or “ERROR”, try entering the command again.
AT Commands FIGURE 7. 3. HyperTerminal: Comport Setting Change the Bits per Second to 115200 (default), Data Bits to 8, Parity to None, Stop Bits to 1, and Flow Control to Hardware. FIGURE 8. HyperTerminal: Comport Settings 4. Type AT and press Enter. You should get a reply of “OK” or “0”. 5. To see what you are typing as you type it, you will need to turn on the echo and verbose mode. Type ATE1V1 and press Enter. 6. If you get a reply of “OK”, then you entered the command successfully.
AT Commands • Acceptable parameters and/or specific formats are in the parameters column. • Required variable parameters are denoted with italicized text, ex. Dn. The n is variable and noted in the parameters column. • Optional parameters are denoted with square brackets [ ]. • Most commands with parameters can be entered with ? to read the current value, i.e. AT&D? will respond with “2” if the default has not been changed. • AT Commands are not case sensitive.
AT Commands TABLE 1. Information and Status Command Details *NETIP? The current IP address of the modem reported by the embedded OEM module (generally obtained from Carrier). This is the address to which packets can be sent in order to contact the PinPoint from the Internet. Note: If there is no current network IP, 0.0.0.0 may be displayed. Use *NETALLOWZEROIP if you need to allow the display of an IP ending in a zero. See “*NETALLOWZEROIP=n” on page 79.
AT Commands TABLE 1. Information and Status Command Details *POWERMODE? Displays the current power state/mode. Possible values returned are: Initial - the modem is in the initial 5 minutes since power up, so power down event will be ignored. On - regular power on, i.e. a power down is not pending. Low Cancellable - power down is pending but still cancelable if the power down trigger goes away. Low Pending 1 and 2 - power down is pending, any modem tasks are gracefully preparing for the power down.
AT Commands TABLE 2. Basic Command Commands Parameters Details Hn Hang-Up Command n=1 Hang-up &W none Writes all changed modem settings. If this command is not issued, any modified values will revert back to their previous values at modem reset. A none Answer - manual DAE=n Disable AT Escape Sequence detection n=0 Enable +++ AT escape sequence detection. n=1 Disable +++ AT escape sequence detection. En Toggle AT command echo mode. n=0 Echo Off n=1 Echo On.
AT Commands TABLE 2. Basic Commands Command Parameters Details Z none Reset the PinPoint. Note: This command does nothing if *DATZ=1. *DATZ=n Enables or disables reset on ATZ n=0 Normal Reset (Default). n=1 Disable Reset on ATZ. The preferred method of activating (provisioning) the modem is using the Setup Wizard. However, there are special circumstances when commands may be used instead. Note: You may need go into PassThru mode to activate the PinPoint.
AT Commands TABLE 3. Activating (Provisioning) $QCMIP=n Allows configuration of whether to use Simple IP (SIP), Mobile IP (MIP) preferred, or Mobile IP only. n=0 Simple IP. n=1 Mobile IP Preferred. n=2 Mobile IP Only. *NETROAMPREF=n *PROVISION= [MSL],[MDN/MIN],[SID], [NID] Allow configuration of the roaming preference. n=0 Restrict to home network only, n=1 Allow roaming to affiliated networks. MSL=master lockcode Provision the modem with the lock code and phone number.
AT Commands TABLE 4. Cellular Command Network (TELUS) Parameters *NETALLOWZEROIP=n Details Allows the displayed IP address in *NETIP to end in zero (ex. 192.168.1.0). n=0 Allow n=1 Do not allow *NETCHAN? none The current active CDMA/1xRTT channel number. *NETERR? none The . *NETIP? none The current IP address of the modem reported by the embedded OEM module (generally obtained from Carrier).
AT Commands TABLE 5. Local Network and Host Modes Command Parameters Details +++ none AT Escape sequence Not proceeded by AT. If the PinPoint is in a data mode (any mode other than PassThru), this command causes the modem to re-enter AT command mode. There must be an idle time (set by S50) on the serial port before and after this command. The "+" is ASCII 0x2B. Note: The detection of +++ is disabled if DAE=1. See “DAE=n” on page 76.
AT Commands TABLE 5. Local Command Network and Host Modes Parameters Details S0=n This register determines how the PinPoint responds to an incoming TCP connection request. The PinPoint remains in AT Command mode until a connection request is received. DTR must be asserted (S211=1 or &D0) and the PinPoint must be set for a successful TCP connection. The modem will send a "RING" string to the host.
AT Commands TABLE 5. Local Command Network and Host Modes Parameters Details S51=n PAD data forwarding character. n=0 n=ASCII code no forwarding character ASCII code of character that will cause data to be forwarded. (Used in UDP or TCP PAD mode.) S82=n Enables UDP auto answer (half-open) mode. n=0 Normal mode n=2 Enable UDP auto answer mode. S83=n Set or query UDP auto answer idle time-out. If no data is sent or received before the time-out occurs, the current UDP session will be terminated.
AT Commands TABLE 5. Local Command Network and Host Modes Parameters Details TCPS=n TCPT=n TCP connection time-out (TCPT) units. n=0 TCPT specifies minutes. n=1 TCPT specifies seconds. n = minutes (TCPS=0) or seconds (TCPS=1) &Cn TCP connection time-out. Specifies a time interval upon which if there is no in or outbound traffic through a TCP connection, the connection will be terminated. This value only affects the TCP connection in TCP PAD mode. Set DCD mode.
AT Commands TABLE 5. Local Command Network and Host Modes Parameters Details *CTSE=n Clear To Send Enable This feature asserts CTS when there is a network connection. n=0 Disabled (Default). n=1 Enable assertion of CTS when there is network coverage. Note: Flow control (AT\Q) will override this indication, so if you want to use CTS to indicate network coverage, flow control has to be off (AT\Q0). RS232 voltage levels: Positive = Network coverage, Negative = no coverage.
AT Commands TABLE 5. Local Network and Host Modes Command Parameters Details *HOSTPEERIP =d.d.d.d d.d.d.d=local or peer IP of modem Set or query the IP address that can be used to directly contact the PinPoint once a PPP connection is established. If this value is not specified, 192.168.13.31 will be used. Note: This is not normally used nor needed by user applications. *HOSTPRIVIP =d.d.d.d d.d.d.
AT Commands TABLE 5. Local Command Network and Host Modes Parameters Details *UDPLAST=n If enabled, sets S53 to the last accepted IP address through UDP auto answer. This can be used in conjunction with MD3 so that when there is no UDP session, new ethernet host data will cause a connection to be restored to the last IP accepted through UDP auto answer. n=0 Does not change S53 setting. (Default). n=1 Set S53 to the last accepted IP. Note: This does not change the S53 setting in NVRAM.
AT Commands TABLE 6. PassThru Mode Command Parameters Details \APASSTHRU none Set modem operation to pass through mode. This will pass any characters received on the serial port directly to the internal OEM module and output any characters from the internal OEM module out the serial port. This allows direct access/configuration of the OEM module. Once this mode is entered, the unit must be physically reset to return to normal operation.
AT Commands It is possible to communicate with the PinPoint across a TCP/IP network (using TELUS’s network and the Internet). Telnet provides a terminal style connection to the PinPoint. Note: Telnet is not a secure communications protocol. TABLE 7. Telnet Command Parameters S60=n Details Telnet Client Echo Mode *TELNETTIMEOUT=n n=0 No Echo n=1 Local Echo (Default) n=2 Remote Echo n=minutes Telnet port inactivity time out.
AT Commands Friends Mode can limit access to the PinPoint from the Carrier network and the Internet. Friends Mode is a limited form of security. TABLE 8. Friends Command Mode Parameters FM=[n] Fn=[d.d.d.d] 93 Details Friends Mode - Only allow specified IPs to access the PinPoint. n=0 Disable Friends mode n=1 Enable Friends mode - Only packets from friends will be accepted (see below); packets from other IP addresses are ignored. n = Friends list index [0 - 9] Friends mode IP address d.d.d.
AT Commands Time and Date in the PinPoint is set to UTC (Coordinated Universal Time). Time is expressed in 24-hour format, i.e. 13:23:57 would be 1:23pm. You can set time and date manually or you can have it set automatically with a regular query to an Internet time server (such as time.nist.gov) using SNTP (Simple Network Time Protocol). TABLE 9. Time and Date Command Parameters Details *DATE=[mm/dd/ yyyy],[hh:mm:ss] mm/dd/yyyy = Sets and queries the clock in the unit.
AT Commands TABLE 10. Logging Command Parameters Details *DBGEVTLOGCLEAR none Clears the content of the logs in the modem. *DBGIPLVL=n Sets the logging level for the IP subsystem. n=0 No logging n=1 Log errors (i.e. invalid/corrupt packets, etc.). n=2 Log the header of all received packets. Note that this can quickly exhaust the event log. *DBGPPPLVL=n Sets the logging level for the PPP stack. n=0 No logging n=1-3 Enables logging at different levels of detail.
AT Commands IPManager (See “IP Manager translates a dynamic IP address to a fully qualified domain name so you can contact PinPoint by name as if it had a static IP.” on page 16.) is a service from AirLink which allows a PinPoint with a dynamic IP to be contacted as if it had a static IP by using a Fully Qualified Domain Name. TABLE 12. IPManager Command Parameters Details *DOMAIN=[name] name = domain name (i.e. eairlink.com) Domain (or domain zone) of which the PinPoint is a part.
AT Commands TABLE 12. IPManager Command Parameters Details *MODEMNAME=[name] name = domain name (i.e. eairlink.com) Name of the PinPoint (up to 20 characters long) to use when performing IP change notifications to IPManager. The value in *DOMAIN provides the domain zone to add to this name. Caution: Only letters, numbers, and hyphens can be used. Example: if *MODEMNAME=mymodem and *DOMAIN=eairlink.com, then the modem's fully qualified domain name is mymodem.eairlink.com.
AT Commands TABLE 13. Keepalive Command Parameters *IPINGFORCE=n *MINXMIT=n Details Have IP pings be always sent when their specified period expires. n=0 IP pings are sent only when the PinPoint has not received any IP packets for the specified IP ping interval. n=1 IP pings are issued when the IP ping interval expires regardless of received IP packets. n=seconds Minimum transmit period enforcement.
AT Commands Direct Communication can be used with the PinPoint to contact other Internet devices to pass information or other tasks. TABLE 14. Direct Communication Command Parameters Details D[method][d.d.d.d][/ppppp] method = or P - Establish a UDP connection Dial a connection to a remote IP and Port using either UDP, TCP, or Telnet. D[method][@name][/ppppp] T - Establish a TCP connection N - Establish a Telnet connection d.d.d.
AT Commands TABLE 14. Direct Communication Command Parameters Details S53=[method][d.d.d.d][/ ppppp] method = P - UDP Destination IP address, port, and method. These are used as defaults for the D (Dial) AT command. T - TCP Examples: N - Telnet ATS53=T192.168.100.23/12345 d.d.d.d = IP address or name ATS53=foo.earlink.com ppppp = the port address ATS53=192.168.100.
AT Commands TABLE 15. SMTP (email) Command Parameters Details *SMTPFROM=[email] email=email address Sets the email address from which the SMTP message is being sent. *SMTPPW=[pass] pass=password Sets the password to use when authenticating the email account (*SMTPFROM) with the server (*SMTPADDR). Note: not required to use SMTP settings but may be required by carrier.
AT Commands TABLE 16. Power Command Control Parameters Details DTRP=n Set or query the DTR power control. n=0 n = 0: Ignore DTR for power control n=1 n = 1: Enter low power mode when DTR is low n=2 n = 2: Enter low power mode when DTR is high See also PTMR PTMR=n n = 0-255 Number of minutes after one of the power down events (VTLG or DTRP) happens until the PinPoint enters the low power mode. If DTRP and VLTG are both 0 (zero), this setting does nothing.
AT Commands TABLE 17. External Command Events Parameters Details RTSI=n Enable monitoring the RTS signal as in input event. n=0 Disable RTS input monitoring n=1 Enable RST input monitoring Note: If RTS is used as an input, hardware flow control cannot be enabled. *DTRI=n Enable monitoring the DTR signal as in input event. n=0 n = 0: Disable DTR input monitoring n=1 n = 1: Enable DTR input monitoring Note: If DTR is used as an input, DTR cannot be used for low-power control.
AT Commands TABLE 18. SNMP Command Parameters Details n=0 Selects the security level requirements for SNMP communications as follows: *SNMPSECLVL=n No security required. SNMPv2c and SNMPv3 communications are allowed. n=1 Authentication equivalent to 'authNoPriv' setting in SNMPv3. SNMPv3 is required to do authentication, SNMPv2c transmissions will be silently discarded. n=2 Authentication and encryption, equivalent to 'authPriv' setting in SNMPv3.
AT Commands TABLE 19. Other Settings Command Parameters Details +CTA=n n=seconds 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.
AT Commands TABLE 20. Commands Command Usable with PassThru Parameters O Details none Online (Remote) Causes the modem to go from Command State to data state. Qn The AT quiet-mode setting. If quiet mode is set, there will be no responses to AT commands except for data queried. n=0 Off (Default) n=1 Quiet-mode on.
AT Commands TABLE 20. Commands Usable with PassThru Command Parameters Details S9=n n=0-255 Carrier Detect Response Time Specifies the time that the received carrier must be present for the modem to recognize it and turn on Data Carrier Detect (DCD) if applicable. The implementation is entirely at the IWF modem. S10=n n=1-2545 Lost Carrier Hang-up Delay (Remote) Specifies the amount of time that the carrier from the remote modem can be lost before the modem goes onhook.
AT Commands TABLE 20. Commands Usable with PassThru Command Parameters Details !STATUS none Displays the current modem status.
AT Commands TABLE 20. Commands Usable with PassThru Command Parameters Details +WMDN=[num] num=phone number Set the Mobile Directory Number (MDN). C311 Valid numbers are between 10 and 15 digits in length. For support of Wireless Number Portability in all nonRUIM software versions, changes to the MDN will update the IMSI_M portion (least significant 10 digits) of the IMSI.
AT Commands TABLE 20. Commands Usable with PassThru Command Parameters Details +WVSS=[n] n=roam type Preferred Roaming List 0 - Home Only Note: The values depend on the currently loaded PRL.
CHAPTER 13 PinPoint Specifications Physical Characteristics: • • • • • Weight: 2 lb. Size: 6.8” x 3.3” x 2” RF Antenna Connector: 50 Ohm TNC GPS Antenna Connector: SMA Serial Interface: RS232 DB-9F with 1200-115200 bps Data Services & RF Features: • • • • • • Full duplex transceiver Dual-band support for both 800 MHz cellular and 1.9 GHz PCS bands Dual band Receive Diversity Adheres to CDMA authentication as specified in CDMA2000 1X 224 mW RF output (+23.5 dBm) Data rates up to 153.
PinPoint Specifications • 10% duty cycle limit above 60°C • Humidity: 5%-95% Non-condensing Power Management: • • • • • • • Advanced Power Management features Low power consumption Input Voltage: 10 VDC to 28 VDC Input Current: 20 mA to 350 mA Typical Transmit/Receive: 300ma at 12VDC Dormant connection (idle for 10-20 seconds): 60 ma at 12 VDC Low power mode: 20 mA at 12 VDC TELUS CDMA/1xRTT PinPoint User Guide Version 2.
Troubleshooting If you encounter problems with your PinPoint, AirLink’s support staff can help. Support web site The Airlink web site is updated frequently with Setup Wizards, Utilities, FAQs, and other documentation. http://www.airlink.com/support Contacting Technical Support For support assistance please email support@airlink.com or call 510-781-9760 Monday through Friday 6 AM to 5 PM Pacific Standard Time. Support is not available weekends or holidays. TELUS CDMA/1xRTT PinPoint User Guide Version 2.
