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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sima-cli
-Version: 2.1.17
+Version: 2.1.18
 Summary: CLI tool for SiMa Developer Portal to download models, firmware, and apps.
 Home-page: https://community.sima.ai/
 Author: SiMa.ai

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sima-cli"
-version = "2.1.17"
+version = "2.1.18"
 description = "CLI tool for SiMa Developer Portal to download models, firmware, and apps."
 readme = "README.md"
 requires-python = ">=3.8"

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

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

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

@@ -2,12 +2,14 @@ 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
@@ -40,6 +42,7 @@ 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.cloudex import register_cloudex_commands
 from sima_cli.vulcan.commands import (
     ENV_METAVAR,
     _environment_shortcut_options,
@@ -188,8 +191,8 @@ 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)
@@ -213,6 +216,7 @@ register_sdk_commands(main)
 register_playbook_commands(main)
 register_vulcan_commands(main)
 register_models_commands(main)
+register_cloudex_commands(main)
 
 
 # ----------------------
@@ -314,7 +318,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",
@@ -350,13 +354,14 @@ def download(ctx, url, dest):
     default=False,
     help="For eLxr updates, validate the update path and show the command without installing."
 )
-@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("--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.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):
     """
-    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,
@@ -397,6 +402,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 +415,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 +448,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,6 +471,30 @@ 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 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 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.")
@@ -461,7 +503,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):
             return
     except (click.ClickException, click.Abort):
         raise
@@ -598,17 +640,24 @@ def show_mla_memory_usage(ctx):
 # 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 +690,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 +724,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 +769,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 +1068,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.18/sima_cli/cloudex/__init__.py

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