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
671 Jan 05, 2023
1 May 01, 2022
8 Jul 18, 2022
3 Dec 10, 2022
28 Dec 13, 2022
2 Nov 07, 2022
1 Jan 19, 2022
4 Jan 19, 2022
2 Jul 29, 2022
0 Jan 20, 2022
1 Jan 14, 2022
1 Nov 24, 2021
32 Jan 07, 2023
81 Dec 21, 2022
297 Jan 06, 2023
2 Dec 06, 2021
15 Aug 10, 2022
19 Dec 29, 2022
24 Dec 19, 2022