펌웨어 업데이트(rbln-flash)¶

업데이트 선택¶

• 업데이트 모드(Update mode): CP(--cp) 또는 MCU(SMC)(--mcu).
• 이미지 소스(Image source): 단일 펌웨어 이미지 파일(-f) 또는 펌웨어 디렉터리(-d).
• 대상(Targets): PCI BDF(bus/device/function)로 지정한 단일 장치(예: -s 01:00.0) 또는 모든 장치(-s all).

플래그 구문과 제약 사항(예: "--cp와 --mcu 중 하나만 지정")은 명령어 참조에서 확인할 수 있습니다.

rbln-flash 실행 전¶

$ sudo systemctl stop rbln-smd.service
$ sudo modprobe -r rebellions

업데이트 후¶

새 펌웨어는 다음과 같이 적용됩니다:

• Rebel100™: rbln-flash가 업데이트한 장치를 각각 리셋하고, 정상 부팅을 확인한 뒤 SUCCESS를 보고합니다. MCU 업데이트에서는 장치가 새 SMC 펌웨어 버전으로 동작하는지도 확인합니다.
• ATOM™: rebellions 드라이버를 다시 로드하면 새 펌웨어가 적용됩니다.

드라이버를 로드하고 rbln-smd를 다시 시작한 뒤 CP 펌웨어 버전을 확인합니다:

$ sudo modprobe rebellions
$ sudo systemctl start rbln-smd.service
$ rbln-smi -q -qd npu,name,device,fw_ver

모든 장치의 fw_ver 열에 새 버전이 표시되는지 확인합니다. rbln-smi는 CP 펌웨어 버전을 보여 주며, SMC 펌웨어 버전은 보여 주지 않습니다.

기본 사용법¶

$ sudo rbln-flash --cp -f <FILE_PATH> -s <PCI_ADDR | all>
$ sudo rbln-flash --cp -d <DIR_PATH> -s <PCI_ADDR | all>

$ sudo rbln-flash --mcu -f <FILE_PATH> -s <PCI_ADDR | all>
$ sudo rbln-flash --mcu -d <DIR_PATH> -s <PCI_ADDR | all>

옵션¶

디렉터리 모드 바이너리 요구 사항¶

-d를 사용하면 디렉터리에 다음 이름 그대로의 펌웨어 파일이 있어야 합니다:

감지한 장치 플랫폼, 카드, 업데이트 모드(--cp 또는 --mcu)에 따라 파일을 선택합니다. 첫 번째로 감지한 장치를 기준으로 파일 하나를 고르고, 이 파일을 모든 대상 장치에 씁니다. RBLN-CA25와 다른 ATOM™ 카드가 함께 있는 호스트에서는 -s <PCI_ADDR>로 카드를 하나씩 지정해 업데이트해야 합니다.

반환 코드¶

다음 종료 코드를 반환합니다:

자주 발생하는 오류 종료 코드:

스크립트 작성 예제는 CLI 예제 → 종료 코드 처리에서 확인할 수 있습니다.

파일명 규칙¶

fwlog_<DOMAIN>:<BUS>:<SLOT>.<FUNC>.txt

예: fwlog_0000:01:00.0.txt, fwlog_0000:02:00.0.txt.

동작¶

• 결과가 FAILED 또는 TIMEOUT인 장치의 로그만 저장합니다.
• 현재 작업 디렉터리에 저장합니다.
• 같은 이름의 파일이 이미 있으면 덮어씁니다.

펌웨어 업데이트 워크플로우¶

$ sudo rbln-flash --cp -f /PATH/image.bin -s 01:00.0

==== Firmware Update Results ====
0000:01:00.0 : SUCCESS [O]
=================================

$ sudo rbln-flash --cp -d /PATH/ -s all

==== Firmware Update Results ====
0000:01:00.0 : SUCCESS [O]
0000:02:00.0 : FAILED [X]
0000:03:00.0 : TIMEOUT [...]
=================================
2 device(s) failed to update.
Firmware logs have been saved to fwlog_<BDF>.txt for each failed device.
Please check the firmware logs, reset the device, and retry the update.

$ sudo rbln-flash --mcu -f /PATH/image.bin -s 01:00.0

==== Firmware Update Results ====
0000:01:00.0 : SUCCESS [O]
=================================

$ sudo rbln-flash --mcu -d /PATH/ -s all

==== Firmware Update Results ====
0000:01:00.0 : SUCCESS [O]
0000:02:00.0 : FAILED [X]
0000:03:00.0 : TIMEOUT [...]
=================================
2 device(s) failed to update.
Firmware logs have been saved to fwlog_<BDF>.txt for each failed device.
Please check the firmware logs, reset the device, and retry the update.

$ sudo rbln-flash --cp -d /PATH/ -s all -l update.log

==== Firmware Update Results ====
0000:01:00.0 : SUCCESS [O]
0000:02:00.0 : FAILED [X]
0000:03:00.0 : TIMEOUT [...]
=================================
2 device(s) failed to update.
Firmware logs have been saved to fwlog_<BDF>.txt for each failed device.
Please check the firmware logs, reset the device, and retry the update.

종료 코드 처리¶

스크립트나 CI에서 rbln-flash 종료 코드를 확인하는 예제입니다:

sudo rbln-flash --cp -d /PATH -s all
ret=$?

if [ $ret -eq 0 ]; then
  echo "All devices updated successfully!"
elif [ $ret -le 128 ]; then
  echo "$ret device(s) failed to update."
else
  echo "Error occurred: errno $((256 - ret))"
fi

드라이버를 언로드할 수 없음¶

• 데몬 중지: sudo systemctl stop rbln-smd.service
• 드라이버 언로드: sudo modprobe -r rebellions
• 모듈이 계속 사용 중이면 무엇이 사용하고 있는지 확인합니다. lsmod | grep rebellions의 Used by 열에 사용 카운트가 표시되고, sudo lsof /dev/rbln*는 장치를 열고 있는 프로세스를 보여 줍니다. 해당 프로세스를 중지한 뒤 드라이버를 다시 언로드합니다.
• 이전 업데이트 후 드라이버가 자동으로 다시 로드되었다면 다음 실행 전에 언로드합니다(업데이트 후 참조).

디렉터리 모드 실패¶

• 펌웨어 디렉터리에 명령어 참조 → 디렉터리 모드 바이너리 요구 사항에 나열된 필수 파일명이 있는지 확인합니다.
• 의도한 업데이트 모드(--cp 또는 --mcu)를 선택했는지 확인합니다.

일부 장치 업데이트 실패¶

• 반환 코드를 확인합니다(명령어 참조 → 반환 코드 참조).
• --logfile을 지정해 다시 실행하고 로그에서 장치별 오류를 확인합니다.
• 현재 디렉터리에 자동으로 생성된 fwlog_<BDF>.txt 파일에서 장치 측 진단 로그를 확인합니다(실패 시 펌웨어 로그 참조).
• 로그를 확인한 후 실패한 장치를 리셋하고 업데이트를 다시 시도합니다.