User Manual

MCP1 Remote Control Protocol Specifications V1.0.0
6
3. Command Specifications
3.1. Basic Command Specifications
Below is the syntax of commands exchanged between a device and remote controller.
<command name> <option 1> <option 2> . . . <option n> <new line>
- Each command must end with LF (0x0A).
- LF (0x0A) code can be sent as a heart-beat command.
- At least one space is necessary between a command name and an option and between options.
- Commands must be expressed using ASCII characters. Other characters are not allowed.
3.2. Commands a Device Sends to a Remote Controller
3.2.1. Device status change notification
1-1) Device run mode notification
Command Option 1 Option 2 Description
NOTIFY devstatus runmode “emergency” Emergency run mode
“update” Update mode
“normal” Normal run mode
Example: Notification: NOTIFY devstatus runmode “normal”
Meaning: The run mode was changed to normal mode.
1-2) Device error status notification
Command Option 1 Option 2 Description
NOTIFY devstatus error “flt/xxxx” Alert fault information
“err/xxxx” Alert error information
“wrn/xxxx” Alert warning information
Details: “flt/xxxx” = “flt/message// xnnn onf (sssss) ID-xxx 2012/12/31 23:59:59”
“err/xxxx” = “err/message// xnnn onf (sssss) ID-xxx 2012/12/31 23:59:59”
“wrn/xxxx” = “wrn/message// xnnn onf (sssss) ID-xxx 2012/12/31 23:59:59”
The first three characters indicate the alert type.
message = Alert message (The section from “/” to “//” after the alert type is the message data.)
. . . up to 32 characters (ascii characters)
nnn = Alert number (panel display number)
. . . 2 or 3 digit hexadecimal notation (The x at the front indicates hexadecimal notation.)
onf = Alert on/off
. . . Persistent alerts turn on when an alert condition occurs and turn off when they are cleared.
Single-shot alerts turn on while an alert condition is true.
sssss = Identical alert count (a counter that indicates the number of identical alerts, normally set to 1)
. . . Decimal notation
xxx = UNIT ID number . . . 3-digit hexadecimal
Date
Time
Example: Notification: NOTIFY devstatus error “err/DCP[0] communication error// x53 on (1) ID-001 2013/1/22 11:38:23”
Meaning: Error alert 53 occurred.
3.2.2. Preset change notification
1-3) Current preset number change notification
Command Option 1 Description
NOTIFY sscurrent (index) Current preset number change notification
Details: (index) = Current preset index number
Example: Notification: NOTIFY sscurrent 10
Meaning: The current preset was changed to index 10 (preset 10).