MAX7219.hpp

Go to the documentation of this file.

/* ✔ */
 
#pragma once
 
#include <AH/Settings/Warnings.hpp>
AH_DIAGNOSTIC_WERROR() // Enable errors on warnings
 
#include "StaticSizeExtendedIOElement.hpp"
#include <AH/Containers/BitArray.hpp>
#include <AH/Hardware/LEDs/MAX7219_Base.hpp>
 
BEGIN_AH_NAMESPACE
 
template <uint8_t NumChips = 1, class SPIDriver = decltype(SPI) &>
class MAX7219 : public MAX7219_Base<SPIDriver>,
                public StaticSizeExtendedIOElement<8 * 8 * NumChips> {
  public:
    MAX7219(SPIDriver spi, pin_t loadPin)
        : MAX7219_Base<SPIDriver>(std::forward<SPIDriver>(spi), loadPin,
                                  NumChips) {}
 
    void begin() override { MAX7219_Base<SPIDriver>::begin(); }
 
  private:
    struct IndexMask {
        uint8_t row;
        uint8_t col;
        uint8_t rowgrp;
        uint8_t rowmask;
        uint8_t colmask;
    };
 
    static IndexMask pin2index(pin_t pin) {
        uint8_t row = pin / 8;
        uint8_t col = pin % 8;
        uint8_t rowgrp = row % 8;
        uint8_t rowmask = 1 << rowgrp;
        uint8_t colmask = 1 << col;
        return {row, col, rowgrp, rowmask, colmask};
    }
 
  public:
    void pinMode(pin_t pin, PinMode_t mode) override
        __attribute__((deprecated)) {
        (void)pin;
        (void)mode;
    }
 
    void pinModeBuffered(pin_t pin, PinMode_t mode) override
        __attribute__((deprecated)) {
        (void)pin;
        (void)mode;
    }
 
    void digitalWrite(pin_t pin, PinStatus_t val) override {
        IndexMask i = pin2index(pin);
        val ? buffer[i.row] |= i.colmask   // set the pin (high)
            : buffer[i.row] &= ~i.colmask; // clear the pin (low)
        updateBufferedOutputRow(i);
    }
 
    void digitalWriteBuffered(pin_t pin, PinStatus_t val) override {
        IndexMask i = pin2index(pin);
        val ? buffer[i.row] |= i.colmask   // set the pin (high)
            : buffer[i.row] &= ~i.colmask; // clear the pin (low)
        dirty_rows |= i.rowmask;
    }
 
    PinStatus_t digitalRead(pin_t pin) override {
        IndexMask i = pin2index(pin);
        return bool(buffer[i.row] & i.colmask) ? HIGH : LOW;
    }
 
    PinStatus_t digitalReadBuffered(pin_t pin) override {
        IndexMask i = pin2index(pin);
        return bool(buffer[i.row] & i.colmask) ? HIGH : LOW;
    }
 
    analog_t analogRead(pin_t pin) override __attribute__((deprecated)) {
        return 1023 * digitalRead(pin);
    }
 
    analog_t analogReadBuffered(pin_t pin) override
        __attribute__((deprecated)) {
        return 1023 * digitalRead(pin);
    }
 
    void analogWrite(pin_t pin, analog_t val) override
        __attribute__((deprecated)) {
        digitalWrite(pin, val >= 0x80 ? HIGH : LOW);
    }
 
    void analogWriteBuffered(pin_t pin, analog_t val) override
        __attribute__((deprecated)) {
        digitalWrite(pin, val >= 0x80 ? HIGH : LOW);
    }
 
    void updateBufferedOutputRow(IndexMask i) {
        this->sendRowAll(i.rowgrp, buffer.data + i.rowgrp, 8);
        dirty_rows &= ~i.rowmask;
    }
 
    void updateBufferedOutputs() override {
        if (dirty_rows == 0)
            return;
        uint8_t row = 8;
        do {
            --row;
            if (dirty_rows & 0x80)
                this->sendRowAll(row, buffer.data + row, 8);
            dirty_rows <<= 1;
        } while (row);
    }
 
    void updateBufferedInputs() override {}
 
  private:
    Array<uint8_t, 8 * NumChips> buffer;
    uint8_t dirty_rows = 0xFF;
};
 
END_AH_NAMESPACE
 
AH_DIAGNOSTIC_POP()