Houseflow

Set up, manage, and control your Houseflow devices, that includes connected home products like lights, cameras, thermostats, relays and more – all from the Houseflow app.

🔴 Documentation is outdated, see ongoing work on PR #155

Houseflow

Get started

Set up Firebase

Go to Firebase Console and create new project
Add new app to project
- For Web, just click Add Web App in project settings, copy configuration and paste it into /appweb/services/firebase.ts on the top
- For Android add new app in project settings, enter fields, Android package name must match with /appmobile/android/app/build.gradle.android.defaultConfig.applicationId. You can check SHA-1 by using ./gradlew signingReport inside appmobile/android. Download the config file and paste it into appmobile/android/app/google-services.json. Check out Flutterfire Android docs
- For iOS add new app in project settings, refer to Flutterfire iOS docs
Build Web App, go to app_web and run npm install && npm run build
Enable Firebase Functions, Firebase Firestore(in production mode, it will be changed anyway in next step), Firebase Hosting and Firebase Authentication, install Firebase CLI tools and in root of project run firebase deploy
Create collections called devices and devices-private, generate UUID version 4, in Linux/OSX by using echo $(uuidgen) | awk '{print tolower($0)}' or by using UUID generator, afterwards create document inside devices collection which should look like this IMPORTANT

| Value | Description | Type | | -------- | -------------------------------------------------------------------------------------- | -------- | | $UUID | With uuidv4 you previously generated | -------- | | data | Leave it as empty map | Map | | geoPoint | Fill up them, they're used for checking if client is close to device | GeoPoint | | ip | Leave it as unknown, it will be filled up when device connects | string | | status | Leave it as false, it will be filled up when device connects | bool | | type | Set it to one of currently supported device types | string | | uid | Replace it with uuidv4, IT MUST BE SAME AS DOCUMENT NAME | string |

Now create new document at devices-private collection with same document ID as previously generated uuidv4, now generate another UUID with this command echo $(uuidgen) | awk '{print tolower($0)}'

| Value | Description | Type | | ------ | ------------------------------------ | ------ | | $UUID | With uuidv4 you previously generated | ------ | | secret | Set it to second generated UUID | string |

Add service account from firebase, navigate to Project Settings -> Service Accounts -> Generate new private key. Name it as firebaseConfig.json at put at project root.
Fill up .env, you can generate JWT_KEY by using openssl rand -base64 1024, and filling up with output

| Value | Description | | ------------------- | -------------------------------------------------------------------------------------------------- | | DOMAIN | Domain address that will be used(used for finding letsencrypt cert path), only for non-dev version | | JWTKEY | openssl rand -base64 1024 | | DEVICEAPIUSERNAME | echo $(uuidgen) | awk '{print tolower($0)} | | DEVICEAPI_PASSWORD | Same as above |

Start the server using docker-compose -f docker-compose.dev.yml up --build or in production mode docker-compose up --build, be aware that production mode requires setting DOMAIN enviroment variable and creating SSL Certificate
Its time to flash device, go inside /devices/esp8266 and copy platformio.example.ini to platformio.ini and update fields. Now install CLI version of platformio or VSCode extension. Connect device and press flash!
Give yourself permission to execute. First off open mobile app/web app and register, this will create new document at users collection, go to user document and add new Map inside devices array, it shoud look like that

| Value | Description | Type | | ------- | ------------------------------------------------------ | ------ | | uid | UID of the device we flashed | string | | execute | Allow for example opening the gate | bool | | read | Allow reading device data | bool | | write | Allow writing to device, inviting other people and etc | bool |

Ready, refresh the website and device should be visible. Report any problems or issues here

Documentation

MQTT Broker

Houseflow uses emqx as MQTT Broker. Devices connect to it aswell as Device service. For authorization Auth service is being used. It sends HTTP request to Webhooks service on every connect/disconnect.

Device service

Used to handle all requests from Web or Mobile app, communicates with them over HTTP, for authorization it is using Firestore. Redirects all HTTP requests directly to MQTT Broker with specific topic, in conclusion embedded device trigger specific event

Webhooks service

Listens to EMQX connect/disconnect events, changes device state in Firestore

Auth service

Adds device and ACL authorization for MQTT broker, prevents devices from subscribing to topic which isn't intended for them and also from connecting unknown devices.

OTA service

~~Handle updates over the air for embedded devices~~. Currently not used. Updates are handled via ArduinoOTA, related issue.

Mobile App

Mobile app made using Flutter, I picked it over React Native.

Web App

Web app made using React front-end library with Antd Pro v5.

Embedded devices

Currently supported devices are ESP8266, also there is a version in Node.JS. For ESP8266 I use Arduino framework and some kind of C++.

Alarmclock

Measures temperatures and wake me up.

Gate

ESP01 with relay used to open or close gate remotely, closes circuit for 1s and then opens it again

Watermixer

ESP8266 Development Board with relay to trigger mixing water, closes circuit for 1s and then opens it again

Lights

ESP8266 Wemos D1 board, connected with a TIP31C transistor to turn on/off and adjust intensity of lights

Firestore database

Project is using Firestore database for storing devices, users and etc

Contributing

Pull requests are welcome