README.md

This README file contains information on the contents of the homeassistant layer. It contains recipes to run https://home-assistant.io/ on a OE target.

If you need help or like to discuss a topic please join the #meta-homeassistant:matrix.org room on matrix.org.

Please see the corresponding sections below for details.

Quickstart

git clone https://github.com/openembedded/openembedded-core.git
cd openembedded-core
git clone https://github.com/openembedded/meta-openembedded.git
git clone https://github.com/openembedded/bitbake.git
git clone https://git.yoctoproject.org/git/meta-security
git clone https://github.com/bachp/meta-homeassistant.git

. ./oe-init-build-env

bitbake-layers add-layer ../meta-openembedded/meta-oe
bitbake-layers add-layer ../meta-openembedded/meta-python
bitbake-layers add-layer ../meta-openembedded/meta-networking
bitbake-layers add-layer ../meta-openembedded/meta-perl
bitbake-layers add-layer ../meta-security
bitbake-layers add-layer ../meta-homeassistant

bitbake core-image-homeassistant

runqemu qemux86 nographic

You should now be able to access Home Assistant via web browser usually under the address: http://192.168.7.2:8123

Dependencies

URI: https://github.com/openembedded/openembedded-core.git
branch: master
revision: HEAD

URI: git://github.com/openembedded/meta-openembedded.git
branch: master
revision: HEAD

URI: https://github.com/openembedded/bitbake.git
branch: master
revision: HEAD

URI: https://git.yoctoproject.org/git/meta-security
branch: master
revision: HEAD

Why are these needed?

• meta-oe (master) : contains meta-python
• meta-python (master) : contains many of the required python3 packages
• meta-security (master): required for nmap used for presence detection

Contributing

Please submit any patches against the homeassistant as Pull Requests on Github.

Maintainers

• Pascal Bach pascal.bach@nextrem.ch

Adding the homeassistant layer to your build

In order to use this layer, you need to make the build system aware of it.

Assuming the homeassistant layer exists at the top-level of your yocto build tree, you can add it to the build system by adding the location of the homeassistant layer to bblayers.conf, along with any other layers needed. e.g.:

BBLAYERS ?= " \
  /path/to/yocto/meta \
  /path/to/yocto/meta-poky \
  /path/to/yocto/meta-yocto-bsp \
  /path/to/yocto/meta-openembedded/meta-oe \
  /path/to/yocto/meta-openembedded/meta-python \
  /path/to/yocto/meta-security \
  /path/to/yocto/meta-homeassistant \
"