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: краткий вывод после выполнения.