Forward location information to a remote host

You can configure location clients on the TX54-PR device that forward location messages in either NMEA or TAIP format to a remote host.

Required configuration items

Additional configuration items

Configure the TX54-PR device to forward location information:


  1. Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
  2. Access the device configuration:

    1. Locate your device as described in Use Digi Remote Manager to view and manage your device.
    2. Click the Device ID.
    3. Click Settings.
    4. Click to expand Config.

    1. On the menu, click System. Under Configuration, click Device Configuration.

      The Configuration window is displayed.

  3. Click Services > Location > Destination servers.
  4. For Add destination server, click .
  5. (Optional) For Label, type a description of the location destination server.
  6. For Destination server, enter the hostname or IP address of the remote host to which location messages will be sent.
  7. For Destination server port, enter the UDP or TCP port on the remote host to which location messages will be sent.
  8. For Communication protocol, select either UDP or TCP.
  9. For Forward interval multiplier, select the number of Location update intervals to wait before forwarding location data to this server. See Configure the location service for more information about setting the Location update interval.
  10. 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:
      1. Click the down arrow () next to the appropriate message type.
      2. Click Delete.
    • To add a message type:
      1. For Add NMEA filter or Add TAIP filter, click .
      2. 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.

  11. 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:
      1. Click the down arrow () next to the appropriate message type.
      2. Click Delete.
    • To add a message type:
      1. For Add NMEA filter or Add TAIP filter, click .
      2. 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.
  12. 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:

    1. 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.

    2. 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.
  13. (Optional) For Prepend text, enter text to prepend to the forwarded message. Two variables can be included in the prepended text:
    • %s: Includes the TX54-PR 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|__
  14. 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.
  15. Click Apply to save the configuration and apply the change.
  1. Select the device in Remote Manager and click Actions > Open Console, or log into the TX54-PR 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.

  2. At the command line, type config to enter configuration mode:
    > config
(config)>
  3. Add a remote host to which location messages will be sent:
    (config)> add service location forward end
(config service location forward 0)>
  4. 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)>
  5. Set the communication protocol to either upd or tcp:
    (config service location forward 0)> protocol protocol
(config service location forward 0)>
  6. Set the TCP or UDP port on the remote host to which location messages will be sent:
    7. (config service location forward 0)> server_port 8000
(config service location forward 0)>
  7. Set the number of Location update intervals to wait before forwarding location data to this server. See Configure the location service for more information about setting the Location update interval.
    (config service location forward 0)> interval_multiplier int
(config service location forward 0)>
  8. 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)>
    1. 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.

      1. 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)>

      2. 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.

    2. 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.

    • %s: Includes the TX54-PR 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)>

  10. 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)> 

  11. (config service location forward 0)> label "Remote host 1"
(config service location forward 0)>

    • 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:

      1. 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)>
      2. 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:

      1. Change to the filter_nmea node:
        (config service location forward 0)> filter_nmea
(config service location forward 0 filter_nmea)>
      2. 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)>

    • 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:

      1. 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)>
      2. 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:

      1. Change to the filter_taip node:
        (config service location forward 0)> filter_taip
(config service location forward 0 filter_taip)>
      2. 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)>

  13. Save the configuration and apply the change
    (config)> save
Configuration saved.
>
  14. 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.