View the User Guide
PinPoint EDGE/GPRS
User Guide
AirLink Communications, Inc.
version 2.20
February 2006
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. Data may be delayed, corrupted (i.e., have errors) or be totally lost. Although significant delays or losses of data are rare when wireless devices such as the AirLink Communications modem are used in a normal manner with a well-constructed network, the AirLink modem
should not be used in situations where failure to transmit or receive data could result in damage of
any kind to the user or any other party, including but not limited to personal injury, death, or loss
of property. AirLink Communications, Inc., accepts no responsibility for damages of any kind
resulting from delays or errors in data transmitted or received using the AirLink Communications
modem, or for failure of the AirLink Communications modem to transmit or receive such data.
Safety and Hazards
Do not operate the AirLink Communications modem in areas where blasting is in progress, where
explosive atmospheres may be present, near medical equipment, near life support equipment, or
any equipment which may be susceptible to any form of radio interference. In such areas, the AirLink Communications modem MUST BE POWERED OFF. The AirLink Communications
modem can transmit signals that could interfere with this equipment. Do not operate the AirLink
Communications modem in any aircraft, whether the aircraft is on the ground or in flight. In aircraft, the AirLink Communications modem MUST BE POWERED OFF. When operating, the
AirLink Communications modem can transmit signals that could interfere with various on board
systems. The driver or operator of any vehicle should not operate the AirLink Communications
modem while in control of a vehicle. Doing so will detract from the driver or operator's control
and operation of that vehicle. In some states and provinces, operating such communications
devices while in control of a vehicle is an offence.
Limitation of Liability
The information in this manual is subject to change without notice and does not represent a commitment on the part of AirLink Communications, Inc. AIRLINK COMMUNICATIONS, INC.
SPECIFICALLY DISCLAIMS LIABILITY FOR ANY AND ALL DIRECT, INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS OR REVENUE OR
ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE USE OR INABILITY TO
USE ANY AIRLINK COMMUNICATIONS, INC. PRODUCT, EVEN IF AIRLINK COMMUNICATIONS, INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR
THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY.
ii
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Contents
CHAPTER 1
Introduction to PinPoint EDGE or GPRS 1
PinPoint front and back 1
EDGE or GPRS Overview
2
Establishing a Internet Connection
2
Using the PinPoint to connect to the Internet 3
Using EDGE or GPRS to Communicate with Your Equipment
Common Uses for the PinPoint
CHAPTER 2
4
Subscriber Identity Module (SIM)
Installing the SIM
3
5
5
Opening the Case 5
Modem back 6
Modem partially slid from case 6
Ejecting the SIM tray 6
Tray button 6
Empty SIM Tray 7
Inserting the SIM 7
Cingular PinPoint EDGE or GPRS User Guide version 2.20
iii
Contents
SIM Tray with a SIM 7
Inserting the SIM 7
CHAPTER 3
Utilities for the PinPoint 8
AirLink Configuration Executive (ACE)
9
Wireless ACE 3G and Wireless ACE Web 9
Wireless ACE 3G 10
Wireless ACE Web 10
AceNet 11
AceNet 11
AceView 11
AceView 12
AceView: About Modem 12
Modem Doctor
13
Modem Doctor 13
AirLink Tracking System (ATS) 13
AirLink Tracking System 14
CHAPTER 4
Activation of the PinPoint EDGE or GPRS
Connecting the PinPoint to your computer
Quick Start Guide and Setup Wizard
Setup Wizard Menu
15
15
15
16
Activating the PinPoint using AT Commands
PinPoint Indicator Lights
17
17
PinPoint indicator lights PinPoint 17
CHAPTER 5
IP Manager
19
Fully Qualified Domain Name
Dynamic Name Resolution
20
20
Configuring the PinPoint for Dynamic IP
21
Wireless ACE: Dynamic IP (IP Manager configuration) 22
Restrictions for Modem Name 22
DNS: Using Names Instead of IP addresses
23
Configuring DNS 23
Wireless ACE: DNS 23
iv
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Contents
PPP-Peer 24
CHAPTER 6
Keepalive 25
Configuring Keepalive
25
Wireless ACE: Keepalive Configuration 26
Data usage using Keepalive
CHAPTER 7
Host Modes
26
28
AT Mode
29
PassThru Mode
PPP Mode
31
Slip Mode
32
30
UDP Pad Mode
32
UDP Auto Answer 32
Reliable UDP 33
Multicast UDP 34
TCP PAD Mode
34
TCP Auto Answer 35
Hybrid Modes
36
Hybrid Mode Settings 36
CHAPTER 8
External Inputs and Power Control
Capturing Events via External Inputs
37
37
Setting the DTR and RTS 37
Wireless ACE: DTR and RTS 38
Connecting to the Serial Port 38
PinPoint back 38
PinPoint Serial Port Pinouts 39
DTR and RTS switches using Pin 5 (signal GND) as the common ground (broche 5) 39
Power Modes
39
Power Effect on Modem State
40
Cingular PinPoint EDGE or GPRS User Guide version 2.20
v
Contents
CHAPTER 9
Global Positioning System (GPS)
GPS Overview
41
41
AirLink Remote Access Protocol (RAP) 42
National Marine Electronics Association (NMEA)
Trimble ASCII Interface Protocol (TAIP) 42
Real-Time Clock Sync
42
43
Configuring the PinPoint for GPS
43
Over-The-Air (Remote) Host 43
Wireless ACE: *PPIP and *PPPORT 43
Local Host 44
Wireless ACE: S53 44
Wireless ACE: *PPLATSEXTRA 44
Report Types 44
Wireless ACE: *PPGPSR and *PPLATSR 44
Sending Reports Automatically 45
Wireless ACE: Automatic Reports 45
Wireless ACE: Local Automatic Reports 45
Wireless ACE: GPS Initialization Timer 46
RAP Configuration
46
RAP Reports Over-The-Air (Remote) 46
Wireless ACE: RAP Reports Remote 46
Wireless ACE: *PPIGNOREIP 47
RAP Reports over a Local Connection (PPP or SLIP)
Wireless ACE: RAP Local Reports 47
RAP Message format 48
Additional RAP Features
47
49
Device ID 49
Wireless ACE: *PPDEVID 49
Odometer Data in Reports 50
Wireless ACE: Odometer Reports 50
Serial Input Event Reports 50
Wireless ACE: Enabling RTS and DTR for Input Events 50
Wireless ACE: Input Event Reports 51
COM1000 Event Reports 51
Wireless ACE: COM1000 Events 51
Store and Forward for RAP
52
Wireless ACE: Store and Forward 52
Store and Forward Reliable Mode 53
Wireless ACE: Store and Forward Reliable Mode 53
Wireless ACE: Adding GPS Time, Latitude, and Longitude to Reliable UDP data
vi
Cingular PinPoint EDGE or GPRS User Guide version 2.20
53
Contents
Sending Reports 54
Wireless ACE: Automatic Reports 54
Flush on Event 54
Wireless ACE: Store and Forward Flush on Event
Legacy ATS/RAP
54
55
Wireless ACE: *PPGPSR and *PPLATSR 55
Wireless ACE: Legacy format 55
NMEA Configuration
55
Streaming NMEA Messages over the local serial port 56
HyperTerminal: NMEA Stream 56
Wireless ACE: NMEA Strings 56
NMEA Messages Over-The-Air (Remote) T 57
Wireless ACE: NMEA Remote Reports 57
NMEA Messages over a Local Connection (PPP or SLIP) 57
Wireless ACE: NMEA Local Reports 57
NMEA Message Description 58
GGA - Global Positioning System Fix Data 58
RMC - Recommended Minimum Navigation Information 59
VTG - Vector track an Speed over the Ground 60
TAIP Emulation Configuration 60
TAIP Messages Over-the-Air (Remote) 60
Wireless ACE: TAIP Remote Reports 61
TAIP Messages over a Local Connection (PPP or SLIP) 61
Wireless ACE: TAIP Local Reports 61
Sending Unsolicited TAIP Messages over a Local Connection
Wireless ACE: TAIP Local Reports, Unsolicited 62
Using TAIP Command Emulation 62
Wireless ACE: TAIP Emulation 63
TAIP ID 63
Wireless ACE: TAIP ID 63
Supported TAIP Commands 63
TAIP Message Description 64
Elements of a TAIP message 65
CHAPTER 10
Simple Network Management Protocol (SNMP)
SNMP Overview
66
66
Management Information Base (MIB)
SNMP Traps 67
PinPoint SNMP Configuration
Listening Port
62
67
67
67
Cingular PinPoint EDGE or GPRS User Guide version 2.20
vii
Contents
Wireless ACE: *SNMPPORT 67
Security Level 68
Wireless ACE: *SNMPSECLVL 68
User Name and Password 68
Wireless ACE: Changing the PinPoint Password - Menu Option 69
Wireless ACE: Changing the PinPoint Password 69
Trap Destination 70
Wireless ACE: *SNMPPORT 70
Example of the MIB trap
CHAPTER 11
Hardware Installation
70
78
Possible locations for your PinPoint installed in a vehicle are in a trunk away from
where luggage or other items won’t be likely to dislodge it, under or in the console,
or behind seats. Ensure the location is secure both against abrupt movements of the
vehicle and from other items coming into contact with the modem.PinPoint
Mounting Kit 78
PinPoint Mounting Bracket, part number 100-170-1005 79
Connecting the Antenna
80
PinPoint connecters 80
Connecting power
80
Connecting the PinPoint to a computer or other device
CHAPTER 12
PinPoint: AT Commands
81
82
Using Wireless Ace 82
Wireless ACE: Using AT Commands 82
Wireless ACE: Toolbar 83
Using Telnet Terminal Emulation
83
HyperTerminal: Connection Name 84
HyperTerminal: TCP/IP Settings 84
HyperTerminal: AT mode via Telnet 84
Direct Serial Connection
85
HyperTerminal: Connection Name 85
HyperTerminal: Comport Setting 85
HyperTerminal: Comport Settings 86
AT Commands
86
Information and Status 87
Activation (Provisioning) 90
viii
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Contents
Cellular Network (Cingular’s EDGE or GPRS) 90
Local Network and Host Modes 92
PassThru Mode 99
Friends Mode 100
Telnet 100
Time and Date 101
Logging 101
DNS 102
IP Manager 103
Keepalive 104
Direct Communication 106
SMTP (email) and SMS (messaging) 107
SNMP 109
GPS 110
External Events 115
Power Control 115
Commands Available only when in PassThru
117
Commands Usable with PassThru 117
Other Settings 117
CHAPTER 13
Specifications for the PinPoint EDGE or GPRS 124
Physical Characteristics: 124
Data Services & RF Features: GPRS 124
Data Services & RF Features: EDGE 125
Environmental: 125
Power Management: 125
Support web site
126
Contacting Technical Support
126
Cingular PinPoint EDGE or GPRS User Guide version 2.20
ix
CHAPTER 1
Introduction to
PinPoint EDGE or
GPRS
The PinPoint's rugged form factor is ideal for industrial and commercial applications that require real-time communications. The PinPoint provides cellular data
communications for a variety of applications, such as telemetry, public safety,
SCADA, traffic control, traffic metering, transit arrival systems and more.
FIGURE 1.
PinPoint front and back
Cingular PinPoint EDGE or GPRS User Guide version 2.20
1
Introduction to PinPoint EDGE or GPRS
EDGE or GPRS Overview
Enhanced Data rates for GSM Evolution (EDGE) provides Enhanced GPRS
(EGPRS) which can be used for any packet switched applications such as an Internet connection. EDGE can carry data speeds up to 384 kbit/s in packet mode.
General Packet Radio Service (GPRS) is packet-switched with many users sharing
the same transmission channel, only transmitting when they have data to send. This
means that the total available bandwidth can be immediately dedicated to those
users who are actually sending at any given moment, providing higher utilization
where users only send or receive data intermittently. GPRS provides speeds of 30–
70 kbps with bursts possibly up to 170 kbps.
Establishing a Internet Connection
The Internet Service Provider (ISP) from you to the Internet is Cingular with your
PinPoint as the connection to Cingular.
When your PinPoint is powered on, it automatically searches for cellular service
using EDGE or GPRS and establishes a PPP (Point to Point Protocol or “dial” up
connection) link to Cingular’s network. As soon as the PinPoint receives its IP, it’s
ready to create a network between your computer or device and Cingular’s network
so you can use Cingular to communicate on the Internet.
To use your PinPoint to connect to the Internet from your computer, you need to
connect the computer directly to the PinPoint’s serial port and use Dial-Up Networking (DUN).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
2
Introduction to PinPoint EDGE or GPRS
FIGURE 2.
Using the PinPoint to connect to the Internet
Note: Private network connections are unique for each configu-
ration and not covered as part of the standard installation.
Using EDGE or GPRS 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 Cingular.
• Static addresses are permanently assigned to a particular account and will
always be used whenever your PinPoint connects to the Internet. The IP
address will not be given to anyone else.
If you need to contact the PinPoint, a device connected to the modem, or a host system using the modem, you need to have a known IP (such as one which is static) or
domain name (an IP address which is converted by a DNS server into a word based
name).
Most ISPs (cellular included) use dynamic IP addresses rather than static IP
addresses. A dynamic IP address is suitable for many common Internet uses, such
as web browsing, looking up data on another computer system, or other client function (such as data only being sent out or only being received after an initial request).
3
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Introduction to PinPoint EDGE or GPRS
Note: 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 Cingular must
also be Internet routable if the computer you need to connect to
the PinPoint is not connected directly to Cingular's IP network.
Please check with Cingular to confirm you IP is scheme is correct for your application and needs.
Common Uses for the PinPoint
The PinPoint’s rugged construction and cellular connection make it ideal for use in
remote and/or industrial locations.
Because of its GPS capabilities, the PinPoint is ideal for vehicle tracking and
other situations where noting a moving location is as important as connecting to a
network.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
4
CHAPTER 2
Subscriber Identity
Module (SIM)
The Subscriber Identity Module (SIM) in the PinPoint is a smartcard securely storing the key identifying a mobile subscriber. Generally, you will only need to install
the SIM once in the life of the modem and it may be pre-installed by AirLink.
Installing the SIM
To install the SIM, you will only need a small phillips head screw driver.
Opening the Case
1.
Unplug the modem power and all cables.
2.
Using a small phillips head screw driver, remove the four screws on the back of
the modem.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
5
Subscriber Identity Module (SIM)
FIGURE 1.
3.
Modem back
Slide the casing off of the modem and set it aside.
FIGURE 2.
Modem partially slid from case
Ejecting the SIM tray
4.
Using the tip of a PDA stylus, an unbent paperclip, or other slim blunt item
press the yellow button between the two cards.
FIGURE 3.
Tray button
Cingular PinPoint EDGE or GPRS User Guide version 2.20
6
Subscriber Identity Module (SIM)
5.
Slide the tray out of the slot.
FIGURE 4.
Empty SIM Tray
Inserting the SIM
6.
Place the SIM into the tray and gently press to click it into place.
FIGURE 5.
7.
SIM Tray with a SIM
Slide the tray back into the modem and gently press to click it into place.
Note: The card is “up-side down”. The top of the card faces the
the bottom of the modem.
FIGURE 6.
7
Inserting the SIM
8.
Slide the modem back into the case.
9.
Secure the back of the modem with the screws.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
CHAPTER 3
Utilities for the PinPoint
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 3G 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.
These utilities, except AceNet and AirLink Tracking System (ATS), are free of
charge to those who own AirLink modems. You can download the utilities and
their user guides from the AirLink web site: http://www.airlink.com/support. Contact your dealer or AirLink representative for information on AceNet and ATS.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
8
Utilities for the PinPoint
Note: AceView, Wireless ACE 3G, and AceNet require the
Microsoft .NET Framework and Microsoft Windows 98, Windows 2000, Windows XP, or later. Wireless ACE Web requires
Microsoft Internet Explorer 6.0 or later with ActiveX enabled.
You can obtain the Microsoft .Net Framework, Microsoft Internet Explorer, and/or the latest ActiveX updates for Internet
Explorer from Microsoft at: http://www.microsoft.com/.
AirLink Configuration Executive (ACE)
The AirLink Configuration Executive provides a user friendly interaction with
ALEOS, the brains of your PinPoint.
Wireless ACE 3G and Wireless ACE Web
Wireless ACE 3G 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 3G. Features discussed in this section apply to both versions unless otherwise noted.
9
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Utilities for the PinPoint
FIGURE 1.
Wireless ACE 3G
FIGURE 2.
Wireless ACE Web
Cingular PinPoint EDGE or GPRS User Guide version 2.20
10
Utilities for the PinPoint
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 3.
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.
With AceNet, you can connect to modems locally via serial or Ethernet or remotely
via TCP/IP or SMS.
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.
11
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Utilities for the PinPoint
FIGURE 4.
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 and PinPoint-E modems.
FIGURE 5.
AceView: About Modem
Cingular PinPoint EDGE or GPRS User Guide version 2.20
12
Utilities for the PinPoint
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 6.
Modem Doctor
AirLink Tracking System (ATS)
The AirLink Tracking System (ATS) is a feature-rich vehicle tracking system that
uses cellular technology to transmit vehicle and location information to a Tracking
13
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Utilities for the PinPoint
Control console. ATS also employs the satellite based Global Positioning System
(GPS) to obtain location and velocity information.
ATS is a seperate product which can be purchased from AirLink.
FIGURE 7.
AirLink Tracking System
Cingular PinPoint EDGE or GPRS User Guide version 2.20
14
CHAPTER 4
Activation of the
PinPoint EDGE or
GPRS
Your PinPoint needs specific parameters before it can operate on the EDGE or
GPRS network. Generally Cingular 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.
Quick Start Guide and Setup Wizard
The preferred way to configure and activate your PinPoint is via the AirLink Setup
Wizard for Cingular and EDGE or GPRS. The Quick Start Guide will lead you
through the using the Setup Wizard.
• The PinPoint Setup Wizard for EDGE or GPRS and Cingular is available from
the AirLink web site, http://www.airlink.com/support.
• The Quick Start Guide is also available at the AirLink web site.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
15
Activation of the PinPoint EDGE or GPRS
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
Cingular, EDGE or GPRS, and the PinPoint. Other Setup Wizards may not work to connect you to Cingular.
To run the Setup Wizard, you will need the Microsoft .NET framework and
Microsoft Windows 98, Microsoft Windows 2000, Microsoft Windows XP, or
later.
1.
Select Start.
2.
Select All Programs.
3.
Select AirLink Communications.
4.
Select Setup Wizard.
5.
Select Setup Wizard.
FIGURE 1.
Setup Wizard Menu
The Quick Start Guide specifies the information you need and will lead you
through the steps.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
16
Activation of the PinPoint EDGE or GPRS
Activating the PinPoint using AT Commands
An alternate method to configure and activate your PinPoint is by AT commands
(full listing beginning on page 83) sent directly to the modem via a terminal application. This method is recommended only in situations where the Setup Wizard is
not available and/or the configuration for the PinPoint is unusual.
Caution: While you can configure your PinPoint using Wireless
ACE (page 10) or AceNet (page 12), it is not recommended to
activate the PinPoint using either Wireless ACE or AceNet.
PinPoint Indicator Lights
When your PinPoint is connected to power and an antenna, there is a specific pattern to the lights to indicate its operation mode.
FIGURE 2.
PinPoint indicator lights PinPoint
Tx (transmit) and Rx (receive) - Lights will flash as data is transferred to and
from the PinPoint on the remote network.
RSSI - Light shows the strength of the signal and may be nearly solid (strong signal) or
flashing (weaker signal). A slow flash indicates a very weak signal.
Reg - Indicates the PinPoint has acquired an IP from Cingular.
Chan - Indicates the modem has acquired a network channel.
Link - Indicate a successful connection to the cellular network.
17
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Activation of the PinPoint EDGE or GPRS
Pwr - Indicates the power adapter is connected and there is power getting to
the modem.
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.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
18
CHAPTER 5
IP Manager
IP Manager translates a dynamic IP address to a fully qualified domain name so
you can contact your PinPoint by name as if it had a static IP.
Since Wireless Service Providers frequently do 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.
• Dynamic IP addresses are granted only when a modem or other device is connected and can change each time the modem or device reconnects to the network.
• Static IP addresses are granted the same address every time the modem or
device is connected and are not in use when the associated device is not connected.
A dynamic IP address is suitable for many Internet activities such as web browsing,
looking up data on another computer system, data only being sent out, or data only
being received after an initial request. However, if you need to contact the PinPoint
directly, a device connected to the modem, or a host system using the PinPoint, a
dynamic IP won’t give you a reliable address to contact (since it may have changed
since the last time it was assigned).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
19
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. if a domain is part of the .ca TDL, it would be registered with the
Canadian domain registry). It is necessary to have a name registered before it
can be used.
• Sub-domain or server name: A domain name can have many sub-domain or
server names associated with it. Sub-domains need to be registered with the
domain, but do not need to be registered with ICANN or any other registry. It is
the responsibility of a domain to keep track of its own subs.
A URL (Universal Resource Locator) is different from a domain name in that it
also indicates information on the protocol used by a web browser to contact that
address, such as http://www.airlink.com.
• .com is the TDL
• airlink is the domain (usually noted as airlink.com since the domain is specific
to the TDL)
• www is the server registered with AirLink.com
• http:// is the protocol (html or web) used to access the webpage for AirLink
Dynamic Name Resolution
When an IP address is not expected to change, the DNS server can indicate to all
queries that the address can be cached and not looked up for a long period of time.
Dynamic DNS servers, conversely, have a short caching period for the domain
information to prevent other Internet sites or queries from using the old information.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
20
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.
Note: The fully qualified domain name of the PinPoint will be a
subdomain of the domain used by the IP Manager server.
As a free service, Airlink maintains an IP Manager server which can be
used for any AirLink modem. The domain is earlink.com and is used
in all the samples below.
Configuring the PinPoint for Dynamic IP
To configure the Dynamic IP settings in your PinPoint so that it will use IP Manager, you can use AT commands (page 83), using direct serial communication or
Telnet, Wireless ACE (page 10), and ACE Net (page 12) using a template built
from Wireless ACE.
To configure your AirLink modem to be addressed by name, the modem needs to
have 4 elements configured.
In Wireless ACE, select Dynamic IP to configure your modem to use IP Manager.
21
Cingular PinPoint EDGE or GPRS User Guide version 2.20
IP Manager
FIGURE 1.
Wireless ACE: Dynamic IP (IP Manager configuration)
1.
Modem name: The name you want for the modem.
2.
Domain: The domain name to be used by the modem.
3.
IP Manager IP Address: The IP or domain name of the dynamic DNS server
which is running IP Manager.
Note: To use the name here instead of the IP, you need to have
DNS set up in your PinPoint (page 23).
4.
IP Manager update interval: How often you want the address sent to IP Manager. If this is set to zero, the modem will only send an update if the IP changes
(i.e. if the modem is reset or is assigned a different IP).
You can configure a second dynamic server as a backup, secondary, or alternate
server.
Note: For the Modem Name, you should use something which is
unique but also easy to remember. Your company name or the
intended function of the modem are recommended. If you have
more than one modem, you can append a number for each.
Restrictions for Modem Name
•
•
•
•
Must begin with a letter or number
Can include a hyphen (-)
Cannot contain spaces
Must be no longer than 20 characters total
Cingular PinPoint EDGE or GPRS User Guide version 2.20
22
IP Manager
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).
Domain Name Service (DNS) is a network service which translates, or redirects,
the IP address, allowing someone to contact that address via the name. A DNS
server is registered to handle all addresses of a particular domain (much like the
post office for a particular town or city is known to the post offices of all other
towns and cities and is authorized to give the addresses of locations in its own location).
Configuring DNS
The PinPoint has an internal DNS resolver with which it can query DNS servers in
order to translate names into IP addresss which it can then use internally. Generally, when your PinPoint receives its IP address from Cingular, it will also be configured to use Cingular’s DNS servers to use for resolving (or translating) names to
IP addresses. In that case, the only one which is not overwritten is the alternate
DNS.
You can use AT commands (page 83), Wireless ACE (page 10), and ACE Net
(page 12) using a template built from Wireless ACE to configure DNS in your PinPoint.
FIGURE 2.
23
Wireless ACE: DNS
Cingular PinPoint EDGE or GPRS User Guide version 2.20
IP Manager
*DNS1 and *DNS2 - Set these to your primary and secondary DNS servers.
These maybe be overwritten by Cingular when your PinPoint gets its IP
address.
*DNSUSER - Set this, if desired, to an additional DNS server to query first
before the primary or secondary (just as a hosts file is queried first on a computer). If *DNSUSER is set to 0.0.0.0, it will be ignored.
*DNSUPDATE - This command sets how often you want DNS Updates to be
forced. Otherwise the PinPoint will only send updates when it is reset, powered
up, or the IP address granted by the network changes.
Note: If you will be using your PinPoint to communicate with
another AirLink modem and both are using IP Manager to translate dynamic IP addresss to domain names, it is recommended
that you set *DNSUSER to the IP address for IP Manager. IP
Manager’s updates occur more frequently than Cingular’s DNS
servers decreasing the time between IP address change and
address resolution.
PPP-Peer
The PinPoint uses the unqualified domain name of “ppp-peer” when it is PPP or
SLIP address mode to resolve the address of the device or computer connected via
PPP or SLIP address. If the PinPoint is not in PPP or SLIP address mode, “ppppeer” will resolve to 0.0.0.0.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
24
CHAPTER 6
Keepalive
It is not uncommon for your PinPoint to be disconnected from Cingular 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 Cingular 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 is also recommended if you have experienced
issues where the modem can no longer be reached remotely.
When Keepalive pings the IP address, an acknowledgement indicates there is an
active connection to the network. If the modem does not receive a response from
the IP address, it will retry 5 times in 5 second intervals. The PinPoint will then
reset the radio module after 5 failed attempts and reconnect to Cingular.
Configuring Keepalive
As with all other aspects of the PinPoint’s configuration, you can use Wireless Ace
or Wireless Ace Web (page 10), AceNet (page 12), direct serial communication
(page 83), or Telnet (page 83) to configure Keepalive.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
25
Keepalive
To set the Keepalive using Wireless ACE, select Other from the menu on the left.
FIGURE 1.
Wireless ACE: Keepalive Configuration
*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. an IP which is
unreachable or one which is not a valid IP address), the modem will reset itself
on a regular interval.
*IPPINGFORCE sets whether you wish the network connection test to occur
only if there is no activity. Set to 1, IPPINGFORCE will force the ping to occur
at the IPPING interval regardless of any other network activity. When
*IPPINGFORCE is set to 1, the modem does a complete modem reset, in addition to resetting the connection. When the modem is reset, it could take a few
minutes to reconnect to the network.
Data usage using Keepalive
When using Keepalive, be aware that a ping moves approximately 66 bytes of data
over the network and is billable by the carrier. The following *IPPING settings
will incur approximate monthly data usage in addition to any other data usage:
5 minutes
1.2mb / month
15 minutes
400k / month
30 minutes
200k / month
Cingular PinPoint EDGE or GPRS User Guide version 2.20
26
Keepalive
27
60 minutes
100k / month
120 minutes
50k / month
Cingular PinPoint EDGE or GPRS User Guide version 2.20
CHAPTER 7
Host Modes
The PinPoint plays the part of a host when its serial port is connected to a computer
or another device. As the host, the PinPoint can be in one of six communication
modes.
AT: The PinPoint accepts and responds to standard, Hayes-style AT commands.
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.
UDP PAD: Any data received on the serial port is assembled into UDP packets
and send to the session's associated IP and Port (described later). Any responses
received from the associated IP and port destined for the modem's Device Port
are unwrapped and sent out the serial port.
TCP PAD: Any data received on the serial port is packaged into TCP messages
and sent to the associated connection's IP and Port (described later). Any data
received from the TCP peer is unwrapped and sent out the serial port.
By default, the PinPoint is in AT Mode and allows AT Commands to be entered via
Telnet (through the serial port connection) or remotely (through the cellular network).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
28
Host Modes
The PinPoint can be programmed to enter any of the modes, except PassThru, automatically on power up. This is done setting the Startup Mode Default (refer to MD
in the AT Command listing, page 94) 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).
• Resetting or Power cycling the modem.
PassThru Mode can only be exited by resetting the modem.
Note: DTR needs to be asserted (S211=1 or &D0) by the host
before PPP Mode, SLIP Mode, UDP PAD Mode, or TCP PAD
Mode can be entered.
AT Mode
AT commands are used to configure the modem, command it to do something, or
query a setting. For a full listing of the AT commands, refer to page 83.
AT commands must always be terminated by <CR> (ASCII character 0x0D).
If E=1 (Echo On), the AT command (including the terminating <CR>) will be
displayed (output) before any responses.
Two settings affect the format of AT command output: V (Verbose) and Q (Quiet).
If Q=1 (Quiet On), no result codes are output whatsoever, so there is no
response generated by a (non query) command.
If Q=0 (Quiet Off), result codes are output. The format of this output is then
affected by the Verbose setting.
If Quiet mode is off, the result code is affected as follows:
29
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Host Modes
For V=1 (Verbose mode), the textual result code is surrounded by <CR><LF>
and any AT query response is also surrounded by <CR><LF>.
For V=0 (Terse mode), a numeric result code is output with a single trailing
<CR> (no <LF> is output), while any AT query response is followed by
<CR><LF> (there is no preceding output).
For example, possible output to the AT command "AT<CR>" (assuming quiet
mode is not on) is:
<CR> - if V=0
<CR><LF>OK<CR><LF> - if V=1
PassThru Mode
In PassThru mode, the PinPoint does not behave normally, all serial port communication is passed directly between the internal hardware and the computer connected
directly to the modem. This mode can be used to configure hardware-specific settings (e.g., for provisioning, etc.).
Issuing the "AT\APASSTHRU" enters this mode. The modem responds with OK,
at which point a direct connection to the internal hardware is established.
Some internal hardware requires upwards of 20 seconds before AT commands can
be entered, so be patient if there seems to be no response to AT commands.
Caution: PassThru can only be exited by resetting or power-
cycling the modem. This mode cannot be entered via a Telnet
session.
PassThru Mode allows only specific AT commands. Those commands which are
used with ALEOS only will be unavailable. For the many of the commands available in PassThru mode, refer to page 119. Most of these commands are not available except when the modem is in PassThru Mode. The commands usable also
depend heavily on the modem model number (found on the label on the top of the
modem).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
30
Host Modes
Caution: ALEOS is disabled in PassThru Mode. You cannot use
most ALEOS specific commands while the modem is in
PassThru Mode.
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<CR>
ATDT10.0.0.1<CR>
ATDT10001<CR>
ATD#19788<CR>
CLIENT<CR>
In response to any of the preceding commands, the modem will respond with
CONNECT<CR><lf> and is ready for the host to begin PPP negotiations.
The IP received by the host in the resulting negotiation will either be a private (nonroutable) IP or a public (network-routable) IP provided by the network, depending
on the settings of *HOSTPRIVMODE. If *HOSTPRIVMODE=1, the value of
the private IP an be determined beforehand by querying S110. The private IP to be
used can be defined with the command AT*HOSTPRIVIP=192.168.100.33 substituting the desired IP address.
AT*HOSTPRIVIP=192.168.100.33Using a private IP insulates the PPP client
from changes in IP addresses of the underlying network. The PinPoint will perform
basic NAT-like address translation on all packets.
If a public IP address is being used, any changes in the IP (as determined by the
wireless network) will result in the PPP link to the host being disconnected, requiring the host to reinitiate it. The public IP is passed to the host in the PPP negotiations, so when the network forces a change, the modem has to force the host to
renegotiate the PPP link to make this happen.
31
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Host Modes
Slip Mode
SLIP mode is entered be using the "AT\ASLIP" command. As in PPP Mode, the IP
address that the host assumes is affected by the setting of *HOSTPRIVMODE.
SLIP does not negotiate the IP with the host, so before making a SLIP connection,
the host SLIP driver must be configured to use the IP specified by querying S110.
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.23/3456)
• Setting the Startup Mode Default (MD) to 3 (UDP) so that a UDP session is
entered automatically when the modem powers up. Serial data will be sent to
the IP/port specified in S53.
• An incoming UDP packet is received and
• UDP auto answer is enabled (S82=2);
• The destination IP address matches that in S53;
• Or allow any IP is set (AIP=1);
• The modem is in AT mode (not in a current UDP or TCP session).
• • • • UDP 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).
UDP Auto Answer
UDP auto answer (previously called UDP half-open) is set with S82=2. When set,
the PinPoint will automatically establish a UDP session to the source IP address
and port of the UDP packet received. The PinPoint will remain "locked" to this one
Cingular PinPoint EDGE or GPRS User Guide version 2.20
32
Host Modes
remote IP/port until no data is sent or received for the time interval defined in the
UDP auto answer time-out (S83). During this session, packets from other IP/port
addresses will be rejected, unless *UALL is set. Whether or not an incoming
packet will cause the modem to enter a UDP session is always dependent on the
S53 and AIP settings.
When idle, after the time-out has occurred, the PinPoint is in AT command mode on
the serial port, and any valid AT command may be entered during this time.
The Normal UDP Mode (MD3) can be combined with UDP auto answer to cause
the incoming serial data to be sent in UDP packets (instead of being treated as AT
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. The S53 setting can be changed if
the connect to last UDP setting (*UDPLAST=1) is set. The address in S53 will be
updated to reflect the address of the last session initiated by an incoming UDP
packet. So that when new data is received over the host serial port while in the idle
state, a session will be re-established with the last address. (This behavior is the
same as the previous Hybrid2 (MD6) mode).
Note: TCP auto answer (S0) may also be set simultaneously with
UDP auto answer. Then, when in the idle state, the modem will
accept either a TCP or UDP incoming packet, and enter a TCP
or UDP session as appropriate.
Reliable UDP
Reliable UDP adds a simple protocol on top of UDP to provide reliable delivery of
data. When data is received from the host serial port, a 2 byte header is added to the
data, containing a message type and a sequence number. The PinPoint will continue
to send this data (buffering any received data in the meantime) until it receives an
acknowledgement with this sequence number. If an acknowledgement is not
received within the time-out period (specified in S7), the data will be retransmitted.
This will continue until an acknowledgement is received or the modem is reset.
Likewise any UDP packets received by the PinPoint are expected to have this sim-
33
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Host Modes
ple header. The PinPoint will issue an acknowledgement for any valid packets
which are received.
Configure the PinPoint as for a normal UDP session. Set the Startup Mode Default
to 3, and the UDP Mode Default to 7 (ATMD73). If using two modems, configure
the Destination IP and Port in each to point to each other. Serial data will then be
sent reliably between the two
Note: Although it adds reliability, the simple implementation of
the Reliable UDP mode in the PinPoint does not check for
duplicate packets.
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). Since it may take a while to transmit the data to all hosts
(especially if all 20 Modbus entries are used and name resolutions are required),
new data received from the host port is buffered until current transmissions to all
hosts are finished.
Enter the list of target IPs in the Modbus IP list. The index numbers in the IP list
aren't used. Configure the Raven as for a normal UDP session. Set the Startup
Mode Default to 3, and the UDP Mode Default to 8 (ATMD83). Configure the
Destination port to match the device port of the remote modems.
TCP PAD Mode
When the PinPoint is in a TCP session, all characters received on the serial port are
assembled into TCP packets and sent to the mode's remote IP address/port, and any
packets received from the remote end of the TCP connection are disassembled and
dumped onto the serial line.
• A TCP connection is established by one of the following methods:
• Using the Dial TCP (DT) AT command (for example, ATDT192.168.3.23/
3456)
Cingular PinPoint EDGE or GPRS User Guide version 2.20
34
Host Modes
• TCP auto answer is enabled (S0), a TCP connection request is received, and the
modem is not in a data session.
• Data is received on the serial port and
• The Startup Mode Default (MD) is 4 (auto TCP)
• The remote TCP destination, as defined in S53, successfully responds to the
TCP connection request.
The value of S7 (TCP Connection Time-out) specifies the number of seconds to
wait, after initiating a TCP connection attempt, for a successful connection to be
established. If the connection has not been successfully established before the timeout occurs, ERROR/BUSY is returned.
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. TCPT is the number of minutes (TCPS=0)
or seconds (TCPS=1) used for this idle time-out.
Caution: TCPT should never be 0 when using the TCP mode. A
broken TCP session can result in the modem being left with a
TCP half-open connection that can only be terminated with a
reset.
TCP Auto Answer
TCP auto answer (S0=1|2) also allows a TCP connection request to be "answered"
when the modem is idle, not in a data session. The TCP connection request's destination port has to match the modem's device port.
Note: UDP auto answer may also be set simultaneously with
TCP auto answer. Then, when in the idle state, the modem will
accept either a TCP connection request or UDP incoming
packet, and enter a TCP or UDP session as appropriate.
35
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Host Modes
Hybrid Modes
Some previous hybrid modes (MD=5, 6) are no longer implemented as special,
unique modes. Now that UDP auto answer (UDP Half-open, S82=2) can be
enabled in conjunction with UDP PAD mode (MD3), effectively this is the same
as MD5 and MD6 previously accomplished. Setting MD5 and MD6 are still supported, but not recommended.
TABLE 1. Hybrid
Mode Settings
AT
Hybrid (MD5)
Hybrid2 (MD6)
MD
3
3
S82
2
2
S0
1
1
*UDPLAST
0
1
Cingular PinPoint EDGE or GPRS User Guide version 2.20
36
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.
Capturing Events via External Inputs
The RS232 DB9 interface (the serial port) can be connected to digital switches and
configured to capture contact closures using RTS and DTR to signal external or
physical events (such as a tow bar being activated, opening a door or trunk, the car
is turned on or off, etc.).
Setting the DTR and RTS
You can use either Wireless ACE (page 10), direct serial communication, or Telnet
to configure the modem using AT commands (page 82).
In Wireless ACE, select PinPoint from the menu on the left.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
37
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. If
you want to use the DTR switch, wire in a Normally Open switch between the DTR
(pin 4) and signal ground (pin 5), the PinPoint’s external case, or the power
ground (refer to the figures below). If you want to use the RTS switch, use RTS
(pin 7) to the ground (can use the same ground as DTR).
Caution: Never apply voltage to the DTR or RTS inputs. DTR
and RTS can only be switched open or closed to ground.
When the switch is closed, a GPS packet will be sent to the destination IP address
indicating that a contact closure has taken place (an external physical event has
occurred). See “RAP Configuration” on page 46.
FIGURE 2.
PinPoint back
Cingular PinPoint EDGE or GPRS User Guide version 2.20
38
External Inputs and Power Control
FIGURE 3.
PinPoint Serial Port Pinouts
DTR and RTS switches using Pin 5 (signal GND) as the common
ground (broche 5)
FIGURE 4.
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.
PinPointThe PinPoint can power down when the voltage to the modem drops below
a configured threshold (generally caused by the vehicle being turned off), or when
DTR changes (commonly a contact or voltage controlled by the key switch, signaling when the vehicle is turned off).
39
Cingular PinPoint EDGE or GPRS User Guide version 2.20
External Inputs and Power Control
Note: If one or both DTR or RTS have been configured to be
used as digital inputs through the AirLink Tracking System
(ATS), then low power mode cannot be configured to respond to
DTR.
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.
When the modem is woken from low-power mode, the same behavior occurs as
upon power on. The modem starts in AT mode, and then after 5 seconds will enter
the default mode (See “Host Modes” on page 28).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
40
CHAPTER 9
Global Positioning
System (GPS)
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.
GPS Overview
The Global Positioning System (GPS) is a satellite navigation system used for
determining a location and providing a highly accurate time reference almost anywhere on Earth. The US military refers to GPS as Navigation Signal Timing and
Ranging Global Positioning System (NAVSTAR GPS).
GPS consists of a "constellation" of at least 24 satellites in 6 orbital planes. Each
satellite circles the Earth twice every day at an altitude of 20,200 kilometres
(12,600 miles). Each satellite is equipped with an atomic clock and constantly
broadcasts the time, according to its own clock, along with administrative information including the orbital elements of its motion, as determined by ground-based
observatories.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
41
Global Positioning System (GPS)
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. This 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.
AirLink Remote Access Protocol (RAP)
The AirLink Remote Access Protocol (RAP) uses the User Datagram Protocol
(UDP) and is a proprietary binary message format. RAP has been designed to work
specifically with AirLink Tracking System (ATS), but other 3rd party applications
have been developed to take advantage of the RAP messaging format. AirLink
RAP is also referred to as AirLink Binary/ATS.
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.
Trimble ASCII Interface Protocol (TAIP)
Trimble ASCII Interface Protocol (TAIP) is a digital communication interface
based on printable ASCII characters over a serial data link. TAIP was designed specifically for vehicle tracking applications but has become common in a number of
other applications, such as data terminals and portable computers, because of its
ease of use.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
42
Global Positioning System (GPS)
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).
Note: Wireless ACE displays the current time (UTC) set in the
modem and does not translate it to the local time zone. If the
modem is in California and it is 8 a.m., the modem’s time will be
shown as 4 p.m, since UTC is 8 hours “ahead” of Pacific time.
Configuring the PinPoint for GPS
To configure your modem’s GPS settings, you can use either Wireless ACE, direct
serial communication or Telnet to configure the modem using AT commands
(page 83). The configuration examples in this chapter all use Wireless ACE. Most
of the settings are in the menu option: PinPoint.
The main sections below detail how to set up the configuration for RAP (page 46),
RAP special features (page 49), RAP Store and Forward (page 52), NMEA
(page 55), and TAIP (page 60). Most of the PinPoint commands are covered in the
main sections below.
Over-The-Air (Remote) Host
To set the PinPoint to report to an external or remote host, configure *PPIP (ATS
Server IP) and *PPPORT (Server Port). *PPIP will work an NMEA or TAIP
remote host as well as with an ATS remote host.
FIGURE 1.
43
Wireless ACE: *PPIP and *PPPORT
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
Local Host
To set the PinPoint to report to an local host, one directly connected to the PinPinPoint’s serial 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. Specify 0 to 7. If S53=1000 and *PPLATSEXTRA=4, reports will be sent to 1000, 1001, 1002, 1003, and 1004.
FIGURE 3.
Wireless ACE: *PPLATSEXTRA
Report Types
There are several report types available. For remote reports, set *PPGPSR. For
local reports, set *PPLATSR.
FIGURE 4.
Wireless ACE: *PPGPSR and *PPLATSR
0 - *MF, Legacy reports for use with ATS version 4 and older.
11 - Global Positioning System (GPS) data.
12 - GPS data with the UTC time and date.
13 - GPS with time and date and Radio Frequency data from the antenna.
E0 - NMEA GGA and VTG sentences.
E1 - NMEA GGA, RMC, and VTG sentences.
F0 - TAIP data
Cingular PinPoint EDGE or GPRS User Guide version 2.20
44
Global Positioning System (GPS)
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.
Sending Reports Automatically
You can configure the PinPoint to send reports based on a time interval and on the
movement rate of a vehicle (based on it’s position from one time to the next).
FIGURE 5.
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).
If you are sending reports on the local serial port, if you want them sent automatically, you will need to set *PPLATS. The time interval, just as for *PPTIME, is in
seconds.
FIGURE 6.
45
Wireless ACE: Local Automatic Reports
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
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.
Most of the configuration settings for RAP can be changed with the RAP configuration command message. Refer to the AirLink Tracking System User Guide.
RAP Reports Over-The-Air (Remote)
To configure the PinPoint to send RAP reports to a remote server, you will need to
set 3 commands: *PPIP, *PPPORT, and *PPGPSR.
FIGURE 8.
Wireless ACE: RAP Reports Remote
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 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.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
46
Global Positioning System (GPS)
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.
FIGURE 9.
Wireless ACE: *PPIGNOREIP
RAP Reports over a Local Connection (PPP or SLIP)
Local reports are sent to the local IP address of the computer or device connected to
the serial port port of the PinPoint using PPP or SLIP. To configure the modem to
send to the local IP, you will need to set 3 commands: S53, *PPLATS, and
*PPLATSR.
FIGURE 10.
Wireless ACE: RAP Local Reports
1.
Set the port (S53) to the local port to which you want the reports sent. The local
IP will automatically be used. S53, in Wireless ACE, is part of the Misc menu
option.
2.
Set the ATS Local Report Type (*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.
47
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
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.
For reliability, the server expects each command to be acknowledged within a timeout period. If the acknowledgement packet (ACK) is not received within the timeout period, the server will retransmit the command.
The RAP messages are in Hex and are referred to by their message ID.
Commands
0x02 Request a location report from a PinPoint.
0x05 Request the PinPoint configuration.
0x06 Configure the PinPoint.
0x08 Set the PinPoint odometer.
0x09 Request the current PinPoint odometer setting.
0x11 Request a simple GPS report.
0x12 Request a simple GPS report with the date included (the time will be in
UTC).
0x13 Request a simple GPS report with the date and radio frequency information included.
Power Reports
0x10 Power Up Report - Sent by the modem when it is powered up (either as a
result of being power cycled or with a software reset).
0x30 Power Sleep Report - Sent by the modem when it is about to power down
into a low-power state (not supported in some early PinPoint models).
0x31 Power Wakeup Report - Sent by the modem when it is returned to a full
power state from a low-power state (not supported in some early PinPoint models)
Cingular PinPoint EDGE or GPRS User Guide version 2.20
48
Global Positioning System (GPS)
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.
0x20-0x23 indicate the state changes of either the RTS or DTR (See “Serial
Input Event Reports” on page 50) in addition to the same data as in an 0x12
report.
0x24-0x2B indicate the state changes of the COM1000 inputs (See “COM1000
Event Reports” on page 51) in addition to the same data in an 0x12 or 0x13
report.
Note: It is recommended to use Report type 0x12 or 0x13 when
Store and Forward (page 52) is enabled.
Additional RAP Features
RAP allows additional information to be sent with or as the reports to enable a
richer tracking feature set. Configure RAP as you would normally for remote or
local reports (See “RAP Configuration” on page 46).
Device ID
By enabling *PPDEVID, the device ID is sent as part of the RAP message to make
identification easier in a network or fleet of vehicles equipped with PinPoint
modems.
FIGURE 11.
49
Wireless ACE: *PPDEVID
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
Caution: If the PinPoint is using a dynamic IP, *PPDEVID
needs to be enabled.
Generally, the device ID the PinPoint will use is the IP or phone number assigned
by Cingular.
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. The PinPoint odometer is not
connected to the vehicle’s, it is entirely based on calculations of
GPS readings.
Serial Input Event Reports
You can configure the PinPoint to send reports based on the state of the DTR and/or
RTS pins on the serial port. Refer to “Capturing Events via External Inputs
on“page 37 to set up the external devices.
Once the serial port has been connected, you will also need to enable the event
reporting for GPS.
FIGURE 13.
Wireless ACE: Enabling RTS and DTR for Input Events
Cingular PinPoint EDGE or GPRS User Guide version 2.20
50
Global Positioning System (GPS)
If you have connected the physical device to the RTS pin and ground, you will need
to enable RTSI. If you have connected it to the DTR pin and ground, you will need
to enable DTRI. You can have different devices connected to each. If you have
two connected, enable both.
To enable the reports themselves, use *PPINPUTEVT.
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 (page 48).
COM1000 Event Reports
Support for the COM1000 is enable with the register *PPCOM1000=1 (0 = off
[default], 1 = on). Once enabled, ALEOS will receive the UDP packets from a
properly configured COM1000 and add the state of the extra inputs to RAP packets
sent to ATS.
FIGURE 15.
51
Wireless ACE: COM1000 Events
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
The report type will indicate the state of change in the inputs.
Input
Value
Report Type
INPUT 1
LO
0x24
INPUT 1
HI
0x25
INPUT 2
LO
0x26
INPUT 2
HI
0x27
INPUT 3
LO
0x28
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 48).
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.
Wireless ACE: Store and Forward
Once you have enabled SnF, *PPSNF, you can determine how you want the messages sent using *PPSNFB, Store and Forward Mode:
Normal - Each report is sent immediately.
Polled - Reports held until requested by the server.
Grouped - Reports held until total is equal or greater than *PPSNFM which
sets the packet size of grouped reports.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
52
Global Positioning System (GPS)
Store and Forward Reliable Mode
The Store and Forward Reliable Mode is also referred to as Reliable ATS (RATS).
RATS allows the PinPoint 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).
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.
If the PinPoint doesn’t receive acknowledgement for a “window”, the modem will
PING the server with a message containing the sequence numbers of the first and
last packets that haven’t been acknowledged. The PinPoint will continue until the
server acknowledges receipt. When the PinPoint receives the acknowledgement, it
will advance its “window” to the next group.
When PinPoint is first powered on (or reset), it will send a Set Window message to
sync up with the server for the current “window”.
On the other side, if the server receives and out of sequence packet, it will send a
message to the modem noting the missing sequence and the PinPoint will retransmit.
GPS Time, Latitude, and Longitude can be added, *UDPRGPS, to the packet
sequence data for RATS.
Wireless ACE: Adding GPS Time, Latitude, and Longitude to
Reliable UDP data
FIGURE 18.
53
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
Sending Reports
You can configure thePinPoint to send reports based on a time interval and on the
movement rate of a vehicle (based on it’s position from one time to the next).
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).
Flush on Event
If you have events enabled, with *PPFLUSHONEVT, you can configure the PinPoint to flush the SnF buffer when an event occurs. This will drop all outstanding
packets and not transmit or retransmit them.
FIGURE 20.
Wireless ACE: Store and Forward Flush on Event
Note: Outstanding packets can include messages already sent to
the server that haven’t been acknowledged (SnF Reliable Mode)
whether they have been received by the server or not.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
54
Global Positioning System (GPS)
Legacy ATS/RAP
If your ATS server is running ATS version 4 or older, then you will need to configure the PinPoint to send an earlier version of RAP. If you want to send the legacy
message to a remote server, you will need to configure *PPGPSR to *MF. If you
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.
Wireless ACE: Legacy format
8A - Transmit Latitude, Longitude, and Time
8E - Transmit Latitude, Longitude, Direction, Velocity and Time
8F - Transmit Latitude, Longitude, Direction, Velocity, Time, and GPS satellite
quality
NMEA Configuration
The PinPoint transmits standard NMEA GPS messages as well as the proprietary
RAP format.
55
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
Streaming NMEA Messages over the local serial port
The PinPoint can be configured to send standard NMEA messages (sentences) in
ASCII over the serial port without a PPP or SLIP connection from the local computer. The PinPoint must be in AT mode.
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.
You can also issue this command using Wireless ACE to stream the data from the
serial port without using HyperTerminal or and other terminal application. The
data will stream even after the modem is reset.
FIGURE 24.
Wireless ACE: NMEA Strings
Cingular PinPoint EDGE or GPRS User Guide version 2.20
56
Global Positioning System (GPS)
NMEA Messages Over-The-Air (Remote) T
To configure the PinPoint to send NMEA reports to a remote server, you will need
to set 3 commands: *PPIP, *PPPORT, and *PPGPSR.
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.
NMEA Messages over a Local Connection (PPP or SLIP)
Local reports are sent to the local IP address of the computer or device connected to
the serial port of the PinPoint using PPP or SLIP. To configure the modem to send
to the local IP, you will need to set 3 commands: *S53, *PPLATS, and *PPLATSR.
FIGURE 26.
Wireless ACE: NMEA Local Reports
1.
Set the port (S53) to the local port to which you want the reports sent. The local
IP will automatically be used. S53, in Wireless ACE, is part of the Misc menu
option.
2.
Set the ATS Local Report Type (*PPLATSR) to your preferred NMEA sentence
format.
E0 - Output the GGA and VTG sentences.
57
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
E1 - Output the GGA, RMC, and VTG sentences.
3.
Set Local ATS Reporting Time Interval (*PPLATS) to the number of seconds
you want as an interval between reports being sent.
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. GGA
- Global Positioning System Fix Data
Description
Field Contents
Global Positioning System (GPS)
GP
Global Positioning System Fix Data
GGA
UTC (Fix taken at 17:32:21 UTC)
173221.428
Latitude
428,3505.1435
North or South
N
Longitude
08037.5669
East or West
W
Fix Quality
1
(0=invalid, 1=GPS fix, 2=DGPS fix)
Number of satellites being tracked
04
Horizontal dilution of precision (metres)
2.2
Antenna altitude above/below mean-sea-level (geoid)
242.9
Units of antenna altitude, meters
M
Geoidal separation, the difference between the WGS84 earth ellipsoid and mean-sea-level (geoid)
46.9
"-" means mean-sea-level below ellipsoid
Units of geoidal separation, meters
M
(not applicable to the PinPoint)
null field
Cingular PinPoint EDGE or GPRS User Guide version 2.20
58
Global Positioning System (GPS)
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. RMC
- Recommended Minimum Navigation Information
Description
Field Contents
Global Positioning System (GPS)
GP
Recommended Minimum sentence C Phase
RMC
UTC (Fix taken at 17:32:19 UTC)
173219.428
Status A=Active or V=Void
A
(A status of V indicated the GPS has a fix that is below
an internal quality threshold, i.e. dilution of precision
is too high or an elevation mask test failed)
59
Latitude
428,3505.1435
North or South
N
Longitude
08037.5669
East or West
W
Speed over ground, knots
0.09
Track angle in degrees True
13.55
Date (04th of April 2005)
040405
Magnetic Variation, degrees
null field
East or West
null field
Checksum
*2E
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
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.3 and later)
null field
Checksum
*62
TAIP Emulation Configuration
The TAIP emulation functionality allows the PinPoint 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 AirLink Binary/ATS formatted
messages.
TAIP Messages Over-the-Air (Remote)
To configure the PinPoint to send TAIP reports to a remote server, you will need to
set 3 commands: *PPIP, *PPPORT, and *PPGPSR.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
60
Global Positioning System (GPS)
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).
TAIP Messages over a Local Connection (PPP or SLIP)
Some TAIP client applications can send TAIP requests and listen for reports using a
local connection. Generally this is done over the serial port using PPP or SLIP. To
configure this option, you will need to set four commands: *PPIP, S53, *PPGPSR,
and *PPLATS.
FIGURE 28.
61
Wireless ACE: TAIP Local Reports
1.
Set the IP (*PPIP) to the local IP of the PinPoint.
2.
Set the port (S53) to 21000. The local IP will automatically be used. S53, in
Wireless ACE, is part of the Misc menu option.
3.
Set GPS Report Type (*PPGSPR) to F0 - TAIP Data.
4.
Set the Local ATS Reporting Time Interval (*PPLATS) to 0 to disable unsolicited local reports.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
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.
Sending Unsolicited TAIP Messages over a Local Connection
Standard TAIP requires a request before GPS reports are sent. The PinPoint, 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.
This configuration sends TAIP GPS reports to whatever address and UDP Port you
select. You will need to set 3 commands: S53, *PPLATS, and *PPLATSR.
FIGURE 29.
Wireless ACE: TAIP Local Reports, Unsolicited
1.
Set the port (S53) to 1000. The local IP will automatically be used. S53, in
Wireless ACE, is part of the Misc menu option.
2.
Set ATS Local Report Type (*PPLATSR) to F0 - TAIP Data.
3.
Set the Local ATS Reporting Time Interval (*PPLATS) to 5 to send reports
every 5 seconds (can be adjusted as circumstances warrant).
Using TAIP Command Emulation
To configure the PinPoint to use TAIP emulation set GPS Report Type (*PPGSPR)
to F0 - TAIP Data.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
62
Global Positioning System (GPS)
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.
Wireless ACE: TAIP ID
Supported TAIP Commands
The TAIP emulation will accept the following TAIP message types:
SRM allows the client to set the reporting mode configuration. The report mode
configuration is not stored in non-volatile memory and such should be reset
upon a unit reset. This behavior emulates that specified in TAIP specifications.
QRM reports the reporting mode configuration (returns an "RRM" message).
SID allows the client to set the TAIP ID (AT*PPTAIPID can also be used to set
the TAIP ID). The TAIP ID, when set with a "SID" message, will be written to
non-volatile memory.
QID reports the TAIP ID (returns an "RID" message).
DPV configures automatic reporting of PV (Position/Velocity) reports based on
distance traveled and a maximum time. The delta distance value specified in the
message is converted to hundreds of meters and stored as *PPDIST. The maximum time interval is stored as *PPTIME. Currently the minimum time and
epoch values are ignored.
63
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Global Positioning System (GPS)
FPV configures periodic reporting of PV (Position/Velocity) reports. The time
interval from the message is stored at *PPTIME. Currently the epoch value is
ignored.
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.
Examples of TAIP messages:
>RPV19277+3508570-0806260100002632;*75<
>RPV19282+3508571-0806260100000432;*7E<
>RPV19292+3508573-0806260300013832;*71<
>RPV19297+3508573-0806260400013432;*7F<
Cingular PinPoint EDGE or GPRS User Guide version 2.20
64
Global Positioning System (GPS)
TABLE 4. Elements
of a TAIP message
Elements
Begin Message:
>RVP
Seconds into the day (5 Bytes):
19277
Latitude in Degrees (8 Bytes):
+3508570
Longitude in Degrees (9 Bytes):
08062601
Speed in MPH (3 Bytes):
000
Heading in Degrees (3 Bytes):
026
Source of Data (1 Byte):
3
Age of Data (1 Byte):
2
Check Sum:
End Message:
65
command portion
Partie de commande
;*75
<
Cingular PinPoint EDGE or GPRS User Guide version 2.20
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. The
SNMP management system is generally composed of agents (such as your PinPoint, a router, a UPS, a web server, a file server, or other computer equipment) and
a Network Management Station (NMS) which monitors all the agents on a specific
network. Using the management information base (MIB), an NMS can include
reporting, network topology mapping, tools to allow traffic monitoring and trend
analysis, and device monitoring.
Authentication ensures SNMP messages coming from the agent, such as the PinPoint, 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, message encryption. USM uses a user name and password specific to each
device.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
66
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.
SNMP Traps
The trap is a “snap-shot” of the settings and status of the Agent’s device which is
sent as a report to the NMS in a form that can be parsed and stored in the MIB. See
below (page 70) for an example of the trap from an AirLink modem.
PinPoint SNMP Configuration
To configure your PinPoint to work as an SNMP agent, you can use either Wireless
ACE, direct serial communication or Telnet to configure the modem using AT commands (page 63). In Wireless ACE, the SNMP commands are all on the Other
menu option.
There are only three commands to set for SNMP in the PinPoint: the listening port,
the security level, and the trap destination.
Listening Port
*SNMPPORT sets the port for the SNMP agent to listen on. If set to zero, default,
SNMP is disabled.
FIGURE 1.
Wireless ACE: *SNMPPORT
Note: SNMP generally uses port 161, however most Internet pro-
viders (including cellular) block all ports below 1024 as a security measure. You should be able to use higher numbered port
such as 10161.
67
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Simple Network Management Protocol (SNMP)
Security Level
*SNMPSECLVL sets the security level and which version of SNMP communications are used.
FIGURE 2.
Wireless ACE: *SNMPSECLVL
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. SNMPv3 is required
to do authentication. SNMPv2c and SNMPv3 authNoPriv transmissions will be
silently discarded. Authentication and encryption is equivalent to the authPriv
setting in SNMPv3.
User Name and Password
The user name is 'user'. The user name cannot be changed.
The PinPoint's password is used as the SNMP password (default is '12345').
Note: The eight-character password requirement for SMNPv3 is
not enforced by the PinPoint's Agent to allow the default password to function. Your SNMP administrator or MIS may require
you to change to a more secure and/or longer password.
To change the password in the PinPoint, select Modem from the top menu line in
Wireless ACE.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
68
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”.
69
Cingular PinPoint EDGE or GPRS User Guide version 2.20
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.
Example of the MIB trap
AIRLINK-MIB DEFINITIONS ::= BEGIN
IMPORTS
ObjectNameFROM SNMPv2-SMI
MODULE-COMPLIANCEFROM SNMPv2-CONF;
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 }
Cingular PinPoint EDGE or GPRS User Guide version 2.20
70
Simple Network Management Protocol (SNMP)
status OBJECT IDENTIFIER ::= { airlink 3 }
gps OBJECT IDENTIFIER ::= { airlink 4 }
-- GENERAL -phoneNumber OBJECT-TYPE
SYNTAX DisplayString (SIZE (10))
MAX-ACCESS read-only
STATUS current
::= { general 1 }
deviceID OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
::= { general 2 }
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 }
71
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Simple Network Management Protocol (SNMP)
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 }
modemSWVer OBJECT-TYPE
SYNTAX DisplayString
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
Cingular PinPoint EDGE or GPRS User Guide version 2.20
72
Simple Network Management Protocol (SNMP)
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..65535)
MAX-ACCESS read-only
STATUS current
::= { common 3 }
netUID OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
::= { common 4 }
netPW OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
::= { common 5 }
73
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Simple Network Management Protocol (SNMP)
requestPAP OBJECT-TYPE
SYNTAX INTEGER {
no(0),
yes(1) }
MAX-ACCESS read-only
STATUS current
::= { common 6 }
destinationAddress OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
::= { common 7 }
destinationPort OBJECT-TYPE
SYNTAX INTEGER(0..65535)
MAX-ACCESS read-only
STATUS current
::= { common 8 }
serialPortSettings OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
::= { common 9 }
serialPortFlowControl OBJECT-TYPE
Cingular PinPoint EDGE or GPRS User Guide version 2.20
74
Simple Network Management Protocol (SNMP)
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
SYNTAX INTEGER
MAX-ACCESS read-only
STATUS current
::= { status 3 }
rssi OBJECT-TYPE
75
Cingular PinPoint EDGE or GPRS User Guide version 2.20
Simple Network Management Protocol (SNMP)
SYNTAX INTEGER(-125..-50)
MAX-ACCESS read-only
STATUS current
::= { status 4 }
serialSent OBJECT-TYPE
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 }
Cingular PinPoint EDGE or GPRS User Guide version 2.20
76
Simple Network Management Protocol (SNMP)
fixObtained OBJECT-TYPE
SYNTAX INTEGER {
no(0),
yes(1) }
MAX-ACCESS read-only
STATUS current
::= { gps 1 }
satelliteCount OBJECT-TYPE
SYNTAX INTEGER
MAX-ACCESS read-only
STATUS current
::= { gps 2 }
latitude OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
::= { gps 3 }
longitude OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
::= { gps 4 }
END
77
Cingular PinPoint EDGE or GPRS User Guide version 2.20
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.
Possible locations for your PinPoint installed in a vehicle are in a trunk
away from where luggage or other items won’t be likely to dislodge it,
under or in the console, or behind seats. Ensure the location is secure
both against abrupt movements of the vehicle and from other items
coming into contact with the modem.PinPoint Mounting Kit
An optional accessory for your modem is a mounting kit. The bracket is designed
to snugly cradle the modem and hold it in place where you need it.
The PinPoint “snaps” into place in the bracket locking into the grooves on the PinPoint case. The bracket can be further secured with a twist-tie set into the grooves
on the top for situations where the modem may be subjected to violent movement,
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.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
78
Hardware Installation
The bracket can be attached to the location using #6 screws (mounting hole diameter approximately 0.150").
FIGURE 1.
PinPoint Mounting Bracket, part number 100-170-1005
Cingular PinPoint EDGE or GPRS User Guide version 2.20
79
Hardware Installation
Connecting the Antenna
Your PinPoint will work with most standard cellular antennas with a TNC connector and rated to work with EDGE or GPRS technology. Connect the antenna or first
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.
PinPoint connecters
GPS
Cellular
Connecting power
Your PinPoint can be used with either DC (available in most automobiles) or 110
AC (standard US wall power) with the appropriate power adapter (available from
AirLink).
The power cable positive lead should be connected to the battery or power source
positive terminal. The power cable negative lead should be connected to the battery
or power source negative terminal. The PinPoint has an internal polysilicon circuit
breaker that opens at 0.5 to 1.0 amps of current.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
80
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. PinPoint
Your PinPoint can also be connected to a USB to serial device connected to a computer or other device which does not have an available serial port but does have
USB.
81
Cingular PinPoint EDGE or GPRS User Guide version 2.20
CHAPTER 12
PinPoint: AT Commands
Just as with a Hayes compatible analog modem, the PinPoint parameters can all be
configured with AT commands.
Using Wireless Ace
Wireless ACE and Wireless ACE Web (page 10) 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, see
below, can be used instead.
With Wireless ACE and Wireless ACE Web, you only need to find the command
listed and then enter the new value in the space provided. For those commands
which have specific parameters, the choices will be in a drop down menu.
FIGURE 1.
Wireless ACE: Using AT Commands
Cingular PinPoint EDGE or GPRS User Guide version 2.20
82
PinPoint: 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 3G or Wireless ACE Web, please
refer to the Wireless ACE 3G or Web User Guide.
Note: Some of the AT Commands are not able to be configured
in Wireless ACE 3G or Web.
Using Telnet Terminal Emulation
It is possible to communicate with the PinPoint across a TCP/IP network. Telnet
provides a terminal style connection to the PinPoint.
Most installations of Microsoft Windows come with a version of HyperTerminal.
Start>All Programs>Accessories>Communications>HyperTerminal
1.
83
Choose a name for your connection, such as PinPoint or AirLink. The name
and icon are only for your own reference so you can find the connection at a
later date (if you want to have a connection saved for both local and remote, it is
recommended the connection name reflect the connection type, i.e. PinPoint
Remote).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
FIGURE 3.
2.
Select TCP/IP (Winsock) for Connect Using. Then, if the modem is connected
directly to your computer’s Ethernet port, put in the host address of
192.168.13.31 or the *HOSTIP. 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: 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”.
FIGURE 5.
4.
HyperTerminal: Connection Name
HyperTerminal: AT mode via Telnet
Type AT and press Enter. You should get a reply of “OK” or “0”.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
84
PinPoint: AT Commands
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.
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.
Direct Serial Connection
Using HyperTerminal included with most installations of Microsoft Windows:
Start>All Programs>Accessories>Communications>HyperTerminal
1.
Choose a name for your connection, such as PinPoint or AirLink (if you want
to have a connection saved for both local and remote, it is recommended the
connection name reflect the connection type, i.e. PinPoint local). The name and
icon are only for your own reference so you can find the connection at a later
date.
FIGURE 6.
2.
Select COM1 for the Connect Using.
FIGURE 7.
3.
85
HyperTerminal: Connection Name
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.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
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. If you
get a reply of “0” or “ERROR”, try entering the command again.
AT Commands
The tables below list the AT commands, their parameters, and explain what they do.
• For most commands, you need to preface the command with AT (exceptions are
noted), i.e. ATA which listed as A
• Some commands have specific parameters while other commands will take
whatever your type.
• 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
(for example, AT&D? will respond with “2” if the default has not been
changed).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
86
PinPoint: AT Commands
• AT Commands are not case sensitive. A capital “E” is the same as a lower-case
“e”.
• If you enter a command which is recognized by the PinPoint, it will respond
with “OK”. If the command is not recognized, the response will be “ERROR”.
• Those commands applicable only to certain model numbers of the PinPoint will
be noted in the command column.
Caution: Symbols listed with commands, such as *, /, &, or ?,
are part of the command and must be included.
Attention : Les symboles comme *, /, &, or ? font partie des
commandes décrites et ne doivent pas être omis.
Most of the Commands in the “Information and Status” table, only, do not have any
parameters. They only provide information. These commands are repeated elsewhere in their respective categories as well.
TABLE 1. Information
and Status
Command
Details
I[n]
n=0 Product name (for example, PinPoint).
n=1 The PinPoint’s firmware (ALEOS) version, hardware
ID, and copyright.
n=2 The internal hardware's firmware version and relevant
hardware ID.
n=3 The hardware module's unique ID (ESN).
n=5 View active profile (the contents of the active registers).
87
&V
View active profile (the contents of the active registers).
*HOSTMODE?
The current host mode (AT, PPP, UDP, etc.). If the PinPoint is not in AT mode, telnet into the modem to execute
this command.
*NETCHAN?
The current active EDGE or GPRS channel number.
*NETERR?
The EDGE or GPRS network bit error rate.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: 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 .
*NETOK
Checks the EDGE or GPRS network connection.
OK if connected.
ERROR if not connected.
*NETOP?
The current cellular carrier (for example, Cingular) from
the modem's firmware version.
*NETPHONE?
The modem's phone number (if applicable or obtainable).
*NETRSSI?
The current RSSI (Receive Signal Strength Indicator) of
the PinPoint as a negative dBm value.
The same information is displayed with the command
S202?.
*NETSTATE?
The current network state:
Connecting To Network = The PinPoint is in the process
of trying to connect to the EDGE or GPRS network.
Network Authentication Fail = Authentication to the
EDGE or GPRS network has failed. Verify settings to activate the PinPoint.
Network Negotiation Fail = Network connection negotiation failed. This is usually temporary and often clears up
during a subsequent attempt.
Network Ready = PinPoint is connected to the EDGE or
GPRS network and ready to send data.
Network Dormant = PinPoint is connected to the EDGE
or GPRS network, but the link is dormant. It will be woken
up when data is sent or received.
No Service = There is no EDGE or GPRS network
detected.
Hardware Reset = The hardware module is being reset.
This is a temporary state.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
88
PinPoint: 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.
Low Final - Power down is imminent.
Low - Power is down.
*SMTPSTATUS?
The status of the last issued SMTP message
(*SMTPSEND). If no status is available 0 is returned.
Once read, the status is cleared.
The status codes are received from the SMTP server the
modem attempted to send the request. Example: 354 =
send in progress, 250 = sent ok.
*SNTPQUERY?
The current SNTP (Simple Network Time Protocol) time
and date.
The preferred method of activating (provisioning) the modem is using the Setup
Wizard. However, there are special circumstances when commands may be used
instead.
Caution: You may need go into PassThru mode to activate the
PinPoint. In that case, you will need to refer to the PassThru
Mode table (page 99) and the Commands Usable with PassThru
table (page 117).
89
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 2. Activation
Command
(Provisioning)
Parameters
Details
OPRG=n
Enables/disables over-the-air firmware upgrading of the
PinPoint.
n=0
Disables over-the-air programming.
n=1
Enables over-the-air programming.
*DEVICEID=n
n=number string
Sets or queries the 64-bit Device ID that is used by the
modem to identify itself to the server. The default is a
value that depends on the underlying communications
technology being used.
*NETAPN=apn
apn=access
Easy entry of the APN.
If left blank, the modem will attempt to use the default
subscriber value as defined by the account.
*NETPHONE?
none Aucun
The modem's phone number, if applicable or obtainable.
*NETPW=pw
pw=password
The password that is used to login to Cingular’s cellular network, when required.
*NETUID=uid
uid=user id (up
to 64 bytes)
The login that is used to login to the Cingular’s cellular
network, when required.
The PinPoint’s cellular network is the connection to EDGE or GPRS and remote
devices or computers.
TABLE 3. Cellular
Command
Network (Cingular’s EDGE or GPRS)
Parameters
Details
*NETALLOWZEROIP=n
Allows the displayed IP address in *NETIP to end in
zero (ex. 192.168.1.0). Do not allow
n=0
Allow
n=1
*NETCHAN?
none
The current active EDGE or GPRS channel number.
*NETERR?
none
The EDGE or GPRS network bit error rate.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
90
PinPoint: AT Commands
TABLE 3. Cellular
Network (Cingular’s EDGE or GPRS)
Command
Parameters
Details
*NETIP?
none
The current IP address of the modem reported by the
embedded hardware 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.
Refer to *NETALLOWZEROIP if you need to allow
the display of an IP ending in a zero.
*NETOK?
none
Checks the EDGE or GPRS connection.
OK if connected.
ERROR if not connected.
*NETOP?
none
The current cellular carrier (i.e. Cingular) from the
modem's firmware version.
*NETRSSI?
none
The current RSSI (Receive Signal Strength Indicator) of
the PinPoint as a negative dBm value. The same information is displayed with the command S202?.
*NETSTATE?
none
See *NETSTATE?.
*NETWDOG=n
n=minutes
Network connection watchdog: The number of minutes
to wait for a network connection. If no connection is
established within the set number of minutes, the PinPoint resets.
Default = 20 min. 0 = Disable.
+COPS=mode,[format]
[,oper]
Manually specify an operator.
mode=0
Automatic - any affiliated carrier [default].
mode=1
Manual - use only the operator <oper> specified.
mode=4
Manual/Automatic - if manual selection fails, goes to
automatic mode.
format=0
Alphanumeric ("name") (G3310 must use this format).
format=2
Numeric
oper=”name”
oper uses the format specified in the format parameter.
Refer also to *NETOP.
The Local network for the PinPoint is the one to which it is connected physically
via the serial port to your computer, device, hub, or switch. The PinPoint has the
91
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
ability to provide some NAT (network address translation) to pass communication
from the EDGE or GPRS network and the Internet to the local device(s) and network. On the local network, the PinPoint acts as a Host.
TABLE 4. Local
Network and Host Modes
Command
Parameters
Details
+++
none
AT Escape sequence.
If the PinPoint is in a data mode (any mode other than
PassThru), this command causes the modem to re-enter
AT command mode.
The "+" is ASCII 0x2B.
This command is not proceeded by AT.
Note: There must be an idle time (set by S50) on the
serial port before and after this command.
+++
The detection of +++ is disabled if DAE=1.
AIP=n
n=0
n=1
Allow only the IP specified in S53 to connect when UDP
auto answer is enabled (S82=2).
Allow any incoming IP to connect when UDP auto
answer is enabled (S82=2).
Always subject to any Friends filters () that may be
defined. Toujours soumis à des filtres pouvant être définis dans le mode Friends
HOR=n
Half-Open Response - In UDP auto answer (half-open)
mode:
n=0
No response codes when UDP session is initiated.
n=1
RING CONNECT response codes sent out serial link
before the data from the first UDP packet.
Note: Quiet Mode must be Off.
MDhh
hh (hex byte) =
Default power-up mode.
00 - normal
mode
When the PinPoint is power-cycled, it may enter the
mode specified by this command after 5 seconds. On
startup, typing ATMD0 within 5 seconds changes the
mode to normal (AT command) mode.
01 - SLIPmode
02 - PPPmode
03 - UDP mode
See also S53 to set the port for UDP or TCP.
04 - TCP mode
07 - PassThru
mode
Cingular PinPoint EDGE or GPRS User Guide version 2.20
92
PinPoint: AT Commands
TABLE 4. 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.
A "CONNECT" sent to the host indicates acknowledgement of the connection request and the TCP session is
established.
n=0
Off (Default)
n=1
On
n=2
Use Telnet server mode on TCP connections.
n=3
With a Telnet connection, overrides the client's default
echo, allowing the server on the host port to perform the
echo. CRLF sequences from the telnet client will also be
edited to simply pass CRs to the server on the host port.
S7=n
n = seconds
Specifies the number of seconds to wait for a TCP connection to be established when dialing out.
S23=[speed],[databits]
[parity][stop bits]
speed =
Serial line parameters. The settings take affect after
reset.
300 | 1200 |
2400 | 4800 |
9600 | 19200 |
38400 | 57600 |
115200 | 230400
databits = 7 or 8
parity =
Ex. ATS23=19200,8N1 (sets modem to 19200, etc.)
Note: Databits MUST be 8 data bits for PPP mode.
Can also be set using &L=[speed],[databits] [parity][stop bits]
O=Odd
E=Even
N=None
M=Mark
stopbits =
1 | 1.5 | 2
S50=n
n = tenths of
seconds
Data forwarding idle time-out. If set to 0, a forwarding
time-out of 10ms is used.
(Used in UDP or TCP PAD mode)
93
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 4. 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. While a session is
active, packets from other IPs will be discarded (unless
*UALL is set).
n=0
n=1-255
S211=n
No idle time-out (Default).
Time-out in seconds.
For applications or situations where hardware control of
the DTR signal is not possible, the modem can be configured to ignore DTR. When Ignore DTR is enabled,
the modem operates as if the DTR signal is always
asserted.
n=0
Use hardware DTR. (default).
Ignore DTR.
n=1
n=3
S221=n
n = 0 - 255
Ignore DTR and assert DSR. This value is deprecated,
and it is recommended to use &S to control the DSR
instead. When this value is set to 3, &S will automatically be set to 0. See also: &D and &S.
Connect Delay
Number of seconds to delay the "CONNECT' response
upon establishing a TCP connection.
OR
Number of tenths of seconds to delay before outputting
ENQ on the serial port after the CONNECT when the
ENQ feature is enabled (see *ENQ).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
94
PinPoint: AT Commands
TABLE 4. Local
Network and Host Modes
Command
Parameters
Details
TCPS=n
n = minutes
(TCPS=0) or
seconds
(TCPS=1)
TCP connection time-out (TCPS) units. Specifies a time
interval upon which if there is no in or outbound traffic
through a TCP connection, the connection will be terminated.
TCPT=n
n = minutes
(TCPT=0) or
seconds
(TCPT=1)
TCP connection time-out (TCPT) units. 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.
&Cn
Set DCD mode.
n=0
Always assert DCD.
n=1
Assert DCD when in a data mode (UDP, TCP, PPP, or
SLIP) (Default).
n=2
Assert DCD when the modem has network coverage.
&Dn
Set DTR mode.
n=0
Ignore DTR, same effect as HW DTR always asserted
(same as S211=1).
n=2
Use hardware DTR (same as S211=0).
&Sn
Set DSR mode.
n=0
Always assert DSR.
n=1
Assert DSR when in a data mode (UDP, TCP, PPP, or
SLIP) (Default).
n=2
Assert DSR when the modem has network coverage.
Note: S211 can also be used to request that DSR is
always asserted. If S211 is set to 3 and &S is changed to
a non-zero value, S211 will be changed to 1.
95
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 4. 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.
*DU=n
The dial command always uses UDP, even when using
ATDT.
n=0
Dial using the means specified (default).
n=1
Dial UDP always, even when using ATDT.
Note: When this parameter is set you cannot establish a
TCP PAD connection.
*ENQ=n
Outputs an ENQ [0x05] after the TCP CONNECT
delayed by the Delay Connect Response time (S221).
n=0
Disabled (Default).
n=1
Enables ENQ on CONNECT.
*HOSTMODE?
none
The current host mode (AT, PPP, UDP, etc.) which the
modem is in. If the modem is not in AT mode, telnet into
the modem to execute this command.
*HOSTNETMASK=n.n.n.n
n.n.n.n = subnet
mask, example
255.255.255.0
Netmask for the host interface. Allows communication
with a subnet behind the host interface.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
96
PinPoint: AT Commands
TABLE 4. Local
Command
Network and Host Modes
Parameters
Details
*HOSTPAP=n
Use PAP to request the user login and password during
PPP negotiation on the host connection.
n=0
Disable PAP request (Default).
n=1
Takes user login and password from Windows DUN
connection and copies to *NETUID and *NETPW.
*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. PPP
*HOSTPRIVIP =d.d.d.d
d.d.d.d=IP
Set or query the private IP address that is to be negotiated by the PPP connection if *HOSTPRIVMODE =1.
PPP
*HOSTPRIVMODE =n
Set or query whether a private or public (network) IP is
to be used when the Host initiates a PPP connection to
the modem. PPP
n=0
n=1
*MODEMHISPEED=n
97
Public (network) IP Mode: When the Host initiates a
PPP connection, the host will be given the public IP that
was obtained from the OEM module. If the network
issues a new IP, the PPP connection will be closed (since
the IP has changed) and has to be re-initiated. (default).
PPPPPP
Private IP Mode: When the Host initiates a PPP connection, the host will be given the IP address specified in
*HOSTPRIVIP. The modem will then perform NATlike address translation, which shields the Host from network IP changes. PPP
Set the internal serial link speed to the radio (modem)
module.
n=0
115200 (default)
n=1
230400
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 4. Local
Command
Network and Host Modes
Parameters
Details
*UALL=n
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).
n=1
Accept UDP data from all IP addresses when in a UDP
session.
*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.
If the modem is reset, the original S53 setting will be
restored from NVRAM.
*USD=n
Waits the specified delay before sending the first UDP
packet and the subsequent UDP packets out to the serial
port.
n=0
n=1-255
\Qn
No UDP packet delay (Default).
Delay in 100ms units, from 100 ms to 25.5 sec.
Set or query the serial port flow control setting.
n=0
No flow control is being used.
n=2
RTS/CTS hardware flow control is being used.
n=4
Transparent software flow control. Uses escaped XON
and XOFF for flow control. XON and XOFF characters
in data stream are escaped with the @ character (0x40).
@ in data is sent as @@.
\APPP
none
Set modem operation to PPP mode.
\ASLIP
none
Set modem operation to SLIP mode. DTR must be
asserted (&D0 or S211=1).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
98
PinPoint: AT Commands
PassThru Mode is used to communicate directly to the PinPoint’s internal hardware
(OEM module).
TABLE 5. 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 hardware module and output any characters
from the internal hardware module out the serial port.
This allows direct access/configuration of the hardware
module. Once this mode is entered, the unit must be
physically reset to return to normal operation.
Note: This mode is not
available through the remote
AT telnet server.
Note: It may take up to 30 seconds for the hardware
module to respond after CONNECT is output.
*CSX1=n
n=0
Data will be passed to the host.
n=1
PASSTHRU mode will echo all host received data and
will not pass the data to the modem while the modem is
not asserting DCD.
Note: If the modem is asserting DCD, data will be
passed from the host to the modem as it normally is
when *CSX1=0.
*PTINIT=n
n=AT command
Any AT Command string to be passed to the OEM module before entering PASSTHRU mode, e.g. AT&S1V1,
etc.
*PTREFRESH=n
n=0-255 minutes
Number of minutes of inactivity in PASSTHRU mode to
resend the *PTINIT string to the hardware module.
0 = Disabled
*RESETPERIOD=n
n=0-255 hours
In PASSTHRU mode, modem will be reset after this
period if no data has been sent or received. . Value is in
hours.
0 = Disabled
It is possible to communicate with the PinPoint across a TCP/IP network. Telnet
provides a terminal style connection to the PinPoint.
Caution: Telnet is not a secure communications protocol.
99
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 6. Telnet
Command
Parameters
Details
S60=n
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.
By default, this value is set to close the AT telnet connection if no data is received for 2 minutes.
*TPORT=p
p=0-65535
Sets or queries the port used for the AT Telnet server. If 0
is specified, the AT Telnet server will be disabled. The
default value is 2332.
Friends Mode can limit access to the PinPoint from the Carrier network and the
Internet. Friends Mode is a limited form of security.
TABLE 7. Friends
Command
Mode
Parameters
Details
FM=[n]
Fn=[d.d.d.d]
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.d = IP
address
Example: 166.129.2.255 allows access by all IPs in the
range 166.129.2.0-166.129.2.255.
255 = allow any number 0-255
Note: ATF? will return a list of all the current Fn settings.
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 Inter-
Cingular PinPoint EDGE or GPRS User Guide version 2.20
100
PinPoint: AT Commands
net time server (such as time.nist.gov) using SNTP (Simple Network Time Protocol).
TABLE 8. Time
and Date
Command
Parameters
Details
*DATE=[mm/dd/
yyyy],[hh:mm:ss]
mm/dd/yyyy =
Sets and queries the clock in the unit. 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 24hour notation.
month, day, year
hh:mm:ss =
time in 24-hour
notation
*SNTP=n
Note: The GPS will be used to set the time, in which
case any date/time specified will be ignored.
Enables daily SNTP update of the system time.
*SNTPADDR=
[d.d.d.d][name]
n=0
Off
n=1
On
d.d.d.d=IP
name=domain
name
*SNTPQUERY?
none
SNTP Server IP address, or fully-qualified domain
name, to use if *SNTP=1.
Note: If blank, time.nist.gov is used.
The current SNTP time and date.
The PinPoint allows several different levels of logging.
TABLE 9. Logging
Command
Parameters
Details
*DBGCOM1000=n
Turn on debugging for COM1000.
n=0
No logging
n=1
Logging
*DBGCOMLVL=n
*DBGEVTLOGCLEAR
101
Set the logging level for the host or module COM port.
none
n=0
No logging
n=1
Host COM
n=2
Module COM
Clears the content of the logs in the modem.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 9. Logging
Command
Parameters
Details
*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
n=1-3
No logging
Enables logging at different levels of detail. (default =
1).
DNS settings in the PinPoint allow the modem to use domain names instead of IPs
to contact other Internet hosts.
TABLE 10. DNS
Command
Parameters
Details
*DNSn=d.d.d.d
n=1 or 2
Sets the DNS addresses to be returned during PPP negotiation. If the underlying communications network provides DNS addresses, they replace those specified by
this command.
d.d.d.d = IP of
domain server
You can only set *DNS1 and *DNS2.
*DNSUPDATE=n
*DNSUSER=d.d.d.d
Indicates whether the modem should send DNS updates
to the DNS server specified by *DNSUSER. These
updates are as per RFC2136. They are not secure and are
recommended only for a private network. In a public
network, the IP Logger services should be used instead.
n=0
DNS updates disabled (Default).
n=1
DNS updates enabled.
d.d.d.d = IP of
domain server
Sets a user-provided DNS to query first when performing name resolutions in the modem.
IP Manager (page 19) 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.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
102
PinPoint: AT Commands
TABLE 11. IP
Manager
Command
Parameters
Details
*DOMAIN=[name]
name = domain
name (i.e. eairlink.com)
Domain (or domain zone) of which the PinPoint is a
part. This value is used during name resolutions if a fully
qualified name is not provided and also for DNS
updates. This value can be up to 20 characters long.
If *DOMAIN=eairlink.com, then when
[email protected] is entered, the fully qualified name
remote1.eairlink.com will be used to perform a DNS
query to resolve the name to an IP address.
Note: Only letters, numbers, hyphens, and periods can
be used.
*IPMANAGERn=[name]
n= 1 or 2
name = domain
name
*IPMGRKEYn=[key]
n= 1 or 2
key = 128-bit
key in hexadecimal [32 hex
characters]
*IPMGRUPDATEn=m
n= 1 or 2
m=5-255
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 (i.e.
"AT*IPMANAGER1=").
Sets the 128-bit key to use to authenticate the IP update
notifications. If the key's value is all zeros, a default key
will be used. If all the bytes in the key are set to FF, then
no key will be used (i.e. the IP change notifications will
not be authenticated). AT*IPMGRKEY1 is used to set
the key to use with AT*IPMANAGER1, while
AT*IPMGRKEY2 is used to the key with
AT*IPMANAGER2.
Sets the number of minutes to periodically send an IP
update notification to the corresponding server. This will
occur even if the IP address of the PinPoint doesn't
change. *IPMGRUPDATE1 is used to set the refresh
rate to *IPMANAGER1, while *IPMGRUPDATE2 is
used with *IPMANAGER2.
If the value is set to 0, then periodic updates will not be
issued (i.e. IP change notifications will only be sent
when the IP actually changes).
103
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 11. IP
Manager
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.
Example: if *MODEMNAME=mymodem and
*DOMAIN=eairlink.com, then the modem's fully qualified domain name is mymodem.eairlink.com.
Note: Each modem using IPManager needs a unique
name. Two modems cannot be called “mymodem”. One
could be “mymodem1” with the other as “mymodem”.
Automatically Generated Names:
#I3 - The ESN/IMEI will be used as the name.
#NETPHONE - The phone number be used as the
name.
Note: Only letters, numbers, hyphens, and periods can
be used.
Keepalive (page 25) allows the PinPoint to stay connected to the cellular network
even when there are periods of inactivity.
TABLE 12. Keepalive
Command
Parameters
Details
*IPPING=n
n=0-255
Set the period to ping (if no valid packets have been
received) a specified address (*IPPINGADDR) to keep
the modem alive (online).
0 = Disable pinging (default)
See also *MINXMIT which can override this value.
*IPPINGADDR=
[d.d.d.d][name]
d.d.d.d = IP
name= domain
name
Set the IP address or valid internet domain name for the
PinPoint to ping to keep itself alive (online). *IPPING
must to be set to a value other than 0 to enable pinging.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
104
PinPoint: AT Commands
TABLE 12. Keepalive
Command
Parameters
Details
*IPINGFORCE=n
*MINXMIT=n
Have IP pings be always sent when their specified period
expires.
n=seconds
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.
Minimum transmit period enforcement. When set to n
seconds, will not let the *IPPING, *PPMINTIME, and
the *MSCIUPDPERIOD timers to be set less than n seconds.
Note that the *PPTIME can still be set to less than
*MINXMIT, but the packets will still be transmitted no
more often than the *PPMINTIME.
Warning: The *MINXMIT value is can only be set one
time and AirLink must be contacted to reset it.
105
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
Direct Communication can be used with the PinPoint to contact other Internet
devices to pass information or other tasks.
TABLE 13. Direct
Communication
Command
Parameters
Details
D[method][d.d.d.d][/ppppp]
method = P, T, N
or
d.d.d.d = IP
address to contact
Dial a connection to a remote IP and Port using method.
P - Establish a UDP connection
D[method][@name][/ppppp]
name = domain
name to contact
ppppp = IP port
to contact
D continued
see above
T - Establish a TCP connection
N - Establish a Telnet connection
ATD - Dial (establish) default connection.
ATDP192.168.13.31/2332 - Dial (establish) UDP session to 192.168.13.31, at port 2332.
To end the connection, issue the +++ escape sequence or
drop the DTR line (if Ignore DTR S211=0 or &D2).
The defualt connetion is set in S53.
If a domain name is specified, the '@' symbol can be
used to explicitly indicate the start of the name. For
example, if ATDPHONY is issued, this will be interpreted as dial a UDP connection to "HONY". To dial
using the default method to host "PHONY", one would
issue [email protected] .
If the method, IP address, or port is omitted, the values
from S53 are used. If a telnet connection is requested (N)
and the port is not supplied, port 23 will be used instead
of the value from S53.
Several special dialing numbers exist to make it easy to
establish a PPP or SLIP connection with the modem.
ATD#19788 or ATDT#19788 will establish a PPP connection (see \APPP) and ATDT#7547 will establish a
SLIP connection (see \ASLIP).
Note: The source port of the session is the Device Port
(set by S110 or *DPORT).
PINGd.d.d.d[,n]
or
PING domain_name[,n]
d.d.d.d = IP
address to contact
n = amount of
data to send
Ping the specified IP address.
Sends a single ping, returns either OK or ERROR
depending on result. Times out in 10 seconds. If n is provided, it specifies the amount of data to send with the
ping. If n is not provided, the default, 50 bytes is used.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
106
PinPoint: AT Commands
TABLE 13. 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.23/12345
Telnet to the specified IP at port 12345.
Query the specified IP at port 12345.
ATS53=/12345
Query port 12345.
*DPORT=n
n=1-65535
The modem's Device Port. Can also be set with the command S110.
*MSCIUPDADDR=name
name = domain
name
Modem Status Update Address - where Name/Port is the
domain name and port of the machine where the modem
status updates will be sent. The PinPoint's status parameters are sent in an XML format.
[/port]
port=port
*MSCIUPDPERIOD=n
n=0-255
Modem Status Update Period - where n defines the
update period in seconds.
0 = Disabled.
SMTP (Simple Mail Transfer Protocol) is the de facto standard for email transmission across the Internet. The PinPoint can send messages using SMTP if it has been
configured to use a mail server.
SMS (Simple Message Service) is another way to send messages via your Wireless
Service Provider’s cellular network.
TABLE 14. SMTP
Command
Parameters
Details
*NETSMS2EMAIL=
number= SMS/
E-mail server
Specify the SMS/E-mail server number. This is necessary to send an SMS message to an email address
(+CMGS).
[number]
107
(email) and SMS (messaging)
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 14. SMTP
(email) and SMS (messaging)
Command
Parameters
Details
*SMTPADDR=
d.d.d.d=IP
[d.d.d.d][name]
name=
Specify the IP address or Fully Qualified Domain Name
(FQDN) of the SMTP server to use.
domain name
*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. Remarque : Les paramètres SMTP
ne sont pas obligatoires, mais le télécommunicateur peut
les exiger.
*SMTPSEND=[email][body
]
email= email
address
Sends an email to the address specified, followed by the
body of the email message.
body= message
body
The email message is terminated and sent by entering a .
or Ctrl-Z on an empty line.
See also *SMTPSUBJ, *SMYPFROM, and *SMTPADDR.
*SMTPSTATUS?
none
Returns the status of the last issued SMTP message
(*SMTPSEND). If no status is available 0 is returned.
Once read, the status is cleared out.
The status codes are received from the SMTP server the
modem attempted to send the request.
Example: 354 = send in progress, 250 = sent ok.
*SMTPSUBJ=[subject]
subject= SMTP
message subject
Allows configuration of the default Subject to use if one
isn't specified in the message by providing a "Subject:
xxx" line as the initial message line.
*SMTPUSER=[user]
user= username
The email account username to authenticate with the
SMTP server (*SMTPADDR) for sending email.
Note: not required to use SMTP settings but may be
required by carrier.
Simple Network Management Protocol (SNMP) can be used to monitor devices
connected to a network for any conditions which warrant administration attention.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
108
PinPoint: AT Commands
By default, SNMP uses port 161, however most Internet providers (including cellular) block all ports below 1024 as a security measure.
TABLE 15. SNMP
Command
Parameters
Details
\ACEPW=pw
pw=password
Change the ACE password to a new value. Password is
case-sensitive. Default password is 12345.
Example: AT\ACEPAW=new123
*SNMPPORT=n
This controls which port the SNMP Agent listens on.
n=0
SNMP is disabled.
n=1-65535
Port for SNMP agent to listen on.
*SNMPSECLVL=n
*SNMPTRAPDEST=host/
[port]
Selects the security level requirements for SNMP communications as follows:
n=0
No security required. SNMPv2c and SNMPv3 communications are allowed.
n=1
Authentication equivalent to 'authNoPriv' setting in
SNMPv3. SNMPv3 is required to do authentication,
SNMPv2c transmissions will be silently discarded.
n=2
Authentication and encryption, equivalent to 'authPriv'
setting in SNMPv3. SNMPv3 is required to do authentication and encryption, SNMPv2c and SNMPv3 authNoPriv transmissions will be silently discarded. Messages
are both authenticated and encrypted to prevent a hacker
from viewing its contents.
host=IP address
Controls destination for SNMP Trap messages.
port=TCP port
If port is 0 or host is empty, traps are disabled.
Traps are sent out according to the SNMP security level
(i.e. if the security level is 2, traps will be authenticated
and encrypted). Currently, the only trap that can be generated is linkup.
Global Positioning System (GPS) information is gathered by the PinPoint for use
with Airlink Tracking System (ATS) or other applications needing location updates
(page 41).
109
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 16. GPS
Command
Parameters
Details
GPSn
Send NMEA GPS strings out serial link.
none
n=1
ATGPS will cause the NMEA GGA, RMC, and VTG
GPS strings to output to the serial port one time.
ATGPS1 will cause these strings to be sent out the serial
link once per second continuously until ATGPS or until
reset.
See also *PGPS.
#IG=n
n = seconds
Set or query GPS initialization timer.
Time in seconds to wait for GPS acquisition before
transmitting at high rates.
#U
none
Immediately issue GPS report to the ATS server IP and
port.
*MF=hh
hh = hex value
Set or query GPS format, where hh is a hex value; 8E
(transmit Latitude/Longitude/Direction/Velocity/Time in
binary) or 8F.
*PGPS=n
n=1
Send NMEA GPS strings out serial link [n=1]. Similar to
ATGPS except that the *PGPS value can be saved to
NVRAM so that it will continue to operate after resets.
*PPDEVID=n
Whether or not the PinPoint should include the 64-bit
device ID in its GPS reports.
n=0
Disable ID
n=1
Enable/display ID
Note: This setting MUST be 1 if the modem uses a
Dynamic IP.
*PPDIST=n
n = 1-65535
GPS Report Distance Interval in 100 Meter Units
n=0 Disabled
Cingular PinPoint EDGE or GPRS User Guide version 2.20
110
PinPoint: AT Commands
TABLE 16. GPS
Command
Parameters
Details
*PPGPSR=n
GPS report type.
n=0
n=0x11
Standard GPS Report
n=0x12
Standard GPS Report + UTC Date
n=0x13
Standard GPS Report + UTC Date + RF data
n=0xE0
GGA and VTG NMEA reports
n=0xE1
GGA, VTG and RMC NMEA reports
n=0xF0
TAIP reports
n=0xF1
Compact TAIP data
PPIGNOREIP=n
When enabled, ignore ATS Server IP (*PPIP) updates in
RAP.
n=0
Enabled Activée
n=1
Disabled
*PPINPUTEVT=n
*PPIP=d.d.d.d
Use legacy reports specified in *MF value. Note: Must
also have *PPDEVID=0.
Enable sending input changes as events (different report
types).
d.d.d.d=IP
n=0
Disabled
n=1
Enabled Activée
IP address where GPS reports are sent (ATS Server IP).
Example: AT*PPIP=192.100.100.100
Note: Also see *PPPORT.
*PPLATS=n
n=0-255
Local ATS - Causes GPS reports to also be sent out the
serial link every n seconds, when there is a PPP connection to the serial host established.
n=0 Disabled
Note: Sends to the PPP peer IP S110 with the Destination Port number S53.
111
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 16. GPS
Command
Parameters
Details
*PPLATSEXTRA=n
Have local ATS reporting (LATS) send up to 7 extra copies of a GPS report to the subsequent ports.
n=1-7
n=0
Send GPS report copies to that number of ports.
Just the original report is sent (default).
Example: If AT*PPLATSEXTRA=7 and the port in
S53 is 1000, then GPS reports will be sent to ports 10001008.
*PPLATSR=n
*PPMINTIME=n
n=any of the
valid GPS report
type
Indicates the type of GPS report to send to the local client (PPP/SLIP peer).
n = seconds
Specifies the minimum amount of time between reports
generated due to either the time interval (*PPTIME) or
the distance interval (*PPDIST). This is useful to limit
network traffic and make more efficient use of bandwidth. This can be used in conjunction with store and
forward. The minimum value which this setting can take
depends on the policies of the carrier.
(0-65535)
See *PPGPSR.
n=0 Disabled
*PPODOM=n
Enable odometer reporting.
n=0
Disabled (default)
n=1
Enabled
*PPODOMVAL=n
n=meters
The PinPoint’s current odometer value. The value is in
meters. Maximum value is approximately 4.3 billion
meters (2.5 million miles).
*PPPORT=n
n=1-65535
Port where GPS reports are sent.
n=0
Use S53 value.
See also ATSIP.
*PPSNF=n
Set or query the GPS report Store and Forward feature.
Store and Forward will cause GPS reports to be stored
up if the PinPoint goes out of network coverage. Once
the vehicle is in coverage the GPS reports will be sent en
masse to the server.
n=0
Disabled
n=1
Enabled (default)
Cingular PinPoint EDGE or GPRS User Guide version 2.20
112
PinPoint: AT Commands
TABLE 16. GPS
Command
Parameters
Details
*PPSNFB=n
Store and Forward Behavior.
When *PPSNF=1, the type of Store and Forward behavior is defined by:
*PPSNFM=n
n=0
Normal Store and Forward. Data is stored when the PinPoint is out of EDGE or GPRS coverage; when the PinPoint is in coverage, data is sent to server as soon as
possible. This is the default for PinPoints 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.
n=2
Grouped Reports. Data is stored until the desired minimum number of reports (see *PPSNFM) has been
stored. The data is then sent to the server in groups with
at least the specified number of reports.
n = 0-255
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.
*PPSNFR=n
Store and Forward Reliability:
n=0
GPS reports will be retransmitted if not acknowledged
by the server.
n=1
Disabled
Enabled
*PPTAIPID=nnnn
113
nnnn = TAIP ID
(4 characters)
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).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 16. GPS
Command
Parameters
Details
*PPTIME=n
n = seconds
GPS Report Time Interval
(1 - 65535)
Note: 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 PinPoint to overheat and shutdown. An RF
resource may continue be tied up to transfer small
amounts of data. Generally the RF channel will be
released and go dormant in 10-20 seconds of no data sent
or received. See also *PPMINTIME, *PPTSV
*PPTSV=n
n=0-255
Timer for Stationary Vehicles.
Time interval in minutes that the PinPoint will send in
reports when it is stationary.
For example, if *PPTIME=10, the PinPoint 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.
n=0 Disabled
*UDPRGPS=n
Set or query GPS stamping of UDP Reliable packets.
When set, data received on the host serial port will be
encapsulated with the GPS date and time.
n=0
Disabled (default)
n=1
Enabled
The PinPoint can be configured to use a digital switch connected to the DTR and
RTS of the serial port to trigger an Event (page 37).
The PinPoint will put itself into a low-power mode when other configured events
occur (page 37).
This last table is for commands which don’t fit into the other categories.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
114
PinPoint: 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
Disable DTR input monitoring.
n=1
Enable DTR input monitoring.
Note: If DTR is used as an input, DTR cannot be used
for low-power control.
*PPCOM1000=n
Enables support for extra inputs from a COM1000.
n=0
Disable
n=1
Enable
*PPFLUSHONEVT=n
n=0
n=1
Flushes store and forward buffer when an input event
(DTR/RTS) occurs. Vide le tampon de la fonction de
stockage et de transmission lorsqu'un événement
d'entrée (DTR/RTS) survient.
Disable
Enable
TABLE 18. Power
Command
Control
Parameters
Details
DTRP=n
Set or query the DTR power control.
n=0
Ignore DTR for power control.
n=1
Enter low power mode when DTR is low.
n=2
Enter low power mode when DTR is high.
See also PTMR.
115
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 18. Power
Control
Command
Parameters
Details
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.
Note: There is always a minimum of 1 minute between
power down event and actual shutdown (to give the
modem time to prepare); entering zero will not power
down the modem immediately, but after one minute.
Note: In the first 5 minutes after modem powers up,
power down events are ignored to give the user time to
change configurations.
VLTG=n
n=threshhold in
tenths of volts
Set or query the voltage level at which the PinPoint goes
into low power mode.
Example: ATVLTG=130 would power down the
modem if the voltage goes below 13.0V.
n=0 Ignore voltage for power control.
*POWERMODE?
none
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.
Low Final - Power down is imminent.
Low - Power is down.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
116
PinPoint: AT Commands
TABLE 19. Other
Command
Settings
Parameters
Details
*NUMTOIP=n
Convert 12 digit number to IP.
n=0
Use as name.
n=1
Use as IP.
Commands Available only when in PassThru
When the PinPoint is in PassThru mode (page 30), the features of ALEOS, except
serial communications, are disabled. When the modem is in PassThru mode, you
are communicating directly to the OEM module. Only this subset of AT commands
will work while in PassThru mode. It is also necessary to note the model number of
your modem, since the model number corresponds to the internal module.
Note: Many of these commands will not work (or will give dif-
ferent results) unless the PinPoint is in PassThru Mode.
Remarque:
TABLE 20. Commands
Usable with PassThru
Command
Parameters
Details
+++
none
AT Escape sequence.
This command is not proceeded by AT.
A/
none
Re-execute last command.
This command is not proceeded by AT.
A
none
Answer - manual.
En
Toggle AT command echo mode.
n=0
Echo Off.
n=1
Echo On.
Hn
I[n]
117
Hang-Up Command.
n=1
Hang-up
n=0
The modem’s module type.
n=3
The internal hardware module's unique ID (ESN).
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: 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.
En ligne (à distance).
Fait passer le modem du mode commande au mode données.
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.
S0=n
Auto Answer
n=0
n=1-255
S3=n
S5=n
S6=n
Enable after n number x 6 of seconds.
Carriage Return Character
n=0-127
S4=n
Disable
(ASCII character number)
The standard end of line character used to indicate the
end of an AT command. This character is also used as
the carriage return character for framing responses and
result codes in command state.
n=0-127
Line Feed Character
(ASCII character number)
The standard line feed character sent by the modem to
the host at the end of a response or return code in command state.
n=0-127
Backspace Character
(ASCII character number)
This register sets the character recognized as a backspace during command entry.
n=2-10
Wait for Blind Dial
This register denotes the wait time, in seconds, before a
blind dial (no dial tone detection).
S7=n
n=1-255
Wait For Carrier
If no carrier from the remote modem is detected within
the specified time, the modem goes on-hook.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
118
PinPoint: AT Commands
TABLE 20. Commands
Usable with PassThru
Command
Parameters
Details
S8=n
n=0-255
Comma Pause Time (Dial Modifier)
Whenever a dial command contains the comma character, the contents of this register specify the pause time
for each comma.
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. This allows temporary disruptions to carrier without disconnecting.
A setting of 255 causes the modem to disable Carrier
Detect and presume carrier is always present.
S11=n
n=50-255
DTMF Dialing Speed (Remote)
This specifies the duration of tones in DTMF dialing.
Vn
Command Response Mode.
n=0
Terse (numeric) command responses.
n=1
Verbose command responses (Default).
Xn
119
Extended Call Progress Result mode.
n=0
Turn off extended result codes (Default).
n=1
Turn on result codes. This adds the text 19200 to the
CONNECT response.
Z
none
Reset the PinPoint.
&F
none
Restore Factory Setting.
&V
none
View active profile (the contents of the active registers).
&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.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 20. Commands
Usable with PassThru
Command
Parameters
Details
!STATUS
none
Displays the current modem status. Format of response:
Current band: <bande>
Current channel: <chan>
SID:<sid> NID:<nid> Roaming:<n>
Temp:<temp>
Pilot [NOT] acquired
Modem has [NOT] registered
!RSSI
none
Received Signal Strength Indicator
+CBIP?
none
Base Station IP Address
+CGDCONT=1,”IP”,”apn”
apn=access
point name
Easy entry of the APN
If left blank, the modem will attempt to use the default
subscriber value as defined by the account.
Note: 1,”IP”, are required and not variable. Quotes
need to be placed around the APN.
+CGSN
none
ESN (Electronic Serial Number).
+CICB
The mode for answering data/fax calls with A (Answer)
or autoanswer via S0=1.
n=0
Answer as voice (Default)
n=2
Voice
n=3
Async data for next call, then revert to Voice
+CIMI
none
Mobile Station IP Address
+CMIP?
none
Received Signal Strength and Channel Frame Error Rate
+CSQ
none
Serving System
+CSS?
none
Capabilities
+GCAP
none
Model identification with supported frequency bands.
+WGMM
none
Serial number of the module.
+WHWV
none
PRL version
Cingular PinPoint EDGE or GPRS User Guide version 2.20
120
PinPoint: AT Commands
TABLE 20. Commands
Usable with PassThru
Command
Parameters
Details
+WIMI=[num]
num=IMSI
Set the IMSI.
A valid IMSI is 15 digits in length; MCC (3), MNC (2),
MIN2 (3), MIN1 (7). For support of Wireless Number
Portability, changes to the IMSI will NOT update the
MDN. Changes to the IMSI will automatically update
the Access Overload Class values unless specifically
modified using +WAOC command.
Generally, Cingular will provide the IMSI.
+WMDN=[num]
num=phone
number
Set the Mobile Directory Number (MDN).
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. Changes to the MDN will also automatically update the Access Overload Class values unless
specifically modified using the +WAOC command. The
new IMSI_M and Access Overload Class values will not
be visible in the WIMI and WAOC commands until after
the changes are committed with the WCMT command.
Generally, Cingular will provide the MDN.
+WSID=[idx],
[sid],[nid]
idx=The location in the SID/
NID list to store
the values.
sid= system ID
nid=network ID
121
Set SID and NID.
The new SID/NID values are committed to NV with the
+WCMT command.
Generally, Cingular will provide the SID and NID.
Note: A maximum of 20 index locations (0-19) are supported. Error 22 is returned if the specified index value is
not in the valid range.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
PinPoint: AT Commands
TABLE 20. Commands
Usable with PassThru
Command
Parameters
Details
+WSPC=[lock],[nnnnnn]
lock=
Service Programming Code
0 - OTKSL(One
Time Key Subsidy Lock)
Upon successful entry of this code, all other service provisioning AT commands may be used. Generally, Cingular will provide the unlock code and type.
1 - MSL (Master
Subsidy Lock)
If an OTKSL is used to enter provisioning mode, only
the +WIMI, +WMDN, and +WCMT commands will be
allowed. All other commands will return ERROR.
nnnnnn=6 digit
unlock code
Caution: This command supports five attempts to enter
the correct service programming code. If five incorrect
attempts are performed, the ME will power down.
Note: Once the correct SPC code is entered, the module
transitions to the Service Programming state. This state
is not exited until a commit is done (+WCMT). While in
the Service Programming state, subsequent validations
of the SPC code are ignored until the Service Programming state is reset.
+WSSW
none
Software version of the module
+WVSS=[n]
n=roam type
Preferred Roaming List .
0 - Home Only
Note: The values depend on the currently loaded PRL.
1 - Automatic
Home only - Service on home systems
2- Automatic A
For preferred systems:
3- Automatic B
Automatic - Roaming allowed on affiliated systems
For non preferred systems:
Automatic-A - Roaming allowed on affiliated systems
and any A band system
Automatic-B - Roaming allowed on affiliated systems
and any B band system
$QCVAD
The mode for answering data/fax calls with A (Answer)
or autoanswer via S0=1.
n=0
Answer as voice (Default)
n=3
Data for one call
n=4
Data for all calls
Cingular PinPoint EDGE or GPRS User Guide version 2.20
122
PinPoint: AT Commands
TABLE 20. Commands
Usable with PassThru
Command
Parameters
Details
~NAMLCK=nnnnnn
nnnnnn=6 digit
unlock code
The NAMLCK is the modem's 6-digit OTSL (One Time
Subsidy Lock), MSL (Master Subsidy Lock), or SPC
(Service Provisioning Code). Generally, Cingular will
provide the unlock code.
If the number is accepted by the modem, the OK result
code is returned. If the number is rejected, the ERROR
result is returned. If three successive Errors are returned,
the modem must be reset to allow any further attempts.
Caution: The modem permits 99 failures of this command during its lifetime. After that, the modem becomes
permanently disabled.
~NAMVAL=
nam[,num,sid,nid]
nam=0 or 1;
active account
Write account activation data
num=phone
number
Following writing the values, the modem must be reset.
sid=system ID
Generally, Cingular will provide the SID and NID.
Note: If ~NAMLCK has not been successfully executed,
the modem returns ERROR.
nid=network ID
123
Cingular PinPoint EDGE or GPRS User Guide version 2.20
CHAPTER 13
Specifications for the
PinPoint EDGE or
GPRS
Physical Characteristics:
•
•
•
•
Weight: 2 lb.
Size: 6.8” x 3.3” x 2”
RF Antenna Connector: 50 Ohm TNC
Serial Interface: RS232 DB-9F with 1200-115200 bps
Data Services & RF Features: GPRS
• Network: 1900/850 MHz GPRS
• Transmit frequency: 1850-1910 MHz and 824-849 MHz
• Transmit power range at antenna port: 1.0 W for 1900 MHz and 0.8W for 850
MHz
• Transmitter can reduce output power when near a base station as per GSM specifications
•
•
•
•
Receiver frequency: 1930-1990 MHz and 869-894 MHz
Receiver sensitivity: typical -107 dBm (2.439% bit error rate)
Multislot Class 8
Circuit Switched Data Capable (14,400 Transparent and Non-Transparent
Modes)
Cingular PinPoint EDGE or GPRS User Guide version 2.20
124
Specifications for the PinPoint EDGE or GPRS
Data Services & RF Features: EDGE
• Quad Band EDGE (850/1900 MHz and 900/1800 MHz)
• EDGE (MS Class 10) w/ GPRS (MS-12) Fallback
• Coding Schemes 1-9, Full PBCCH Support
Environmental:
• Operating ranges: -30°C to +70°C
• Humidity: 5%-95% Non-condensing
Power Management:
•
•
•
•
•
•
•
Advanced Power Management features
Low power consumption
Dormant connection (idle for 10-20 seconds): 60 mA at 12 VDC
Input Voltage: 10 VDC to 28 VDC
Input Current: 20 mA to 350 mA
Typical Transmit/Receive: 300ma at 12VDC
Low power mode: 20 mA at 12 VDC
Cingular PinPoint EDGE or GPRS User Guide version 2.20
125
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 [email protected] or call 510-781-9760
Monday through Friday 5 AM to 5 PM Pacific Time (8 AM to 8 PM Eastern Time).
Support is not available weekends or holidays.
Cingular PinPoint EDGE or GPRS User Guide version 2.20
126
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement