Wim Huiskamp / TM1638

TM1638 LED controller. Max 80 LEDs, Max 24 Key scan. Supports LED&KEY, QYF-TM1638 and JY-LKM1638 module.

Dependents:   mbed_TM1638 Otjimaniya RL0201-V1

See here for more information.

TM1638.cpp@2:532ce15ea9ec, 2016-01-15 (annotated)

Committer:
wim
Date:
Fri Jan 15 19:09:59 2016 +0000
Revision:
2:532ce15ea9ec
Parent:
1:1f2453ed85d7
Child:
3:25ddabfadc8c
Refactored display and keyboard defines, added ASCII font.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
wim 0:201dfacbe0e5 1 /* mbed TM1638 Library, for TM1638 LED controller
wim 0:201dfacbe0e5 2 * Copyright (c) 2015, v01: WH, Initial version
wim 2:532ce15ea9ec 3 * 2016, v02: WH, Added ASCII alphabet display selector, refactored display and keyboard defines
wim 0:201dfacbe0e5 4 *
wim 0:201dfacbe0e5 5 * Permission is hereby granted, free of charge, to any person obtaining a copy
wim 0:201dfacbe0e5 6 * of this software and associated documentation files (the "Software"), to deal
wim 0:201dfacbe0e5 7 * in the Software without restriction, including without limitation the rights
wim 0:201dfacbe0e5 8 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
wim 0:201dfacbe0e5 9 * copies of the Software, and to permit persons to whom the Software is
wim 0:201dfacbe0e5 10 * furnished to do so, subject to the following conditions:
wim 0:201dfacbe0e5 11 *
wim 0:201dfacbe0e5 12 * The above copyright notice and this permission notice shall be included in
wim 0:201dfacbe0e5 13 * all copies or substantial portions of the Software.
wim 0:201dfacbe0e5 14 *
wim 0:201dfacbe0e5 15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
wim 0:201dfacbe0e5 16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
wim 0:201dfacbe0e5 17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
wim 0:201dfacbe0e5 18 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
wim 0:201dfacbe0e5 19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
wim 0:201dfacbe0e5 20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
wim 0:201dfacbe0e5 21 * THE SOFTWARE.
wim 0:201dfacbe0e5 22 */
wim 0:201dfacbe0e5 23 #include "mbed.h"
wim 0:201dfacbe0e5 24 #include "TM1638.h"
wim 0:201dfacbe0e5 25
wim 0:201dfacbe0e5 26 /** Constructor for class for driving TM1638 LED controller with SPI bus interface device.
wim 0:201dfacbe0e5 27 * @brief Supports 8 digits @ 10 segments.
wim 0:201dfacbe0e5 28 * Also supports a scanned keyboard of upto 24 keys.
wim 0:201dfacbe0e5 29 *
wim 0:201dfacbe0e5 30 * @param PinName mosi, miso, sclk, cs SPI bus pins
wim 0:201dfacbe0e5 31 */
wim 0:201dfacbe0e5 32 TM1638::TM1638(PinName mosi, PinName miso, PinName sclk, PinName cs) : _spi(mosi,miso,sclk), _cs(cs) {
wim 0:201dfacbe0e5 33
wim 0:201dfacbe0e5 34 _init();
wim 0:201dfacbe0e5 35 }
wim 0:201dfacbe0e5 36
wim 0:201dfacbe0e5 37 /** Init the SPI interface and the controller
wim 0:201dfacbe0e5 38 * @param none
wim 0:201dfacbe0e5 39 * @return none
wim 0:201dfacbe0e5 40 */
wim 0:201dfacbe0e5 41 void TM1638::_init(){
wim 0:201dfacbe0e5 42
wim 0:201dfacbe0e5 43 //init SPI
wim 0:201dfacbe0e5 44 _cs=1;
wim 0:201dfacbe0e5 45 _spi.format(8,3); //TM1638 uses mode 3 (Clock High on Idle, Data latched on second (=rising) edge)
wim 0:201dfacbe0e5 46 _spi.frequency(500000);
wim 0:201dfacbe0e5 47
wim 0:201dfacbe0e5 48 //init controller
wim 0:201dfacbe0e5 49 _display = TM1638_DSP_ON;
wim 0:201dfacbe0e5 50 _bright = TM1638_BRT_DEF;
wim 0:201dfacbe0e5 51 _writeCmd(TM1638_DSP_CTRL_CMD, _display | _bright ); // Display control cmd, display on/off, brightness
wim 0:201dfacbe0e5 52
wim 0:201dfacbe0e5 53 _writeCmd(TM1638_DATA_SET_CMD, TM1638_DATA_WR | TM1638_ADDR_INC | TM1638_MODE_NORM); // Data set cmd, normal mode, auto incr, write data
wim 0:201dfacbe0e5 54 }
wim 0:201dfacbe0e5 55
wim 0:201dfacbe0e5 56
wim 0:201dfacbe0e5 57 /** Clear the screen and locate to 0
wim 0:201dfacbe0e5 58 */
wim 0:201dfacbe0e5 59 void TM1638::cls() {
wim 0:201dfacbe0e5 60
wim 0:201dfacbe0e5 61 _cs=0;
wim 0:201dfacbe0e5 62 wait_us(1);
wim 0:201dfacbe0e5 63 _spi.write(_flip(TM1638_ADDR_SET_CMD | 0x00)); // Address set cmd, 0
wim 0:201dfacbe0e5 64
wim 0:201dfacbe0e5 65 for (int cnt=0; cnt<TM1638_DISPLAY_MEM; cnt++) {
wim 0:201dfacbe0e5 66 _spi.write(0x00); // data
wim 0:201dfacbe0e5 67 }
wim 0:201dfacbe0e5 68
wim 0:201dfacbe0e5 69 wait_us(1);
wim 0:201dfacbe0e5 70 _cs=1;
wim 0:201dfacbe0e5 71 }
wim 0:201dfacbe0e5 72
wim 0:201dfacbe0e5 73 /** Set Brightness
wim 0:201dfacbe0e5 74 *
wim 0:201dfacbe0e5 75 * @param char brightness (3 significant bits, valid range 0..7 (1/16 .. 14/14 dutycycle)
wim 0:201dfacbe0e5 76 * @return none
wim 0:201dfacbe0e5 77 */
wim 0:201dfacbe0e5 78 void TM1638::setBrightness(char brightness){
wim 0:201dfacbe0e5 79
wim 0:201dfacbe0e5 80 _bright = brightness & TM1638_BRT_MSK; // mask invalid bits
wim 0:201dfacbe0e5 81
wim 0:201dfacbe0e5 82 _writeCmd(TM1638_DSP_CTRL_CMD, _display | _bright ); // Display control cmd, display on/off, brightness
wim 0:201dfacbe0e5 83 }
wim 0:201dfacbe0e5 84
wim 0:201dfacbe0e5 85 /** Set the Display mode On/off
wim 0:201dfacbe0e5 86 *
wim 0:201dfacbe0e5 87 * @param bool display mode
wim 0:201dfacbe0e5 88 */
wim 0:201dfacbe0e5 89 void TM1638::setDisplay(bool on) {
wim 0:201dfacbe0e5 90
wim 0:201dfacbe0e5 91 if (on) {
wim 0:201dfacbe0e5 92 _display = TM1638_DSP_ON;
wim 0:201dfacbe0e5 93 }
wim 0:201dfacbe0e5 94 else {
wim 0:201dfacbe0e5 95 _display = TM1638_DSP_OFF;
wim 0:201dfacbe0e5 96 }
wim 0:201dfacbe0e5 97
wim 0:201dfacbe0e5 98 _writeCmd(TM1638_DSP_CTRL_CMD, _display | _bright ); // Display control cmd, display on/off, brightness
wim 0:201dfacbe0e5 99 }
wim 0:201dfacbe0e5 100
wim 0:201dfacbe0e5 101 /** Write databyte to TM1638
wim 0:201dfacbe0e5 102 * @param int address display memory location to write byte
wim 0:201dfacbe0e5 103 * @param char data byte written at given address
wim 0:201dfacbe0e5 104 * @return none
wim 0:201dfacbe0e5 105 */
wim 0:201dfacbe0e5 106 void TM1638::writeData(int address, char data) {
wim 0:201dfacbe0e5 107 _cs=0;
wim 0:201dfacbe0e5 108 wait_us(1);
wim 0:201dfacbe0e5 109 _spi.write(_flip(TM1638_ADDR_SET_CMD | (address & TM1638_ADDR_MSK))); // Set Address cmd
wim 0:201dfacbe0e5 110
wim 0:201dfacbe0e5 111 _spi.write(_flip(data)); // data
wim 0:201dfacbe0e5 112
wim 0:201dfacbe0e5 113 wait_us(1);
wim 0:201dfacbe0e5 114 _cs=1;
wim 0:201dfacbe0e5 115 }
wim 0:201dfacbe0e5 116
wim 0:201dfacbe0e5 117 /** Write Display datablock to TM1638
wim 0:201dfacbe0e5 118 * @param DisplayData_t data Array of TM1638_DISPLAY_MEM (=16) bytes for displaydata (starting at address 0)
wim 0:201dfacbe0e5 119 * @param length number bytes to write (valide range 0..TM1638_DISPLAY_MEM (=16), starting at address 0)
wim 0:201dfacbe0e5 120 * @return none
wim 0:201dfacbe0e5 121 */
wim 0:201dfacbe0e5 122 void TM1638::writeData(DisplayData_t data, int length) {
wim 0:201dfacbe0e5 123 _cs=0;
wim 0:201dfacbe0e5 124 wait_us(1);
wim 0:201dfacbe0e5 125 _spi.write(_flip(TM1638_ADDR_SET_CMD | 0x00)); // Set Address at 0
wim 0:201dfacbe0e5 126
wim 0:201dfacbe0e5 127 // sanity check
wim 0:201dfacbe0e5 128 if (length < 0) {length = 0;}
wim 0:201dfacbe0e5 129 if (length > TM1638_DISPLAY_MEM) {length = TM1638_DISPLAY_MEM;}
wim 0:201dfacbe0e5 130
wim 0:201dfacbe0e5 131 // for (int idx=0; idx<TM1638_DISPLAY_MEM; idx++) {
wim 0:201dfacbe0e5 132 for (int idx=0; idx<length; idx++) {
wim 0:201dfacbe0e5 133 _spi.write(_flip(data[idx])); // data
wim 0:201dfacbe0e5 134 }
wim 0:201dfacbe0e5 135
wim 0:201dfacbe0e5 136 wait_us(1);
wim 0:201dfacbe0e5 137 _cs=1;
wim 0:201dfacbe0e5 138 }
wim 0:201dfacbe0e5 139
wim 0:201dfacbe0e5 140
wim 0:201dfacbe0e5 141 /** Read keydata block from TM1638
wim 0:201dfacbe0e5 142 * @param *keydata Ptr to Array of TM1638_KEY_MEM (=4) bytes for keydata
wim 0:201dfacbe0e5 143 * @return bool keypress True when at least one key was pressed
wim 0:201dfacbe0e5 144 *
wim 0:201dfacbe0e5 145 * Note: Due to the hardware configuration the TM1638 key matrix scanner will detect multiple keys pressed at same time,
wim 0:201dfacbe0e5 146 * but this may also result in some spurious keys being set in keypress data array.
wim 0:201dfacbe0e5 147 * It may be best to ignore all keys in those situations. That option is implemented in this method depending on #define setting.
wim 0:201dfacbe0e5 148 */
wim 0:201dfacbe0e5 149 bool TM1638::getKeys(KeyData_t *keydata) {
wim 0:201dfacbe0e5 150 int keypress = 0;
wim 0:201dfacbe0e5 151 char data;
wim 0:201dfacbe0e5 152
wim 0:201dfacbe0e5 153 // Read keys
wim 0:201dfacbe0e5 154 _cs=0;
wim 0:201dfacbe0e5 155 wait_us(1);
wim 0:201dfacbe0e5 156
wim 0:201dfacbe0e5 157 // Enable Key Read mode
wim 0:201dfacbe0e5 158 _spi.write(_flip(TM1638_DATA_SET_CMD | TM1638_KEY_RD | TM1638_ADDR_INC | TM1638_MODE_NORM)); // Data set cmd, normal mode, auto incr, read data
wim 0:201dfacbe0e5 159
wim 0:201dfacbe0e5 160 for (int idx=0; idx < TM1638_KEY_MEM; idx++) {
wim 0:201dfacbe0e5 161 data = _flip(_spi.write(0xFF)); // read keys and correct bitorder
wim 0:201dfacbe0e5 162
wim 2:532ce15ea9ec 163 data = data & TM1638_KEY_MSK; // Mask valid bits
wim 0:201dfacbe0e5 164 if (data != 0) { // Check for any pressed key
wim 2:532ce15ea9ec 165 for (int bit=0; bit < 8; bit++) {
wim 0:201dfacbe0e5 166 if (data & (1 << bit)) {keypress++;} // Test all significant bits
wim 0:201dfacbe0e5 167 }
wim 0:201dfacbe0e5 168 }
wim 0:201dfacbe0e5 169
wim 0:201dfacbe0e5 170 (*keydata)[idx] = data; // Store keydata after correcting bitorder
wim 0:201dfacbe0e5 171 }
wim 0:201dfacbe0e5 172
wim 0:201dfacbe0e5 173 wait_us(1);
wim 0:201dfacbe0e5 174 _cs=1;
wim 0:201dfacbe0e5 175
wim 0:201dfacbe0e5 176 // Restore Data Write mode
wim 0:201dfacbe0e5 177 _writeCmd(TM1638_DATA_SET_CMD, TM1638_DATA_WR | TM1638_ADDR_INC | TM1638_MODE_NORM); // Data set cmd, normal mode, auto incr, write data
wim 0:201dfacbe0e5 178
wim 0:201dfacbe0e5 179 #if(1)
wim 0:201dfacbe0e5 180 // Dismiss multiple keypresses at same time
wim 0:201dfacbe0e5 181 return (keypress == 1);
wim 0:201dfacbe0e5 182 #else
wim 0:201dfacbe0e5 183 // Allow multiple keypress and accept possible spurious keys
wim 0:201dfacbe0e5 184 return (keypress > 0);
wim 0:201dfacbe0e5 185 #endif
wim 0:201dfacbe0e5 186 }
wim 0:201dfacbe0e5 187
wim 0:201dfacbe0e5 188
wim 0:201dfacbe0e5 189 /** Helper to reverse all command or databits. The TM1638 expects LSB first, whereas SPI is MSB first
wim 0:201dfacbe0e5 190 * @param char data
wim 0:201dfacbe0e5 191 * @return bitreversed data
wim 0:201dfacbe0e5 192 */
wim 0:201dfacbe0e5 193 char TM1638::_flip(char data) {
wim 0:201dfacbe0e5 194 char value=0;
wim 0:201dfacbe0e5 195
wim 0:201dfacbe0e5 196 if (data & 0x01) {value |= 0x80;} ;
wim 0:201dfacbe0e5 197 if (data & 0x02) {value |= 0x40;} ;
wim 0:201dfacbe0e5 198 if (data & 0x04) {value |= 0x20;} ;
wim 0:201dfacbe0e5 199 if (data & 0x08) {value |= 0x10;} ;
wim 0:201dfacbe0e5 200 if (data & 0x10) {value |= 0x08;} ;
wim 0:201dfacbe0e5 201 if (data & 0x20) {value |= 0x04;} ;
wim 0:201dfacbe0e5 202 if (data & 0x40) {value |= 0x02;} ;
wim 0:201dfacbe0e5 203 if (data & 0x80) {value |= 0x01;} ;
wim 0:201dfacbe0e5 204 return value;
wim 0:201dfacbe0e5 205 }
wim 0:201dfacbe0e5 206
wim 0:201dfacbe0e5 207
wim 0:201dfacbe0e5 208 /** Write command and parameter to TM1638
wim 0:201dfacbe0e5 209 * @param int cmd Command byte
wim 0:201dfacbe0e5 210 * &Param int data Parameters for command
wim 0:201dfacbe0e5 211 * @return none
wim 0:201dfacbe0e5 212 */
wim 0:201dfacbe0e5 213 void TM1638::_writeCmd(int cmd, int data){
wim 0:201dfacbe0e5 214
wim 0:201dfacbe0e5 215 _cs=0;
wim 0:201dfacbe0e5 216 wait_us(1);
wim 0:201dfacbe0e5 217 // _spi.write(_flip( (cmd & 0xF0) | (data & 0x0F)));
wim 0:201dfacbe0e5 218 _spi.write(_flip( (cmd & TM1638_CMD_MSK) | (data & ~TM1638_CMD_MSK)));
wim 0:201dfacbe0e5 219
wim 0:201dfacbe0e5 220 wait_us(1);
wim 0:201dfacbe0e5 221 _cs=1;
wim 0:201dfacbe0e5 222 }
wim 0:201dfacbe0e5 223
wim 0:201dfacbe0e5 224
wim 0:201dfacbe0e5 225 #if (LEDKEY8_TEST == 1)
wim 0:201dfacbe0e5 226 // Derived class for TM1638 used in LED&KEY display unit
wim 0:201dfacbe0e5 227 //
wim 0:201dfacbe0e5 228
wim 0:201dfacbe0e5 229 /** Constructor for class for driving TM1638 LED controller as used in LEDKEY8
wim 0:201dfacbe0e5 230 *
wim 0:201dfacbe0e5 231 * @brief Supports 8 Digits of 7 Segments + DP + LED Icons. Also supports a scanned keyboard of 8.
wim 0:201dfacbe0e5 232 *
wim 0:201dfacbe0e5 233 * @param PinName mosi, miso, sclk, cs SPI bus pins
wim 0:201dfacbe0e5 234 */
wim 0:201dfacbe0e5 235 TM1638_LEDKEY8::TM1638_LEDKEY8(PinName mosi, PinName miso, PinName sclk, PinName cs) : TM1638(mosi, miso, sclk, cs) {
wim 0:201dfacbe0e5 236 _column = 0;
wim 0:201dfacbe0e5 237 _columns = LEDKEY8_NR_DIGITS;
wim 0:201dfacbe0e5 238 }
wim 0:201dfacbe0e5 239
wim 0:201dfacbe0e5 240 #if(0)
wim 0:201dfacbe0e5 241 #if DOXYGEN_ONLY
wim 0:201dfacbe0e5 242 /** Write a character to the Display
wim 0:201dfacbe0e5 243 *
wim 0:201dfacbe0e5 244 * @param c The character to write to the display
wim 0:201dfacbe0e5 245 */
wim 0:201dfacbe0e5 246 int putc(int c);
wim 0:201dfacbe0e5 247
wim 0:201dfacbe0e5 248 /** Write a formatted string to the Display
wim 0:201dfacbe0e5 249 *
wim 0:201dfacbe0e5 250 * @param format A printf-style format string, followed by the
wim 0:201dfacbe0e5 251 * variables to use in formatting the string.
wim 0:201dfacbe0e5 252 */
wim 0:201dfacbe0e5 253 int printf(const char* format, ...);
wim 0:201dfacbe0e5 254 #endif
wim 0:201dfacbe0e5 255 #endif
wim 0:201dfacbe0e5 256
wim 0:201dfacbe0e5 257 /** Locate cursor to a screen column
wim 0:201dfacbe0e5 258 *
wim 0:201dfacbe0e5 259 * @param column The horizontal position from the left, indexed from 0
wim 0:201dfacbe0e5 260 */
wim 0:201dfacbe0e5 261 void TM1638_LEDKEY8::locate(int column) {
wim 0:201dfacbe0e5 262 //sanity check
wim 0:201dfacbe0e5 263 if (column < 0) {column = 0;}
wim 0:201dfacbe0e5 264 if (column > (_columns - 1)) {column = _columns - 1;}
wim 0:201dfacbe0e5 265
wim 0:201dfacbe0e5 266 _column = column;
wim 0:201dfacbe0e5 267 }
wim 0:201dfacbe0e5 268
wim 0:201dfacbe0e5 269
wim 0:201dfacbe0e5 270 /** Number of screen columns
wim 0:201dfacbe0e5 271 *
wim 0:201dfacbe0e5 272 * @param none
wim 0:201dfacbe0e5 273 * @return columns
wim 0:201dfacbe0e5 274 */
wim 0:201dfacbe0e5 275 int TM1638_LEDKEY8::columns() {
wim 0:201dfacbe0e5 276 return _columns;
wim 0:201dfacbe0e5 277 }
wim 0:201dfacbe0e5 278
wim 0:201dfacbe0e5 279
wim 0:201dfacbe0e5 280 /** Clear the screen and locate to 0
wim 0:201dfacbe0e5 281 * @param bool clrAll Clear Icons also (default = false)
wim 0:201dfacbe0e5 282 */
wim 0:201dfacbe0e5 283 void TM1638_LEDKEY8::cls(bool clrAll) {
wim 0:201dfacbe0e5 284
wim 0:201dfacbe0e5 285 if (clrAll) {
wim 0:201dfacbe0e5 286 //clear local buffer (including Icons)
wim 0:201dfacbe0e5 287 for (int idx=0; idx < (LEDKEY8_NR_GRIDS << 1); idx++) {
wim 0:201dfacbe0e5 288 _displaybuffer[idx] = 0x00;
wim 0:201dfacbe0e5 289 }
wim 0:201dfacbe0e5 290 }
wim 0:201dfacbe0e5 291 else {
wim 0:201dfacbe0e5 292 //clear local buffer (preserving Icons)
wim 0:201dfacbe0e5 293 for (int idx=0; idx < LEDKEY8_NR_GRIDS; idx++) {
wim 0:201dfacbe0e5 294 _displaybuffer[(idx<<1)] = _displaybuffer[(idx<<1)] & MASK_ICON_GRID[idx][0];
wim 0:201dfacbe0e5 295 _displaybuffer[(idx<<1) + 1] = _displaybuffer[(idx<<1) + 1] & MASK_ICON_GRID[idx][1];
wim 0:201dfacbe0e5 296 }
wim 0:201dfacbe0e5 297 }
wim 0:201dfacbe0e5 298
wim 2:532ce15ea9ec 299 writeData(_displaybuffer, (LEDKEY8_NR_GRIDS * TM1638_BYTES_PER_GRID));
wim 0:201dfacbe0e5 300
wim 0:201dfacbe0e5 301 _column = 0;
wim 0:201dfacbe0e5 302 }
wim 0:201dfacbe0e5 303
wim 0:201dfacbe0e5 304 /** Set Icon
wim 0:201dfacbe0e5 305 *
wim 1:1f2453ed85d7 306 * @param Icon icon Enums Icon has Grid position encoded in 8 MSBs, Icon pattern encoded in 16 LSBs
wim 0:201dfacbe0e5 307 * @return none
wim 0:201dfacbe0e5 308 */
wim 0:201dfacbe0e5 309 void TM1638_LEDKEY8::setIcon(Icon icon) {
wim 0:201dfacbe0e5 310 int addr, icn;
wim 0:201dfacbe0e5 311
wim 1:1f2453ed85d7 312 icn = icon & 0xFFFF;
wim 0:201dfacbe0e5 313 addr = (icon >> 24) & 0xFF;
wim 2:532ce15ea9ec 314 addr = (addr - 1) << 1; // * PT1638_BYTES_PER_GRID
wim 0:201dfacbe0e5 315
wim 0:201dfacbe0e5 316 //Save char...and set bits for icon to write
wim 0:201dfacbe0e5 317 _displaybuffer[addr] = _displaybuffer[addr] | LO(icn);
wim 0:201dfacbe0e5 318 _displaybuffer[addr+1] = _displaybuffer[addr+1] | HI(icn);
wim 2:532ce15ea9ec 319 writeData(_displaybuffer, (LEDKEY8_NR_GRIDS * TM1638_BYTES_PER_GRID));
wim 0:201dfacbe0e5 320 }
wim 0:201dfacbe0e5 321
wim 0:201dfacbe0e5 322 /** Clr Icon
wim 0:201dfacbe0e5 323 *
wim 1:1f2453ed85d7 324 * @param Icon icon Enums Icon has Grid position encoded in 8 MSBs, Icon pattern encoded in 16 LSBs
wim 0:201dfacbe0e5 325 * @return none
wim 0:201dfacbe0e5 326 */
wim 0:201dfacbe0e5 327 void TM1638_LEDKEY8::clrIcon(Icon icon) {
wim 0:201dfacbe0e5 328 int addr, icn;
wim 0:201dfacbe0e5 329
wim 1:1f2453ed85d7 330 icn = icon & 0xFFFF;
wim 0:201dfacbe0e5 331 addr = (icon >> 24) & 0xFF;
wim 2:532ce15ea9ec 332 addr = (addr - 1) << 1; // * TM1638_BYTES_PER_GRID
wim 0:201dfacbe0e5 333
wim 0:201dfacbe0e5 334 //Save char...and clr bits for icon to write
wim 0:201dfacbe0e5 335 _displaybuffer[addr] = _displaybuffer[addr] & ~LO(icn);
wim 0:201dfacbe0e5 336 _displaybuffer[addr+1] = _displaybuffer[addr+1] & ~HI(icn);
wim 2:532ce15ea9ec 337 writeData(_displaybuffer, (LEDKEY8_NR_GRIDS * TM1638_BYTES_PER_GRID));
wim 0:201dfacbe0e5 338 }
wim 0:201dfacbe0e5 339
wim 0:201dfacbe0e5 340
wim 0:201dfacbe0e5 341 /** Set User Defined Characters (UDC)
wim 0:201dfacbe0e5 342 *
wim 0:201dfacbe0e5 343 * @param unsigned char udc_idx The Index of the UDC (0..7)
wim 0:201dfacbe0e5 344 * @param int udc_data The bitpattern for the UDC (8 bits)
wim 0:201dfacbe0e5 345 */
wim 0:201dfacbe0e5 346 void TM1638_LEDKEY8::setUDC(unsigned char udc_idx, int udc_data) {
wim 0:201dfacbe0e5 347
wim 0:201dfacbe0e5 348 //Sanity check
wim 0:201dfacbe0e5 349 if (udc_idx > (LEDKEY8_NR_UDC-1)) {
wim 0:201dfacbe0e5 350 return;
wim 0:201dfacbe0e5 351 }
wim 0:201dfacbe0e5 352 // Mask out Icon bits?
wim 0:201dfacbe0e5 353
wim 0:201dfacbe0e5 354 _UDC_7S[udc_idx] = LO(udc_data);
wim 0:201dfacbe0e5 355 }
wim 0:201dfacbe0e5 356
wim 0:201dfacbe0e5 357
wim 0:201dfacbe0e5 358 /** Write a single character (Stream implementation)
wim 0:201dfacbe0e5 359 */
wim 0:201dfacbe0e5 360 int TM1638_LEDKEY8::_putc(int value) {
wim 0:201dfacbe0e5 361 int addr;
wim 0:201dfacbe0e5 362 bool validChar = false;
wim 0:201dfacbe0e5 363 char pattern = 0x00;
wim 0:201dfacbe0e5 364
wim 0:201dfacbe0e5 365 if ((value == '\n') || (value == '\r')) {
wim 0:201dfacbe0e5 366 //No character to write
wim 0:201dfacbe0e5 367 validChar = false;
wim 0:201dfacbe0e5 368
wim 0:201dfacbe0e5 369 //Update Cursor
wim 0:201dfacbe0e5 370 _column = 0;
wim 0:201dfacbe0e5 371 }
wim 1:1f2453ed85d7 372 else if ((value == '.') || (value == ',')) {
wim 1:1f2453ed85d7 373 //No character to write
wim 1:1f2453ed85d7 374 validChar = false;
wim 1:1f2453ed85d7 375 pattern = S7_DP; // placeholder for all DPs
wim 1:1f2453ed85d7 376
wim 1:1f2453ed85d7 377 // Check to see that DP can be shown for current column
wim 1:1f2453ed85d7 378 if (_column > 0) {
wim 1:1f2453ed85d7 379 //Translate between _column and displaybuffer entries
wim 1:1f2453ed85d7 380 //Add DP to bitpattern of digit left of current column.
wim 2:532ce15ea9ec 381 addr = (_column - 1) << 1; // * PT1638_BYTES_PER_GRID
wim 1:1f2453ed85d7 382
wim 1:1f2453ed85d7 383 //Save icons...and set bits for decimal point to write
wim 1:1f2453ed85d7 384 _displaybuffer[addr] = _displaybuffer[addr] | pattern;
wim 1:1f2453ed85d7 385 // _displaybuffer[addr+1] = _displaybuffer[addr+1] | pattern;
wim 1:1f2453ed85d7 386
wim 2:532ce15ea9ec 387 writeData(_displaybuffer, (LEDKEY8_NR_GRIDS * TM1638_BYTES_PER_GRID));
wim 1:1f2453ed85d7 388
wim 1:1f2453ed85d7 389 //No Cursor Update
wim 1:1f2453ed85d7 390 }
wim 1:1f2453ed85d7 391 }
wim 0:201dfacbe0e5 392 else if ((value >= 0) && (value < LEDKEY8_NR_UDC)) {
wim 0:201dfacbe0e5 393 //Character to write
wim 0:201dfacbe0e5 394 validChar = true;
wim 0:201dfacbe0e5 395 pattern = _UDC_7S[value];
wim 0:201dfacbe0e5 396 }
wim 2:532ce15ea9ec 397
wim 2:532ce15ea9ec 398 #if (SHOW_ASCII == 1)
wim 2:532ce15ea9ec 399 //display all ASCII characters
wim 2:532ce15ea9ec 400 else if ((value >= FONT_7S_START) && (value <= FONT_7S_END)) {
wim 2:532ce15ea9ec 401 //Character to write
wim 2:532ce15ea9ec 402 validChar = true;
wim 2:532ce15ea9ec 403 pattern = FONT_7S[value - FONT_7S_START];
wim 2:532ce15ea9ec 404 } // else
wim 2:532ce15ea9ec 405 #else
wim 2:532ce15ea9ec 406 //display only digits and hex characters
wim 2:532ce15ea9ec 407 else if (value == '-') {
wim 2:532ce15ea9ec 408 //Character to write
wim 2:532ce15ea9ec 409 validChar = true;
wim 2:532ce15ea9ec 410 pattern = C7_MIN;
wim 2:532ce15ea9ec 411 }
wim 0:201dfacbe0e5 412 else if ((value >= (int)'0') && (value <= (int) '9')) {
wim 0:201dfacbe0e5 413 //Character to write
wim 0:201dfacbe0e5 414 validChar = true;
wim 0:201dfacbe0e5 415 pattern = FONT_7S[value - (int) '0'];
wim 0:201dfacbe0e5 416 }
wim 0:201dfacbe0e5 417 else if ((value >= (int) 'A') && (value <= (int) 'F')) {
wim 0:201dfacbe0e5 418 //Character to write
wim 0:201dfacbe0e5 419 validChar = true;
wim 0:201dfacbe0e5 420 pattern = FONT_7S[10 + value - (int) 'A'];
wim 0:201dfacbe0e5 421 }
wim 0:201dfacbe0e5 422 else if ((value >= (int) 'a') && (value <= (int) 'f')) {
wim 0:201dfacbe0e5 423 //Character to write
wim 0:201dfacbe0e5 424 validChar = true;
wim 0:201dfacbe0e5 425 pattern = FONT_7S[10 + value - (int) 'a'];
wim 0:201dfacbe0e5 426 } //else
wim 2:532ce15ea9ec 427 #endif
wim 0:201dfacbe0e5 428
wim 0:201dfacbe0e5 429 if (validChar) {
wim 0:201dfacbe0e5 430 //Character to write
wim 0:201dfacbe0e5 431
wim 0:201dfacbe0e5 432 //Translate between _column and displaybuffer entries
wim 2:532ce15ea9ec 433 addr = _column << 1; // * TM1638_BYTES_PER_GRID
wim 0:201dfacbe0e5 434
wim 0:201dfacbe0e5 435 //Save icons...and set bits for character to write
wim 0:201dfacbe0e5 436 _displaybuffer[addr] = (_displaybuffer[addr] & MASK_ICON_GRID[_column][0]) | pattern;
wim 0:201dfacbe0e5 437 // _displaybuffer[addr+1] = (_displaybuffer[addr+1] & MASK_ICON_GRID[_column][0]) | pattern;
wim 0:201dfacbe0e5 438
wim 2:532ce15ea9ec 439 writeData(_displaybuffer, (LEDKEY8_NR_GRIDS * TM1638_BYTES_PER_GRID));
wim 0:201dfacbe0e5 440
wim 0:201dfacbe0e5 441 //Update Cursor
wim 0:201dfacbe0e5 442 _column++;
wim 0:201dfacbe0e5 443 if (_column > (LEDKEY8_NR_DIGITS - 1)) {
wim 0:201dfacbe0e5 444 _column = 0;
wim 0:201dfacbe0e5 445 }
wim 0:201dfacbe0e5 446
wim 0:201dfacbe0e5 447 } // if validChar
wim 0:201dfacbe0e5 448
wim 0:201dfacbe0e5 449 return value;
wim 0:201dfacbe0e5 450 }
wim 0:201dfacbe0e5 451
wim 0:201dfacbe0e5 452
wim 0:201dfacbe0e5 453 // get a single character (Stream implementation)
wim 0:201dfacbe0e5 454 int TM1638_LEDKEY8::_getc() {
wim 0:201dfacbe0e5 455 return -1;
wim 0:201dfacbe0e5 456 }
wim 0:201dfacbe0e5 457
wim 0:201dfacbe0e5 458 #endif