리눅스에서 FreeBSD로 Wi-Fi 드라이버 포팅에 AI 활용: 사례 연구

직접적인 AI 코드 포팅 시도

개발자는 Broadcom BCM4350 Wi-Fi 칩이 탑재된 2016년형 MacBook Pro를 보유하고 있었는데, 이 칩은 FreeBSD에 대한 네이티브 지원이 부족했습니다. 일반적인 해결책은 PCI 패스스루가 가능한 Linux VM인 wifibox를 사용하는 것입니다. 대신, 개발자는 AI를 사용해 Linux brcmfmac 드라이버(ISC 라이선스)를 직접 FreeBSD로 포팅하려 시도했습니다.

개발자는 brcmfmac 서브트리를 클론하고 Claude Code에게 FreeBSD에서 작동하도록 만들도록 요청했으며, 특히 LinuxKPI(FreeBSD의 Linux 커널 호환성 레이어) 사용을 위한 참조로 iwlwifi 드라이버를 지목했습니다. 초기 시도는 컴파일은 되지만 작동하지 않는 모듈을 생성했는데, 이는 테스트 VM에 실제 하드웨어가 없었기 때문입니다.

실제 PCI 장치로 테스트할 때 커널 패닉이 발생했습니다. Claude Code는 #ifdef __FreeBSD__ 래퍼를 추가하고 FreeBSD 전용 심(shim)과 콜백을 구축하여 패닉을 수정하려 시도했지만, 프로젝트가 "매우 복잡하고 지저분해지고 있다"고 경고했습니다. 결과적인 diff는 예상보다 훨씬 컸으며, 드라이버는 여전히 작동하지 않았습니다.

명세서 우선 접근법

Armin Ronacher의 Claude Opus와 Pi 에이전트 경험에서 영감을 받아, 개발자는 접근법을 전환했습니다. 자신의 작업이 좁은 범위(하나의 칩, PCI만, Wi-Fi 클라이언트만)임을 인식하고, 새로운 Pi 세션을 생성하여 에이전트에게 BCM4350에 초점을 맞춰 brcmfmac 드라이버가 어떻게 작동하는지에 대한 상세한 명세서를 작성하도록 요청했습니다.

개발자는 명시적으로 독자를 "클린룸 환경에서 명세서를 구현하는 임무를 맡은 독자"로 설정하고, "비트 단위까지" 설명해 달라고 요청했습니다. 에이전트는 다음을 포함하는 11장의 명세서를 생성했습니다:

• 00-overview.md
• 01-data-structures.md
• 02-bus-layer.md
• 03-protocol-layer.md
• 04-firmware-interface.md
• 05-event-handling.md
• 06-cfg80211-operations.md
• 07-initialization.md
• 08-data-path.md
• 09-firmware-commands.md
• 10-structures-reference.md

개발자는 AI가 생성한 명세서는 검증이 필요하다고 언급하며, "AI가 작성한 내용을 그대로 신뢰할 수는 없다"고 지적했습니다.