콘텐츠로 이동

지원 환경

현재 버전의 드라이버를 설치하고 쓸 수 있는 아키텍처, 배포판, 운영체제 및 커널, 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 지원에 문의하십시오. 실행 중인 펌웨어와 명령 프로토콜 버전은 다음으로 확인합니다.

1
2
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 구성에 따라 어떻게 달라지는지는 여러 디바이스를 보십시오.


함께 보기