first commit

snippets/README.md

@@ -0,0 +1,5 @@
+# Snippets
+
+Практические чеклисты и короткие шаблоны для повторного использования в labs.
+
+Использовать перед экспериментом, а не после того, как схема уже повела себя странно.

snippets/breadboard_checklist.md

@@ -0,0 +1,10 @@
+# Breadboard Checklist
+
+1. Проверить, как соединены rows на конкретной breadboard.
+2. Проверить continuity power rails по всей длине.
+3. Найти split rails, если они есть.
+4. Соединить split rails jumpers только осознанно.
+5. Проверить short между `+` и `-` rails перед питанием.
+6. При нестабильной схеме пошевелить провод только после выключения питания и затем проверить контакт мультиметром.
+
+Цвет провода помогает читать схему, но не доказывает электрическое соединение.

snippets/debugging_template.md

@@ -0,0 +1,45 @@
+# Debugging Template
+
+## Symptom
+
+Что наблюдается фактически.
+
+## Expected
+
+Что должно было произойти.
+
+## Actual
+
+Что произошло и какие измерения это подтверждают.
+
+## Circuit Assumption To Re-check
+
+- Power
+- Ground
+- Polarity
+- Pinout
+- Breadboard rails
+- GPIO voltage
+- Component value
+
+## Measurements
+
+| Point | Expected | Actual |
+| --- | --- | --- |
+| TBD | TBD | TBD |
+
+## Hypothesis
+
+Какая причина наиболее вероятна.
+
+## Test
+
+Какой один маленький тест подтвердит или опровергнет гипотезу.
+
+## Result
+
+Что показал тест.
+
+## Fix / Next Action
+
+Что изменить или проверить дальше.

snippets/esp32_gpio_safety.md

@@ -0,0 +1,12 @@
+# ESP32 GPIO Safety
+
+- ESP32 GPIO strictly 3.3V.
+- Не подключать 5V напрямую к GPIO.
+- Перед подключением внешнего сигнала измерить его voltage относительно ESP32 GND.
+- Для внешних модулей нужен common ground.
+- Не питать нагрузку напрямую от GPIO, если ток неизвестен или заметен.
+- Проверить pinout конкретной dev board.
+- На старте избегать boot strap pins, пока не понятны их ограничения.
+- Если используется I2C module, проверить pull-up voltage на SDA/SCL.
+
+Минимальный вопрос перед подключением к GPIO: "Какое напряжение реально будет на этом проводе?"

snippets/i2c_scanner.md

@@ -0,0 +1,23 @@
+# I2C Scanner Note
+
+I2C scanner — первый firmware smoke test для I2C-модуля.
+
+## Before Running
+
+1. Проверить VCC модуля.
+2. Проверить common ground.
+3. Проверить SDA/SCL wiring.
+4. Измерить idle voltage на SDA/SCL.
+5. Убедиться, что уровни безопасны для ESP32.
+
+## Expected Result
+
+Scanner должен найти один или несколько I2C addresses. Для LCD 1602 часто встречаются адреса вроде `0x27` или `0x3F`, но фактический адрес нужно измерить scanner-ом.
+
+## If Nothing Found
+
+- Проверить SDA/SCL swap.
+- Проверить питание.
+- Проверить common ground.
+- Проверить выбранные GPIO in firmware.
+- Проверить, не нужен ли другой I2C bus setup.

snippets/multimeter_checklist.md

@@ -0,0 +1,20 @@
+# Multimeter Checklist
+
+## Voltage Measurement
+
+1. Черный щуп в `COM`.
+2. Красный щуп в voltage/resistance jack, не в current jack.
+3. Выбрать DC voltage mode.
+4. Измерять между двумя точками, часто между signal и GND.
+5. Не разрывать схему для измерения напряжения.
+
+## Resistance / Continuity
+
+1. Отключить питание схемы.
+2. Разрядить подозрительные конденсаторы, если они есть.
+3. Выбрать resistance или continuity mode.
+4. Проверить short между power rails до подачи питания.
+
+## Current Measurement Warning
+
+Ток измеряется последовательно, мультиметр становится частью цепи. Не измерять ток так же, как напряжение.

snippets/psu_safety_checklist.md

@@ -0,0 +1,14 @@
+# PSU Safety Checklist
+
+Перед подключением схемы к лабораторному БП:
+
+1. Выключить output БП.
+2. Выставить нужное напряжение без нагрузки.
+3. Выставить малый current limit.
+4. Проверить полярность проводов.
+5. Проверить схему мультиметром на short между `+` и `GND`.
+6. Подключить схему.
+7. Включить output и наблюдать ток.
+8. Если БП ушел в current limit, выключить output и искать ошибку.
+
+Не повышать current limit, пока причина ограничения тока не понятна.