ADVANCED: navStopSetRouteFile (Function)

This function will start to transfer a route file to the navigation device.

A "GPI progress" event is raised when there are changes to the progress and/or status of the file transfer. See also navWaitEvent for event # 9.

The route file is a binary file that follows the format specified in "5.1.6.2.1 Path Specific Stop (PSS) file data format" in the "Garmin Fleet Management Interface Control

Specification", which is part of the Garmin Fleet Management SDK, available at http://developer.garmin.com/fleet-management/overview/.

The file can optionally be compressed with the GZIP format.

When the upload is completed, navGPIProgressReceive will report any errors with the route.

In addition to the common errors, the following errors can happen:

Note: To create a route on the RTCU device, use the navStopRouteCreate and navStopSetRoute functions instead.

Input:

filename : STRING

The name and path of the file to transfer.

ID : STRING

A small text message to identify the file.

Must be between 1 and 16 characters.

Returns: INT

Declaration:

FUNCTION navStopSetRouteFile : INT;
VAR_INPUT
  filename : STRING;
  id       : STRING;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM NavigationExample;
 
BEGIN
  ...
  // Start transfer of a route
  navStopSetRouteFile(filename := "route01.pss", id := "Route 1");
  ...
END;
END_PROGRAM;