first commit

README.md

@@ -0,0 +1,40 @@
+# embedded-lab
+
+`embedded-lab` — инженерный лабораторный репозиторий для изучения практической электроники и embedded-разработки.
+
+Это не конспект и не набор случайных заметок. Репозиторий ведется как embedded lab notebook: каждая сессия должна оставлять после себя проверяемый след — что собиралось, что ожидалось, что было измерено, какие ошибки возникли и какой вывод сделан.
+
+## Learning Philosophy
+
+Базовый цикл обучения:
+
+1. **Эксперимент** — собираем маленькую схему или firmware-пример.
+2. **Схема** — явно фиксируем соединения и ограничения.
+3. **Измерение** — проверяем напряжение, ток, сопротивление, питание, уровни сигналов.
+4. **Ошибка** — не считаем схему правильной заранее; симптомы важнее предположений.
+5. **Вывод** — коротко записываем, что стало понятнее и что делать дальше.
+
+Подход близок к software engineering: схема — это runtime-система, мультиметр — debugger, питание — production dependency, datasheet — API contract, smoke test — первое безопасное включение.
+
+## Быстрый Старт
+
+1. Прочитать `SAFETY.md`.
+2. Прочитать `SESSION_PROTOCOL.md`.
+3. Проверить текущее состояние в `memory_bank/01_current_state.md`.
+4. Начать с лабораторной `labs/001_led_resistor_psu/README.md`.
+5. Перед подачей питания использовать `snippets/psu_safety_checklist.md` и `snippets/multimeter_checklist.md`.
+
+Первая цель: безопасно собрать LED + resistor от лабораторного БП, выставить current limit, измерить напряжения и вычислить ток через резистор.
+
+## Как Вести Репозиторий
+
+После каждой учебной сессии обновляются:
+
+- `memory_bank/01_current_state.md`
+- `memory_bank/02_concepts.md`
+- `memory_bank/03_components.md`
+- `memory_bank/04_mistakes_and_debugging.md`
+- `memory_bank/08_learning_log.md`
+- relevant files внутри `labs/`
+
+Не нужно писать длинную теорию. Важнее сохранить факты, измерения, симптомы, решения и следующие действия.