# nedpavel/meta-myboard architecture

> Architecture diagram of the GitHub repository nedpavel/meta-myboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nedpavel/meta-myboard
- Repository: https://github.com/nedpavel/meta-myboard

## Overview

meta-myboard is a Yocto layer for an Intel Atom-based railway operator display. Its principal workflow is booting the configured image into a fullscreen Qt kiosk, where an operator navigates display pages and views live CAN process values; a separate page supports USB application updates. The layer also packages MVB userspace access and configures board services and hardware. GUI relationships are based on sampled source; image and platform links are documented in the README. Other unsampled recipe internals are represented only at their exact tree paths.

Main entry points: [`recipes-extended/images/myboard-image.bb`](https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/images/myboard-image.bb) (MyBoard image), [`recipes-gui/myboard-gui/files/src/mainwindow.cpp`](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/mainwindow.cpp) (Kiosk pages), [`recipes-bsp/libmvb/files/libmvb.c`](https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/libmvb/files/libmvb.c) (MVB userspace library), [`recipes-gui/myboard-gui/files/src/main.cpp`](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/main.cpp) (Qt entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Platform image"]
  node_image["MyBoard image<br/>[myboard-image.bb]"]
  node_machine["Machine definition<br/>[myboard.conf]"]
  node_kernel["Kernel fragments"]
  node_xorg["Framebuffer X"]
end

subgraph group_gui["Kiosk GUI"]
  node_entry["Qt entry point<br/>[main.cpp]"]
  node_window["Kiosk pages<br/>[mainwindow.cpp]"]
  node_updater["USB app update<br/>[mainwindow.cpp]"]
end

subgraph group_can["CAN display"]
  node_canreader["SocketCAN reader<br/>[canreader.cpp]"]
  node_matrix["Signal decoder<br/>[canmatrix.cpp]"]
  node_canopen["CANopen interpreter<br/>[canopen.cpp]"]
end

subgraph group_mvb["MVB access"]
  node_libmvb["MVB userspace library<br/>[libmvb.c]"]
  node_mvbapi["MVB API<br/>[libmvb.h]"]
  node_mvbdriver["MVB device driver<br/>[pixymvbip.c]"]
  node_mvbtool["MVB diagnostics<br/>[mvbtool.c]"]
end

subgraph group_services["Board services"]
  node_timesync["NTP configuration"]
  node_nfs["NFS dev mount<br/>[nfs-devmount.bb]"]
  node_canconfig["CAN startup config<br/>[can-network.bb]"]
  node_udev["Device rules"]
end

node_operator(("Operator"))
node_usb["USB storage"]
node_canbus["CAN bus"]

node_operator -->|"starts kiosk"| node_entry
node_entry -->|"creates window"| node_window
node_operator -->|"navigates pages"| node_window
node_window -->|"opens can0"| node_canreader
node_canbus -->|"delivers frames"| node_canreader
node_window -.->|"decodes signals"| node_matrix
node_window -.->|"interprets frames"| node_canopen
node_usb -->|"provides archive"| node_updater
node_window -->|"offers update page"| node_updater
node_mvbtool -->|"calls API"| node_libmvb
node_libmvb -->|"implements API"| node_mvbapi
node_libmvb -->|"maps device memory"| node_mvbdriver
node_machine -->|"targets image"| node_image
node_image -->|"includes kernel config"| node_kernel
node_image -->|"includes display config"| node_xorg
node_image -->|"includes time sync"| node_timesync
node_image -->|"includes dev mount"| node_nfs
node_image -->|"includes CAN setup"| node_canconfig
node_image -->|"includes device rules"| node_udev

click node_image "https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/images/myboard-image.bb"
click node_machine "https://github.com/nedpavel/meta-myboard/blob/main/conf/machine/myboard.conf"
click node_kernel "https://github.com/nedpavel/meta-myboard/tree/main/recipes-kernel/linux/linux-intel"
click node_xorg "https://github.com/nedpavel/meta-myboard/blob/main/recipes-graphics/xorg-conf/xorg-conf-myboard.bb"
click node_entry "https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/main.cpp"
click node_window "https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/mainwindow.cpp"
click node_updater "https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/mainwindow.cpp"
click node_canreader "https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/canreader.cpp"
click node_matrix "https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/canmatrix.cpp"
click node_canopen "https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/canopen.cpp"
click node_libmvb "https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/libmvb/files/libmvb.c"
click node_mvbapi "https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/libmvb/files/libmvb.h"
click node_mvbdriver "https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/pixymvbip/files/pixymvbip.c"
click node_mvbtool "https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/libmvb/files/mvbtool.c"
click node_timesync "https://github.com/nedpavel/meta-myboard/blob/main/recipes-core/timesync-myboard/timesync-myboard.bb"
click node_nfs "https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/nfs-devmount/nfs-devmount.bb"
click node_canconfig "https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/systemd-can/can-network.bb"
click node_udev "https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/udev/udev-rules-myboard.bb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_image,node_machine,node_kernel,node_xorg toneBlue
class node_entry,node_window,node_updater,node_usb toneAmber
class node_canreader,node_matrix,node_canopen toneMint
class node_libmvb,node_mvbapi,node_mvbdriver,node_mvbtool toneRose
class node_timesync,node_nfs,node_canconfig,node_udev,node_operator,node_canbus toneIndigo
```

## Components

### Platform image

- [MyBoard image](https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/images/myboard-image.bb): `recipes-extended/images/myboard-image.bb`
- [Machine definition](https://github.com/nedpavel/meta-myboard/blob/main/conf/machine/myboard.conf): `conf/machine/myboard.conf`
- [Kernel fragments](https://github.com/nedpavel/meta-myboard/tree/main/recipes-kernel/linux/linux-intel): `recipes-kernel/linux/linux-intel`
- [Framebuffer X](https://github.com/nedpavel/meta-myboard/blob/main/recipes-graphics/xorg-conf/xorg-conf-myboard.bb): `recipes-graphics/xorg-conf/xorg-conf-myboard.bb`

### Kiosk GUI

- [Qt entry point](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/main.cpp): `recipes-gui/myboard-gui/files/src/main.cpp`
- [Kiosk pages](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/mainwindow.cpp): `recipes-gui/myboard-gui/files/src/mainwindow.cpp`
- [USB app update](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/mainwindow.cpp): `recipes-gui/myboard-gui/files/src/mainwindow.cpp`

### CAN display

- [SocketCAN reader](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/canreader.cpp): `recipes-gui/myboard-gui/files/src/canreader.cpp`
- [Signal decoder](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/canmatrix.cpp): `recipes-gui/myboard-gui/files/src/canmatrix.cpp`
- [CANopen interpreter](https://github.com/nedpavel/meta-myboard/blob/main/recipes-gui/myboard-gui/files/src/canopen.cpp): `recipes-gui/myboard-gui/files/src/canopen.cpp`

### MVB access

- [MVB userspace library](https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/libmvb/files/libmvb.c): `recipes-bsp/libmvb/files/libmvb.c`
- [MVB API](https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/libmvb/files/libmvb.h): `recipes-bsp/libmvb/files/libmvb.h`
- [MVB device driver](https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/pixymvbip/files/pixymvbip.c): `recipes-bsp/pixymvbip/files/pixymvbip.c`
- [MVB diagnostics](https://github.com/nedpavel/meta-myboard/blob/main/recipes-bsp/libmvb/files/mvbtool.c): `recipes-bsp/libmvb/files/mvbtool.c`

### Board services

- [NTP configuration](https://github.com/nedpavel/meta-myboard/blob/main/recipes-core/timesync-myboard/timesync-myboard.bb): `recipes-core/timesync-myboard/timesync-myboard.bb`
- [NFS dev mount](https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/nfs-devmount/nfs-devmount.bb): `recipes-extended/nfs-devmount/nfs-devmount.bb`
- [CAN startup config](https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/systemd-can/can-network.bb): `recipes-extended/systemd-can/can-network.bb`
- [Device rules](https://github.com/nedpavel/meta-myboard/blob/main/recipes-extended/udev/udev-rules-myboard.bb): `recipes-extended/udev/udev-rules-myboard.bb`

### Other components

- **Operator**
- **USB storage**
- **CAN bus**

## Connections

- Operator → Qt entry point: starts kiosk (evidence: `README`)
- Qt entry point → Kiosk pages: creates window (evidence: `recipes-gui/myboard-gui/files/src/main.cpp`)
- Operator → Kiosk pages: navigates pages
- Kiosk pages → SocketCAN reader: opens can0 (evidence: `recipes-gui/myboard-gui/files/src/mainwindow.cpp`)
- CAN bus → SocketCAN reader: delivers frames (evidence: `recipes-gui/myboard-gui/files/src/canreader.cpp`)
- Kiosk pages → Signal decoder: decodes signals
- Kiosk pages → CANopen interpreter: interprets frames
- USB storage → USB app update: provides archive (evidence: `recipes-gui/myboard-gui/files/src/mainwindow.cpp`)
- Kiosk pages → USB app update: offers update page (evidence: `recipes-gui/myboard-gui/files/src/mainwindow.cpp`)
- MVB diagnostics → MVB userspace library: calls API (evidence: `recipes-bsp/libmvb/files/mvbtool.c`)
- MVB userspace library → MVB API: implements API (evidence: `recipes-bsp/libmvb/files/libmvb.c`)
- MVB userspace library → MVB device driver: maps device memory
- Machine definition → MyBoard image: targets image (evidence: `README`)
- MyBoard image → Kernel fragments: includes kernel config (evidence: `README`)
- MyBoard image → Framebuffer X: includes display config (evidence: `README`)
- MyBoard image → NTP configuration: includes time sync (evidence: `README`)
- MyBoard image → NFS dev mount: includes dev mount (evidence: `README`)
- MyBoard image → CAN startup config: includes CAN setup (evidence: `README`)
- MyBoard image → Device rules: includes device rules (evidence: `README`)
