Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/javalikescript/lha
light home automation application
https://github.com/javalikescript/lha
blockly home-automation iot lua mqtt raspberry-pi webthings zigbee zwave
Last synced: 3 months ago
JSON representation
light home automation application
- Host: GitHub
- URL: https://github.com/javalikescript/lha
- Owner: javalikescript
- License: mit
- Created: 2019-03-21T21:30:19.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-07-14T07:22:20.000Z (4 months ago)
- Last Synced: 2024-07-14T08:32:31.673Z (4 months ago)
- Topics: blockly, home-automation, iot, lua, mqtt, raspberry-pi, webthings, zigbee, zwave
- Language: Lua
- Homepage:
- Size: 645 KB
- Stars: 6
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
lha is a light home automation application
## Overview
The lha application allows to
* enrich your existing gateway such as the [Hue](https://www.philips-hue.com/) bridge
* record and display historical device values such as temperature
* interact between incompatible protocols such as between _ZigBee_ and _Z-Wave_
* compose advanced automations using [Blockly](https://developers.google.com/blockly/) scripts
* create your own [Lua](https://www.lua.org/) extensions
The lha engine manages the extensions including scripts, the things, the scheduler and a web server.
The engine records thing property values in dedicated time based log files.
It is a pure [Lua](https://www.lua.org/) application built around a scheduler and an HTTP server based on [luajls](https://github.com/javalikescript/luajls).
It exposes a [Web of Things](https://iot.mozilla.org/wot/) API.
The lha application could be run on small computers such as the _Raspberry PI_ or the _WD MyCloud_.
It could also be run on any _Linux_ distribution or _Windows_.
The application is small, around 5MB, and does not need any dependency.
## Extensions
Available extensions are:
* [ConBee II](https://phoscon.de/en/conbee), Dresden elektronik ConBee REST API
The recommended tool is [deCONZ](https://github.com/deconz-community/deconz-docker) using docker
* [Philips Hue V2](https://www.philips-hue.com/), Hue Bridge REST API
The recommended tool is the Hue Bridge
* [Z-Wave JS WS](https://github.com/zwave-js), Z-Wave JS API
The recommended tool is [Z-Wave JS UI](https://github.com/zwave-js/zwave-js-ui) using docker
* [MQTT](https://mqtt.org/) Broker, provides a light message broker
* Generic
Create virtual things, usefull for scripting
* Web Chart
Display thing property values in a time chart
* Web Dashboard
Setup tiles with relevant thing properties
* Web Scripts
Automatically trigger thing modifications
* Share server folders to download and upload files
* Users Management, adds user and permissions
* HTTPS server, provides lha on a secure server
* Self monitoring, based on Lua and [libuv](https://github.com/luvit/luv)
* Ping, Test the reachability of a host on the network
You need to include your devices using the dedicated tool such as deCONZ, Hue App or Z-Wave JS UI Control Panel.
## Devices
Any device available through ConBee, Hue or Z-Wave JS could be added by enhancing the extension JSON mapping files.
See list of already available [devices](devices.md)
## Screenshots
An example of a dashboard setup with temperature and motion sensors.
A chart of temperature sensors.
An example of script to send a SMS on an intrusion.
## Setup
Download the [latest](https://github.com/javalikescript/lha/releases/latest) release corresponding to your target OS.
Unzip the archive and launch the engine using `bin/lua lha.lua -ll info`
Open the web interface in a browser.
Go to the extension section to add and configure your extensions.
Note that you will need to provide an authorized user to use the ConBee or Hue bridge.
## Dependencies
The lha release includes web extensions using the following libraries:
* "vuejs" is licensed under the MIT License see https://vuejs.org/
*Reactive, component-oriented view layer for modern web interfaces*
* "blockly" is licensed under the Apache License 2.0 see https://developers.google.com/blockly/
*Blockly is a library from Google for building beginner-friendly block-based programming languages*
* "Chart.js" is licensed under the MIT License see http://chartjs.org/
*Simple yet flexible JavaScript charting for designers & developers*
* "Moment.js" is licensed under the MIT License see https://momentjs.com/
*Parse, validate, manipulate, and display dates and times in JavaScript*
* "Font Awesome Free" is licensed under multiple licenses see https://fontawesome.com/license/free
*The iconic font and CSS framework*
* "fetch" is licensed under the MIT license see https://github.com/github/fetch/releases
* "promise" is licensed under the MIT license see https://github.com/taylorhakes/promise-polyfill