Claude Code를 활용한 Raspberry Pi BadUSB 툴킷의 하드웨어 디버깅 및 버그 수정 사례

실용적 조언

하드웨어 제어 시 물리적 신호 감지가 불가능할 경우, active-unbind와 쿨다운/레이트 리미트를 결합한 소프트웨어적 우회 방식을 고려하라.
Python으로 커널 인터페이스를 제어할 때 write 호출이 무시된다면 os.write를 사용하여 시스템 콜을 강제하라.

섹션별 상세

Claude Code를 활용한 하드웨어 디버깅을 수행했다. Claude Code가 SSH로 접속하여 실시간으로 /dev/hidg0 및 sysfs 상태를 폴링하며, Pi Zero 2 W가 물리적 연결 해제를 소프트웨어적으로 감지할 수 없음을 확인했다.

하드웨어 제약에 따른 우회 전략을 수립했다. 물리적 연결 신호 부재를 확인한 후, Claude Code는 active-unbind 방식과 쿨다운 및 레이트 리미트를 적용한 우회 솔루션을 제안하고 구현했다.

Python 시스템 콜 관련 버그를 수정했다. open(udc_path, 'w').write('')가 CPython의 TextIOWrapper로 인해 실제 시스템 콜을 호출하지 않는 문제를 발견하고, os.write(fd, b' ')로 변경하여 강제로 시스템 콜을 호출하도록 수정했다.

커널 설정 파일 시스템(configfs) 관리 로직을 개선했다. rm -rf를 통한 삭제가 configfs에서 금지됨을 확인하고, 리프 노드에서 루트 방향으로 rmdir을 수행하는 올바른 teardown 시퀀스를 구현했다.

언급된 도구

Claude Code추천

AI 페어 프로그래밍 및 디버깅

pytest추천

HID 엔진 모의 테스트

언급된 리소스

GitHubPi-Zero-2W-Bad-USB GitHub