콘텐츠로 이동

펌웨어 업데이트

카드의 부트 플래시에 있는 펌웨어를 호스트에서 ha-fw-update로 갱신하는 방법을 다룹니다. 업데이트가 어떻게 동작하는지, 시작하기 전에 확인할 것, 업데이트 절차, 업데이트 중의 제약, 새 펌웨어로 부팅되었는지 확인하는 방법, 실패했을 때의 대응을 차례로 설명합니다. 옵션, 종료 코드, JSON 출력의 정의는 ha-fw-update에 있습니다.

업데이트 중에는 호스트 전원을 끄거나 재부팅하지 마십시오

이렇게 부팅하지 못하게 된 카드는 호스트 소프트웨어로 복구할 수 없습니다. 도구가 비정상 종료되거나 터미널 연결이 끊겨도 펌웨어는 쓰기를 끝까지 진행하므로, 그 경우에도 호스트를 그대로 두고 기다리십시오.


언제 업데이트하는가

  • HyperAccel이 새 펌웨어 이미지를 배포하고 업데이트를 안내할 때
  • 지원 환경이 설치한 드라이버와 함께 쓰도록 정한 펌웨어보다 카드의 펌웨어가 오래되었을 때

현재 펌웨어 버전은 카드마다 sysfs fw_version이나 hyperaccel-smi -q의 Firmware Version으로 확인합니다. 값은 major.minor.patch 형식이고, 펌웨어가 아직 준비되지 않았으면 unknown입니다.

1
2
cat /sys/class/ha/ha0/fw_version
hyperaccel-smi -q -i 0

새 펌웨어가 설치된 드라이버와 맞는지 먼저 확인하십시오

드라이버와 호환되지 않는 펌웨어로 부팅하면 드라이버가 카드를 인식하지 않을 수 있습니다. 그러면 업데이트 뒤 카드가 돌아오지 않고, 이 도구로 다시 업데이트할 수도 없습니다. 업데이트하기 전에 지원 환경에서 펌웨어와 드라이버의 조합을 확인하십시오.


시작하기 전에

항목 요구 사항
권한 root(sudo)로 실행합니다
도구 ha-fw-update와 ha-hotreset은 /usr/bin/에 설치됩니다. Python 3.7 이상이 필요하고(python3 --version으로 확인합니다. 낮으면 요구 사항을 보십시오), ha-hotreset은 pciutils(lspci, setpci)를 씁니다
이미지 HyperAccel이 배포한 펌웨어 이미지(image.gpt) 또는 크기가 정확히 16 MiB인 전체 플래시 이미지. 자세한 조건은 이미지 파일에 있습니다
펌웨어 카드에서 실행 중인 펌웨어가 호스트에서의 업데이트를 지원해야 합니다(지원 환경). 지원하지 않으면 도구가 종료 코드 2로 끝나고 플래시는 바뀌지 않습니다
카드 상태 펌웨어가 준비된 상태(fw_version이 unknown이 아님)이고, 그 카드의 /dev/haN을 연 프로세스가 없어야 합니다
핫 리셋 업데이트 뒤 새 펌웨어로 부팅하려면 ha-hotreset이 그 카드를 리셋할 수 있어야 합니다. sudo ha-hotreset --list에서 NOT resettable로 표시되는 카드는 --no-reset으로 업데이트한 뒤 호스트 전원을 껐다 켭니다
보드 ha-fw-update --help의 안전 항목(SAFETY)대로, root-of-trust가 bypass 모드인 보드에서만 씁니다. 소프트웨어로 확인할 수 없으므로 확실하지 않으면 HyperAccel에 문의하십시오

업데이트 절차

1. 카드를 고릅니다

카드는 도메인을 포함한 PCI BDF 주소로 지정하는 것을 권장합니다. /dev/haN의 번호는 핫 리셋이나 카드 추가 뒤에 바뀔 수 있지만, PCI 주소는 슬롯에 고정됩니다. hyperaccel-smi가 출력하는 Bus-Id 열의 값을 그대로 -d에 넘기십시오.

1
hyperaccel-smi # Bus-Id 열, 예: 0000:01:00.0

Bus-Id는 도메인:버스:디바이스.기능 형식입니다. 그 버스:디바이스.기능을 가진 카드가 모든 PCI 도메인을 통틀어 하나뿐이라면 -d 01:00.0처럼 도메인을 생략해도 됩니다. 같은 버스:디바이스.기능을 가진 카드가 여러 도메인에 있으면 도구가 후보를 보여 주고 거부하므로, 그때는 전체 주소를 쓰십시오. -i N으로 /dev/haN의 번호를 줄 수도 있습니다.

2. 카드에서 동작 중인 워크로드를 멈춥니다

업데이트는 그 카드의 /dev/haN을 연 프로세스가 없을 때만 진행됩니다. 다른 프로세스가 열고 있으면 도구가 그 PID를 알려 주고 종료 코드 2로 끝납니다. 다른 카드만 쓰는 워크로드와, hyperaccel-smi처럼 sysfs만 읽는 모니터링은 멈추지 않아도 됩니다.

3. 사전 점검을 합니다

--dry-run은 쓰기 직전까지의 점검만 하고 아무것도 쓰지 않습니다.

1
sudo ha-fw-update -d 0000:01:00.0 --dry-run image.gpt

사전 점검은 root 권한, 이미지 형식, 카드, 같은 카드에서 실행 중인 다른 업데이트, fw_version, 카드를 연 다른 프로세스, 리셋 명령을 확인합니다. 마지막으로 카드를 열고 이미지를 올릴 카드 메모리를 확보해, 카드가 요청을 받을 수 있는지 확인합니다. 통과하면 요약을 출력하고 Dry run: nothing written.으로 끝나며, 종료 코드는 0입니다. 점검 항목별 종료 코드는 사전 점검에 있습니다.

요약의 Reset 줄에 parent is NOT a root port가 나오고 WARNING: <BDF> is not directly under a root port; ... 경고가 나오면, 업데이트 뒤의 핫 리셋은 경로를 마스킹해 진행되거나, 마스킹할 수 없으면 거부됩니다(경로 마스킹). sudo ha-hotreset --list로 그 카드를 리셋할 수 있는지 확인하십시오. --list는 부모 포트의 조건만 판정합니다. 같은 부모 브리지 아래에 다른 디바이스가 있으면 --list가 리셋 가능으로 표시해도 ha-hotreset은 리셋을 거부합니다.

4. 범위를 고릅니다

상황 --scope
잘 모르겠음 full(기본값)
16 MiB 전체 플래시 이미지 full(이 이미지는 full만 받습니다)
이미지에서 fip 파티션(펌웨어 애플리케이션)만 바뀐 것을 알고 있음 app

full은 이미지 전체를, app은 이미지의 fip 파티션만 씁니다. 어느 쪽이든 플래시와 내용이 다른 부분만 실제로 쓰므로 시간 차이는 크지 않습니다.

  • app은 fip 파티션 밖의 내용을 쓰지 않습니다. 이미지의 다른 부분이 바뀌었다면 그 변경은 반영되지 않습니다.
  • 플래시에 있는 fip 파티션의 위치가 이미지와 다르면 펌웨어가 app 요청을 거부하고(종료 코드 3), 도구가 --scope full로 다시 실행하라고 안내합니다. 플래시는 바뀌지 않습니다.

--rewrite는 플래시와 같은 섹터도 건너뛰지 않고 범위 전체를 지우고 다시 씁니다. 보통은 필요하지 않습니다.

5. 업데이트를 실행합니다

1
sudo ha-fw-update -d 0000:01:00.0 image.gpt

도구는 사전 점검을 마치고 요약을 출력한 뒤 Proceed? [y/N]으로 확인을 받습니다. y를 입력하면 시작합니다. 스크립트에서는 -y로 프롬프트를 생략합니다.

출력 예:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
Device   : ha0  (0000:01:00.0)  firmware 1.0.5
Image    : image.gpt  2,752,512 B  gpt image  crc32 0x07ba4d6e
Scope    : full -> flash 0x000000-0x29ffff
Estimate : typically under a minute  (device timeout 246 s)
Reset    : SBR via ha-hotreset (parent is a root port)
WARNING: Do not power off or reboot this host during the update. Recovery requires a debug tool (e.g., Trace32).
Proceed? [y/N] y
[1/5] Pre-flight ....... ok
[2/5] Upload ........... ok   2.6 MiB in 0.4 s
[3/5] Flash (device) ... ok   4.1 s   672/672 sectors   (Ctrl+C was ignored from here)
[4/5] Reset (SBR) ...... ok
[5/5] Verify ........... ok   firmware 1.0.5 -> 1.0.6   (ha0)

[2/5]에서 이미지를 카드 메모리에 올리고, [3/5]에서 펌웨어가 검사, 비교, 쓰기, 되읽기 확인을 끝낼 때까지 기다립니다. [3/5]가 ok이면 플래시는 이미 새 이미지입니다. 이어서 [4/5]에서 카드를 핫 리셋하고 [5/5]에서 새 펌웨어로 부팅되었는지 확인합니다. 각 줄의 정의는 화면 출력에 있습니다.

요약의 device timeout은 드라이버가 펌웨어의 응답을 기다리는 상한이지 예상 소요 시간이 아닙니다.

원격 세션에서는 tmux나 screen 안에서 실행하십시오

연결이 끊기면 도구가 끝까지 실행되지 못할 수 있습니다. 펌웨어의 쓰기는 영향을 받지 않습니다. 다시 접속한 뒤 같은 명령을 다시 실행하면 이미 쓴 부분은 건너뛰고 리셋과 확인까지 마칩니다. 앞선 실행이 아직 끝나지 않았으면 another ha-fw-update is running for <BDF>, 드라이버가 앞선 업데이트의 응답을 기다리는 중이면 upload failed: Device or resource busy를 내고 종료 코드 2로 끝나므로, 잠시 뒤 다시 실행하십시오. 뒤의 경우는 응답을 받지 못했을 때를 보십시오.

6. 진행 상황을 봅니다

[3/5] 동안 터미널에서는 같은 줄이 계속 갱신되며 진행률을 보여 줍니다.

1
[3/5] Flash (device) ...  43%  (289/672 sectors)  2 s
  • 진행률은 sysfs fw_update_progress에서 읽습니다. 값은 <끝난 섹터> <전체 섹터>(4 KiB 단위)이고, 플래시와 같아서 건너뛴 섹터도 끝난 것으로 셉니다. 그래서 거의 같은 이미지는 곧바로 100%가 됩니다.
  • 펌웨어가 이미지를 검사하는 동안에는 값이 0 0이며, 그동안 도구는 진행률 대신 경과 시간을 보여 줍니다.
  • 진행률을 읽을 수 없으면(값이 unknown이거나 계속 0 0이면) 도구는 경과 시간만 보여 주고, [3/5]가 끝날 때 섹터 수 대신 no progress counter (old firmware)를 표시합니다.
  • 출력을 파일이나 파이프로 보내면 줄을 갱신하지 않고 단계 이름만 한 번 출력합니다.

다른 터미널에서 같은 값을 직접 볼 수도 있습니다. 업데이트가 끝난 뒤에도 값은 다음 업데이트나 카드가 다시 시작될 때까지 남습니다.

1
cat /sys/class/ha/ha0/fw_update_progress

[3/5]부터 리셋이 끝날 때까지 Ctrl+C, SIGTERM, SIGHUP은 보류됩니다. 이 구간에 Ctrl+C를 누르면 도구는 쓰기와 리셋을 마친 뒤 확인 단계를 건너뛰고 종료 코드 6으로 끝납니다. 이때 플래시는 새 이미지이고 카드는 리셋되었으므로 새 펌웨어로 부팅되었는지 확인으로 넘어가십시오. 보류된 SIGTERM이나 SIGHUP은 리셋에 성공한 직후 도구를 종료시키며, 이때는 확인 단계의 출력과 --json 결과가 나오지 않습니다. 이 경우에도 플래시는 새 이미지이고 카드는 리셋되었습니다. --no-reset이면 보류된 시그널은 처리되지 않고 도구가 그대로 끝납니다.

7. 새 펌웨어로 부팅합니다

[4/5]에서는 /dev/haN을 닫고 ha-hotreset --bdf <BDF>로 카드를 리셋합니다. 리셋 후 카드는 플래시의 새 이미지로 부팅하고, 드라이버가 카드를 다시 인식합니다.

[5/5]에서는 같은 PCI 주소의 카드가 fw_version을 보고할 때까지 최대 --boot-timeout(기본 60초) 동안 기다립니다. 리셋 뒤 /dev/haN의 번호가 바뀔 수 있습니다.

리셋을 나중에 하기

--no-reset을 주면 플래시만 갱신하고 리셋하지 않습니다. 카드는 다시 시작될 때까지(핫 리셋, 호스트 재부팅, 전원 재인가) 이전 펌웨어로 계속 동작하고, 그동안 fw_version은 이전 버전을 보여 줍니다. 다음 경우에 씁니다.

  • 호스트가 정해진 시간에 정기적으로 리셋하는 정책으로 동작하는 경우
  • ha-hotreset이 그 카드를 리셋할 수 없어서(NOT resettable) 업데이트가 끝난 뒤 호스트 전원을 껐다 켜야 하는 경우
  • 다른 프로세스가 카드를 열고 있어 --force로 진행해야 하는 경우 (이 경우 --force는 --no-reset과 함께 써야 함)
1
2
3
sudo ha-fw-update -d 0000:01:00.0 --no-reset image.gpt
# 그 카드의 /dev/haN을 연 프로세스를 모두 끝낸 뒤
sudo ha-hotreset --bdf 0000:01:00.0

애플리케이션의 리셋은 새 펌웨어를 적재하는 방법이 아닙니다

SDK의 디바이스 리셋은 먼저 실행 중인 펌웨어를 다시 초기화합니다. 플래시의 새 이미지로 부팅시키려면 ha-hotreset이나 호스트 전원 재인가를 쓰십시오.

여러 카드와 자동화

업데이트는 카드마다 한 번씩 실행합니다. 다음 예는 하나라도 실패하면 멈춥니다.

1
2
3
for b in 0000:01:00.0 0000:41:00.0; do
    sudo ha-fw-update -d "$b" -y image.gpt || break
done

스크립트에서 결과를 처리하려면 --json을 씁니다. --json은 -y나 --dry-run과 함께 써야 하며, 화면 출력 대신 결과 JSON 하나만 표준 출력에 냅니다. 종료 코드와 result 필드를 보십시오. 필드는 JSON 출력에 있습니다.

1
sudo ha-fw-update -d 0000:01:00.0 -y --json image.gpt > result.json

카드마다 결과 JSON을 남기고, 멈춘 카드에서 할 일과 이어서 실행할 명령을 알려 주는 예제 스크립트는 여러 카드의 펌웨어를 차례로 업데이트하기에 있습니다.


업데이트 중 제약

업데이트가 진행되는 동안 그 카드에는 다음과 같은 제약이 적용됩니다. 다른 카드는 영향을 받지 않습니다.

  • 업데이트 중인 디바이스에 애플리케이션이 SDK로 작업을 제출하거나 리셋을 요청하는 등, 디바이스에 명령을 보내는 요청은 기다리지 않고 바로 거부됩니다.
  • 드라이버의 자동 리셋(ha_auto_reset)과 워치독 선점(ha_wd_preempt)이 해당 디바이스에 대해 동작하지 않습니다. 커널 로그에 auto-TDR: skipped, a fw_update is in flight or unanswered (flash may be mid-write)가 남을 수 있습니다.
  • 업데이트 도구가 /dev/haN을 열고 있으므로 ha-hotreset은 그 카드의 리셋을 거부합니다.
  • 같은 카드에 ha-fw-update를 하나 더 실행하면 종료 코드 2로 거부됩니다.
  • sysfs 읽기와 hyperaccel-smi는 그대로 동작합니다.

새 펌웨어로 부팅되었는지 확인

[5/5] Verify 줄이 ok이고 firmware <이전> -> <새>를 보여 주면 다음을 확인한 것입니다.

  • 리셋 뒤 같은 PCI 주소의 카드를 드라이버가 다시 인식했습니다.
  • 카드가 플래시의 이미지로 부팅했고, 펌웨어가 준비 완료를 알렸습니다.
  • 그 펌웨어가 보고한 버전이 [5/5] Verify ........... ok firmware 1.0.5 -> 1.0.6 (ha0) 로그의 화살표 오른쪽 값(예: 1.0.6)입니다.

플래시 내용이 이미지와 같은지는 [3/5]에서 펌웨어가 되읽어 이미 확인했습니다.

[5/5]는 버전 번호를 비교합니다. 업데이트 전과 버전 번호가 같은 이미지를 썼다면 WARNING: same version -- confirm the new image on the UART boot log. 경고와 함께 성공(종료 코드 0)으로 끝납니다. 버전 번호만으로는 새 이미지를 구분할 수 없습니다. 배포용 펌웨어는 UART에 버전을 출력하지 않으므로, 경고에 적힌 UART 부팅 로그로는 어떤 이미지가 실행 중인지 확인할 수 없습니다. 기록한 이미지 파일로 구분하십시오.

직접 확인하려면 PCI 주소, 노드, 펌웨어 버전을 함께 출력합니다.

1
2
3
4
for d in /sys/class/ha/ha*; do
    echo "$(basename "$(readlink -f "$d/device")") $(basename "$d") $(cat "$d/fw_version")"
done
hyperaccel-smi -q

fw_version이 unknown이면 카드가 아직 부팅 중이거나 펌웨어가 준비되지 않은 것입니다. 잠시 뒤 다시 읽으십시오.


실패했을 때

업데이트 도구가 실패하면 ERROR:로 시작하는 메시지를 출력하고(--json이면 결과 JSON의 error에 담습니다), 종료 코드로 플래시 상태를 알려 줍니다. 전체 정의는 종료 코드에 있습니다.

종료 코드 플래시 할 일
1, 2, 3 이 실행으로는 바뀌지 않음 메시지대로 원인을 고친 뒤 다시 실행합니다
4 일부만 기록되었을 수 있음 카드를 리셋하지 말고 같은 명령을 다시 실행합니다. 응답을 받지 못했을 때를 보십시오
5 새 이미지 리셋하지 못했을 때를 보십시오
6 새 이미지 카드가 돌아오지 않을 때를 보십시오

도구가 종료 코드를 알리지 못하고 끝났다면(터미널 연결이 끊긴 경우, 프로세스가 종료된 경우, Traceback으로 시작하는 Python 오류를 낸 경우) 그 실행이 플래시를 어디까지 썼는지 알 수 없습니다. 카드를 리셋하지 말고 같은 업데이트 명령을 다시 실행하십시오.

HyperAccel에 문의할 때는 도구의 출력(또는 --json 결과), sudo dmesg, hyperaccel-smi -q의 출력을 함께 보내십시오.

쓰기 전에 끝났을 때

종료 코드 1, 2, 3은 그 실행이 플래시에 아무것도 쓰지 않았다는 뜻입니다. 자주 보는 메시지는 다음과 같습니다.

메시지 할 일
/dev/haN is open by pid(s) ...; close them, or pass --force --no-reset 그 프로세스를 끝내고 다시 실행합니다
another ha-fw-update is running for <BDF>, another update is running on this device 같은 카드의 다른 업데이트가 끝나기를 기다립니다
device haN reports firmware 'unknown' (not ready), device not ready로 시작하는 메시지 카드가 부팅 중이거나 방금 리셋되었습니다. 잠시 뒤 다시 실행하고, 계속되면 dmesg를 확인합니다
device allocation failed: ...(예: State not recoverable) 카드가 명령을 받을 수 없는 상태입니다. sysfs health를 확인하고, FATAL과 복구의 안내대로 카드를 복구한 뒤 다시 실행합니다
upload failed: Device or resource busy 그 카드에서 업데이트가 진행 중이거나, 드라이버가 앞선 업데이트의 응답을 기다리고 있습니다. 응답을 받지 못했을 때를 따릅니다
this firmware has no update handler: flash it once with a debug tool (e.g., Trace32), firmware ABI predates FW_UPDATE (protocol < 7): flash it once with a debug tool (e.g., Trace32) 실행 중인 펌웨어가 호스트에서의 업데이트를 지원하지 않습니다. HyperAccel에 문의하십시오
fip partition layout differs from the one in flash -- retry with --scope full --scope full(기본값)로 다시 실행합니다
firmware rejected the image (GPT/CRC) -- flash untouched, not a GPT image ... 같은 이미지 검사 메시지 이미지 파일이 손상되었거나 다른 파일입니다. 배포받은 이미지를 다시 확인합니다
the firmware could not read the flash ... 다시 실행합니다
firmware aborted before writing (device busy/unhealthy) -- reset the card and retry 플래시를 지우기 전에 중단했습니다. sudo ha-hotreset --bdf <BDF>로 카드를 리셋한 뒤 다시 실행합니다
no reset script: ... ha-hotreset을 설치하거나, --hotreset으로 경로를 주거나, --no-reset으로 실행합니다

응답을 받지 못했을 때

종료 코드 4의 대표적인 경우는 다음 두 가지입니다.

  • FLASH WRITE FAILED -- flash may be partially written. Do NOT reboot; retry, then use a debug tool (e.g., Trace32): 펌웨어가 쓰기나 되읽기 확인에 실패했다고 응답했습니다.
  • firmware did not answer within the budget -- state unknown, ... 또는 device went FATAL or stopped answering during the update -- state unknown, ...: 호스트가 기한 안에 응답을 받지 못했습니다. 펌웨어가 쓰기를 멈췄다는 뜻은 아닙니다.

어느 경우든 카드를 다시 시작하지 않는 한 일부만 기록된 플래시로 부팅하는 일은 없습니다. 그래서 답은 리셋이 아니라 업데이트를 다시 실행하는 것입니다.

  1. 호스트 전원을 끄거나 재부팅하지 말고, 카드를 리셋하지 마십시오. ha-hotreset과 애플리케이션의 리셋도 포함됩니다.
  2. 같은 이미지로 같은 명령을 다시 실행합니다. 플래시와 내용이 다른 부분만 다시 쓰므로, 앞선 쓰기에서 이미 쓴 부분은 건너뜁니다. 호스트가 응답을 받지 못한 경우에는 아래와 같이 펌웨어가 응답한 뒤에 다시 실행합니다.

호스트가 응답을 받지 못하면 커널 로그에 다음이 남습니다.

1
ha 0000:01:00.0: fw_update: no answer from firmware (<오류 번호>); resets stay refused until it answers or the update is retried

그 앞에는 원인에 따라 응답 기한이 지났다는 fw_update: no response after <N> ms: ...와 fw_update timeout 태그가 붙은 hang 진단(hang 감지와 워치독), 또는 쓰는 도중 카드가 사라졌다는 fw_update: device vanished during the write (all-ones)가 남습니다.

이때부터 펌웨어가 응답할 때까지 드라이버는 그 카드에 업데이트 중 제약과 같은 제약을 유지합니다. 카드에 명령을 보내는 요청과 애플리케이션의 리셋 요청을 거부하고, 자동 리셋을 멈춥니다. 애플리케이션의 리셋 요청이 거부되면 다음이 남습니다.

1
ha 0000:01:00.0: reset refused: last fw_update unanswered (flash may still be written); retry ha-fw-update once the firmware answers, else contact HyperAccel support

ha-fw-update가 이미지를 카드 메모리에 올리는 것도 거부되는 요청에 해당합니다. 그래서 이 상태에서 다시 실행하면 [2/5]에서 upload failed: Device or resource busy를 내고 종료 코드 2로 끝나며, 이 실행은 플래시를 바꾸지 않습니다.

펌웨어가 늦게라도 응답하면 이 상태가 풀리고 다음이 남습니다.

1
ha 0000:01:00.0: fw_update: late completion from firmware; resets re-enabled

이 메시지는 새 펌웨어 이미지 업데이트의 성공을 의미하는 것이 아닙니다. 이 메시지를 확인한 뒤 같은 이미지로 업데이트를 다시 실행해 리셋과 확인까지 마치십시오.

응답을 받지 못한 상태에서도 ha-hotreset은 리셋을 진행합니다. 도구가 끝난 뒤에는 카드를 연 프로세스가 없기 때문입니다. 펌웨어가 응답하기 전에는 ha-hotreset을 실행하지 마십시오.

카드가 끝내 응답하지 않으면 남은 방법은 드라이버를 다시 적재해 리셋 거부 상태를 지우거나(rmmod), ha-hotreset으로 리셋하거나, 호스트 전원을 껐다 켜는 것입니다. 어느 쪽이든 쓰기가 끝나지 않은 플래시로 카드가 부팅할 위험이 있으므로, 그 전에 HyperAccel에 문의하십시오.

리셋하지 못했을 때

종료 코드 5는 플래시를 새 이미지로 갱신하고 펌웨어의 되읽기 확인까지 끝났지만, 리셋 단계에서 ha-hotreset이 실패했다는 뜻입니다. 오류 메시지에 ha-hotreset의 출력이 함께 나옵니다. 흔한 원인은 다음과 같습니다.

  • 카드의 부모 포트에서 SBR을 걸 수 없는 구성(NOT resettable)이거나, 경로 마스킹이 적용되지 않음
  • 다른 ha-hotreset 실행이 600초 안에 끝나지 않음
  • 같은 부모 브리지 아래에 다른 디바이스가 있음
  • 업데이트하는 동안 다른 프로세스가 그 카드를 열었음
  • pciutils가 설치되어 있지 않음

원인을 해결한 뒤 sudo ha-hotreset --bdf <BDF>를 다시 실행하거나, 호스트 전원을 껐다 켜십시오. 플래시 쓰기는 이미 끝났으므로 이 단계에서는 재부팅이나 전원 재인가가 안전합니다. 리셋 조건은 ha-hotreset에 있습니다.

카드가 돌아오지 않을 때

종료 코드 6은 리셋 뒤 --boot-timeout(기본 60초) 안에 같은 PCI 주소의 카드가 fw_version을 보고하지 않았거나, 확인 단계를 Ctrl+C로 건너뛰었다는 뜻입니다. 플래시는 새 이미지입니다.

  1. 잠시 기다린 뒤 새 펌웨어로 부팅되었는지 확인의 명령으로 다시 확인합니다. 부팅이 늦어진 카드는 커널 로그에 firmware booted after probe gave up; CSR-derived telemetry refreshed를 남기고 fw_version을 보고합니다.
  2. sudo dmesg에서 그 카드의 메시지를 확인합니다. - ABI protocol mismatch: firmware v..., driver requires >= v...; refusing probe: 설치된 드라이버가 새 펌웨어를 지원하지 않습니다. 지원 환경을 확인하십시오. - firmware never reported ready: 펌웨어가 부팅 중 준비 완료를 알리지 않았습니다.
  3. 카드가 부팅하지 못하면 HyperAccel에 문의하십시오.

안전 규칙

  • [3/5]가 끝날 때까지 호스트 전원을 끄거나 재부팅하지 마십시오. 도구가 비정상 종료되어도 펌웨어는 쓰기를 끝까지 진행합니다. 얼마나 기다릴지는 요약의 device timeout이 상한입니다.
  • 업데이트 중 ha-hotreset --force로 카드를 리셋하지 마십시오. --force는 열린 핸들이 있어도 카드를 리셋합니다.
  • PCI sysfs reset(/sys/bus/pci/devices/<BDF>/reset)으로 카드를 리셋하지 마십시오. 이 카드는 FLR을 지원하지 않습니다. 호스트에서의 리셋은 ha-hotreset만 쓰십시오.
  • 종료 코드 4의 답은 리셋이 아니라 재시도입니다. 카드를 다시 시작하지 않는 한 일부만 기록된 플래시는 문제가 되지 않습니다. 재시도가 계속 실패하면 카드를 리셋하지 말고 HyperAccel에 문의하십시오.

도구가 디버그 도구를 언급하는 경우

도구는 복구에 디버그 도구(예: Trace32)가 필요할 수 있다고 안내하는 메시지를 냅니다. 이는 JTAG 디버거를 이용한 복구를 뜻하며, 호스트 소프트웨어로는 복구할 수 없는 상태를 가리킵니다. 이런 상태가 되었다면 HyperAccel에 문의하십시오.


함께 보기