Base Libraries and functions for own Hoffmation projects
npm install hoffmation-base
A home automation library specialized for Zigbee and Homematic IP devices in combination with ioBroker.
This project serves as library for home automation projects. It provides services, models and utilities necessary to
interact with rooms and smart devices via iobroker, but also to connect them to other services for textual/audio/visual
notifications or really just any code or service you want the devices to connect to.
Built on other open source projects that take care of the technical level, this project is made to provide a tool for
the coding on the logical level. It is built as base to write automation code independent of the ioBroker user interface
and currently provides support for the interaction with devices specified in src/server/devices and services that can be found in src/server/services.
Those include, but are not limited to:
- Devices: Motion/Presence sensors, window handles, heating elements, lamps and dimmers, shutters, door contact
sensors, physical buttons/switches, power sockets
- Services: Interaction service for a telegram bot, weather, sonos control, waste calendar
This library can be used in conjunction with or as addition to own base projects, but it's intended to be used with
the configuration project Hoffmation-Express which uses this library
via a npm package.
Whether you use it with Hoffmation-Express or with your own controller code, make sure you pass a valid config file (
see src/server/config/private for an example) and a valid ioBroker device tree (you can
find more information about that in the Hoffmation-Express project).
In order to get the library running correctly, the following requirements should be met:
* You use ioBroker for all devices that you want to control or read from
Make sure you got the socket.io adapter installed
* You use devices that are supported or are able to use one of the supported devices as base for yours.
(If you use a Zigbee or Homematic IP device that is not currently supported, don't hesitate to create a pull request
and add it!)
* You have a unix-based or windows device for the software you want to run this library with.
To build the library, make sure Node.js is installed.
Then, just run npm run build.
Even if it looks simple at first, automating your entire home with a user interface can sometimes be more difficult than
just coding your home.
Especially if you have a lot of specialized requirements that you want to satisfy, it can be simpler to just code your
own rules and interfaces than to rely on user interfaces to do it for you.