HT16K33plus_Model1_RDL.hpp

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stdbool.h>
#include <algorithm> // Required for std::fill
#include <cstring>
 
#include <lgpio.h>
#include "common_data_RDL.hpp"
#include "led_segment_font_data_RDL.hpp"
 
class HT16K33plus_Model1
{
    public:
        // enums:
        enum TextAlignment_e : uint8_t
        {
            AlignLeft       = 0, 
            AlignRight      = 1, 
            AlignRightZeros = 2  
        };
        enum BlinkFreq_e : uint8_t
        {
            BLINKOFF  =    0x81, 
            BLINKON2HZ =   0x83, 
            BLINKON1HZ =   0x85, 
            BLINKON0_5HZ = 0x87  
        };
        enum DecimalPoint_e : uint8_t
        {
            DecPointOff  = 0, 
            DecPointOn   = 1  
        };
        enum DisplayType_e : uint8_t
        {
            SegType7  = 7,  
            SegType9  = 9,  
            SegType14 = 14, 
            SegType16 = 16  
        };
        // constructor
         HT16K33plus_Model1(int I2Cdevice, int I2Caddress, int I2Cflags);
        // methods I2C related
        rdlib::Return_Codes_e Display_I2C_ON(void);
        rdlib::Return_Codes_e Display_I2C_OFF(void);
        int DisplayCheckConnection(void);
        int DisplayI2CErrorGet(void) const;
        uint16_t DisplayI2CErrorTimeoutGet(void) const;
        void DisplayI2CErrorTimeoutSet(uint16_t);
        uint8_t DisplayI2CErrorRetryNumGet(void) const;
        void DisplayI2CErrorRetryNumSet(uint8_t);
 
        // Device related
        void DisplayInit(uint8_t brightLevel, BlinkFreq_e  blink,
            uint8_t numOfDigits, DisplayType_e dtype);
        void DisplayOn(void);
        void DisplayOff(void);
        void DisplaySleep(void);
        void DisplayNormal(void);
        void DisplayResetDefault(void);
        void setBrightness(uint8_t value);
        uint8_t getBrightness() const;
        void  setBlink(BlinkFreq_e  value);
        BlinkFreq_e  getBlink() const;
        DisplayType_e getDisplayType() const;
 
        // Display data related
        void ClearDigits(void);
        //raw data segments
        void displayRawData(uint8_t digitPos, uint16_t value);
        // Display data
        rdlib::Return_Codes_e displayChar(uint8_t digitPos, char c, DecimalPoint_e dp);
        rdlib::Return_Codes_e displayText(const char *text, TextAlignment_e TextAlignment);
        rdlib::Return_Codes_e displayText(const char *text);
        rdlib::Return_Codes_e displayHexChar(uint8_t digitPos, char hex);
        rdlib::Return_Codes_e displayIntNum(int32_t number, TextAlignment_e TextAlignment);
        rdlib::Return_Codes_e displayFloatNum(float number, TextAlignment_e TextAlignment, uint8_t fractionDigits);
    protected:
 
    private:
        rdlib::Return_Codes_e displayMultiSegNum(uint8_t digitPos, char c, DecimalPoint_e dp);
 
        // methods I2C related
        void SendCmd(uint8_t cmd);
        void SendData(const unsigned char* data, size_t length);
 
        // Members I2C related
        int _I2CAddress = 0x70 ; 
        int _I2CDevice =  1;      
        int _I2CFlags =   0;      
        int _I2CHandle =  0;      
        uint16_t _I2C_ErrorDelay = 100; 
        uint8_t _I2C_ErrorRetryNum = 3; 
        int _I2C_ErrorFlag =         0; 
        // members device related
        //  Register Command List
        static constexpr uint8_t HT16K33_DDAPTR =     0x00; 
        static constexpr uint8_t HT16K33_NORMAL =     0x21; 
        static constexpr uint8_t HT16K33_STANDBY =    0x20; 
        static constexpr uint8_t HT16K33_DISPLAYON =  0x81; 
        static constexpr uint8_t HT16K33_DISPLAYOFF = 0x80; 
        static constexpr uint8_t HT16K33_BRIGHTNESS = 0xE0; 
        BlinkFreq_e _blinkSetting = BLINKOFF; 
        DisplayType_e  _displayType = SegType7; 
        uint8_t _brightness = 7;  
        uint8_t _numOfDigits = 4; 
        // Display Offsets and Masks for ASCII Font
        static constexpr uint8_t _HT_ASCIIOffset =    0x20; 
        static constexpr uint8_t _HT_HEXoffset   =    0x10; 
        static constexpr uint8_t _HT_ASCIIEnd    =    0x7B; 
        static constexpr uint8_t  _HT_DEC_POINT_7_MASK =    0x80;  
        static constexpr uint16_t _HT_DEC_POINT_9_MASK =  0x0200; 
        static constexpr uint16_t _HT_DEC_POINT_14_MASK = 0x4000; 
};