Fork: 0
root / smart-home-server
Download ZIP 336commits
Transfer to URL with SHA
smart-home-server / tools / virtual_devices /
latest commit 25be204bd1
@Eugene Sukhodolskiy Eugene Sukhodolskiy authored 2 days ago
..
device Add virtual device emulator (Flask) for relay and button types 2 days ago
devices Add virtual device emulator (Flask) for relay and button types 2 days ago
pids Add virtual device emulator (Flask) for relay and button types 2 days ago
.gitignore Add virtual device emulator (Flask) for relay and button types 2 days ago
README.md Add virtual device emulator (Flask) for relay and button types 2 days ago
cli.py Add virtual device emulator (Flask) for relay and button types 2 days ago
emulator.py Add virtual device emulator (Flask) for relay and button types 2 days ago
requirements.txt Add virtual device emulator (Flask) for relay and button types 2 days ago
state.py Add virtual device emulator (Flask) for relay and button types 2 days ago
README.md

Virtual Device Emulator

Эмуляторы устройств умного дома на Python + Flask. Полностью повторяют REST-контракт реальных ESP8266/ESP32 устройств.

Типы устройств

  • relay — 4 канала реле. Управление set_state (on/off).
  • button — 4 канала кнопок. При клике шлёт событие POST /events/new на сервер.

Установка

cd tools/virtual_devices
python3 -m venv .venv
source .venv/bin/activate  # или .venv\Scripts\activate на Windows
pip install -r requirements.txt

CLI

# Создать виртуальное реле
python cli.py create --type relay --alias virt_relay --name "Virtual Relay" --port 9001

# Создать виртуальные кнопки
python cli.py create --type button --alias virt_btn --name "Virtual Buttons" --port 9002

# Запустить эмулятор
python cli.py start --alias virt_relay
python cli.py start --alias virt_btn

# Список устройств
python cli.py list

# Остановить
python cli.py stop --alias virt_relay

# Статус (JSON)
python cli.py status --alias virt_relay

# Нажать кнопку (для button-типа)
python cli.py click --alias virt_btn --channel 0

# Удалить устройство
python cli.py remove --alias virt_relay

Регистрация в PHP-сервере

# Убедитесь, что сервер доступен по нужному URL
python cli.py register --alias virt_relay --server-url http://smart-home-serv.local

Команда register:

  1. Проверяет /about эмулятора (должен быть setup)
  2. Отправляет POST /api/v1/devices/setup/new-device на сервер
  3. Сервер сам устанавливает токен и переводит устройство в normal

Web UI

Каждый эмулятор предоставляет UI на корневом URL:

http://127.0.0.1:9001/
  • Для реле — тумблеры on/off
  • Для кнопок — кнопки Click и лог событий
  • Обновление каждые 2 секунды

Эндпоинты эмулятора

Method Path Auth Описание
GET /about — Информация об устройстве
GET /status Bearer Состояние каналов
POST /action Bearer Управление (set_state, simulate_click)
POST /set_token — (setup) / Bearer (normal) Установка токена
POST /reset Bearer Сброс в setup
GET /channels_schema Bearer (или — в setup) Схема каналов
POST /simulate-event — Debug: ручной триггер события

Структура

virtual_devices/
├── cli.py              # Управление устройствами
├── emulator.py         # Flask-приложение эмулятора
├── state.py            # Хранение состояния (JSON)
├── device/
│   ├── base.py         # Базовый класс устройства
│   ├── relay.py        # Реле
│   └── button.py       # Кнопки
├── templates/
│   └── control.html    # UI (inline в emulator.py)
├── devices/            # Состояния (*.json, .gitignore)
└── pids/               # PID-файлы запущенных процессов

Изменения в сервере

Для поддержки IP:port в device_ip при регистрации:

  • server/SHServ/Controllers/DevicesRESTAPIController.php — валидация setup_new_device теперь разбирает host:port и валидирует только host.