See Wiki developer documentation for further information.
To customize remote-os it's highly recommended having experience with:
- Buildroot
- Linux operating system
- Building and customizing Linux kernel
- Embedded systems
- Shell scripting
- Kconfig for writing Buildroot custom packages
The following tables give a short overview of the project structure. It is using the Buildroot's br2-external mechanism and was inspired by the Home Assistant Operating System project.
See Buildroot documentation "Keeping customizations outside of Buildroot" for further information.
| Directory | Description |
|---|---|
buildroot |
Buildroot snapshot |
buildroot-external |
Externalized remote-os configuration |
buildroot-patches |
Patches for Buildroot itself |
scripts |
Helper scripts for updating Buildroot and firmware / kernel packages |
All board specific configuration is found under the buildroot-external directory:
| Directory | Description |
|---|---|
board |
Target board resources |
configs |
Buildroot board configuration |
kernel |
Linux kernel configuration fragments |
package |
Custom Buildroot packages |
patches |
Patches for Buildroot packages |
rootfs-overlay |
Common file system overlay files |
scripts |
Build hook scripts |