p9813.h

Go to the documentation of this file.

#pragma once
 
#include "pixeltypes.h"
#include "fl/stl/compiler_control.h"
#include "pixel_iterator.h"
#include "crgb.h"
#include "eorder.h"
#include "platforms/spi_output_template.h"
#include "fl/stl/noexcept.h"
 
FL_DISABLE_WARNING_PUSH
FL_DISABLE_WARNING_DEPRECATED_REGISTER

//
// P9813 definition - takes data/clock/select pin values (N.B. should take an SPI definition?)
//

template <int DATA_PIN, fl::u8 CLOCK_PIN, EOrder RGB_ORDER = RGB, fl::u32 SPI_SPEED = DATA_RATE_MHZ(10)>
class P9813Controller : public CPixelLEDController<RGB_ORDER> {
    typedef fl::SPIOutput<DATA_PIN, CLOCK_PIN, SPI_SPEED> SPI;
    SPI mSPI;
 
    void writeBoundary() FL_NO_EXCEPT { mSPI.writeWord(0); mSPI.writeWord(0); }
 
    FASTLED_FORCE_INLINE void writeLed(fl::u8 r, fl::u8 g, fl::u8 b) FL_NO_EXCEPT {
        FASTLED_REGISTER fl::u8 top = 0xC0 | ((~b & 0xC0) >> 2) | ((~g & 0xC0) >> 4) | ((~r & 0xC0) >> 6);
        mSPI.writeByte(top); mSPI.writeByte(b); mSPI.writeByte(g); mSPI.writeByte(r);
    }
 
public:
    P9813Controller() FL_NO_EXCEPT {}
    #if defined(FL_IS_ESP32)
    CLEDController &setSpiBus(fl::Esp32SpiBus bus) FL_NO_EXCEPT override {
        mSPI.setBus(bus);
        return *this;
    }
    #endif
 
    virtual void init() FL_NO_EXCEPT {
        mSPI.init();
    }
 
protected:
    virtual void showPixels(PixelController<RGB_ORDER> & pixels) FL_NO_EXCEPT {
        mSPI.select();
 
        writeBoundary();
        while(pixels.has(1)) {
            writeLed(pixels.loadAndScale0(), pixels.loadAndScale1(), pixels.loadAndScale2());
            pixels.advanceData();
            pixels.stepDithering();
        }
        writeBoundary();
 
        mSPI.endTransaction();
    }
 
public:
    static constexpr fl::u8 getPaddingByte() FL_NO_EXCEPT { return 0x00; }

    static fl::span<const fl::u8> getPaddingLEDFrame() FL_NO_EXCEPT {  // okay static in header
        static const fl::u8 frame[] = {  // okay static in header
            0xFF,  // Flag byte for RGB=0,0,0
            0x00,  // Blue = 0
            0x00,  // Green = 0
            0x00   // Red = 0
        };
        return fl::span<const fl::u8>(frame, 4);
    }

    static constexpr size_t getPaddingLEDFrameSize() FL_NO_EXCEPT {
        return 4;
    }

    static constexpr size_t calculateBytes(size_t num_leds) FL_NO_EXCEPT {
        // P9813 protocol:
        // - Start boundary: 4 bytes (0x00000000)
        // - LED data: 4 bytes per LED (flag byte + BGR)
        // - End boundary: 4 bytes (0x00000000)
        return 4 + (num_leds * 4) + 4;
    }
};
 
FL_DISABLE_WARNING_POP