Skip to content
Уроки
Датчики
Движение
AM312 (PIR)

AM312 — пассивный ИК-датчик движения (PIR)

Пассивный инфракрасный датчик: ничего не излучает, реагирует только на изменение теплового ИК-излучения в поле зрения — неподвижная, пусть даже тёплая цель для него невидима.

👁️ PIR-датчик движения AM312

AM312 — пассивный инфракрасный датчик (PIR): в отличие от радаров вроде HMMD-mmWave, которые сами излучают сигнал и отражением обнаруживают даже неподвижную цель (дыхание), AM312 ничего не излучает и видит только движение — изменение теплового ИК-излучения в поле зрения. Неподвижный, пусть даже тёплый человек для него невидим. Физика — в THEORY.md.

📋 Навигация

ФайлЧто внутри
WIRING.mdПодключение, таблица пинов
THEORY.mdПринцип PIR, отличие от радаров, ограничения
Lesson.mdМетодический план урока для учителя
PREZ.mdПрезентация модуля — тезисы для урока

🛠 Состав компонента

  • include/PirSensor.h — интерфейс класса драйвера.
  • src/PirSensor.cpp — обработка прерывания, hold time, дребезг.
  • src/main.cpp — тестовый стенд: серийная диагностика, LED/реле-индикация.
  • tools/timeline_view.py — визуализация таймлайна событий движения в реальном времени (см. ниже).

🚀 Сборка и прошивка (PlatformIO) 

cd Components/PIR_sensor_AM312
pio run -t upload && pio device monitor

По умолчанию сигнальный пин — GPIO13, см. WIRING.md.

Ожидаемый вывод 

=== [PIR_sensor_AM312] Motion Detection Test ===
Hold time 2000 мс, debounce 50 мс
Прогрев датчика ~5000 мс — возможны ложные срабатывания, см. THEORY.md.
Не блокирует loop() — статус печатается сразу, прогрев только помечен в логе.
------------------------------------
[IDLE]   покой  предыдущее=0 мс прогрев
[MOTION] движение обнаружено
[IDLE]   покой  предыдущее=2150 мс

прогрев в конце строки означает, что с момента begin() прошло меньше kWarmupMs — в этот период возможны ложные срабатывания, пока пироэлектрический элемент датчика стабилизируется (см. THEORY.md). Это не блокирует работу — просто предупреждение в логе.

⚙️ Настройки в коде

Заданы в конструкторе (main.cpp: PirSensor pir(kPirPin, kHoldTimeMs, kDebounceMs)):

  • kHoldTimeMs (по умолчанию 2000 мс) — сколько ждать без нового фронта на пине, прежде чем считать движение закончившимся (защита от дребезга сигнала на границе обнаружения).
  • kDebounceMs (по умолчанию 50 мс) — минимальный интервал между засчитываемыми фронтами прерывания.
  • kWarmupMs (по умолчанию 5000 мс) — информационный порог для метки “прогрев” в логе, не задерживает и не блокирует работу драйвера.

AM312 не имеет программной калибровки/настройки чувствительности — это простой аналоговый датчик с фиксированным порогом, у него нет интерфейса для этого (см. THEORY.md).

🖥️ Наглядная визуализация (для демонстрации детям)

tools/timeline_view.py рисует ленту времени: горизонтальная шкала, закрашенные участки — периоды, когда датчик считал, что перед ним есть движение. Хорошо показывает hold time (почему полоса не гаснет сразу после остановки) и общий ритм срабатываний.

cd Components/PIR_sensor_AM312/tools
pip install -r requirements.txt
python3 timeline_view.py /dev/ttyUSB0   # порт как в pio device monitor

Подробнее про виртуальное окружение (venv/uv) — ../../PYTHON_TOOLS.md.

🔧 Устранение неисправностей

  • Постоянно [IDLE], даже при явном движении — проверьте, что OUT датчика идёт на GPIO13 (или ваш выбранный пин), питание 3.3В (не 5В) — см. WIRING.md.
  • Статус мигает туда-сюда очень часто — увеличьте kHoldTimeMs, датчик реагирует на посторонние источники движения (сквозняк, работающий вентилятор) — см. THEORY.md, раздел про ограничения.
  • Ложные срабатывания в первые секунды после включения — ожидаемо, см. прогрев в логе выше и раздел про warmup в THEORY.md.