first commit

labs/005_pwm_led_dimming/README.md

@@ -0,0 +1,51 @@
+# Lab 005: PWM LED Dimming
+
+## Goal
+
+Управлять яркостью LED с ESP32 через PWM и проверить связь duty cycle с наблюдаемой яркостью.
+
+## Required Components
+
+- ESP32 dev board
+- LED
+- Resistor
+- Breadboard
+- Dupont wires
+- Multimeter
+
+## Expected Behavior
+
+LED меняет яркость при изменении PWM duty cycle. GPIO остается в пределах 0V..3.3V.
+
+## Pre-Flight Checklist
+
+- Выбрать безопасный PWM-capable GPIO.
+- Подключить LED только через резистор.
+- Проверить полярность LED.
+- Проверить common ground.
+
+## Safety Notes
+
+- ESP32 GPIO strictly 3.3V.
+- GPIO не должен питать нагрузку с большим током.
+- Не подключать LED без резистора.
+
+## Expected Measurements
+
+- GPIO low: около 0V.
+- GPIO high: около 3.3V.
+- Average voltage by multimeter may change with duty cycle, but exact reading depends on meter.
+
+## Actual Measurements
+
+TODO: записать реальные измерения.
+
+## Debugging Checklist
+
+- Если яркость не меняется, проверить GPIO и PWM channel.
+- Если LED не светится, проверить полярность и resistor path.
+- Если readings странные, помнить, что мультиметр усредняет PWM.
+
+## Conclusion
+
+TODO: краткий вывод после выполнения.

labs/005_pwm_led_dimming/firmware.md

@@ -0,0 +1,22 @@
+# Firmware
+
+## Expected Behavior
+
+- Configure PWM on selected GPIO.
+- Sweep duty cycle from low to high.
+- Optional: print current duty cycle to serial.
+
+## Physical Test Procedure
+
+1. Start with low duty cycle.
+2. Observe LED brightness.
+3. Measure average voltage for several duty cycles.
+4. Record whether visual brightness matches expected trend.
+
+## Code
+
+TODO: добавить PWM firmware после выбора workflow.
+
+## Actual Result
+
+TODO: записать фактическое поведение.

labs/005_pwm_led_dimming/measurements.md

@@ -0,0 +1,25 @@
+# Measurements
+
+## Expected Measurements
+
+| Duty Cycle | Expected Observation |
+| --- | --- |
+| 0% | LED off |
+| 25% | Dim |
+| 50% | Medium |
+| 100% | Brightest safe level |
+
+## Actual Measurements
+
+TODO: добавить реальные значения.
+
+| Duty Cycle | Average Voltage | Observation |
+| --- | --- | --- |
+| 0% | TBD | TBD |
+| 25% | TBD | TBD |
+| 50% | TBD | TBD |
+| 100% | TBD | TBD |
+
+## Observations
+
+TODO: visual response, flicker, meter behavior.

labs/005_pwm_led_dimming/notes.md

@@ -0,0 +1,17 @@
+# Notes
+
+## Bugs / Surprises
+
+TODO: записать PWM setup issues, wrong GPIO, unexpected brightness.
+
+## Explanation
+
+TODO: объяснить PWM как fast switching и duty cycle.
+
+## Conclusion
+
+TODO: что стало понятно о PWM.
+
+## Next Actions
+
+TODO: следующий маленький шаг.

labs/005_pwm_led_dimming/schematic.md

@@ -0,0 +1,12 @@
+# Schematic
+
+## Expected Circuit
+
+```text
+ESP32 PWM GPIO -> resistor -> LED anode
+LED cathode -> ESP32 GND
+```
+
+## Actual Circuit
+
+TODO: указать GPIO, resistor value и LED polarity.