지원 환경
현재 버전의 드라이버를 설치하고 쓸 수 있는 아키텍처, 배포판, 운영체제 및 커널, IOMMU 구성을 정리합니다. 항목마다 무엇까지 확인했는지 함께 적었습니다. 여기에 명시되지 않은 환경은 확인되지 않았습니다.
범례 — ✅ 지원 · 🟡 검증 중 · ❌ 미지원 · 📅 예정
아키텍처
| 아키텍처 |
상태 |
확인 내용 |
비고 |
| x86_64 |
✅ |
동작 |
드라이버에서 제공하는 모든 기능을 사용 가능합니다. |
| arm64, 4K 페이지 커널 |
✅ |
동작 |
Ubuntu 24.04(arm64)에서 동작을 확인했습니다. |
| arm64, 16K·64K 페이지 커널 |
❌ |
지원하지 않음 |
현재 드라이버는 4K 페이지만 지원합니다. |
운영체제 별 드라이버 지원 현황
| 운영체제 |
상태 |
확인 내용 |
| Ubuntu 22.04 (x86_64) |
✅ |
동작 확인 |
| Ubuntu 24.04 (arm64) |
✅ |
동작 확인 |
| Ubuntu 24.04, 26.04 (x86_64) |
🟡 |
검증 중: 동작 검증 준비 중입니다. |
| Debian 12 (x86_64) |
🟡 |
검증 중: 동작 검증 준비 중입니다. |
| RHEL 9 계열: Rocky Linux 9, AlmaLinux 9 (x86_64) |
✅ |
9.8에서 동작 확인 |
| RHEL 8 계열 (x86_64) |
📅 |
설치 가능 여부를 검증할 예정입니다. |
| CentOS Stream 9, 10 (x86_64) |
📅 |
설치 가능 여부를 검증할 예정입니다. |
커널 요구 사항
| 요구 사항 |
관련 기능 |
| 페이지 크기 4 KiB |
드라이버 전체. 다른 페이지 크기의 커널에서는 빌드되지 않습니다 |
CONFIG_HWMON |
hwmon 인터페이스. 꺼져 있으면 hwmon 디바이스가 생기지 않습니다. /sys/class/ha/haN/의 텔레메트리는 그대로 동작합니다 |
펌웨어
드라이버는 펌웨어가 부팅할 때 보고하는 명령 프로토콜 버전을 보고 디바이스에 연결할지 정합니다. 이 드라이버의 명령 프로토콜은 v9이고, 연결에 필요한 최소 버전은 v6입니다. 펌웨어가 보고하는 버전이 v6 이상이면 연결합니다. v9보다 높은 버전을 보고하는 펌웨어도, 그 버전이 v6 이상이면 연결됩니다. 프로토콜 v9에는 하드웨어 리비전이 포함되지만, 이 드라이버는 그 값을 sysfs에 표시하지 않습니다. hw_version은 PCI 설정 공간에서 읽습니다.
| 펌웨어 |
상태 |
드라이버 동작 |
| 명령 프로토콜 v6 이상 |
✅ |
연결합니다 |
| 명령 프로토콜 v6 미만 |
❌ |
카드를 인식할 때 연결을 거부합니다. 그 카드에는 /dev/haN이 생기지 않습니다 |
| 펌웨어 1.0.2 미만 |
❌ |
지원하지 않습니다. HyperAccel 지원에 문의하십시오 |
드라이버 일부 기능은 더 높은 버전의 펌웨어가 필요합니다.
| 기능 |
필요한 펌웨어 |
조건에 못 미치면 |
펌웨어 업데이트(ha-fw-update) |
명령 프로토콜 v7 이상 |
업데이트를 거부합니다. sysfs fw_update_progress는 unknown입니다 |
LED 점멸(ha-led) |
명령 프로토콜 v8 이상 |
명령을 거부합니다. ha-led를 보십시오 |
| 온도·전력·사용률 텔레메트리 |
텔레메트리 인터페이스(sys_mon) v3 이상 |
해당 텔레메트리 노드가 unknown입니다 |
명령 프로토콜 v7 미만인 펌웨어는 ha-fw-update로 업데이트할 수 없습니다. 이 경우 펌웨어 업데이트 절차는 HyperAccel 지원에 문의하십시오. 실행 중인 펌웨어와 명령 프로토콜 버전은 다음으로 확인합니다.
| cat /sys/class/ha/ha*/fw_version
sudo dmesg | grep 'ABI protocol'
|
| 커널 로그 |
뜻 |
ABI protocol v<N> (driver v9, min v6) |
명령 프로토콜이 <N>인 펌웨어에 연결했습니다. <N>은 v6 이상이면 되고, v9보다 커도 연결은 유지됩니다 |
ABI protocol mismatch: firmware v<N>, driver requires >= v6; refusing probe |
카드를 인식할 때 나오면 연결을 거부한 것입니다. 리셋 뒤에는 아래 post-reset 줄과 함께 나옵니다 |
firmware v<버전> predates the ABI protocol handshake (needs >= v1.0.2); skipping protocol check |
프로토콜 버전을 확인하지 못한 채 연결했습니다 |
firmware boot not confirmed; skipping ABI protocol check (CSR may be mid-publication) |
카드를 인식할 때 펌웨어가 준비되지 않아, 프로토콜 버전을 확인하지 않고 연결했습니다 |
post-reset ABI protocol check FAILED -- device stays bound but its wire ABI is incompatible; unbind it |
리셋 뒤 다시 부팅한 펌웨어를 이 드라이버와 쓸 수 없습니다. 이유는 그 앞에 같은 카드의 메시지로 남고, 카드는 연결된 채 남습니다 |
IOMMU
| IOMMU 구성 |
상태 |
확인 내용 |
| IOMMU 꺼짐 |
✅ |
동작 |
IOMMU passthrough (iommu=pt) |
✅ |
동작 |
IOMMU DMA/DMA-FQ (iommu=on) |
✅ |
동작 |
여러 디바이스 사이의 경로가 IOMMU 구성에 따라 어떻게 달라지는지는 여러 디바이스를 보십시오.
함께 보기