CM11 Immediate Commands

Use the -i command line option to send a command to the CM11A to be executed immediately:

cm11 -i "ON A2"			turns on module A2
cm11 -i "DIM:10 A1" 		dims module A1 down 10%
cm11 -i "BRIGHT:10 A1"         	brightens module A1 up 10%
cm11 -i "DIMTO:30 A1"   	dims/brightens A1 to absolute 30%
				(0% = full bright, 100% = off)
You can send multiple X10 commands on one line:
cm11 -i "ON A1" "OFF A2" "DIM:30 B2"
You can send a set of commands from a file for immediate execution:
cm11 -i - < file.cm11
where file.cm11 is a text file with one cm11 command on each line.

Commands are optionally postfixed with a colon and a percentage value (for DIM, DIMTO, BRIGHT commands) or three bytes of extended data (for EXTC and EXTD commands), and are followed by whitespace and one or more UNITS (separated by commas and NO whitespace), all of which must be on the same housecode.

If no value is specified for DIM or BRIGHT, 6% is used. (This is the same as is sent by a single click on the DIM or BRIGHT button on a mini-controller.) A value must be specified for DIMTO, EXTC, and EXTD commands.

The available commands are:
name means example usage
ALLOFF ALL units OFF (ALLOFF A1 or ALLOFF A)
ALLLON ALL Lights ON (ALLLON A or ALLLON A1)
ON, OFF Turn units ON or OFF (ON A1,A2)
DIM DIM units relatively (DIM:10 A7,A1)
BRIGHT BRIGHTen units relatively (BRIGHT:20 A7,A1)
DIMTO DIM or brighten TO absolute (DIMTO:50 A2,A4,A6)
PREDIM PREset DIM (PREDIM:30 A1)
ALLLOFF ALL Lights OFF (ALLLOFF A or ALLLOFF A1)
EXTC EXTended Code (EXTC:025a03 A1)
EXTD EXTended Data (EXTD:025a03 A1)
HAILREQ HAIL REQuest (HAILREQ A1)
HAILACK HAIL ACKnowlege (HAILACK A2)
STATON STATus response: ON (STATON A1)
STATOFF STATus response: OFF (STATOFF A1)
STATREQ STATus REQuest (STATREQ A2)

The most commonly used commands are ON, OFF, DIM, BRIGHT, and DIMTO. However, the cm11 program includes the full X10 command set to allow you to access any feature of the CM11A from your computer.

PREDIM and DIMTO are effectively the same command from the user's perspective, since they all inform the module to set the brightness/dimness to an absolute level. However, X10 never implemented the PREDIM command in their modules, even though they put it in the protocol. So don't use it. :)

Note that ALLLON and ALLLOFF have three L's in them. They are abbreviations for "ALL Lamps ON" and "ALL Lamps OFF". You probably will want to use aliases to control groups of lamps rather than using ALLLON and ALLLOFF.

EXTC and EXTD are "Extended" sequences that use three bytes of data. X10 has partially documented how the extended commands are being used. The EXTC and EXTD commands are a sort of "low-level" way to get to these commands.

STATREQ, STATON and STATOFF are old 2-way commands for requesting and reporting status. They have been superceded by some extended commands for use with the LM14 and others.

For "normal" modules, a DIMTO command actually turns the module on, BRIGHTens it all the way, and then DIMs down to the level requested. Cm11 includes code so that the DIMTO command is translated into the appropriate LM14 Extended Codes when the target units are identified as LM14's with the EXTDIM command in a symbol file.

In order for cm11 to be able to do this, you specify which UNITs are LM14s using the EXTDIM command in a symbol or macro file.