alexey.zholtikov/upm
1
0
Fork 0
mirror of https://github.com/eclipse/upm.git synced 2025-07-02 01:41:12 +03:00
Code Issues Actions Packages Projects Releases Wiki Activity

tm1637: brand new working implementation

Browse Source 
Signed-off-by: Mihai Tudor Panu <mihai.tudor.panu@intel.com>
This commit is contained in:
Mihai Tudor Panu
2015-04-08 16:02:59 -07:00
parent 1d0284abaf
commit 828d3b928e
10 changed files with 595 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
src/tm1637/CMakeLists.txt Normal file
View File

@ -0,0 +1,5 @@
set (libname "tm1637")
set (libdescription "C++ API for the TM1637 7-segment display")
set (module_src ${libname}.cxx)
set (module_h ${libname}.h)
upm_module_init()

21
src/tm1637/jsupm_tm1637.i Normal file
View File

@ -0,0 +1,21 @@
%module jsupm_tm1637
%include "../upm.i"
%include "../carrays_uint8_t.i"
%varargs(4, int digit = 0) write;
%rename("writeArray") write(uint8_t *digits);
%rename("writeString") write(std::string digits);
%typemap(in) uint8_t * {
void *argp = 0 ;
int res = SWIG_ConvertPtr($input, &argp, SWIGTYPE_p_uint8Array, 0 | 0);
$1 = (uint8_t *)(argp);
}
%{
#include "tm1637.h"
%}
%include "tm1637.h"

16
src/tm1637/pyupm_tm1637.i Normal file
View File

@ -0,0 +1,16 @@
%module pyupm_tm1637
%include "../upm.i"
%include "../carrays_uint8_t.i"
%varargs(4, int digit = 0) write;
%typemap(in) uint8_t * {
void *argp = 0 ;
int res = SWIG_ConvertPtr($input, &argp,SWIGTYPE_p_uint8Array, 0 | 0 );
$1 = reinterpret_cast< uint8_t * >(argp);
}
%{
#include "tm1637.h"
%}
%include "tm1637.h"

204
src/tm1637/tm1637.cxx Normal file
View File

@ -0,0 +1,204 @@
/*
* Author: Mihai Tudor Panu <mihai.tudor.panu@intel.com>
* Copyright (c) 2015 Intel Corporation.
*
* 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 "tm1637.h"
#include <stdarg.h>
const uint8_t m_brkt[2] = {0x39, 0x0f};
const uint8_t m_nums[10] = {0x3f, 0x06, 0x5b, 0x4f, 0x66,
0x6d, 0x7d, 0x07, 0x7f, 0x6f};
const uint8_t m_char[26] = {0x77, 0x7c, 0x39, 0x5e, 0x79,
0x71, 0x6f, 0x76, 0x30, 0x1e,
0x00, 0x38, 0x00, 0x00, 0x5c,
0x73, 0x67, 0x50, 0x5b, 0x78,
0x3e, 0x1c, 0x00, 0x00, 0x6e,
0x5b};
using namespace std;
using namespace upm;
upm::TM1637::TM1637(int clk_pin, int dio_pin, int bright, M_FAST_GPIO mmio) {
if((m_clk = mraa_gpio_init(clk_pin)) == NULL){
cerr << "TM1637: failed to initialize CLK pin." << endl;
return;
}
if((m_dio = mraa_gpio_init(dio_pin)) == NULL){
cerr << "TM1637: failed to initialize DIO pin." << endl;
return;
}
mraa_gpio_dir(m_clk, MRAA_GPIO_OUT);
mraa_gpio_dir(m_dio, MRAA_GPIO_OUT);
// Let the resistors pull the lines high
mraa_gpio_mode(m_clk, MRAA_GPIO_PULLUP);
mraa_gpio_mode(m_dio, MRAA_GPIO_PULLUP);
if(mmio){
if(mraa_gpio_use_mmaped(m_clk, 1) != MRAA_SUCCESS ||
mraa_gpio_use_mmaped(m_dio, 1) != MRAA_SUCCESS){
cerr << "TM1637: failed to set memory mapped GPIO" << endl;
return;
}
}
mraa_gpio_write(m_clk, 0);
mraa_gpio_write(m_dio, 0);
for (int i = 0; i < M_DISPLAY_DIGITS; i++) {
m_digits[i] = 0x00;
}
setBrightness(bright);
}
upm::TM1637::~TM1637() {
for (int i = 0; i < M_DISPLAY_DIGITS; i++) {
m_digits[i] = 0x00;
}
update();
mraa_gpio_close(m_clk);
mraa_gpio_close(m_dio);
}
mraa_result_t upm::TM1637::write(uint8_t *digits) {
for (int i = 0; i < M_DISPLAY_DIGITS; i++) {
m_digits[i] = digits[i];
}
update();
return MRAA_SUCCESS;
}
mraa_result_t upm::TM1637::write(int d, ...) {
va_list args;
va_start(args, d);
m_digits[0] = (uint8_t)d;
for (int i = 1; i < M_DISPLAY_DIGITS; i++) {
m_digits[i] = (uint8_t)va_arg(args, int);
d++;
}
va_end(args);
update();
return MRAA_SUCCESS;
}
mraa_result_t upm::TM1637::writeAt(int index, char symbol) {
if(index < 0 || index >= M_DISPLAY_DIGITS){
cerr << "TM1637: invalid index in " << __FUNCTION__ << endl;
return MRAA_ERROR_INVALID_PARAMETER;
}
m_digits[index] = encode(symbol);
update();
return MRAA_SUCCESS;
}
mraa_result_t upm::TM1637::write(std::string digits) {
int len = digits.length();
if( len > M_DISPLAY_DIGITS){
len = M_DISPLAY_DIGITS;
}
for (int i = 0; i < len; i++) {
m_digits[i] = encode(digits[i]);
}
update();
return MRAA_SUCCESS;
}
void upm::TM1637::setColon(bool value) {
if(value){
m_digits[1] |= 0x80;
}
else{
m_digits[1] &= 0x7f;
}
update();
}
void upm::TM1637::setBrightness(int value) {
m_brightness = value & 0x07;
update();
}
void upm::TM1637::i2c_start() {
mraa_gpio_write(m_clk, 1);
mraa_gpio_write(m_dio, 1);
mraa_gpio_write(m_dio, 0);
}
void upm::TM1637::i2c_stop() {
mraa_gpio_write(m_clk, 0);
mraa_gpio_write(m_dio, 0);
mraa_gpio_write(m_clk, 1);
mraa_gpio_write(m_dio, 1);
}
void upm::TM1637::i2c_writeByte(uint8_t value) {
for(uint8_t i = 0; i < 8; i++)
{
mraa_gpio_write(m_clk, 0);
if(value & 0x01)
mraa_gpio_write(m_dio, 1);
else
mraa_gpio_write(m_dio, 0);
value >>= 1;
mraa_gpio_write(m_clk, 1);
}
// Ack clock without skew, TM1637 is fast enough
mraa_gpio_write(m_clk, 0);
mraa_gpio_write(m_clk, 1);
mraa_gpio_write(m_clk, 0);
}
void upm::TM1637::update() {
i2c_start();
i2c_writeByte(TM1637_ADDR);
i2c_stop();
i2c_start();
i2c_writeByte(TM1637_REG);
for (int i = 0; i < M_DISPLAY_DIGITS; i++) {
i2c_writeByte(m_digits[i]);
}
i2c_stop();
i2c_start();
i2c_writeByte(TM1637_CMD | m_brightness);
i2c_stop();
}
uint8_t upm::TM1637::encode(char c) {
if(c >= '0' && c <= '9')
return m_nums[(int)c - 48];
if(c >= 'a' && c <= 'z')
return m_char[(int)c - 97];
if(c >= 'A' && c <= 'Z')
return m_char[(int)c - 65];
if(c == '[')
return m_brkt[0];
if(c == ']')
return m_brkt[1];
if(c == '(' || c == ')')
return m_brkt[(int)c - 40];
if(c == '-')
return 0x40;
if(c == '_')
return 0x08;
if(c == '}')
return 0x70;
if(c == '{')
return 0x46;
return 0x00;
}

149
src/tm1637/tm1637.h Normal file
View File

@ -0,0 +1,149 @@
/*
* Author: Mihai Tudor Panu <mihai.tudor.panu@intel.com>
* Copyright (c) 2015 Intel Corporation.
*
* 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.
*/
#pragma once
#include <unistd.h>
#include <stdint.h>
#include <string>
#include <iostream>
#include <mraa/gpio.h>
// TM1637 specific register addresses for writing all digits at a time
#define TM1637_ADDR 0x40
#define TM1637_REG 0xC0
#define TM1637_CMD 0x88
// Display specific values
#define M_DISPLAY_DIGITS 4
namespace upm
{
/**
* @brief TM1637 7-segment display library
* @defgroup tm1637 libupm-tm1637
* @ingroup seeed gpio display
*/
/**
* @library tm1637
* @sensor tm1637
* @comname TM1637 7-Segment Display
* @type display
* @man seeed
* @con gpio
*
* @brief C++ API for TM1637 (7-segment display)
*
* The TM1637 is a display controller for LED based 7-segment displays.
* It can be used to address and write data to multiple display digits. This
* driver is based on the Grove version of the TM1637 display which uses 4
* digits thus making it ideal for clock displays, timers, counters or even
* score display in a two player arcade game.
*
* @image html tm1637.jpeg
* @snippet tm1637.cxx Interesting
*/
class TM1637
{
public:
/**
* Enum for memory mapped GPIO
*/
typedef enum {
NO = 0,
YES = 1
} M_FAST_GPIO;
/**
* TM1637 constructor
*
* @param clk_pin the clock pin the sensor is connected to
* @param dio_pin the data pin the sensor is connected to
* @param bright initial brightness from 0 to 7 dark to bright (default 3)
* @param mmio fast memory mapped gpio writes, default is yes
*/
TM1637(int clk_pin, int dio_pin, int bright = 3, M_FAST_GPIO mmio = YES);
/**
* TM1637 destructor
*/
~TM1637();
/**
* Write digits to the display in 7 segment encoding
*
* @param digits an array of digits to send to the display
* @return 0 if the write was successful, error code otherwise
*/
mraa_result_t write(uint8_t *digits);
/**
* Write digits to the display in 7 segment encoding
*
* @param d list of multiple arguments to send to the display
* @return 0 if the write was successful, error code otherwise
*/
mraa_result_t write(int d, ...);
/**
* Write a symbol (digit or letter) to the display at a specified index
*
* @param index 0-based index of the digit to change from the left
* @param symbol the digit or letter to display
* @return 0 if the write was successful, error code otherwise
*/
mraa_result_t writeAt(int index, char symbol);
/**
* Write all the digits or letters to the display as a string
*
* @param digits a string of symbols to display
* @return 0 if the write was successful, error code otherwise
*/
mraa_result_t write(std::string digits);
/**
* Toggles the colon between digits on the display
*
* @param value pass true to turn on the colon, false to turn it off
*/
void setColon(bool value);
/**
* Use to control the brightness of the display
*
* @param value between 0 and 7, darkest to brightest
*/
void setBrightness(int value);
private:
void i2c_start();
void i2c_stop();
void i2c_writeByte(uint8_t value);
void update();
uint8_t encode(char c);
mraa_gpio_context m_clk, m_dio;
std::string m_name;
uint8_t m_digits[4];
uint8_t m_brightness;
};
}