first commit

firmware/README.md

@@ -0,0 +1,25 @@
+# Firmware
+
+Firmware хранится отдельно от lab notes, чтобы код, физическая схема и измерения не смешивались.
+
+Каждый firmware example должен иметь:
+
+- ссылку на relevant lab;
+- выбранный board/workflow;
+- physical test procedure;
+- ожидаемое поведение;
+- known limitations;
+- способ не commit-ить secrets.
+
+## Preferred Initial Workflow
+
+- Начать с Arduino Core или PlatformIO.
+- ESP-IDF оставить на более поздний этап, когда базовые GPIO/I2C/PWM и debugging уже понятны.
+- Для каждого примера сначала описывать, что должно быть видно физически: LED blink, serial log, LCD text, measured GPIO level.
+
+## Structure
+
+- `esp32/` — общие заметки по ESP32.
+- `arduino/` — Arduino Core examples and notes.
+- `platformio/` — PlatformIO projects and notes.
+- `esp-idf/` — future ESP-IDF experiments.

firmware/arduino/README.md

@@ -0,0 +1,17 @@
+# Arduino Core
+
+Arduino Core подходит для первых labs, потому что быстро дает feedback loop: write, flash, observe, measure.
+
+## Use For
+
+- Blink
+- Button input
+- PWM LED dimming
+- I2C scanner
+- LCD test
+
+## Notes
+
+- Board selection must match actual ESP32 dev board.
+- Serial logs are part of debugging, but physical measurements still matter.
+- Secrets must not be committed.

firmware/esp-idf/README.md

@@ -0,0 +1,14 @@
+# ESP-IDF
+
+ESP-IDF is planned for later stages.
+
+## Use Later For
+
+- Deeper ESP32 architecture.
+- Tasks, timers and FreeRTOS concepts.
+- More production-like firmware structure.
+- Wi-Fi reliability and power management.
+
+## Current Decision
+
+Do not start here. First build confidence with safety, measurements, GPIO, PWM and I2C using Arduino Core or PlatformIO.

firmware/esp32/README.md

@@ -0,0 +1,15 @@
+# ESP32 Firmware Notes
+
+## Rules
+
+- GPIO считать strictly 3.3V.
+- Перед использованием GPIO проверить pinout конкретной dev board.
+- Избегать boot strap pins на первых лабораторных, пока не понятны ограничения.
+- Для внешних схем нужен common ground.
+- Сначала проверять простую physical behavior, затем усложнять firmware.
+
+## TODO
+
+- Записать точную модель ESP32 dev board.
+- Выбрать безопасные GPIO для первых labs.
+- Зафиксировать upload workflow.

firmware/platformio/README.md

@@ -0,0 +1,15 @@
+# PlatformIO
+
+PlatformIO is a good default once the first Arduino-style examples work.
+
+## Why Use It
+
+- Reproducible project configuration.
+- Clear dependency management.
+- Better structure for multiple examples.
+
+## Initial Rules
+
+- Each project should reference its lab.
+- `platformio.ini` should document board and framework.
+- Physical test procedure belongs in lab `firmware.md`, not only in code comments.