본문으로 건너뛰기

네트워크 부팅 복구

이동식 미디어가 아닌 네트워크를 통해 DevKit을 부팅해야 할 때 네트워크 부팅 복구 기능을 사용하세요. 다음의 경우에 유용합니다.

  • DevKit을 이전 릴리스의 SDK로 다운그레이드해야 합니다.
  • 최신 릴리스가 아닌 빌드를 설치해야 합니다(예: 사전 릴리스 develop 빌드 또는 내부 엔지니어링 이미지).
  • 손상된 부트로더 또는 파일 시스템이 있는 보드를 복구해야 하는데, SD 카드가 없습니다.
  • 새 보드를 브링업하려 하시는데, 내부 저장 장치의 마모를 줄이고 싶으신 것 같습니다.
  • 현재 Modalix DevKit을 Yocto Linux에서 eLxr로, 또는 eLxr에서 다시 Yocto Linux로 변환하고 있습니다. 변환에 필요한 구체적인 요구 사항은 eLxr로 변환을 참조하십시오.
노트

이 가이드는 SiMa.ai가 제공하는 이미지를 사용하며, 보드에서 U-Boot 프롬프트가 동작해야 합니다. 직접 빌드한 이미지를 설치하는 방법은 이 가이드에서 다루지 않습니다. 그 경우에는 eMMC에 이미지 플래싱을 참조하십시오.

sima-cli bootimg와 함께 --netboot 옵션을 사용하세요. 그러면 대상 보드의 부트 이미지를 다운로드하여 호스트의 내장 TFTP 서버에서 제공합니다. 펌웨어 버전 2.1.3 이상을 실행 중인 접근 가능한 DevKit 또는 PCIe 카드의 경우, --devkit <ip>를 추가하여 호스트가 U-Boot 환경을 구성하고 네트워크 부팅을 시작할 수 있도록 합니다. 이렇게 하면 3단계를 건너뛸 수 있습니다. 이전 펌웨어를 사용하거나 접근할 수 없는 장치의 경우, 3단계에서 직렬 콘솔을 통해 U-Boot를 구성합니다.

1단계: 물리적 설정
노트

이 절차는 macOS 및 Ubuntu Linux 호스트를 지원합니다.

호스트 시스템에 sima-cli가 설치되어 있지 않으면, 다음 단계를 진행하기 전에 설치하십시오.

호스트 셸 세션을 사용하여 TFTP 서버를 시작하고 eMMC 플래시를 시작합니다. --devkit 및 --autoflash를 사용하는 경우에도 netboot 진행 상황을 모니터링하기 위해 별도의 직렬 콘솔 연결을 사용하는 것이 좋습니다. 3단계에서 수동으로 U-Boot를 구성하려면 직렬 콘솔이 필요합니다.

  1. DevKit의 이더넷 포트를 호스트 장치에 직접 연결하고, 호스트의 네트워크 인터페이스를 정적 IP 주소 192.168.1.10으로 설정합니다. Modalix 얼리 액세스 DevKit에서는 이더넷 포트 0을 사용합니다.

  2. 권장되는 직렬 연결을 위해 DevKit의 UART 포트를 호스트에 연결하여 콘솔에 액세스합니다. 호스트에 sima-cli를 설치한 후 직렬 터미널을 엽니다.

    sima-user@sima-user-machine:~$ sima-cli serial

  3. DevKit에서 네트워크 인터페이스를 기본 정적 IP 주소인 192.168.1.20으로 구성합니다. 구성 방법은 독립 실행형 모드 네트워크 설정을 따르십시오.

2단계. 호스트에서 TFTP 네트워크 부팅 서버를 시작합니다.

요구 사항

  • 호스트와 DevKit은 동일한 물리적 네트워크 또는 직접 이더넷 연결을 통해 연결되어야 합니다.
  • 이더넷 연결은 기가비트 인터페이스 이상이어야 합니다(전송 속도는 1000Mbps를 초과해야 함).
  • 호스트는 펌웨어 이미지를 다운로드하기 위해 인터넷에 접속해야 합니다.
  • UDP 포트 **69(TFTP)**는 호스트 방화벽에 의해 차단되어서는 안 됩니다.

<version>을 대상 SDK 버전(예: 2.1.3)으로, <boardtype>을 modalix 또는 mlsoc로, <fwtype>을 yocto 또는 elxr로 바꿉니다.

macOS에서:

sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype <boardtype> --fwtype <fwtype> -v <version> --netboot

Linux에서:

경고

TFTP 서버는 권한이 필요한 포트 69에 연결되므로 sudo 명령어를 사용해야 합니다.

sima-user@sima-user-machine:~$ sudo ~/.sima-cli/.venv/bin/sima-cli bootimg --boardtype <boardtype> --fwtype <fwtype> -v <version> --netboot

호스트에서 Netboot를 구성합니다(펌웨어 2.1.3 이상).​

DevKit 또는 PCIe 카드가 현재 펌웨어 2.1.3 이상을 실행 중이고 호스트에서 접근 가능한 경우, 위의 명령에 --devkit <ip>를 추가합니다. <ip>를 장치의 현재 IP 주소로 바꿉니다. 호스트는 U-Boot 환경을 구성하고 네트워크 부팅을 시작하므로 3단계를 건너뛰고 4단계로 진행할 수 있습니다.

장치가 네트워크 부팅을 완료한 후 자동으로 플래싱하려면 --autoflash를 추가합니다.

sima-user@sima-user-machine:~$ sima-cli bootimg --boardtype <boardtype> --fwtype <fwtype> -v <version> --netboot --devkit <ip> --autoflash

Linux에서는 위에서 설명한 것과 동일한 sudo ~/.sima-cli/.venv/bin/sima-cli 접두사를 사용합니다. --autoflash를 사용하면 4단계에서 수동 f 명령을 입력할 필요가 없습니다. 가능하다면 직렬 콘솔을 연결하여 진행 상황을 모니터링하고, CLI에서 재부팅하라는 메시지가 나타날 때까지 기다립니다.

이 명령어는:

  1. 요청한 SDK 버전과 보드 유형에 맞는 부팅 가능한 이미지를 다운로드합니다.
  2. 파일을 임시 작업 디렉터리에 추출합니다.
  3. 로컬 TFTP 서버를 시작하고 추출된 부트 파일을 제공합니다(Image, boot.scr, .dtb 파일 등).
3단계: DevKit을 네트워크 부팅으로 구성

2단계에서 호스트가 --devkit를 사용하여 네트워크 부팅을 구성한 경우 이 단계를 건너뛰십시오. 그렇지 않은 경우 아래의 직렬 콘솔 절차를 따르십시오.

DevKit을 시리얼 콘솔을 통해 호스트에 연결한 상태에서 전원을 껐다가 다시 켜십시오. 전원 재부팅 중에 시리얼 콘솔 연결이 끊어지면 다시 연결하십시오. Hit any key to stop autoboot 메시지가 나타날 때까지 기다린 다음 아무 키나 눌러 U-Boot 셸로 들어갑니다.

... ... ...

Address in DT is		ff:ff:ff:ff:ff:ff
Address in environment is	68:e1:54:00:05:c6
eth0: ethernet@a800000 [PRIME]
Hit any key to stop autoboot:  0
sima$

다음으로 U-Boot 셸에서 다음 명령을 실행합니다.

sima:~$ setenv boot_targets net; saveenv; boot

Modalix eLxr 대상의 경우, 부팅하기 전에 cpio 이미지 이름을 설정하십시오.

sima:~$ setenv cpio_name simaai-image-palette-modalix.cpio.gz; setenv boot_targets net; saveenv; boot

이 명령은 DevKit에 2단계에서 준비된 호스트 TFTP 서버에서 부팅하도록 지시합니다.

노트

기본적으로 DevKit U-Boot는 다음과 같이 구성됩니다.

  • ipaddr=192.168.1.20(DevKit의 이더넷 인터페이스, 멀티포트 보드의 첫 번째 포트).
  • serverip=192.168.1.10 (TFTP 서버를 실행하는 호스트 머신).

다른 네트워크를 사용하려면 U-Boot에서 serverip 및 ipaddr를 업데이트하여 현재 환경에 맞게 설정하십시오. 선택한 IP 주소에서 DevKit이 호스트에 연결할 수 있는지 확인하십시오.

sima:~$ setenv serverip 10.0.0.10; setenv ipaddr 10.0.0.1; saveenv; boot
4단계: eMMC를 플래싱합니다.

2단계에서 --autoflash를 활성화한 경우, 네트워크 부팅된 장치가 준비되면 플래싱이 자동으로 시작됩니다. 진행 상황을 모니터링하고 안내에 따라 재부팅하십시오. 그렇지 않은 경우 아래의 수동 명령을 사용하십시오.

호스트의 --netboot 셸은 두 가지 명령을 지원합니다.

  • c — 연결된 모든 클라이언트와 현재 해당 클라이언트에서 실행 중인 펌웨어 버전을 표시합니다.
  • f — 선택한 클라이언트의 eMMC를 플래싱합니다.

DevKit이 네트워크 부팅을 완료할 때까지 기다립니다. 이 과정은 몇 분 정도 걸릴 수 있습니다. 시리얼 콘솔에 로그인 프롬프트가 표시되면 보드가 준비된 것입니다. 전체 부팅 과정을 관찰하기 위해 시리얼 콘솔을 계속 연결해 두는 것이 좋습니다.

호스트 터미널로 돌아가서 netboot> 프롬프트가 나타날 때까지 Enter 키를 누릅니다. 선택적으로 c를 입력하여 DevKit이 연결되었는지 확인하고 현재 펌웨어 버전을 표시한 다음, f를 입력하여 펌웨어를 업데이트합니다.

netboot> f

다음과 유사한 로그를 확인할 수 있습니다.

🔍 Checking SSH availability for 192.168.1.20...
✅ Board is online!
✅ SSH is available on 192.168.1.20
netboot> f
🔧 Initiating eMMC flash [...]

이미지 파일의 크기는 대략 1.6GB이며, 전송하는 데 몇 분 정도 걸립니다. 예시 진행 상황은 다음과 같습니다.

↦ 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에서 대상 버전이 부팅됩니다.

문제 해결

  • DevKit이 네트워크 부팅에 실패하면 호스트와 장치가 동일한 서브넷(192.168.1.x)에 있는지 확인하십시오.

  • Modalix 얼리 액세스 보드에서는 네트워크 부팅을 위해 이더넷 포트 0만 지원됩니다.

  • Linux 환경에서 호스트 방화벽이 **UDP 포트 69(TFTP)**를 허용하도록 설정되었는지 확인하십시오.

  • DevKit과의 연결 상태를 확인하십시오.

    modalix:~$ ping 192.168.1.10

  • 네트부팅 중에 DevKit의 IP 주소가 변경되는 경우(예: DHCP가 새 주소를 할당하는 경우), sima-cli는 이를 알림받지 못하고 이전 주소를 계속 사용할 수 있습니다. 직렬 콘솔을 통해 DevKit에 연결하고 ip addr 명령을 실행하여 현재 IP 주소를 확인합니다. 그런 다음 호스트의 네트부팅 셸에서 해당 주소를 사용하여 f 명령을 실행하여 장치를 플래싱합니다.

    netboot> f <actual-ip>

  • f에서 이미지를 찾지 못하면 2단계의 sima-cli bootimg --netboot 명령을 다시 실행하여 TFTP 경로를 새로 고칩니다.

  • Modalix DevKit을 eLxr로 변환한 후 시리얼 콘솔에 NFS 관련 오류 메시지가 표시되면 안전하게 무시해도 됩니다.