RP: Set Multible LEDs command: EXP Bus Command Reference¶
Understanding EXP board addressing
This command is used with FAST Expansion and FAST breakout boards via a FAST Serial Protocol (FSP) connection to the EXP Bus. Please read the EXP Overview to understand the operation of these commands and addresses.
This command sets multiple LEDs to be the same target color.
Note that there is also a binary version of this command, RB:
, which might be more appropriate for your use case.
Command Syntax¶
RP:<rgb>,<index>[,<index>...]<cr>
<rgb>¶
RGB color value as a single ASCII hex number, with each channel in the range of 0-255 (binary 0x00
- 0xFF
).
<index>¶
This is the LED number for the LED you want to update. Individual LEDs are accessed via 0-127 (binary 0x00
- 0x7F
) since that's the max LEDs that can be attached to a single breakout board.
New in firmware 0.20:
You can also use mapped LED blocks which you configured via the LM:
command. In this case, all the LEDs in that set will be updated to the same color as if they were a single LED.
If LED maps have previously been created on the expansion board targetted, then LED indexes 80
-FF
correspond to the mapped LED sets.
Example¶
To turn alternating LEDs connected to full red
The command would look like this:
rp:FF0000,00,02,04,06,08,0A,0C<CR>
Breaking it down:
RP:
command nameFF0000
target color of full red00
set LED 002
set LED 204
set LED 406
set LED 608
set LED 80A
set LED 10 (0x0A hex)0C
set LED 12 (0x0C hex)<CR>
at the end
If you have a global fade rate set (via a previously-sent RF:
command for the board the LEDs are attached to), then the LEDs will fade to the target color over that time.
Return Response¶
None
N or > jump the next page, P or < for previous, search with S or ?