I2C-сканер: как найти адрес устройства и понять, почему шина молчит

Опубликовано 16.10.2026, 13:42:30 · Radio Store
I2C-сканер: как найти адрес устройства и понять, почему шина молчит

Почему «подключил по примеру» не работает

Шина I2C кажется простой: два провода, адрес устройства, библиотека — и всё должно работать. Но на практике именно I2C чаще всего становится источником загадочных отказов. Дисплей OLED не инициализируется, датчик возвращает странные значения, модуль часов реального времени «пропадает» после первого обращения, а скетч, который вчера работал, сегодня молчит.

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

Поэтому первый инструмент диагностики I2C — не осциллограф и не даташит, а простой сканер шины. Он не чинит всё автоматически, но быстро отвечает на главный вопрос: устройство вообще отвечает на шине или нет.

Как устроена шина I2C простыми словами

I2C использует два сигнала:

  • SDA — линия данных;
  • SCL — линия тактового сигнала.

Обычно на плате Arduino Uno или Nano это аналоговые пины A4 и A5. На других платах пины могут отличаться: например, на Arduino Mega это отдельные пины SDA и SCL, а на ESP32 их можно назначить программно.

Шина работает по принципу «ведущий и ведомый». Ведущий контроллер, например Arduino, начинает обмен. Ведомое устройство, например дисплей SSD1306, отвечает на свой адрес. Если ведомое устройство узнало свой адрес, оно возвращает подтверждение, и ведущий понимает, что устройство на месте.

Важная особенность I2C: линии данных и тактового сигнала обычно не могут сами выставить высокий уровень. Они умеют только тянуть линию вниз. За высокий уровень отвечают подтягивающие резисторы. Поэтому I2C часто описывают как шину с открытым стоком. Если подтяжек нет или они слишком слабые, сигнальные фронты получаются медленными, и устройство может не отвечать стабильно.

Что делает сканер I2C

Сканер перебирает возможные адреса ведомых устройств и на каждом адресе пытается начать передачу. Если устройство отвечает, сканер сообщает, что нашёл адрес. Если не отвечает, переходит к следующему адресу.

Для Arduino Uno и Nano подойдёт такой скетч. Он сканирует обычно полезный диапазон адресов с 0x08 по 0x77. Некоторые адреса в начале и конце диапазона зарезервированы спецификацией I2C, поэтому их лучше не трогать в обычном любительском сканере.

#include <Wire.h>

void setup() {
  Serial.begin(9600);
  Wire.begin();

  Serial.println("Поиск устройств I2C...");
  byte found = 0;

  for (byte address = 0x08; address < 0x78; address++) {
    Wire.beginTransmission(address);
    byte error = Wire.endTransmission();

    if (error == 0) {
      Serial.print("Найдено устройство по адресу 0x");
      if (address < 0x10) {
        Serial.print('0');
      }
      Serial.println(address, HEX);
      found++;
    }
  }

  if (found == 0) {
    Serial.println("Устройства не найдены.");
  }
}

void loop() {
  // Повторное сканирование обычно не нужно,
  // пока вы не меняли схему, провода или питание.
}

Для платы Uno или Nano этот скетч можно прошивать как есть. Для ESP32 или другой платы с нестандартными пинами I2C может понадобиться явное указание пинов, например:

Wire.begin(SDA_PIN, SCL_PIN);

Где SDA_PIN и SCL_PIN — номера пинов, к которым вы подключили линию данных и линию тактового сигнала.

Сканер нашёл устройство: что это значит

Если сканер показал адрес, это хорошая новость. Значит:

  • питание на модуль подаётся;
  • общая земля с контроллером есть;
  • линии SDA и SCL физически подключены туда, куда ожидает библиотека;
  • подтягивающие резисторы хотя бы частично работают;
  • устройство отвечает на базовый запрос по адресу.

Но найденный адрес не означает автоматически, что ваша библиотека будет работать. Дальше нужно сверить три вещи:

  • формат адреса: 7-битный или 8-битный;
  • процедуру инициализации устройства;
  • напряжение логики и питание модуля.

Сканер не нашёл устройство: самые частые причины

Если сканер пишет, что устройств нет, не спешите считать модуль мёртвым. Чаще всего проблема проще.

Перепутаны SDA и SCL

I2C не терпит перестановки линий. Если SDA подключён к SCL, а SCL к SDA, устройство обычно не отвечает. На Arduino Uno и Nano проверьте:

  • A4 — это SDA;
  • A5 — это SCL.

На других платах сверяйтесь с документацией платы, а не с привычкой из Uno.

Нет общей земли

Если модуль питается от внешнего источника, а контроллер от USB, обязательно соедините их земли. Без общей точки отсчёта уровни сигналов становятся бессмысленными. I2C не работает «по воздуху» между двумя независимыми источниками питания.

Нет подтягивающих резисторов

Многие готовые модули имеют подтяжки на плате. Но не все. Если вы собрали I2C-устройство на навесном монтаже или используете голый чип, без подтягивающих резисторов шина работать не будет.

Типовое значение для короткой шины — 4,7 кОм. В трёхзначном SMD-коде это 472, а в четырёхзначном прецизионном коде может встречаться как 4701. Это те самые коды, которые разбирались в статье про маркировку SMD-резисторов.

Но «типовое» не значит «единственно верное». Для длинной шины, большой ёмкости или высокой скорости могут понадобиться резисторы меньшего номинала. Для экономии энергии и медленных шин — большего. Точные значения смотрите в документации конкретного устройства и в рекомендациях по применению.

Слишком много подтяжек параллельно

Если вы подключили несколько модулей, и на каждом есть свои подтягивающие резисторы, они оказываются параллельно. Два резистора по 4,7 кОм параллельно дают примерно 2,35 кОм. Это не всегда катастрофа, но на длинной шине или при сильной нагрузке по току может привести к чрезмерному нагреву или проблемам с низким уровнем сигнала.

Практическое правило для начала: если все модули имеют встроенные подтяжки и шина короткая, дополнительные резисторы обычно не нужны. Если шина не работает, попробуйте оставить один модуль и проверить его отдельно.

Питание не соответствует логике

Модуль может питаться от 3,3 В, а контроллер иметь 5-вольтовую логику. Многие модули это терпят, но не все. Если подтягивающие резисторы подключены к 5 В, а сам модуль рассчитан только на 3,3 В на выводах, это может повредить устройство.

И наоборот: если модуль питается от 3,3 В, а контроллер подтягивает линию к 5 В, устройство может не распознать уровни корректно. Поэтому для отладки проще держать единое напряжение логики и питания там, где это возможно.

Точные допуски по выводам всегда смотрите в документации на конкретный чип. Универсального правила «5 В терпят все 3,3-вольтовые модули» не существует.

Провода слишком длинные или макетная плата добавляет ёмкость

I2C любит короткие и чистые соединения. Длинные провода, витые пары без контроля, макетная плата с паразитной ёмкостью и плохими контактами делают фронты медленными. На низкой скорости это может ещё проходить, на 400 кГц — уже нет.

Если сканер работает нестабильно, попробуйте:

  • укоротить провода;
  • убрать макетную плату и подключить модуль напрямую;
  • снизить скорость шины;
  • оставить только одно устройство на шине.

Для снижения скорости в Arduino-скетче можно использовать, например:

Wire.setClock(100000);

или для грубой отладки:

Wire.setClock(50000);

Это не панацея, но хороший диагностический приём.

7-битный и 8-битный адрес: главная путаница

Сканер выше показывает 7-битный адрес. Большинство библиотек Arduino тоже ожидают 7-битный адрес. Но в технической документации производитель может указывать 8-битный адрес, в который уже включён бит чтения или записи.

Пример. В документации написано, что устройство имеет адрес 0xD0 для записи. Это 8-битный формат. Чтобы получить 7-битный адрес, нужно сдвинуть его вправо:

0xD0 в двоичном виде: 1101 0000
Бит чтения/записи — последний, равен 0 при записи.
7-битный адрес: 0110 1000, то есть 0x68.

То есть если документация даёт 0xD0, в скетч Arduino обычно нужно подставлять 0x68.

И наоборот: если библиотека просит 7-битный адрес 0x68, а вы подставите 0xD0, устройство не ответит, потому что контроллер будет обращаться не туда.

Полезная проверка:

Если адрес из документации чётный и больше 0x7F,
скорее всего, это 8-битный адрес для записи.
Разделите его на два, то есть сдвиньте вправо на один бит.

Если адрес нечётный, например 0xD1,
это может быть 8-битный адрес для чтения.
Тоже сдвигайте вправо: 0xD1 -> 0x68.

Не все документы используют одинаковый стиль, поэтому всегда смотрите, что именно ожидает библиотека. Хорошая библиотека обычно явно пишет в примере: 0x3C, 0x3D, 0x68 и так далее.

Почему устройство может не отвечать, хотя оно исправно

Сканер — это грубый инструмент. Он проверяет только наличие подтверждения на адресе. Некоторые устройства могут не отвечать на пустой запрос, но нормально работать после инициализации. Другие, наоборот, отвечают на адрес, но требуют специальной последовательности регистров.

Типичные ситуации:

  • датчик находится в режиме сна и требует пробуждения;
  • дисплей требует инициализации перед тем, как начать нормально отвечать;
  • устройство имеет несколько возможных адресов и выбирает их перемычкой;
  • два устройства на шине имеют одинаковый адрес;
  • ведомое устройство растягивает тактовый сигнал, а простая проверка этого не учитывает;
  • питание просело в момент опроса, и устройство сбросилось.

Поэтому вывод сканера надо читать вместе с документацией на устройство. Если сканер молчит, это ещё не приговор. Если сканер нашёл адрес, это ещё не гарантия, что библиотека заработает без правильной инициализации.

Растягивание тактового сигнала

Некоторые ведомые устройства могут удерживать линию SCL в низком уровне, чтобы заставить ведущее устройство подождать. Это называется растягиванием тактового сигнала. В простых скетчах это обычно обрабатывается библиотекой Wire, но на длинной шине или при слабой подтяжке такое поведение может выглядеть как зависание или потеря устройства.

Признаки проблемы:

  • сканер иногда находит устройство, иногда нет;
  • обмен работает на коротких проводах и ломается на длинных;
  • при подключении второго модуля шина начинает вести себя непредсказуемо;
  • снижение скорости помогает.

Лечение:

  • укоротить провода;
  • улучшить подтяжки;
  • снизить скорость I2C;
  • убрать лишние устройства с шины;
  • проверить питание на просадки.

SDA застрял в низком уровне

Иногда после неудачного обмена линия SDA остаётся низкой. Это может произойти, если ведущий контроллер был сброшен в середине передачи, а ведомое устройство осталось в состоянии ожидания. Тогда шина выглядит мёртвой: сканер не находит ничего, хотя питание и провода вроде бы в порядке.

Простой способ проверить — полностью снять питание со всех устройств и подать заново. Часто этого достаточно.

Существуют и более сложные процедуры восстановления шины, например подача нескольких тактовых импульсов на SCL при отпущенной SDA, чтобы помочь ведомому устройству завершить передачу. Но для начала не стоит лезть в бит-бэнг-восстановление: сначала проверьте питание, общую землю, подтяжки и отсутствие коротких замыканий.

Практический пример: OLED SSD1306 не находится

Допустим, вы собирали термогигрометр с дисплеем SSD1306, как в статье про поделку на Arduino. Дисплей должен быть по адресу 0x3C, но сканер его не видит.

Действуйте по порядку:

  1. Проверьте, что дисплей подключён к A4 и A5 правильно: SDA к A4, SCL к A5.
  2. Проверьте общую землю Arduino и дисплея.
  3. Проверьте питание дисплея. Если модуль 3,3-вольтовый, не подавайте на него 5 В без уверенности в допусках.
  4. Посмотрите, есть ли на модуле встроенные подтягивающие резисторы. У большинства готовых модулей они есть.
  5. Запустите сканер без других I2C-устройств.
  6. Если сканер нашёл 0x3D, а не 0x3C, поменяйте адрес в скетче.
  7. Если сканер нашёл адрес, но библиотека не работает, проверьте, что библиотека ожидает именно 7-битный адрес.
  8. Укоротите провода и уберите макетную плату, если используете длинные соединения.

Частая ошибка — оставить в скетче адрес 0x3C, а модуль на самом деле имеет перемычку, выбирающую 0x3D. Сканер в таком случае сразу показывает реальность, и спорить с ним бесполезно.

Карта диагностики

Ниже — текстовая шпаргалка. Её можно держать открытой во время отладки.

Сканер не находит вообще ничего
  -> проверьте питание модуля
  -> проверьте общую землю
  -> проверьте, что SDA и SCL не перепутаны
  -> проверьте наличие подтягивающих резисторов
  -> оставьте на шине одно устройство
  -> уменьшите скорость I2C до 100 кГц или 50 кГц

Сканер находит устройство, но библиотека не работает
  -> сверьте 7-битный и 8-битный адрес
  -> проверьте инициализацию устройства по документации
  -> попробуйте другой возможный адрес модуля
  -> убедитесь, что библиотека использует тот же интерфейс, например I2C, а не SPI
  -> проверьте напряжение логики и питание

Сканер находит устройство нестабильно
  -> уменьшите длину проводов
  -> уберите макетную плату
  -> проверьте подтяжки
  -> проверьте просадки питания
  -> исключите два устройства с одинаковым адресом
  -> снизьте скорость шины

После сброса Arduino шина перестаёт работать
  -> возможно, SDA застрял в низком уровне
  -> полностью перезагрузите питание всех устройств
  -> проверьте, не прерывается ли обмен из-за таймеров или прерываний
  -> уменьшите скорость и длину линии

Чек-лист перед тем, как искать «сгоревший модуль»

Прежде чем считать устройство мёртвым, пройдите этот список:

  • Питание модуля соответствует его документации.
  • Общая земля контроллера и модуля подключена.
  • SDA и SCL подключены к правильным пинам.
  • На шине есть подтягивающие резисторы, либо они есть на модуле.
  • Вы не добавили лишние подтяжки параллельно встроенным.
  • Сканер использует правильный диапазон адресов.
  • Вы понимаете, какой адрес ожидает библиотека: 7-битный или 8-битный.
  • Провода короткие, контакты надёжные, макетная плата не добавляет лишних проблем.
  • Скорость I2C не превышена для вашей длины линии.
  • На шине нет двух устройств с одинаковым адресом.
  • В документации устройства проверены требования к инициализации и уровням логики.

Итог

Сканер I2C не заменяет понимание шины, но очень быстро отделяет проблемы физического уровня от ошибок в коде. Если устройство не отвечает, чаще всего виноваты питание, земля, перепутанные пины, отсутствие подтяжек или слишком длинные провода. Если устройство отвечает, но библиотека не работает, почти всегда дело в адресе, формате адреса или неправильной инициализации.

I2C кажется простой двухпроводной шиной, но именно из-за двух проводов её легко сломать мелочами: плохим контактом, лишним модулем, слабой подтяжкой или просадкой питания. Поэтому диагностика должна быть такой же системной, как и в статье про питание: сначала проверьте базу, потом читайте документацию, потом уже меняйте библиотеки и код.

Эта статья продолжает практическую линию блога: если вы собирали Термогигрометр с OLED-дисплеем на Arduino, то проблема «дисплей не найден» становится понятнее. Если вы хотите правильно читать адреса и допуски устройств, смотрите Как читать даташит. Если шина работает нестабильно из-за просадок и пиков потребления, вернитесь к Питанию ESP32 и ESP32-S3. А чтобы не перепутать номинал подтягивающего резистора при пайке, полезно держать под рукой Маркировку SMD-резисторов.