mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
154 lines
4.6 KiB
C++
154 lines
4.6 KiB
C++
#pragma once
|
|
//
|
|
// FILE: HT16K33.h
|
|
// AUTHOR: Rob Tillaart
|
|
// VERSION: 0.3.7
|
|
// DATE: 2019-02-07
|
|
// PURPOSE: Arduino Library for HT16K33 4x7segment display
|
|
// http://www.adafruit.com/products/1002
|
|
// URL: https://github.com/RobTillaart/HT16K33.git
|
|
|
|
|
|
#include "Arduino.h"
|
|
#include "Wire.h"
|
|
|
|
|
|
#define HT16K33_LIB_VERSION (F("0.3.7"))
|
|
|
|
|
|
// Characters
|
|
#define HT16K33_0 0
|
|
#define HT16K33_1 1
|
|
#define HT16K33_2 2
|
|
#define HT16K33_3 3
|
|
#define HT16K33_4 4
|
|
#define HT16K33_5 5
|
|
#define HT16K33_6 6
|
|
#define HT16K33_7 7
|
|
#define HT16K33_8 8
|
|
#define HT16K33_9 9
|
|
#define HT16K33_A 10
|
|
#define HT16K33_B 11
|
|
#define HT16K33_C 12
|
|
#define HT16K33_D 13
|
|
#define HT16K33_E 14
|
|
#define HT16K33_F 15
|
|
#define HT16K33_SPACE 16
|
|
#define HT16K33_MINUS 17
|
|
#define HT16K33_TOP_C 18 // c
|
|
#define HT16K33_DEGREE 19 // °
|
|
#define HT16K33_NONE 99
|
|
|
|
// P for Pascal / Pressure ?
|
|
// J for joule?
|
|
|
|
class HT16K33
|
|
{
|
|
public:
|
|
HT16K33(const uint8_t address, TwoWire *wire = &Wire); // 0x70 .. 0x77
|
|
|
|
#if defined (ESP8266) || defined(ESP32)
|
|
bool begin(uint8_t sda, uint8_t scl);
|
|
#endif
|
|
bool begin();
|
|
void reset();
|
|
|
|
bool isConnected();
|
|
|
|
// default _cache is true as it is ~3x faster but if one has noise
|
|
// on the I2C and wants to force refresh one can disable caching
|
|
// for one or more calls.
|
|
void clearCache();
|
|
void cacheOn();
|
|
void cacheOff();
|
|
void refresh(); // force writing of cache to display
|
|
|
|
void displayOn();
|
|
void displayOff();
|
|
|
|
void brightness(uint8_t value); // 0 .. 15
|
|
void blink(uint8_t value); // 0 .. 3 0 = off
|
|
|
|
|
|
// 0,1,2,3,4 digits - will replace suppressLeadingZeroPlaces
|
|
void setDigits(uint8_t value);
|
|
// 0 = off, 1,2,3,4 digits space instead of 0
|
|
void suppressLeadingZeroPlaces(uint8_t value); // will be obsolete
|
|
|
|
void displayClear();
|
|
bool displayInt(int n); // -999 .. 9999
|
|
bool displayHex(uint16_t n); // 0000 .. FFFF
|
|
|
|
// Date could be {month.day} or {day.hour} . as separator
|
|
// Time could be hh:mm or mm:ss or ss:uu (hundreds : as separator
|
|
// colon displays : lz = Leading Zero or space
|
|
bool displayDate(uint8_t left, uint8_t right, bool lz = true); // 00.00 .. 99.99
|
|
bool displayTime(uint8_t left, uint8_t right, bool colon = true, bool lz = true); // 00:00 .. 99:99
|
|
bool displaySeconds(uint16_t seconds, bool colon = true, bool lz = true); // 00:00 .. 99:99
|
|
|
|
// -999 .. 0.000 .. 9999
|
|
bool displayFloat(float f, uint8_t decimals = 3);
|
|
|
|
// -99 .. 0.00 .. 999
|
|
bool displayUnit(float f, uint8_t decimals = 2, uint8_t unitChar = HT16K33_SPACE);
|
|
|
|
|
|
void display(uint8_t *array); // array with 4 elements
|
|
void display(uint8_t *array, uint8_t point); // point = digit with . (0..3)
|
|
void displayColon(uint8_t on); // 0 = off
|
|
void displayRaw(uint8_t *array, bool colon = false); // max control
|
|
|
|
// from issue #21 - used in special layout :88:8'8 normal = 88:88 or 8.8.8.8
|
|
// value = 0 ==> all off.
|
|
// 2 = colon
|
|
// 4 = upper left point, left of the 1st digit
|
|
// 8 = lower left point, left of the 1st digit
|
|
// 16 = upper point between 3rd and 4th digit
|
|
void displayExtraLeds(uint8_t value);
|
|
|
|
bool displayVULeft(uint8_t value); // 0..8
|
|
bool displayVURight(uint8_t value); // 0..8
|
|
|
|
|
|
// DEBUG
|
|
void displayTest(uint8_t del);
|
|
// array as numbers
|
|
void dumpSerial(uint8_t *array, uint8_t point);
|
|
// display cache in HEX format
|
|
void dumpSerial();
|
|
uint8_t getAddress() { return _address; };
|
|
uint8_t getAddr() { return getAddress(); }; // TODO obsolete in future
|
|
|
|
|
|
// EXPERIMENTAL
|
|
bool getOverflow() { return _overflow; };
|
|
void clrOverflow() { _overflow = false; };
|
|
|
|
bool displayFixedPoint0(float f);
|
|
bool displayFixedPoint1(float f);
|
|
bool displayFixedPoint2(float f);
|
|
bool displayFixedPoint3(float f);
|
|
|
|
|
|
private:
|
|
void _refresh();
|
|
void writeCmd(uint8_t cmd);
|
|
void writePos(uint8_t pos, uint8_t mask);
|
|
void writePos(uint8_t pos, uint8_t mask, bool point);
|
|
|
|
uint8_t _address;
|
|
uint8_t _displayCache[5]; // for performance
|
|
bool _cache = true;
|
|
uint8_t _digits = 0;
|
|
uint8_t _bright;
|
|
|
|
TwoWire* _wire;
|
|
|
|
// EXPERIMENTAL
|
|
bool _overflow = false;
|
|
};
|
|
|
|
|
|
// -- END OF FILE --
|
|
|