diff --git a/docs/getting-started/firmware-update/net-boot.mdx b/docs/getting-started/firmware-update/net-boot.mdx index 29680da..e2e78d9 100644 --- a/docs/getting-started/firmware-update/net-boot.mdx +++ b/docs/getting-started/firmware-update/net-boot.mdx @@ -10,23 +10,21 @@ Use Net Boot Recovery when you need to boot the DevKit over the network instead - You need to **downgrade** the DevKit to an older SDK release. - You need to install a build that is **not the latest release** (for example, a pre-release `develop` build or an internal engineering image). -- You need to recover a board with a corrupted bootloader or filesystem and there's no SD card available. +- You need to recover a board with a corrupted filesystem and there's no SD card available. The board needs a working U-Boot to boot over the network. - You are bringing up a new board and want to avoid wear on internal storage devices. - You are converting a Modalix DevKit from Yocto Linux to eLxr, or from eLxr back to Yocto Linux. See [Convert to eLxr](/hardware/reference/tech-notes/elxr-conversion) for the conversion-specific prerequisites. :::note -This guide uses images that SiMa.ai provides, and it needs a working U-Boot prompt on the board. It does not describe how to install an image that you built yourself. For that, see [Flash an Image to eMMC](/hardware/deployment/flash-image). +This guide uses firmware images provided by SiMa.ai. For an image you built yourself, see [Flash an Image to eMMC](/hardware/deployment/flash-image). ::: -Use the `--netboot` option with `sima-cli bootimg`. It downloads the boot image for the target board and serves it from a built-in TFTP server on the host. For a reachable DevKit or PCIe card currently running firmware 2.1.3 or later, add `--devkit ` so the host can configure the U-Boot environment and initiate netboot. You can then skip Step 3. For older firmware or a device that is not reachable, configure U-Boot through the serial console in Step 3. +Use `sima-cli bootimg --netboot` to serve the target firmware from the host's built-in TFTP server. The host can configure U-Boot over SSH on a reachable DevKit or PCIe card running firmware 2.1.3 or later. For older firmware or a device you cannot reach over SSH, use the serial console in Step 3.
Step 1. Physical Setup :::note -This procedure supports **macOS** and **Ubuntu Linux** hosts. - -If you have not installed `sima-cli` on your host machine, install it before continuing. +Use **sima-cli 2.1.21 or later** on macOS or Ubuntu Linux. On Windows, install and run `sima-cli` in Ubuntu under **Windows Subsystem for Linux (WSL)**. Native Windows NetBoot is unsupported. Use a host shell session to start the TFTP server and initiate the eMMC flash. We recommend a separate serial console connection to monitor netboot progress, even when using `--devkit` and `--autoflash`. A serial console is required for the manual U-Boot configuration in Step 3. ::: @@ -39,21 +37,27 @@ Use a host shell session to start the TFTP server and initiate the eMMC flash. W sima-user@sima-user-machine:~$ sima-cli serial ``` + On Windows, you can open the serial console with a Windows serial client. See [Serial Connection](/hardware/getting-started/setup-serial). + 3. On the DevKit, configure the network interface to the default static IP **192.168.1.20** by following the [Standalone Mode Network Setup](/hardware/getting-started/standalone-mode/network).
+### Windows Hosts {#windows-hosts} + +The board must be able to reach the TFTP server running inside WSL. On Windows 11 22H2 or later, use [WSL 2 mirrored networking](https://learn.microsoft.com/en-us/windows/wsl/networking#mirrored-mode-networking) for direct LAN access. For a direct Ethernet connection, configure the adapter's static IP in Windows and use that board-facing address as the TFTP server address. Check that the Windows and Hyper-V firewall settings allow inbound TFTP traffic to WSL. +
Step 2. Start the TFTP Netboot Server on the Host **Requirements** - The host and DevKit must be on the same physical network or direct Ethernet link. -- The Ethernet connection must be a Gigabit interface or faster (link greater than 1000 Mbps). +- Use a Gigabit Ethernet link or faster. - The host needs Internet access to download the firmware image. - UDP port **69 (TFTP)** must not be blocked by the host firewall. -Replace `` with the target SDK version (for example `%platform_version%`), `` with `modalix` or `mlsoc`, and `` with `yocto` or `elxr`. +Replace `` with the target firmware version (for example `%platform_version%`), `` with `modalix` or `mlsoc`, and `` with `yocto` or `elxr`. **On macOS:** @@ -61,19 +65,19 @@ Replace `` with the target SDK version (for example `%platform_version% sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot ``` -**On Linux:** +**On Ubuntu or Ubuntu under WSL:** :::warning The TFTP server binds to port 69, which is privileged, so `sudo` is required: ::: ```console -sima-user@sima-user-machine:~$ sudo ~/.sima-cli/.venv/bin/sima-cli bootimg --boardtype --fwtype -v --netboot +sima-user@sima-user-machine:~$ sudo "$(command -v sima-cli)" bootimg --boardtype --fwtype -v --netboot ``` ### Configure Netboot from the Host (Firmware 2.1.3 or Later) -If the DevKit or PCIe card is currently running firmware 2.1.3 or later and is reachable from the host, append `--devkit ` to the command above. Replace `` with the device's current IP address. The host configures the U-Boot environment and initiates netboot, so you can skip Step 3 and continue to Step 4. +If the DevKit or PCIe card is currently running firmware 2.1.3 or later and is reachable over SSH, append `--devkit ` to specify its current IPv4 address. If you omit the option, `sima-cli` tries to discover a device and asks you to choose if it finds more than one. Review the device and TFTP server addresses before approving the reboot. If the CLI schedules the reboot into NetBoot, skip Step 3. To flash automatically once the device has netbooted, also append `--autoflash`: @@ -81,13 +85,17 @@ To flash automatically once the device has netbooted, also append `--autoflash`: sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot --devkit --autoflash ``` -On Linux, use the same `sudo ~/.sima-cli/.venv/bin/sima-cli` prefix shown above. With `--autoflash`, you do not need to enter the manual `f` command in Step 4. Keep the serial console connected, if available, to monitor progress, and wait for the CLI to tell you to reboot. +On Ubuntu or WSL, use the same `sudo` invocation shown above. After the network boot completes and SSH is ready, `--autoflash` writes the image and schedules the reboot into eMMC. If remote setup is skipped or the CLI reports that manual serial setup is required, keep the TFTP server running and follow Steps 3 and 4. This command: -1. Downloads the bootable image for the requested SDK version and board type. -2. Extracts the files to a temporary working directory. -3. Starts a local TFTP server and serves the extracted boot files (`Image`, `boot.scr`, `.dtb` files, etc.). +1. Downloads the boot files and flash image for the requested firmware and board type. +2. Prepares the files in a managed cache that later NetBoot sessions can reuse. +3. Starts the TFTP server and serves the boot files, including `netboot.scr.uimg`. + +### Use Previously Downloaded Firmware Images + +To run NetBoot without downloading firmware during the session, replace `-v ` with `--images ` and keep the board and firmware type options. For eLxr, place the matching minimal TFTP archive and compressed eMMC image (`.img.gz`) in that directory. For Yocto, use the release archive. Add `--delete-cache` if you want the CLI to remove its prepared cache after the session.
@@ -108,46 +116,31 @@ Hit any key to stop autoboot: 0 sima$ ``` -Then run the following commands in the U-Boot shell: - -```console -sima:~$ setenv boot_targets net; saveenv; boot -``` - -For Modalix **eLxr** targets, also set the cpio image name before booting: +If `sima-cli` printed manual U-Boot commands, use those commands. Otherwise, for the direct Ethernet setup in Step 1, set the board and TFTP server addresses and load the boot script from the host: ```console -sima:~$ setenv cpio_name simaai-image-palette-modalix.cpio.gz; setenv boot_targets net; saveenv; boot +sima$ setenv ipaddr 192.168.1.20 +sima$ setenv serverip 192.168.1.10 +sima$ tftp ${scriptaddr} ${serverip}:netboot.scr.uimg && source ${scriptaddr} ``` -This tells the DevKit to boot from the host TFTP server prepared in Step 2. - -:::note -By default, the DevKit U-Boot is configured with: - -- `ipaddr=192.168.1.20` (DevKit's Ethernet interface, first port on multi-port boards). -- `serverip=192.168.1.10` (host machine running the TFTP server). - -To use a different network, update `serverip` and `ipaddr` in U-Boot to match your environment. Make sure the DevKit can reach the host at the chosen IPs: - -```console -sima:~$ setenv serverip 10.0.0.10; setenv ipaddr 10.0.0.1; saveenv; boot -``` -::: +For a different network, substitute the board's address and the reachable TFTP server address shown by `sima-cli`.
Step 4. Flash the eMMC -If you enabled `--autoflash` in Step 2, flashing starts automatically once the netbooted device is ready. Monitor progress and reboot when instructed. Otherwise, use the manual commands below. +If automatic flashing starts, keep the host terminal and network connection active until the CLI reports that flashing is complete and a reboot was scheduled. If you reach the `netboot>` prompt and still need to flash the board, use the manual commands below. -The `--netboot` shell on the host supports two commands: +The `netboot>` prompt on the host supports these commands: -- `c` — Show all connected clients and the firmware version currently running on them. -- `f` — Flash the selected client's eMMC. +- `c` — Show TFTP clients, their connection status, and available board information. +- `d` — Discover devices on the local network. +- `f [ip]` — Flash a connected client's eMMC. Supply the board's current IPv4 address to target it directly. +- `q` — End the session and stop the TFTP server. -Wait for the DevKit to finish netbooting. This may take several minutes. Once the login prompt is shown on the serial console, the board is ready. We recommend keeping the serial console connected throughout to observe the full boot sequence. +Wait for the DevKit to finish netbooting and for the CLI to report that SSH is available. This may take several minutes. Switch back to the host terminal and press **Enter** until you see the `netboot>` prompt. Optionally type `c` to confirm the DevKit is connected and show its current firmware version, then type `f` to flash: @@ -165,14 +158,14 @@ netboot> f 🔧 Initiating eMMC flash [...] ``` -The image is roughly 1.6 GB, and the transfer takes a few minutes. Example progress: +Image size and flash time vary by firmware release. Example progress: ```text ↦ 520093696 bytes (520 MB, 496 MiB) copied, 1 s, 515 MB/s ↦ 5368709120 bytes (5.4 GB, 5.0 GiB) copied, 163.331 s, 32.9 MB/s ``` -After flashing completes, power-cycle the DevKit. It boots the target version from eMMC. +After flashing completes, accept the CLI's prompt to reboot into eMMC, or reboot the DevKit later. Confirm the target firmware version on the DevKit with `cat /etc/buildinfo`.
@@ -182,20 +175,20 @@ After flashing completes, power-cycle the DevKit. It boots the target version fr - If the DevKit fails to netboot, verify both host and device are on the same subnet (`192.168.1.x`). - On the Modalix Early Access board, only Ethernet port 0 is supported for netboot. -- On Linux, ensure the host firewall allows **UDP port 69 (TFTP)**. +- Check that the host firewall allows **UDP port 69 (TFTP)**. For WSL, also check the Windows and Hyper-V firewall settings. - Verify connectivity from the DevKit: ```console modalix:~$ ping 192.168.1.10 ``` -- If the DevKit changes IP address during netboot (for example, because DHCP assigns a new address), `sima-cli` is not notified and may continue using the previous address. Connect to the DevKit through the serial console and run `ip addr` to find its current IP address. Then use the `f` command in the host's netboot shell with that address to flash the device: +- If the DevKit changes IP address during NetBoot, `sima-cli` tries to find it by its Ethernet MAC address. If automatic recovery fails, use `d` at the `netboot>` prompt or run `ip -4 addr` on the board through the serial console. Confirm that the address belongs to your board, then flash it using its current address: ```console netboot> f ``` -- If `f` fails to find the image, rerun the `sima-cli bootimg --netboot` command from Step 2 to refresh the TFTP paths. +- If `f` reports that no eMMC image was prepared, check that the firmware archive or local image directory contains the flash image, then restart the command from Step 2. - If NFS-related error messages appear on the serial console after converting a Modalix DevKit to eLxr, they can be safely ignored. diff --git a/docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md b/docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md index cc7b3b4..ef18907 100644 --- a/docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md +++ b/docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md @@ -15,7 +15,7 @@ These changes make the 3.0.0 system image incompatible with the 2.1 system image This note uses these terms: - **Board**: the SoM DevKit or PCIe card. -- **Host**: the Ubuntu or macOS computer that supplies the boot image through a TFTP server. +- **Host**: the Ubuntu, macOS, or Windows computer running the TFTP server. On Windows, install and run `sima-cli` in Ubuntu under **Windows Subsystem for Linux (WSL)**. Native Windows NetBoot is unsupported. Follow the [WSL networking instructions](/hardware/getting-started/firmware-update/net-boot#windows-hosts) before starting. - **Flash**: write a system image to the board's storage. ## Before You Start @@ -71,6 +71,7 @@ A direct Ethernet connection with Internet sharing is recommended. 2. Enable Internet sharing on the host: - **Ubuntu**: follow the shared-connection procedure in [Network Setup](/hardware/getting-started/standalone-mode/network). - **macOS**: enable Internet Sharing for the Ethernet interface connected to the board. + - **Windows with WSL**: use the same-network option below or configure sharing on the Windows Ethernet adapter connected to the board. Alternatively, connect both systems to the same network. The host must be able to reach the board. The board must be able to reach the host's TFTP server. @@ -85,6 +86,8 @@ With Internet sharing enabled, the host assigns an IP address to the board. Use sima-cli serial ``` + On Windows, you can open the serial console with a Windows serial client as described in [Serial Connection](/hardware/getting-started/setup-serial). + 3. Log in to the board. 4. Run this command **on the board**: @@ -132,8 +135,8 @@ Run the commands in this section **on the host**. sima-cli bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash ``` -:::tip Ubuntu hosts -On Ubuntu, run `sima-cli` with `sudo` because the TFTP server uses privileged UDP port 69. Use `which sima-cli` to find the installed CLI's absolute path and run the conversion in one command: +:::tip Ubuntu and WSL hosts +In Ubuntu, including Ubuntu under WSL, run `sima-cli` with `sudo` because the TFTP server uses privileged UDP port 69: ```bash sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash @@ -142,7 +145,7 @@ sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash Replace `{ip}` with the board's IP address. ::: -The command starts a TFTP server on the host. It instructs the board to boot from that server. The `--autoflash` option then writes the image to the board automatically. +The command starts a TFTP server on the host. Confirm the board and TFTP server addresses shown by `sima-cli`, then approve the prompt to start NetBoot. Once the board has booted over the network and SSH is ready, `--autoflash` writes the image and schedules a reboot into eMMC. Keep the host terminal open until the procedure is complete. Keep the network connected and the board powered on. @@ -169,7 +172,7 @@ From the directory that contains `images`, run this command on the host: sima-cli bootimg --netboot --images images ``` -On Ubuntu, run: +On Ubuntu or Ubuntu under WSL, run: ```bash sudo "$(which sima-cli)" bootimg --netboot --images images @@ -177,18 +180,16 @@ sudo "$(which sima-cli)" bootimg --netboot --images images The command uses the local files to start the TFTP server. Follow the board boot and flashing steps in [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot). Then continue with Section 4 below. -## 4. Reboot the Board +## 4. Verify the Board After Reboot -1. Wait for `sima-cli` to tell you to reboot the board. -2. Reboot the board. -3. Wait for the board to start. -4. Connect to the board through serial or SSH. -5. Check the firmware version **on the board**: +1. Wait for `sima-cli` to report that flashing is complete and the reboot has been scheduled. If you flashed manually, follow the reboot prompt in [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot). +2. After the board starts, connect through serial or SSH. +3. Check the firmware version **on the board**: ```bash cat /etc/buildinfo ``` -6. Make sure the version is **3.0.0** before you continue with system setup. +4. Make sure the version is **3.0.0** before you continue with system setup. For PCIe host systems, follow [PCIe Driver Installation](/hardware/getting-started/pcie-mode/driver-installation) to set up the host driver. diff --git a/docs/reference/tech-notes/elxr-conversion.mdx b/docs/reference/tech-notes/elxr-conversion.mdx index 99b6284..7eec92c 100644 --- a/docs/reference/tech-notes/elxr-conversion.mdx +++ b/docs/reference/tech-notes/elxr-conversion.mdx @@ -14,6 +14,8 @@ Use this guide to convert an existing SiMa.ai **Yocto-based DevKit** to the **eL The eLxr platform is available starting from SDK **2.0.0** and later on the **Modalix DevKit**. Converting to eLxr requires a tRoot update and eMMC reflash facilitated by [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot). + +On a Windows host, install and run `sima-cli` in Ubuntu under **Windows Subsystem for Linux (WSL)**. Native Windows NetBoot is unsupported. Follow the [WSL networking instructions](/hardware/getting-started/firmware-update/net-boot#windows-hosts). ::: The **eLxr** platform replaces the legacy Yocto environment as the default runtime for SiMa.ai DevKits. It provides: @@ -66,14 +68,14 @@ After the update completes successfully, **power cycle the DevKit** to apply the The remainder of the conversion uses the standard TFTP netboot + flash procedure documented in [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot). Follow that procedure with the eLxr-specific values below: - **Step 2 (Start TFTP server):** use `--boardtype modalix --fwtype elxr -v %platform_version%`. -- **Step 3 (Configure U-Boot):** set `cpio_name=simaai-image-palette-modalix.cpio.gz` in addition to `boot_targets=net` before running `boot`. -- **Step 4 (Flash):** type `f` at the `netboot>` prompt. +- **Step 3 (Configure U-Boot):** if remote setup is unavailable, use the serial console to load the boot script as shown in the recovery guide. +- **Step 4 (Flash):** when flashing manually, type `f` at the `netboot>` prompt and accept the reboot prompt when flashing completes. ![Connection Diagram](/img/tech-notes/conversion-diagram.png) *Connection Diagram* -After flashing completes and you power-cycle the DevKit, it runs **eLxr** from eMMC. +After the DevKit reboots, it runs **eLxr** from eMMC. @@ -87,7 +89,7 @@ With the DevKit running eLxr, install the Palette SDK and run the example applic
Revert to Yocto (Optional) -To switch back to Yocto, follow [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot) again with `--fwtype yocto`. The `cpio_name` U-Boot variable is not required for Yocto targets — only `setenv boot_targets net`, `saveenv`, `boot`. +To switch back to Yocto, follow [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot) again with `--fwtype yocto` and the target Yocto firmware version. :::note There is **no minimum tRoot version requirement** when converting back to Yocto, so Step 1 above can be skipped. @@ -100,5 +102,5 @@ If NFS-related error messages appear on the serial console after converting to e ## Summary 1. Update to the latest **tRoot** image (≥ 2.0.0). -2. Follow [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot) with `--fwtype elxr` and the eLxr `cpio_name` to flash eLxr to eMMC. +2. Follow [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot) with `--fwtype elxr` to flash eLxr to eMMC. 3. Install the Palette SDK and try out apps via the [Palette SDK documentation](https://developer.sima.ai/software). diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx index 6f60d9a..f347ca3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx @@ -6,54 +6,58 @@ sidebar_position: 2 # ネットワークブートによる復旧 -リムーバブルメディアではなく、ネットワーク経由でDevKitを起動する必要がある場合は、ネットワークブートによる復旧を使用してください。これは、次のような場合に役立ちます。 +リムーバブルメディアではなく、ネットワーク経由でDevKitを起動する必要がある場合は、ネットブートリカバリーを使用してください。これは、次のような場合に役立ちます。 - DevKit を、より古いバージョンの SDK に**ダウングレード**する必要があります。 - 最新リリース版**ではない**ビルドをインストールする必要があります(たとえば、プレリリース版の`develop`ビルドや、社内向けのエンジニアリングイメージなど)。 -- 破損したブートローダーまたはファイルシステムを持つボードを復旧する必要があり、SDカードが利用できません。 -- 新しいボードを立ち上げるにあたり、内部ストレージデバイスの摩耗を避けたいと考えています。 +- SD カードが使えず、ファイルシステムが破損したボードを復旧する場合。ネットワークブートには、正常に動作する U-Boot が必要です。 +- 新しい基板を導入するにあたり、内部ストレージデバイスの摩耗を避けたいと考えているのですね。 - あなたは、Yocto LinuxのModalix DevKitをeLxrに変換するか、またはeLxrからYocto Linuxに戻しています。変換に特有の前提条件については、[eLxr に変換](/hardware/reference/tech-notes/elxr-conversion)を参照してください。 :::note -このガイドでは SiMa.ai が提供するイメージを使用します。また、ボード上で U-Boot プロンプトが動作している必要があります。独自にビルドしたイメージのインストール方法は、このガイドでは説明していません。その場合は、[イメージを eMMC に書き込む](/hardware/deployment/flash-image)を参照してください。 +このガイドでは SiMa.ai が提供するファームウェアイメージを使用します。自分でビルドしたイメージを使用する場合は、[イメージを eMMC に書き込む](/hardware/deployment/flash-image)を参照してください。 ::: -`sima-cli bootimg` とともに、`--netboot` オプションを使用します。これにより、ターゲットボードのブートイメージがダウンロードされ、ホスト上の組み込みTFTPサーバーから提供されます。ファームウェア2.1.3以降を実行している、アクセス可能な DevKit または PCIe カードの場合、`--devkit ` を追加して、ホストが U-Boot 環境を構成し、ネットブートを開始できるようにします。この場合、ステップ3をスキップできます。古いファームウェアを使用している場合、またはアクセスできないデバイスの場合は、ステップ3でシリアルコンソールを通じて U-Boot を構成します。 +`sima-cli bootimg --netboot` を使うと、ホストに内蔵された TFTP サーバーから対象のファームウェアを配信できます。ファームウェア 2.1.3 以降を実行している DevKit または PCIe カードに SSH で接続できる場合は、ホストから U-Boot を設定できます。古いファームウェアを使用している場合や SSH で接続できない場合は、手順 3 でシリアルコンソールを使用してください。
ステップ1:物理的なセットアップ :::note -この手順は、**macOS** および **Ubuntu Linux** ホストをサポートします。 +macOS または Ubuntu Linux では **sima-cli 2.1.21 以降**を使用してください。Windows では、**Windows Subsystem for Linux (WSL)** 上の Ubuntu に `sima-cli` をインストールして実行してください。ネイティブ Windows での NetBoot には対応していません。 -ホストマシンに `sima-cli` がインストールされていない場合は、先にインストールしてから続行してください。 - -ホストのシェルセッションを使用して、TFTPサーバーを起動し、eMMCフラッシュを開始します。`--devkit`と`--autoflash`を使用する場合でも、netbootの進捗状況を監視するために、別のシリアルコンソール接続を使用することをお勧めします。ステップ3のU-Bootを手動で構成するには、シリアルコンソールが必要です。 +ホストのシェルで TFTP サーバーを起動し、eMMC への書き込みを開始します。`--devkit` と `--autoflash` を使用する場合も、進行状況の確認には別のシリアルコンソール接続を推奨します。手順 3 で U-Boot を手動で設定する場合は、シリアルコンソールが必要です。 ::: 1. **DevKitのイーサネットポート**をホストマシンに直接接続し、ホストのネットワークインターフェースを固定IPアドレス**192.168.1.10**に設定します。Modalixの早期アクセス版DevKitでは、イーサネットポート0を使用してください。 -2. 推奨されるシリアル接続では、DevKit の **UART ポート** をホストに接続して、コンソールにアクセスします。ホストに `sima-cli` をインストールし、シリアルターミナルを開きます。 +2. シリアル接続を利用する場合は、DevKit の **UART ポート**をホストに接続します。ホストに `sima-cli` をインストールしたら、シリアルターミナルを開きます。 ```console sima-user@sima-user-machine:~$ sima-cli serial ``` + Windows では、Windows 用のシリアルクライアントでコンソールを開けます。[シリアル接続](/hardware/getting-started/setup-serial)を参照してください。 + 3. DevKitで、ネットワークインターフェースをデフォルトの固定IPアドレス**192.168.1.20**に設定します。設定方法は、[スタンドアロンモードネットワーク設定](/hardware/getting-started/standalone-mode/network)の手順に従ってください。
+### Windows ホスト {#windows-hosts} + +ボードから WSL 内の TFTP サーバーにアクセスできる必要があります。Windows 11 22H2 以降では、LAN から直接アクセスできるように [WSL 2 のミラーネットワークモード](https://learn.microsoft.com/en-us/windows/wsl/networking#mirrored-mode-networking)を使用してください。イーサネットで直結する場合は、Windows でアダプターの固定 IP アドレスを設定し、そのアドレスを TFTP サーバーのアドレスとして使用します。Windows と Hyper-V のファイアウォールが WSL への受信 TFTP トラフィックを許可していることを確認してください。 +
-ステップ2:ホスト上でTFTP ネットワークブートサーバーを起動します。 +手順2:ホスト上でTFTP Netbootサーバーを起動します。 **要件** - ホストとDevKitは、同じ物理ネットワーク上にあるか、または直接のイーサネットリンクで接続されている必要があります。 -- イーサネット接続は、ギガビットインターフェース以上(1000Mbpsを超えるリンク速度)である必要があります。 +- ギガビット以上のイーサネット接続を使用してください。 - ホストは、ファームウェアイメージをダウンロードするためにインターネットに接続する必要があります。 - UDPポート**69(TFTP)**は、ホストのファイアウォールによってブロックされないようにしてください。 -`` を、ターゲットとなる SDK のバージョン(例:`%platform_version%`)に置き換え、`` を `modalix` または `mlsoc` に、そして `` を `yocto` または `elxr` に置き換えてください。 +`` を対象のファームウェアバージョン(例:`%platform_version%`)、`` を `modalix` または `mlsoc`、`` を `yocto` または `elxr` に置き換えてください。 **macOS の場合:** @@ -61,40 +65,44 @@ sidebar_position: 2 sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot ``` -**Linux の場合:** +**Ubuntu または WSL 上の Ubuntu の場合** :::warning TFTPサーバーは、特権ポートである69にバインドされるため、`sudo` が必要です。 ::: ```console -sima-user@sima-user-machine:~$ sudo ~/.sima-cli/.venv/bin/sima-cli bootimg --boardtype --fwtype -v --netboot +sima-user@sima-user-machine:~$ sudo "$(command -v sima-cli)" bootimg --boardtype --fwtype -v --netboot ``` -### ホストから Netboot を設定する(ファームウェア 2.1.3 以降) +### ホストから NetBoot を設定する(ファームウェア 2.1.3 以降) -もし、DevKitまたはPCIeカードが現在、ファームウェア2.1.3以降で動作しており、ホストからアクセス可能な場合、上記のコマンドに`--devkit `を追加します。``を、デバイスの現在のIPアドレスに置き換えてください。ホストはU-Boot環境を構成し、ネットブートを開始するため、ステップ3をスキップしてステップ4に進むことができます。 +ファームウェア 2.1.3 以降を実行している DevKit または PCIe カードに SSH で接続できる場合は、`--devkit ` を追加して現在の IPv4 アドレスを指定します。このオプションを省略すると、`sima-cli` はデバイスの検出を試み、複数見つかった場合は選択を求めます。再起動を承認する前に、デバイスと TFTP サーバーのアドレスを確認してください。NetBoot への再起動が予約された場合は、手順 3 を省略します。 -デバイスがネットブートを開始した後、自動的にフラッシュを実行するには、`--autoflash`も追加してください。 +ネットワークブート後に自動で書き込むには、`--autoflash` も追加します。 ```console sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot --devkit --autoflash ``` -Linuxでは、上記に示したのと同じ`sudo ~/.sima-cli/.venv/bin/sima-cli`プレフィックスを使用します。`--autoflash`を使用すると、ステップ4で手動の`f`コマンドを入力する必要はありません。可能であれば、シリアルコンソールを接続したままにして、進捗状況を監視し、CLIから再起動するように指示されるまで待ちます。 +Ubuntu または WSL では、上記と同じように `sudo` を使用します。ネットワークブートが完了し、SSH 接続が可能になると、`--autoflash` がイメージを書き込み、eMMC から起動するよう再起動を予約します。リモート設定を省略した場合やシリアルコンソールでの手動設定が必要と表示された場合は、TFTP サーバーを起動したまま手順 3 と 4 に進みます。 + +このコマンドは次の処理を行います。 -このコマンドは: +1. 指定したファームウェアとボードの種類に対応するブートファイルと書き込み用イメージをダウンロードします。 +2. 次回以降の NetBoot でも再利用できる管理対象のキャッシュにファイルを準備します。 +3. TFTP サーバーを起動し、`netboot.scr.uimg` などのブートファイルを配信します。 -1. 要求されたSDKバージョンとボードタイプに対応する、起動可能なイメージファイルをダウンロードします。 -2. ファイルを一時的な作業ディレクトリに展開します。 -3. ローカルの TFTP サーバーを起動し、抽出されたブートファイル(`Image`、`boot.scr`、`.dtb`ファイルなど)を配信します。 +### ダウンロード済みのファームウェアイメージを使用する + +実行中のファームウェアのダウンロードを省くには、ボードとファームウェアの種類を指定したまま、`-v ` を `--images ` に置き換えます。eLxr の場合は、対応する最小構成の TFTP アーカイブと圧縮された eMMC イメージ(`.img.gz`)をそのディレクトリに置きます。Yocto の場合はリリースアーカイブを使用します。セッション終了後に準備済みのキャッシュを削除するには、`--delete-cache` を追加します。
-ステップ3:DevKit をネットワークブートするように設定します。 +手順 3:DevKit をネットワークから起動する -ステップ2でホストに`--devkit`を使用してネットブートを設定した場合は、この手順をスキップしてください。それ以外の場合は、以下のシリアルコンソール手順に従ってください。 +手順 2 で `--devkit` を使って NetBoot を設定できた場合は、この手順を省略します。それ以外の場合は、次の手順でシリアルコンソールを使用します。 DevKit をシリアルコンソール経由でホストに接続したまま、電源を入れ直します。電源の入れ直し中にシリアルコンソールの接続が切れた場合は、再接続してください。`Hit any key to stop autoboot` と表示されるまで待ち、任意のキーを押して U-Boot シェルに入ります。 @@ -108,48 +116,33 @@ Hit any key to stop autoboot: 0 sima$ ``` -次に、U-Boot シェルで以下のコマンドを実行します。 - -```console -sima:~$ setenv boot_targets net; saveenv; boot -``` - -Modalix **eLxr** をターゲットとする場合は、起動前に cpio イメージの名前も設定してください。 +`sima-cli` が手動設定用の U-Boot コマンドを表示した場合は、そのコマンドを使用してください。それ以外の場合は、手順 1 のイーサネット直結構成に合わせてボードと TFTP サーバーのアドレスを設定し、ホストからブートスクリプトを読み込みます。 ```console -sima:~$ setenv cpio_name simaai-image-palette-modalix.cpio.gz; setenv boot_targets net; saveenv; boot +sima$ setenv ipaddr 192.168.1.20 +sima$ setenv serverip 192.168.1.10 +sima$ tftp ${scriptaddr} ${serverip}:netboot.scr.uimg && source ${scriptaddr} ``` -これは、ステップ2で準備したホストのTFTPサーバーから起動するように、DevKitに指示します。 - -:::note -デフォルトでは、DevKit U-Boot は、以下の設定で構成されています。 - -- `ipaddr=192.168.1.20`(DevKitのイーサネットインターフェース、マルチポートボードの最初のポート)。 -- `serverip=192.168.1.10`(TFTPサーバーが稼働しているホストマシン)。 - -別のネットワークを使用するには、環境に合わせて、U-Boot 内の `serverip` と `ipaddr` を更新してください。選択した IP アドレスで、DevKit がホストにアクセスできることを確認してください。 - -```console -sima:~$ setenv serverip 10.0.0.10; setenv ipaddr 10.0.0.1; saveenv; boot -``` -::: +別のネットワークを使用する場合は、ボードのアドレスと、`sima-cli` に表示された到達可能な TFTP サーバーのアドレスに置き換えてください。
-ステップ4:eMMCに書き込みます +手順 4:eMMC に書き込む -ステップ2で`--autoflash`を有効にした場合、ネットワークブートされたデバイスが準備完了すると、自動的にフラッシュが開始されます。進捗状況を監視し、指示に従って再起動してください。そうでない場合は、以下の手動コマンドを使用してください。 +自動書き込みが始まったら、書き込みが完了し再起動が予約されたと CLI に表示されるまで、ホストのターミナルとネットワーク接続を維持してください。`netboot>` プロンプトが表示され、まだ書き込みが必要な場合は、次のコマンドを使用します。 -ホスト上の`--netboot`シェルは、次の2つのコマンドをサポートしています。 +ホストの `netboot>` プロンプトでは、次のコマンドを使用できます。 -- `c` — 接続されているすべてのクライアントと、現在それらのクライアントで実行されているファームウェアのバージョンを表示します。 -- `f` — 選択したクライアントのeMMCにファームウェアを書き込みます。 +- `c` — TFTP クライアント、接続状態、取得できたボード情報を表示します。 +- `d` — ローカルネットワーク上のデバイスを検出します。 +- `f [ip]` — 接続したクライアントの eMMC に書き込みます。現在の IPv4 アドレスを指定すると、対象のボードを直接選択できます。 +- `q` — セッションを終了し、TFTP サーバーを停止します。 -DevKit がネットワークブートを完了するまで待ちます。これには数分かかる場合があります。シリアルコンソールにログインプロンプトが表示されたら、ボードは準備完了です。完全なブートシーケンスを観察するために、シリアルコンソールを接続したままにしておくことをお勧めします。 +DevKit のネットワークブートが完了し、CLI に SSH 接続が可能になったと表示されるまで待ちます。数分かかることがあります。 -ホスト端末に戻り、`netboot>` プロンプトが表示されるまで **Enter** キーを押します。オプションで、`c` と入力して、DevKit が接続されていることを確認し、現在のファームウェアバージョンを表示してから、`f` と入力して書き込みます。 +ホスト端末に戻り、`netboot>` プロンプトが表示されるまで **Enter** キーを押します。オプションで、`c` と入力して、DevKit が接続されていることを確認し、現在のファームウェアバージョンを表示してから、`f` と入力してフラッシュします。 ```console netboot> f @@ -165,14 +158,14 @@ netboot> f 🔧 Initiating eMMC flash [...] ``` -このイメージのサイズは約1.6GBで、転送には数分かかります。進捗状況の例: +イメージのサイズと書き込み時間はファームウェアのリリースによって異なります。以下は進行状況の表示例です。 ```text ↦ 520093696 bytes (520 MB, 496 MiB) copied, 1 s, 515 MB/s ↦ 5368709120 bytes (5.4 GB, 5.0 GiB) copied, 163.331 s, 32.9 MB/s ``` -書き込みが完了したら、DevKit の電源を入れ直してください。これにより、eMMCからターゲットバージョンが起動されます。 +書き込みが完了したら、eMMC から起動するよう CLI の再起動プロンプトを承認するか、後で DevKit を再起動します。DevKit 上で `cat /etc/buildinfo` を実行し、対象のファームウェアバージョンを確認してください。
@@ -182,20 +175,20 @@ netboot> f - DevKit がネットワークブートに失敗した場合、ホストとデバイスの両方が同じサブネット (`192.168.1.x`) 上にあることを確認してください。 - Modalixの早期アクセス版では、ネットワークブートに利用できるのはイーサネットポート0のみです。 -- Linuxでは、ホストのファイアウォールがUDPポート69(TFTP)を許可するように設定されていることを確認してください。 +- ホストのファイアウォールで **UDP ポート 69(TFTP)**が許可されていることを確認してください。WSL では、Windows と Hyper-V のファイアウォール設定も確認します。 - DevKitからの接続を確認してください。 ```console modalix:~$ ping 192.168.1.10 ``` -- ネットブート中にDevKitのIPアドレスが変更された場合(たとえば、DHCPによって新しいアドレスが割り当てられた場合)、`sima-cli`には通知されず、以前のアドレスを使い続ける可能性があります。シリアルコンソールを通じてDevKitに接続し、`ip addr`コマンドを実行して、現在のIPアドレスを確認します。次に、ホストのネットブートシェルで、そのアドレスを使用して`f`コマンドを実行し、デバイスにファームウェアを書き込みます。 +- NetBoot 中に DevKit の IP アドレスが変わると、`sima-cli` はイーサネットの MAC アドレスでボードの検出を試みます。自動検出に失敗した場合は、`netboot>` プロンプトで `d` を実行するか、シリアルコンソールからボード上で `ip -4 addr` を実行します。対象のボードのアドレスであることを確認し、現在のアドレスを指定して書き込みます。 ```console netboot> f ``` -- `f` でイメージが見つからない場合は、ステップ2の`sima-cli bootimg --netboot` コマンドを再度実行し、TFTPパスを更新してください。 +- `f` の実行時に eMMC イメージが準備されていないと表示された場合は、ファームウェアアーカイブまたはローカルのイメージディレクトリに書き込み用イメージが含まれていることを確認し、手順 2 のコマンドを再実行してください。 - Modalix DevKit を eLxr に変換した後、シリアルコンソールに NFS 関連のエラーメッセージが表示された場合、それらは無視しても問題ありません。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md index 146a733..561ec3b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md @@ -15,7 +15,7 @@ sidebar_position: 4 このドキュメントでは、以下の用語を使用します。 - **ボード**: SoM DevKit または PCIe カード。 -- **ホスト**: TFTPサーバーを通じてブートイメージを提供する、UbuntuまたはmacOSコンピューター。 +- **ホスト**: TFTP サーバーを実行する Ubuntu、macOS、または Windows コンピューター。Windows では、**Windows Subsystem for Linux (WSL)** 上の Ubuntu に `sima-cli` をインストールして実行します。ネイティブ Windows での NetBoot には対応していません。開始前に [WSL のネットワーク設定](/hardware/getting-started/firmware-update/net-boot#windows-hosts)を参照してください。 - **フラッシュ**: システムイメージをボードのストレージに書き込みます。 ## 始める前に @@ -71,6 +71,7 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash 2. ホストでインターネット共有を有効にします。 - **Ubuntu**: [ネットワーク設定](/hardware/getting-started/standalone-mode/network) に記載されている、共有接続の手順に従ってください。 - **macOS**: ボードに接続されているイーサネットインターフェースに対して、インターネット共有機能を有効にします。 + - **WSL を使用する Windows**: 下記の同一ネットワークを使用する方法を選ぶか、ボードを接続した Windows のイーサネットアダプターでインターネット共有を設定します。 あるいは、両方のシステムを同じネットワークに接続します。ホストはボードにアクセスできる必要があります。また、ボードはホストのTFTPサーバーにアクセスできる必要があります。 @@ -85,6 +86,8 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash sima-cli serial ``` + Windows では、Windows 用のシリアルクライアントでコンソールを開けます。[シリアル接続](/hardware/getting-started/setup-serial)を参照してください。 + 3. ボードにログインしてください。 4. このコマンドを**ボード上で実行**してください。 @@ -132,8 +135,8 @@ PCIe カードのシリアルポートは、アクセスしにくい場合があ sima-cli bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash ``` -:::tip Ubuntu ホスト -Ubuntu では、TFTP サーバーが特権 UDP ポート 69 を使用するため、`sima-cli` を `sudo` で実行してください。`which sima-cli` でインストール済み CLI の絶対パスを調べ、次の単一コマンドで変換を実行できます。 +:::tip Ubuntu および WSL ホスト +WSL 上の Ubuntu を含め、Ubuntu では TFTP サーバーが特権 UDP ポート 69 を使用するため、`sudo` で `sima-cli` を実行します。 ```bash sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash @@ -142,7 +145,7 @@ sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash `{ip}` をボードの IP アドレスに置き換えてください。 ::: -このコマンドは、ホスト上でTFTPサーバーを起動します。これにより、ボードがそのサーバーからブートするように指示されます。その後、`--autoflash`オプションが、イメージをボードに自動的に書き込みます。 +このコマンドはホストで TFTP サーバーを起動します。`sima-cli` に表示されるボードと TFTP サーバーのアドレスを確認し、NetBoot の開始を承認してください。ボードがネットワークから起動して SSH 接続が可能になると、`--autoflash` がイメージを書き込み、eMMC から起動するよう再起動を予約します。 手順が完了するまで、ホストのターミナルを開いたままにしてください。ネットワークに接続した状態を維持し、ボードの電源を入れ続けます。 @@ -169,7 +172,7 @@ cd .. sima-cli bootimg --netboot --images images ``` -Ubuntu で、次のコマンドを実行してください。 +Ubuntu または WSL 上の Ubuntu では、次を実行します。 ```bash sudo "$(which sima-cli)" bootimg --netboot --images images @@ -177,18 +180,16 @@ sudo "$(which sima-cli)" bootimg --netboot --images images このコマンドは、ローカルファイルを使用してTFTPサーバーを起動します。[ネットワークブートによる復旧](/hardware/getting-started/firmware-update/net-boot) に記載されているボードの起動とフラッシュの手順に従ってください。その後、以下のセクション4に進みます。 -## 4. ボードを再起動します。 +## 4. 再起動後にボードを確認する -1. `sima-cli` から再起動の指示があるまで待ってください。 -2. ボードを再起動してください。 -3. ボードが開始されるまでお待ちください。 -4. シリアルまたはSSH経由でボードに接続します。 -5. **ボード上の**ファームウェアバージョンを確認してください。 +1. 書き込みが完了し、再起動が予約されたと `sima-cli` に表示されるまで待ちます。手動で書き込んだ場合は、[ネットワークブートによる復旧](/hardware/getting-started/firmware-update/net-boot)の再起動プロンプトに従います。 +2. ボードが起動したら、シリアル接続または SSH で接続します。 +3. **ボード上の**ファームウェアバージョンを確認してください。 ```bash cat /etc/buildinfo ``` -6. システム設定を進める前に、バージョンが**3.0.0**であることを確認してください。 +4. システム設定を進める前に、バージョンが**3.0.0**であることを確認してください。 PCIe ホストシステムの場合、ホストドライバーを設定するには、[PCIe ドライバーのインストール](/hardware/getting-started/pcie-mode/driver-installation) の手順に従ってください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx index a863c0f..a856c56 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx @@ -13,7 +13,9 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; :::note eLxrプラットフォームは、SDK **2.0.0** 以降のバージョンから、**Modalix DevKit** で利用できます。 -eLxr への変換には、tRoot の更新と eMMC の再フラッシュが必要であり、これらは [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot) によって行われます。 +eLxr への変換には、tRoot の更新と eMMC の再フラッシュが必要であり、これらは [ネットワークブートによる復旧](/hardware/getting-started/firmware-update/net-boot) によって行われます。 + +Windows ホストでは、**Windows Subsystem for Linux (WSL)** 上の Ubuntu に `sima-cli` をインストールして実行します。ネイティブ Windows での NetBoot には対応していません。[WSL のネットワーク設定](/hardware/getting-started/firmware-update/net-boot#windows-hosts)を参照してください。 ::: **eLxr** プラットフォームは、従来の Yocto 環境に代わり、SiMa.ai DevKit のデフォルトのランタイムとして機能します。このプラットフォームは、以下の機能を提供します。 @@ -66,14 +68,14 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi 変換の残りの手順では、[ネットワークブートによる復旧](/hardware/getting-started/firmware-update/net-boot)に記載されている標準の TFTP ネットブートおよびフラッシュ手順を使用します。以下に示す eLxr 固有の値を使用して、その手順に従ってください。 - **手順2(TFTPサーバーの起動):** `--boardtype modalix --fwtype elxr -v %platform_version%` を使用します。 -- **ステップ3(U-Bootの設定):** `boot`を実行する前に、`boot_targets=net`に加えて、`cpio_name=simaai-image-palette-modalix.cpio.gz`を設定します。 -- **手順4(フラッシュ):**`f`と入力し、`netboot>`のプロンプトでEnterキーを押します。 +- **手順 3(U-Boot の設定):** リモートで設定できない場合は、復旧ガイドに従ってシリアルコンソールからブートスクリプトを読み込みます。 +- **手順 4(書き込み):** 手動で書き込む場合は、`netboot>` プロンプトで `f` と入力し、書き込みが完了したら再起動を承認します。 ![接続図](/img/tech-notes/conversion-diagram.png) *接続図* -フラッシュ処理が完了し、DevKitの電源を入れ直すと、eMMCから**eLxr**が起動します。 +DevKit の再起動後は、eMMC から **eLxr** が起動します。 @@ -87,7 +89,7 @@ DevKitでeLxrを実行している状態で、Palette SDKをインストール
Yoctoに戻す(オプション) -Yoctoに戻すには、`--fwtype yocto`を指定して、[ネットワークブートによる復旧](/hardware/getting-started/firmware-update/net-boot)を再度実行します。Yoctoターゲットの場合、`cpio_name` U-Boot変数は必要ありません。`setenv boot_targets net`、`saveenv`、`boot`のみを実行します。 +Yocto に戻すには、`--fwtype yocto` と対象の Yocto ファームウェアバージョンを指定し、[ネットワークブートによる復旧](/hardware/getting-started/firmware-update/net-boot)の手順をもう一度実行します。 :::note Yocto に戻して変換する際に、**tRoot の最小バージョン要件はありません**。したがって、上記のステップ 1 は省略できます。 @@ -100,5 +102,5 @@ eLxr に変換した後、シリアルコンソールに NFS 関連のエラー ## 要約 1. 最新の **tRoot** イメージ(バージョン 2.0.0 以上)に更新してください。 -2. [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot)の手順に従い、`--fwtype elxr`とeLxr `cpio_name`を使用して、eLxrをeMMCに書き込みます。 +2. `--fwtype elxr` を指定し、[ネットワークブートによる復旧](/hardware/getting-started/firmware-update/net-boot)に従って eLxr を eMMC に書き込みます。 3. Palette SDKをインストールし、[Palette SDK ドキュメント](https://developer.sima.ai/software)を参照して、アプリを試してみてください。 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx index 272d2d0..7ac5b9c 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx @@ -1,59 +1,63 @@ --- title: "네트워크 부팅 복구" -description: "네트워크를 통해 Modalix DevKit을 부팅하고 eMMC에 펌웨어를 플래싱합니다." +description: "네트워크를 통해 Modalix DevKit를 부팅하고 eMMC에 펌웨어를 플래싱합니다." sidebar_position: 2 --- # 네트워크 부팅 복구 -이동식 미디어가 아닌 네트워크를 통해 DevKit을 부팅해야 할 때 네트워크 부팅 복구 기능을 사용하세요. 다음의 경우에 유용합니다. +탈착식 미디어가 아닌 네트워크를 통해 DevKit을 부팅해야 할 때 Net Boot 복구 기능을 사용하세요. 다음의 경우에 유용합니다. -- DevKit을 이전 릴리스의 SDK로 **다운그레이드**해야 합니다. -- 최신 릴리스가 아닌 빌드를 설치해야 합니다(예: 사전 릴리스 `develop` 빌드 또는 내부 엔지니어링 이미지). -- 손상된 부트로더 또는 파일 시스템이 있는 보드를 복구해야 하는데, SD 카드가 없습니다. -- 새 보드를 브링업하려 하시는데, 내부 저장 장치의 마모를 줄이고 싶으신 것 같습니다. -- 현재 Modalix DevKit을 Yocto Linux에서 eLxr로, 또는 eLxr에서 다시 Yocto Linux로 변환하고 있습니다. 변환에 필요한 구체적인 요구 사항은 [eLxr로 변환](/hardware/reference/tech-notes/elxr-conversion)을 참조하십시오. +- DevKit을 이전 버전의 SDK로 **다운그레이드**해야 합니다. +- 최신 버전이 아닌 빌드를 설치해야 합니다(예: 사전 릴리스 `develop` 빌드 또는 내부 엔지니어링 이미지). +- SD 카드 없이 파일 시스템이 손상된 보드를 복구해야 합니다. 네트워크 부팅에는 정상적으로 작동하는 U-Boot가 필요합니다. +- 새 보드를 도입하려 하시는데, 내부 저장 장치의 마모를 줄이고 싶으신 것 같습니다. +- 현재 Modalix DevKit을 Yocto Linux에서 eLxr로, 또는 eLxr에서 다시 Yocto Linux로 변환하고 있습니다. 변환에 필요한 구체적인 요구 사항은 [eLxr로 변환](/hardware/reference/tech-notes/elxr-conversion)를 참조하십시오. :::note -이 가이드는 SiMa.ai가 제공하는 이미지를 사용하며, 보드에서 U-Boot 프롬프트가 동작해야 합니다. 직접 빌드한 이미지를 설치하는 방법은 이 가이드에서 다루지 않습니다. 그 경우에는 [eMMC에 이미지 플래싱](/hardware/deployment/flash-image)을 참조하십시오. +이 가이드에서는 SiMa.ai에서 제공하는 펌웨어 이미지를 사용합니다. 직접 빌드한 이미지를 사용하려면 [eMMC에 이미지 기록](/hardware/deployment/flash-image)을 참조하세요. ::: -`sima-cli bootimg`와 함께 `--netboot` 옵션을 사용하세요. 그러면 대상 보드의 부트 이미지를 다운로드하여 호스트의 내장 TFTP 서버에서 제공합니다. 펌웨어 버전 2.1.3 이상을 실행 중인 접근 가능한 DevKit 또는 PCIe 카드의 경우, `--devkit `를 추가하여 호스트가 U-Boot 환경을 구성하고 네트워크 부팅을 시작할 수 있도록 합니다. 이렇게 하면 3단계를 건너뛸 수 있습니다. 이전 펌웨어를 사용하거나 접근할 수 없는 장치의 경우, 3단계에서 직렬 콘솔을 통해 U-Boot를 구성합니다. +`sima-cli bootimg --netboot`를 실행하면 호스트의 내장 TFTP 서버가 대상 펌웨어를 제공합니다. 펌웨어 2.1.3 이상을 실행하는 DevKit 또는 PCIe 카드에 SSH로 연결할 수 있으면 호스트에서 U-Boot를 구성할 수 있습니다. 이전 펌웨어를 사용하거나 SSH로 연결할 수 없으면 3단계에서 시리얼 콘솔을 사용합니다.
1단계: 물리적 설정 :::note -이 절차는 **macOS** 및 **Ubuntu Linux** 호스트를 지원합니다. +macOS 또는 Ubuntu Linux에서는 **sima-cli 2.1.21 이상**을 사용합니다. Windows에서는 **Windows Subsystem for Linux (WSL)**의 Ubuntu에 `sima-cli`를 설치하고 실행해야 합니다. 네이티브 Windows에서는 NetBoot를 지원하지 않습니다. -호스트 시스템에 `sima-cli`가 설치되어 있지 않으면, 다음 단계를 진행하기 전에 설치하십시오. - -호스트 셸 세션을 사용하여 TFTP 서버를 시작하고 eMMC 플래시를 시작합니다. `--devkit` 및 `--autoflash`를 사용하는 경우에도 netboot 진행 상황을 모니터링하기 위해 별도의 직렬 콘솔 연결을 사용하는 것이 좋습니다. 3단계에서 수동으로 U-Boot를 구성하려면 직렬 콘솔이 필요합니다. +호스트 셸에서 TFTP 서버를 시작하고 eMMC에 이미지를 기록합니다. `--devkit`과 `--autoflash`를 사용하는 경우에도 별도의 시리얼 콘솔에서 네트워크 부팅 진행 상황을 확인하는 것이 좋습니다. 3단계에서 U-Boot를 수동으로 구성하려면 시리얼 콘솔이 필요합니다. ::: 1. **DevKit의 이더넷 포트**를 호스트 장치에 직접 연결하고, 호스트의 네트워크 인터페이스를 정적 IP 주소 **192.168.1.10**으로 설정합니다. Modalix 얼리 액세스 DevKit에서는 이더넷 포트 0을 사용합니다. -2. 권장되는 직렬 연결을 위해 DevKit의 **UART 포트**를 호스트에 연결하여 콘솔에 액세스합니다. 호스트에 `sima-cli`를 설치한 후 직렬 터미널을 엽니다. +2. 시리얼 연결을 사용하려면 DevKit의 **UART 포트**를 호스트에 연결합니다. 호스트에 `sima-cli`를 설치한 후 시리얼 터미널을 엽니다. ```console sima-user@sima-user-machine:~$ sima-cli serial ``` -3. DevKit에서 네트워크 인터페이스를 기본 정적 IP 주소인 **192.168.1.20**으로 구성합니다. 구성 방법은 [독립 실행형 모드 네트워크 설정](/hardware/getting-started/standalone-mode/network)을 따르십시오. + Windows에서는 Windows용 시리얼 클라이언트로 콘솔을 열 수 있습니다. [시리얼 연결](/hardware/getting-started/setup-serial)을 참조하세요. + +3. DevKit에서 네트워크 인터페이스를 기본 정적 IP 주소인 **192.168.1.20**으로 구성합니다. 구성 방법은 [독립 모드 네트워크 설정](/hardware/getting-started/standalone-mode/network)을 따르십시오.
+### Windows 호스트 {#windows-hosts} + +보드에서 WSL 내부의 TFTP 서버에 연결할 수 있어야 합니다. Windows 11 22H2 이상에서는 LAN에서 직접 연결할 수 있도록 [WSL 2 미러링 네트워킹](https://learn.microsoft.com/en-us/windows/wsl/networking#mirrored-mode-networking)을 사용합니다. 이더넷으로 직접 연결할 경우 Windows에서 어댑터의 정적 IP 주소를 설정하고 보드와 연결된 인터페이스의 주소를 TFTP 서버 주소로 사용합니다. Windows와 Hyper-V 방화벽이 WSL로 들어오는 TFTP 트래픽을 허용하는지 확인합니다. +
-2단계. 호스트에서 TFTP 네트워크 부팅 서버를 시작합니다. +2단계. 호스트에서 TFTP Netboot 서버를 시작합니다. **요구 사항** -- 호스트와 DevKit은 동일한 물리적 네트워크 또는 직접 이더넷 연결을 통해 연결되어야 합니다. -- 이더넷 연결은 기가비트 인터페이스 이상이어야 합니다(전송 속도는 1000Mbps를 초과해야 함). +- 호스트와 DevKit는 동일한 물리적 네트워크 또는 직접 이더넷 연결을 통해 연결되어야 합니다. +- 기가비트 이상의 이더넷 연결을 사용합니다. - 호스트는 펌웨어 이미지를 다운로드하기 위해 인터넷에 접속해야 합니다. - UDP 포트 **69(TFTP)**는 호스트 방화벽에 의해 차단되어서는 안 됩니다. -``을 대상 SDK 버전(예: `%platform_version%`)으로, ``을 `modalix` 또는 `mlsoc`로, ``을 `yocto` 또는 `elxr`로 바꿉니다. +``을 대상 펌웨어 버전(예: `%platform_version%`)으로, ``을 `modalix` 또는 `mlsoc`로, ``을 `yocto` 또는 `elxr`로 바꿉니다. **macOS에서:** @@ -61,40 +65,44 @@ sidebar_position: 2 sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot ``` -**Linux에서:** +**Ubuntu 또는 WSL의 Ubuntu에서** :::warning TFTP 서버는 권한이 필요한 포트 69에 연결되므로 `sudo` 명령어를 사용해야 합니다. ::: ```console -sima-user@sima-user-machine:~$ sudo ~/.sima-cli/.venv/bin/sima-cli bootimg --boardtype --fwtype -v --netboot +sima-user@sima-user-machine:~$ sudo "$(command -v sima-cli)" bootimg --boardtype --fwtype -v --netboot ``` -### 호스트에서 Netboot를 구성합니다(펌웨어 2.1.3 이상). +### 호스트에서 NetBoot 구성(펌웨어 2.1.3 이상) -DevKit 또는 PCIe 카드가 현재 펌웨어 2.1.3 이상을 실행 중이고 호스트에서 접근 가능한 경우, 위의 명령에 `--devkit `를 추가합니다. ``를 장치의 현재 IP 주소로 바꿉니다. 호스트는 U-Boot 환경을 구성하고 네트워크 부팅을 시작하므로 3단계를 건너뛰고 4단계로 진행할 수 있습니다. +DevKit 또는 PCIe 카드가 펌웨어 2.1.3 이상을 실행 중이고 SSH로 연결할 수 있으면 `--devkit `를 추가하여 현재 IPv4 주소를 지정합니다. 이 옵션을 생략하면 `sima-cli`가 장치를 검색하며, 여러 장치가 검색되면 선택을 요청합니다. 재부팅을 승인하기 전에 장치와 TFTP 서버 주소를 확인합니다. CLI가 NetBoot로 재부팅하도록 예약했다면 3단계를 건너뜁니다. -장치가 네트워크 부팅을 완료한 후 자동으로 플래싱하려면 `--autoflash`를 추가합니다. +네트워크 부팅 후 자동으로 기록하려면 `--autoflash`도 추가합니다. ```console sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot --devkit --autoflash ``` -Linux에서는 위에서 설명한 것과 동일한 `sudo ~/.sima-cli/.venv/bin/sima-cli` 접두사를 사용합니다. `--autoflash`를 사용하면 4단계에서 수동 `f` 명령을 입력할 필요가 없습니다. 가능하다면 직렬 콘솔을 연결하여 진행 상황을 모니터링하고, CLI에서 재부팅하라는 메시지가 나타날 때까지 기다립니다. +Ubuntu 또는 WSL에서는 위와 같은 방식으로 `sudo`를 사용합니다. 네트워크 부팅이 완료되고 SSH 연결이 가능해지면 `--autoflash`가 이미지를 기록하고 eMMC로 부팅하도록 재부팅을 예약합니다. 원격 구성을 건너뛰었거나 CLI에 시리얼 콘솔을 사용한 수동 구성이 필요하다고 표시되면 TFTP 서버를 계속 실행하고 3단계와 4단계를 따릅니다. + +이 명령은 다음 작업을 수행합니다. -이 명령어는: +1. 지정한 펌웨어와 보드 유형에 해당하는 부팅 파일과 기록용 이미지를 다운로드합니다. +2. 다음 NetBoot 세션에서도 재사용할 수 있도록 관리되는 캐시에 파일을 준비합니다. +3. TFTP 서버를 시작하고 `netboot.scr.uimg`를 포함한 부팅 파일을 제공합니다. -1. 요청한 SDK 버전과 보드 유형에 맞는 부팅 가능한 이미지를 다운로드합니다. -2. 파일을 임시 작업 디렉터리에 추출합니다. -3. 로컬 TFTP 서버를 시작하고 추출된 부트 파일을 제공합니다(`Image`, `boot.scr`, `.dtb` 파일 등). +### 미리 다운로드한 펌웨어 이미지 사용 + +세션 중에 펌웨어를 다운로드하지 않고 NetBoot를 실행하려면 보드와 펌웨어 유형 옵션을 유지하고 `-v `을 `--images `로 바꿉니다. eLxr의 경우 해당 디렉터리에 일치하는 최소 TFTP 아카이브와 압축된 eMMC 이미지(`.img.gz`)를 넣습니다. Yocto의 경우 릴리스 아카이브를 사용합니다. 세션이 끝난 후 CLI가 준비한 캐시를 삭제하려면 `--delete-cache`를 추가합니다.
- 3단계: DevKit을 네트워크 부팅으로 구성 +3단계: DevKit 네트워크 부팅 설정 -2단계에서 호스트가 `--devkit`를 사용하여 네트워크 부팅을 구성한 경우 이 단계를 건너뛰십시오. 그렇지 않은 경우 아래의 직렬 콘솔 절차를 따르십시오. +2단계에서 `--devkit`으로 NetBoot 구성을 완료했다면 이 단계를 건너뜁니다. 그 외에는 아래의 시리얼 콘솔 절차를 따릅니다. DevKit을 시리얼 콘솔을 통해 호스트에 연결한 상태에서 전원을 껐다가 다시 켜십시오. 전원 재부팅 중에 시리얼 콘솔 연결이 끊어지면 다시 연결하십시오. `Hit any key to stop autoboot` 메시지가 나타날 때까지 기다린 다음 아무 키나 눌러 U-Boot 셸로 들어갑니다. @@ -108,46 +116,31 @@ Hit any key to stop autoboot: 0 sima$ ``` -다음으로 U-Boot 셸에서 다음 명령을 실행합니다. - -```console -sima:~$ setenv boot_targets net; saveenv; boot -``` - -Modalix **eLxr** 대상의 경우, 부팅하기 전에 cpio 이미지 이름을 설정하십시오. +`sima-cli`가 수동 U-Boot 설정 명령을 출력했다면 해당 명령을 사용합니다. 그 외에는 1단계의 이더넷 직접 연결에 맞춰 보드와 TFTP 서버 주소를 설정한 후 호스트에서 부팅 스크립트를 불러옵니다. ```console -sima:~$ setenv cpio_name simaai-image-palette-modalix.cpio.gz; setenv boot_targets net; saveenv; boot +sima$ setenv ipaddr 192.168.1.20 +sima$ setenv serverip 192.168.1.10 +sima$ tftp ${scriptaddr} ${serverip}:netboot.scr.uimg && source ${scriptaddr} ``` -이 명령은 DevKit에 2단계에서 준비된 호스트 TFTP 서버에서 부팅하도록 지시합니다. - -:::note -기본적으로 DevKit U-Boot는 다음과 같이 구성됩니다. - -- `ipaddr=192.168.1.20`(DevKit의 이더넷 인터페이스, 멀티포트 보드의 첫 번째 포트). -- `serverip=192.168.1.10` (TFTP 서버를 실행하는 호스트 머신). - -다른 네트워크를 사용하려면 U-Boot에서 `serverip` 및 `ipaddr`를 업데이트하여 현재 환경에 맞게 설정하십시오. 선택한 IP 주소에서 DevKit이 호스트에 연결할 수 있는지 확인하십시오. - -```console -sima:~$ setenv serverip 10.0.0.10; setenv ipaddr 10.0.0.1; saveenv; boot -``` -::: +다른 네트워크를 사용하는 경우 보드의 주소와 `sima-cli`에 표시된 연결 가능한 TFTP 서버 주소로 바꿉니다.
- 4단계: eMMC를 플래싱합니다. +4단계: eMMC에 이미지 기록 -2단계에서 `--autoflash`를 활성화한 경우, 네트워크 부팅된 장치가 준비되면 플래싱이 자동으로 시작됩니다. 진행 상황을 모니터링하고 안내에 따라 재부팅하십시오. 그렇지 않은 경우 아래의 수동 명령을 사용하십시오. +자동 기록이 시작되면 CLI에 기록 완료 및 재부팅 예약 메시지가 표시될 때까지 호스트 터미널과 네트워크 연결을 유지합니다. `netboot>` 프롬프트가 나타났지만 보드에 아직 이미지를 기록해야 한다면 아래의 수동 명령을 사용합니다. -호스트의 `--netboot` 셸은 두 가지 명령을 지원합니다. +호스트의 `netboot>` 프롬프트에서 다음 명령을 사용할 수 있습니다. -- `c` — 연결된 모든 클라이언트와 현재 해당 클라이언트에서 실행 중인 펌웨어 버전을 표시합니다. -- `f` — 선택한 클라이언트의 eMMC를 플래싱합니다. +- `c` — TFTP 클라이언트, 연결 상태 및 확인 가능한 보드 정보를 표시합니다. +- `d` — 로컬 네트워크에서 장치를 검색합니다. +- `f [ip]` — 연결된 클라이언트의 eMMC에 이미지를 기록합니다. 보드의 현재 IPv4 주소를 지정하면 해당 보드를 직접 선택할 수 있습니다. +- `q` — 세션을 종료하고 TFTP 서버를 중지합니다. -DevKit이 네트워크 부팅을 완료할 때까지 기다립니다. 이 과정은 몇 분 정도 걸릴 수 있습니다. 시리얼 콘솔에 로그인 프롬프트가 표시되면 보드가 준비된 것입니다. 전체 부팅 과정을 관찰하기 위해 시리얼 콘솔을 계속 연결해 두는 것이 좋습니다. +DevKit의 네트워크 부팅이 끝나고 CLI에 SSH를 사용할 수 있다는 메시지가 표시될 때까지 기다립니다. 몇 분 정도 걸릴 수 있습니다. 호스트 터미널로 돌아가서 `netboot>` 프롬프트가 나타날 때까지 **Enter** 키를 누릅니다. 선택적으로 `c`를 입력하여 DevKit이 연결되었는지 확인하고 현재 펌웨어 버전을 표시한 다음, `f`를 입력하여 펌웨어를 업데이트합니다. @@ -165,14 +158,14 @@ netboot> f 🔧 Initiating eMMC flash [...] ``` -이미지 파일의 크기는 대략 1.6GB이며, 전송하는 데 몇 분 정도 걸립니다. 예시 진행 상황은 다음과 같습니다. +이미지 크기와 기록 시간은 펌웨어 릴리스에 따라 달라집니다. 다음은 진행 상황의 예입니다. ```text ↦ 520093696 bytes (520 MB, 496 MiB) copied, 1 s, 515 MB/s ↦ 5368709120 bytes (5.4 GB, 5.0 GiB) copied, 163.331 s, 32.9 MB/s ``` -플래싱이 완료되면 DevKit의 전원을 껐다가 다시 켜십시오. 그러면 eMMC에서 대상 버전이 부팅됩니다. +기록이 끝나면 eMMC로 부팅하라는 CLI의 재부팅 요청을 승인하거나 나중에 DevKit을 재부팅합니다. DevKit에서 `cat /etc/buildinfo`를 실행하여 대상 펌웨어 버전을 확인합니다.
@@ -180,22 +173,22 @@ netboot> f
문제 해결 -- DevKit이 네트워크 부팅에 실패하면 호스트와 장치가 동일한 서브넷(`192.168.1.x`)에 있는지 확인하십시오. -- Modalix 얼리 액세스 보드에서는 네트워크 부팅을 위해 이더넷 포트 0만 지원됩니다. -- Linux 환경에서 호스트 방화벽이 **UDP 포트 69(TFTP)**를 허용하도록 설정되었는지 확인하십시오. +- DevKit가 네트워크 부팅에 실패하면 호스트와 장치가 동일한 서브넷(`192.168.1.x`)에 있는지 확인하십시오. +- Modalix 얼리 액세스 게시판에서는 네트워크 부팅을 위해 이더넷 포트 0만 지원됩니다. +- 호스트 방화벽이 **UDP 포트 69(TFTP)**를 허용하는지 확인합니다. WSL을 사용하는 경우 Windows와 Hyper-V 방화벽 설정도 확인합니다. - DevKit과의 연결 상태를 확인하십시오. ```console modalix:~$ ping 192.168.1.10 ``` -- 네트부팅 중에 DevKit의 IP 주소가 변경되는 경우(예: DHCP가 새 주소를 할당하는 경우), `sima-cli`는 이를 알림받지 못하고 이전 주소를 계속 사용할 수 있습니다. 직렬 콘솔을 통해 DevKit에 연결하고 `ip addr` 명령을 실행하여 현재 IP 주소를 확인합니다. 그런 다음 호스트의 네트부팅 셸에서 해당 주소를 사용하여 `f` 명령을 실행하여 장치를 플래싱합니다. +- NetBoot 중에 DevKit의 IP 주소가 바뀌면 `sima-cli`가 이더넷 MAC 주소로 장치를 찾습니다. 자동 복구에 실패하면 `netboot>` 프롬프트에서 `d`를 사용하거나 시리얼 콘솔을 통해 보드에서 `ip -4 addr`를 실행합니다. 주소가 대상 보드의 것인지 확인한 후 현재 주소를 사용하여 기록합니다. ```console netboot> f ``` -- `f`에서 이미지를 찾지 못하면 2단계의 `sima-cli bootimg --netboot` 명령을 다시 실행하여 TFTP 경로를 새로 고칩니다. +- `f` 실행 시 준비된 eMMC 이미지가 없다고 표시되면 펌웨어 아카이브 또는 로컬 이미지 디렉터리에 기록용 이미지가 있는지 확인한 후 2단계의 명령을 다시 실행합니다. - Modalix DevKit을 eLxr로 변환한 후 시리얼 콘솔에 NFS 관련 오류 메시지가 표시되면 안전하게 무시해도 됩니다.
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md index 7ba92a2..44094ba 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md @@ -15,7 +15,7 @@ sidebar_position: 4 이 문서에서는 다음 용어를 사용합니다. - **보드**: SoM DevKit 또는 PCIe 카드. -- **호스트**: TFTP 서버를 통해 부트 이미지를 제공하는 Ubuntu 또는 macOS 컴퓨터입니다. +- **호스트**: TFTP 서버를 실행하는 Ubuntu, macOS 또는 Windows 컴퓨터입니다. Windows에서는 **Windows Subsystem for Linux (WSL)**의 Ubuntu에 `sima-cli`를 설치하고 실행해야 합니다. 네이티브 Windows에서는 NetBoot를 지원하지 않습니다. 시작하기 전에 [WSL 네트워크 설정](/hardware/getting-started/firmware-update/net-boot#windows-hosts)을 따릅니다. - **플래시**: 시스템 이미지를 보드의 저장 장치에 기록합니다. ## 시작하기 전에 @@ -71,6 +71,7 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash 2. 호스트에서 인터넷 공유를 활성화합니다. - **Ubuntu**: [네트워크 설정](/hardware/getting-started/standalone-mode/network)에 설명된 공유 연결 절차를 따르세요. - **macOS**: 보드에 연결된 이더넷 인터페이스에 대해 인터넷 공유 기능을 활성화합니다. + - **WSL을 사용하는 Windows**: 아래의 동일 네트워크 연결 방법을 사용하거나 보드에 연결된 Windows 이더넷 어댑터에서 인터넷 공유를 설정합니다. 또는 두 시스템을 동일한 네트워크에 연결합니다. 호스트는 보드에 연결할 수 있어야 합니다. 보드는 호스트의 TFTP 서버에 연결할 수 있어야 합니다. @@ -85,6 +86,8 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash sima-cli serial ``` + Windows에서는 Windows용 시리얼 클라이언트로 콘솔을 열 수 있습니다. [시리얼 연결](/hardware/getting-started/setup-serial)을 참조하세요. + 3. 보드에 로그인하세요. 4. 이 명령을 **보드에서** 실행하세요. @@ -132,8 +135,8 @@ PCIe 카드의 시리얼 포트에 접근하기 어려울 수 있습니다. 시 sima-cli bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash ``` -:::tip Ubuntu 호스트 -Ubuntu에서는 TFTP 서버가 권한이 필요한 UDP 포트 69를 사용하므로 `sima-cli`를 `sudo`로 실행해야 합니다. `which sima-cli`로 설치된 CLI의 절대 경로를 찾아 다음 한 줄 명령으로 변환을 실행합니다: +:::tip Ubuntu 및 WSL 호스트 +WSL의 Ubuntu를 포함하여 Ubuntu에서는 TFTP 서버가 권한이 필요한 UDP 포트 69를 사용하므로 `sudo`로 `sima-cli`를 실행합니다. ```bash sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash @@ -142,7 +145,7 @@ sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash `{ip}`를 보드의 IP 주소로 바꾸십시오. ::: -이 명령어는 호스트에서 TFTP 서버를 시작합니다. 이 명령어는 보드가 해당 서버에서 부팅하도록 지시합니다. 그런 다음 `--autoflash` 옵션이 이미지를 보드에 자동으로 기록합니다. +이 명령은 호스트에서 TFTP 서버를 시작합니다. `sima-cli`에 표시되는 보드와 TFTP 서버 주소를 확인한 후 NetBoot 시작을 승인합니다. 보드의 네트워크 부팅이 끝나고 SSH 연결이 가능해지면 `--autoflash`가 이미지를 기록하고 eMMC로 부팅하도록 재부팅을 예약합니다. 프로세스가 완료될 때까지 호스트 터미널을 열어두십시오. 네트워크 연결을 유지하고 보드의 전원을 켜둔 상태로 유지하십시오. @@ -169,7 +172,7 @@ cd .. sima-cli bootimg --netboot --images images ``` -Ubuntu에서 다음 명령을 실행합니다. +Ubuntu 또는 WSL의 Ubuntu에서는 다음 명령을 실행합니다. ```bash sudo "$(which sima-cli)" bootimg --netboot --images images @@ -177,18 +180,16 @@ sudo "$(which sima-cli)" bootimg --netboot --images images 이 명령어는 로컬 파일을 사용하여 TFTP 서버를 시작합니다. [네트워크 부팅 복구](/hardware/getting-started/firmware-update/net-boot)에 설명된 대로 보드 부팅 및 플래싱 단계를 따르십시오. 그런 다음 아래 섹션 4를 계속 진행합니다. -## 4. 보드를 재부팅합니다. +## 4. 재부팅 후 보드 확인 -1. `sima-cli`가 보드를 재부팅하라는 메시지를 보낼 때까지 기다리세요. -2. 보드를 재부팅합니다. -3. 보드가 시작될 때까지 기다리세요. -4. 시리얼 또는 SSH를 통해 보드에 연결합니다. -5. **보드**에서 펌웨어 버전을 확인하세요. +1. `sima-cli`에 기록 완료 및 재부팅 예약 메시지가 표시될 때까지 기다립니다. 수동으로 기록했다면 [네트워크 부팅 복구](/hardware/getting-started/firmware-update/net-boot)의 재부팅 안내를 따릅니다. +2. 보드가 부팅되면 시리얼 또는 SSH로 연결합니다. +3. **보드**에서 펌웨어 버전을 확인하세요. ```bash cat /etc/buildinfo ``` -6. 시스템 설정을 진행하기 전에 버전이 **3.0.0**인지 확인하십시오. +4. 시스템 설정을 진행하기 전에 버전이 **3.0.0**인지 확인하십시오. PCIe 호스트 시스템의 경우, 호스트 드라이버를 설정하려면 [PCIe 드라이버 설치](/hardware/getting-started/pcie-mode/driver-installation)을 따르십시오. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx index fad7f1c..dac787c 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx @@ -13,7 +13,9 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; :::note eLxr 플랫폼은 SDK **2.0.0** 버전부터 사용 가능하며, **Modalix DevKit**에서 제공됩니다. -eLxr로 변환하려면 tRoot 업데이트와 eMMC 재플래싱이 필요하며, 이는 [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot)를 통해 수행됩니다. +eLxr로 변환하려면 tRoot 업데이트와 eMMC 재플래싱이 필요하며, 이는 [네트워크 부팅 복구](/hardware/getting-started/firmware-update/net-boot)를 통해 수행됩니다. + +Windows 호스트에서는 **Windows Subsystem for Linux (WSL)**의 Ubuntu에 `sima-cli`를 설치하고 실행해야 합니다. 네이티브 Windows에서는 NetBoot를 지원하지 않습니다. [WSL 네트워크 설정](/hardware/getting-started/firmware-update/net-boot#windows-hosts)을 따릅니다. ::: **eLxr** 플랫폼은 기존의 Yocto 환경을 대체하여 SiMa.ai DevKit의 기본 런타임으로 사용됩니다. 이 플랫폼은 다음과 같은 기능을 제공합니다. @@ -63,17 +65,17 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi
단계 2. eLxr 이미지를 넷부팅하고 eMMC에 플래시합니다. -나머지 변환 과정은 [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot)에 설명된 표준 TFTP 넷부팅 + 플래시 절차를 사용합니다. 아래에 제시된 eLxr에 특정한 값을 사용하여 해당 절차를 따르십시오. +나머지 변환 과정은 [네트워크 부팅 복구](/hardware/getting-started/firmware-update/net-boot)에 설명된 표준 TFTP 넷부팅 + 플래시 절차를 사용합니다. 아래에 제시된 eLxr에 특정한 값을 사용하여 해당 절차를 따르십시오. - **2단계(TFTP 서버 시작):** `--boardtype modalix --fwtype elxr -v %platform_version%`을 사용합니다. -- **3단계(U-Boot 구성):** `boot`를 실행하기 전에 `boot_targets=net` 외에 `cpio_name=simaai-image-palette-modalix.cpio.gz`를 설정합니다. -- **4단계(플래시):** `f`를 `netboot>` 프롬프트에 입력합니다. +- **3단계(U-Boot 설정):** 원격 설정을 사용할 수 없으면 복구 가이드에 따라 시리얼 콘솔에서 부팅 스크립트를 불러옵니다. +- **4단계(이미지 기록):** 수동으로 기록할 때는 `netboot>` 프롬프트에 `f`를 입력하고 기록이 완료되면 재부팅을 승인합니다. ![연결 다이어그램](/img/tech-notes/conversion-diagram.png) *연결 다이어그램* -플래싱이 완료되고 DevKit의 전원을 껐다가 다시 켜면 eMMC에서 **eLxr**가 실행됩니다. +DevKit이 재부팅되면 eMMC에서 **eLxr**가 실행됩니다.
@@ -87,7 +89,7 @@ DevKit에서 eLxr를 실행하는 동안 Palette SDK를 설치하고 예제 애
Yocto로 되돌리기 (선택 사항) -Yocto로 다시 전환하려면 `--fwtype yocto`를 사용하여 [네트워크 부트 복구](/hardware/getting-started/firmware-update/net-boot)를 다시 수행합니다. Yocto 대상에는 `cpio_name` U-Boot 변수가 필요하지 않습니다. `setenv boot_targets net`, `saveenv`, `boot`만 사용하면 됩니다. +Yocto로 돌아가려면 `--fwtype yocto`와 대상 Yocto 펌웨어 버전을 지정하여 [네트워크 부팅 복구](/hardware/getting-started/firmware-update/net-boot) 절차를 다시 따릅니다. :::note Yocto로 다시 변환할 때 **최소 tRoot 버전 요구 사항은 없습니다**. 따라서 위의 1단계는 건너뛸 수 있습니다. @@ -100,5 +102,5 @@ eLxr로 변환한 후 시리얼 콘솔에 NFS 관련 오류 메시지가 표시 ## 요약 1. 최신 **tRoot** 이미지(≥ 2.0.0)로 업데이트하세요. -2. [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot)를 수행하고, `--fwtype elxr` 및 eLxr `cpio_name`을 사용하여 eLxr를 eMMC에 플래싱합니다. +2. `--fwtype elxr`를 지정하고 [네트워크 부팅 복구](/hardware/getting-started/firmware-update/net-boot) 절차에 따라 eMMC에 eLxr를 기록합니다. 3. Palette SDK를 설치하고 [Palette SDK 설명서](https://developer.sima.ai/software)를 통해 앱을 사용해 보세요. diff --git a/i18n/translation-sources.json b/i18n/translation-sources.json index 79fb57e..1fce15c 100644 --- a/i18n/translation-sources.json +++ b/i18n/translation-sources.json @@ -12,7 +12,7 @@ "docs/devkit/modalix-pcie-card.mdx": "232dd51ed358c091888f15e9c087bb5f1ff68f86d74673812c987df63d35e889", "docs/getting-started/firmware-update/boot-image.mdx": "e4118102273dc951ded4d89bd7692940a0f1a3be760efc290cb93f518d682277", "docs/getting-started/firmware-update/index.mdx": "2ad6c9f57a382b20de60086fb6dcf27bef351991adc878804082eb5c09b793d5", - "docs/getting-started/firmware-update/net-boot.mdx": "0ce8638b1d52ce9ee23e95ed091662698e9ea00963f8c9c0a8d884482d948a2f", + "docs/getting-started/firmware-update/net-boot.mdx": "3631303f8722cd114f85a603434d0fe14af74b03413bc47e37b8e010fba41dd1", "docs/getting-started/firmware-update/sima-cli.mdx": "28a519855c9a827cc9b4138da33d238bf07128979dd8236bc1447e2d5e4e5f6c", "docs/getting-started/index.md": "7b67d2771aba9a1aa1becaa4e249f51d98db82c55f20a77628b2e2c1bdbf8888", "docs/getting-started/pcie-mode/driver-installation.mdx": "896c6b7dca22c8bae3c0399d94d808e5e6802dd6fbfbaf640e9ffab1df83ad33", @@ -33,8 +33,8 @@ "docs/reference/extra-docs.md": "779b936385eeb6362cc2705d1c5810b2b0b8e282a01cd6ee164b29667fcdd985", "docs/reference/glossary.md": "31878a4c1db6594fcff0bba415f4e0a199de8d6a8b6ca24147dca9ed4bc99083", "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", - "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", - "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", + "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "8facc96b91543fcc0aa17084b55298b3e4d23e560480960361ed269c0f3b935a", + "docs/reference/tech-notes/elxr-conversion.mdx": "ce5d0ddca61b9cebbd6f434f96229417952d07e0cdd1980b5b655041e056e77a", "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", @@ -59,7 +59,7 @@ "docs/devkit/modalix-pcie-card.mdx": "232dd51ed358c091888f15e9c087bb5f1ff68f86d74673812c987df63d35e889", "docs/getting-started/firmware-update/boot-image.mdx": "e4118102273dc951ded4d89bd7692940a0f1a3be760efc290cb93f518d682277", "docs/getting-started/firmware-update/index.mdx": "2ad6c9f57a382b20de60086fb6dcf27bef351991adc878804082eb5c09b793d5", - "docs/getting-started/firmware-update/net-boot.mdx": "0ce8638b1d52ce9ee23e95ed091662698e9ea00963f8c9c0a8d884482d948a2f", + "docs/getting-started/firmware-update/net-boot.mdx": "3631303f8722cd114f85a603434d0fe14af74b03413bc47e37b8e010fba41dd1", "docs/getting-started/firmware-update/sima-cli.mdx": "28a519855c9a827cc9b4138da33d238bf07128979dd8236bc1447e2d5e4e5f6c", "docs/getting-started/index.md": "7b67d2771aba9a1aa1becaa4e249f51d98db82c55f20a77628b2e2c1bdbf8888", "docs/getting-started/pcie-mode/driver-installation.mdx": "896c6b7dca22c8bae3c0399d94d808e5e6802dd6fbfbaf640e9ffab1df83ad33", @@ -80,8 +80,8 @@ "docs/reference/extra-docs.md": "779b936385eeb6362cc2705d1c5810b2b0b8e282a01cd6ee164b29667fcdd985", "docs/reference/glossary.md": "31878a4c1db6594fcff0bba415f4e0a199de8d6a8b6ca24147dca9ed4bc99083", "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", - "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", - "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", + "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "8facc96b91543fcc0aa17084b55298b3e4d23e560480960361ed269c0f3b935a", + "docs/reference/tech-notes/elxr-conversion.mdx": "ce5d0ddca61b9cebbd6f434f96229417952d07e0cdd1980b5b655041e056e77a", "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", @@ -106,7 +106,7 @@ "docs/devkit/modalix-pcie-card.mdx": "232dd51ed358c091888f15e9c087bb5f1ff68f86d74673812c987df63d35e889", "docs/getting-started/firmware-update/boot-image.mdx": "e4118102273dc951ded4d89bd7692940a0f1a3be760efc290cb93f518d682277", "docs/getting-started/firmware-update/index.mdx": "2ad6c9f57a382b20de60086fb6dcf27bef351991adc878804082eb5c09b793d5", - "docs/getting-started/firmware-update/net-boot.mdx": "0ce8638b1d52ce9ee23e95ed091662698e9ea00963f8c9c0a8d884482d948a2f", + "docs/getting-started/firmware-update/net-boot.mdx": "3631303f8722cd114f85a603434d0fe14af74b03413bc47e37b8e010fba41dd1", "docs/getting-started/firmware-update/sima-cli.mdx": "28a519855c9a827cc9b4138da33d238bf07128979dd8236bc1447e2d5e4e5f6c", "docs/getting-started/index.md": "7b67d2771aba9a1aa1becaa4e249f51d98db82c55f20a77628b2e2c1bdbf8888", "docs/getting-started/pcie-mode/driver-installation.mdx": "896c6b7dca22c8bae3c0399d94d808e5e6802dd6fbfbaf640e9ffab1df83ad33", @@ -127,8 +127,8 @@ "docs/reference/extra-docs.md": "779b936385eeb6362cc2705d1c5810b2b0b8e282a01cd6ee164b29667fcdd985", "docs/reference/glossary.md": "31878a4c1db6594fcff0bba415f4e0a199de8d6a8b6ca24147dca9ed4bc99083", "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", - "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", - "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", + "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "8facc96b91543fcc0aa17084b55298b3e4d23e560480960361ed269c0f3b935a", + "docs/reference/tech-notes/elxr-conversion.mdx": "ce5d0ddca61b9cebbd6f434f96229417952d07e0cdd1980b5b655041e056e77a", "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", @@ -153,7 +153,7 @@ "docs/devkit/modalix-pcie-card.mdx": "232dd51ed358c091888f15e9c087bb5f1ff68f86d74673812c987df63d35e889", "docs/getting-started/firmware-update/boot-image.mdx": "e4118102273dc951ded4d89bd7692940a0f1a3be760efc290cb93f518d682277", "docs/getting-started/firmware-update/index.mdx": "2ad6c9f57a382b20de60086fb6dcf27bef351991adc878804082eb5c09b793d5", - "docs/getting-started/firmware-update/net-boot.mdx": "0ce8638b1d52ce9ee23e95ed091662698e9ea00963f8c9c0a8d884482d948a2f", + "docs/getting-started/firmware-update/net-boot.mdx": "3631303f8722cd114f85a603434d0fe14af74b03413bc47e37b8e010fba41dd1", "docs/getting-started/firmware-update/sima-cli.mdx": "28a519855c9a827cc9b4138da33d238bf07128979dd8236bc1447e2d5e4e5f6c", "docs/getting-started/index.md": "7b67d2771aba9a1aa1becaa4e249f51d98db82c55f20a77628b2e2c1bdbf8888", "docs/getting-started/pcie-mode/driver-installation.mdx": "896c6b7dca22c8bae3c0399d94d808e5e6802dd6fbfbaf640e9ffab1df83ad33", @@ -174,8 +174,8 @@ "docs/reference/extra-docs.md": "779b936385eeb6362cc2705d1c5810b2b0b8e282a01cd6ee164b29667fcdd985", "docs/reference/glossary.md": "31878a4c1db6594fcff0bba415f4e0a199de8d6a8b6ca24147dca9ed4bc99083", "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", - "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", - "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", + "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "8facc96b91543fcc0aa17084b55298b3e4d23e560480960361ed269c0f3b935a", + "docs/reference/tech-notes/elxr-conversion.mdx": "ce5d0ddca61b9cebbd6f434f96229417952d07e0cdd1980b5b655041e056e77a", "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx b/i18n/uk/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx index 9576a06..cbf403d 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx +++ b/i18n/uk/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx @@ -1,59 +1,63 @@ --- title: "Відновлення за допомогою мережевої завантажувальної системи." -description: "Завантажте Modalix DevKit через мережу та встановіть нову прошивку на eMMC." +description: "Завантажте Modalix DevKit через мережу та встановіть нове програмне забезпечення на eMMC." sidebar_position: 2 --- # Відновлення за допомогою мережевої завантажувальної системи. -Використовуйте функцію Net Boot Recovery, коли вам потрібно завантажити DevKit через мережу замість завантаження зі знімного носія. Це корисно в таких випадках: +Використовуйте функцію Net Boot Recovery, коли вам потрібно завантажити DevKit через мережу замість завантаження з переносного носія. Це корисно в таких випадках: - Вам потрібно **повернутися до попередньої версії** DevKit і встановити старішу версію SDK. - Вам потрібно встановити версію, яка **не є останньою офіційною версією** (наприклад, попередню версію `develop` або внутрішню інженерну збірку). -- Вам потрібно відновити роботу пристрою, на якому пошкоджено завантажувач або файлову систему, і при цьому немає можливості використати SD-карту. -- Ви запускаєте нову плату і хочете запобігти зношуванню внутрішніх пристроїв зберігання даних. +- Потрібно відновити плату з пошкодженою файловою системою, а SD-карти немає. Для завантаження через мережу потрібен справний U-Boot. +- Ви вводите в експлуатацію нову плату і хочете запобігти зношуванню внутрішніх пристроїв зберігання даних. - Ви перетворюєте Modalix DevKit з Yocto Linux на eLxr, або з eLxr назад на Yocto Linux. Перегляньте [Перехід на eLxr](/hardware/reference/tech-notes/elxr-conversion), щоб дізнатися про конкретні вимоги до перетворення. :::note -У цьому посібнику використовуються образи, які надає SiMa.ai, і на платі має працювати командний рядок U-Boot. Він не описує встановлення образу, який ви зібрали самі. Для цього див. розділ [Прошивання образу на eMMC](/hardware/deployment/flash-image). +У цьому посібнику використовуються образи прошивки від SiMa.ai. Якщо ви зібрали образ самостійно, див. [Запис образу в eMMC](/hardware/deployment/flash-image). ::: -Використовуйте опцію `--netboot` разом із `sima-cli bootimg`. Вона завантажує образ завантаження для цільової плати та надає його через вбудований TFTP-сервер на хості. Якщо DevKit або PCIe карта доступна та працює під керуванням версії прошивки 2.1.3 або новішої, додайте `--devkit `, щоб хост міг налаштувати середовище U-Boot і запустити мережеве завантаження. У цьому випадку можна пропустити крок 3. Для старих версій прошивки або пристроїв, до яких неможливо отримати доступ, налаштуйте U-Boot через послідовну консоль на кроці 3. +Виконайте `sima-cli bootimg --netboot`, щоб надати доступ до цільової прошивки через вбудований TFTP-сервер на хості. Якщо на DevKit або платі PCIe встановлено прошивку версії 2.1.3 чи новішої і пристрій доступний через SSH, хост може налаштувати U-Boot. Для старішої прошивки або якщо SSH недоступний, скористайтеся послідовною консоллю на кроці 3.
Крок 1. Фізичне налаштування :::note -Ця процедура підтримує хости **macOS** і **Ubuntu Linux**. +У macOS або Ubuntu Linux використовуйте **sima-cli 2.1.21 або новішої версії**. У Windows установлюйте й запускайте `sima-cli` в Ubuntu у **Windows Subsystem for Linux (WSL)**. NetBoot безпосередньо у Windows не підтримується. -Якщо ви ще не встановили `sima-cli` на вашому хості, встановіть його, перш ніж продовжувати. - -Використовуйте сесію командного рядка хоста, щоб запустити TFTP-сервер і розпочати процес прошивання eMMC. Ми рекомендуємо використовувати окреме з’єднання послідовної консолі для моніторингу прогресу мережевої завантаження, навіть якщо ви використовуєте `--devkit` і `--autoflash`. Для ручного налаштування U-Boot на етапі 3 потрібне з’єднання послідовної консолі. +Скористайтеся терміналом хоста, щоб запустити TFTP-сервер і почати запис образу в eMMC. Радимо відкрити окрему послідовну консоль для спостереження за мережевим завантаженням, навіть якщо ви використовуєте `--devkit` і `--autoflash`. Для ручного налаштування U-Boot на кроці 3 потрібна послідовна консоль. ::: 1. Під’єднайте **Ethernet-порт DevKit** безпосередньо до хост-машини та налаштуйте мережевий інтерфейс хоста на статичну IP-адресу **192.168.1.10**. На Modalix Early Access DevKit використовуйте Ethernet-порт 0. -2. Для рекомендованого послідовного з’єднання під’єднайте **UART порт** DevKit до хоста для отримання доступу до консолі. Якщо на хості встановлено `sima-cli`, відкрийте послідовний термінал: +2. Для рекомендованого послідовного з’єднання під’єднайте **порт UART** DevKit до хоста. Установіть `sima-cli` на хості й відкрийте послідовний термінал. ```console sima-user@sima-user-machine:~$ sima-cli serial ``` + У Windows можна відкрити консоль за допомогою клієнта послідовного порту для Windows. Див. [Послідовне з’єднання](/hardware/getting-started/setup-serial). + 3. На DevKit налаштуйте мережевий інтерфейс, встановивши для нього стандартну статичну IP-адресу **192.168.1.20**, дотримуючись інструкцій [Налаштування мережі в автономному режимі](/hardware/getting-started/standalone-mode/network).
+### Хости Windows {#windows-hosts} + +Плата має з’єднуватися з TFTP-сервером, що працює у WSL. У Windows 11 22H2 або новішій версії використовуйте [дзеркальний режим мережі WSL 2](https://learn.microsoft.com/en-us/windows/wsl/networking#mirrored-mode-networking) для прямого доступу з локальної мережі. Для прямого підключення через Ethernet налаштуйте статичну IP-адресу адаптера у Windows і використовуйте адресу інтерфейсу, під’єднаного до плати, як адресу TFTP-сервера. Переконайтеся, що брандмауери Windows і Hyper-V дозволяють вхідний трафік TFTP до WSL. +
Крок 2. Запустіть сервер TFTP Netboot на хості. **Вимоги** - Хост і DevKit повинні перебувати в одній фізичній мережі або бути з’єднані безпосередньо через Ethernet. -- Підключення Ethernet має бути інтерфейсом Gigabit або швидшим (швидкість передачі даних має перевищувати 1000 Мбіт/с). +- Використовуйте з’єднання Gigabit Ethernet або швидше. - Для завантаження образу прошивки хосту потрібен доступ до Інтернету. - UDP-порт **69 (TFTP)** не повинен бути заблокований брандмауером хоста. -Замініть `` на цільову версію SDK (наприклад, `%platform_version%`), `` на `modalix` або `mlsoc`, а `` на `yocto` або `elxr`. +Замініть `` на цільову версію прошивки (наприклад, `%platform_version%`), `` на `modalix` або `mlsoc`, а `` на `yocto` або `elxr`. **На macOS:** @@ -61,42 +65,46 @@ sidebar_position: 2 sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot ``` -**На Linux:** +**В Ubuntu або в Ubuntu під WSL** :::warning Сервер TFTP прив’язується до порту 69, який має особливі права, тому потрібне використання команди `sudo`: ::: ```console -sima-user@sima-user-machine:~$ sudo ~/.sima-cli/.venv/bin/sima-cli bootimg --boardtype --fwtype -v --netboot +sima-user@sima-user-machine:~$ sudo "$(command -v sima-cli)" bootimg --boardtype --fwtype -v --netboot ``` -### Налаштуйте Netboot на хості (версія прошивки 2.1.3 або новіша). +### Налаштування NetBoot із хоста (прошивка 2.1.3 або новіша) -Якщо на платі DevKit або PCIe зараз працює прошивка версії 2.1.3 або новішої, і до неї можна отримати доступ з хоста, додайте `--devkit ` до наведеної вище команди. Замініть `` на поточну IP-адресу пристрою. Хост налаштовує середовище U-Boot і ініціює мережеву завантаження, тому ви можете пропустити крок 3 і перейти до кроку 4. +Якщо DevKit або плата PCIe працює з прошивкою версії 2.1.3 чи новішої і доступна через SSH, додайте `--devkit ` та вкажіть поточну IPv4-адресу пристрою. Якщо пропустити цей параметр, `sima-cli` спробує знайти пристрій і запропонує вибір, якщо знайде кілька. Перед підтвердженням перезавантаження перевірте адреси пристрою й TFTP-сервера. Якщо CLI запланував перезавантаження в режим NetBoot, пропустіть крок 3. -Щоб автоматично виконати прошивку після мережевої завантаження пристрою, також додайте `--autoflash`: +Щоб автоматично записати образ після мережевого завантаження пристрою, також додайте `--autoflash`. ```console sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot --devkit --autoflash ``` -У системі Linux використовуйте той самий префікс `sudo ~/.sima-cli/.venv/bin/sima-cli`, який показано вище. Якщо використовується `--autoflash`, вам не потрібно вводити команду `f` вручну на етапі 4. За можливості, тримайте підключеною послідовну консоль, щоб відстежувати прогрес, і дочекайтеся, поки інтерфейс командного рядка (CLI) повідомить вам про необхідність перезавантаження. +В Ubuntu або WSL використовуйте `sudo`, як у прикладі вище. Після завершення мережевого завантаження, коли SSH буде доступний, `--autoflash` запише образ і запланує перезавантаження з eMMC. Якщо віддалене налаштування пропущено або CLI вказує, що потрібне ручне налаштування через послідовну консоль, залиште TFTP-сервер запущеним і виконайте кроки 3 і 4. + +Ця команда виконує такі дії. -Ця команда: +1. Завантажує файли завантаження й образ для запису відповідно до вибраної прошивки та типу плати. +2. Готує файли в керованому кеші, який можна повторно використати в наступних сеансах NetBoot. +3. Запускає TFTP-сервер і надає доступ до файлів завантаження, зокрема `netboot.scr.uimg`. -1. Завантажує образ для завантаження, призначений для запитуваної версії SDK і типу плати. -2. Витягує файли та поміщає їх до тимчасового робочого каталогу. -3. Запускає локальний TFTP-сервер і надає доступ до витягнутих файлів завантаження (`Image`, `boot.scr`, `.dtb` та інші файли). +### Використання раніше завантажених образів прошивки + +Щоб виконати NetBoot без завантаження прошивки під час сеансу, замініть `-v ` на `--images ` і залиште параметри типу плати та прошивки. Для eLxr помістіть у цей каталог відповідний мінімальний архів TFTP і стиснений образ eMMC (`.img.gz`). Для Yocto використовуйте архів випуску. Додайте `--delete-cache`, якщо потрібно видалити підготовлений кеш після завершення сеансу.
-Крок 3. Налаштуйте DevKit для завантаження по мережі +Крок 3. Налаштування DevKit для завантаження через мережу -Якщо на другому кроці на хості було налаштовано мережеву завантажувальну систему з використанням `--devkit`, пропустіть цей крок. В іншому випадку дотримуйтесь наведеної нижче процедури підключення через послідовний порт. +Пропустіть цей крок, якщо хост налаштував NetBoot за допомогою `--devkit` на кроці 2. В іншому разі виконайте наведені нижче дії через послідовну консоль. -Перезавантажте DevKit, поки він підключений до хоста через послідовну консоль. Якщо під час перезавантаження послідовна консоль від’єднується, під’єднайте її знову. Зачекайте, поки не з’явиться повідомлення `Hit any key to stop autoboot`, а потім натисніть будь-яку клавішу, щоб перейти до оболонки U-Boot: +Перезавантажте DevKit, поки він підключений до хоста через послідовний порт. Якщо під час перезавантаження послідовний порт від’єднується, під’єднайте його знову. Зачекайте, поки не з’явиться повідомлення `Hit any key to stop autoboot`, а потім натисніть будь-яку клавішу, щоб перейти до оболонки U-Boot: ```console ... ... ... @@ -108,46 +116,31 @@ Hit any key to stop autoboot: 0 sima$ ``` -Потім виконайте наступні команди в оболонці U-Boot: - -```console -sima:~$ setenv boot_targets net; saveenv; boot -``` - -Для цільових систем Modalix **eLxr**, також встановіть назву образу cpio перед завантаженням: +Якщо `sima-cli` вивів команди для ручного налаштування U-Boot, скористайтеся ними. В іншому разі для прямого підключення через Ethernet, описаного в кроці 1, задайте адреси плати й TFTP-сервера, а потім завантажте сценарій із хоста. ```console -sima:~$ setenv cpio_name simaai-image-palette-modalix.cpio.gz; setenv boot_targets net; saveenv; boot +sima$ setenv ipaddr 192.168.1.20 +sima$ setenv serverip 192.168.1.10 +sima$ tftp ${scriptaddr} ${serverip}:netboot.scr.uimg && source ${scriptaddr} ``` -Це дає вказівку DevKit завантажуватися з TFTP-сервера хоста, підготовленого на етапі 2. - -:::note -За замовчуванням, DevKit U-Boot налаштовано таким чином: - -- `ipaddr=192.168.1.20` (Ethernet-інтерфейс DevKit, перший порт на платах з кількома портами). -- `serverip=192.168.1.10` (хост-машина, на якій працює сервер TFTP). - -Щоб використовувати іншу мережу, оновіть значення `serverip` та `ipaddr` у U-Boot, щоб вони відповідали вашому середовищу. Переконайтеся, що DevKit може зв’язатися з хостом за вказаними IP-адресами: - -```console -sima:~$ setenv serverip 10.0.0.10; setenv ipaddr 10.0.0.1; saveenv; boot -``` -::: +Для іншої мережі підставте адресу плати й доступну їй адресу TFTP-сервера, яку показує `sima-cli`.
-Крок 4. Прошийте eMMC +Крок 4. Запис образу в eMMC -Якщо ви ввімкнули `--autoflash` на кроці 2, процес прошивання розпочнеться автоматично, як тільки пристрій, завантажений через мережу, буде готовий. Слідкуйте за ходом процесу та перезавантажте пристрій, коли буде надано відповідну інструкцію. В іншому випадку використовуйте наведені нижче команди для ручного запуску. +Якщо автоматичний запис розпочався, залиште термінал хоста відкритим і збережіть мережеве з’єднання, доки CLI не повідомить, що запис завершено й перезавантаження заплановано. Якщо з’явилося запрошення `netboot>`, а плату ще потрібно прошити, скористайтеся командами нижче. -Оболонка `--netboot` на хості підтримує дві команди: +У запрошенні `netboot>` на хості доступні такі команди. -- `c` — Відобразити всіх підключених клієнтів і версію прошивки, яка зараз на них працює. -- `f` — Прошити eMMC обраного клієнта. +- `c` — показує клієнтів TFTP, стан з’єднання й доступні відомості про плату. +- `d` — шукає пристрої в локальній мережі. +- `f [ip]` — записує образ в eMMC підключеного клієнта. Щоб явно вибрати плату, укажіть її поточну IPv4-адресу. +- `q` — завершує сеанс і зупиняє TFTP-сервер. -Зачекайте, поки DevKit завершить процес мережевої завантажувальної процедури. Це може зайняти кілька хвилин. Після того, як на послідовній консолі з’явиться запрошення до входу, плата буде готова до роботи. Ми рекомендуємо тримати послідовну консоль підключеною протягом усього процесу, щоб спостерігати за повною послідовністю завантаження. +Зачекайте, доки DevKit завантажиться через мережу й CLI повідомить про доступність SSH. Це може тривати кілька хвилин. Поверніться до терміналу хоста та натисніть клавішу **Enter**, поки не з’явиться запрошення `netboot>`. За бажанням введіть `c`, щоб підтвердити, що DevKit підключено, і відобразити поточну версію його прошивки, а потім введіть `f`, щоб розпочати процес прошивання: @@ -165,14 +158,14 @@ netboot> f 🔧 Initiating eMMC flash [...] ``` -Розмір образу становить приблизно 1,6 ГБ, а час передавання даних – кілька хвилин. Приклад відображення прогресу: +Розмір образу й час запису залежать від версії прошивки. Нижче наведено приклад відображення перебігу запису. ```text ↦ 520093696 bytes (520 MB, 496 MiB) copied, 1 s, 515 MB/s ↦ 5368709120 bytes (5.4 GB, 5.0 GiB) copied, 163.331 s, 32.9 MB/s ``` -Після завершення процесу прошивання вимкніть і знову ввімкніть DevKit. Пристрій завантажуватиметься із зазначеної версії, що зберігається в eMMC. +Після завершення запису підтвердьте перезавантаження з eMMC у CLI або перезавантажте DevKit пізніше. На DevKit виконайте `cat /etc/buildinfo` й перевірте, що встановлено цільову версію прошивки.
@@ -181,21 +174,21 @@ netboot> f Усунення несправностей - Якщо DevKit не вдається завантажити через мережу, переконайтеся, що хост і пристрій знаходяться в одній підмережі (`192.168.1.x`). -- На платі Modalix Early Access підтримується лише порт Ethernet 0 для завантаження по мережі. -- У системі Linux переконайтеся, що брандмауер хоста дозволяє використання **UDP-порту 69 (TFTP)**. +- На сторінці Modalix «Ранній доступ» підтримується лише порт Ethernet 0 для завантаження по мережі. +- Переконайтеся, що брандмауер хоста дозволяє трафік через **UDP-порт 69 (TFTP)**. Для WSL також перевірте налаштування брандмауерів Windows і Hyper-V. - Перевірте з’єднання з DevKit: ```console modalix:~$ ping 192.168.1.10 ``` -- Якщо під час мережевої завантажувальної процедури (netboot) DevKit змінює IP-адресу (наприклад, тому що DHCP призначає нову адресу), `sima-cli` не отримує про це повідомлення і може продовжувати використовувати попередню адресу. Підключіться до DevKit через послідовну консоль і виконайте команду `ip addr`, щоб дізнатися поточну IP-адресу. Потім використовуйте команду `f` в оболонці netboot хоста, вказавши цю адресу, щоб прошити пристрій: +- Якщо IP-адреса DevKit зміниться під час NetBoot, `sima-cli` спробує знайти пристрій за MAC-адресою Ethernet. Якщо автоматичний пошук не вдався, введіть `d` у запрошенні `netboot>` або виконайте на платі `ip -4 addr` через послідовну консоль. Переконайтеся, що адреса належить вашій платі, а потім скористайтеся поточною адресою для запису. ```console netboot> f ``` -- Якщо `f` не зможе знайти образ, повторіть виконання команди `sima-cli bootimg --netboot` з кроку 2, щоб оновити шляхи TFTP. -- Якщо після перетворення Modalix DevKit на eLxr на послідовній консолі з’являються повідомлення про помилки, пов’язані з NFS, їх можна безпечно ігнорувати. +- Якщо `f` повідомляє, що образ eMMC не підготовлено, перевірте, чи містить архів прошивки або локальний каталог образ для запису, і повторіть команду з кроку 2. +- Якщо після перетворення Modalix DevKit на eLxr на послідовному консольному інтерфейсі з’являються повідомлення про помилки, пов’язані з NFS, їх можна безпечно ігнорувати.
diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md index 0474385..cc6e69a 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md @@ -15,7 +15,7 @@ sidebar_position: 4 У цій інструкції використовуються такі терміни: - **Плата**: SoM DevKit або плата PCIe. -- **Хост**: комп’ютер Ubuntu або macOS, який надає образ завантаження через TFTP-сервер. +- **Хост**: комп’ютер з Ubuntu, macOS або Windows, на якому працює TFTP-сервер. У Windows установлюйте й запускайте `sima-cli` в Ubuntu у **Windows Subsystem for Linux (WSL)**. NetBoot безпосередньо у Windows не підтримується. Перш ніж почати, виконайте [налаштування мережі WSL](/hardware/getting-started/firmware-update/net-boot#windows-hosts). - **Прошивання**: запис системного образу в пам’ять пристрою. ## Перш ніж почати. @@ -71,6 +71,7 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash 2. Увімкніть спільний доступ до Інтернету на хості: - **Ubuntu**: дотримуйтесь інструкцій щодо налаштування спільного підключення, описаних у розділі [Налаштування мережі.](/hardware/getting-started/standalone-mode/network). - **macOS**: увімкніть функцію спільного доступу до Інтернету для інтерфейсу Ethernet, підключеного до плати. + - **Windows із WSL**: скористайтеся варіантом підключення до однієї мережі, описаним нижче, або налаштуйте спільний доступ до Інтернету на Ethernet-адаптері Windows, під’єднаному до плати. Як альтернатива, під’єднайте обидві системи до однієї мережі. Хост повинен мати можливість зв’язатися з платою. Плата повинна мати можливість зв’язатися з TFTP-сервером хоста. @@ -85,6 +86,8 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash sima-cli serial ``` + У Windows можна відкрити консоль за допомогою клієнта послідовного порту для Windows. Див. [Послідовне з’єднання](/hardware/getting-started/setup-serial). + 3. Увійдіть до системи на платі. 4. Виконайте цю команду **на платі**: @@ -132,8 +135,8 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash sima-cli bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash ``` -:::tip Хости Ubuntu -В Ubuntu запускайте `sima-cli` через `sudo`, оскільки сервер TFTP використовує привілейований UDP-порт 69. Наведена нижче команда використовує `which sima-cli`, щоб знайти абсолютний шлях до встановленого CLI та виконати перетворення: +:::tip Хости Ubuntu та WSL +В Ubuntu, зокрема в Ubuntu під WSL, запускайте `sima-cli` через `sudo`, оскільки TFTP-сервер використовує привілейований UDP-порт 69. ```bash sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash @@ -142,7 +145,7 @@ sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash Замініть `{ip}` на IP-адресу плати. ::: -Ця команда запускає TFTP-сервер на хості. Вона дає вказівку пристрою завантажуватися з цього сервера. Потім опція `--autoflash` автоматично записує образ на пристрій. +Ця команда запускає TFTP-сервер на хості. Перевірте адреси плати й TFTP-сервера, які показує `sima-cli`, і підтвердьте запуск NetBoot. Коли плата завантажиться через мережу й SSH стане доступним, `--autoflash` запише образ і запланує перезавантаження з eMMC. Тримайте термінал хоста відкритим, доки процедура не буде завершена. Переконайтеся, що мережа підключена, а пристрій увімкнено. @@ -169,7 +172,7 @@ cd .. sima-cli bootimg --netboot --images images ``` -На Ubuntu виконайте: +В Ubuntu або в Ubuntu під WSL виконайте таку команду. ```bash sudo "$(which sima-cli)" bootimg --netboot --images images @@ -177,18 +180,16 @@ sudo "$(which sima-cli)" bootimg --netboot --images images Ця команда використовує локальні файли для запуску TFTP-сервера. Дотримуйтесь інструкцій щодо завантаження та прошивання плати, наведених у розділі [Відновлення за допомогою мережевої завантажувальної системи.](/hardware/getting-started/firmware-update/net-boot). Потім перейдіть до розділу 4 нижче. -## 4. Перезавантажте плату. +## 4. Перевірка плати після перезавантаження -1. Зачекайте, поки `sima-cli` не дасть команду перезавантажити пристрій. -2. Перезавантажте плату. -3. Зачекайте, поки плата запуститься. -4. Підключіться до плати через послідовний порт або SSH. -5. Перевірте версію прошивки **на платі**: +1. Зачекайте, доки `sima-cli` повідомить, що запис завершено й перезавантаження заплановано. Якщо ви записували образ вручну, виконайте вказівки щодо перезавантаження з посібника [Відновлення через мережеве завантаження](/hardware/getting-started/firmware-update/net-boot). +2. Після запуску плати під’єднайтеся до неї через послідовний порт або SSH. +3. Перевірте версію прошивки **на платі**: ```bash cat /etc/buildinfo ``` -6. Переконайтеся, що встановлена версія **3.0.0**, перш ніж продовжувати налаштування системи. +4. Переконайтеся, що встановлена версія **3.0.0**, перш ніж продовжувати налаштування системи. Для хост-систем PCIe дотримуйтесь інструкцій [Встановлення драйвера PCIe.](/hardware/getting-started/pcie-mode/driver-installation), щоб налаштувати драйвер хоста. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx index a3e85c3..8f8607b 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx +++ b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx @@ -13,7 +13,9 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; :::note Платформа eLxr доступна, починаючи з SDK **2.0.0** і пізніших версій, на **Modalix DevKit**. -Для переходу на eLxr потрібне оновлення tRoot і повторне програмування eMMC, що здійснюється за допомогою [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot). +Для переходу на eLxr потрібне оновлення tRoot і повторне програмування eMMC, що здійснюється за допомогою [Відновлення через мережеве завантаження](/hardware/getting-started/firmware-update/net-boot). + +На хості Windows установлюйте й запускайте `sima-cli` в Ubuntu у **Windows Subsystem for Linux (WSL)**. NetBoot безпосередньо у Windows не підтримується. Виконайте [налаштування мережі WSL](/hardware/getting-started/firmware-update/net-boot#windows-hosts). ::: Платформа **eLxr** замінює застаріле середовище **Yocto** як стандартне середовище виконання для **SiMa.ai DevKit**. Вона забезпечує: @@ -63,17 +65,17 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi
Крок 2. Завантажте eLxr через мережу (Netboot) та прошийте eMMC. -Решту процесу перетворення виконайте за стандартною процедурою TFTP netboot + flash, описаною в [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot). Дотримуйтесь цієї процедури, використовуючи наведені нижче значення, специфічні для eLxr: +Решту процесу перетворення виконайте за стандартною процедурою TFTP netboot + flash, описаною в [Відновлення через мережеве завантаження](/hardware/getting-started/firmware-update/net-boot). Дотримуйтесь цієї процедури, використовуючи наведені нижче значення, специфічні для eLxr: - **Крок 2 (Запуск TFTP-сервера):** використовуйте `--boardtype modalix --fwtype elxr -v %platform_version%`. -- **Крок 3 (Налаштування U-Boot):** встановіть `cpio_name=simaai-image-palette-modalix.cpio.gz`, на додаток до `boot_targets=net`, перед запуском `boot`. -- **Крок 4 (Прошивання):** введіть `f` у командному рядку `netboot>`. +- **Крок 3 (Налаштування U-Boot):** якщо віддалене налаштування недоступне, завантажте сценарій через послідовну консоль, як описано в посібнику з відновлення. +- **Крок 4 (Запис образу):** для ручного запису введіть `f` у запрошенні `netboot>` і підтвердьте перезавантаження після завершення запису. ![Схема підключення](/img/tech-notes/conversion-diagram.png) *Схема підключення* -Після завершення процесу прошивання та перезавантаження пристрою DevKit, він працює **eLxr**з eMMC. +Після перезавантаження DevKit запускає **eLxr** з eMMC.
@@ -87,7 +89,7 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi
Повернутися до Yocto (Необов’язково) -Щоб повернутися до Yocto, дотримуйтесь [Відновлення за допомогою мережевої завантажувальної системи.](/hardware/getting-started/firmware-update/net-boot) знову з `--fwtype yocto`. `cpio_name` U-Boot змінна не є обов’язковою для Yocto цілі — лише `setenv boot_targets net`, `saveenv`, `boot`. +Щоб повернутися до Yocto, повторіть процедуру з посібника [Відновлення через мережеве завантаження](/hardware/getting-started/firmware-update/net-boot), указавши `--fwtype yocto` й цільову версію прошивки Yocto. :::note Під час повернення до Yocto **немає жодних мінімальних вимог до версії tRoot**, тому крок 1, описаний вище, можна пропустити. @@ -100,5 +102,5 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi ## Підсумок. 1. Оновіть до останньої версії образу **tRoot** (≥ 2.0.0). -2. Виконайте [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot), використовуючи `--fwtype elxr` та eLxr `cpio_name`, щоб прошити eLxr на eMMC. +2. Запишіть eLxr в eMMC за інструкціями [Відновлення через мережеве завантаження](/hardware/getting-started/firmware-update/net-boot), указавши `--fwtype elxr`. 3. Встановіть Palette SDK і спробуйте використовувати додатки за допомогою [документації Palette SDK](https://developer.sima.ai/software). diff --git a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx index edfcbdc..b9ad400 100644 --- a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx +++ b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/getting-started/firmware-update/net-boot.mdx @@ -9,51 +9,55 @@ sidebar_position: 2 當您需要透過網路啟動 DevKit,而不是從可移除媒體啟動時,請使用網路啟動恢復功能。這在以下情況下很有用: - 您需要將 DevKit 降級到較舊版本的 SDK。 -- 您需要安裝一個**不是最新版本**的建置版本(例如,預發布的 `develop` 建置版本或內部工程映像檔)。 -- 您需要修復一個損壞了開機載入程式或檔案系統的板子,但沒有可用的 SD 卡。 -- 您正在進行新板卡的硬體啟動,並希望避免內部儲存裝置耗損。 +- 您需要安裝一個**不是最新版本**的建構版本(例如,預發布的 `develop` 建構版本或內部工程映像檔)。 +- 板卡的檔案系統損毀,且手邊沒有 SD 卡,需要復原板卡。透過網路開機需要能正常運作的 U-Boot。 +- 您正在進行新板卡的初始啟動與驗證,並希望避免內部儲存裝置耗損。 - 您正在將一個 Modalix DevKit 從 Yocto Linux 轉換為 eLxr,或者從 eLxr 轉換回 Yocto Linux。請參閱 [轉換為 eLxr](/hardware/reference/tech-notes/elxr-conversion),以了解轉換所需的特定先決條件。 :::note -本指南使用 SiMa.ai 提供的映像檔,且電路板上必須有可運作的 U-Boot 提示字元。本指南不說明如何安裝您自行建置的映像檔;若有此需求,請參閱[將映像檔燒錄到 eMMC](/hardware/deployment/flash-image)。 +本指南使用 SiMa.ai 提供的韌體映像檔。若要使用自行建置的映像檔,請參閱[將映像檔燒錄至 eMMC](/hardware/deployment/flash-image)。 ::: -使用 `--netboot` 選項搭配 `sima-cli bootimg`。它會下載目標板的啟動映像,並從主機上的內建 TFTP 伺服器提供該映像。對於目前執行韌體 2.1.3 或更高版本的 DevKit 或 PCIe 卡,請新增 `--devkit `,以便主機能夠設定 U-Boot 環境並啟動網路啟動。然後,您可以跳過步驟 3。對於較舊的韌體或無法連線的裝置,請在步驟 3 中透過序列主控台設定 U-Boot。 +使用 `sima-cli bootimg --netboot`,透過主機內建的 TFTP 伺服器提供目標韌體。如果 DevKit 或 PCIe 卡正在執行 2.1.3 或更新版本的韌體,且可以透過 SSH 連線,主機就能設定 U-Boot。如果韌體較舊或無法透過 SSH 連線,請依步驟 3 使用序列主控台。
步驟 1:實體設定 :::note -此程序支援 **macOS** 以及 **Ubuntu Linux** 主機。 +在 macOS 或 Ubuntu Linux 上,請使用 **sima-cli 2.1.21 或更新版本**。在 Windows 上,請在 **Windows 子系統 Linux 版(Windows Subsystem for Linux,WSL)** 的 Ubuntu 環境中安裝並執行 `sima-cli`。原生 Windows 環境不支援 NetBoot。 -如果您尚未在您的主機上安裝 `sima-cli`,請在繼續之前先安裝。 - -使用主機的 Shell 工作階段來啟動 TFTP 伺服器,並開始 eMMC 快閃操作。我們建議使用獨立的序列主控台連線來監控網路啟動進度,即使在使用 `--devkit` 和 `--autoflash` 時也是如此。在步驟 3 中,需要使用序列主控台進行手動 U-Boot 設定。 +在主機終端機啟動 TFTP 伺服器並開始燒錄 eMMC。即使使用 `--devkit` 和 `--autoflash`,仍建議另開序列主控台來查看開機進度。步驟 3 的手動 U-Boot 設定需要使用序列主控台。 ::: -1. 將 **DevKit 的乙太網路連接埠** 直接連接到主機,並將主機的網路介面設定為靜態 IP 位址 **192.168.1.10**。在 Modalix 搶先體驗版 DevKit 上,使用乙太網路連接埠 0。 +1. 將 **DevKit 的乙太網路連接埠** 直接連接到主機,並將主機的網路介面設定為靜態 IP 位址 **192.168.1.10**。在 Modalix 早期版本 DevKit 上,使用乙太網路連接埠 0。 -2. 為了建立建議的序列連接,請將 DevKit 的 **UART 埠** 連接到主機,以便進行主控台存取。在主機上安裝 `sima-cli` 後,請開啟序列終端機: +2. 若要使用建議的序列連線,請將 DevKit 的 **UART 連接埠**接到主機。主機安裝 `sima-cli` 後,請開啟序列終端機。 ```console sima-user@sima-user-machine:~$ sima-cli serial ``` + 在 Windows 上也可以用 Windows 序列埠用戶端開啟主控台。請參閱[序列連線](/hardware/getting-started/setup-serial)。 + 3. 在 DevKit 上,按照 [獨立模式網路設定](/hardware/getting-started/standalone-mode/network) 的步驟,將網路介面設定為預設的靜態 IP 位址 **192.168.1.20**。
+### Windows 主機 {#windows-hosts} + +板卡必須能連到 WSL 內的 TFTP 伺服器。在 Windows 11 22H2 或更新版本上,請使用 [WSL 2 的鏡像網路模式](https://learn.microsoft.com/en-us/windows/wsl/networking#mirrored-mode-networking),讓板卡可以從區域網路直接連線。若使用乙太網路直連,請在 Windows 中設定網路介面卡的固定 IP,並將連接板卡的介面 IP 當作 TFTP 伺服器位址。確認 Windows 和 Hyper-V 的防火牆允許傳入 WSL 的 TFTP 流量。 +
步驟 2:在主機上啟動 TFTP Netboot 伺服器。 **需求** -- 主機和 DevKit 必須位於相同的實體網路或直接乙太網路連線中。 -- 乙太網路連線必須是 Gigabit 介面或更快的介面(傳輸速率大於 1000 Mbps)。 +- 主機和 DevKit 必須位於相同的實體網路或直接以太網路連線中。 +- 請使用 Gigabit Ethernet 或更快的連線。 - 主機需要連線到網際網路才能下載韌體映像檔。 - UDP 埠 **69 (TFTP)** 不得被主機的防火牆封鎖。 -將 `` 替換為目標 SDK 版本(例如 `%platform_version%`),將 `` 替換為 `modalix` 或 `mlsoc`,並將 `` 替換為 `yocto` 或 `elxr`。 +將 `` 替換為目標韌體版本(例如 `%platform_version%`),將 `` 替換為 `modalix` 或 `mlsoc`,並將 `` 替換為 `yocto` 或 `elxr`。 **在 macOS 上:** @@ -61,40 +65,44 @@ sidebar_position: 2 sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot ``` -**在 Linux 上:** +**在 Ubuntu 或 WSL 的 Ubuntu 環境中** :::warning TFTP 伺服器會繫結到 69 埠,而該埠需要特權才能存取,因此 `sudo` 必須提供: ::: ```console -sima-user@sima-user-machine:~$ sudo ~/.sima-cli/.venv/bin/sima-cli bootimg --boardtype --fwtype -v --netboot +sima-user@sima-user-machine:~$ sudo "$(command -v sima-cli)" bootimg --boardtype --fwtype -v --netboot ``` -### 從主機設定 Netboot(韌體 2.1.3 或更新版本) +### 從主機設定 NetBoot(韌體 2.1.3 或更新版本) -如果 DevKit 或 PCIe 卡目前正在執行韌體 2.1.3 或更高版本,並且可以從主機存取,請將 `--devkit ` 附加到上述指令中。將 `` 替換為裝置目前的 IP 位址。主機會設定 U-Boot 環境並啟動網路啟動,因此您可以跳過步驟 3 並繼續到步驟 4。 +如果 DevKit 或 PCIe 卡正在執行 2.1.3 或更新版本的韌體,且可以透過 SSH 連線,請加上 `--devkit ` 並指定裝置目前的 IPv4 位址。省略此選項時,`sima-cli` 會嘗試探索裝置,找到多部裝置時會請您選擇。確認裝置和 TFTP 伺服器位址後,再同意重新啟動。如果 CLI 已排定重新啟動以進入 NetBoot,請跳過步驟 3。 -若要在裝置完成網路啟動後自動進行閃存操作,請同時附加 `--autoflash`。 +若要在裝置透過網路開機後自動燒錄,請加上 `--autoflash`。 ```console sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype --fwtype -v --netboot --devkit --autoflash ``` -在 Linux 系統上,請使用上述相同的 `sudo ~/.sima-cli/.venv/bin/sima-cli` 前置詞。如果啟用了 `--autoflash`,則無需在步驟 4 中手動輸入 `f` 命令。如果可以,請保持序列主控台的連接,以便監控進度,並等待 CLI 提示您重新啟動。 +在 Ubuntu 或 WSL 中,請沿用上方的 `sudo` 指令寫法。裝置完成網路開機且 SSH 就緒後,`--autoflash` 會寫入映像檔,並排定重新啟動以從 eMMC 開機。如果略過遠端設定,或 CLI 顯示需要透過序列主控台手動設定,請保持 TFTP 伺服器運作並依照步驟 3 和 4 操作。 + +這個指令會執行下列作業。 -這個指令: +1. 下載指定韌體和板卡類型所需的開機檔案及燒錄映像檔。 +2. 在受管理的快取中準備檔案,供後續 NetBoot 工作階段重複使用。 +3. 啟動 TFTP 伺服器並提供開機檔案,其中包括 `netboot.scr.uimg`。 -1. 下載指定 SDK 版本和板型對應的可開機映像檔。 -2. 將檔案解壓縮到一個暫時的工作目錄中。 -3. 啟動一個本機 TFTP 伺服器,並提供已解壓縮的啟動檔案(例如:`Image`、`boot.scr`、`.dtb` 檔案等)。 +### 使用已下載的韌體映像檔 + +如果要在 NetBoot 工作階段中使用現有檔案,請保留板卡和韌體類型選項,並將 `-v ` 替換為 `--images `。使用 eLxr 時,請將相符的最小 TFTP 封存檔和壓縮的 eMMC 映像檔(`.img.gz`)放入該目錄。使用 Yocto 時,請使用發行版封存檔。若要在工作階段結束後移除 CLI 準備的快取,請加上 `--delete-cache`。
-步驟 3:將 DevKit 設定為透過網路啟動 +步驟 3:將 DevKit 設定為透過網路開機 -如果主機在步驟 2 中已設定網路啟動,且使用了 `--devkit`,則跳過此步驟。否則,請按照以下序列主控台程序操作。 +如果在步驟 2 已使用 `--devkit` 設定 NetBoot,請跳過此步驟。否則,請依下列說明操作序列主控台。 在 DevKit 連接到主機時,進行電源重啟。如果在電源重啟過程中,序列埠連接中斷,請重新連接。等待直到看到「`Hit any key to stop autoboot`」,然後按下任意鍵以進入 U-Boot 介面: @@ -108,48 +116,33 @@ Hit any key to stop autoboot: 0 sima$ ``` -然後在 U-Boot 終端機中執行以下指令: - -```console -sima:~$ setenv boot_targets net; saveenv; boot -``` - -對於 Modalix **eLxr** 目標,在啟動之前也請設定 cpio 映像檔的名稱: +如果 `sima-cli` 顯示了手動設定 U-Boot 的指令,請執行這些指令。否則,若採用步驟 1 的乙太網路直連設定,請設定板卡與 TFTP 伺服器位址,再從主機載入開機指令碼。 ```console -sima:~$ setenv cpio_name simaai-image-palette-modalix.cpio.gz; setenv boot_targets net; saveenv; boot +sima$ setenv ipaddr 192.168.1.20 +sima$ setenv serverip 192.168.1.10 +sima$ tftp ${scriptaddr} ${serverip}:netboot.scr.uimg && source ${scriptaddr} ``` -這會指示 DevKit 從步驟 2 中準備好的主機 TFTP 伺服器啟動。 - -:::note -預設情況下,DevKit U-Boot 的設定如下: - -- `ipaddr=192.168.1.20`(DevKit的乙太網路介面,多埠板上的第一個埠)。 -- `serverip=192.168.1.10`(執行 TFTP 伺服器的主機)。 - -若要使用不同的網路,請在 U-Boot 中更新 `serverip` 和 `ipaddr`,使其與您的環境相符。請確認 DevKit 可以透過您選擇的 IP 位址連線到主機。 - -```console -sima:~$ setenv serverip 10.0.0.10; setenv ipaddr 10.0.0.1; saveenv; boot -``` -::: +如果使用其他網路,請改用板卡的位址及 `sima-cli` 顯示且板卡可連到的 TFTP 伺服器位址。
-步驟 4:燒錄 eMMC。 +步驟 4:燒錄 eMMC -如果您在步驟 2 中啟用了 `--autoflash`,則在透過網路啟動的裝置準備就緒後,刷機程序會自動開始。請監控進度,並在出現提示時重新啟動。否則,請使用以下手動指令。 +自動燒錄開始後,請保持主機終端機和網路連線,直到 CLI 回報燒錄完成並已排定重新啟動。如果看到 `netboot>` 提示且仍需燒錄板卡,請使用下列手動指令。 -這個 `--netboot` 主機上的 Shell 支援兩個指令: +主機的 `netboot>` 提示支援下列指令。 -- `c` — 顯示所有已連線的使用者端,以及目前正在這些使用者端上執行的韌體版本。 -- `f` — 將選取的客戶端裝置的 eMMC 進行燒錄。 +- `c`:顯示 TFTP 用戶端、連線狀態及可取得的板卡資訊。 +- `d`:探索區域網路上的裝置。 +- `f [ip]`:燒錄已連線用戶端的 eMMC。指定板卡目前的 IPv4 位址,即可直接選取該板卡。 +- `q`:結束工作階段並停止 TFTP 伺服器。 -請等待 DevKit 完成網路啟動。這可能需要幾分鐘。一旦序列主控台上顯示登入提示,則板子已準備就緒。我們建議在整個啟動過程中保持序列主控台的連接,以便觀察完整的啟動序列。 +請等待 DevKit 完成網路開機,且 CLI 顯示 SSH 已可連線。這可能需要幾分鐘。 -切換回主機終端,然後按 **Enter** 鍵,直到您看到 `netboot>` 提示。您可以選擇輸入 `c` 以確認 DevKit 已連接,並顯示其目前的韌體版本,然後輸入 `f` 以進行燒錄: +切換回主機終端,然後按 **Enter** 鍵,直到您看到 `netboot>` 提示。您可以選擇輸入 `c` 以確認 DevKit 已連接,並顯示其目前的韌體版本,然後輸入 `f` 以進行刷寫: ```console netboot> f @@ -165,14 +158,14 @@ netboot> f 🔧 Initiating eMMC flash [...] ``` -該映像檔大小約為 1.6 GB,傳輸過程大約需要幾分鐘。以下為進度範例: +映像檔大小和燒錄時間會因韌體版本而異。以下為進度範例。 ```text ↦ 520093696 bytes (520 MB, 496 MiB) copied, 1 s, 515 MB/s ↦ 5368709120 bytes (5.4 GB, 5.0 GiB) copied, 163.331 s, 32.9 MB/s ``` -完成燒錄後,請重新啟動 DevKit。它會從 eMMC 啟動目標版本。 +燒錄完成後,接受 CLI 提示以重新啟動並從 eMMC 開機,或稍後重新啟動 DevKit。在 DevKit 上執行 `cat /etc/buildinfo`,確認已執行目標韌體版本。
@@ -181,21 +174,21 @@ netboot> f 疑難排解 - 如果 DevKit 無法透過網路啟動,請確認主機和裝置是否位於相同的子網路中 (`192.168.1.x`)。 -- 在 Modalix 搶先體驗版中,僅支援乙太網路連接埠 0 進行網路啟動。 -- 在 Linux 上,請確認主機防火牆允許使用 **UDP 埠 69(TFTP)**。 +- 在 Modalix 搶先體驗版中,僅支援乙太網路埠 0 進行網路啟動。 +- 確認主機防火牆允許 **UDP 連接埠 69(TFTP)**。使用 WSL 時,也請檢查 Windows 和 Hyper-V 防火牆設定。 - 請驗證與 DevKit 的連線。 ```console modalix:~$ ping 192.168.1.10 ``` -- 如果 DevKit 在網路啟動期間變更 IP 位址(例如,因為 DHCP 分配了新的位址),`sima-cli` 不會收到通知,並且可能繼續使用先前的位址。透過序列主控台連接到 DevKit,然後執行 `ip addr` 命令以找出其目前的 IP 位址。然後,在主機的網路啟動 shell 中使用該位址,並使用 `f` 命令來對設備進行刷機: +- 如果 DevKit 在 NetBoot 期間更換 IP 位址,`sima-cli` 會嘗試透過乙太網路 MAC 位址尋找板卡。如果自動尋找失敗,請在 `netboot>` 提示輸入 `d`,或透過序列主控台在板卡上執行 `ip -4 addr`。確認該位址屬於目標板卡後,使用目前位址進行燒錄。 ```console netboot> f ``` -- 如果 `f` 無法找到映像檔,請從步驟 2 重新執行 `sima-cli bootimg --netboot` 命令,以重新整理 TFTP 路徑。 -- 如果在將 Modalix DevKit 轉換為 eLxr 後,序列主控台上出現與 NFS 相關的錯誤訊息,則可以安全地忽略這些訊息。 +- 如果 `f` 回報沒有準備好的 eMMC 映像檔,請確認韌體封存檔或本機映像檔目錄包含燒錄映像檔,再重新執行步驟 2 的指令。 +- 如果在將 Modalix DevKit 轉換為 eLxr 後,序列控制台上出現與 NFS 相關的錯誤訊息,則可以安全地忽略這些訊息。
diff --git a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md index 0833c1b..8361fad 100644 --- a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md +++ b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/convert-2-1-3-to-3-0-0.md @@ -15,7 +15,7 @@ sidebar_position: 4 本文使用以下術語: - **板卡**:SoM DevKit 或 PCIe 卡。 -- **主機**:透過 TFTP 伺服器提供啟動映像檔的 Ubuntu 或 macOS 電腦。 +- **主機**:執行 TFTP 伺服器的 Ubuntu、macOS 或 Windows 電腦。在 Windows 上,請在 **Windows 子系統 Linux 版(Windows Subsystem for Linux,WSL)** 的 Ubuntu 環境中安裝並執行 `sima-cli`。原生 Windows 環境不支援 NetBoot。開始前請依照 [WSL 網路設定說明](/hardware/getting-started/firmware-update/net-boot#windows-hosts)操作。 - **燒錄**:將系統映像寫入板卡的儲存空間。 ## 在您開始之前 @@ -71,6 +71,7 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash 2. 在主機上啟用網際網路共用: - **Ubuntu**:請依照 [網路設定](/hardware/getting-started/standalone-mode/network) 中的「共享連線」程序操作。 - **macOS**:啟用乙太網路介面的網際網路共用功能,該介面連接到板卡上。 + - **使用 WSL 的 Windows**:使用下方的同一網路連線方式,或在 Windows 中設定連接板卡的乙太網路介面卡以共用網際網路。 或者,將兩個系統連接到同一個網路。主機必須能夠連線到板卡。板卡必須能夠連線到主機的 TFTP 伺服器。 @@ -85,6 +86,8 @@ curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash sima-cli serial ``` + 在 Windows 上也可以用 Windows 序列埠用戶端開啟主控台。請參閱[序列連線](/hardware/getting-started/setup-serial)。 + 3. 登入板卡。 4. 請在**板卡上**執行這個指令: @@ -132,8 +135,8 @@ PCIe 卡上的序列埠可能不易觸及。如果您無法連接序列線,請 sima-cli bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash ``` -:::tip Ubuntu 主機 -在 Ubuntu 上,TFTP 伺服器使用需要管理員權限的 UDP 連接埠 69,因此必須使用 `sudo` 執行 `sima-cli`。以下單一指令使用 `which sima-cli` 找出已安裝 CLI 的絕對路徑,然後執行轉換: +:::tip Ubuntu 與 WSL 主機 +在 Ubuntu(包括 WSL 的 Ubuntu 環境)上,TFTP 伺服器使用需要特權的 UDP 連接埠 69,因此請使用 `sudo` 執行 `sima-cli`。 ```bash sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash @@ -142,7 +145,7 @@ sudo "$(which sima-cli)" bootimg -v 3.0.0 --netboot --devkit {ip} --autoflash 將 `{ip}` 替換為板卡的 IP 位址。 ::: -這個指令會在主機上啟動一個 TFTP 伺服器。它會指示板卡從該伺服器啟動。然後,`--autoflash` 選項會自動將映像檔寫入板卡。 +此指令會在主機上啟動 TFTP 伺服器。請確認 `sima-cli` 顯示的板卡及 TFTP 伺服器位址,再同意啟動 NetBoot。板卡完成網路開機且 SSH 就緒後,`--autoflash` 會寫入映像檔,並排定重新啟動以從 eMMC 開機。 在程序完成之前,請保持主機終端視窗開啟。請保持網路連線,並確保板卡已開啟電源。 @@ -169,7 +172,7 @@ cd .. sima-cli bootimg --netboot --images images ``` -在 Ubuntu 上執行: +在 Ubuntu 或 WSL 的 Ubuntu 環境中,執行以下指令。 ```bash sudo "$(which sima-cli)" bootimg --netboot --images images @@ -177,18 +180,16 @@ sudo "$(which sima-cli)" bootimg --netboot --images images 這個指令會使用本機檔案來啟動 TFTP 伺服器。請依照 [網路開機恢復](/hardware/getting-started/firmware-update/net-boot) 中的板卡啟動和燒錄步驟進行操作。然後繼續執行下方第 4 節的說明。 -## 4. 重新啟動板卡。 +## 4. 重新啟動後確認板卡狀態 -1. 請等待 `sima-cli` 指示您重新啟動板卡。 -2. 重新啟動板卡。 -3. 請等待板卡啟動。 -4. 透過序列埠或 SSH 連接到板卡上。 -5. 請檢查**板卡上**的韌體版本: +1. 等待 `sima-cli` 回報燒錄完成並已排定重新啟動。如果您手動燒錄,請依照[網路開機復原](/hardware/getting-started/firmware-update/net-boot)的重新啟動提示操作。 +2. 板卡啟動後,透過序列埠或 SSH 連線。 +3. 請檢查**板卡上**的韌體版本: ```bash cat /etc/buildinfo ``` -6. 請確認版本為 **3.0.0** 後,再繼續進行系統設定。 +4. 請確認版本為 **3.0.0** 後,再繼續進行系統設定。 對於 PCIe 主機系統,請依照 [PCIe 驅動程式安裝](/hardware/getting-started/pcie-mode/driver-installation) 的步驟來設定主機驅動程式。 diff --git a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx index 3884323..e61bc93 100644 --- a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx +++ b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/elxr-conversion.mdx @@ -13,7 +13,9 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; :::note 從 SDK **2.0.0** 及其後續版本開始,即可使用 eLxr 平台,該平台可在 **Modalix DevKit** 上使用。 -轉換為 eLxr 需要更新 tRoot 並重新刷寫 eMMC,此過程由 [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot) 協助完成。 +轉換為 eLxr 需要更新 tRoot 並重新刷寫 eMMC,此過程由 [網路開機復原](/hardware/getting-started/firmware-update/net-boot) 協助完成。 + +使用 Windows 主機時,請在 **Windows 子系統 Linux 版(Windows Subsystem for Linux,WSL)** 的 Ubuntu 環境中安裝並執行 `sima-cli`。原生 Windows 環境不支援 NetBoot。請依照 [WSL 網路設定說明](/hardware/getting-started/firmware-update/net-boot#windows-hosts)操作。 ::: **eLxr** 平台取代舊版的 Yocto 環境,成為 SiMa.ai DevKit 的預設執行階段。它提供: @@ -63,17 +65,17 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi
步驟 2:透過網路啟動 eLxr 映像檔,並將其燒錄到 eMMC 。 -剩餘的轉換步驟使用標準的 TFTP 網路啟動 + 燒錄程序,該程序已記錄在 [Net Boot Recovery](/hardware/getting-started/firmware-update/net-boot) 中。請按照該程序,並使用以下針對 eLxr 進行設定的特定值: +剩餘的轉換步驟使用標準的 TFTP 網路啟動 + 燒錄程序,該程序已記錄在 [網路開機復原](/hardware/getting-started/firmware-update/net-boot) 中。請按照該程序,並使用以下針對 eLxr 進行設定的特定值: - **步驟 2(啟動 TFTP 伺服器):** 使用 `--boardtype modalix --fwtype elxr -v %platform_version%`。 -- **步驟 3(設定 U-Boot):** 在執行 `boot` 之前,除了設定 `boot_targets=net` 之外,還需要設定 `cpio_name=simaai-image-palette-modalix.cpio.gz`。 -- **步驟 4(快閃):** 在 `netboot>` 提示字元處輸入 `f`。 +- **步驟 3(設定 U-Boot):** 如果無法遠端設定,請依照復原指南,透過序列主控台載入開機指令碼。 +- **步驟 4(燒錄):** 手動燒錄時,請在 `netboot>` 提示輸入 `f`,並在燒錄完成後接受重新啟動提示。 ![連線圖](/img/tech-notes/conversion-diagram.png) *連線圖* -在完成刷機且您重新啟動 DevKit 後,它會從 eMMC 執行 **eLxr**。 +DevKit 重新啟動後,會從 eMMC 執行 **eLxr**。
@@ -87,7 +89,7 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi
切換回 Yocto(可選) -若要切換回 Yocto,請再次執行 [網路啟動恢復](/hardware/getting-started/firmware-update/net-boot),並使用 `--fwtype yocto`。對於 Yocto 目標,不需要 `cpio_name` U-Boot 變數,只需要 `setenv boot_targets net`、`saveenv` 和 `boot`。 +若要切換回 Yocto,請指定 `--fwtype yocto` 和目標 Yocto 韌體版本,再依照[網路開機復原](/hardware/getting-started/firmware-update/net-boot)的步驟操作。 :::note 在轉換回 Yocto 時,**沒有最低 tRoot 版本要求**,因此可以跳過上述步驟 1。 @@ -100,5 +102,5 @@ sima-user@sima-user-machine:~$ sima-cli update --ip 192.168.1.20 %platform_versi ## 摘要 1. 更新至最新的 **tRoot** 映像檔(≥ 2.0.0)。 -2. 請按照以下步驟進行:[網路啟動恢復](/hardware/getting-started/firmware-update/net-boot),使用 `--fwtype elxr` 和 eLxr `cpio_name`,將 eLxr 刷入 eMMC。 +2. 使用 `--fwtype elxr` 並依照[網路開機復原](/hardware/getting-started/firmware-update/net-boot)的步驟,將 eLxr 燒錄到 eMMC。 3. 安裝 Palette SDK,並透過 [Palette SDK 文件](https://developer.sima.ai/software) 試用應用程式。