User manual

TCP/IP communication 104
© 2016 ... MapFactor s.r.o.
17 TCP/IP communication
TCP/IP communication can be used for remote messaging with and control of navigator based
products - for example as a solution for communication between driver and controller. It can also be
used for integration with third party software.
-----------------------------------------------------------------------------------------------------
TCP/IP commands:
Every command starts with '$' and ends with '\n' or "\r\n".
DISPLAY A TEXT MESSAGE
Format:
$message="message";instant
Description:
- shows a message on remote device
Protocol version:
- 1.0.0 or later
- 2.0.3 or later for "instant parameter"
Availability:
- tcp/ip or com
Parameters:
- parameter is a text enclosed in quotation marks to display on remote device
- when parameter "instant" is used the message is shown immediatelly; placeholder icon is displayed
otherwise
Return values:
- "ok" on success or "error" when failed
- "busy" when the remote device is busy responding to another command
DISPLAY A QUESTION
Format:
$message="message";ask;instant
Description:
- shows a question on remote device (can be answered with "yes" or "no)
Protocol version:
- 1.0.0 or later
- 2.0.3 or later for "instant parameter"
Availability:
- tcp/ip or com
Parameters:
- parameter is a text enclosed in quotation marks to display on remote device
- when parameter "instant" is used the message is shown immediatelly; placeholder icon is displayed
otherwise
Return values:
- "yes" or "no" as the answer to question on success or "error" when failed
- "busy" when the remote device is busy responding to another command
DISPLAY A CHAT MESSAGE
Format:
$chat="message"
Description:
- sends a new message to chat window
Protocol version:
- 2.0.0 or later
Availability:
- tcp/ip or com