Library for TM1637 LEDcontroller

Dependents:   mbed_TM1637 TM1637_test

See here for more information.

Revision:
1:f63d87466f55
Parent:
0:dc8789a6e21f
--- a/TM1637.cpp	Sat Jan 30 20:35:25 2016 +0000
+++ b/TM1637.cpp	Fri Oct 06 16:43:56 2017 +0000
@@ -1,5 +1,8 @@
 /* mbed TM1637 Library, for TM1637 LED controller
  * Copyright (c) 2016, v01: WH, Initial version
+ *               2017, v02: WH, Added RobotDyn 6 Digit module,
+ *                          Added Eyewink 6 Digit + 6 Keys module,   
+ *                          Constructor adapted to 2 pins: dio, clk  
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -22,18 +25,46 @@
 #include "mbed.h" 
 #include "TM1637.h"
 
+#if(SPI==1)
 /** Constructor for class for driving TM1637 LED controller with Serial bus interface device. 
- *  @brief Supports 6 digits @ 8 segments. 
- *   
- *  @param  PinName mosi Serial bus MOSI pin
- *  @param  PinName miso Serial bus MISO pin 
- *  @param  PinName sclk Serial bus SCLK pin
-*/
-TM1637::TM1637(PinName mosi, PinName miso, PinName sclk) : _mosi(mosi), _miso(miso), _sclk(sclk) {
+  *
+  * @brief Supports 6 Grids @ 8 segments. Also supports upto 16 Keys. 
+  *        Serial bus interface device.
+  *        DEPRECATED version 
+  *
+  *  @param  PinName mosi_nc  Serial bus NC pin
+  *  @param  PinName miso_dio Serial bus DIO pin  
+  *  @param  PinName sclk_clk Serial bus CLK pin 
+  */
+TM1637::TM1637(PinName mosi_nc, PinName miso_dio, PinName sclk_clk) : _mosi_nc(mosi_nc), _dio(miso_dio), _clk(sclk_clk) {
 
   _init();
 }
 
+/** Constructor for class for driving TM1637 LED controller with Serial bus interface device. 
+ *  @brief Supports 6 digits @ 8 segments. Also supports upto 16 Keys.
+ *   
+ *  @param  PinName dio Serial bus DIO pin 
+ *  @param  PinName clk Serial bus CLK pin
+*/
+TM1637::TM1637(PinName dio, PinName clk) : _mosi_nc(NC), _dio(dio), _clk(clk) {
+
+  _init();
+}
+#else
+
+/** Constructor for class for driving TM1637 LED controller with Serial bus interface device. 
+ *  @brief Supports 6 digits @ 8 segments. Also supports upto 16 Keys.
+ *   
+ *  @param  PinName dio Serial bus DIO pin 
+ *  @param  PinName clk Serial bus CLK pin
+*/
+TM1637::TM1637(PinName dio, PinName clk) : _dio(dio), _clk(clk) {
+
+  _init();
+}
+
+#endif
 /** Init the Serial interface and the controller
   * @param  none
   * @return none
@@ -42,9 +73,14 @@
   
 //TM1637 uses a Serial bus that looks like I2C, but really is not.
 //It has Start and Stop conditions like I2C and an Ack pulse, but instead of slaveaddresses and a RW bit it just transmits commands and data.
+
 //init Serial bus
-  _mosi=1;
-  _sclk=1;  
+  _dio.output();
+//  _dio.mode(PullUp);
+  wait_us(1);
+
+  _dio=1;  
+  _clk=1;  
 
 //init controller  
   _display = TM1637_DSP_ON;
@@ -141,7 +177,6 @@
 /** Read keydata block from TM1637
   *  @param  *keydata Ptr to bytes for keydata
   *  @return bool keypress True when at least one key was pressed
-  *
   */   
 bool TM1637::getKeys(KeyData_t *keydata) {
 
@@ -151,7 +186,9 @@
   _write(TM1637_DATA_SET_CMD | TM1637_KEY_RD | TM1637_ADDR_INC | TM1637_MODE_NORM); // Data set cmd, normal mode, auto incr, read data
 
   // Read keys
-  *keydata = _read(0xFF);
+  // Bitpattern S0 S1 S2 K1 K2 1 1 1  
+  *keydata = _read();
+//  printf("Key = 0x%02x\r\n", *keydata);
 
   _stop();  
   
@@ -168,9 +205,9 @@
   */ 
 void TM1637::_start() {
 
-  _mosi=0;
+  _dio=0;
   wait_us(1);
-  _sclk=0;
+  _clk=0;
   wait_us(1);
 }
   
@@ -180,11 +217,11 @@
   */ 
 void TM1637::_stop() {
 
-  _mosi=0;
+  _dio=0;
   wait_us(1);  
-  _sclk=1;
+  _clk=1;
   wait_us(1);
-  _mosi=1;
+  _dio=1;
   wait_us(1);
 }
 
@@ -197,65 +234,85 @@
   for (int bit=0; bit<8; bit++) {    
     //The TM1637 expects LSB first
     if (((data >> bit) & 0x01) == 0x01) {
-      _mosi=1;      
+      _dio=1;      
     }
     else {    
-      _mosi=0;      
+      _dio=0;      
     }  
     wait_us(1);
-    _sclk=1;
+    _clk=1;
     wait_us(1);
-    _sclk=0;  
+    _clk=0;  
     wait_us(1);
   }  
+
+  _dio=1;
   
+  // Prepare DIO to read data
+  _dio.input();
+  wait_us(3);
+      
   // dummy Ack
-  _sclk=1;
+  _clk=1;
   wait_us(1);
-  _sclk=0;  
+//  _ack = _dio;  
+  _clk=0;  
   wait_us(1); 
+  
+  // Return DIO to output mode
+  _dio.output();  
+  wait_us(3);  
+
+  _dio=1; //idle  
 }
 
 /** Read byte from TM1637
-  *  @param  int senddata
   *  @return read byte 
   */ 
-char TM1637::_read(int data) {
+char TM1637::_read() {
   char keycode = 0;
-   
-  for (int bit=0; bit<8; bit++) {    
-    
-    // Prepare to read next bit, LSB first    
-    keycode = keycode << 1;  
+
+  // Prepare DIO to read data
+  _dio.input();
+  wait_us(3);
     
-    //The TM1637 expects LSB first
-    if (((data >> bit) & 0x01) == 0x01) {
-      _mosi=1;      
-    }
-    else {    
-      _mosi=0;      
-    }  
+  for (int bit=0; bit<8; bit++) {    
+   
+    //The TM1637 sends bitpattern: S0 S1 S2 K1 K2 1 1 1
+    //Data is shifted out by the TM1637 on the falling edge of CLK
+    //Observe sufficient delay to allow the Open Drain DIO to rise to H levels
+    // Prepare to read next bit, LSB (ie S0) first. 
+    // The code below flips bits for easier matching with datasheet
+    keycode = keycode << 1;  
+
+    _clk=1;
     wait_us(1);
-    _sclk=1;
-    wait_us(1);
+    
+    // Read next bit
+    if (_dio) { keycode |= 0x01; }        
 
-    // Read next bit, LSB first
-    if (_miso) { keycode |= 0x01; }
-
-    _sclk=0;  
-    wait_us(1);
+    _clk=0;        
+    wait_us(5); // Delay to allow for slow risetime
   }  
   
+  // Return DIO to output mode
+  _dio.output();
+  wait_us(3);  
+
   // dummy Ack
-  _sclk=1;
+  _dio=0; //Ack   
   wait_us(1);
-  _sclk=0;  
+  
+  _clk=1;
+  wait_us(1);
+  _clk=0;  
   wait_us(1); 
 
+  _dio=1; //idle
+
   return keycode;
 }
 
-
 /** Write command and parameter to TM1637
   *  @param  int cmd Command byte
   *  &Param  int data Parameters for command
@@ -275,15 +332,31 @@
 // Derived class for TM1637 used in LED&KEY display unit
 //
 
+#if(SPI==1)
 /** Constructor for class for driving TM1637 LED controller as used in CATALEX
   *
-  *  @brief Supports 8 Digits of 7 Segments + DP.
+  *  @brief Supports 4 Digits of 7 Segments + DP (or Colon for Digit2 on some models).
+  *         DEPRECATED version 
   *   
-  *  @param  PinName mosi Serial bus MOSI pin
-  *  @param  PinName miso Serial bus MISO pin  
-  *  @param  PinName sclk Serial bus SCLK pin
+  *  @param  PinName mosi_nc  Serial bus NC pin
+  *  @param  PinName miso_dio Serial bus DIO pin  
+  *  @param  PinName sclk_clk Serial bus CLK pin
   */
-TM1637_CATALEX::TM1637_CATALEX(PinName mosi, PinName miso, PinName sclk) : TM1637(mosi, miso, sclk) {
+TM1637_CATALEX::TM1637_CATALEX(PinName mosi_nc, PinName miso_dio, PinName sclk_clk) : TM1637(mosi_nc, miso_dio, sclk_clk) {
+  _column  = 0;
+  _columns = CATALEX_NR_DIGITS;    
+}  
+#endif
+
+/** Constructor for class for driving TM1637 LED controller
+ *
+ * @brief Supports 4 Digits of 7 Segments + DP (or Colon for Digit2 on some models).
+ *        Serial bus interface device. 
+ *
+ *  @param  PinName dio Serial bus DIO pin
+ *  @param  PinName sck Serial bus CLK pin 
+ */
+TM1637_CATALEX::TM1637_CATALEX(PinName dio, PinName clk) : TM1637(dio, clk) {
   _column  = 0;
   _columns = CATALEX_NR_DIGITS;    
 }  
@@ -346,7 +419,7 @@
     }  
   }
 
-  writeData(_displaybuffer, (CATALEX_NR_GRIDS * TM1637_BYTES_PER_GRID));
+  writeData(_displaybuffer, (CATALEX_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
 
   _column = 0;   
 }     
@@ -365,7 +438,7 @@
     
   //Save char...and set bits for icon to write
   _displaybuffer[addr] = _displaybuffer[addr] | LO(icn);      
-//  writeData(_displaybuffer, (CATALEX_NR_GRIDS * TM1637_BYTES_PER_GRID));
+//  writeData(_displaybuffer, (CATALEX_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
   writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);  
 }
 
@@ -383,7 +456,7 @@
     
   //Save char...and clr bits for icon to write
   _displaybuffer[addr] = _displaybuffer[addr] & ~LO(icn);      
-//  writeData(_displaybuffer, (CATALEX_NR_GRIDS * TM1637_BYTES_PER_GRID));
+//  writeData(_displaybuffer, (CATALEX_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
   writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);    
 }
 
@@ -408,6 +481,11 @@
 /** Write a single character (Stream implementation)
   */
 int TM1637_CATALEX::_putc(int value) {
+//The CATALAX mapping between Digit positions (Left to Right) and Grids is:
+//  GR1 GR2 GR3 GR4
+//The memory addresses or column numbers are:
+//   0   1   2   3
+    
     int addr;
     bool validChar = false;
     char pattern   = 0x00;
@@ -505,3 +583,490 @@
 }
 
 #endif
+
+#if (ROBOTDYN_TEST == 1) 
+// Derived class for TM1637 used in ROBOTDYN display unit
+//
+
+/** Constructor for class for driving TM1637 LED controller as used in ROBOTDYN
+  *
+  *  @brief Supports 6 Digits of 7 Segments + DP.
+  *   
+  *  @param  PinName dio Serial bus DIO pin
+  *  @param  PinName clk Serial bus CLK pin
+  */
+TM1637_ROBOTDYN::TM1637_ROBOTDYN(PinName dio, PinName clk) : TM1637(dio, clk) {
+  _column  = 0;
+  _columns = ROBOTDYN_NR_DIGITS;    
+}  
+
+
+#if(0)
+#if DOXYGEN_ONLY
+    /** Write a character to the Display
+     *
+     * @param c The character to write to the display
+     */
+    int putc(int c);
+
+    /** Write a formatted string to the Display
+     *
+     * @param format A printf-style format string, followed by the
+     *               variables to use in formatting the string.
+     */
+    int printf(const char* format, ...);   
+#endif
+#endif
+
+/** Locate cursor to a screen column
+  *
+  * @param column  The horizontal position from the left, indexed from 0
+  */
+void TM1637_ROBOTDYN::locate(int column) {
+  //sanity check
+  if (column < 0) {column = 0;}
+  if (column > (_columns - 1)) {column = _columns - 1;}  
+  
+  _column = column;       
+}
+
+
+/** Number of screen columns
+  *
+  * @param none
+  * @return columns
+  */
+int TM1637_ROBOTDYN::columns() {
+    return _columns;
+}
+
+    
+/** Clear the screen and locate to 0
+  * @param bool clrAll Clear Icons also (default = false)
+  */ 
+void TM1637_ROBOTDYN::cls(bool clrAll) {  
+
+  if (clrAll) {
+    //clear local buffer (including Icons)
+    for (int idx=0; idx < ROBOTDYN_NR_GRIDS; idx++) {
+      _displaybuffer[idx] = 0x00;  
+    }
+  }  
+  else {
+    //clear local buffer (preserving Icons)
+    for (int idx=0; idx < ROBOTDYN_NR_GRIDS; idx++) {
+      _displaybuffer[idx] = _displaybuffer[idx] & MASK_ICON_GRID[idx];  
+    }  
+  }
+
+  writeData(_displaybuffer, (ROBOTDYN_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
+
+  _column = 0;   
+}     
+
+/** Set Icon
+  *
+  * @param Icon icon Enums Icon has Grid position encoded in 8 MSBs, Icon pattern encoded in 16 LSBs
+  * @return none
+  */
+void TM1637_ROBOTDYN::setIcon(Icon icon) {
+  int addr, icn;
+
+   icn =        icon  & 0xFFFF;
+  addr = (icon >> 24) & 0xFF; 
+  addr = (addr - 1);
+    
+  //Save char...and set bits for icon to write
+  _displaybuffer[addr] = _displaybuffer[addr] | LO(icn);      
+//  writeData(_displaybuffer, (ROBOTDYN_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
+  writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);  
+}
+
+/** Clr Icon
+  *
+  * @param Icon icon Enums Icon has Grid position encoded in 8 MSBs, Icon pattern encoded in 16 LSBs
+  * @return none
+  */
+void TM1637_ROBOTDYN::clrIcon(Icon icon) {
+  int addr, icn;
+
+   icn =        icon  & 0xFFFF;
+  addr = (icon >> 24) & 0xFF; 
+  addr = (addr - 1);
+    
+  //Save char...and clr bits for icon to write
+  _displaybuffer[addr] = _displaybuffer[addr] & ~LO(icn);      
+//  writeData(_displaybuffer, (ROBOTDYN_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
+  writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);    
+}
+
+
+/** Set User Defined Characters (UDC)
+  *
+  * @param unsigned char udc_idx  The Index of the UDC (0..7)
+  * @param int udc_data           The bitpattern for the UDC (8 bits)       
+  */
+void TM1637_ROBOTDYN::setUDC(unsigned char udc_idx, int udc_data) {
+
+  //Sanity check
+  if (udc_idx > (ROBOTDYN_NR_UDC-1)) {
+    return;
+  }
+  // Mask out Icon bits?
+
+  _UDC_7S[udc_idx] = LO(udc_data);
+}
+
+/** Write a single character (Stream implementation)
+  *
+  */
+int TM1637_ROBOTDYN::_putc(int value) {
+//The ROBOTDYN mapping between Digit positions (Left to Right) and Grids is:
+//  GR3 GR2 GR1 GR6 GR5 GR4
+//The memory addresses or column numbers are:
+//   2   1   0   5   4   3
+//The Grids are reversed for 2 sets of 3 digits: 
+    const int col2addr[] = {2, 1, 0, 5, 4, 3};
+
+    int addr;
+    bool validChar = false;
+    char pattern   = 0x00;
+    
+    if ((value == '\n') || (value == '\r')) {
+      //No character to write
+      validChar = false;
+      
+      //Update Cursor      
+      _column = 0;
+    }
+    else if ((value == '.') || (value == ',')) {
+      //No character to write
+      validChar = false;
+      pattern = S7_DP; // placeholder for all DPs
+      
+      // Check to see that DP can be shown for current column
+      if (_column > 0) {
+        //Translate between _column and displaybuffer entries
+        //Add DP to bitpattern of digit left of current column.
+        addr = col2addr [_column - 1];
+      
+        //Save icons...and set bits for decimal point to write
+        _displaybuffer[addr] = _displaybuffer[addr] | pattern;
+//        writeData(_displaybuffer, (ROBOTDYN_NR_GRIDS * TM1637_BYTES_PER_GRID));
+        writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr); 
+        
+        //No Cursor Update
+      }
+    }
+    else if ((value >= 0) && (value < ROBOTDYN_NR_UDC)) {
+      //Character to write
+      validChar = true;
+      pattern = _UDC_7S[value];
+    }  
+    
+#if (SHOW_ASCII == 1)
+    //display all ASCII characters
+    else if ((value >= FONT_7S_START) && (value <= FONT_7S_END)) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[value - FONT_7S_START];
+    } // else
+#else    
+    //display only digits and hex characters      
+    else if (value == '-') {
+      //Character to write
+      validChar = true;
+      pattern = C7_MIN;         
+    }
+    else if ((value >= (int)'0') && (value <= (int) '9')) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[value - (int) '0'];
+    }
+    else if ((value >= (int) 'A') && (value <= (int) 'F')) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[10 + value - (int) 'A'];
+    }
+    else if ((value >= (int) 'a') && (value <= (int) 'f')) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[10 + value - (int) 'a'];
+    } //else
+#endif
+
+    if (validChar) {
+      //Character to write
+ 
+      //Translate between _column and displaybuffer entries
+      addr = col2addr[_column];
+
+      //Save icons...and set bits for character to write
+      _displaybuffer[addr] = (_displaybuffer[addr] & MASK_ICON_GRID[_column]) | pattern;
+
+//      writeData(_displaybuffer, (ROBOTDYN_NR_GRIDS * TM1637_BYTES_PER_GRID));
+      writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);        
+                                
+      //Update Cursor
+      _column++;
+      if (_column > (ROBOTDYN_NR_DIGITS - 1)) {
+        _column = 0;
+      }
+
+    } // if validChar           
+
+    return value;
+}
+
+
+// get a single character (Stream implementation)
+int TM1637_ROBOTDYN::_getc() {
+    return -1;
+}
+
+#endif
+
+
+#if (EYEWINK_TEST == 1) 
+// Derived class for TM1637 used in EYEWINK display unit
+//
+
+/** Constructor for class for driving TM1637 LED controller as used in EYEWINK
+  *
+  *  @brief Supports 6 Digits of 7 Segments + DP and 6 Keys.
+  *   
+  *  @param  PinName dio Serial bus DIO pin
+  *  @param  PinName clk Serial bus CLK pin
+  */
+TM1637_EYEWINK::TM1637_EYEWINK(PinName dio, PinName clk) : TM1637(dio, clk) {
+  _column  = 0;
+  _columns = EYEWINK_NR_DIGITS;    
+}  
+
+
+#if(0)
+#if DOXYGEN_ONLY
+    /** Write a character to the Display
+     *
+     * @param c The character to write to the display
+     */
+    int putc(int c);
+
+    /** Write a formatted string to the Display
+     *
+     * @param format A printf-style format string, followed by the
+     *               variables to use in formatting the string.
+     */
+    int printf(const char* format, ...);   
+#endif
+#endif
+
+/** Locate cursor to a screen column
+  *
+  * @param column  The horizontal position from the left, indexed from 0
+  */
+void TM1637_EYEWINK::locate(int column) {
+  //sanity check
+  if (column < 0) {column = 0;}
+  if (column > (_columns - 1)) {column = _columns - 1;}  
+  
+  _column = column;       
+}
+
+
+/** Number of screen columns
+  *
+  * @param none
+  * @return columns
+  */
+int TM1637_EYEWINK::columns() {
+    return _columns;
+}
+
+    
+/** Clear the screen and locate to 0
+  * @param bool clrAll Clear Icons also (default = false)
+  */ 
+void TM1637_EYEWINK::cls(bool clrAll) {  
+
+  if (clrAll) {
+    //clear local buffer (including Icons)
+    for (int idx=0; idx < EYEWINK_NR_GRIDS; idx++) {
+      _displaybuffer[idx] = 0x00;  
+    }
+  }  
+  else {
+    //clear local buffer (preserving Icons)
+    for (int idx=0; idx < EYEWINK_NR_GRIDS; idx++) {
+      _displaybuffer[idx] = _displaybuffer[idx] & MASK_ICON_GRID[idx];  
+    }  
+  }
+
+  writeData(_displaybuffer, (EYEWINK_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
+
+  _column = 0;   
+}     
+
+/** Set Icon
+  *
+  * @param Icon icon Enums Icon has Grid position encoded in 8 MSBs, Icon pattern encoded in 16 LSBs
+  * @return none
+  */
+void TM1637_EYEWINK::setIcon(Icon icon) {
+  int addr, icn;
+
+   icn =        icon  & 0xFFFF;
+  addr = (icon >> 24) & 0xFF; 
+  addr = (addr - 1);
+    
+  //Save char...and set bits for icon to write
+  _displaybuffer[addr] = _displaybuffer[addr] | LO(icn);      
+//  writeData(_displaybuffer, (EYEWINK_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
+  writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);  
+}
+
+/** Clr Icon
+  *
+  * @param Icon icon Enums Icon has Grid position encoded in 8 MSBs, Icon pattern encoded in 16 LSBs
+  * @return none
+  */
+void TM1637_EYEWINK::clrIcon(Icon icon) {
+  int addr, icn;
+
+   icn =        icon  & 0xFFFF;
+  addr = (icon >> 24) & 0xFF; 
+  addr = (addr - 1);
+    
+  //Save char...and clr bits for icon to write
+  _displaybuffer[addr] = _displaybuffer[addr] & ~LO(icn);      
+//  writeData(_displaybuffer, (EYEWINK_NR_GRIDS * TM1637_BYTES_PER_GRID), 0);
+  writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);    
+}
+
+
+/** Set User Defined Characters (UDC)
+  *
+  * @param unsigned char udc_idx  The Index of the UDC (0..7)
+  * @param int udc_data           The bitpattern for the UDC (8 bits)       
+  */
+void TM1637_EYEWINK::setUDC(unsigned char udc_idx, int udc_data) {
+
+  //Sanity check
+  if (udc_idx > (EYEWINK_NR_UDC-1)) {
+    return;
+  }
+  // Mask out Icon bits?
+
+  _UDC_7S[udc_idx] = LO(udc_data);
+}
+
+/** Write a single character (Stream implementation)
+  *
+  */
+int TM1637_EYEWINK::_putc(int value) {
+//The EYEWINK mapping between Digit positions (Left to Right) and Grids is:
+//  GR1 GR2 GR3 GR4 GR5 GR6
+//The memory addresses or column numbers are:
+//   0   1   2   3   4   5
+//The Grids for all digits: 
+//    const int col2addr[] = {0, 1, 2, 3, 4, 5};
+
+    int addr;
+    bool validChar = false;
+    char pattern   = 0x00;
+    
+    if ((value == '\n') || (value == '\r')) {
+      //No character to write
+      validChar = false;
+      
+      //Update Cursor      
+      _column = 0;
+    }
+    else if ((value == '.') || (value == ',')) {
+      //No character to write
+      validChar = false;
+      pattern = S7_DP; // placeholder for all DPs
+      
+      // Check to see that DP can be shown for current column
+      if (_column > 0) {
+        //Translate between _column and displaybuffer entries
+        //Add DP to bitpattern of digit left of current column.
+//        addr = col2addr [_column - 1];
+        addr = _column - 1;
+      
+        //Save icons...and set bits for decimal point to write
+        _displaybuffer[addr] = _displaybuffer[addr] | pattern;
+//        writeData(_displaybuffer, (EYEWINK_NR_GRIDS * TM1637_BYTES_PER_GRID));
+        writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr); 
+        
+        //No Cursor Update
+      }
+    }
+    else if ((value >= 0) && (value < EYEWINK_NR_UDC)) {
+      //Character to write
+      validChar = true;
+      pattern = _UDC_7S[value];
+    }  
+    
+#if (SHOW_ASCII == 1)
+    //display all ASCII characters
+    else if ((value >= FONT_7S_START) && (value <= FONT_7S_END)) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[value - FONT_7S_START];
+    } // else
+#else    
+    //display only digits and hex characters      
+    else if (value == '-') {
+      //Character to write
+      validChar = true;
+      pattern = C7_MIN;         
+    }
+    else if ((value >= (int)'0') && (value <= (int) '9')) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[value - (int) '0'];
+    }
+    else if ((value >= (int) 'A') && (value <= (int) 'F')) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[10 + value - (int) 'A'];
+    }
+    else if ((value >= (int) 'a') && (value <= (int) 'f')) {   
+      //Character to write
+      validChar = true;
+      pattern = FONT_7S[10 + value - (int) 'a'];
+    } //else
+#endif
+
+    if (validChar) {
+      //Character to write
+ 
+      //Translate between _column and displaybuffer entries
+//      addr = col2addr[_column];
+      addr = _column;      
+
+      //Save icons...and set bits for character to write
+      _displaybuffer[addr] = (_displaybuffer[addr] & MASK_ICON_GRID[_column]) | pattern;
+
+//      writeData(_displaybuffer, (EYEWINK_NR_GRIDS * TM1637_BYTES_PER_GRID));
+      writeData(_displaybuffer, TM1637_BYTES_PER_GRID, addr);        
+                                
+      //Update Cursor
+      _column++;
+      if (_column > (EYEWINK_NR_DIGITS - 1)) {
+        _column = 0;
+      }
+
+    } // if validChar           
+
+    return value;
+}
+
+
+// get a single character (Stream implementation)
+int TM1637_EYEWINK::_getc() {
+    return -1;
+}
+
+#endif
\ No newline at end of file