Commands for Multi Channel LED Controller

 

RGB-W Controller for up to 1024 channels


Interface: USB (Serial converter) or Serial Port

Settings: 19200 Bd, No Parity, 8 Databits, 2 Stopbits

Single Channel Command for setting each colour and brightness of each LED.
Circle Command for special circular effects.
Group Commands for setting user definable groups of  LEDs with a single command.


1. Single LED Color Command

Command consists of 3-Bytes

Byte 1 = Colour   :  '1' = Red  , '2' = Green , '3' = Blue , '4' = White
Byte 2 = LED No/Position  (0..255)
Byte 3 = Brightness :  0 = Off , 255 = Maximum brightness

Note:     Byte 1 is ASCII 1..9  , i.e. 30..39 hex  or  48..57 decimal
    Byte 2,3 are binary

Example:   '2' 88 128    :     Set  Green of LED No 88  to  50% brightness



2. Circle Command

Command consists of 8-Bytes

Byte 1 = 'C'
Byte 2 = LED No/Position      (0..255) of the LED in the Center of the Circle
Byte 3 = Colour   :          '1' = Red  , '2' = Green , '3' = Blue Blue , '4' = White
Byte 4 = Brightness :      0 = Off , 255 = Maximum brightness
Byte 5 = Radius Start :     0..255  (Steps of 2mm --> 100 resembles 20cm)
Byte 6 = Radius End :      0..255   
Byte 7 = Angel Start :      0..255   resembles  0..359°
Byte 8 = Angel End :      0..255   

Note:     Byte 1 and 3 are ASCII ,   2 , 4, .. 8  are binary

Example:   'C' 55 '1' 25 0 25 0 64    :     
Set  Red to 10% Brightness for all LED's with distance 0..5cm and angle 0..90°
with respect to LED No 55

 
3. Group Commands

Command consists of 3-Bytes

Byte 1 =  'G'
Byte 2 = Group No :  '0' .. '9' .. 'z'   
Byte 3 = Brightness :  0 = Off , 255 = Maximum brightness

Note:     Byte 1,2 are ASCII ,    Byte 3 is binary

Example:   'G5'  255    :     Set  all LED's of group 5  to full brightness

3.1. Special Groups:  R  ,  G  ,  B  and W

There are some groups , that are common to all LEDs and can not be changed.

'GR' xx         : Red colour of all LEDs is set to brightness xx
'GG' xx        : Green       "            "
'GB' xx        : Blue           "            "
'GW' xx        : White    "            "


Examples:
'GW' 255 , (pause),  'GW' 0 (pause) ,  'GW' 255 , (pause),  'GW' 0 (pause) …
                    gives a stroboscope effect
'GR' 50  'GB' 50    : Set all LEDs to violet with ca. 20% brightness

'GW' 0                : Shut off all LEDs

3.2. Setting / Configuration of a Group

Defines, which colours of which LED belong to the same group.
Command consists of 4-Bytes

Byte 1 =  'S'
Byte 2 = Group No :  '0' .. '9' .. 'z'   
Byte 3 = LED No/Position  (0..255)
Byte 4 = Binary mask or colours   (Red is bit 0 … White is bit 3)

Note:     Byte 1,2 are ASCII ,    Byte 3,4 are binary

Example:   
'S7'  88  b'00000101'        Assigns Colour 1 and 3 (Red + Blue)  of  LED 88 to group 7

This command must be sent for each LED of  a group.

A colour of a LED can belong to different groups.
More colours of a LED can belong to the same group.
 
3.3. Writing Group-Data into EEPROM

1. Erase all EEPROM data by sending the command     ‘SWR0’

2. Send all Group data as described in 3.2.

3. Send the EEPROM save command   ‘SWRE’