ws2816.h

Go to the documentation of this file.

#pragma once

 
#include "fl/stl/stdint.h"
#include "fl/stl/noexcept.h"
#include "fl/stl/array.h"
#include "fl/stl/pair.h"
 
namespace fl {
 
// NOTE: The old loadAndScale_WS2816_HD<RGB_ORDER>() function has been removed.
// RGB reordering now happens upstream via ScaledPixelIteratorRGB16 adapter.
// The encoder receives wire-ordered 16-bit RGB data (fl::array<u16, 3>).
// For backward compatibility, WS2816Controller in chipsets.h still uses the
// old pattern temporarily - it will be updated to use the new iterator pattern.

inline pair<CRGB, CRGB> packWS2816Pixel(u16 s0, u16 s1, u16 s2) FL_NO_EXCEPT {
    // Split each 16-bit channel into high/low bytes
    u8 b0_hi = s0 >> 8;
    u8 b0_lo = s0 & 0xFF;
    u8 b1_hi = s1 >> 8;
    u8 b1_lo = s1 & 0xFF;
    u8 b2_hi = s2 >> 8;
    u8 b2_lo = s2 & 0xFF;
 
    // Pack into two CRGB pixels: [R_hi, R_lo, G_hi] and [G_lo, B_hi, B_lo]
    return make_pair(
        CRGB(b0_hi, b0_lo, b1_hi),
        CRGB(b1_lo, b2_hi, b2_lo)
    );
}

template <typename InputIterator, typename OutputIterator>
void encodeWS2816(InputIterator first, InputIterator last, OutputIterator out) FL_NO_EXCEPT {
    while (first != last) {
        // Get 16-bit RGB in wire order (already scaled, color-corrected, brightness-adjusted)
        const array<u16, 3>& rgb16 = *first;
        u16 s0 = rgb16[0];
        u16 s1 = rgb16[1];
        u16 s2 = rgb16[2];
 
        // Use the packing helper function
        pair<CRGB, CRGB> packed = packWS2816Pixel(s0, s1, s2);
        *out++ = packed.first;
        *out++ = packed.second;
 
        ++first;
    }
}
 
} // namespace fl