Logic IO PNM-100 User manual

NMP – User Guide, Version 3.00
Navigation and Messaging Platform
User Guide
Version 3.00
Page 1 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
Table of Content
Table of Content............................................................................................................2
Introduction....................................................................................................................3
Features.........................................................................................................................4
Contents of package......................................................................................................5
How to use the N P......................................................................................................6
The main menu..........................................................................................................6
Connection status......................................................................................................7
Configurable Buttons.................................................................................................7
Driver menu...............................................................................................................8
Keyboard................................................................................................................9
essage menu........................................................................................................10
Stop menu................................................................................................................12
obile Data Terminal menu.....................................................................................14
Updates.......................................................................................................................15
Remote update........................................................................................................15
SD Card update.......................................................................................................15
Update process........................................................................................................15
How to configure the N P..........................................................................................17
Settings....................................................................................................................17
Basic device configuration...................................................................................17
Device specific settings........................................................................................17
Functionality.........................................................................................................18
enu buttons........................................................................................................18
Hiding buttons......................................................................................................19
Sound settings......................................................................................................20
Hiding menus.......................................................................................................20
Debug...................................................................................................................20
Time settings........................................................................................................21
Themes.................................................................................................................22
Translations..........................................................................................................23
Keyboard..............................................................................................................23
Waypoint symbols....................................................................................................24
Images.....................................................................................................................24
Sounds.....................................................................................................................24
How to install the N P (optional)................................................................................26
How to modify installation for a new device.............................................................26
Probing the device...................................................................................................27
Troubleshooting...........................................................................................................28
Page 2 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
Introduction
This document descri es the details of the Navigation and Messaging Platform(NMP), a
platform providing the com ined functionality of a navigation system with fleet management
and a Mo ile Data Terminal, MDT.
This document will descri e the installation and use of the NMP, and for information a out
the usage of the PNM-100 and PNM-200 devices please refer to the Technical Manual for
those products.
The package contains either an SD card with the application, or a Windows CE device with
the application already installed on an SD card.
The NMP is controlled and managed from the RTCU application and for more detailed
information on the programming, please consult the RTCU IDE online help.
The RTCU application runs on an NMP ena led RTCU with firmware 2.64 or higher and the
NMP application runs on a Windows CE 5.0 device with .Net Compact Framework 2.0 or
higher.
To change an RTCU application from using a Garmin navigation devices and/or an MDT to
use an NMP, very few changes are needed; The navigation interface must e opened efore
the MDT interface, and the NMP must e fed GPS data y calling gpsFix()1 repeatedly for
the navigation part to work.
1 See Online Help, Navigation section.
Page 3 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
DT
Navigation Powered by Sygic
Windows CE 5.0
RTCU device
or RTCU IDE
simulator
Connection cable
GPS
GPRS
RTCU Gateway
Custom Fleet Navigation Application
with RTCU support
WWW

NMP – User Guide, Version 3.00
Features
This includes
Compati le with the navigation API, most existing programs will only need small
changes.
Compati le with MDT API.
Uses GPS information from the RTCU, preventing any inconsistencies etween the
navigation device and the RTCU.
Configura le:
oWaypoint sym ols
oLogos
oTranslations
Additional user defined uttons for interaction with the RTCU.
Support for hardware uttons on supported hardware.
Support for status leds on supported hardware.
Support for rear view camera on supported hardware.
Page 4 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
Contents of package
The NMP package contains the following:
•NMP - User Guide V300.pdf This document
•SD Card with the following content:
•\nmp Folder with NMP software
•\drive\ Folder with navigation system
•\drivers\ Folder with drivers for different disk configurations
•\res\ Folder with resources for navigation system
•\map\ Folder with map data
•\install.exe Installation program
•\install.xml Installation configuration
•\autorun.exe Launcher application. Moved to the autorun location on the
device when install is run.
Page 5 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
How to use the NMP
The main menu
When the NMP is started, the display will show this:
When the RTCU is connected, the NMP will look like this2:
2 Please notice that the uttons etc. can e changed in the settings, see Menu uttons.
Page 6 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
User status and
user log in
Read and write
text messages
View and
edit stops
MDT power up request.
RTCU controls visi ility
Current location
No connection
to RTCU
No GPS signal
from RTCU
RTCU connected
Text set from RTCU (navSetUIText)

NMP – User Guide, Version 3.00
Connection status
The connection status can show three different icons:
No connection
The RTCU is not connected to the NMP. All the uttons will
e disa led, only the navigation window is visi le to allow
the route to e visi le.
Connected RTCU is connected. The uttons are ena led.
File transfer in
progress
A file is eing transferred to the NMP. The responsiveness
might suffer a it.
By clicking the icon, the a out dialog is shown.
To access the underlying operating system, press the icon for a out 5 seconds and then enter
the admin code to e a le to exit. The code is controlled y the settings (page 17), with the
default eing 'admin'.
Configurable Buttons
Using special NMP functions, it is possi le to add uttons elow the navigation window.
These uttons take up space that would otherwise e used for navigation.
Page 7 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
Butons can e
ena led and disa led
Buttons can
e hidden
Configura le
color and width

NMP – User Guide, Version 3.00
Dri er menu
The driver menu shows all the drivers and their status. To go ack to the main menu, press
ack or the driver utton.
To log in, enter the User ID and password and press next to set the status.
Page 8 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
Back to
main menu
Click to
log in
Click to
set status
Switch etween
num ers and letters
Clear driver and driver status
(Hidden y default)

NMP – User Guide, Version 3.00
Select the user status from the list and press Ok.
Keyboard
The on-screen key oard looks like this (exact layout is determined y the configuration):
Page 9 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
Switch etween
num ers and letters
Backspace
Space ar

NMP – User Guide, Version 3.00
Message menu
The message menu provides a list of received and sent messages. When the RTCU deletes
messages, the message utton will flash until this menu is accessed.
When viewing messages, the reply options depend on what type of message it is. For message
type 2 and 3 (acknowledge and yes/no) a utton is shown for each reply. For type 4, user
defined replies, clicking the reply utton will show the list of predefined replies. For type 0
and 1, a utton is availa le to write a reply:
Page 10 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
Unread/not
replied
Read
Toggles etween
sent and received
messages

NMP – User Guide, Version 3.00
The screen looks like this when writing a new reply. From the quick message menu, it is
possi le to select predefined messages.
Page 11 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
Shows a list of
predefined
messages.
Field to write the
message in

NMP – User Guide, Version 3.00
Stop menu
The stop menu shows a list of the stops. When the RTCU deletes stops, the stop utton will
flash until this menu is accessed.
Clicking a stop will mark it as read and make it possi le to activate, delete and mark it as
done.
Page 12 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
Read stop
Done stop
Active stop
Distance to stop
(straight line)
Unread stop
Unread stop
Delete stop Mark as
done/not done
Navigate to
stop

NMP – User Guide, Version 3.00
When clicking Drive, the route will e calculated and the stop marked active. Once the route
has een calculated, it will e shown. Click the “Done” utton to dismiss the preview.
The “Details” utton makes it posi le to disa le some types of road (toll road, motorway etc.)
and see the progress of the route.
Page 13 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
Mobile Data Terminal menu
The MDT provides the same uttons and display size as the MDT-200.
The utton to show the MDT menu is only visi le when the RTCU unit has activated it with
mdtPower(power:=on)3.
Clicking the MDT utton on the Main menu sends the PowerUP key to the RTCU, which can
then decide to show the MDT y calling mdtStandby(enable := alse). Similarly, when
the ack utton is pressed, the RTCU receives mdtGetKey = 126 (Power key), and can then
hide the MDT menu with mdtStandby(enable :=true).
To close the MDT menu and remove the utton, call mdtPower(power:= alse).
3 See Online help, MDT section.
Page 14 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
Turns green when
either text messages
or stops change.

NMP – User Guide, Version 3.00
Updates
The NMP can e updated in two different ways. Remotely via the RTCU device, or locally y
accessing the SD card.
Remote update
The NMP can e updated after it is deployed, y sending the update file through the RTCU
device.
This is done y transferring the update.zip file to the file system of the RTCU, and then
calling the nmpUpdate4 function, which will transfer the file to the NMP device and start the
update. Transferring the update to the NMP device takes a long time due to the connection
speed.
SD Card update
With physical access to the NMP, it is possi le to update directly via the SD card, providing a
faster transfer speed. To perform an update, remove the SD card from the device, place the
update.zip and update.xml files in the NMP folder on the SD card, reinsert the card and
start the NMP device.
Update process
Once the update has een transferred to the NMP, it will either ask the user if it should e
installed, or install it immediately, depending on the type of update. If the update is postponed
or is interrupted, it will try to install it again the next time the NMP starts.
4 See Online help, nmpUpdate and nmpUpdateProgressReceive.
Page 15 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
To perform the update, the navigation application shuts down, closing communication with
the RTCU unit. Instead an update program runs through several steps efore showing the
result of the update. The device will restart after a moment, or it can e restarted manually.
Page 16 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
How to configure the NMP
By removing the SD card from the device and inserting it in a PC, it is possi le to configure
certain features of the device. Make sure to make a ackup efore making any changes to e
a le to restore it to a known state. Note that the license for the navigation maps is located on
the SD card, and can not e transferred to another card, as it is tied to the SD card.
Settings
The settings of the NMP are all stored in the file \SD Card\NMP\settings.xml.
To generate a file with the default settings, simply delete the existing settings.xml and run
the program to generate a new file with most of the defaults included.
To avoid having to set all the settings, it is possi le to only specify a small su set, and then
use the defaults for the rest.
To e.g. change the aud rate, the following settings.xml file is enough:
Basi devi e onfiguration
The following settings are used, when no device specific settings are defined.
<Port> Serial port on the NMP device that the RTCU is connected to.
<Baud> Determines the aud rate to use when communicating with the
RTCU. It must match the aud rate of the RTCU. The default
value, which is compati le with older RTCU firmware, is 9600
aud. The maximum suggested value is 57600 aud.
<drivePath> Path to the Drive application.
Devi e spe ifi settings
As a new thing in v2.00, it is now possi le to define some settings for specific devices. This
makes it possi le to use the same configuration for multiple devices. By default, the
definitions for the PNM-100 and the PNM-200 devices are included.
The device specific settings are placed under the element <Device>. This element has the
attri utes id, which must e set to the ID of the device, and the optional attri ute name, which
is only used for descri ing the device. To get the ID of the device, see Pro ing the device on
page 27.
The <Device> element contains the following elements. If an element is not set, the defaults
specified in the generic elements will e used instead.
<Port> Serial port
<Baud> Baud rate of the connection to the RTCU.
Page 17 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com
<?xml version="1.0"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Baud>57600</Baud>
</Settings>

NMP – User Guide, Version 3.00
<SdCardName> Physical name of SD card drive. Must e the Physical name, as
seen in the Storage manager, for instance DSK1. If this is not
correct, the licenses for the maps will not work. If this is omitted,
no changes will e made, and the current settings will e used.
<drivePath> Path to the Drive application.
<deviceId> Optional id for use with custom devices. A value etween 0 and
15, that is added to 0x100 to ecome the actual device ID5. Is not
used on official devices.
Fun tionality
<DisconnectShutdown> O soleted. Use DisconnectTimeout instead.
<DisconnectTimeout> Timeout in seconds, when connection is lost or never
esta lished. When this times out, a dialog will ask to shut down,
with a timeout of 30 seconds.
Set to -1 for default, 0 disa led. Defaults to 3 minutes on
PNM220, disa led on all other.
If nmpPower is ena led, the device may choose to re oot
instead, to attempt to restore the connection.
<HideTaskBar> Hides the task ar and makes the application topmost. Should e
true unless access to the underlying Windows CE device is
needed.
<ClearRouteWhenDone> Determines if the route is removed from the map once the
destination has een reached.
<OnlyButtonsOnMain> Determines if the custom uttons will e shown on all views or
only the navigation/map view.
<dbPath> Path to data ase file for storing all the data. Should not e
changed.
<DatabasePass> Password used to encrypt the data. Should not e changed.
Menu buttons
The following settings controls the visi ility of the uttons in the menu ar.
<ShowDrivers> Determines if the Driver utton is visi le. If hidden,
functionality needing this utton should not e used.
<ShowMsg> Determines if the Message utton is visi le. If hidden,
functionality needing this utton should not e used.
<ShowStops> Determines if the Stop utton is visi le. If hidden, functionality
needing this utton should not e used.
5 See nmpGetHardwareId in the on-line help
Page 18 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
<ShowMDT> Determines if the MDT utton is visi le. If hidden, the MDT can
only e shown from the RTCU unit.
<NavMenu> Shows a utton similar to the driver, message, stop etc. uttons,
to access the navigation screen. If this is ena led, the dedicated
ack utton will e removed, as the navigation screen is
considered on the same level as the rest. If ShowExit is ena led,
the menu utton will e the exit utton, when on the navigation
screen.
<AutoShowMenu> If true, hidden menu uttons will e shown if needed. If e.g. the
Message menu is disa led with ShowMsg and a message is
received, it will e made visi le.
Hiding buttons
The element <HideButtons> makes it possi le to hide some of the uttons and there y
disa ling some features.
The <HideButtons> tag contains a num er of <HideButton> tags, containing a utton and a
hide attri ute:
<HideButtons>
<HideButton button="stops.done" hide="true"/>
</HideButtons>
If hide is false, the utton is not hidden.
See the following ta le for a list of possi le utton names.
Name Des ription
msg.delete Delete message.
msg.reply Reply to message.
msg.ok Ok reply.
msg.yes Yes reply.
msg.no No reply.
msg.deleteall Delete all messages.
stops.done Mark destination as done.
stops.drive Drive to destination.
stops.delete Delete destination.
stops.deleteall Delete all destinations.
user.clear Clear driver.
Page 19 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com

NMP – User Guide, Version 3.00
Sound settings
<PlaySounds> The value of the child tags determines if sounds will e played
when the following events occurs:
<OnMsgDelete> A message has een deleted y the RTCU.
<OnMsgReceived> A message has een deleted y the RTCU.
<OnStopDelete> A stop has een deleted y the RTCU.
<OnStopReceived> A stop has een received y the RTCU.
<Volume> Determines the system volume used during startup. Value
etween 0 and 100, where 0 is off and 100 is highest volume.
<HighSpeedThreshold> Determines the speed at which to use the highest sound volume.
The volume levels are ased on the settings in the Sygic menus
and varies with the speed.
Hiding menus
The following settings defines settings related to the hiding of the menu and utton ars.
<MenuWidth> Width of the menu when not collapsed.
<MenuCollapsedWidth> Width of the menu when it is collapsed. The width of the
connection icon is 32 pixels.
<ButtonsHeight> Height of the configura le uttons when not collapsed.
<ButtonsCollapsedHeig
ht> Height of the panel with the configura le uttons when it is
collapsed.
<ButtonsHideWidth> Width of the utton to hide the configura le uttons.
<CanHideButtons> Determines if it is possi le to hide the configura le uttons y
pressing a utton. If false, the hide utton is not visi le. It is
always possi le to use nmpHideMenus to hide it from the
RTCU.
<CanHideMenu> Determines if it is possi le to hide the menu y pressing a
utton. If false, the hide utton is not visi le. It is always
possi le to use nmpHideMenus to hide it from the RTCU.
Debug
The following settings are used for de ugging the device.
<LogFolder> Determines where the de ug logs are stored.
<LogComm> Determines if the communication with the RTCU is logged.
Should not e ena led under normal circumstances.
<LogDebug> Determines if de ug output is logged. Should not e ena led
under normal circumstances.
<ShowExit> Displays utton in the main menu to exit to the operating system.
Page 20 of 28
Logic IO Aps Ph: ([phone]
Holm oes Allé 14 Fax: [phone]
8700 Horsens Email: [email protected]
Denmark www.logicio.com