View Categories

Luxafor Signal AT Command Reference

Command Set v1.0

1. Introduction #

The Luxafor Signal device is controlled through a text-based AT command interface. Commands can be sent over any of the following channels:

  • USB CDC – virtual serial port over USB (TinyUSB CDC-ACM).
  • Cloud WebSocket – commands relayed through the cloud server connection.
  • Local HTTP server – commands submitted through the device’s local REST endpoint (available in AP and STA modes).

1.1 Command Format #

Each command is an ASCII string terminated by a carriage return / line feed. Commands that take parameters use the = form:

AT+<NAME>                Execute / action command 
AT+<NAME>?               Query ( get ) command 
AT+<NAME>=<params>       Set command , parameters separated by commas

1.2 Responses #

file YbdjPukbQj

file tmMFfRIp5P

 

2. General Commands #

file

 

3. Device Information Commands #

file CbND79iMzB

 

4. File and Storage Commands #

file Ieyn4QEYhz

file sP3H0qbNan

 

5. LED Commands #

The device has 12 addressable RGB LEDs. LED commands select LEDs with a decimal bit mask, <led_pins>: bit 0 (value 1) is LED 1 and bit 11 (value 2048) is LED 12, so 4095 selects all 12 LEDs. LEDs 1–6 (mask 63) form the right half and LEDs 7–12 (mask 4032) the left half. Bit 12 (value 4096) is a clear-others modifier: when set, every LED not selected by the mask is switched off (solid color) or reset to the background color (pattern step); when clear, unselected LEDs keep their current color. Colors are always six hex digits, RRGGBB.

file U2k38mnshA

5.1. Pattern Step Format #

A custom pattern is a list of up to 40 steps. Each step is one line:

+CP:<led_bits>, <RRGGBB>, <speed>, <delay> 
  • <led_pins> – LED bit mask as described above. Add 4096 to reset all unselected LEDs to the background color (used for running-light effects).
  • <RRGGBB>  – target color of the selected LEDs.
  • <speed> – fade rate from the previous color. 0 is effectively instant (about 13 ms for a full 0–255 change); every increment adds about 13 ms to a full-range fade (10 ≈ 140 ms, 80 ≈ 1 s, 150 ≈ 1.9 s).
  • <delay> – minimum hold time of the step in milliseconds, counted from the start of the step. The next step begins once both the fade has finished and the delay has elapsed; 0 advances as soon as the fade completes

The step sequence plays from the first to the last line and then repeats according to the AT+PP= repeat count.

5.2. Built-in Patterns #

file cuhWqZzkgh

 

6. Audio Commands #

file

 

7. Wi-Fi Commands #

file C7OiVVop7u

file mEd49jylnA

 

8. Local Server Commands #

file 9JjqQokLkT

file QkBsNnTI6H

 

9. Error Codes #

Failed commands reply with ERROR:<code>. The last error code can also be read back with AT+GLEC.

file 0LRTh3cv0h

 

10. Examples #

10.1 Basic Device Query #

AT
OK
AT+GDN
+DN: luxafor_signal-3F2A1B
AT+GFV
+FV:1.0 

10.2 Connecting to a Wi-Fi Network #

AT+WSCAN=
OK
AT+WSCAN?
+WSCAN:2
+WSCAN:HomeNetwork,6,-52,WPA2
+WSCAN:Neighbor,11,-78,WPA/WPA2
OK
AT+STA=HomeNetwork,secretpassword
OK
AT+WM=1
OK
AT+STA?
+STA:1,HomeNetwork,192.168.1.42,-51

10.3 Setting a Solid Color #

AT+SC=63,FF8000
OK
AT+SC?
+SC:63,FF8000
AT + SC =4097 ,0000 FF
OK

The last command lights LED 1 blue and switches every other LED off (mask 1 + clear others bit 4096).

10.4 Playing a Light Pattern #

AT+DP=0
OK
AT+PP=1,255
OK
AT+PP?
+PP:1,255
AT+PP=0,1
OK
AT+CPD=+CP:4095,FF0000,5,10\r\n+CP:4095,000000,5,10
OK
AT+PP=1,5
OK 

10.5 Playing an MP3 File #

AT+GML
+ML:notify.mp3,48213
OK
AT+VOL=80
OK
AT+PLAY=notify.mp3,2
OK
AT+PLAY?
+PLAY:notify.mp3,1,2,1 
Updated on 17/11/2026

What are your feelings

  • Happy
  • Normal
  • Sad