Jump to Macro

by index:

\i O J byte::macro_index

Parameter	Type	Range	Description
macro_index	word	0 ... max. macro index	index of the macro to jump to

by name:

\i O J by_name::macro_name

Parameter	Type	Range	Description
macro_name	by_name	ASCII chars (0x01 .. 0xFF)	0-terminated macro name

Jumps to the macro referred by macro_index or macro_name. Macros executed with this command will be interrupted by a new command sent via any interface as well as touch and keyboard events.

Note

If the macro does not exist or one of the called commands returns an error, [NACK] is returned.
When the macro is fully executed, an [ACK] is sent. When called within another macro, execution does not return to the calling macro.
When addressing by index, the macro offset (see Set Macro Offset) is taken into account.
When addressing by name, the macro prefix (refer to Set Macro Name Prefix) and suffix (refer to Set Macro Name Suffix) are taken into account.
Using this command is useful at the end of a macro to branch to the beginning of the current or another macro for building endless loops, as this command does not use the macro stack.

Response:

[ACK]

Example

\iOJ\D5

Jumps to the macro with index 5.