Skip to content

spec ws2812 write n pixels

Ken Sharp edited this page Dec 10, 2025 · 2 revisions

WS2812 Write N Pixels

Set the RGB color of a range WS2812 pixels.

Command Packet

WS2812 Write a range of pixels
Description Set the RGB color of a range of WS2812 pixels.
Size Variable
Format 0 1 2 3 4 5 6 7 8 9 10 11 12
7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0
SoF : 0xFF PACKET SIZE PACKET NUM CMD : 0x0162 START PIXEL INDEX NUM PIXELS REFRESH ~RGB COLORS CHECKSUM
SoF Start of Frame. Always 0xFF.
PACKET SIZE Packet Size In Bytes
PACKET NUM The Current Packet Number. This value increments with each new packet.
CMD WS2812 Write All Pixels Command
START PIXEL INDEX Index of first pixel in range.
NUM PIXELS Number of pixels to write.
REFRESH 0 = Do Not Refresh LEDs, new color value is stored in memory but no visible change is made | 1 = Refresh LEDs, new value is stored in memory and all LEDs update
~RGB COLORS Byte Array of G, R, B values for each pixel in range.
CHECKSUM Checksum. Computed by adding all of the bytes in the packet in U8 form ignoring rollover.

Response Packet

WS2812 Write N Pixels Response
Description LINX device's response to WS2812 Write N Pixels command
Size 6 Bytes
Format 0 1 2 3 4 5
7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0
SoF : 0xFF PACKET SIZE PACKET NUM STATUS CHECKSUM
SoF Start of Frame. Always 0xFF.
PACKET SIZE Total packet size in bytes.
PACKET NUM The packet number of the packet that generated the response.
STATUS See Return Status section below.
CHECKSUM Checksum. Computed by adding all of the bytes in the packet in U8 form ignoring rollover.

Return Status

No function specific statuses. See Return Status for universal return statuses.

Related Links

LINX

Clone this wiki locally