Library for the Grove 4 digit display, for use with the NCS36510 mbed board

Fork of DigitDisplay by Seeed Studio

Files at this revision

API Documentation at this revision

Comitter:
seeed
Date:
Sat Feb 08 05:42:09 2014 +0000
Commit message:
initial

Changed in this revision

DigitDisplay.cpp Show annotated file Show diff for this revision Revisions of this file
DigitDisplay.h Show annotated file Show diff for this revision Revisions of this file
diff -r 000000000000 -r d3173c8bfd48 DigitDisplay.cpp
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/DigitDisplay.cpp	Sat Feb 08 05:42:09 2014 +0000
@@ -0,0 +1,317 @@
+/* The library of Grove - 4 Digit Display
+ *
+ * \author  Yihui Xiong
+ * \date    2014/2/8
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2014 Seeed Technology Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#include "DigitDisplay.h"
+
+#define ADDR_AUTO  0x40
+#define ADDR_FIXED 0x44
+
+#define POSITION_COLON 1
+
+#define DIGIT_UNKOWN 0x08
+#define DIGIT_NULL   0x00
+#define DIGIT_MINUS  0x40
+
+const uint8_t DIGIT_TABLE[] = {0x3f, 0x06, 0x5b, 0x4f,
+                              0x66, 0x6d, 0x7d, 0x07,
+                              0x7f, 0x6f, 0x77, 0x7c,
+                              0x39, 0x5e, 0x79, 0x71
+                             }; //0~9,A,b,C,d,E,F
+
+
+inline uint8_t conv(uint8_t n)
+{
+    uint8_t segments;
+    
+    if (n <= sizeof(DIGIT_TABLE)) {
+        segments = DIGIT_TABLE[n];
+    }else if (n == 0xFF) {
+        segments = DIGIT_NULL;
+    } else {
+        segments = DIGIT_UNKOWN;
+    }
+    
+    return segments;
+}
+
+DigitDisplay::DigitDisplay(PinName clk, PinName dio) : _clk(clk), _dio(dio)
+{
+    _dio.output();
+    _dio = 1;
+    _clk = 1;
+    
+    _brightness = 2;
+    _colon      = false;
+    _off        = true;
+    
+    for (uint8_t i = 0; i < sizeof(_content); i++) {
+        _content[i] = DIGIT_NULL;
+    }
+}
+
+void DigitDisplay::on()
+{
+    start();
+    send(0x88 | _brightness);
+    stop();
+}
+
+void DigitDisplay::off()
+{
+    start();
+    send(0x80);
+    stop();
+}
+
+void DigitDisplay::setBrightness(uint8_t brightness)
+{
+    if (brightness > 7) {
+        brightness = 7;
+    }
+    
+    _brightness = brightness;
+    
+    start();
+    send(0x88 | _brightness);
+    stop();
+}
+
+void DigitDisplay::setColon(bool enable)
+{
+    if (_colon != enable) {
+        _colon = enable;
+        
+        if (enable) {
+            _content[POSITION_COLON] |= 0x80;
+        } else {
+            _content[POSITION_COLON] &= 0x7F;
+        }
+        
+        writeRaw(POSITION_COLON, _content[POSITION_COLON]);
+    }    
+}
+    
+void DigitDisplay::write(int16_t n)
+{
+    uint8_t negative = 0;
+    
+    if (n < 0) {
+        negative = 1;
+        n = (-n) % 1000;
+    } else {
+        n = n % 10000;
+    }
+    
+    int8_t i = 3;
+    do {
+        uint8_t  r = n % 10;
+        _content[i] = conv(r);
+        i--;
+        n = n / 10;
+    } while (n != 0);
+    
+    if (negative) {
+        _content[i] = DIGIT_MINUS;
+        i--;
+    }
+    
+    for (int8_t j = 0; j <= i; j++) {
+        _content[j] = DIGIT_NULL;
+    }
+    
+    if (_colon) {
+        _content[POSITION_COLON] |= 0x80;
+    }
+    
+    writeRaw(_content);
+}
+
+void DigitDisplay::write(uint8_t numbers[])
+{
+    for (uint8_t i = 0; i < 4; i++) {
+        _content[i] = conv(numbers[i]);
+    }
+    
+    if (_colon) {
+        _content[POSITION_COLON] |= 0x80;
+    }
+    
+    start();
+    send(ADDR_AUTO);
+    stop();
+    start();
+    send(0xC0);
+    for (uint8_t i = 0; i < 4; i++) {
+        send(_content[i]);
+    }
+    stop();
+    
+    if (_off) {
+        _off = 0;
+        start();
+        send(0x88 | _brightness);
+        stop();
+    }
+}
+
+void DigitDisplay::write(uint8_t position, uint8_t number)
+{
+    if (position >= 4) {
+        return;
+    }
+    
+    uint8_t segments = conv(number);
+    
+    if ((position == POSITION_COLON) && _colon) {
+        segments |= 0x80;
+    }
+    
+    _content[position] = segments;
+    
+    start();
+    send(ADDR_FIXED);
+    stop();
+    start();
+    send(0xC0 | position);
+    send(segments);
+    stop();
+    
+    if (_off) {
+        _off = 0;
+        start();
+        send(0x88 | _brightness);
+        stop();
+    }
+}
+
+void DigitDisplay::writeRaw(uint8_t segments[])
+{
+    for (uint8_t i = 0; i < 4; i++) {
+        _content[i] = segments[i];
+    }
+    
+    start();
+    send(ADDR_AUTO);
+    stop();
+    start();
+    send(0xC0);
+    for (uint8_t i = 0; i < 4; i++) {
+        send(segments[i]);
+    }
+    stop();
+    
+    if (_off) {
+        _off = 0;
+        start();
+        send(0x88 | _brightness);
+        stop();
+    }
+}
+
+void DigitDisplay::writeRaw(uint8_t position, uint8_t segments)
+{
+    if (position >= 4) {
+        return;
+    }
+    
+    _content[position] = segments;
+
+    start();
+    send(ADDR_FIXED);
+    stop();
+    start();
+    send(0xC0 | position);
+    send(segments);
+    stop();
+
+    if (_off) {
+        _off = 0;
+        start();
+        send(0x88 | _brightness);
+        stop();
+    }
+}
+
+void DigitDisplay::clear()
+{
+    for (uint8_t i = 0; i < 4; i++) {
+        _content[i] = DIGIT_NULL;
+    }
+    _colon = false;
+    
+    writeRaw(0, DIGIT_NULL);
+    writeRaw(1, DIGIT_NULL);
+    writeRaw(2, DIGIT_NULL);
+    writeRaw(3, DIGIT_NULL);
+}
+    
+void DigitDisplay::start()
+{
+    _clk = 1;
+    _dio = 1;
+    _dio = 0;
+    _clk = 0;
+}
+
+bool DigitDisplay::send(uint8_t data)
+{
+    for (uint8_t i = 0; i < 8; i++) {
+        _clk = 0;
+        _dio = data & 1;
+        data >>= 1;
+        _clk = 1;
+    }
+    
+    // check ack
+    _clk = 0;
+    _dio = 1;
+    _clk = 1;
+    _dio.input();
+    
+    uint16_t count = 0;
+    while (_dio) {
+        count++;
+        if (count >= 200) {
+            _dio.output();
+            return false;
+        }
+    }
+    
+    _dio.output();
+    return true;
+}
+
+void DigitDisplay::stop()
+{
+    _clk = 0;
+    _dio = 0;
+    _clk = 1;
+    _dio = 1;
+}
+
+
diff -r 000000000000 -r d3173c8bfd48 DigitDisplay.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/DigitDisplay.h	Sat Feb 08 05:42:09 2014 +0000
@@ -0,0 +1,96 @@
+/* The library of Grove - 4 Digit Display
+ *
+ * \author  Yihui Xiong
+ * \date    2014/2/8
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2014 Seeed Technology Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#ifndef __DIGIT_DISPLAY__
+#define __DIGIT_DISPLAY__
+
+#include "mbed.h"
+
+class DigitDisplay
+{
+public:
+    DigitDisplay(PinName clk, PinName dio);
+    
+    /**
+     * Display a decimal number, A number larger than 10000 or smaller than -1000 will be truncated, MSB will be lost.
+     */
+    void write(int16_t number);
+    
+    /**
+     * Display four numbers
+     * \param   numbers     0 - 0xF:     0 - 9, A, b, C, d, E, F
+     *                      0x10 - 0xFE: '_'(unknown)
+     *                      0xFF:        ' '(null)
+     */
+    void write(uint8_t numbers[]);
+    
+    /**
+     * Display a number in a specific position
+     * \param   position    0 - 3, left to right
+     * \param   number      0 - 0xF:     0 - 9, A, b, C, d, E, F
+     *                      0x10 - 0xFE: '_'
+     *                      0xFF:        ' '
+     */
+    void write(uint8_t position, uint8_t number);
+    
+    void writeRaw(uint8_t position, uint8_t segments);
+    void writeRaw(uint8_t segments[]);
+    
+    void clear();
+    void on();
+    void off();
+    
+    /**
+     * Set the brightness, level 0 to level 7
+     */
+    void setBrightness(uint8_t brightness);
+    
+    /**
+     * Enable/Disable the colon
+     */
+    void setColon(bool enable);
+    
+    DigitDisplay& operator= (int16_t number) {
+        write(number);
+        return *this;
+    }
+    
+private:
+    void start();
+    bool send(uint8_t data);
+    void stop();
+    
+    DigitalOut   _clk;
+    DigitalInOut _dio;
+    bool         _off;
+    bool         _colon;
+    uint8_t      _brightness;
+    uint8_t      _content[4];
+};
+
+#endif // __DIGIT_DISPLAY__