ДЛЯ ИНТЕГРАТОРОВ
Открытое REST API поверх HTTP и команды MODBUS RTU. Готовые примеры, понятные шкалы значений и управление сразу группой.
Выберите группу G00–G15 и формат примера. Генератор ничего не отправляет на оборудование. Подставьте локальный IP своего модуля.
REST — способ организации API, HTTP — протокол, по которому идут запросы. В MMDALI чтение доступно через GET, а управление — через POST с JSON. Отдельный «простой GET для включения света» в текущей прошивке не предусмотрен.
Откройте в браузере телефона или компьютера, подключённого к локальной сети модуля:
http://<IP-модуля>/api/info http://<IP-модуля>/api/dali/status http://<IP-модуля>/api/dali/state?target=group&id=1
Это обычные HTTP GET-запросы. Браузер покажет JSON-ответ.
Задайте метод POST, путь команды и Content-Type. Это можно сделать из cURL, Node.js или вашей системы автоматики.
POST /api/dali/brightness HTTP/1.1
Host: <IP-модуля>
Content-Type: application/json
{"target":"group","id":1,"value":125}125 соответствует 50% на линейной шкале ползунка интерфейса; это не измеренная световая отдача.
| Кому | JSON-поля | Диапазон id |
|---|---|---|
| Вся линия | "target":"broadcast" | id не нужен |
| Группа | "target":"group","id":1 | 0..15 |
| Светильник | "target":"device","id":0 | 0..63 |
| HTTP-метод и путь | Тело / назначение |
|---|---|
GET /api/info | Сведения о модуле |
GET /api/dali/state?target=group&id=1 | Состояние группы G01 |
POST /api/dali/brightness | {"target":"group","id":1,"value":125} |
POST /api/dali/rgb | {"target":"group","id":3,"hex":"#32a4ff"} |
POST /api/dali/cct | {"target":"group","id":1,"value":4000} |
POST /api/dali/hsv | {"target":"group","id":3,"value":180,"contrast":250,"hue":140} |
POST /api/dali/cct | {"target":"group","id":1,"step":1} — холоднее; step 2 — теплее |
0..250, отдельное значение 255 = OFF. Ползунок интерфейса 0..100% переводится в эту шкалу.level фактического уровня DALI может использовать шкалу 0..254; не подставляйте его без преобразования в команду яркости API.hex в обычном формате #RRGGBB или отдельные r/g/b в диапазоне 0..254. HEX переводится в регистровую шкалу с целочисленным округлением вниз.0..250. Hue не задаётся в градусах. Value 255 выключает свет.Проверяйте HTTP-код и поле ok. Ошибка параметров возвращает HTTP 400; сбой обмена с контроллером — HTTP 502. Подробность ошибки находится в поле error.
// Форма сообщения об ошибке; текст зависит от операции
{"ok":false,"error":"описание ошибки"}Многострочные cURL-примеры используют синтаксис Bash/sh. В PowerShell используйте curl.exe и соберите команду в одну строку либо выберите формат HTTP или JavaScript.
Пример JavaScript в генераторе рассчитан на Node.js 18+ или выполнение внутри интерфейса самого модуля. Запрос со сторонней веб-страницы может потребовать согласования CORS, HTTPS и правил доступа к локальной сети в браузере. Серверная интеграция не зависит от CORS.
Текущий проект поддерживает внешний MODBUS RTU по RS-485. Параметры из текущей прошивки: 115200, 8N1, Slave ID 1. Перед подключением серийного устройства сверяйте паспорт и актуальную карту регистров.
Все приведённые адреса — 0-based. Если ваш клиент показывает регистры с единицы, задайте соответствующее смещение в клиенте. Не добавляйте 40001 к адресу без проверки принятого им формата.
| Операция | Группа g = 0..15 | Устройство a = 0..63 |
|---|---|---|
| Яркость | 2000 + 5×g | 3000 + 5×a |
| Цветовая температура | 2620 + 5×g | 3320 + 5×a |
| RGB — три регистра | 2700 + 3×g | 3640 + 3×a |
| HSV — три регистра | 2800 + 3×g | 4800 + 3×a |
FC06 / 0x06, регистр 2005, значение 125. Выберите MODBUS RTU в генераторе выше, чтобы получить полный кадр с CRC. Запись 255 в тот же регистр выключает группу.
FC16 / 0x10, начиная с регистра 2709, запишите три значения [49,163,254] для цвета #32a4ff. Полную RGB-тройку передавайте одной записью нескольких регистров. Для HSV так же передавайте полную тройку value/contrast/hue.
В компактном диапазоне 4200 + g расположена яркость групп. Пример: FC16, старт 4200, значения [50,125,250] — G00 получает 20%, G01 — 50%, G02 — 100% по шкале интерфейса.
Один кадр MODBUS может породить несколько последовательных действий DALI. Это не обещание одновременной смены света с точностью до миллисекунды.
Если в вашей системе есть HTTP, но нет собственного MODBUS-клиента, текущий API предоставляет чтение и запись holding-регистров:
GET /api/modbus/read?addr=2&count=1
POST /api/modbus/write
{"addr":2005,"value":125}
POST /api/modbus/write-multiple
{"addr":2709,"values":[49,163,254]}На внешнюю RS-485 линию подключайте один активный MODBUS-мастер. В текущей аппаратной архитектуре веб-мост ESP взаимодействует с контроллером по отдельному внутреннему интерфейсу.
Формат RTU: спецификации Modbus Organization. Среда JavaScript: документация Node.js fetch. Карта регистров MMDALI взята из текущего проекта прошивки.
Интерактивное демо показывает только управление. Скриншоты конфигуратора доступны на главной странице. Полную карту регистров под ваш проект можно запросить у нас.
Примеры сверены с текущим проектом ESP / STM TTL. Спецификация серийной версии уточняется к выпуску в I квартале 2027 года. RGB и CCT требуют соответствующих возможностей драйвера.