릴리즈 노트¶
ha.ko 드라이버와, 드라이버와 함께 배포되는 운영 도구·패키지의 버전별 변경입니다. 이 노트는 운영 기능만 다루며, 애플리케이션 인터페이스의 변경은 SDK 릴리즈 노트에 있습니다. 최신 버전이 맨 위에 있습니다.
2.6.0¶
2026-11-11 릴리즈. VM 게스트에서 호스트와 카드 사이의 복사가 동작하게 하고, 카드를 다음 사용자에게 넘기기 전에 지우는 ha-wipe를 추가했으며, 리셋에 실패한 카드의 판정과 ha-hotreset의 경로 마스킹을 바꿨습니다.
신규¶
tw_window_size,dmabuf_exports노드.tw_window_size는 변환 창 하나의 크기를,dmabuf_exports는 RDMA NIC 같은 다른 장치가 카드 DRAM에 직접 접근하도록 예약된 dma-buf export 창과 export를 요청한 프로세스를 보여 줍니다.hyperaccel-smi의-q와--json에도 나옵니다. sysfs 노드를 보십시오.ha-wipe. 카드를 다음 사용자에게 넘기기 전에ha-hotreset으로 리셋하고 할당할 수 있는 DRAM 전체를 0으로 채운 뒤 일부 블록을 다시 읽어 확인하는 도구입니다. deb 패키지와make install이/usr/bin/ha-wipe로 설치합니다. SRAM은 지우지 않습니다. ha-wipe를 보십시오.ha_hdma_cpu_latency_us(기본0). DMA 엔진이 복사하는 동안과 끝난 뒤 10 ms 동안 CPU wake-up latency 요청을 걸어, 복사를 기다리는 스레드가 깊은 C-state에서 늦게 깨지 않게 합니다. 기본값은 그동안 모든 C-state를 막습니다.-1이면 걸지 않습니다. 파라미터 레퍼런스를 보십시오.ha_hdma_completion(기본auto). DMA 엔진의 완료를 받는 방식을 정합니다.auto는 베어메탈로 확인될 때만 인터럽트(MSI-X)를, 아니면 폴링을 쓰고,irq와poll은 그 판단을 덮어씁니다. 드라이버가 VM을 베어메탈로 잘못 판단해 모든 복사가 실패할 때poll로 설정하십시오. 파라미터 레퍼런스를 보십시오.ha_ready_timeout_ms(기본3000). 리셋 뒤 펌웨어가 준비 완료를 알릴 때까지 드라이버가 기다리는 시간(ms)을 정합니다. 이전에는 3초로 정해져 있었습니다. 리셋 뒤 커널 로그에device came back but firmware did not report ready가 남았는데 잠시 뒤fw_version에 버전이 나오면 값을 올리십시오. 파라미터 레퍼런스를 보십시오.ha_host_mem_max_mb(기본1024). 카드가 직접 읽고 쓰도록 애플리케이션이 드라이버에서 할당하는 호스트 메모리의 합에 대한 상한(MiB)입니다. 모든 카드와 프로세스의 할당을 합쳐 세며, 상한을 넘는 할당은 실패합니다.0이면 상한이 없습니다. 파라미터 레퍼런스를 보십시오.
변경¶
- VM 게스트에서 호스트와 카드 사이의 복사가 동작합니다. 카드를 VM에 패스스루하면 DMA 엔진의 완료 인터럽트가 드라이버에 닿지 않아, 복사가 모두 5초 뒤
ll: timeout으로 실패했습니다. 이제 베어메탈로 확인되지 않으면 엔진이 호스트 메모리에 남기는 완료 표시를 폴링합니다. 어느 방식을 쓰는지는 드라이버를 적재할 때 남는HDMA completion: <방식>줄이 보여 주며, 폴링일 때는 엔진마다의HDMA … MSI-X줄이 남지 않습니다. 완료 알림이 오지 않은 전송은 새 줄ll: engine stopped but its completion <방식> never arrived로 알립니다. x86 베어메탈 서버는 그대로 인터럽트를 씁니다. 커널이 EL1에서 도는 arm64 서버는 베어메탈이어도 폴링으로 바뀝니다. 이런 서버는ha_hdma_completion=irq로 설정하면 이전처럼 인터럽트로 받아, 폴링에 드는 CPU를 쓰지 않습니다. 커널 로그 메시지를 보십시오. - 카드 간 복사가 변환 창 경계를 걸쳐도 정확히 전송됩니다. 이전에는 상대 카드의 변환 창 하나(
tw_window_size)가 덮는 범위를 넘는 조각이 있으면 넘친 부분이 이웃한 다른 구간에 닿았습니다. 읽을 때는 다른 구간의 데이터를 성공으로 돌려주고, 쓸 때는 다른 프로세스의 메모리를 덮을 수 있었습니다. 이제 경계에서 잘라 창 하나씩 전송합니다. 상대 카드가 리셋 중이거나 FATAL이면 복사를 시작하지 않고 오류로 끝냅니다. 여러 디바이스를 보십시오. - 카드 쪽 BAR2 주소를 받지 못한 카드는 바인드하지 않습니다. 드라이버는 펌웨어가 알려 주는 카드 쪽 BAR2 주소로 접근 창을 설정합니다. probe 때 1초 안에 이 주소를 받지 못하면 그 카드에
/dev/haN을 만들지 않고, 펌웨어가 부팅했는지에 따라 커널 로그에firmware booted but did not publish the BAR2 inbound base …또는firmware has not booted, so the BAR2 inbound base is unknown …을 남깁니다. probe를 멈추는 오류를 보십시오. - 카드 번호와 장치 번호가 모듈을 다시 적재해도 유지됩니다. 모듈을 적재할 때 꽂혀 있는 카드에 PCI 주소 순서로 번호를 매겨 두고, probe에 실패한 카드의 번호는 비워 둡니다. 모든 카드가 장치 번호의 major 하나를 같이 쓰고 minor가 카드 번호입니다. 카드 번호를 보십시오.
pool_bar파라미터를 없앴습니다. 접근 창은 항상 BAR2에 둡니다.- SDK 리셋이 실패해도
faulted가 남습니다. 이전에는 자동 리셋이 실패했을 때만health가faulted로 남았습니다. 이제 SDK로 요청한 리셋이 실패해도faulted로 남고, 그 카드의 자동 리셋도 멈춥니다. - 리셋 실패 안내. 리셋이 카드를 복구하지 못하면 커널 로그에
device reset failed (...)줄이 남고, 다시 리셋할지, 호스트에서ha-hotreset을 실행할지, 호스트 전원을 재인가할지를 알려 줍니다. 부모 포트가 Surprise Down을 마스킹하지 않아 드라이버가 SBR을 거부한 카드는 이제 옵션 없이ha-hotreset으로 리셋할 수 있습니다. 리셋이 실패하면을 보십시오. ha-hotreset이 경로 마스킹을 기본으로 씁니다. 부모 포트가 root port가 아니고 Surprise Down을 마스킹하지 않은 카드도, 리셋하는 동안 부모 포트부터 root port까지 경로를 마스킹하고 카드가 다시 응답하면 되돌려 리셋합니다. 이전에는 이런 카드를 거부했고--allow-switch-link-drop을 줄 때만 마스킹했습니다.--no-switch-link-drop을 주면 이전처럼 거부합니다.--allow-switch-link-drop은 호환을 위해 받지만 효과가 없습니다. 경로 마스킹을 보십시오.ha-hotreset의 거부 종료 코드. 아무것도 건드리지 않은 거부가 종료 코드로 구분됩니다. 디바이스 노드가 열려 있거나 다른ha-hotreset실행을 기다리다 시간이 다하면3, 이 카드의 PCIe 위치에서 SBR이 안전하지 않으면4입니다. 이전에는 열린 노드와 SBR 거부가 모두1이었습니다.ha-hotreset은 드라이버가 카드를 바인드하지 않으면 실패합니다. 리셋 전에/dev/haN이 없던 카드도 리셋 뒤ha드라이버가 바인드했는지 확인하고, 바인드하지 않았으면the card was reset but the ha driver did not bind it를 출력하고 종료 코드1로 끝납니다. 이전에는 이런 카드에Hot reset OK를 출력했습니다. 동작 순서를 보십시오.ha-hotreset은 호스트에서 한 번에 하나만 실행됩니다. 마스킹하는 포트를 그 아래 카드들이 함께 쓰기 때문입니다. 두 번째 실행은 첫 실행이 끝날 때까지 최대 600초 기다립니다.ha-fw-update는 리셋 단계에서 기다리게 되면 그 사실을 먼저 출력합니다.ha-hotreset의 중단 처리. 카드를 제거한 뒤에 실패하거나 중단되면 카드를 다시 인식시키고, 카드가 응답할 때만 마스킹을 되돌립니다. 응답하지 않으면 마스킹을 남기고 직접 되돌리는setpci명령을 출력합니다. 이전에는 카드가 응답하는지 확인하지 않고 마스킹을 되돌렸습니다.- 드라이버의 명령 프로토콜이 v9가 되었습니다. 카드를 인식할 때 커널 로그에
ABI protocol v<N> (driver v9, min v6)이 남습니다. 연결에 필요한 최소 버전은 v6 그대로이므로 펌웨어를 업데이트하지 않아도 됩니다. 지원 환경을 보십시오. - arm64와 RHEL 9에서 동작을 확인했습니다. Ubuntu 24.04 arm64(4K 페이지 커널)와 RHEL 9.8(x86_64)에서 확인했습니다. 이전에는 arm64는 검증 중, RHEL 9 계열은 검증 예정이었습니다. 지원 환경을 보십시오.
- 자동 리셋의 커널 로그 메시지가 영어로 바뀌었습니다. 시작(
auto-TDR: the device went FATAL; resetting it), 실패(auto-TDR: reset failed (<err>); ...), 리셋 도중 제거(auto-TDR: this instance was removed during the reset (<err>); ...) 세 줄입니다. 커널 로그에서 이전 한국어 문구를 찾는 스크립트가 있으면 새 문구로 바꾸십시오. - AEXP 커널 로그 문구가 바뀌었습니다.
AEXP:로 시작하는 세 줄이 이제bootloader default라고 적습니다. 이 줄을 찾는 곳이 있으면 함께 고치십시오. - 커널 로그 정리. 부팅 신호를 기다리는 동안 50 ms마다 남던
wait_boot: elapsed=…줄을 디버그 수준으로 내려 기본 커널 로그에 남지 않게 했습니다. help노드가peer_sram의 SRAM 주소 계산식을 더 이상 적지 않습니다. 계산식은 여러 디바이스를 참고하십시오.- deb 패키지가
pciutils에 의존합니다.ha-hotreset과, 이를 거치는ha-fw-update,ha-wipe가setpci와lspci를 씁니다. DKMS tarball의make install도 필요한 패키지를 설치할 때pciutils를 함께 설치합니다. - deb 패키지가 드라이버 인터페이스 버전을 알립니다.
hyperdriver-dkms가hyperaccel-kmd-uapi(이 드라이버가 구현한 버전)와hyperaccel-kmd-uapi-min(이 드라이버가 아직 지원하는 가장 낮은 버전)을 Provides로 제공합니다. SDK 패키지가 함께 쓸 수 있는 드라이버를 요구하는 데 씁니다. .tar.gz패키지의 핫 리셋 스크립트 이름이 바뀌었습니다.hotreset.sh가ha-hotreset.sh가 되었고,ha-fw-update와ha-wipe도 자기 디렉터리에서 이 이름을 찾습니다. 설치되는 명령은 그대로ha-hotreset입니다.- 드라이버 소스의 라이선스는 GPL-2.0-only입니다.
ha커널 모듈 소스에 라이선스 표기가 들어가고, 패키지에 전문이COPYING으로 들어갑니다. DKMS 소스의 헤더는 모두include/로 옮겨졌고,src/에는.c파일만 있습니다.
2.5.0¶
2026-10-19 릴리즈. 호스트와 카드 사이의 복사를 DMA 엔진 여러 개로 처리하고, 섀시에서 카드를 찾는 ha-led를 추가했으며, arm64와 새 커널에서 빌드할 수 있게 했습니다.
신규¶
- 호스트와 카드 사이의 복사가 DMA 엔진 여러 개로 처리됩니다. 카드마다 방향별로 여러 엔진이 복사를 나누어 병렬로 처리하고, 호스트 페이지를 준비하는 일과 전송을 겹쳐 처리량이 늘었습니다. 이전에는 4 KiB보다 작은 복사를 CPU 복사(PIO)로 처리했지만, 이제는 복사 크기와 상관없이 DMA 엔진으로 보내는 것이 기본이며(
ha_hdma_min_bytes, 기본0),N을 주면N바이트보다 작은 복사만 CPU 복사로 처리합니다. 파라미터 레퍼런스를 보십시오. ha-led. 카드 한 장의 보드 LED를 깜빡여, 섀시에서 그 카드가 꽂힌 슬롯을 찾게 해 주는 도구입니다.hyperaccel-smi가Bus-Id로 보여 주는 카드를 PCI 주소로 지정합니다. deb 패키지와make install이/usr/bin/ha-led로 설치합니다. 펌웨어 ABI 프로토콜 8 이상에서 동작하며, 보드에 LED가 있어야 합니다. ha-led를 보십시오.- arm64 빌드. arm64 커널에서 DKMS로 드라이버를 빌드할 수 있습니다. 드라이버는 4K 페이지 커널만 지원하며, DKMS는 16K·64K 페이지 커널을 빌드 대상에서 제외합니다.
abi_prefetch_stats노드.ha_abi_prefetch의 판정 누계를 한 줄로 보여 줍니다. 복사를 앞당긴 횟수(issued), 그 결과가 쓰인 횟수(consumed), 사유별 거절 횟수(refused_*) 등이 들어 있어, 앞당기기가 기대만큼 일어나지 않을 때 원인을 찾는 데 씁니다.
변경¶
- 새 커널에서 빌드. 커널 6.3 이상과 RHEL 9.4 이상 커널에서 바뀐 커널 API에 맞췄습니다. 빌드를 확인한 커널은 지원 환경을 보십시오.
make install이 빌드를 먼저 확인합니다. DKMS tarball의make install은 새 버전이 실행 중인 커널에서 빌드되는지 임시 DKMS 트리에서 확인한 뒤에 기존 드라이버를 교체합니다. 빌드되지 않으면 설치된 드라이버를 건드리지 않고 멈춥니다.- DKMS tarball
make install의 설치 안내. - RHEL 계열(RHEL, CentOS Stream, AlmaLinux, Rocky Linux)과 Fedora에서 필요한 패키지를 설치하지 못하면 dnf 오류 메시지별 조치를 함께 출력합니다.No match for argument: dkms에는 EPEL을 켜는 명령(RHEL 계열만)을,No match for argument: kernel-devel-...에는 커널을 업데이트하고 재부팅한 뒤 다시 설치하라는 안내를 냅니다. - EL9 이상과 Fedora에서는 설치된 커널 중 가장 새 버전에 맞는kernel-devel-matched를 함께 설치합니다. 저장소에서 새 커널을 끌어오지는 않습니다. -modprobe ha가 실패하면 Secure Boot에서 DKMS 서명 키를 MOK로 등록하는 명령을 출력합니다. - deb 패키지가 빌드에 실패해도 기존 드라이버를 남깁니다.
hyperdriver-dkms는 새 버전을 실행 중인 커널에서 먼저 빌드해 봅니다. 빌드되지 않으면 설치를 실패로 끝내고, 지금 적재된 버전과 설치된 버전, 빌드 로그 위치를 출력합니다. 패키지를 제거하면 DKMS에 등록된 모든 버전을 지웁니다. - DMA 엔진이 응답하지 않거나 멈추지 않으면 카드가 FATAL이 됩니다. 카드가 DMA 엔진의 상태 레지스터에 응답하지 않거나(
ll: no response), 시간 초과나 중단 뒤에도 엔진이 멈추지 않으면(HDMA engine at …) 디바이스가 FATAL이 됩니다. 이전에는 엔진을 멈추지 못해도 경고(ch <ch> still running after force stop)만 남기고 그 전송만 실패시켰습니다. 이제 엔진이 아직 쓸 수 있는 호스트 페이지를 해제하지 않고 격리하며, 카드를 리셋해 엔진이 멈출 때까지 새 DMA 전송을 막습니다. FATAL과 복구를 보십시오. - DMA와 변환 창의 커널 로그 문구가 바뀌었습니다. DMA 줄의
ch=<ch>가channel=<ch> <방향>이 되었고(ll: timeout (n=<n> channel=<ch> <방향>)), 변환 창이 모자랄 때 남던TW: every pool window is pinned; … failed가 창을 무엇이 붙잡고 있는지 개수로 보여 주는TW: no free pool window (…); … failed로 바뀌었습니다. 커널 로그에서 이전 문구를 찾는 스크립트가 있으면 새 문구로 바꾸십시오. 커널 로그 메시지를 보십시오. - 커널 로그 정리. 인터럽트와 명령마다 남던 메시지(
MSI-X recv등)를 디버그 수준으로 내려 기본 커널 로그에 남지 않게 했습니다. 펌웨어 오류 덤프(Firmware error: resq[...])는 모든 카드를 합쳐 5초에 10번까지만 남깁니다. 오류 횟수는devcmd_fw_errors가 빠짐없이 셉니다. ha_abi_prefetch판정 보강. 같은 스트림에서 앞선 작업이 목적지 버퍼를 읽거나 쓰면 그 복사를 앞당기지 않습니다. 앞당기지 않은 복사는 원래 순서대로 실행됩니다.ha-hotreset의--bdf값 확인.--bdf뒤에 PCI 주소를 주지 않거나--bdf=처럼 빈 값을 주면--bdf needs a PCI address와 사용법을 출력하고 종료 코드 2로 끝납니다. 이전에는 값 없는--bdf가 종료 코드 1로 끝났고, 빈--bdf=는 카드가 한 장일 때 그 카드를 골랐습니다.- 펌웨어 업데이트 응답을 기다리는 동안의 리셋 거부 메시지.
reset refused: last fw_update unanswered …가 펌웨어가 응답한 뒤 업데이트를 다시 실행하고, 그래도 안 되면 지원팀에 문의하라고 안내합니다. 이전 메시지는 모듈 재적재,ha-hotreset --force, 전원 재인가를 제안했습니다.
2.4.0 이하 deb에서 업그레이드할 때
빌드에 실패해도 기존 드라이버를 남기는 동작은 2.5.0 패키지가 설치된 다음 업그레이드부터 적용됩니다. 2.4.0 이하 패키지는 업그레이드를 시작할 때 설치된 드라이버를 먼저 제거하므로, 새 버전이 빌드되지 않으면 설치된 드라이버가 남지 않습니다. 업그레이드 전에 실행 중인 커널의 헤더가 설치되어 있는지, 그 커널이 지원 환경에 있는지 확인하십시오.
2.4.0¶
2026-09-22 릴리즈. 펌웨어 업데이트 도구를 추가하고, 리셋이 SBR(Secondary Bus Reset)을 거는 조건을 바꿨습니다.
펌웨어 ABI 프로토콜 6 이상이 필요합니다
2.4.0 드라이버가 요구하는 펌웨어 ABI 프로토콜 최소 버전은 6입니다(2.3.1부터 2.3.6까지는 1). 펌웨어가 이보다 낮은 프로토콜을 게시하면 드라이버는 그 카드를 등록하지 않고 커널 로그에 ABI protocol mismatch: firmware vN, driver requires >= v6; refusing probe를 남깁니다. 지금 쓰는 펌웨어의 프로토콜은 probe(드라이버가 카드를 인식하는 단계) 때 커널 로그에 남는 ABI protocol vN (driver vM, min vK)의 N으로 확인합니다. 업그레이드 전에 N이 6 이상인지 확인하십시오. 이 줄은 2.3.1 이후 드라이버가 남깁니다. 이 줄이 없거나 대신 predates the ABI protocol handshake가 남으면 지원 환경의 펌웨어 항목을 보십시오.
신규¶
ha-fw-update. 실행 중인 펌웨어를 통해 카드의 부트 플래시에 펌웨어 이미지를 쓰고, 카드를 핫 리셋해 새 펌웨어로 부팅하는 도구입니다. deb 패키지와make install이/usr/bin/ha-fw-update로 설치합니다. 펌웨어 ABI 프로토콜 7 이상에서 동작하며, 업데이트하는 동안 그 카드의 다른 작업과 리셋(자동 리셋 포함)은 거절됩니다. 절차와 안전 규칙은 펌웨어 업데이트를 보십시오.fw_update_progress노드. 펌웨어 업데이트 진행률을 4 KiB 섹터 단위<완료> <전체>로 보여 줍니다. 업데이트를 지원하지 않는 펌웨어에서는unknown입니다.- 카드 간 SRAM 경로와
peer_sram노드. 드라이버가 probe 때 카드마다 다른 LPU의 SRAM으로 가는 경로를 설정하고, 리셋 뒤 다시 설정합니다. 이 카드에서 실행되는 커널이 각 LPU의 SRAM에 접근할 때 쓰는 base 주소를peer_sram이 LPU마다 한 줄로 보여 줍니다. ha_abi_prefetch(기본 켜짐). 다음 커널을 실행하기 전에 호스트에서 디바이스로 보내는 ABI 데이터를, 앞선 커널이 실행되는 동안 미리 복사하기 시작합니다.0이면 앞당기지 않습니다. 런타임에 바꿀 수 있습니다.
변경¶
- SBR 조건. SDK 디바이스 리셋과 자동 리셋은 펌웨어 재초기화가 실패했을 때 SBR로 넘어갑니다. 이제 부모 포트가 root port이거나, 부모 포트에서 Surprise Down Error가 마스킹된 경우에만 SBR을 겁니다.
ha-hotreset과 같은 기준입니다. 2.3.6까지는 부모가 PCIe 스위치 downstream port만 아니면 SBR을 걸었습니다. SBR을 거절하면 이유를 커널 로그에 남기고, SBR을 걸 때는issuing SBR via parent <BDF>를 남깁니다. - 리셋 뒤에는 디바이스를 다시 엽니다. 디바이스가 리셋되면(SDK 디바이스 리셋, 자동 리셋, PCIe 오류 복구 등) 리셋 전에 열어 둔 핸들로는 더 이상 작업할 수 없습니다. 애플리케이션은 디바이스를 다시 열어야 합니다. SDK로 리셋을 요청한 핸들은 계속 쓸 수 있습니다.
- FATAL 디바이스의 폴링 중지. 디바이스가 FATAL이면 리셋될 때까지 텔레메트리 폴링과 워치독 판정을 멈춥니다. 이 동안
health는faulted이고, 온도·전력 같은 폴링 값은 마지막 샘플이 5초를 넘기면unknown이 됩니다. - 카드 번호 유지. 모듈이 적재된 동안 같은 PCI 주소의 카드가 다시 인식되면(리셋 중 재열거 등), 그사이 다른 카드가 그 번호를 가져가지 않았다면 이전과 같은
haN번호를 받습니다. 규칙은 카드 번호를 보십시오. - 워치독.
- 임계값과 관찰 주기를 더한 값이 대기 상한 이상이라 stall을 잡을 수 없는 구성이면 커널 로그에 경고합니다. 값은 바꾸지 않습니다.
- hang 하나에 hang dump를 한 번만 남깁니다.
- 상한 없이 기다리는 명령이 오래 걸리면 그 시점의 배치 진행과 판정을
last_hang에 기록합니다. - hang dump. 마지막으로 보낸 펌웨어 명령의 이름, 판정(응답 상한이 지나 판정이 나온 경우), 그 명령을 보낸 디바이스 핸들을 연 프로세스(PID와 이름)를 사람이 읽는 한 줄(
hang (...))로 먼저 남깁니다. 기계용hang dump줄의 스트림 값은 사용자 공간 주소가 아니라 부팅마다 다른 키로 가린 값입니다. last_hang. 기록된 적 없는rc,cmd_idx,opcode를0대신-로 표시합니다.hyperaccel-smi도 이 값을 읽어 표시합니다.- 커널 로그 정리. 디바이스 메모리 할당·해제마다 남던 메시지를 디버그 수준으로 내렸습니다.
2.3.6¶
2026-09-09 릴리즈. 워치독과 hang 진단, PCIe 오류 복구를 추가했습니다.
신규¶
- 워치독. 디바이스 명령과 DMA 전송의 대기를 바깥에서 주기적으로 관찰해, 임계를 넘으면 커널 로그에
watchdog: ... wait stalled를 남깁니다. 기본값에서는 보고만 하고 대기를 끊지 않습니다. -ha_wd_hang_ms(기본8000): 디바이스 명령 대기의 임계입니다.0이면 끕니다. -ha_wd_hdma_hang_ms(기본4000): DMA 전송 대기의 임계입니다.0이면 끕니다. -ha_wd_poll_ms(기본500, 최소50): 관찰 주기입니다. -ha_wd_preempt(기본0): 켜면 멈춘 대기를 끊습니다. 애플리케이션 작업의 대기를 끊으면 디바이스가 FATAL이 되므로ha_auto_reset=1과 함께 씁니다. - hang dump. 응답 상한이 지나거나 워치독이 stall로 판정한 디바이스 명령 대기를 찾으면 커널 로그에
hang dump한 줄을 남깁니다. 마지막으로 보낸 명령과 그 본문, 명령 큐 진행, DMA 엔진 상태가 들어 있습니다. 상한 없이 기다리는 명령이 오래 걸리면 경과 시간과 그 명령을 기다리는 프로세스도 주기적으로 남깁니다. ha_devcmd_ceiling_ms(기본12000, 최소100). 드라이버가 펌웨어 응답을 기다리는 상한입니다. 이 시간 안에 응답이 없으면 hang으로 보고devcmd_timeouts를 올립니다. 애플리케이션 작업을 기다리던 중이었으면 디바이스는 FATAL이 됩니다.last_hang의 진행 정보와 판정. 마지막 hang 때의 배치 진행(batch_seq,exec_index,resq_tail)과 판정(verdict)이 추가되었습니다. 판정은 디바이스가 명령에서 멈췄는지(stuck-in-command), 완료 인터럽트만 놓쳤는지(completed-irq-lost) 등을 구분하며, 펌웨어가 진행 정보를 제공하지 않으면unsupported입니다.hyperaccel-smi -q가 판정과 진행 정보를 함께 보여 줍니다.peer_route노드. peer마다 카드 사이의 PCIe 경로를direct(스위치 안에서 직접) 또는host-mem(root complex 경유)으로 보여 줍니다. 관측용이며 전송을 막지 않습니다.- PCIe 오류 복구. 커널이 PCIe 오류 복구(AER, DPC)를 진행하면 드라이버가 진행 중인 작업을 멈추고, 복구 뒤 펌웨어 부팅을 확인한 다음 요청을 다시 받습니다.
ha_aer_enable(기본0, 적재할 때만 설정). 드라이버가 카드의 PCIe AER 오류 보고를 켤지 정합니다. AER로 보고된 치명적 오류에 대한 커널의 복구 조치는 부모 브리지 SBR이고, 구성에 따라 호스트 재시작으로 이어질 수 있어 기본으로 꺼 둡니다. 커널 버전에 따른 차이는 FATAL과 복구를 보십시오.ha_sysmon_poll_ms(기본200, 범위50~2500). 텔레메트리 폴링 주기를 바꿀 수 있습니다.0은 끄는 값이 아니라 가장 짧은 주기(50)입니다.ha_tw_pin_wait_ms(기본12000, 범위0~60000). 디바이스 간 복사가 상대 카드의 변환 창(translation window) 슬롯을 기다리는 상한입니다. 상한이 지나면 그 전송은 실패하고 커널 로그에 남습니다.0이면 기다리지 않습니다.
변경¶
- 펌웨어 준비 확인. probe와 리셋 때 펌웨어가 준비 완료를 알릴 때까지 기다립니다. 알리지 않아도 카드는 등록되지만, 펌웨어에서 읽는 텔레메트리는
unknown이고 애플리케이션 요청은 준비될 때까지 거절됩니다. 펌웨어가 나중에 준비되면 그때부터 정상 동작합니다. - FATAL 판정. 애플리케이션 작업에서 펌웨어가 돌려준 오류 코드가 그 명령만 실패시키는 것으로 정해진 코드가 아니면(처음 보는 코드 포함) 디바이스를 FATAL로 봅니다. 2.3.1까지는 응답 없음, 펌웨어 시간 초과, 코어 치명 오류만 FATAL로 봤습니다.
- 리셋 중 텔레메트리. 디바이스 리셋 동안에는 텔레메트리 폴링과 디바이스를 읽는 sysfs 조회를 멈춥니다. 폴링 값은 마지막 샘플이 5초를 넘기면
unknown이 됩니다. - 핸들이 열린 디바이스의 제거. 디바이스를 연 프로세스가 남아 있어도 드라이버 언바인드나 핫 리셋에 따른 디바이스 제거를 처리합니다. 남은 프로세스의 요청은 실패하고, 디바이스 메모리 매핑에 접근하면
SIGBUS가 발생할 수 있습니다. - 커널 로그 정리. 명령마다 남던 메시지(
devcmd stage,devcmd flush)를 디버그 수준으로 내렸습니다. 명령마다 남던 응답 큐 덤프는 이제 펌웨어 오류(Firmware error: resq[...])가 날 때만 함께 남습니다.
2.3.1¶
2026-08-20 릴리즈. 카드 단위 핫 리셋 도구를 추가하고, 응답하지 않는 카드를 계속 읽지 않도록 텔레메트리를 보호했습니다.
신규¶
ha-hotreset. 카드 하나를 PCIe 핫 리셋하는 도구입니다. deb 패키지와make install이/usr/bin/ha-hotreset으로 설치합니다. 지정한 카드만 제거하고 부모 브리지에서 SBR을 건 뒤 다시 스캔하므로, 모듈은 적재된 채로 남고 다른 카드는 리셋되지 않습니다. 이전 리셋 스크립트는 모듈을 내려 모든 카드를 떼어 냈습니다. - 부모 포트가 root port가 아니면서 Surprise Down Error를 마스킹하지 않았거나, 카드의 디바이스 노드가 열려 있거나, 부모 브리지 아래에 다른 디바이스가 있으면 아무것도 건드리지 않고 멈춥니다. 이 중 일부는 옵션으로 넘길 수 있습니다. ---all은 모든 카드를 먼저 점검하고, 한 장이라도 점검을 통과하지 못하면 어느 카드도 리셋하지 않습니다. - 옵션은 ha-hotreset을 보십시오.peer_map노드. 이 카드에서 다른 카드로 가는 디바이스 간 복사의 매핑 상태를 peer마다mapped또는unmapped로 보여 줍니다.unmapped인 방향의 복사는 실패하며 다른 주소로 대신 보내지 않습니다. 다른 카드가 없으면none입니다.pool_bar(기본1, 적재할 때만 설정). 호스트가 디바이스 메모리에 접근하는 창을 둘 BAR를 정합니다. 기본값1(BAR2)에서는 다른 카드가 이 카드의 SRAM에 직접 접근하는 기능과 연산을 함께 쓸 수 있고,0(BAR0)은 이전 방식입니다. 펌웨어가 BAR2의 주소를 알려 주지 않는데 카드 쪽 PCIe 주소가 호스트와 다른 구성이면 BAR0로 내려가고 커널 로그에using BAR0 pool을 남깁니다.ha_sysmon_fail_limit(기본15). 텔레메트리 폴링이 연속으로 이 횟수만큼 응답을 받지 못하면 폴링을 멈추고 커널 로그에 남깁니다. 응답하지 않는 카드를 계속 읽으면 PCIe Completion Timeout이 나고, firmware-first 플랫폼은 이를 이유로 서버를 리셋할 수 있기 때문입니다. 멈춘 동안 폴링 값은unknown이고, 디바이스를 리셋하면 폴링을 다시 시작합니다.0이면 멈추지 않습니다.- 펌웨어 호환성 확인. probe 때 펌웨어가 게시한 ABI 프로토콜 버전을 커널 로그에
ABI protocol vN (driver vM, min vK)로 남기고, 드라이버의 최소 버전보다 낮으면 그 카드를 등록하지 않습니다.
변경¶
fw_version. 펌웨어 버전 값이0이나 all-ones로 읽히거나 펌웨어 부팅이 확인되지 않으면unknown을 표시합니다.hyperaccel-smi. 표와-q출력에서 IP별 사용률을core,mpu,vpu,cdma,cgdma만 보여 줍니다.--json출력에는util노드의 항목이 모두 들어 있습니다.
2.3.0¶
2026-07-31 릴리즈. sysfs 텔레메트리, hwmon, hyperaccel-smi, 자동 리셋, deb 패키지를 처음 제공합니다.
신규¶
- sysfs 텔레메트리.
/sys/class/ha/haN/아래에 읽기 전용 노드를 추가했습니다. root 권한이나 디바이스 핸들 없이 읽을 수 있고, 연산이 멈춘 동안에도 응답합니다. 센서 값을 믿을 수 없으면unknown을 표시합니다. - 정적 정보:fw_version,hw_version,serial,dram_size,sram_size- 메모리 사용량:dram_used,dram_free,sram_used,sram_free- 센서:temp,temp_avg,temp_blocks,power_mw,rails,util- 작업과 오류:inflight,stream_count,devcmd_timeouts,devcmd_fw_errors,hdma_timeouts,last_hang- 상태와 설명:health(ok,degraded,faulted,unknown),help - hwmon. 커널이 hwmon을 지원하면
ha라는 이름으로 센서를 등록합니다. 온도 15개(최고, 평균, 블록 13개), rail 4개의 전압과 전류, 전체 전력을 lm-sensors나 node_exporter가 별도 설정 없이 읽습니다. hyperaccel-smi. sysfs 텔레메트리를 표로 보여 주는 명령입니다.make install과 deb 패키지가/usr/bin/hyperaccel-smi로 설치합니다.-q(상세),--json,-l(반복),-i(카드 지정)를 지원하고,HYPERACCEL_VISIBLE_DEVICES로 보여 줄 카드를 제한할 수 있습니다. 보이는 LPU가 없으면 종료 코드2를 돌려주므로 헬스체크에 쓸 수 있습니다. Python 3가 필요합니다.ha_auto_reset(기본0). 켜면 디바이스가 FATAL이 될 때 드라이버가 자동으로 리셋합니다. 자동 리셋이 실패하면 수동 리셋이 성공할 때까지 다시 시도하지 않고,health는faulted를 표시합니다.- deb 패키지
hyperdriver-dkms. DKMS 소스, udev 규칙, 부팅 때 자동 적재 설정,hyperaccel-smi를 설치합니다. 실행 중인 커널과, 헤더가 설치된 다른 커널 모두에 대해 드라이버를 빌드합니다. 실행 중인 커널의 헤더가 없으면 설치를 중단하고, 업그레이드 뒤에도 디바이스가 사용 중이라 이전 드라이버가 계속 적재되어 있으면 경고합니다. CDI 스펙 생성기는 들어 있지 않습니다.
변경¶
- 리셋 절차. SDK 디바이스 리셋은 진행 중인 작업을 멈추고 정리한 뒤 먼저 펌웨어 재초기화를 시도하고, 실패할 때만 SBR로 넘어갑니다. 부모가 PCIe 스위치 downstream port이면 호스트 장애를 막기 위해 SBR을 거절합니다. 자동 리셋도 같은 절차를 따릅니다.
- 사용자 공간 라이브러리 분리. 드라이버 패키지는 더 이상
libha_driver(라이브러리, 헤더, pkg-config 파일)를 설치하지 않습니다. 이 라이브러리는 SDK와 함께 설치됩니다. - 사전 빌드 tarball의 정리 범위. 사전 빌드 tarball의
make install과make remove가 다른 경로나 DKMS로 설치된ha.ko와 DKMS 등록까지 지웁니다.
버전 목록¶
| 버전 | 릴리즈 날짜 |
|---|---|
| 2.6.0 | 2026-11-11 |
| 2.5.0 | 2026-10-19 |
| 2.4.0 | 2026-09-22 |
| 2.3.6 | 2026-09-09 |
| 2.3.1 | 2026-08-20 |
| 2.3.0 | 2026-07-31 |
적재된 드라이버의 버전은 cat /sys/module/ha/version으로, 실행 중인 커널에 설치된 모듈 파일의 버전은 modinfo -F version ha로 확인합니다.