|ASCII - Command||M||For Manufacturer Use only|
|Syntax Transmit||M [Data]|
|Syntax Receive||M <Data>||Available in|
|ASCII Format||String||CANBus Object Number||No|
|Opmode||All||Data Type Bus/DPR||-|
|Configuration||No||Last Change of this Object||1.3|
|Short Description||Read/write Macro Variable|
|The M command can be used to access any internal macro variable.
Macro variables are variables which can be used by the macro routines. They are called by name within a macro routine. The complete variable information (name, address) is managed in the form of a table. There are two types of macro variable.
1. System variables – these variables are determined by the firmware, and are fixed. Both the names and the addresses for such variables are constant within a given firmware version. The table with the data for the variables is within the programming area, so that the system variables can be accessed at any time.
2. User variables – these variables are set up in the macro routines during the initialization phase of the amplifier. The availability of a specific variable, or its physical address, depends on the amplifier configuration. The table with the information for the variables is set up in the RAM, and is normally only required during the compilation of the macro programs (initialization phase). After the initialization has been concluded, the table is removed from the memory. In this case, it is not possible to access the user variables through the M command.
If the parameter setting MSG=2 is found when the amplifier is switched on, then the table for the user variables is kept in the memory. In this case, it will also be possible to access the user variables through the M command.
The M command can be used in one of three forms:
1. “M” – a list of all the system and user variables is generated
2. “M name” – an information line is generated for the variable <name>, in the following form:
“name [TYPE] address FORMAT=value”
The individual elements are interpreted as follows:
name = name of the macro variable
TYPE = variable type (SYSTEM or USER)
address = physical address of the variable (hexadecimal format)
FORMAT = variable type (BYTE,WORD,LONG,STRING), the suffix FAST means that the variable is stored in the internal (fast) RAM
Value = variable contents (in hexadecimal format, or as ASCII string, depending on FORMAT)
3. “M name value” – the number “value” is entered in the variable “name”
The entry for “value” must be made as a decimal number. If the character sequence “0x” is added as a prefix, the number can be entered in hexadecimal format.