Command Text Feature Pseudo-Code

void ACTION(char[ ] arg)

  • The Feature takes one array of characters as argument.
  • The Feature do not return anything.
  • The ACTION is performed on target.


Command Text Panel



Command Text Macro

Description:

Macro

Identifier

Displayed Name

Function Identifier

Group*

Max Length


Example:

define_text_command(

cmdSetMsgOnDisplay,

"Set Msg On Display",

SetMsgOnDisplay,

12 ,

32

);


*optional argument. If Group is omitted the Group-Number will default to 0.

The unique message id is derived from the row number, in source file where the macro is used.



Command Text XML Definition

Description

XML

Feature Root: Start

<F>

Command Text: Start

<Ct>

ID

<I>BYTE</I>

SUB ID

<Is>BYTE</Is>

GROUP

<Gr>BYTE</Gr>

NAME

<N>STRING</N>

Maximum number of characters

<Mx>INT</Mx>

Command Text: End

</Ct>

Feature Root: End

</F>




Command Text Data Message

The text value is of format: UTF-8

The text is of arbitrary length and don't require any END-OF-STRING (0) character.


Byte#

0

1

2

3 .. N-3

N-2

N-1

N

Name

START

ID

SUB ID

TEXT

CRC MSB

CRC LSB

END

Value

0xAA

[0..255]

[0..255]

UTF-8

CRC16-CITT

0xBB