sima-cli 2.1.17__tar.gz → 2.1.19__tar.gz

{sima_cli-2.1.17/sima_cli.egg-info → sima_cli-2.1.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sima-cli
-Version: 2.1.17
+Version: 2.1.19
 Summary: CLI tool for SiMa Developer Portal to download models, firmware, and apps.
 Home-page: https://community.sima.ai/
 Author: SiMa.ai
@@ -27,7 +27,8 @@ Requires-Dist: rich==14.0.0
 Requires-Dist: InquirerPy==0.3.4
 Requires-Dist: tftpy==0.8.6
 Requires-Dist: psutil==7.0.0
-Requires-Dist: huggingface-hub<1.0,>=0.34.0
+Requires-Dist: huggingface-hub<3.0,>=2.2.0; python_version >= "3.10"
+Requires-Dist: huggingface-hub<2.0,>=0.34.0; python_version < "3.10"
 Requires-Dist: tabulate==0.9.0
 Dynamic: author
 Dynamic: license-file
@@ -148,6 +149,20 @@ sima-cli --internal login
 SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.2 tools/model-compiler/amd64
 ```
 
+Full-system SWU updates prefer RAM-backed `/tmp` when available memory can
+hold both the bundle and its extraction, plus a reserve of at least 512 MiB
+or 10% of total RAM (whichever is larger). Otherwise they stage in `/data`,
+with NVMe as a further fallback if `/data` lacks space. RAM staging is temporary;
+interrupted updates retained there do not survive a reboot.
+
+Public-mirror downloads, `models download`, and `neat artifacts` split files
+of at least 64 MiB into four byte ranges when supported by the server. Models
+and Neat artifacts share a limit of four active download connections across
+files and ranges, including single-connection fallbacks. Ranges must match the
+expected size and an object validator or the expected SHA-256 before the file is published. Models retain signed-URL refresh and
+cancellation handling. Existing public-mirror partial downloads continue
+sequentially; servers without range support use a single connection.
+
 ## Common Workflows
 
 Set up SDK containers:
@@ -157,6 +172,14 @@ sima-cli sdk setup
 sima-cli sdk neat
 ```
 
+When pairing with `sdk setup --devkit`, a new DevKit host key is automatically
+recorded in the SDK user's `~/.ssh/known_hosts`, including during unattended
+setup or after SDK container recreation. Subsequent pairing preserves saved
+keys and rejects a changed key at the same address and SSH port. After a device
+reimage or key rotation, verify the replacement fingerprint before explicitly
+updating that entry. For environments requiring verified trust before the first
+connection, provision verified host keys in the SDK user's `known_hosts`.
+
 Install Model Compiler from package metadata:
 
 ```bash
@@ -238,3 +261,13 @@ For command-specific prerequisites, see the generated [command reference](docs/s
 ## Support
 
 For issues and feature requests, use the sima-cli GitHub repository or contact the SiMa.ai development team.
+
+### Remote browser certificate help
+
+SDK setup stages a verified public mkcert CA certificate alongside the SDK HTTPS
+certificate. SDK images with browser certificate help can offer that file for
+download on the sign-in page, with instructions for the browser computer.
+Only the public certificate is staged; the mkcert private key stays on the host.
+If the issuing CA cannot be verified, including a plain self-signed fallback,
+no CA download is published. Re-running setup refreshes the staged file even
+when the existing HTTPS certificate does not need to be reissued.

{sima_cli-2.1.17 → sima_cli-2.1.19}/README.md

@@ -113,6 +113,20 @@ sima-cli --internal login
 SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.2 tools/model-compiler/amd64
 ```
 
+Full-system SWU updates prefer RAM-backed `/tmp` when available memory can
+hold both the bundle and its extraction, plus a reserve of at least 512 MiB
+or 10% of total RAM (whichever is larger). Otherwise they stage in `/data`,
+with NVMe as a further fallback if `/data` lacks space. RAM staging is temporary;
+interrupted updates retained there do not survive a reboot.
+
+Public-mirror downloads, `models download`, and `neat artifacts` split files
+of at least 64 MiB into four byte ranges when supported by the server. Models
+and Neat artifacts share a limit of four active download connections across
+files and ranges, including single-connection fallbacks. Ranges must match the
+expected size and an object validator or the expected SHA-256 before the file is published. Models retain signed-URL refresh and
+cancellation handling. Existing public-mirror partial downloads continue
+sequentially; servers without range support use a single connection.
+
 ## Common Workflows
 
 Set up SDK containers:
@@ -122,6 +136,14 @@ sima-cli sdk setup
 sima-cli sdk neat
 ```
 
+When pairing with `sdk setup --devkit`, a new DevKit host key is automatically
+recorded in the SDK user's `~/.ssh/known_hosts`, including during unattended
+setup or after SDK container recreation. Subsequent pairing preserves saved
+keys and rejects a changed key at the same address and SSH port. After a device
+reimage or key rotation, verify the replacement fingerprint before explicitly
+updating that entry. For environments requiring verified trust before the first
+connection, provision verified host keys in the SDK user's `known_hosts`.
+
 Install Model Compiler from package metadata:
 
 ```bash
@@ -203,3 +225,13 @@ For command-specific prerequisites, see the generated [command reference](docs/s
 ## Support
 
 For issues and feature requests, use the sima-cli GitHub repository or contact the SiMa.ai development team.
+
+### Remote browser certificate help
+
+SDK setup stages a verified public mkcert CA certificate alongside the SDK HTTPS
+certificate. SDK images with browser certificate help can offer that file for
+download on the sign-in page, with instructions for the browser computer.
+Only the public certificate is staged; the mkcert private key stays on the host.
+If the issuing CA cannot be verified, including a plain self-signed fallback,
+no CA download is published. Re-running setup refreshes the staged file even
+when the existing HTTPS certificate does not need to be reissued.

{sima_cli-2.1.17 → sima_cli-2.1.19}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sima-cli"
-version = "2.1.17"
+version = "2.1.19"
 description = "CLI tool for SiMa Developer Portal to download models, firmware, and apps."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -33,7 +33,8 @@ dependencies = [
     "InquirerPy==0.3.4",
     "tftpy==0.8.6",
     "psutil==7.0.0",
-    "huggingface-hub>=0.34.0,<1.0",
+    "huggingface-hub>=2.2.0,<3.0; python_version >= '3.10'",
+    "huggingface-hub>=0.34.0,<2.0; python_version < '3.10'",
     "tabulate==0.9.0"
 ]
 

{sima_cli-2.1.17 → sima_cli-2.1.19}/requirements.txt

@@ -8,5 +8,6 @@ rich==14.0.0
 InquirerPy==0.3.4
 tftpy==0.8.6
 psutil==7.0.0
-huggingface-hub>=0.34.0,<1.0
+huggingface-hub>=2.2.0,<3.0; python_version >= "3.10"
+huggingface-hub>=0.34.0,<2.0; python_version < "3.10"
 tabulate==0.9.0

{sima_cli-2.1.17 → sima_cli-2.1.19}/setup.py

@@ -23,7 +23,8 @@ setup(
         "InquirerPy>=0.3.4,<0.4",
         "tftpy>=0.8.6,<0.9",
         "psutil>=7.0.0,<8.0",
-        "huggingface-hub>=0.34.0,<1.0",
+        "huggingface-hub>=2.2.0,<3.0; python_version >= '3.10'",
+        "huggingface-hub>=0.34.0,<2.0; python_version < '3.10'",
         "rich>=13.7,<14.0"
     ],
     entry_points={

{sima_cli-2.1.17 → sima_cli-2.1.19}/sima_cli/__version__.py

@@ -1,2 +1,2 @@
 # sima_cli/__version__.py
-__version__ = "2.1.17"
+__version__ = "2.1.19"

{sima_cli-2.1.17 → sima_cli-2.1.19}/sima_cli/cli.py

@@ -2,17 +2,19 @@ import os
 import shutil
 import sys
 from contextlib import nullcontext, redirect_stdout
+from pathlib import Path
 import click
 from rich.console import Console
 from rich.panel import Panel
 from rich.text import Text
 from sima_cli.utils.env import get_environment_type
 from sima_cli.update.updater import perform_update
+from sima_cli.update.host import install_host_package
 from sima_cli.update.swu import handle_update
 from sima_cli.model_zoo.model import list_models, download_model, describe_model
 from sima_cli.app_zoo.app import list_apps, download_app, describe_app
 from sima_cli.utils.config_loader import internal_resource_exists
-from sima_cli.mla.meminfo import monitor_simaai_mem_chart
+from sima_cli.mla.meminfo import MemoryTelemetryError, monitor_simaai_mem_chart
 from sima_cli.__version__ import __version__ 
 from sima_cli.utils.config import CONFIG_PATH
 from sima_cli.install.optiview import install_optiview
@@ -40,6 +42,8 @@ from sima_cli.upgrade.selfupdate import register_selfupdate_command
 from sima_cli.playbooks import register_playbook_commands
 from sima_cli.vulcan import register_vulcan_commands
 from sima_cli.models import register_models_commands
+from sima_cli.peripherals import register_peripherals_commands
+from sima_cli.cloudex import register_cloudex_commands
 from sima_cli.vulcan.commands import (
     ENV_METAVAR,
     _environment_shortcut_options,
@@ -102,6 +106,13 @@ def _rerun_current_command() -> None:
     os.execvpe(sys.executable, cmd, env)
 
 
+# Command groups whose stdout is a machine-readable document: root diagnostics go to stderr for them.
+QUIET_STDOUT_SUBCOMMANDS = ("models", "peripherals")
+# Command groups that only read the DevKit they run on: no PyPI update check and no Artifactory
+# gate before them, so they work offline and never prompt or exit early.
+LOCAL_ONLY_SUBCOMMANDS = ("peripherals",)
+
+
 def _initialize_main_context(ctx, internal, yes):
     _configure_stdio_errors()
     auto_accept_update = yes or _update_auto_confirm_requested(sys.argv)
@@ -109,7 +120,8 @@ def _initialize_main_context(ctx, internal, yes):
     if auto_accept_update:
         os.environ["SIMA_CLI_AUTO_ACCEPT_UPDATE"] = "1"
     try:
-        if check_for_update('sima-cli') and _should_rerun_after_update(sys.argv):
+        if (ctx.invoked_subcommand not in LOCAL_ONLY_SUBCOMMANDS
+                and check_for_update('sima-cli') and _should_rerun_after_update(sys.argv)):
             _rerun_current_command()
     finally:
         if auto_accept_update:
@@ -125,14 +137,15 @@ def _initialize_main_context(ctx, internal, yes):
     if not internal:
         internal = os.getenv("SIMA_CLI_INTERNAL", "0") in ("1", "true", "yes")
 
-    defer_artifactory_access = ctx.invoked_subcommand == "update" or ctx.meta.get("daily_netboot", False)
+    local_only = ctx.invoked_subcommand in LOCAL_ONLY_SUBCOMMANDS
+    defer_artifactory_access = local_only or ctx.invoked_subcommand == "update" or ctx.meta.get("daily_netboot", False)
     if internal and not internal_resource_exists() and not defer_artifactory_access:
         click.echo("❌ You have specified -i or --internal argument to access internal resources, but you do not have an internal resource map configured.")
         click.echo("Refer to the confluence page to find out how to configure internal resource map.")
         exit(0)
 
     internal_reachable = True
-    if internal:
+    if internal and not local_only:
         internal_reachable = check_artifactory_reachability()
 
     if internal and not internal_reachable and not defer_artifactory_access and not _allows_external_prerelease_fallback(sys.argv):
@@ -167,7 +180,7 @@ class InspectionAwareGroup(click.Group):
             _command_name_from_argv(['sima-cli'] + options) == 'bootimg'
             and any(arg in ('--netboot', '-n', '--autoflash', '-a') for arg in options)
         )
-        if _command_name_from_argv(['sima-cli'] + options) == 'update' and '--inspect' in options:
+        if _command_name_from_argv(['sima-cli'] + options) == 'update' and any(arg in ('--inspect', '--swap') for arg in options):
             ctx.meta['update_inspect'] = True
         return super().parse_args(ctx, args)
 
@@ -188,18 +201,18 @@ def main(ctx, internal, yes):
     internal = internal or os.getenv("SIMA_CLI_INTERNAL", "0") in ("1", "true", "yes")
     if internal:
         Console(stderr=True).print(Panel(
-            "Pre-release software may be unstable. Use at your own risk.",
-            title="Pre-release software", border_style="yellow",
+            Text("Pre-release software may be unstable. Use at your own risk.", style="yellow"),
+            title="Pre-release software", border_style="yellow", width=72,
         ))
     if ctx.meta.get('update_inspect'):
         ctx.ensure_object(dict)
         ctx.obj.update(internal=internal, yes=yes)
         return
-    # Model Registry JSON must remain parseable on stdout. Route root-level
-    # update and environment diagnostics to stderr for this command group.
+    # Model Registry and peripherals JSON must remain parseable on stdout. Route root-level
+    # update and environment diagnostics to stderr for these command groups.
     output_context = (
         redirect_stdout(sys.stderr)
-        if ctx.invoked_subcommand == "models"
+        if ctx.invoked_subcommand in QUIET_STDOUT_SUBCOMMANDS
         else nullcontext()
     )
     with output_context:
@@ -213,6 +226,8 @@ register_sdk_commands(main)
 register_playbook_commands(main)
 register_vulcan_commands(main)
 register_models_commands(main)
+register_peripherals_commands(main)
+register_cloudex_commands(main)
 
 
 # ----------------------
@@ -314,7 +329,7 @@ def download(ctx, url, dest):
 @click.option(
     "-y", "--yes",
     is_flag=True,
-    help="Assume yes for update confirmation prompts."
+    help="Assume yes for update confirmation prompts and select the newest matching full-system build."
 )
 @click.option(
     "-p", "--passwd",
@@ -348,15 +363,17 @@ def download(ctx, url, dest):
     "--dryrun",
     is_flag=True,
     default=False,
-    help="For eLxr updates, validate the update path and show the command without installing."
+    help="For eLxr, preview an update or slot swap without installing, switching slots, or rebooting."
 )
-@click.option("--inspect", "inspect_state", is_flag=True, help="Show eLxr 3.0+ A/B slot state without updating (local or --ip).")
+@click.option("--inspect", "inspect_state", is_flag=True, help="Show eLxr 3.0+ A/B slots and overlay customizations without updating (local or --ip).")
+@click.option("--swap", is_flag=True, help="Select the available inactive eLxr 3.0+ slot for next boot; use --reboot to restart now.")
+@click.option("--verbose", is_flag=True, help="Show detailed overlay file categories during eLxr 3.0+ inspection or update.")
 @click.option("--signing-cert", metavar="URL_OR_FILE", help="SWUpdate PEM verification certificate: HTTP(S) URL or local file. Defaults to the certificate for the selected channel when configured (eLxr 3.0+).")
-@click.option("--reboot", is_flag=True, help="Reboot after successful eLxr 3.0+ installation; verify remote boot health.")
+@click.option("--reboot", is_flag=True, help="Reboot after successful eLxr 3.0+ installation or slot selection; verify remote boot health.")
 @click.pass_context
-def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force, troot_only, dryrun, inspect_state, reboot, signing_cert):
+def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force, troot_only, dryrun, inspect_state, verbose, reboot, signing_cert, swap):
     """
-    Update the software on a SiMa DevKit or remote SiMa device.
+    Update a SiMa DevKit, remote device, or Linux PCIe host.
 
     This command downloads and applies system software updates across
     different SiMa environments (Modalix, MLSoC/Davinci, headless images,
@@ -365,6 +382,15 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force,
 
     eLxr 3.0+ uses signed full-system SWU bundles. Use --inspect for A/B
     state, --ip for remote updates, and --reboot to reboot after installation.
+
+    Use --swap to select the valid inactive slot without downloading an update.
+    The current and target versions are shown before confirmation; --yes skips
+    confirmation. Reboot separately to apply, or add --reboot to restart now.
+    Shared data and overlay customizations persist and can override files in
+    the selected version. Blank, invalid, pending, and unknown states are refused.
+
+    Examples: sima-cli update --swap; sima-cli update --ip 192.168.6.5 --swap --reboot
+
     The verification certificate is downloaded for the selected channel when configured; use
     --signing-cert URL_OR_FILE for an image signed with your own certificate.
     Developer-portal version lookup for 3.0 is not available yet.
@@ -397,6 +423,9 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force,
 
       • Remote updates require an accessible IP address (``--ip``)
 
+      • PCIe host updates require Linux and ``-i/--internal``; omit the
+        version to choose from the available daily platform builds
+
     Typical Use Cases:
 
       • Updating a SiMa DevKit to the latest GA release
@@ -407,6 +436,8 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force,
 
       • Running updates from both the device itself or a host PC
 
+      • Installing a daily PCIe host package on a Linux development host
+
     \b
     Examples:
 
@@ -438,6 +469,14 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force,
 
         sima-cli -i update -y
 
+        # Select and install a PCIe host package from the daily build catalog (Linux only)
+
+        sima-cli -i update
+
+        # Or install a specific indexed daily platform build
+
+        sima-cli -i update -v 3.0.0_daily_develop_B1774
+
         # Update legacy eLxr (<3.0) from the public pre-release mirror without prompts
 
         sima-cli -y update -f -y
@@ -453,7 +492,34 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force,
     """
     # Prioritize explicit --version option over positional argument
     version_or_url = version_option or version_or_url
+    env_type, env_subtype = get_environment_type()
+    internal = ctx.obj.get("internal", False)
+    auto_confirm = yes or ctx.obj.get("yes", False)
+
+    device_update_options = (
+        dryrun
+        or troot_only
+        or inspect_state
+        or swap
+        or verbose
+        or reboot
+        or force
+        or signing_cert is not None
+        or flavor != "auto"
+    )
+    # A plain update with no remote target means installing the PCIe host
+    # package. Device-specific operations continue to the existing dispatcher.
+    if env_type == "host" and not ip and not device_update_options:
+        if env_subtype != "linux":
+            raise click.UsageError("PCIe host updates are only supported on Linux hosts.")
+        if not internal:
+            raise click.UsageError("Linux PCIe host updates require -i/--internal.")
+        install_host_package(version_or_url, auto_confirm=auto_confirm)
+        return
+
     is_elxr = is_devkit_running_elxr()
+    if swap and (inspect_state or version_or_url or force or troot_only or signing_cert is not None or flavor != "auto"):
+        raise click.UsageError("--swap cannot be combined with --inspect or installation options.")
     if inspect_state and (version_or_url or dryrun or force or troot_only or reboot or signing_cert is not None or flavor != 'auto'):
         raise click.UsageError("--inspect cannot be combined with installation options.")
     try:
@@ -461,7 +527,7 @@ def update(ctx, version_or_url, version_option, ip, yes, passwd, flavor, force,
                          internal=ctx.obj.get("internal", False),
                          auto_confirm=yes or ctx.obj.get("yes", False), dryrun=dryrun,
                          signing_cert=signing_cert, reboot=reboot, inspect=inspect_state, force=force,
-                         troot_only=troot_only, flavor=flavor, local_elxr=is_elxr):
+                         troot_only=troot_only, flavor=flavor, local_elxr=is_elxr, verbose=verbose, swap=swap):
             return
     except (click.ClickException, click.Abort):
         raise
@@ -590,25 +656,34 @@ def mla(ctx):
 @click.pass_context
 def show_mla_memory_usage(ctx):
     """Show MLA Memory usage overtime."""
-    monitor_simaai_mem_chart()
-    pass
+    try:
+        monitor_simaai_mem_chart()
+    except MemoryTelemetryError as exc:
+        raise click.ClickException(str(exc)) from exc
 
 
 # ----------------------
 # bootimg Command
 # ----------------------
 @main.command(name="bootimg")
-@click.option("-v", "--version", required=True, help="Firmware version to download and write (e.g., 1.6.0)")
+@click.option("-v", "--version", required=False, help="Firmware version to download and write (e.g., 1.6.0)")
 @click.option("-b", "--boardtype", type=click.Choice(["modalix",  "mlsoc"], case_sensitive=False), default="modalix", show_default=True, help="Target board type.")
 @click.option("-t", "--fwtype", type=click.Choice(["yocto",  "elxr"], case_sensitive=False), default="elxr", show_default=True, help="Target firmware type.")
 @click.option("-n", "--netboot", is_flag=True, default=False, show_default=True, help="Prepare image for network boot and launch TFTP server.")
+@click.option(
+    "--images",
+    type=click.Path(exists=True, file_okay=False, dir_okay=True, readable=True, path_type=Path),
+    help="Directory containing local netboot source images.",
+)
+@click.option("--delete-cache", is_flag=True, help="Delete the managed netboot cache after the session exits.")
 @click.option("-f", "--force", is_flag=True, help="Allow daily mirror fallback if Artifactory is unavailable (internal Modalix eLxr netboot only).")
 @click.option("--recovery", is_flag=True, help="Write eLxr Modalix recovery media for automatic eMMC recovery.")
 @click.option("--devkit", "--devkit-ip", "devkit_ip", required=False, help="DevKit IP for remote netboot; discover and select a DevKit when omitted.")
 @click.option("-r", "--rootfs", required=False, help="Custom root fs folders (internal use only)")
 @click.option("-a", "--autoflash", is_flag=True, default=False, show_default=True, help="Network boot the selected DevKit, then automatically flash its internal storage once SSH is ready.")
 @click.pass_context
-def bootimg_cmd(ctx, version, boardtype, netboot, devkit_ip, autoflash, fwtype, rootfs, recovery=False, force=False):
+def bootimg_cmd(ctx, version, boardtype, netboot, images, delete_cache, devkit_ip,
+                autoflash, fwtype, rootfs, recovery=False, force=False):
     """
     Prepare a bootable image for the SiMa DevKit.
 
@@ -641,6 +716,17 @@ def bootimg_cmd(ctx, version, boardtype, netboot, devkit_ip, autoflash, fwtype,
 
         • Automating eMMC flashing over the network
 
+    Local Images and Cache:
+
+      • Use ``--images DIRECTORY`` to recursively discover local netboot
+        artifacts. eLxr requires a minimal TFTP archive and an eMMC
+        ``.img.gz``; Yocto requires a release archive.
+
+      • The supplied directory remains read-only. Prepared content is cached
+        under the platform temporary directory in ``sima-cli/netboot`` and is
+        reused by default. ``--delete-cache`` removes only the managed cache
+        entry after the session exits.
+
     \b
     Examples:
 
@@ -664,12 +750,28 @@ def bootimg_cmd(ctx, version, boardtype, netboot, devkit_ip, autoflash, fwtype,
 
         sima-cli bootimg -v 2.0.0 --netboot
 
+        # Prepare netboot from images already downloaded to a local directory
+
+        sima-cli bootimg --netboot --boardtype modalix --fwtype elxr --images /path/to/images
+
         # Prepare USB/SD recovery media that automatically recovers eMMC
 
         sima-cli bootimg -v 3.0.0 --recovery
 
     """
 
+    uses_netboot = netboot or autoflash
+    if images and not uses_netboot:
+        raise click.UsageError("--images requires --netboot or --autoflash.")
+    if delete_cache and not uses_netboot:
+        raise click.UsageError("--delete-cache requires --netboot or --autoflash.")
+    if images and version:
+        raise click.UsageError("--images and --version cannot be used together.")
+    if images and rootfs:
+        raise click.UsageError("--images and --rootfs cannot be used together.")
+    if not version and not images:
+        raise click.UsageError("Provide --version, or use --images for netboot.")
+
     if recovery:
         if netboot or autoflash or rootfs or devkit_ip:
             raise click.UsageError("--recovery cannot be combined with --netboot, --autoflash, --rootfs, or --devkit-ip.")
@@ -693,13 +795,23 @@ def bootimg_cmd(ctx, version, boardtype, netboot, devkit_ip, autoflash, fwtype,
     click.echo(f"   🔹 F/W Type  : {fwtype}")
     click.echo(f"   🔹 F/W Flavor: headless")
     click.echo(f"   🔹 Custom RootFS: {rootfs}")
+    click.echo(f"   🔹 Local Images: {images}")
     click.echo(f"   🔹 DevKit IP : {devkit_ip}")
     
     try:
         boardtype = boardtype if boardtype != 'mlsoc' else 'davinci'
         if netboot or autoflash:
-            setup_netboot(version, boardtype, internal, autoflash, flavor='headless', rootfs=rootfs, swtype=fwtype, allow_daily_fallback=force, devkit=devkit_ip)
-            click.echo("✅ Netboot image prepared and TFTP server is running.")
+            netboot_options = {}
+            if images:
+                netboot_options["images"] = str(images)
+            if delete_cache:
+                netboot_options["delete_cache"] = True
+            setup_netboot(
+                version, boardtype, internal, autoflash, flavor='headless',
+                rootfs=rootfs, swtype=fwtype, allow_daily_fallback=force,
+                devkit=devkit_ip, **netboot_options,
+            )
+            click.echo("✅ Netboot session ended and the TFTP server is stopped.")
         else:
             write_image(version, boardtype, fwtype, internal, flavor='headless', recovery=recovery)
             click.echo("✅ Boot image successfully written.")
@@ -982,7 +1094,28 @@ def network_cmd(ctx):
     """
     Setup Network IP address on the DevKit
 
-    This command only works on the DevKit. It allows user to switch between DHCP and Static (Default addresses) IP.
+    This command only works on the DevKit. Select an interface, then choose DHCP,
+    Default Static IP, or Custom Static IP.
+
+    Custom Static IP prompts for an IPv4 address, such as 192.168.1.50, or an
+    address with a subnet prefix, such as 192.168.1.50/24. A bare address uses
+    the default static profile's prefix. Invalid addresses are rejected;
+    leave the prompt blank to cancel.
+
+    Custom addresses are activated without changing the existing boot
+    configuration. The default static settings are copied into a temporary
+    custom profile with autoconnect disabled on NetworkManager, or a runtime
+    configuration on systemd-networkd. After reboot, the board uses its
+    existing startup configuration. Selecting DHCP or
+    Default Static IP disables the custom configuration.
+    DNS and other default static settings are inherited. If an inherited IPv4
+    gateway is incompatible with the new address, enter a replacement gateway
+    or leave it blank for no gateway. The default profile is not modified.
+
+    Network changes must be made from the DevKit serial console. SSH sessions,
+    including commands launched through sudo, are rejected before configuration
+    changes. A replacement custom profile is activated before the old one is
+    removed.
 
     """
     network_menu()

sima_cli-2.1.19/sima_cli/cloudex/__init__.py

@@ -0,0 +1,5 @@
+"""Experimental CloudEx commands."""
+
+from .commands import register_cloudex_commands
+
+__all__ = ["register_cloudex_commands"]