navSafeMode (Function)

Top  Previous  Next

Architecture:

NX32 / NX32L

Device support:

MX2 turbo/encore/warp, AX9 turbo, NX-200, NX-400, NX-900

Firmware version:

4.70 / 1.30.00

Nav. API level:

6


This function is used to enable Safe Mode and configure the threshold speed in the navigation unit.

While this is enabled, the user configurable Safe Mode is removed.

 

If Safe Mode is enabled, the following restrictions are applied when the speed exceeds the threshold:

The driver will be restricted from going to ‘Dispatch’ and ‘Tools’ menus .

If the driver is browsing a page descending from the ‘Dispatch’ or ‘Tools’ menus, the driver will be taken to the main map page.

The driver will not be able to read new stops or non-immediate text messages

 

 

Input:

speed : INT (0..2236, default: 2236)

The speed threshold in mm/s. The maximum value of 2236 mm/s is around 8km/hr.

Set this value to 0 to restore the user configurable safe mode.

 

 

 

Returns: INT

0

- Success.

-1

- Navigation interface is not opened.

-2

- Error communicating with navigation device.

-4

- The navigation device rejected the command.

-8

- Speed is outside the valid range.

-11

- Configuring safe mode is not supported.

-12

- Navigation interface is busy.

 

Declaration:

FUNCTION navSafeMode : INT;
VAR_INPUT
  speed   : INT := 2236;
END_VAR;

 

Example:

INCLUDE rtcu.inc
 
PROGRAM NavigationExample;
 
BEGIN
  ...
  // Enable safe mode
  navSafeMode();
  ...
END;
END_PROGRAM;