TM1637 Class Reference

C++ API for TM1637 (7-segment display) More...

Detailed Description

• ID: tm1637
• Name: TM1637 7-Segment Display
• Category: display
• Manufacturer: seeed
• Connection: gpio

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.

    bool point = true;
    int timezone = -7; // Your UTC offset
    time_t rawtime;
    struct tm * gmt;
    char myTime[4];

    fprintf(stdout, "TM1637 Display Example\n");
    signal(SIGINT, sig_handler);

    TM1637 myDisplay = TM1637(0, 1); // TM1637 on pins 0 (clk) and 1 (dio)
    myDisplay.write(0x39, 0x09, 0x09); // Start a box using 7-segment encoding
    myDisplay.writeAt(3, ']'); // Finish box using writeAt function
    sleep(3); // Wait 3 seconds

    while(run)
    {
        time(&rawtime); // Update raw time
        gmt = gmtime(&rawtime); // Get current time

        // Format and store the time in 24 hour format
        sprintf(myTime, "%2d%02d", (gmt->tm_hour + timezone + 24) % 24, gmt->tm_min);

        myDisplay.write(myTime); // Write to display as string
        myDisplay.setColon(point ^= true); // Toggle the dots on the display
        sleep(1); // Only update once every second
    }

Public Types
enum	M_FAST_GPIO { NO = 0, YES = 1 }

Public Member Functions
	TM1637 (int clk_pin, int dio_pin, int bright=3, M_FAST_GPIO mmio=YES)
	~TM1637 ()
mraa_result_t	write (uint8_t *digits)
mraa_result_t	write (int d,...)
mraa_result_t	writeAt (int index, char symbol)
mraa_result_t	write (std::string digits)
void	setColon (bool value)
void	setBrightness (int value)

Constructor & Destructor Documentation

TM1637	(	int	clk_pin,
		int	dio_pin,
		int	bright = 3,
		M_FAST_GPIO	mmio = YES
	)

TM1637 constructor

Parameters

clk_pin	the clock pin the sensor is connected to
dio_pin	the data pin the sensor is connected to
bright	initial brightness from 0 to 7 dark to bright (default 3)
mmio	fast memory mapped gpio writes, default is yes

~TM1637

(

)

TM1637 destructor

Member Function Documentation

mraa_result_t write

(

uint8_t *

digits

)

Write digits to the display in 7 segment encoding

Parameters

digits

an array of digits to send to the display

Returns

0 if the write was successful, error code otherwise

mraa_result_t write	(	int	d,
			...
	)

Write digits to the display in 7 segment encoding

Parameters

d	list of multiple arguments to send to the display

Returns

0 if the write was successful, error code otherwise

mraa_result_t writeAt	(	int	index,
		char	symbol
	)

Write a symbol (digit or letter) to the display at a specified index

Parameters

index	0-based index of the digit to change from the left
symbol	the digit or letter to display

Returns

0 if the write was successful, error code otherwise

mraa_result_t write

(

std::string

digits

)

Write all the digits or letters to the display as a string

Parameters

digits

a string of symbols to display

Returns

0 if the write was successful, error code otherwise

void setColon

(

bool

value

)

Toggles the colon between digits on the display

Parameters

value

pass true to turn on the colon, false to turn it off

void setBrightness

(

int

value

)

Use to control the brightness of the display

Parameters

value

between 0 and 7, darkest to brightest

---

The documentation for this class was generated from the following files:

• /var/lib/jenkins/workspace/upm-doc-stable/src/tm1637/tm1637.h
• /var/lib/jenkins/workspace/upm-doc-stable/src/tm1637/tm1637.cxx