Build Your Image¶
NetModule provides its own meta layer for customized image generation.
Project Setup¶
Netmodule Meta Layer¶
Additional Layers and Bitbake¶
Following additional resources are required:
Setup workspace¶
Start new build project with cloning all required git repositories:
1. Clone the nm-oem-linux repository
2. Move into the cloned repository and run git submodule init
then git submodule update
3. Your workspace should now look similar as in the snippet below:
- ::
- . ├── bitbake ├── build ├── env.common ├── env.image ├── env.image-minimal ├── env.image-ostree ├── machine_select ├── meta-netmodule-bsp ├── meta-netmodule-distro ├── meta-netmodule-wlan ├── meta-openembedded ├── meta-updater ├── openembedded-core └── README.md
Configure project¶
Start to source environment: . ./env.image-ostree
select your hardware in the prompt. You will be moved to the build
directory.
Build NetModule reference images¶
NetModule provides several reference images depends on use case:
Image | Description |
---|---|
netmodule-linux-image | Standard reference image. Contains required applications, drivers and tools to use interfaces, network connectivities and sensors. |
netmodule-linux-image-dev | Based on netmodule-linux-image and extended
with helpful development tools for low level
access (e.g. direct access on i2c bus) and generic
debug tools like strace and gdb. |
netmodule-linux-image-minimal | Minimal ramdisk based image for simple bring up or can be used for emmc operations like device flashing or data recovery. |
Images recipes location¶
Images recipes are located in layer meta-netmodule-distro
:
- ::
- meta-netmodule-distro/recipes-core/images/ ├── includes │ ├── firmware.inc │ └── image-preprocessing.inc ├── initramfs-ostree-image.bbappend ├── netmodule-linux-image.bb ├── netmodule-linux-image-dev.bb ├── netmodule-linux-image-mdev.bb ├── netmodule-linux-image-minimal.bb ├── netmodule-linux-image-oem.bb └── nmcontainer-python3.bb
Images build instructions¶
Start image build after sourcing environment with:
bitbake netmodule-linux-image
Images deploy location¶
- Built images are located in deploy directory.::
- <project root>/build/tmp/deploy/images/<hw type e.g. am335x-nmhw21>/