HD44780.hpp

Go to the documentation of this file.

/*
 * This file is part of the DUDS project. It is subject to the BSD-style
 * license terms in the LICENSE file found in the top-level directory of this
 * distribution and at https://github.com/jjackowski/duds/blob/master/LICENSE.
 * No part of DUDS, including this file, may be copied, modified, propagated,
 * or distributed except according to the terms contained in the LICENSE file.
 *
 * Copyright (C) 2017  Jeff Jackowski
 */
#include <duds/hardware/interface/DigitalPinSet.hpp>
#include <duds/hardware/interface/ChipSelect.hpp>
#include <duds/hardware/display/TextDisplay.hpp>
#include <chrono>

namespace duds { namespace ui { namespace graphics {
    class BppImage;
} } }

namespace duds { namespace hardware { namespace devices { namespace displays {

class HD44780 : public duds::hardware::display::TextDisplay {
    duds::hardware::interface::DigitalPinSet outputs;
    duds::hardware::interface::ChipSelect enable;
    std::vector<duds::hardware::interface::DigitalPinConfig> outcfg;
    std::chrono::high_resolution_clock::time_point soonestSend;
    std::chrono::nanoseconds nibblePeriod;
    enum {
        dataMask   = 0xFF,
        textFlag   = 0x100,
        writeFlag  = 0x200,  // not presently supported; wire to ground
        nibbleFlag = 0x400
    };
    void wait() const;
    struct Access {
        duds::hardware::interface::DigitalPinSetAccess output;
        duds::hardware::interface::ChipAccess enable;
    };
    void preparePins(Access &acc);
    void sendByte(Access &acc, int val);
    virtual void moveImpl(unsigned int c, unsigned int r);
    virtual void writeImpl(int c);
    void writeImpl(Access &acc, const std::string &text);
    virtual void writeImpl(const std::string &text);
    virtual void writeImpl(
        const std::string &text,
        unsigned int c,
        unsigned int r
    );
public:
    HD44780();
    HD44780(
        duds::hardware::interface::DigitalPinSet &&outPins,
        duds::hardware::interface::ChipSelect &&enablePin,
        unsigned int c,
        unsigned int r,
        std::chrono::nanoseconds delay = std::chrono::nanoseconds(8000)
    );
    virtual ~HD44780();
    void configure(
        duds::hardware::interface::DigitalPinSet &&outPins,
        duds::hardware::interface::ChipSelect &&enablePin,
        unsigned int c,
        unsigned int r,
        std::chrono::nanoseconds delay = std::chrono::nanoseconds(8000)
    );
    void initialize();
    void off();
    void on();
    virtual void clear();
    void setGlyph(
        const std::shared_ptr<duds::ui::graphics::BppImage> &glyph,
        int idx
    );
};

} } } }