A lightweight and efficient TM1637 display driver written in C for STM32 (HAL-based).

This library provides an easy way to interface STM32 MCUs with the TM1637 7-segment LED display driver — commonly used in digital clocks, voltmeters, and similar projects.
It supports 1–6 digits, brightness control, and formatted string display.

• 🔹 Supports 1 to 6 digits (configurable)
• 🔹 Adjustable brightness levels (0–8)
• 🔹 Displays numbers, characters, and strings
• 🔹 Supports formatted printing (printf)
• 🔹 Full STM32 HAL compatibility
• 🔹 Simple and portable API design
• 🔹 Example and video tutorial included

You can install in two ways:

Add these files to your STM32 project:

• tm1637.h
• tm1637.c
• tm1637_config.h

Available in the official pack repo:
👉 STM32-PACK

1. CLK (Clock) Pin – Configure as Output Open-Drain
2. DIO (Data I/O) Pin – Configure as Output Open-Drain
3. No timer or interrupt configuration is needed

To ensure latency in 'tm1637_config.h', set it to a large value and then adjust it for faster response.

TM1637_DELAY     10

#include "tm1637.h"

tm1637_t seg = 
{
    .seg_cnt  = 4,             // Number of digits
    .gpio_clk = GPIOA,         // CLK pin port
    .gpio_dat = GPIOA,         // DIO pin port
    .pin_clk  = GPIO_PIN_1,    // CLK pin number
    .pin_data = GPIO_PIN_2,    // DIO pin number
};

tm1637_init(&seg);
tm1637_str(&seg, "1234");

If you find this project useful, please ⭐ the repo and consider supporting me:

Licensed under the terms in the LICENSE.