// // FILE: HT16K33.cpp // AUTHOR: Rob Tillaart // VERSION: 0.1.2 // DATE: 2019-02-07 // PURPOSE: Class for HT16K33 // // HISTORY: // 0.1.0 - 2019-02-07 initial version // 0.1.1 - 2019-02-07 first stable version // 0.1.2 - 2019-02-11 optimized performance // // Released to the public domain // #include "HT16K33.h" #define HT16K33_ON 0x21 // 0=off 1=on #define HT16K33_STANDBY 0x20 // bit xxxxxxx0 #define HT16K33_DISPLAYON 0x81 // 0=off 1=on #define HT16K33_DISPLAYOFF 0x80 // bit xxxxxxx0 #define HT16K33_BLINKON1HZ 0x85 // 00=off 01=2Hz 10=1Hz 11=0.5Hz #define HT16K33_BLINKOFF 0x81 // bit xxxxx21x #define HT16K33_BRIGHTNESS 0xE0 // mask to be ored with 0x00 - 0x0F static const uint8_t charmap[] = { 0x3F, // 0 0x06, // 1 0x5B, // 2 0x4F, // 3 0x66, // 4 0x6D, // 5 0x7D, // 6 0x07, // 7 0x7F, // 8 0x6F, // 9 0x77, // A 0x7C, // B 0x39, // C 0x5E, // D 0x79, // E 0x71, // F 0x00, // space }; HT16K33::HT16K33() { } void HT16K33::begin(const uint8_t address) { _addr = address; displayOn(); displayClear(); } void HT16K33::displayOn() { writeCmd(HT16K33_ON); writeCmd(HT16K33_DISPLAYON); brightness(8); } void HT16K33::displayOff() { writeCmd(HT16K33_DISPLAYOFF); writeCmd(HT16K33_STANDBY); } void HT16K33::blink(uint8_t val) { if (val > 0x03) val = 0x00; writeCmd(HT16K33_BLINKOFF | (val << 1) ); } void HT16K33::brightness(uint8_t val) { if (val > 0x0F) val = 0x0F; writeCmd(HT16K33_BRIGHTNESS | val); } ////////////////////////////////////////// // // display functions // void HT16K33::displayClear() { uint8_t x[4] = {17, 17, 17, 17}; display(x); displayColon(false); } // 0000..9999 // TODO negative numbers // DIV10 & DIV100 optimize? void HT16K33::displayInt(int n) { uint8_t x[4], h, l; h = n / 100; l = n - h * 100; x[0] = h / 10; x[1] = h - x[0] * 10; x[2] = l / 10; x[3] = l - x[2] * 10; display(x); } // 0000..FFFF void HT16K33::displayHex(uint16_t n) { uint8_t x[4], h, l; h = n >> 8; l = n & 0xFF; x[3] = l & 0x0F; x[2] = l >> 4; x[1] = h & 0x0F;; x[0] = h >> 4; display(x); } // 00:00 .. 99:99 void HT16K33::displayTime(uint8_t left, uint8_t right) { uint8_t x[4]; x[0] = left / 10; x[1] = left - x[0] * 10; x[2] = right / 10; x[3] = right - x[2] * 10; display(x); displayColon(false); } // only 0.000 .. 9999. // TODO -999..-0.00 // TODO x.yEz void HT16K33::displayFloat(float f) { int pt = 0; // uint8_t neg = 0; // if (f < 0) { neg = -1; f = -f; } if (f > 9999 || f < 0 ) return; int w = round(f); if (w > 9) pt = 1; if (w > 99) pt = 2; if (w > 999) pt = 3; if (f >= 1) { while (f < 1000) f *= 10; w = round(f); } else { w = round(f * 1000); } uint8_t x[4], h, l; h = w / 100; l = w - h * 100; x[0] = h / 10; x[1] = h - x[0] * 10; x[2] = l / 10; x[3] = l - x[2] * 10; display(x, pt); } void HT16K33::displayTest(uint8_t del) { for (int i = 0; i < 256; i++) { writePos(0, i); writePos(1, i); writePos(2, i); writePos(3, i); writePos(4, i); delay(del); } } void HT16K33::display(uint8_t *arr) { writePos(0, charmap[arr[0]]); writePos(1, charmap[arr[1]]); writePos(3, charmap[arr[2]]); writePos(4, charmap[arr[3]]); } void HT16K33::display(uint8_t *arr, uint8_t pnt) { writePos(0, charmap[arr[0]], pnt == 0); writePos(1, charmap[arr[1]], pnt == 1); writePos(3, charmap[arr[2]], pnt == 2); writePos(4, charmap[arr[3]], pnt == 3); } void HT16K33::displayColon(uint8_t on) { writePos(2, on ? 2 : 0); } ////////////////////////////////////////////////////////// void HT16K33::writeCmd(uint8_t cmd) { Wire.beginTransmission(_addr); Wire.write(cmd); Wire.endTransmission(); } void HT16K33::writePos(uint8_t pos, uint8_t mask) { if (_displayCache[pos] == mask) return; Wire.beginTransmission(_addr); Wire.write(pos * 2); Wire.write(mask); Wire.endTransmission(); _displayCache[pos] = mask; } void HT16K33::writePos(uint8_t pos, uint8_t mask, bool pnt) { if (pnt) mask |= 0x80; writePos(pos, mask); } // -- END OF FILE --