Skip to main content

sima-cli bootimg

Prepare a bootable image for the SiMa DevKit.

Parent command: sima-cli

Usage

sima-cli bootimg [OPTIONS]

Options

NameDescription
-v, --versionFirmware version to download and write (e.g., 1.6.0) (required)
-b, --boardtypeTarget board type. (default: mlsoc)
-t, --fwtypeTarget firmware type. (default: yocto)
-n, --netbootPrepare image for network boot and launch TFTP server.
--devkit-ipOptional DevKit IP address for pre-netboot version probing.
-r, --rootfsCustom root fs folders (internal use only)
-a, --autoflashNet boot the DevKit and automatically flash the internal storage - TBD

Arguments

None.

Full Help

Usage: sima-cli bootimg [OPTIONS]

Prepare a bootable image for the SiMa DevKit.

This command downloads the specified firmware version and prepares a
removable boot medium (SD card or USB) or configures a TFTP-based network
boot environment. It supports both MLSoC- and Modalix-based DevKits, as well
as Yocto and eLxr firmware types.

Operations Performed:

• Download the correct firmware bundle for the selected version

• Build a bootable disk image (SD/USB) OR configure TFTP netboot

• (Optional) Boot the DevKit over the network and flash internal eMMC
storage (use `f` command)

• Support for internal/testing rootfs overrides (`--rootfs`)

Typical Use Cases:

• Flashing a new firmware version to an SD card

• Setting up a fast development loop using TFTP netboot

• Preparing an eLxr-based bring-up image for Modalix DevKits

• Automating eMMC flashing over the network

Examples:

# Write an SD card image for an MLSoC DevKit

sima-cli bootimg -v 1.6.0 --boardtype mlsoc

# Set up netboot for a Modalix DevKit

sima-cli bootimg -v 1.6.0 --boardtype modalix --netboot

# Set up netboot and probe an existing DevKit first

sima-cli bootimg -v 2.1.0 --boardtype modalix --netboot --devkit-ip
192.168.1.20

# Prepare an eLxr netboot image for Modalix

sima-cli bootimg -v 2.0.0 --boardtype modalix --fwtype elxr --netboot

Options:
-v, --version TEXT Firmware version to download and write
(e.g., 1.6.0) [required]
-b, --boardtype [modalix|mlsoc]
Target board type. [default: mlsoc]
-t, --fwtype [yocto|elxr] Target firmware type. [default: yocto]
-n, --netboot Prepare image for network boot and launch
TFTP server.
--devkit-ip TEXT Optional DevKit IP address for pre-netboot
version probing.
-r, --rootfs TEXT Custom root fs folders (internal use only)
-a, --autoflash Net boot the DevKit and automatically flash
the internal storage - TBD
--help Show this message and exit.