Типовые ошибки¶

Этот раздел нужен не для того, чтобы ругать пользователя.

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

Формат раздела простой:

симптом;
вероятная причина;
что проверить;
что нельзя делать;
как исправлять безопасно.

Главное правило диагностики¶

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

Сначала проверяют базу:

питание;
полярность;
общий GND;
клеммы и разъёмы;
датчики;
силовые ключи;
прошивку и конфигурацию.

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

Когда нужно остановиться¶

Немедленно выключи питание, если:

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

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

Основные группы ошибок¶

В этом разделе ошибки разделены по группам:

02-ошибки-питания.md - слабый блок питания, неверное напряжение, просадка, тонкие провода, нет запаса.
03-ошибки-проводки.md - перепутанная полярность, плохие клеммы, нет общей земли, плохие разъёмы.
04-ошибки-контроллеров.md - неподходящая плата, 3.3V/5V логика, GPIO вместо силового выхода, неправильная прошивка.
05-ошибки-нагревателей-и-ssr.md - нагреватели, SSR, MOSFET, 110-230V AC, термодатчик, радиаторы и защита.
06-чеклист-диагностики.md - общий порядок проверки, когда устройство не работает.

Почему питание проверяют первым¶

Питание влияет почти на всё.

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

контроллер перезагружается;
Wi-Fi отваливается;
экран моргает;
сервопривод дёргается;
вентилятор не стартует;
датчики показывают случайные значения;
нагреватель плохо выходит на температуру.

Пока питание не проверено мультиметром под нагрузкой, сложно уверенно диагностировать остальное.

Почему проводка важнее, чем кажется¶

Плохой контакт может работать "почти нормально".

Именно это опасно:

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

Если устройство меняет поведение при шевелении провода, это не программная ошибка. Это проблема соединения.

Почему защита не должна отключаться¶

Thermal runaway, MINTEMP, MAXTEMP, heater not heating и похожие ошибки существуют не для раздражения пользователя.

Это признаки, что контроллер больше не доверяет температуре или видит опасное поведение нагрева.

Плохая идея:

отключить thermal protection;
расширить пределы температуры без понимания причины;
заменить предохранитель на больший;
замкнуть термостат напрямую;
закоротить защиту "для теста".

Правильная идея: найти причину срабатывания защиты.

Как читать этот раздел¶

Если устройство не работает совсем, начинай с чеклиста диагностики.

Если симптом понятен, переходи к нужной статье:

перезагрузки, моргание, слабый нагрев - питание;
работает при шевелении провода - проводка;
плата не определяется или пины не реагируют - контроллер;
нагреватель не выключается или SSR греется - нагреватели и SSR;
всё непонятно - общий чеклист.

Главное¶

Большинство ошибок начинается с питания, проводки и неправильного подключения.
Если что-то греется, пахнет или темнеет, питание нужно выключить.
Диагностику делают от простого к сложному.
Защиту прошивки и аппаратную защиту нельзя отключать ради удобства.
Сетевую часть 110-230V AC нельзя диагностировать "на столе" без понимания электробезопасности.

Материалы по теме¶

SparkFun: Troubleshooting Tips - базовый подход к проверке соединений, питания, нагрева и аппаратных проблем.
SparkFun: How to Power a Project - напряжение, ток и выбор питания для электронного проекта.
Tom's Hardware: How to Fix 3D Printer Thermal Runaway - практический разбор термодатчика, нагревателя, вентилятора, питания и проводки при thermal runaway.
Klipper Configuration Reference: verify_heater - официальная проверка нагревателя и датчика температуры по ожидаемому росту температуры и накопленной ошибке.
SparkFun Qwiic Power Meter guide - пример необходимости общего GND при измерении/управлении внешней нагрузкой.