Skip to content

Build the ToloMEO Reference Image

This tutorial walks you through cloning meta-tolomeo, starting the development environment, and building the ToloMEO reference image. By the end you will have a running virtual machine you can SSH into.

The reference image is meta-tolomeo's own target: the image-devel image, built with the tolomeo-devel distribution on the tolomeo-qemux86-64 QEMU machine. Hardware target builds are not covered here — to build meta-tolomeo onto your own board, work through Build Your Own BSP Layer afterward.

Prerequisites

Step 1 — Clone the repository

git clone git@gitlab.com:DAVEEmbeddedSystems/public/tolomeo-public-projects/edge/tolomeo-edge/meta-tolomeo.git
cd meta-tolomeo

Step 2 — Open in the devcontainer

  1. In VS Code: File → Open Folder, select the cloned directory.
  2. VS Code detects .devcontainer/devcontainer.json and prompts to Reopen in Container. Click it. Alternatively: Command Palette → Dev Containers: Reopen in Container.
  3. The container builds on first run. This takes 5-10 minutes. When the terminal prompt inside the container appears, the environment is ready.

Verify the environment:

kas --version
curl -I https://reed-cache01.tolomeo.io/sstate-cache/

The mirror answers with a success status, or a redirect:

HTTP/2 200

Step 3 — Set up build keys

The build system requires a keys/ directory in the repository root containing the signing key material. If keys/ already exists as a symlink or directory, skip this step. Otherwise use the development keys that DAVE provides in devel-keys/:

ln -s devel-keys keys

Warning

The keys in devel-keys/ are publicly known and exist only for build validation. Never use them on a production device. See Generate a Signed Update Package for generating your own key material.

Step 4 — Build the development image

kas build kas/tolomeo-qemux86-64_tolomeo-devel_image-devel.yml

A full build from an empty cache takes 2-4 hours. With the remote sstate mirrors populated, most tasks are cache hits and the build completes in 20-40 minutes.

Tip

Run the build inside tmux so that closing VS Code does not interrupt it.

The build is complete when BitBake reports:

NOTE: Tasks Summary: Attempted NNNN tasks of which NNNN didn't need to be rerun and all succeeded.

Build artifacts land in build/tmp-glibc/deploy/images/tolomeo-qemux86-64/.

Step 5 — Boot the image in QEMU

Follow Run in Standalone Mode to prepare the working directory and launch QEMU. Use the devel image artifact (image-devel-tolomeo-qemux86-64.rootfs.ext4.gz) in place of the production image referenced in that guide.

Connect via SSH once the VM has booted:

ssh -p 2222 admin@127.0.0.1

Next Steps