Skip to content

SUF 1 300 A API

ritaaliseenko edited this page Nov 25, 2022 · 1 revision

SUF-1-300-A

Тип устройства 9 (0x09), версия прошивки 1 (0x01).

Оглавление

Список поддерживаемых команд (CMD)

0 (0x00) Off - выключение нагрузки;
1 (0x01) Bright_Down - уменьшение мощности на нагрузке;
2 (0x02) On - включение нагрузки;
3 (0x03) Bright_Up - увеличение мощности на нагрузке;
4 (0x04) Switch - переключение нагрузки;
5 (0x05) Bright_Back - переключение мощности на нагрузке;
6 (0x06) Set_Brightness - установка мощности на нагрузке;
7 (0x07) Load_Preset - запуск сценария;
8 (0x08) Save_Preset - сохранение сценария;
9 (0x09) Unbind - отвязка от управляющего ус-ва;
10 (0x0A) Stop_Reg - мгновенная остановка изменения мощности на нагрузке;
15 (0x0F) Bind - привязка к управляющему ус-ву;
24 (0x18) Shadow_Set_Bright - установка мощности, на которую будет включена нагрузка;
25 (0x19) Temporary_On - включение нагрузки на время;
128 (0x80) Read_State - чтение параметров блока;
129 (0x81) Write_State - запись параметров в блок;
130 (0x82) Send_State - ответ от блока;
131 (0x83) Service - сервисный режим блока;
132 (0x84) Clear_Memory - очистка памяти блока.

Описание работы поддерживаемых команд

Off

Режим реле: мгновенно выключает нагрузку.
Режим диммер: плавно выключает нагрузку.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Bright_Down

Режим реле: мгновенно выключает нагрузку.
Режим диммер: плавно уменьшает мощность на нагрузке до min порога (выключения нагрузки не происходит).

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

On

Режим реле: мгновенно включает нагрузку.
Режим диммер: плавно включает нагрузку.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Bright_Up

Режим реле: мгновенно включает нагрузку.
Режим диммер: плавно увеличивает мощность на нагрузке до max порога. Если нагрузка выключена, то при приёме данной команды блок выставит min уровень мощности на нагрузке на 2 секунды, после чего начнётся плавное увеличение мощность до max порога.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Switch

Режим реле: мгновенно переключает нагрузку (если нагрузка была выключена, то включает, и наоборот).
Режим диммер: плавно переключает нагрузку (если нагрузка была выключена, то включает, и наоборот).

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Bright_Back

Режим реле: мгновенно переключает нагрузку (если нагрузка была выключена, то включает, и наоборот).
Режим диммер: плавно переключает мощность на нагрузке до min или max порога (выключения нагрузки не происходит). Если нагрузка выключена, то при приёме данной команды блок выставит min уровень мощности на нагрузке на 2 секунды, после чего начнётся плавное увеличение мощность до max порога.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Set_Brightness

Режим реле: мгновенно включает или выключает нагрузку. Если заданное значение равно 0, то нагрузка выключиться. Если заданное значение больше 0, то нагрузка включиться.
Режим диммер: плавно устанавливает мощность на нагрузке до заданного значения.

  • Команда принимается по протоколу nooLite: если заданное значение находится в диапазоне 0-27, а нагрузка включена - нагрузка выключится. Если заданное значение находится в диапазоне 35-155, а нагрузка выключена - нагрузка включится. Диапазоны 28-34 и 156-255 являются зонами нечувствительности, приём значений из этих диапазонов никак не влияет на состояние нагрузки.
  • Команда принимается по протоколу nooLite-F: если заданное значение меньше min порога, а нагрузка выключена, то изменения мощности не произойдёт. Если заданное значение меньше min порога, а нагрузка включена - нагрузка выключится. Если заданное значение больше max порога, то мощность измениться до значения max порога.

Поддерживаемые форматы (FMT): 1 - установка мощности;
Поддерживаемые данные (D0-D3): в D0 задается значение мощности;

Load_Preset

Вызывает заранее сохранённое состояние нагрузки блока.
Режим реле: возможное состояние нагрузки - выключено или включено.
Режим диммер: возможное состояние нагрузки - выключено или включено на определенное значение мощности.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Save_Preset

Сохраняет текущее состояние нагрузки блока.
Режим реле: возможное состояние нагрузки - выключено или включено.
Режим диммер: возможное состояние нагрузки - выключено или включено на определенное значение мощности.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Unbind

Блок входит в режим отвязки от управляющего устройства, которое передало ему эту команду. Данный режим длиться 30 секунд и сопровождается циклическим включением/выключением нагрузки, блок ожидает подтверждения отвязки сервисной кнопкой или другим привязанным к блоку управляющим устройством. Если подтверждения отвязки не произошло, то по прошествии 30 секунд блок выходит из режима отвязки, отвязки от управляющего устройства не происходит.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Stop_Reg

Режим реле: не поддерживается.
Режим диммер: мгновенно останавливает изменение мощности на нагрузке (во время включения, выключения, диммирования нагрузки).

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Bind

Команда передана по протоколу nooLite: если блок находится в сервисном режиме, то при приёме данной команды он входит в режим привязки к управляющему устройству, которое передало ему эту команду. Данный режим длиться 45 секунд и сопровождается индикацией светодиода, блок ожидает подтверждения привязки сервисной кнопкой или другим привязанным к блоку управляющим устройством. Если подтверждения привязки не произошло, то по прошествии 45 секунд блок выходит из режима привязки и сервисного режима, привязки к управляющему устройству не происходит.
Команда передана по протоколу nooLite-F: если блок находится в сервисном режиме, то при приёме данной команды он автоматически привязывается к управляющему устройству.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): not used;

Shadow_Set_Bright

Режим реле: не поддерживается.
Режим диммер: устанавливает мощность, на которую будет включена нагрузка (если она выключена).

  • Команда принимается по протоколу nooLite: диапазон задаваемых значений мощности 35-155. Значения, не попадающие в данный диапазон игнорируются.
  • Команда принимается по протоколу nooLite-F: диапазон задаваемых значений мощности от min до max. Значения, не попадающие в данный диапазон игнорируются.

Поддерживаемые форматы (FMT): 1 - установка мощности;
Поддерживаемые данные (D0-D3): в D0 задается значение мощности;

Temporary_On

Включает нагрузку на заданное время, по прошествии этого времени выключает нагрузку.

Поддерживаемые форматы (FMT): 5, 6 - установка времени;
Поддерживаемые данные (D0-D3): в D0 и D1 задается значение времени в 5-и секундных интервалах. При FMT = 5 значение времени записывается только в младший байт D0, максимальное значение времени 255 * 5 с = 1275 с. При FMT = 6 значение времени записывается в младший байт D0 и старший байт D1, максимальное значение времени 65535 * 5 с = 327675 с;

Read_State

Данная команда позволяет сделать запрос на чтение параметров силового блока в зависимости от передаваемого с ней формата. В ответ на данную команду блок отправляет команду Send_State с запрашиваемыми параметрами.

Поддерживаемые форматы (FMT): 0, 16, 17, 18;
Поддерживаемые данные (D0-D3): not used;

Write_State

Данная команда позволяет записать параметры в силовой блок в зависимости от передаваемого с ней формата. Запись параметров в силовой блок сопровождается индикацией нагрузки. В ответ на данную команду блок отправляет команду Send_State с записываемыми параметрами.

Поддерживаемые форматы (FMT): 16, 17, 18;
Поддерживаемые данные (D0-D3): подробно про данные;

Send_State

Данная команда не принимается блоком, а только отправляется в качестве ответа на исполнение других команд, отправленных по протоколу nooLite-F.

Service

Управляет сервисным режимом на силовом блоке. Включение сервисного режима сопровождается индикацией светодиода и нагрузки. Если сервисный режим не был использован, то по прошествии 45 секунд он отключается.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): в D0 (0 - выключить сервисный режим, 1 - включить сервисный режим);

Clear_Memory

Чистит память блока от привязанных nooLite управляющих устройств.

Поддерживаемые форматы (FMT): not used;
Поддерживаемые данные (D0-D3): D0 = 170, D1 = 85, D2 = 170, D3 = 85;

Параметры силового блока

Параметры силового блока можно условно разделить на два типа: общие сведения о блоке (только чтение) и настройки блока (чтение и запись).

Общие сведения о блоке

Чтение параметров общих сведений о блоке происходит при помощи форматов, представленных в следующей таблице:

Форматы параметров общих сведений о блоке:

FMT D0 D1 D2 D3
0 тип устройства версия прошивки состояние блока мощность, на которую
будет включен блок

Примечания:
[1] Использование при чтении форматов, которые не описаны в таблицах [1][2], приведёт к возврату силовым блоком ответа с форматом 255;

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

Возвращаемое значение: 9 (0x09).

Состояние блока

Возвращаемое значение:

bit7: состояние сервисного режима

0 = сервисный режим отключен;
1 = сервисный режим включен;

bit6-2: reserved

bit1-0: состояние нагрузки устройства

00 = нагрузка выключена;
01 = нагрузка включена;
10 = нагрузка включена на время;
11 = reserved;

Мощность, на которую будет включен блок

Возвращаемое значение в режиме реле: 100;
Возвращаемое значение в режиме диммер: последнее установленное значение мощности, попадающее в диапазон от min до max.

Настройки блока

Чтение и запись параметров настроек силового блока происходит при помощи форматов, представленных в следующей таблице:

Форматы параметров настроек блока:

FMT D0 D1 D2 D3
16 настройки D0 настройки D1 маска настроек D0 маска настроек D1
17 max уровень
диммирования
уровень включения min уровень
диммирования
reserved
18 время задержки
ретранслируемой команды
reserved reserved reserved

Примечания:
[1] Использование при чтении форматов, которые не описаны в таблицах [1][2], приведёт к возврату силовым блоком ответа с форматом 255;
[2] Использование при записи форматов, которые не описаны в таблице [2], приведёт к возврату силовым блоком ответа с форматом 255;

Настройки D0

bit7: запрет обработки команды Temporary_On

0 = обработка команды разрешена [1];
1 = обработка команды запрещена;

bit6: включение ретранслятора nooLite команд

0 = ретранслятор выключен [1];
1 = ретранслятор включен;

bit5: включение нагрузки, после подачи питания на силовой блок [2]

0 = нагрузка не включается [1];
1 = нагрузка включается;

bit4-3: разрешение работы устройства внешнего управления через дополнительные контакты

00 = переключающий выключатель [1];
01 = кнопка;
10 = выключатель;
11 = дополнительные контакты не используются;

bit2: запрет работы блока по протоколу nooLite [3]

0 = работа с протоколом nooLite разрешена [1];
1 = работа с протоколом nooLite запрещена;

bit1: тип управления нагрузкой

0 = реле [1];
1 = диммер;

bit0: восстановление состояния нагрузки, после подачи питания на силовой блок [2]

0 = состояние нагрузки зависит от настройки bit5 [1];
1 = состояние нагрузки восстанавливается до того, которое было перед обесточиванием блока;

Примечания:
[1] Эти настройки выставляются по умолчанию после сброса блока к заводским параметрам;
[2] Эти настройки не могут быть включены одновременно, при попытке включить обе включиться только настройка bit0;
[3] Эта настройка не влияет на работу настройки bit6.

Настройки D1

bit7-2: reserved

bit0-1: чувствительность приёмника

00 = 0 дБ;
01 = 6 дБ;
10 = 12 дБ [1];
11 = 18 дБ;

Примечания:
[1] Эти настройки выставляются по умолчанию после сброса блока к заводским параметрам;

Маска настроек

Данный параметр используется только при записи настроек в силовой блок. Он необходим для выбора конкретных настроек. Для этого каждой выбираемой настройке (позиции бита настройки) выставляется соответствующий бит маски, для остальных настроек соответствующий бит маски сбрасывается (например для настроек D0 маска 0b01000001 позволит произвести выбор настроек bit6 и bit0).

Максимальный уровень диммирования

Данный параметр относится к настройке D0 bit1 = 1 (режим диммер). Выставление данного параметра ограничивает уровень мощности, выше которого нагрузка не может быть продиммирована. Диапазон максимального уровня диммирования: от (min+1) до 100. При сбросе блока в заводские настройки устанавливается значение по умолчанию 100.

Уровень включения

Данный параметр относится к настройке D0 bit1 = 1 (режим диммер). Выставление данного параметра задает уровень мощности с которого начнёт включение нагрузка. Диапазон уровня включения: от min до max. При сбросе блока в заводские настройки устанавливается значение по умолчанию 20.

Минимальный уровень диммирования

Данный параметр относится к настройке D0 bit1 = 1 (режим диммер). Выставление данного параметра ограничивает уровень мощности, ниже которого нагрузка не может быть продиммирована. Диапазон минимального уровня диммирования: от 1 до (max-1). При сбросе блока в заводские настройки устанавливается значение по умолчанию 20.

Время задержки ретранслируемой команды

Данный параметр относится к настройке D0 bit6 = 1 (ретранслятор включен). Выставление данного параметра задаёт время в 10 мс интервалах, через которое принятая команда nooLite будет ретранслирована обратно в эфир. Максимальное значение времени 255 * 10 мс = 2550 мс. При сбросе блока в заводские настройки устанавливается значение по умолчанию 0.

Ретранслятор

За работу ретранслятора отвечает настройка D0 bit6 и 18-ый формат параметров настроек блока. Ретранслятор может ретранслировать исключительно команды протокола nooLite.

Список поддерживаемых команд (CMD) для ретрансляции

0 (0x00) Off
1 (0x01) Bright_Down
2 (0x02) On
3 (0x03) Bright_Up
4 (0x04) Switch
5 (0x05) Bright_Back
6 (0x06) Set_Brightness
7 (0x07) Load_Preset
8 (0x08) Save_Preset
10 (0x0A) Stop_Reg
11 (0x0B) Bright_Step_Down
12 (0x0C) Bright_Step_Up
16 (0x10) Roll_Color
17 (0x11) Switch_Color
18 (0x12) Switch_Mode
19 (0x13) Speed_Mode_Switch
20 (0x14) Battery_Low
21 (0x15) Send_Temp_Humi
25 (0x19) Temporary_On
26 (0x20) Modes

Дополнительные контакты силового блока

За выбор режима работы дополнительных контактов отвечает настройка D0 bit4-3.

Внешний выключатель/кнопка

Обработка силовым блоком внешнего выключателя/кнопки и команд, приходящих по радиоканалу никак не влияют друг на друга, например, если нагрузка силового блока была выключена при помощи внешнего выключателя (выключатель разомкнут), то приходящая в последствии команда включения включит нагрузку, несмотря на то, что выключатель все еще разомкнут.

Переключающий выключатель (0b00)

В данном режиме, подключённый к дополнительным контактам проводной выключатель управляет нагрузкой следующим образом: каждое замыкание/размыкание выключателя приводит к изменению состояния нагрузки (включению или выключению).

Кнопка (0b01)

В данном режиме, подключённая к дополнительным контактам проводная кнопка управляет нагрузкой следующим образом: кратковременное нажатие на кнопку переключает нагрузку (включает или выключает). Если силовой блок находится в режиме диммера (настройка D0 bit1 = 1), то при удержании (зажатии) кнопки происходит диммирование нагрузки в диапазоне min - max либо наоборот. Если в момент длительного зажатия кнопки, нагрузка была выключена, то блок выставит min уровень мощности на нагрузке на 2 секунды, после чего начнётся плавное увеличение мощность до max порога.

Выключатель (0b10)

В данном режиме, подключённый к дополнительным контактам проводной выключатель управляет нагрузкой следующим образом: если выключатель замыкается - нагрузка включается, если выключатель размыкается - нагрузка выключается.

Clone this wiki locally