display_digits_max72xx.h

// display_digits_max72xx.h - mupplet for 7 segment digits display using MAX72xx
 
#pragma once
 
#include "muwerk.h"
#include "helper/light_controller.h"
#include "helper/mup_display.h"
#include "hardware/max72xx_digits.h"
 
namespace ustd {
 
class DisplayDigitsMAX72XX : public MuppletDisplay {
  public:
    static const char *version;  // = "0.1.0";
 
  private:
    // hardware configuration
    Max72xxDigits display;
 
    // runtime
    LightController light;
 
  public:
    DisplayDigitsMAX72XX(String name, uint8_t csPin, uint8_t hDisplays = 1, uint8_t vDisplays = 1,
                         uint8_t length = 8)
        : MuppletDisplay(name, 0), display(csPin, hDisplays, vDisplays, length) {
    }
 
    void begin(Scheduler *_pSched, bool initialState = false) {
        pSched = _pSched;
        tID = pSched->add([this]() { this->loop(); }, name, 80000L);
 
        pSched->subscribe(tID, name + "/display/#", [this](String topic, String msg, String orig) {
            this->commandParser(topic.substring(name.length() + 9), msg, name + "/display");
        });
        pSched->subscribe(tID, name + "/light/#", [this](String topic, String msg, String orig) {
            this->light.commandParser(topic.substring(name.length() + 7), msg);
        });
 
        // initialize default values
        current_font = 0;
#ifdef USTD_FEATURE_PROGRAMPLAYER
        programInit();
#endif
        // prepare hardware
        display.begin();
        display.setTextWrap(false);
 
        // start light controller
        light.begin([this](bool state, double level, bool control,
                           bool notify) { this->onLightControl(state, level, control, notify); },
                    initialState);
    }
 
  private:
    void loop() {
        light.loop();
#ifdef USTD_FEATURE_PROGRAMPLAYER
        programLoop();
#endif
    }
 
    void onLightControl(bool state, double level, bool control, bool notify) {
        uint8_t intensity = (level * 15000) / 1000;
        if (control) {
            display.setIntensity(intensity);
        }
        if (control) {
            display.setPowerSave(!state);
        }
        if (notify) {
            pSched->publish(name + "/light/unitbrightness", String(level, 3));
            pSched->publish(name + "/light/state", state ? "on" : "off");
        }
    }
 
    virtual void getDimensions(int16_t &width, int16_t &height) {
        width = display.width();
        height = display.height();
    }
 
    virtual bool getTextWrap() {
        return display.getTextWrap();
    }
 
    virtual void setTextWrap(bool wrap) {
        display.setTextWrap(wrap);
    }
 
    virtual FontSize getTextFontSize() {
        FontSize retVal;
        retVal.baseLine = 0;
        retVal.xAdvance = 1;
        retVal.yAdvance = 1;
        return retVal;
    }
 
    virtual uint8_t getTextFontCount() {
        return 1;
    }
 
    virtual void setTextFont(uint8_t font, int16_t baseLineAdjustment) {
    }
 
    virtual void setTextColor(uint16_t fg, uint16_t bg) {
    }
 
    virtual void getCursor(int16_t &x, int16_t &y) {
        x = display.getCursorX();
        y = display.getCursorY();
    }
 
    virtual void setCursor(int16_t x, int16_t y) {
        display.setCursor(x, y);
    }
 
    virtual void displayClear(int16_t x, int16_t y, int16_t w, int16_t h) {
        display.fillRect(x, y, w, h);
        display.write();
    }
 
    virtual void displayClear(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t bg) {
        display.fillRect(x, y, w, h);
        display.write();
    }
 
    virtual void displayPrint(String content, bool ln = false) {
        if (ln) {
            display.println(content);
        } else {
            display.print(content);
        }
        display.write();
    }
 
    virtual bool displayFormat(int16_t x, int16_t y, int16_t w, int16_t align, String content,
                               uint8_t font, uint16_t color, uint16_t bg) {
        bool ret = display.printFormatted(x, y, w, align, content);
        display.write();
        return ret;
    }
 
#ifdef USTD_FEATURE_PROGRAMPLAYER
    virtual bool initNextCharDimensions(ProgramItem &item) {
        while (charPos < item.content.length()) {
            charX = display.getCharLen(item.content[charPos], false);
            charY = 1;
            if (charX) {
                if (item.content[charPos] == ' ') {
                    lastPos += charX;
                } else {
                    return true;
                }
            } else if (item.content[charPos] == ' ') {
                lastPos += charX;
            }
            // char is not printable
            ++charPos;
        }
        // end of string
        return false;
    }
#endif
};
 
const char *DisplayDigitsMAX72XX::version = "0.1.0";
 
}  // namespace ustd