Модуль поддерживает команды управления шторами и жалюзи по радиоканалу.
Реализованы протоколы Somfy и Dooya (Akko).
Описываются команды и их параметры.
Интерфейс модуля - UART, скорость обмена - 115 200 бод, размер данных - 8 бит, стоп бит - 1, проверки на чётность нет.
Команды можно передавать как строчными, так и прописными символами.
Окончание ввода команды определяется по символу, значение которого меньше 0x0E, т.е. команда может заканчиваться, например, символом '\n', или '\r'.
Команду от параметров должен отделять пробел.
Все числовые параметры - числа в шестнадцатеричной системе исчисления. Записываются без символов '0x'.
Если параметров несколько, они разделяются только запятой за которой сразу же, без пробела, следует следующий параметр.
Любой параметр или все сразу могут быть пропущены. В этом случае команда будет использовать параметры предыдущей команды из своей группы, кроме параметра num_repeats.
Если пропущен параметр num_repeats, будет использовано значение по-умолчанию т.е. команда будет передана так, как будто на пульте клавиша команды была нажата кратковременно.
Например, команда smf_up 15,e - передать команду Move up для устройства Somfy, имеющего адрес Somfy_ID_base + 21 (0x15->21). Команду передать 14 раз (0x0e->14), т.е. команда соответствует длительному нажатию на клавишу “^” на радиопульте Somfy.
При успешном выполнении команды в UART будет выведено сообщение "OK". После этого можно отправлять следующую команду.
В случае ошибки в UART будет выведено сообщение "ERROR". Никакой дополнительной информации о причине ошибки не выводится.
Параметр counter может принимать занчения 0x00 - 0x1F. Т.о. модуль поддерживает 32 адреса для привязки к устройствам Somfy.
Параметр num_repeats может принимать занчения 0x00 - 0x1F. При значениях 0x00 - 0x02 команда будет передана 2 раза. Параметр используется для того, чтобы можно было эмулировать кратковременное и долгое нажатие кнопок на пульте Somfy. Граница между коротким и длинным нажатием - 0x0e. Т.е. если количесво повторов команды мешьше 0x0e (14), будет воспринято кратковременное нажатие на кнопку. Если 0x0e или больше - длительное. Граница 0x0e может быть различной для разных устройств, поэтому параметр принимает не два значения (короткое/длинное нажатие), а точное, цифровое.
Параметр smf_id_base это базовый адрес устройств Somfy. Размер - три байта. Адреса устройств Somfy получаются прибавлением к smf_id_base номера счётчика.
Параметр value может принимать занчения 0x0000 - 0xFFFF. В протоколе Somfy носит название rolling code. Это счётчик команд для конкретного адреса Somfy. Размер - два байта. Увеличивается при каждом нажатии на кнопку пульта. Окно разрешённых занчений - текущее занчение + 100. Т.о. если два пульта имеют один и тот же адрес, устройство Somfy будет выполнять команды только от пульта, rolling code которого будет попадать в окно разрешённых значений.
Параметр group может принимать занчения 0x0 - 0xF. Выбирается группа каналов. В группе 15 каналов т.е. до 15 устройств Dooya могут быть объединены в группу. При передаче команды на 0-м канале, эту команду выполнят все устройства, находящиеся в группе.
Параметр channal может принимать занчения 0x0 - 0xF. При привязке устройсва нужно использовать значения 0x1 - 0xF. Команда, переданная на канале 0x0 будет выполнена всеми устройствами, входящими в группу.
Параметр dy_id_base это базовый адрес устройств Dooya. Размер - четыре байта. Адреса устройств Dooya получаются заменой младшего байта dy_id_base на байт состоящий из номера группы и номера канала.