Automate home
Yet another home automation project because a smart light is more than just on or off.
Overview
When talking about home automation there are at least two goals you could have in mind:
- let a user interact with the home devices through many interfaces locally or remotely
- let devices interact together and let the system change their state
I believe the other home automation projects fits perfectly the first goal, this project focuses on automation, the second one.
What's the difference between this project model and other home automation projects?
The main difference is the design of an Appliance where, with the name Appliance, I refer to entities like a light, a curtain, a sound player ecc.
One of the simplest Appliances I could imagine is a light with two physical states: on and off.
A light model could be designed like a deterministic state machine; all the other home automation projects I know do it like that.
Or it could be designed like a non deterministic state machine; which is how it is done by this project.
When using a deterministic state machine if you have a light with on/off physical states its model states will be just on/off. When using a non-deterministic state machine it is quite simple to have more model states for an on/off light, as an example, your light could be in an alarmed state and it could start blinking.
Behavior-driven development
I believe logics are the building bricks of a smart home system. Nevertheless, they are complex to build, debug and share and one of this project goals is to make it easier.
Having an Appliance grouping together all its logics simplifies debug and reuse.
All Appliances inner states can be tested with BDD style tests like this.
BDD style tests make it quite easy to understand the behaviour of every Appliance in every possible state and thus make it shareable.
I like to think of this project as a way to share behavioural models for our smart devices more easily.
Documentation
For a deep dive into this project see the documentation.
For a minute guide to this project see the landing page.
Example projects
Using the docker image:
docker pull majamassarini/automate-home:latest
20 Dec 31, 2022
59 Dec 26, 2022
120 Nov 30, 2022
147 Jan 4, 2023
10 Oct 6, 2022
57k Jan 1, 2023
3 Apr 29, 2022
34 Dec 14, 2022
3 Aug 24, 2022
0 Nov 23, 2021
442 Dec 23, 2022
1 Dec 12, 2021
61 Dec 29, 2022
92 Dec 31, 2022
3 Jan 27, 2022
72 Dec 24, 2022
70 Dec 24, 2022
51 Nov 21, 2022
5 Jan 01, 2023
31 Jan 04, 2023
6 Nov 13, 2021
238 Jan 08, 2023
50 Sep 26, 2022
13 Jan 02, 2023
1 Jan 24, 2022
3 Dec 19, 2021
2 Dec 07, 2021
2 Feb 20, 2022