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
2.3k Dec 29, 2022
70 Dec 24, 2022
4 Oct 18, 2022
94 Jan 07, 2023
1.9k Jan 02, 2023
72 Dec 24, 2022
8 Oct 06, 2022
3 Jan 07, 2022
29 Nov 30, 2022
2.3k Dec 30, 2022
28 Dec 23, 2022
2 Jan 04, 2022
37 Dec 27, 2022
291 Jul 06, 2022
45 Dec 15, 2022
1 Jan 18, 2022
13 Jan 02, 2023
2 Aug 03, 2022
25 Dec 30, 2022
288 Dec 13, 2022