Editing Digital Addressable Lighting Interface (section)

==Commands for control gear==
Forward frames sent to control gear are 16 bits long, comprising an address byte followed by an opcode byte.  The address byte specifies a target device or a ''special command'' addressed to all devices.

Except for special commands, when addressing a device, the 7 most significant bits is the device address.  The least significant bit of the address byte specifies the interpretation of the opcode byte, with "0" meaning that the opcode is a light level (ARC), and "1" meaning that the opcode is a command.

Multi packet commands are used for more complex tasks - like setting RGB colors.  These commands use three "data transfer registers"  (DTR, DTR1, DTR2 ) which can be read and written or used as a parameter by subsequent commands.  For example, copy the current ARC level to DTR, save DTR as a scene.  Evidently, the DTR value can be different in different devices.

Address byte (AB) format:
* <code>0AAA AAAS</code>: Target device 0 ≤ A < 64.
* <code>100A AAAS</code>: Target group 0 ≤ A < 16.  Each control gear may be a member of any or all groups.
* <code>1111 110S</code>: Broadcast unaddressed
* <code>1111 111S</code>: Broadcast
* <code>1010 0000 to 1100 1011</code>: Special commands
* <code>1100 1100 to 1111 1011</code>: Reserved

Common control gear commands:<ref>[https://webstore.iec.ch/searchform&q=62386-102 IEC 62386-102]</ref><ref>{{Cite web|url=http://www.rayzig.com/manual/rayzig.html?112DALIcommands.html|title=Rayzig version 2.207|access-date=13 November 2020|archive-date=13 November 2020|archive-url=https://web.archive.org/web/20201113182940/http://www.rayzig.com/manual/rayzig.html?112DALIcommands.html|url-status=dead}}</ref><ref>https://www.nxp.com/files-static/microcontrollers/doc/ref_manual/DRM004.pdf {{Webarchive|url=https://web.archive.org/web/20201113152849/https://www.nxp.com/files-static/microcontrollers/doc/ref_manual/DRM004.pdf |date=13 November 2020 }} {{Bare URL PDF|date=March 2022}}</ref>
{| class="wikitable collapsible  sortable"
! Value (Hex) !!Command !! Description !! Answer
|-
| ||'''Control commands''' || ||
|-
| AB || DAPC (level) || Sets targetLevel (0-254) to device(s) at address AB using the current fade time, or stops a running fade (255). <span style="color:red">[S bit must be 0]</span>||
|-
| 00 || OFF || Set targetLevel to 0 without fading||
|-
| 01 || UP || Starts or continues a fade up for 200ms at the current fade rate||
|-
| 02 || DOWN || Starts or continues a fade down for 200ms at the current fade rate||
|-
| 03 || STEP UP || Increments targetLevel by 1 without fading||
|-
| 04 || STEP DOWN || Decrements targetLevel by 1 without fading||
|-
| 05 || RECALL MAX LEVEL || Set targetLevel to MAX level without fading||
|-
| 06 || RECALL MIN LEVEL || Set targetLevel to MIN level without fading||
|-
| 07 || STEP DOWN AND OFF || Decrements targetLevel by 1 without fading, turning off if already at MIN level||
|-
| 08 || ON AND STEP UP || Increments targetLevel by 1 without fading, turning on to MIN level if currently off||
|-
| 09 || GO TO LAST ACTIVE LEVEL || Sets targetLevel to the last active (non-zero) level, using the current fade time.||
|-
| 10+s || GO TO SCENE (sceneNumber) || Sets targetLevel to the value stored in scene sceneNumber, using the current fade time, or no change if the value stored in the scene is 255.||
|-
| ||'''Configuration commands''' || ||
|-
| 20 || RESET || Changes all variables to their reset values.||
|-
| 21 || STORE ACTUAL LEVEL IN DTR0 || Stores the actualLevel (light output level) in register DTR0||
|-
| || IDENTIFY DEVICE || Starts a temporary identification process such as flashing the lamps, making a sound or transmitting an RF beacon.||
|-
| 2A|| SET MAX LEVEL (DTR0) || Changes maxLevel level to DTR0||
|-
| 2B|| SET MIN LEVEL (DTR0) || Changes minLevel level to DTR0||
|-
| 2C|| SET SYSTEM FAILURE LEVEL (DTR0) || Changes systemFailureLevel to DTR0 ||
|-
| 2D|| SET POWER ON LEVEL (DTR0) || Changes powerOnLevel to DTR0 ||
|-
| 2E|| SET FADE TIME (DTR0) || Changes fadeTime to DTR0||
|-
| 2F|| SET FADE RATE (DTR0) || Changes fadeRate to DTR0||
|-
| || SET EXTENDED FADE TIME (DTR0) || Changes the two 4-bit variables extendedFadeTimeMultiplier:extendedFadeTimeBase to DTR0||
|-
| 40+s|| SET SCENE (DTR0, sceneX) || Changes sceneX to the value DTR0||
|-
| 60+g|| ADD TO GROUP (group)  || Adds the control gear into the specified group||
|-
| ||'''Query commands''' || ||
|-
| 90|| QUERY STATUS || Asks the control gear for the current status. Reply bits: 0=controlGearFailure; 1=lampFailure; 2=lampOn; 3=limitError; 4=fadeRunning; 5=resetState; 6=shortAddress is MASK; 7=powerCycleSeen||XX
|-
| 92|| QUERY LAMP FAILURE || Asks the control gear if it is currently detecting a lamp failure|| Yes/No
|-
| A0|| QUERY ACTUAL LEVEL || Asks the control gear what the current actualLevel (output level) is|| XX
|}