SD.begin: инициализация и типовые ошибки

Утро показа логгера заказчику началось с «initialization failed» на чистом столе — хотя вечером накануне всё писало исправно. За пятнадцать минут я успел перепрошить плату, переткнуть все восемь проводов и начать подозревать ноутбук. Помогло то, что в итоге не тронуло ни код, ни питание: карта выехала из разъёма на миллиметр — push-push не был дожат до щелчка, контакт плавал. Переткнул до двойного щелчка — всё заработало. Полтора часа стоило отсутствие одной привычки: перетыкать карту до конца, а не до «как-то стоит».

SD.begin() — самая отказная строчка любого проекта с картой. Не потому, что функция плохая, а потому, что она проверяет сразу три слоя: жива ли шина SPI, отвечает ли карта и монтируется ли файловая система. Отказ любого из трёх выглядит одинаково — false без единого слова объяснений. Задача этого урока — научиться читать этот false как диагноз со списком вероятных болезней, а не как приговор всему проекту.

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

Шаг первый — настройка SPI и переход на пониженную скорость. Протокол карт требует знакомиться медленно: свежевключённая карта ещё не сказала, на какой частоте способна жить, поэтому первые команды гоняют на частотах порядка 400 кГц. Отсюда и время: вся инициализация занимает от 100 до 500 мс на Uno. Это заметная пауза, и по двум причинам из неё следствия: во-первых, SD.begin() не вызывают в каждом обороте loop() просто «для проверки» — повесите на него весь скетч; во-вторых, блокировка на полсекунды в setup() — нормальная цена, а в рабочем цикле — роскошь, которую логгер не может себе позволить.

Шаг второй — диалог с картой. Библиотека посылает сброс (CMD0), спрашивает про допустимый диапазон питания (CMD8), запускает карту командой ACMD41 и по ответам понимает поколение карты и её готовность. Если на CMD0 ответа нет вообще — «карта не отвечает» — это почти всегда контакт или мёртвая карта. В расширенной диагностике из примера CardInfo такой отказ печатается кодом 0X1: карта не прошла даже сброс. Коды выглядят сухо, но когда чек-лист не помогает, именно они сужают круг подозреваемых.

Шаг третий — монтирование файловой системы: библиотека читает загрузочный сектор, ищет таблицу FAT и корневой каталог. Вот здесь ложится exFAT: у него другая структура, и вместо вежливого признания «формат не знаю» вы получаете тот же безликий false. true возвращается только когда все три слоя сказали да — поэтому и проверять результат нужно всегда: без карты каждый последующий SD.open() молча вернёт «неудачу», и вы будете ловить призрака в коде, которого не существует. Это правило мы завели ещё в первом уроке раздела.

Теперь галерея причин — в порядке частоты в моей практике. Первая — формат. Карты на 64 ГБ и больше почти наверняка размечены в exFAT из коробки; форматирование в телефоне тоже любит exFAT. Лечение: FAT32 на компьютере, не на телефоне. Объём — берите 2–16 ГБ: для текстового лога это миллионы строк, а старые карты предсказуемее скоростных новинок. SDXC даже после принудительного FAT32 иногда капризничает — я такие в проекты не ставлю.

Вторая — питание. Классика жанра: в покое всё отлично, begin проходит, а при первой записи сыплются ошибки — импульс в 150 мА проваливает вход модуля ниже 4,4 В, и стабилизатор проседает. Короткие провода и конденсатор 100 мкФ у модуля, как мы считали в уроке про устройство модуля, закрывают вопрос в девяти случаях из десяти.

Третья — провода и CS: false при исправной карте чаще всего означает перепутанные MOSI/MISO или несовпадение номера CS с реальным проводом. Распиновка и общая шина — прошлая тема: урок про SPI-подключение. Четвёртая — контакт в разъёме: моя утренняя история с картой, выехавшей на миллиметр. Пятая — само собой, карта вообще не вставлена: звучит как анекдот, случалось со мной дважды за зиму.

Метод здесь тот же, что при диагностике NAN у датчиков температуры: печатать этапы и смотреть, на каком стоп — ровно этому учит урок про диагностику DHT. Отказ SD.begin() ничем не экзотичнее: это тоже не «карта сломалась», а конкретный слой, который сказал нет.

Логика попыток в setup — минимум гигиены. Но у логгеров есть сценарий пожёстче: карту вставляют на горячую, когда плата уже работает на объекте. Тогда SD.begin() повторяют из loop() — по таймеру, раз в пять секунд, без единого delay: приёмы неблокирующих таймеров разобраны в уроке про millis вместо delay. Осторожность одна: каждый begin — блокировка на сотни миллисекунд, и в этом окне скетч не читает датчики. Поэтому моё правило — повторная инициализация не чаще раза в пять секунд и только пока флаг cardOk ложный.

Флаг-состояние делает скетч взрослым: bool cardOk; при успехе печатаем состояние и работаем; если запись вдруг перестала удаваться — переводим логгер в режим «нет карты» и снова включаем таймер попыток. Так устроены все мои автономные устройства, и печать состояний в Serial — тот самый метод из урока про отладку логики: строка try=1 ok=0 в журнале честнее любых догадок.

Когда чек-лист и три попытки не помогли, открывайте пример CardInfo из библиотеки: он печатает коды card.init() — например, 0X1,0X0 означает, что карта не ответила даже на сброс, и дело почти наверняка в контакте или её смерти. Коды сухие, но по ним видно, на каком слое сломалось, — та же логика, что у таблицы выше, только глубже.

Когда begin отрабатывает стабильно, начинается самое интересное: данные. Урок про CSV и конфиги покажет, как оформить лог в таблицу, которую открывает Excel, и как менять пороги устройства файлом config.txt с той же карты. А если в журнале нужны настоящие даты и часы, а не счётчик секунд — их даст отдельная пара уроков про часы реального времени.

Домашнее задание: запустите пример CardInfo из библиотеки SD на своей сборке и запишите коды, которые он печатает: тип карты, объём тома, коды card.init(). Потом намеренно устроите сбой — вставьте карту не до щелчка — и сравните, как изменится вывод. Два лога рядом учат читать false быстрее любого учебника.