You can configure location clients on the EX15 device that forward location messages in either NMEA or TAIP format to a remote host.
Required configuration items
- Enable the location service.
- The hostname or IP address of the remote host to which the location messages will be forwarded.
- The communication protocol, either TCP or UDP.
- The destination port on the remote host to which the messages will be forwarded.
- Message protocol type of the messages being forwarded, either NMEA or TAIP.
Additional configuration items
- Additional remote hosts to which the location messages will be forwarded.
- Location update interval, which determines how often the device will forward location information to the remote hosts.
- A description of the remote hosts.
- Specific types of NMEA or TAIP messages that should be forwarded.
- If the message protocol is NMEA, configure a talker ID to be used for all messages.
- Text that will be prepended to the forwarded message.
- A vehicle ID that is used in the TAIP ID message and can also be prepended to the forwarded message.
Configure the EX15 device to forward location information:
Web
- Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
- Access the device configuration:
Remote Manager:
- Locate your device as described in Use Digi Remote Manager to view and manage your device.
- Click the Device ID.
- Click Settings.
- Click to expand Config.
Local Web UI:- On the menu, click System. Under Configuration, click Device Configuration.
The Configuration window is displayed.
- Click Services > Location > Destination servers.
- For Add destination server, click .
- (Optional) For Label, type a description of the location destination server.
- For Destination server, enter the hostname or IP address of the remote host to which location messages will be sent.
- For Destination server port, enter the UDP or TCP port on the remote host to which location messages will be sent.
- For Communication protocol, select either UDP or TCP.
- For Forward interval multiplier, select the number of Location update intervals to wait before forwarding location data to this server.
- For NMEA filters, select the filters that represent the types of messages that will be forwarded. By default, all message types are forwarded.
- To remove a filter:
- Click the down arrow () next to the appropriate message type.
- Click Delete.
- To add a message type:
- For Add NMEA filter or Add TAIP filter, click .
- Select the filter type. Allowed values are:
- GGA: Reports time, position, and fix related data.
- GLL: Reports position data: position fix, time of position fix, and status.
- GSA: Reports GPS DOP and active satellites.
- GSV: Reports the number of SVs in view, PRN, elevation, azimuth, and SNR.
- RMC: Reports position, velocity, and time.
VTG: Reports direction and speed over ground.
- To remove a filter:
- For TAIP filters, select the filters that represent the types of messages that will be forwarded. By default, all message types are forwarded.
- To remove a filter:
- Click the down arrow () next to the appropriate message type.
- Click Delete.
- To add a message type:
- For Add NMEA filter or Add TAIP filter, click .
- Select the filter type. Allowed values are:
- AL: Reports altitude and vertical velocity.
- CP: Compact position: reports time, latitude, and longitude.
- ID: Reports the vehicle ID.
- LN: Long navigation: reports the latitude, longitude, and altitude, the horizontal and vertical speed, and heading.
- PV: Position/velocity: reports the latitude, longitude, and heading.
- To remove a filter:
- For Outgoing message type, select either NMEA or TAIP for the type of message that the device will forward to a remote host.
(Optional) If NMEA is selected:
- Select a Talker ID.
The talker ID is a two-character prefix in the NMEA message that identifies the source type. The talker ID set here will override the talker ID from all sources, and all forwarded sentences will use the configured ID. The default setting is Default, which means that the talker ID provided by the source will be used.
- Determine the Behavior when fix is invalid:
- None: No messages are sent.
- Empty: Send messages with empty fields.
- Last fix: Send messages with information from the last valid fix.
- Select a Talker ID.
- (Optional) For Prepend text, enter text to prepend to the forwarded message. Two variables can be included in the prepended text:
- %s: Includes the EX15 device's serial number in the prepended text.
- %v: Includes the vehicle ID in the prepended text.
For example, to include both the device's serial number and vehicle ID in the prepend message, you can enter the following in the Prepend field:
__|%s|__|%v|__
- Type a four-digit alphanumeric Vehicle ID that will be included with to location messages. If no vehicle ID is configured, this setting defaults to 0000.
- Click Apply to save the configuration and apply the change.
Command line
- Select the device in Remote Manager and click Actions > Open Console, or log into the EX15 local command line as a user with full Admin access rights.
Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.
- At the command line, type config to enter configuration mode:
> config (config)>
- Add a remote host to which location messages will be sent:
(config)> add service location forward end (config service location forward 0)>
- Set the hostname or IP address of the remote host to which location messages will be sent:
(config service location forward 0)> server host (config service location forward 0)>
- Set the communication protocol to either upd or tcp:
(config service location forward 0)> protocol protocol (config service location forward 0)>
- Set the TCP or UDP port on the remote host to which location messages will be sent:
- Set the number of Location update intervals to wait before forwarding location data to this server.
(config service location forward 0)> interval_multiplier int (config service location forward 0)>
- Set the protocol type for the messages. Allowed values are taip or nmea; the default is taip:
(config service location forward 0)> type nmea (config service location forward 0)>
(Optional) If the protocol type is set to nmea:- Configure a Talker ID.
The talker ID is a two-character prefix in the NMEA message that identifies the source type. The talker ID set here will override the talker ID from all sources, and all forwarded sentences will use the configured ID.
Use the ? to determine available talker IDs:
(config service location forward 0)> talker_id ? Talker ID: Setting a talker ID will override the talker ID from all remote sources, and all forwarded sentences from remote sources will use the configured ID. Format: Default GA GB GI GL GN GP GQ Default value: Default Current value: Default (config service location forward 0)>
Set the talker ID:
(config service location forward 0)> talker_id value (config service location forward 0)>
The default setting is Default, which means that the talker ID provided by the source will be used.
- Determine the behavior when fix is invalid:
(config service location forward 0)> no_fix value (config service location forward 0)>
where value is one of:
- none: No messages are sent.
- empty: Send messages with empty fields.
- last_fix: Send messages with information from the last valid fix.
The default is empty.
- Configure a Talker ID.
-
(Optional) Set the text to prepend to the forwarded message. Two variables can be included in the prepended text:
- %s: Includes the EX15 device's serial number in the prepended text.
- %v: Includes the vehicle ID in the prepended text.
(config service location forward 0)> prepend __|%s|__|%v|__ (config service location forward 0)>
-
(Optional) Set the vehicle ID.
Allowed value is a four digit alphanumerical string (for example, 01A3 or 1234). If no vehicle ID is configured, this setting defaults to 0000.
(config service location forward 0)> vehicle-id 1234 (config service location forward 0)>
-
(Optional) Provide a description of the remote host:
(config service location forward 0)> label "Remote host 1" (config service location forward 0)>
-
(Optional) Specify types of messages that will be forwarded. Allowed values vary depending on the message protocol type. By default, all message types are forwarded.
-
If the message protocol type is NMEA:
Allowed values are:
- gga: Reports time, position, and fix related data.
- gll: Reports position data: position fix, time of position fix, and status.
- gsa: Reports GPS DOP and active satellites.
- gsv: Reports the number of SVs in view, PRN, elevation, azimuth, and SNR.
- rmc: Reports position, velocity, and time.
- vtg: Reports direction and speed over ground.
To remove a message type:
- Use the show command to determine the index number of the message type to be deleted:
(config service location forward 0)> show filter_nmea 0 gga 1 gll 2 gsa 3 gsv 4 rmc 5 vtg (config service location forward 0)>
- Use the index number to delete the message type. For example, to delete the gsa (index number 2) message type:
(config service location forward 0)> del filter_nmea 2 (config service location forward 0)>
To add a message type:
- Change to the filter_nmea node:
(config service location forward 0)> filter_nmea (config service location forward 0 filter_nmea)>
- Use the add command to add the message type. For example, to add the gsa message type:
(config service location forward 0 filter_nmea)> add gsa end (config service location forward 0 filter_nmea)>
-
If the message protocol type is TAIP:
Allowed values are:
- al: Reports altitude and vertical velocity.
- cp: Compact position: reports time, latitude, and longitude.
- id: Reports the vehicle ID.
- ln: Long navigation: reports the latitude, longitude, and altitude, the horizontal and vertical speed, and heading.
- pv: Position/velocity: reports the latitude, longitude, and heading.
To remove a message type:
- Use the show command to determine the index number of the message type to be deleted:
(config service location forward 0)> show filter_taip 0 al 1 cp 2 id 3 ln 4 pv (config service location forward 0)>
- Use the index number to delete the message type. For example, to delete the id (index number 2) message type:
(config service location forward 0)> del filter_taip 2 (config service location forward 0)>
To add a message type:
- Change to the filter_taip node:
(config service location forward 0)> filter_taip (config service location forward 0 filter_taip)>
- Use the add command to add the message type. For example, to add the id message type:
(config service location forward 0 filter_taip)> add id end (config service location forward 0 filter_taip)>
-
- Save the configuration and apply the change.
(config)> save Configuration saved. > - Type exit to exit the Admin CLI.
Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.
(config service location forward 0)> server_port 8000 (config service location forward 0)>
PDF
