База знаний · Датчики и модули
TM1637 и MAX7219: цифры, матрицы и бегущая строка
Четыре цифры на двух проводах и матрицы, которые собираются в бегущую строку: как подключить, какую библиотеку взять и почему матрица молчит или пишет задом наперёд.
В уроке 25 одна цифра индикатора забирала у платы семь выводов, и выручала её микросхема-счётчик CD4026. Готовые модули решают задачу иначе: внутри стоит контроллер, который сам зажигает сегменты, а от Arduino нужны два-три провода. Самые распространённые — TM1637 на четыре цифры и MAX7219, на котором собирают матрицы 8×8 и бегущие строки. Устроены они по-разному, и спотыкаются на них тоже по-разному.
Чем они отличаются
| Что | TM1637 | MAX7219 |
|---|---|---|
| Что показывает | 4 цифры с двоеточием или точками; микросхема умеет до 6 | 8 цифр или матрицу 8×8; модули собирают в цепочки |
| Провода | CLK и DIO — любые два вывода | DIN, CLK и CS; быстрее всего — через аппаратный SPI |
| Обмен | Свой двухпроводный, не I²C: адреса нет | 16-битные посылки, совместим с SPI |
| Несколько штук | Каждому — своя пара выводов | Цепочкой: DOUT одного — на DIN следующего |
| Яркость | 8 неравных ступеней | 16 ступеней |
| Питание и логика | 5 В; единица на входе — от 0,7 питания | 4–5,5 В; единица — от 3,5 В |
| Библиотека | TM1637 (Avishay Orpaz) | LedControl; для бегущей строки — MD_Parola |
TM1637: четыре цифры на двух проводах
VCC — на 5V, GND — на землю, CLK и DIO — на любые два вывода, в скетче ниже это 2 и 3. Два провода сбивают с толку: похоже на I²C, но протокол свой. Адреса у TM1637 нет, и сканер I²C тут не помощник. На одну шину с датчиками I²C его тоже не посадишь: микросхема подтверждает каждый байт, который слышит, и примет чужой обмен за свои команды. Библиотека сама прижимает линии к земле или отпускает их, а единицу дают подтяжки на модуле — резисторы 10 кОм к питанию.
// Секундомер на индикаторе TM1637: минуты и секунды с мигающим двоеточием.
// CLK — вывод 2, DIO — вывод 3, VCC — 5V, GND — GND. Библиотека TM1637 (Avishay Orpaz).
#include <TM1637Display.h>
const byte CLK = 2;
const byte DIO = 3;
TM1637Display display(CLK, DIO);
void setup() {
display.setBrightness(2); // 0…7; включится вместе со следующей записью цифр
display.clear();
}
void loop() {
unsigned long seconds = millis() / 1000;
int mmss = (seconds / 60 % 100) * 100 + seconds % 60;
bool colon = seconds % 2 == 0;
display.showNumberDecEx(mmss, colon ? 0b01000000 : 0, true); // true — с ведущими нулями
delay(100);
}
На Uno скетч берёт 1 820 байт флеша и 30 байт ОЗУ. showNumberDecEx() с маской 0b01000000 зажигает двоеточие; у модулей с точками между цифрами та же маска зажжёт точку после второй цифры. Последний аргумент true оставляет ведущие нули: на индикаторе «00:07», а не одинокая семёрка справа.
И деталь из описания самой библиотеки: setBrightness() не меняет яркость сразу, а лишь запоминает её. Индикатор возьмёт новое значение со следующей записью цифр, поэтому без вывода чисел яркость не изменится. На TM1637 собран и Trema-модуль четырёхразрядного индикатора, у него своя библиотека — iarduino_4LED.
MAX7219: матрица 8×8
MAX7219 управляет 64 светодиодами — восемью разрядами по восемь сегментов — и сам их перебирает, плате остаётся только присылать данные. Выводов три: DIN, CLK и CS. Библиотека LedControl дёргает их программно, поэтому подойдут любые; в скетче — 12, 11 и 10, как в примерах самой библиотеки.
// Смайлик на матрице 8×8 с MAX7219 через библиотеку LedControl.
// DIN — вывод 12, CLK — 11, CS — 10; VCC — 5V, GND — GND.
#include <LedControl.h>
LedControl matrix(12, 11, 10, 1); // DIN, CLK, CS, сколько модулей в цепочке
const byte SMILE[8] = {
0b00111100,
0b01000010,
0b10100101,
0b10000001,
0b10100101,
0b10011001,
0b01000010,
0b00111100
};
void setup() {
matrix.shutdown(0, false); // после включения MAX7219 спит — будим
matrix.setIntensity(0, 4); // яркость 0…15
matrix.clearDisplay(0);
for (byte row = 0; row < 8; row++) {
matrix.setRow(0, row, SMILE[row]);
}
}
void loop() {}
Первую строку setup() не пропускайте. После включения MAX7219 спит, и LedControl при старте сам переводит микросхему в сон. Без shutdown(0, false) матрица останется тёмной при верных проводах и рабочем скетче. Яркость — от 0 до 15. На полной яркости, когда горят все 64 точки, модуль берёт около 330 мА — так указано в даташите: 40 мА на сегмент, и в каждый момент горит разряд из восьми сегментов. Во флеше смайлик занимает 1 410 байт. Если он лёг на бок или нахмурился, у модуля другая разводка — разверните модуль. На тех же MAX7219 продают и восьмиразрядные цифровые индикаторы — для них у LedControl есть setDigit() и setChar().
Бегущая строка на сборке 32×8
Четыре матрицы на одной плате — это четыре MAX7219 в цепочке. Для текста и эффектов удобна библиотека MD_Parola, она ставится вместе с MD_MAX72XX. Сборку подключают к аппаратному SPI: на Uno DIN — на 11-й вывод, CLK — на 13-й, CS — на 10-й. Что это за выводы и почему они именно такие, разобрано на странице про шину SPI.
// Бегущая строка на сборке из четырёх матриц MAX7219 (32×8).
// Аппаратный SPI Uno: DIN — 11, CLK — 13, CS — 10, GND — GND.
// VCC — на 5V платы, а если сборку питает отдельный блок 5 В, то только на блок.
#include <MD_Parola.h>
#include <MD_MAX72xx.h>
#include <SPI.h>
#define HARDWARE_TYPE MD_MAX72XX::FC16_HW // если буквы кривые — попробуйте другой тип
const byte MAX_DEVICES = 4;
const byte CS_PIN = 10;
MD_Parola display(HARDWARE_TYPE, CS_PIN, MAX_DEVICES);
void setup() {
display.begin();
display.setIntensity(3); // 0…15; на полной яркости вся сборка берёт больше ампера
// Сдвиг на столбец раз в 60 мс, пауза 0 — строка бежит без остановок.
display.displayText("Trema IDE", PA_LEFT, 60, 0, PA_SCROLL_LEFT, PA_SCROLL_LEFT);
}
void loop() {
if (display.displayAnimate()) {
display.displayReset(); // строка уехала — запускаем снова
}
}
Строка бежит без остановок: пауза в displayText() равна нулю. Паузу посередине стоит давать только короткой надписи. В 32 столбца сборки влезает слово из пяти-шести букв, а «Trema IDE» занимает 45 столбцов. Длинный текст на паузе замрёт обрезанным: библиотека останавливает его, как только въехала последняя буква. Короткому слову вроде «Trema» подойдут PA_CENTER и пауза 1000 мс — оно въедет, постоит секунду по центру и уедет дальше.
Флеша скетч берёт 19 820 байт — больше 60 % Uno: в библиотеке шрифт и десятки эффектов. Отчёт компилятора показывает всего 103 байта ОЗУ, ещё около 120 библиотека возьмёт при запуске под буфер матриц и зону текста.
Главная ловушка — строка HARDWARE_TYPE и то, как лежит сборка. Большинство готовых сборок 32×8 — типа FC-16, это написано на плате. Библиотека рассчитывает, что вход DIN у такой сборки справа, как на схеме; надпись на плате при этом бывает вверх ногами. Дальше — разводка: у одних модулей разряды MAX7219 идут строками, у других столбцами, где-то перевёрнуты столбцы или строки. Библиотека знает четыре распространённых типа — FC16_HW, GENERIC_HW, PAROLA_HW и ICSTATION_HW, а всего вариантов разводки восемь. Не тот тип — и буквы бегут зеркально, вверх ногами или рассыпаются на столбики. Лечится перебором: поменяли тип, залили, посмотрели. Если не подошёл ни один, поможет пример MD_MAX72xx_HW_Mapper из библиотеки MD_MAX72XX. Он гоняет по одной матрице полоску и точку, задаёт вопросы в мониторе порта (по-английски, скорость 57600) и в конце называет тип — или три признака, из которых складывается длинное имя вроде DR1CR0RR1_HW.
Вторая ловушка — инструкции, написанные для старых версий библиотеки. В них стоит MD_Parola P = MD_Parola(CS_PIN, MAX_DEVICES) без типа модуля. На Uno такой скетч собирается без единого слова, хотя ошибка грубая: число 10 становится типом модуля (под этим номером в библиотеке записана разводка, как у PAROLA_HW), вывод CS — четвёртым, а модулей в цепочке — один. Сборка на 10-м выводе такого скетча не услышит. Предупреждение компилятор выдаёт, только если включить предупреждения в настройках среды. На ESP32 та же строка честно не собирается: «invalid conversion from 'int' to 'MD_MAX72XX::moduleType_t'». Показывает компилятор при этом на строку #define CS_PIN 10, а исправлять надо строку с MD_Parola, куда это число подставлено.
Русские буквы встроенный шрифт не знает. В кавычках скетча они записаны в UTF-8, по два байта на букву, и на матрице появятся чужие значки. Готовый русский шрифт лежит в примере Parola_Double_Height_v1_Russian самой MD_Parola, и разложен он хитро: буквы стоят на местах второго байта UTF-8, а коды первых байтов, 208 и 209, пустые, нулевой ширины. Поэтому текст в кавычках пишется по-русски как есть, без перекодировки. Буквы там двухэтажные, под две сборки одна над другой, но тот же приём годится и для своего шрифта в одну строку: нарисовать буквы на местах 128–191, а 208 и 209 оставить пустыми. Не выйдет только ё: её второй байт совпадает с «Б», а у Ё — с «с». Пример Parola_UFT-8_Display — название с опечаткой — тут не поможет: он перекодирует латиницу с диакритикой, а кириллицу выбрасывает.
Платы на 3,3 В: ESP32, ESP8266, Pico
MAX7219 по даташиту принимает за единицу не меньше 3,5 В, а ESP32 даёт 3,3. Часто это работает, но без гарантии: на длинных проводах появляется мусор. Надёжно — поставить между платой и сборкой буфер 74HCT125 или 74HCT245 и питать его от 5 В: микросхемы серии HCT понимают 3,3 В как единицу и отдают дальше полные 5 В. У 74HCT125 выводы разрешения /OE сажают на землю. У 74HCT245 /OE тоже на землю, а DIR — на 5 В: тогда данные идут со стороны A, от платы, на сторону B, к сборке.
У TM1637 единица — от 0,7 питания, при 5 В это те же 3,5 В. Вдобавок подтяжки на модуле тянут линии к его питанию: модуль от 5 В поднимает CLK и DIO до 5 В, а выводы ESP32 рассчитаны на 3,3. Буфер, как для MAX7219, тут не годится: по линии DIO микросхема отвечает плате, сигнал идёт в обе стороны. Модуль часто питают от 3,3 В, но это ниже паспорта: даташит описывает работу при 4,5–5,5 В. Проще взять модуль с I²C: у индикатора FLASH-I2C питание 3,3 или 5 В на выбор, и уровень на линиях равен питанию.
Ошибки и что за ними стоит
| Сообщение или симптом | Что случилось |
|---|---|
| Матрица на MAX7219 не светится совсем | В скетче на LedControl нет shutdown(0, false), в скетче на MD_Parola — begin(). Ещё бывает: провода от платы пришли на выходной разъём DOUT, а не на DIN, или у отдельного блока питания нет общей земли с платой. |
| Бегущая строка зеркальная, вверх ногами или рассыпается | Сначала посмотрите, где у сборки вход DIN: у FC-16 он должен оказаться справа, надпись на плате при этом бывает вверх ногами. Если DIN справа, а буквы всё равно кривые — не тот HARDWARE_TYPE: перебирайте FC16_HW, GENERIC_HW, PAROLA_HW и ICSTATION_HW. |
| Скетч из старой инструкции собрался, а матрица молчит | В нём MD_Parola(CS_PIN, MAX_DEVICES) без типа модуля: на Uno первое число молча становится типом, второе — выводом CS. Допишите тип первым аргументом. |
| invalid conversion from 'int' to 'MD_MAX72XX::moduleType_t' | Та же старая строка, собранная под ESP32: там компилятор строже и не пропускает её. Показывает он на строку #define CS_PIN 10, а исправлять надо строку с MD_Parola, куда это число подставлено. |
| TM1637 показывает мусор или ничего | Перепутаны CLK и DIO или нет общей земли. Номера в конструкторе — сначала CLK, потом DIO. |
| Сканер I²C не видит TM1637 или «находит» что-то сразу на многих адресах | Так и должно быть: это не I²C, адреса у микросхемы нет. Если модуль посадили на A4 и A5, он может подтверждать любой байт, отсюда и «устройства» на многих адресах. |
| setBrightness() не меняет яркость | Новая яркость включается со следующей записью цифр. И ступени с 3-й по 7-ю отличаются на глаз слабо. |
| Плата перезагружается, матрица мигает на полной яркости | Не хватает тока: сборка 32×8 со всеми точками берёт больше ампера. Снизьте setIntensity() или питайте сборку от отдельного блока 5 В с общей землёй — VCC сборки тогда отключите от вывода 5V платы. |
| TM1637Display.h: No such file or directory | Не установлена библиотека. В каталоге она называется TM1637, автор — Avishay Orpaz. Trema IDE найдёт её по имени файла сама: после неудачной сборки предложит поставить библиотеку и собрать проект заново, а если окно закрыть, кнопка «Установить библиотеку и собрать заново» останется в карточке ошибки. |
| Смайлик на матрице лёг на бок или нахмурился | У модуля другая разводка: разряды MAX7219 идут столбцами или строки перевёрнуты. Смайлик симметричен слева направо, так что хватит развернуть модуль. |
Что купить
Для бегущей строки — светодиодная матрица 32×8 на MAX7219: красная за 480 ₽, зелёная и синяя — по 620 ₽. Четыре цифры на TM1637 — Trema-модуль индикатора: белый и синий по 594 ₽, зелёный за 504 ₽. Для плат на 3,3 В — индикатор FLASH-I2C за 378 ₽. А матрица 8×8 с I²C за 360 ₽ держит внутри свой буфер бегущей строки на 512 символов, питание у неё — 5 В. Цены — на 15.11.2026.
Частые вопросы
Как подключить индикатор TM1637 к Arduino?
VCC — на 5V, GND — на землю, CLK и DIO — на любые два цифровых вывода, например 2 и 3. В скетче библиотека TM1637: TM1637Display display(2, 3) — сначала CLK, потом DIO. Число выводит showNumberDec(), с двоеточием — showNumberDecEx(число, 0b01000000, true).
TM1637 работает по I2C?
Нет. Проводов два, как у I2C, но протокол свой и адреса нет. Сканер I2C тут не помощник, а на одну шину с датчиками I2C индикатор не посадить: микросхема подтверждает каждый байт, который слышит. Каждому TM1637 нужна своя пара выводов.
Почему матрица на MAX7219 не светится?
После включения MAX7219 спит, и библиотека LedControl при старте тоже переводит его в сон. Первой строкой в setup() нужен вызов shutdown(0, false). Если он есть — проверьте, что провода от платы пришли на разъём DIN, а не DOUT, и что у отдельного блока питания есть общая земля с платой.
Почему бегущая строка на MD_Parola показывает буквы зеркально или вверх ногами?
Сначала проверьте, как лежит сборка: у FC-16 вход DIN должен быть справа, надпись на плате при этом бывает вверх ногами. Если так и есть, в скетче не тот тип модуля в HARDWARE_TYPE: сборки разных производителей разведены по-разному. Попробуйте по очереди MD_MAX72XX::FC16_HW, GENERIC_HW, PAROLA_HW и ICSTATION_HW.
Сколько тока берёт матрица MAX7219?
Одна матрица 8×8 на полной яркости со всеми горящими точками — около 330 мА, сборка 32×8 — больше ампера. USB-порт и предохранитель Uno рассчитаны на 0,5 А, поэтому снижайте яркость setIntensity() или питайте сборку от отдельного блока 5 В с общей землёй. VCC сборки тогда подключают только к блоку, не к выводу 5V платы.
Можно ли подключить MAX7219 или TM1637 к ESP32?
Напрямую — без гарантии. MAX7219 по даташиту принимает за единицу не меньше 3,5 В, а ESP32 выдаёт 3,3; надёжный путь — буфер 74HCT125 или 74HCT245 с питанием 5 В. С TM1637 такой буфер не поможет: линия DIO у него двусторонняя. К тому же подтяжки на модуле поднимают линии до его питания, и модуль от 5 В подаёт на выводы ESP32 5 В. Для плат на 3,3 В проще взять индикатор с I2C, который питается от 3,3 В.
Как вывести русский текст на матрицу MAX7219?
Встроенный шрифт MD_Parola русских букв не знает: в скетче они записаны в UTF-8, по два байта на букву, и на матрице выйдут чужие значки. Готовый русский шрифт есть в примере Parola_Double_Height_v1_Russian: буквы в нём стоят на местах второго байта UTF-8, поэтому текст в кавычках пишется по-русски как есть. Шрифт двухэтажный, под две сборки одна над другой, но тот же приём годится и для своего шрифта в одну строку. Пример Parola_UFT-8_Display кириллицу не обрабатывает.
Читайте также
Обновлено: 15 ноября 2026
