TM1638plus

Table of contents

• Overview
• Installation
• Software
• Documentation
• Tested

Overview

• Name: TM1638plus
• Description:

An Arduino library to display data on a 8-digit TM1638 seven segment module's. This library supports all 3 of the known models on market. see Documentation section below. As of version 2.2.0 the library also supports TM1637 & MAX7219 seven segment module's.

• Main Author: Gavin Lyons.

Installation

The library is included in the official Arduino library manger and the optimum way to install it is using the library manager which can be opened by the manage libraries option in Arduino IDE. Search "tm1638" in search bar of library manager to find it.

See link below for instruction for this and for the other methods too.

Installing Additional Arduino Libraries guide

Software

Class system

Debug messages

Debug messages can be turned on by setting displaylib_LED_debug to true, these will be sent to serial monitor in event of some error's or warning's.

Documentation

The API (application programming interface) html documentation is at link. Hosted on github pages and generated by Doxygen software. Here the user will find lots of information on files, functions & data types.

Software API Url Link

This library supports three variants of the TM1638, which for purposes of this documentation, will be named Model 1, Model 2 and Model 3.
The library also supports two variants of TM1637(model 4 & 5),
and the MAX7219 seven segment modules(model 6)

Model Name	PCB Labels	LEDs	Push buttons	Digits
Model 1	TM1638 LED & KEY	8 red only	8	8
Model 2	TM1638 KEYS, QYF	0	16	8
Model 3	TM1638 V1.3 or LKM1638	8 bi color, red or green	8	8
Model 4	TM1637	centered semi:colon	0	4
Model 5	TM1637	0	0	4
Model 6	MAX7219	0	0	8

Component name	Type	Interface	Readme URL link
TM1638	seven segment module	GPIO	Readme
TM1637	seven segment module	GPIO	Readme
MAX7219	seven segment module	SPI HW & SW	Readme

Models 1-3 Pictured left to right.

Model 4-5

Model 6

Tested

• Tested on following MCU & Development platforms.
• Examples files are set up for Arduino UNO R4
• File GPIO_OTHER_MCUs.txt in extra folder gives pins tested for other MCU(tm1638)

1. Arduino UNO & NANO v3.
2. ESP32.
3. STM32 STM32F103C8T6 "the blue pill".
4. ESP8266.
5. Teensy 4.0. (may not work at highest frequency see note #2 in notes section)
6. Arduino R4 minima