ALEOS User Guide
RAP Configuration
RAP has additional features which allow reports based on external physical events, input from a 3rd party devices, store and forward processing, etc.
In addition to being able to configure your AirLink device using ACEmanager or
AT commands, most of the configuration settings for RAP can also be changed with the RAP configuration command message sent by the AVL host.
RAP Reports Over-The-Air (Remote)
To configure your AirLink device to send RAP reports to a remote AVL host server, you will need to set 3 commands: *PPIP, *PPPORT, and *PPGPSR.
1.
Set the IP address of the host with *PPIP and desired port on the host with
*PPPORT.
2.
Set the GPS Report Type, using *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.
Tip:
If your AVL host server uses a dynamic IP address or needs to change its IP address for any reason, you can use the RAP configuration command to change the value for
*PPIP.
242 4112515
Rev. 6 May.13
RAP Reports over a Local Connection
Local reports are sent to the local IP address of the computer or device connected directly to a port on the AirLink device. The reports are sent using PPP or SLIP for serial or USB virtual serial. To configure the modem to send reports to the local IP address, you need to set three commands: S53 in the GPS group, and *PPLATS and *PPLATSR in the PinPoint group.
1.
Set the S53 port to the local port to which you want the reports sent. The local IP address will automatically be used.
2.
Set the Local Report Type, using *PPLATSR, to your preferred RAP report type.
11 — GPS — Global Positioning System data
12 — GPS + Date — GPS data with the UTC time and date
13 — GPS + Date + RF — GPS data with the UTC time and date and
Radio Frequency information from the antenna.
3.
Set Local Reporting Time Interval, using *PPLATS, to the number of seconds you want as an interval between reports being sent.
Tip:
If *PPLATS is set to 0, reports will only be sent if a poll command is issued by the local client.
Configuring Additional RAP Features
RAP allows additional information to be sent with the reports to enable a richer tracking feature set.
Device ID
By enabling *PPDEVID, a device ID of the AirLink device is sent as part of the
RAP message to make identification easier in a network or fleet of vehicles equipped with PinPoint line devices. With *PPDEVID enabled, the AirLink device uses the value configured for *NETPHONE for the device ID. If *NETPHONE is empty, the ESN of the modem is used.
Tip:
If the AirLink device is using a dynamic IP, *PPDEVID needs to be enabled.
Odometer Data in Reports
When the odometer report is enabled, the AirLink device will calculate distance between reports based on GPS data. The modem’s odometer calculations can be included in the RAP message.
•
*PPODOM enables the odometer reporting.
•
*PPODOMVAL is the current odometer reading in the AirLink device. You can set this to a number to offset the odometer calculation, such as one-time manual synchronization of the AirLink device odometer with the current vehicle odometer.
243
ALEOS User Guide
Note: The odometer calculations of the AirLink device may not match the odometer in the vehicle itself. The AirLink device odometer is not connected to the vehicle’s, it is entirely based on calculations of GPS readings.
I/O Event Reports
You can configure the AirLink device to send reports to the AVL Host based on the state of the digital inputs, analogue inputs, and relay outputs.
Tip:
Setting up the I/O port hardware is covered in the Inputs, Relay Outputs, and Power
Status chapter.
Enable *PPINPUTEVT to have events sent to the Host server.
COM 1000 Support
Support for a COM1000 is enabled with the command *PPCOM1000=1 or
*PPREPORTINPUTS=1. Once enabled, ALEOS will receive the reports from a properly configured COM1000 and add the state of the extra inputs to RAP packets sent to the RAP Host.
If you are replacing an existing PinPoint or PinPoint-E in a vehicle with a
COM1000, simply replace the earlier modem with the PinPoint. Turn on
COM1000 reporting with the command *PPCOM1000=1 to allow a seamless transition with no need to change any commands to support the COM1000 in the same operation as the previous installation.
If you have new vehicle installations for the PinPoint and have previously installed
PinPoints or PinPoint-E modems plus COM1000 in other vehicles, connect the inputs directly to the PinPoint and turn on input reporting with the command
*PPREPORTINPUTS=1. Since the PinPoint reports inputs report using the exact same bit fields as the COM1000, no changes to your software should be required.
Caution:
If both *PPCOM1000 and *PPREPORTINPUTS are enabled, the AirLink device digital inputs will be reported and the COM1000 inputs will be ignored.
The report type will indicate the state of change in the inputs. 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.
Flush on Event
If Store and Forward is configured and enabled, enable *PPFLUSHONEVT to receive event reports immediately when they occur. This will cause all pending reports, including the triggering event, to be sent immediately to the Host.
244 4112515
