5.2.1.4.6 Terminal

The ADP example sets up a terminal module that looks something like the screenshot below.

: The appearance of screenshots will vary with operating system version and configuration.

The terminal module is configured by the messages detailed in the tables below.

First, a stream is set up to send terminal data to the host computer.

Table 5-37. MSG_CONF_STREAM
FieldValuesDescription
Token0xFF
Message ID0x20
Data length21
ID0x0000
Type2UINT_8 stream
Mode2Outgoing stream (out from target)
State

0

Stream state ON
Label“Status messages\0”Label of the data stream

Next, the terminal itself is configured.

Table 5-38. MSG_CONF_TERMINAL
FieldValuesDescription
Token0xFF
Message ID0x26
Data length26
ID0x0000ID of terminal
Label“Status terminal\0”Terminal label
Width80Number of characters wide
Height50Number of lines high
Background color0xFFFFFF (transmitted as 0xFFFFFFFFFFFF as each 0xFF character must be transmitted as 0xFFFF, see Message Format)RGB background color
Foreground color0x008000RGB foreground color

Finally, the data stream is connected to the terminal module.

Table 5-39. MSG_CONF_ADD_TO_TERMINAL
FieldValuesDescription
Token0xFF
Message ID0x27
Data length27
Terminal ID0x0000ID of terminal
Stream ID0x0000ID of stream
Mode0xFF (transmitted as 0xFFFF as each 0xFF character must be transmitted as 0xFFFF, see Message Format)
  • Implicit newline in incoming text = ON
Text color0x000000RGB color of the text stream received
Tag text“Status messages\0”
Tag text color0x000000RGB color of the tag text