Мобильное приложения для управления умным домом на базе Z-Wave с помощью OpenRemote

в 19:52, , рубрики: android, diy или сделай сам, iphone, linux, Raspberry Pi, z-wave, Беспроводные технологии, метки: , , ,

Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote
Не так давно был представлен Z-Wave модуль для Raspberry Pi — RaZBerry, который превращает мини-компьютер в полноценный контроллер умного дома. Управление Z-Wave сетью осуществляется с помощью web-интерфейса, использующего HTTP/JavaScript API. Используя JavaScript можно создать набор функций для автоматизации (включение/выключение света, проверка температуры, опрос датчика движения и др.), которые затем можно выполнить, послав HTTP запрос.

Продукт компании OpenRemote с одноименным названием позволяет создавать мобильные приложения для умного дома без программирования, при этом в одном приложении могут использоваться разные технологии: Z-Wave, KNX, X10, ZigBee, управление компьютером по ssh и др.

OpenRemote это сервер выполняющий любые команды и конструктор интерфейсов в котором вы создаете кнопки, переключатели, надписи и др. и этим элементам уже назначаете команды, в нашем случае это HTTP запросы на выполнение JavaScript функций на сервере Z-Wave.

Далее я по пунктам расскажу как создать пульт управления умным домом для iPhone и Android! А вот так будет выглядеть наше приложения, когда мы закончим:
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Под катом много картинок.

1. Создание сети Z-Wave c помощью контроллера Raspberry Pi + RaZberry

  • Установка ПО RaZberry на Raspberry Pi
  • Добавление Z-Wave устройств
  • Проверка работы устройства
  • О предоставленном API автоматизации
  • Создание JS скриптов для удаленного управления

2. Установка OpenRemote контроллера и мобильного приложения

3. Создание дизайна приложения и логики его работы

  • Разработка дизайна
  • Создание команд управления и сенсоров
  • Ассоциация кнопок с командами
  • Синхронизация с мобильным приложением

4. Резюме

5. Ссылки

Создание сети Z-Wave c помощью контроллера Raspberry+RaZberry

RaZberry — это плата подключаемая к Raspberry Pi через GPIO, позволяющая создавать и управлять Z-Wave сетью. Для лучшего понимая прочтите Faq. В комплекте с платой идет софт, который нужно установить.

Установка ПО RaZberry на Raspberry

Установщик поддерживает только Debian-based дистрибутивы (Raspbian, Xbian и др.) Однако ручками можно поставить ПО и на OpenElec и другие ОС.
Выполните команду для установки ПО Z-Way:

wget -q -O - http://razberry.z-wave.me/install | sudo bash

После установки, нужно обязательно перезагрузить Raspberry Pi, чтобы применить изменения для Serial порта.

Чтобы попасть в панель управления умным домом перейдите по адресу http://IP_OF_YOUR_RASPBERRY:8083. Интерфейс программы очень простой, разобраться в нем не составит труда, есть документация. Максимальную совместимость с интерфейсом имеют браузеры: Chrome, Safari, Firefox, другие браузеры: IE, Opera могут работать некорректно.

Добавление Z-Wave устройств

Определимся со списком используемого оборудования:
— Реле Fibaro Single Switch 3kW 2 шт.
— Датчик открытия двери/окна и температуры Fibaro Door/Window Sensor 1шт.

В нижнем меню выберите Режим эксперта. С помощью верхнего меню перейдите на вкладку Сеть → Управление сетью и нажмите Включить (заново) устройство, это запустит процесс ожидания включения устройства в сеть, теперь на устройстве три раза нажмите сервисную кнопку, чтобы контроллер его увидел и добавил.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Проверка работы устройства

Убедимся, что устройство работает. Перейдите на вкладку Настройка устройств, кликните на только, что добавленное устройство в левой колонке и проверьте Стадию интервью, должно быть Интервью прошло успешно и между плюсиков не должно быть точек и заков Ø.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Если интервью не пройдено (есть точки и знаки Ø), то можно его повторить, для этого в нижней части экрана нажмите Дополнительные действия → Принудительно повторить интервью (Режим эксперта должен быть включен, чтобы увидеть это меню).
После успешно пройденного интервью, на этой же вкладке Настройка устройств можно настроить некоторые параметры устройства (не забудьте применить настройки кнопкой Применить настройки к данному устройству внизу экрана, а также разбудить устройство, если оно работает на батарейках):
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Для управления устройством перейдите на вкладку Управление устройствами → Выключатели
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

О предоставленном API автоматизации

Удостоверившись, что все устройства работают правильно, попробуем теперь управлять ими удаленно. Есть несколько способов:

1. С помощью HTTP/JSON API
2. C помощью JavaScript API

HTTP/JSON API использует простой синтаксис для управления устройствами.
Включить свет можно из браузера:

http://192.168.1.113:8083/ZWaveAPI/Run/devices[6].instances[0].SwitchBinary.Set(255)

Или запросить температуру:

http://192.168.1.113:8083/ZWaveAPI/Run/devices[8].instances[2].commandClasses[49].data[1].val.value

JavaScript API позволяет писать различные скрипты автоматизации, например: включить/выключить свет, опросить датчик, получить температуру, выключить свет через 2 минуты после включения. Эти скрипты могут работать как самостоятельно (например: ночью свет включается только на 15%, чтобы не слепить глаза), так и могут быть вызваны удаленно с помощью HTTP/JSON API.

Скрипт включения света:

SwitchOn = function(N,I) {
  zway.devices[N].instances[I].SwitchBinary.Set(255);
  }

Вызов скрипта включения света:

http://192.168.1.113:8083/JS/Run/SwitchOn(6,0)

К сожалению прямое обращение к устройствам с помощью HTTP/JSON API из OpenRemote проблематично по нескольким причинам:

1. Символы [] должны быть перекодированы в UTF-8 в Констукторе OpenRemote
2. При опросе датчиков OpenRemote ожидает «on» или «off», а Z-Wave датчики могут прислать 255 или 0.
3. Для каждого устройства придётся писать свой запрос, а с помощью JS можно использовать только одну функцию для включения различных устройств, изменяя в запросе только параметр функции — номер устройства.

При использовать JavaScript API все эти проблемы исчезают — несколько функций «хэлперов» помогут преобразовать термины Z-Wave в удобные для OpenRemote понятия.
Более подробно о синтаксисе HTTP/JSON API и JavaScript API можно почитать в недавней статье о RaZberry на хабре.

Создание JS скриптов для удаленного управления

JS скрипты находятся в /opt/z-way-server/automation/, создадим файл в котором будут храниться наши функции автоматизации openremote.js, чтобы он автоматически загружался при включении Z-Way, в конец главного файла автоматизации main.js добавьте:

// ======================================================  
executeFile(automationRoot + "/" + "tags.js");  
executeFile(automationRoot + "/" + "openremote.js");  
startAutomation();

/opt/z-way-server/automation/openremote.js

// Включение устройства
SwitchOn = function(N,I) {
  zway.devices[N].instances[I].SwitchBinary.Set(255);
  }

// Выключение устройства
SwitchOff = function(N,I) {
  zway.devices[N].instances[I].SwitchBinary.Set(0);
  }

// Запрос на статус датчика (сработал/не сработал)
SensorStatus = function(N,I) {
  return zway.devices[N].instances[I].SensorBinary.data.level.value;
  }

// Запрос на состояние устройство (включено/выключено)
SwitchStatus = function(N,I) {
  return zway.devices[N].instances[I].SwitchBinary.data.level.value;
  }

// Запрос температуры с округлением до целого
Temperature = function(N,I) {
  return Math.round(zway.devices[N].instances[I].commandClasses[49].data[1].val.value);
  } 

Параметр N — номер устройства в сети.
Параметр I — внутри одного устройства может быть физически несколько устройств (каналов), например 2 реле или датчик температуры, датчик движения, датчик освещенности. Параметр I это номер канала внутри устройств. Если устройство содержит только одно физическое устройство, то это параметр равен 0.

После создания файла нужно либо перезапустить Z-Way командой:

/etc/init.d/Z-Way restart

либо подгрузить скрипт вручную, послав запрос из браузера:

http://192.168.1.113:8083/JS/Run/executeFile("automation/openremote.js")

Проверить работоспособность функций можно из браузера.
Включить свет:

http://192.168.1.113:8083/JS/Run/SwitchOn(6,0)

Запросить температуру:

http://192.168.1.113:8083/JS/Run/Temperature(8,2)

В отладке очень хорошо помогает лог Z-Way сервера:

tail -f /var/log/z-way-server.log

Если все работает, переходим к следующему пункту!

Установка OpenRemote контроллера

Контроллер OpenRemote представляет из себя сервер, который получает команды от мобильного или веб приложения и дальше транслирует их другому контроллеру или серверу. В нашем случае это Z-Way сервер.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

На сайте OpenRemote есть очень подробная инструкция по установке, которой и предлагаю воспользоваться:
Официальная инструкция по установке OpenRemote на английском языке

Замечу лишь, что OpenRemote написан на Java и нам нужна версия виртуальной машины с аппаратной поддержкой плавающей запятой:
JAVA для ARM процессоров в поддержкой плавающей запятой

Установите мобильное приложение для вашего телефона:
Мобильное приложение OpenRemote

Перед тем как приступить к разработке приложения, для лучшего понимая посмотрите как оно будет работать:
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Создание дизайна приложения и логики его работы

Все предыдущие шаги были лишь подготовкой к главному — созданию мобильного приложения!
Откройте облачный Конструктор http://designer.openremote.org. Разобраться в нем не составит труда!

Разработка дизайна

Сразу перейдем к разработке дизайна.

1. Перейдите на вкладку UI Designer Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote и создайте новую панель, назвав ее например, iPhone4.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

2. Перетяните из правой панели кнопки и изображения на экран iPhone.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

3. В свойствах изображения (правая панель) загрузите ваши картинки и с помощью полей Left, Right, Width, Height расположите их на экране как вам нужно. Я загрузил изображения квадрата и лампочки, также добавил надпись.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Создание команд управления и сенсоров

Теперь нужно на кнопки назначить команды, а картинка лампочки должна изменяться в зависимости от состояния света (включен/выключен).

1. Перейдите на вкладку Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote и создайте новый девайс, назвав его например, Raspberry.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

2. Выберите только что созданный девайс Raspberry и создайте новую команду для него New → Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemoteNew command. Выбираем протокол HTTP, вводим URL JS-команды и метод устанавливаем POST.
Эта команда включает устройство №6. Аналогично создаем команды включения других устройств и команды выключения.

http://192.168.1.113:8083/JS/Run/SwitchOn(6,0)

Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

3. Теперь нужно создать команду для опроса состояния света. Это команда будет вызываться каждые 2 секунды, поэтому если вы вручную выключите свет, то в нашем приложении это сразу станет заметно. Как обычно New → Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote New command, но дополнительно нужно указать с какой периодичность проводить опрос Polling, устанавливаем 2s, буква s обязательна.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

4. Создадим Sensor, который будет обрабатывать полученные значения от этой команды и передавать их изображению или надписи. New → Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote New Sensor, выбираем команду, которую будет выполнять сенсор, устанавливаем тип custom, добавляем два состояния on и off, ассоциируем их с возвращаемыми значениями Z-Wave.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Ассоциация кнопок с командами

1. Последний этап разработки приложения, ассоциация кнопок с командами. Вернитесь к дизайнеру приложения UI Designer Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote, выберите вашу кнопку и в её свойствах установить команду, которую она должна выполнять.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

2. Ассоциируйте изображение с сенсором, чтобы при изменении состояния устройства изменялась и картинка в приложении. Выберите изображение и в его свойствах установите сенсор.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

3. В свойствах изображения выберите какая картинка будет показана если сенсор прислал on и какая, если сенсор прислал off.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Синхронизация с мобильным приложением

1. Наше приложение готово, осталось его только залить в телефон. Перейдите по адресу контроллера OpenRemote http://OpenRemoteServer:8080/controller/, и нажмите Sync with Online Designer, тем самым вы загрузите созданное приложение на контроллер OpenRemote.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

2. По адресу http://OpenRemoteServer:8080/webconsole/ можно увидеть наше готовое приложение.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

3. Откройте приложение OpenRemote на мобильном, задайте адрес сервера OpenRemote, выберите панель iPhone4, которую мы создали в UI Designer.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

4. Теперь можно протестировать приложение на мобильном, я продолжил разработку дальше, добавил датчик температуры, датчик открытия окна, и сделал панель для управления медиаплеером XBMC.
Мобильное приложения для управления умным домом на базе Z Wave с помощью OpenRemote

Резюме

На изучение OpenRemote и разработку приложения я затратил один день! Этот инструмент очень прост в освоении, что экономит время. OpenRemote дает безграничные возможности по автоматизации дома, объединяя различные протоколы под одним крылом, а RaZberry оказалось очень удачным решением для управления оборудованием Z-Wave из OpenRemote.

Ссылки

Документация по Z-Way
RaZberry — умный дом на базе Z-Wave и Raspberry Pi
How To Install OpenRemote Controller on Raspberry Pi
OpenRemote Configure Z-Wave for Razberry

Автор: aivs

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js