first commit

labs/003_esp32_blink/README.md

@@ -0,0 +1,52 @@
+# Lab 003: ESP32 Blink
+
+## Goal
+
+Прошить ESP32 и выполнить простой blink на безопасном GPIO или встроенном LED, если он есть на конкретной dev board.
+
+## Required Components
+
+- ESP32 dev board
+- USB cable
+- Computer with Arduino Core or PlatformIO
+- Optional external LED + resistor
+- Multimeter
+
+## Expected Behavior
+
+ESP32 прошивается, запускает firmware, LED мигает с заданным периодом.
+
+## Pre-Flight Checklist
+
+- Определить точную модель ESP32 dev board.
+- Найти pinout и безопасные GPIO.
+- Не подключать 5V к GPIO.
+- Если используется external LED, поставить резистор последовательно.
+- Проверить, что питание идет только понятным способом.
+
+## Safety Notes
+
+- ESP32 GPIO strictly 3.3V.
+- External LED должен иметь резистор.
+- Не использовать boot strap pins без проверки pinout.
+
+## Expected Measurements
+
+- USB 5V на входе dev board: expected near 5V.
+- 3.3V rail на ESP32: expected near 3.3V.
+- GPIO blink level: low около 0V, high около 3.3V.
+
+## Actual Measurements
+
+TODO: записать реальные измерения.
+
+## Debugging Checklist
+
+- Если прошивка не загружается, проверить board/port/boot mode.
+- Если LED не мигает, проверить правильный GPIO.
+- Если external LED не светится, проверить полярность и резистор.
+- Измерить 3.3V rail и GPIO level мультиметром.
+
+## Conclusion
+
+TODO: краткий вывод после выполнения.

labs/003_esp32_blink/firmware.md

@@ -0,0 +1,26 @@
+# Firmware
+
+## Preferred Starting Workflow
+
+Start with Arduino Core or PlatformIO. ESP-IDF оставить на более поздний этап.
+
+## Expected Behavior
+
+- Configure selected GPIO as output.
+- Toggle GPIO with visible delay.
+- If using built-in LED, confirm whether active HIGH or active LOW.
+
+## Physical Test Procedure
+
+1. Прошить firmware.
+2. Наблюдать blink.
+3. Измерить GPIO low/high мультиметром.
+4. Записать board model, GPIO и actual behavior.
+
+## Code
+
+TODO: добавить минимальный blink sketch после выбора board/workflow.
+
+## Actual Result
+
+TODO: записать результат прошивки и наблюдения.

labs/003_esp32_blink/measurements.md

@@ -0,0 +1,25 @@
+# Measurements
+
+## Expected Measurements
+
+| Point | Expected |
+| --- | --- |
+| USB input | Near 5V |
+| ESP32 3.3V rail | Near 3.3V |
+| GPIO LOW | Near 0V |
+| GPIO HIGH | Near 3.3V |
+
+## Actual Measurements
+
+TODO: добавить реальные значения.
+
+| Point | Actual |
+| --- | --- |
+| USB input | TBD |
+| ESP32 3.3V rail | TBD |
+| GPIO LOW | TBD |
+| GPIO HIGH | TBD |
+
+## Observations
+
+TODO: upload logs, LED behavior, reset/boot issues.

labs/003_esp32_blink/notes.md

@@ -0,0 +1,17 @@
+# Notes
+
+## Bugs / Surprises
+
+TODO: записать проблемы с flashing, GPIO, board selection или LED polarity.
+
+## Explanation
+
+TODO: объяснить связь firmware output mode, GPIO voltage и observed blink.
+
+## Conclusion
+
+TODO: что подтверждено о board и workflow.
+
+## Next Actions
+
+TODO: следующий маленький шаг.

labs/003_esp32_blink/schematic.md

@@ -0,0 +1,19 @@
+# Schematic
+
+## Option A: Built-In LED
+
+```text
+Computer USB -> ESP32 dev board
+Built-in LED GPIO: TBD by board model
+```
+
+## Option B: External LED
+
+```text
+ESP32 GPIO -> resistor -> LED anode
+LED cathode -> ESP32 GND
+```
+
+## Actual Circuit
+
+TODO: указать выбранный GPIO, resistor value и способ питания.