Skip to content

README.md

Latest commit

 

History

History
134 lines (93 loc) · 3.08 KB

README.md

File metadata and controls

134 lines (93 loc) · 3.08 KB

LumOS 💡

Qt6 Smart Home Light Controller · Yocto Kirkstone · Raspberry Pi · GPIO

A fullscreen Qt6 QML application cross-compiled with Yocto for Raspberry Pi 2, running on a Wayland/Weston compositor. Built and deployed inside a Docker container using kas for reproducible layer management.

Current Progress

Lumina.mp4
Milestone Status
Hello World Application ✅ Done
GPIO LED control button ✅ Done
App boots on Pi directly ✅ Done
Open lamp with voice ✅ Done
Better UI / Dashboard 🔜 Coming
Support multiple devices in a room 🔜 Coming

Stack

Layer Technology
UI Framework Qt-6.9.3 / QML
Voice Recognition Python / Vosk model
Display Server Wayland / Weston
Build System Yocto Project (Kirkstone)
Layer Management kas
Build Environment Docker (Ubuntu 22.04)
Target Hardware Raspberry Pi 2

Build Instructions

Prerequisites

  • Docker Desktop installed
  • At least 8GB RAM allocated to Docker
  • At least 300GB disk space
  • Install vosk model into voice/model to work on macos

Note

You dont need to download for a model for raspberrypi and if you need to run QtApp on macos you need to run voice.py on it own and install voice/requirement.txt

Step 1 — Build the Docker image

docker build -t yocto-builder ./docker

Step 2 — Create a persistent Linux volume (Optional)

docker volume create yocto-build

Step 3 — Start the container

On macOS:

docker run -it \
  -v yocto-build:/yocto \
  -v $(pwd):/source \
  yocto-builder

Step 4 — Copy project into the volume

cp -r /source/app /yocto/
cp -r /source/meta-app /yocto/
cp -r /source/kas.yml /yocto/

Step 5 — Build with kas

cd /yocto
kas build kas.yml

First build takes 2-4 hours. Subsequent builds use sstate cache and are much faster.

Step 6 — Copy the image to your machine

Open a new terminal on your host machine and run:

docker cp <container_id>:/yocto/build/tmp/deploy/images/raspberrypi2/core-image-weston-raspberrypi2-XXXXXX.rootfs.wic.bz2 ./

Find your container ID with:

docker ps

Replace XXXXXX with your timestamp generated

Step 7 — Flash to SD card

Decompress the image:

bzip2 -d core-image-weston-raspberrypi2.rootfs.wic.bz2

Find your SD card device:

# On macOS
diskutil list

Flash the image:

# On macOS (replace /dev/diskN with your SD card)
sudo dd if=core-image-weston-raspberrypi2-XXXXXX.rootfs.wic of=/dev/rdiskN bs=4m status=progress

Step 8 — Boot the Raspberry Pi

Insert the SD card into your Raspberry Pi 2, connect a display, and power on. The application launches automatically on boot via systemd.

Attach a Second Terminal to the Running Container

docker ps  # get container ID
docker exec -it <container_id> bash