База знаний · Датчики и модули

TM1637 и MAX7219: цифры, матрицы и бегущая строка

Четыре цифры на двух проводах и матрицы, которые собираются в бегущую строку: как подключить, какую библиотеку взять и почему матрица молчит или пишет задом наперёд.

В уроке 25 одна цифра индикатора забирала у платы семь выводов, и выручала её микросхема-счётчик CD4026. Готовые модули решают задачу иначе: внутри стоит контроллер, который сам зажигает сегменты, а от Arduino нужны два-три провода. Самые распространённые — TM1637 на четыре цифры и MAX7219, на котором собирают матрицы 8×8 и бегущие строки. Устроены они по-разному, и спотыкаются на них тоже по-разному.

Чем они отличаются

ЧтоTM1637MAX7219
Что показывает4 цифры с двоеточием или точками; микросхема умеет до 68 цифр или матрицу 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()1/1602/1614/16210/16311/16412/16513/16614/167ступень в setBrightness()С 3-й ступени прибавка — по 1/16:на глаз 3 и 7 отличаются слабо
Ступени яркости у TM1637 неравные. От 0 к 3 доля свечения растёт вдесятеро, а дальше прибавляется по одной шестнадцатой. Поэтому для дома хватает 1–2, а 7 нужна разве что на солнце.

И деталь из описания самой библиотеки: 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.

Сборка 32×8 — это четыре MAX7219 в цепочкемодуль 1модуль 2модуль 3модуль 4← данные идут налево: DOUT модуля — на DIN следующегоCLKCSDINGNDVCCвходArduino UnoD13D10D11GND5V — свободен+−Блок 5 В, от 2 Аплюс — только к VCC сборкиобщая земля —обязательноDIN — данные, идут по цепочкеCLK — такт, общий для всехCS — сигнал «принять», общийVCC и GND — питание
У сборки FC-16 вход справа: так её задумала библиотека MD_MAX72XX, надпись на плате при этом бывает вверх ногами. Внутри данные бегут справа налево, DOUT каждого модуля — на DIN следующего, а такт и CS общие. С отдельным блоком 5 В к Arduino идут четыре провода: DIN, CLK, CS и GND, а VCC сборки — только к плюсу блока, не к выводу 5V. Блок нужен, когда горит много точек: на полной яркости сборка берёт больше ампера, а USB-порт и предохранитель Uno рассчитаны на 0,5 А. Без блока к плате идут все пять проводов, но яркость тогда держат низкой.
// Бегущая строка на сборке из четырёх матриц 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