pins.h

Go to the documentation of this file.

 
#pragma once
 
#include "fl/system/pin.h"  // IWYU pragma: keep
#include "fl/stl/span.h"
#include "fl/stl/noexcept.h"
 
namespace fl {

struct Pins8 {
    int pins[8];
};

class DigitalMultiWrite8 {
  public:
    DigitalMultiWrite8() FL_NO_EXCEPT = default;

    void init(const Pins8& pins) FL_NO_EXCEPT;

    void write(fl::span<const u8> pin_data) const FL_NO_EXCEPT;

    void writeByte(u8 byte) const FL_NO_EXCEPT {
        const u8 lo_nib = byte & 0x0F;
        const u8 hi_nib = (byte >> 4) & 0x0F;
        applyNibble(mSetLo[lo_nib], mClrLo[lo_nib]);
        applyNibble(mSetHi[hi_nib], mClrHi[hi_nib]);
    }

    bool allSamePort() const FL_NO_EXCEPT;
 
  private:
    // Each LUT entry stores up to 4 pin indices to set or clear.
    struct PinList {
        int pins[4];
        u8 count;
    };
 
    void buildNibbleLut(u8 bit_offset, PinList (&set_lut)[16],
                        PinList (&clr_lut)[16]) FL_NO_EXCEPT;
 
    static void applyNibble(const PinList &set, const PinList &clr) FL_NO_EXCEPT;
 
    int mPins[8] = {-1, -1, -1, -1, -1, -1, -1, -1};
    PinList mSetLo[16] = {};
    PinList mClrLo[16] = {};
    PinList mSetHi[16] = {};
    PinList mClrHi[16] = {};
};

void digitalMultiWrite8(const Pins8& pins, fl::span<const u8> pin_data) FL_NO_EXCEPT;

struct Pins16 {
    int pins[16];
};

class DigitalMultiWrite16 {
  public:
    DigitalMultiWrite16() FL_NO_EXCEPT = default;

    void init(const Pins16& pins) FL_NO_EXCEPT;

    void write(fl::span<const u16> pin_data) const FL_NO_EXCEPT;

    bool allSamePort() const FL_NO_EXCEPT;
 
  private:
    // Each LUT entry stores up to 4 pin indices to set or clear.
    struct PinList {
        int pins[4];
        u8 count;
    };
 
    void buildNibbleLut(u8 bit_offset, PinList (&set_lut)[16],
                        PinList (&clr_lut)[16]) FL_NO_EXCEPT;
 
    static void applyNibble(const PinList &set, const PinList &clr) FL_NO_EXCEPT;
 
    int mPins[16] = {-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1};
    PinList mSetNib[4][16] = {};  // nibbles 0-3 (bits 0-3, 4-7, 8-11, 12-15)
    PinList mClrNib[4][16] = {};
};

void digitalMultiWrite16(const Pins16& pins, fl::span<const u16> pin_data) FL_NO_EXCEPT;

struct PinInfo {
    int pin = -1;
    int port = -1;
};

int pinToPort(int pin) FL_NO_EXCEPT;

void pinMap(fl::span<PinInfo> pins) FL_NO_EXCEPT;
 
} // namespace fl