Files
kvida-os/README.md
Ronny Eia 13406a24a3 Scaffold NCS firmware project structure
Sets up kvida-os as a freestanding nRF Connect SDK application for the
nRF54L15, pinned to NCS v3.4.0, with a Docker/WSL2 build environment
(toolchain-only image, NCS modules fetched into a separate volume at
first run) and placeholder module directories matching the architecture
described in the kvida meta-repo.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-07 21:57:10 +02:00

37 lines
1.4 KiB
Markdown

# kvida-os
Fastvare for Kvida — en universell, batteridrevet Matter-node (Nordic nRF54L15) fra Xylon.
Visjon og arkitektur er beskrevet i meta-repoet [`kvida`](../kvida/AGENTS.md). Dette repoet inneholder kun fastvaren, bygget på Nordic nRF Connect SDK (Zephyr).
## Forutsetninger
- Docker
- WSL2
- `usbipd-win` (for å videresende J-Link/SWD-probe fra Windows til WSL2 ved flashing)
## Board
Bygget er foreløpig satt opp mot Nordic sitt offisielle utviklingskort (`nrf54l15dk/nrf54l15/cpuapp`) som plassholder. Kvida sin egen hardware trenger et custom board-oppsett under `boards/` når skjema/pinout er klart — ikke gjort ennå.
## Quickstart
Containeren kjører med arbeidsmappe `/workspace` (west-workspacets topdir), hvor dette repoet er mountet inn som undermappen `kvida-os/`. NCS/Zephyr-modulene havner som søsken av repoet (`/workspace/nrf`, `/workspace/zephyr`, ...) i et eget navngitt Docker-volum.
```sh
# Bygg toolchain-imaget
docker compose build
# Hent NCS/Zephyr-moduler (kjøres én gang, lagres i det navngitte volumet)
docker compose run --rm build west init -l kvida-os
docker compose run --rm build west update
# Bygg fastvaren
docker compose run --rm build west build -b nrf54l15dk/nrf54l15/cpuapp kvida-os/app
# Flash (krever J-Link-probe videresendt via usbipd-win til WSL2)
docker compose run --rm build west flash
```
`west.yml` er pinnet til NCS `v3.4.0`.