# 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/`

Не нужно писать длинную теорию. Важнее сохранить факты, измерения, симптомы, решения и следующие действия.