https://github.com/houseos/meta-houseos

ilbers/isar build environment layer for HouseOS
https://github.com/houseos/meta-houseos

Last synced: about 2 months ago
JSON representation

ilbers/isar build environment layer for HouseOS

• Host: GitHub
• URL: https://github.com/houseos/meta-houseos
• Owner: houseos
• License: mit
• Created: 2020-07-15T17:08:01.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-02-23T10:19:28.000Z (almost 3 years ago)
• Last Synced: 2024-04-16T20:26:15.193Z (9 months ago)
• Language: BitBake
• Homepage:
• Size: 26.4 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# meta-houseos

This repository contains an [ilbers/isar](https://github.com/ilbers/isar) layer used to generate the image for the **HouseOS Central Service Unit**.

## Content

This layer integrates all Open Source software useful for a Smart Home central device.

- pihole - As an AdBlocker

- OpenHAB - To integrate as many Smart Home devices as possible

The following HouseOS specific applications are integrated as well:

- kvs - The Secure Key Value store for persistent data

- scp-client - The Commandline Client for the Secure Control Protocol

## How to build

First create two directories for the build, one for each image.

Second download the `kas-container` script:

`wget https://raw.githubusercontent.com/siemens/kas/master/kas-containr`

`chmod a+x kas-container`

### Build the target image

First export the absolute path to the build directory for the **HouseOS Central Service Unit** image as the `KAS_WORK_DIR` environment variable.

`./kas-docker --isar build meta-odyssey-kas.yml`

The target image will be available here:

`/build/tmp/deploy/images/seeed-odyssey/odyssey-image-debian-buster-lab-seeed-odyssey.wic.img`

### Build the installer image

The installer image can be used as a transport media for initial installation of an image on a device.

For this purpose it is used as a live image that contains the target image on a separate partition.

It is booted and afterwards the image can be written to the device using `dd` or similar.

First export the absolute path to the build directory for the installer image as the `KAS_WORK_DIR` environment variable.

`./kas-docker --isar build installer-kas.yml`

The installer image will be available here:

`/build/tmp/deploy/images/live/installer-image-debian-buster-live.wic.img`

Now, write it to a USB drive, e.g. using `dd` on Linux or `rufus` on Windows.

Next create an additional partition on the USB drive, it is recommended to use ext4 on Linux and `exfat` on Windows.

Afterwards the target image file (*.wic.img) can be copied to the new partition and should be available when the live image is running.

## License

SPDX-License-Identifier: MIT

## Copyright 

Copyright (C) 2020 Benjamin Schilling