Демо-сервер для задачи "умный дом"
Перед запуском в Linux или MacOS убедитесь, что файл имеет права на исполнение. Установить их можно с помощью команды:
chmod +x FILE
Всегда используйте самую последнюю версию демо-сервера.
Чтобы посмотреть список доступных опций программы используйте опцию --help.
Для запуска в режиме сервера используется опция -s:
./smarthome -s
Если вы работаете в windows, не указывайте ./ перед командой. Выполняйте команду из командной оболочки, например, cmd.exe.
smarthome.exe -s
Обратите внимание, что имя файла при скачивании содержит название операционной системы, процессора и версию программы. Либо переименуйте скачанный файл, либо измените строку запуска соответствующим образом.
Дополнительно при запуске в режиме сервера можно указать следующие опции:
-p PORT- номер порта, на котором сервер будет ожидать подключения. По умолчанию используется порт 9998.-0 TIME- начальное модельное время для симуляции в форматеYYYY-MM-DDThh:mm:ss, например,1984-04-01T13:00:00. По умолчанию - текущее астрономическое время, округленное до секунд.-1 DUR- продолжительность моделирования, по умолчанию 1 час.-S SCENARIO- запустить сценарий с указанным номером. Сценарии описаны далее.-V- выводить принятые и отправленные пакеты в JSON-формате.
Если запуск был успешен, демо-сервер будет ожидать подключения на указанном порту. Проверить это можно, например, с помощью curl
curl -H POST -d "" localhost:9998
В ответ вы должны получить закодированную в base64 строку с сообщением с начальным модельным временем. Ответ сервера может выглядеть примерно так:
DbMG_38BBgaI0Kv6kzGK
Версия 0.2.0 поддерживает два сценария работы.
В этом сценарии в сети находится единственное устройство - таймер с именем TIMER01. Таймер шлёт сообщения о текущем времени каждые 100мс модельного времени.
В этом сценарии в сети находится таймер TIMER01, лампа LAMP02 и выключатель SWITCH03, коммутированный с лампой. Выключатель изначально находится в состоянии "выключен" и периодически меняет свое состояние. Таймер шлет сообщения о текущем времени каждые 100мс модельного времени.
Демо-сервер может использоваться как утилита для кодирования и декодирования пакетов.
Обратите внимание, что JSON-формат используется только для отладочных целей. По сети передаются пакеты в бинарном формате, закодированные в Base64.
Опция -B выполняет декодирование пакета из base64 в JSON-форму, например, если выполнить из командной строки Unix команду
echo DbMG_38BBgaI0Kv6kzGK | ./smarthome -B
на стандартный поток вывода будет напечатано
[
{
"length": 13,
"payload": {
"src": 819,
"dst": 16383,
"serial": 1,
"dev_type": 6,
"cmd": 6,
"cmd_body": {
"timestamp": 1688984021000
}
},
"crc8": 138
}
]
Опция -J выполняет преобразование из JSON-представления в base64-представления для отправки. Например, если запустить из командной строки команду
./smarthome -J
и на стандартном потоке ввода ввести
[
{
"length": 13,
"payload": {
"src": 819,
"dst": 16383,
"serial": 1,
"dev_type": 6,
"cmd": 6,
"cmd_body": {
"timestamp": 1688984021000
}
},
"crc8": 138
}
]
на стандартный поток вывода будет напечатано
DbMG_38BBgaI0Kv6kzGK
Опция -K выполняет преобразование из JSON-представления в бинарное представление. Так можно посмотреть, как представляется пакет в бинарной форме до его кодирования в Base64.
Например, если запустить из командной строки команду
./smarthome -K | hexdump -C
и на стандартном потоке ввода ввести
[
{
"length": 13,
"payload": {
"src": 819,
"dst": 16383,
"serial": 1,
"dev_type": 6,
"cmd": 6,
"cmd_body": {
"timestamp": 1688984021000
}
},
"crc8": 138
}
]
на стандартный поток вывода будет напечатано
00000000 0d b3 06 ff 7f 01 06 06 88 d0 ab fa 93 31 8a |.............1.|
Внимание! Команды даны в предположении, что вы используете Linux или MacOS. В windows соответствующие команды могут быть другими.
Ниже приведены примеры пакетов в base64 для всех возможных пар из типа устройства и команды.
- SmartHub, WHOISHERE (1, 1):
DAH_fwEBAQVIVUIwMeE - SmartHub, IAMHERE (1, 2):
DAH_fwIBAgVIVUIwMak - EnvSensor, WHOISHERE (2, 1):
OAL_fwMCAQhTRU5TT1IwMQ8EDGQGT1RIRVIxD7AJBk9USEVSMgCsjQYGT1RIRVIzCAAGT1RIRVI03Q - EnvSensor, IAMHERE (2, 2):
OAL_fwQCAghTRU5TT1IwMQ8EDGQGT1RIRVIxD7AJBk9USEVSMgCsjQYGT1RIRVIzCAAGT1RIRVI09w - EnvSensor, GETSTATUS (2, 3):
BQECBQIDew - EnvSensor, STATUS (2, 4):
EQIBBgIEBKUB4AfUjgaMjfILrw - Switch, WHOISHERE (3, 1):
IgP_fwcDAQhTV0lUQ0gwMQMFREVWMDEFREVWMDIFREVWMDO1 - Switch, IAMHERE (3, 2):
IgP_fwgDAghTV0lUQ0gwMQMFREVWMDEFREVWMDIFREVWMDMo - Switch, GETSTATUS (3, 3):
BQEDCQMDoA - Switch, STATUS (3, 4):
BgMBCgMEAac - Lamp, WHOISHERE (4, 1):
DQT_fwsEAQZMQU1QMDG8 - Lamp, IAMHERE (4, 2):
DQT_fwwEAgZMQU1QMDGU - Lamp, GETSTATUS (4, 3):
BQEEDQQDqw - Lamp, STATUS (4, 4):
BgQBDgQEAaw - Lamp, SETSTATUS (4, 5):
BgEEDwQFAeE - Socket, WHOISHERE (5, 1):
DwX_fxAFAQhTT0NLRVQwMQ4 - Socket, IAMHERE (5, 2):
DwX_fxEFAghTT0NLRVQwMc0 - Socket, GETSTATUS (5, 3):
BQEFEgUD5A - Socket, STATUS (5, 4):
BgUBEwUEAQ8 - Socket, SETSTATUS (5, 5):
BgEFFAUFAQc - Clock, IAMHERE (6, 2):
Dgb_fxUGAgdDTE9DSzAxsw - Clock, TICK (6, 6):
DAb_fxgGBpabldu2NNM