프로젝트 소개

WFB-NG는 WiFi 카드를 모니터 모드로 동작시켜 association이나 ACK 대기 없이 임의의 802.11 패킷을 송수신하는 차세대 장거리 패킷 라디오 링크입니다. 저지연 영상 및 텔레메트리 링크를 목표로 하며, 주로 FPV와 드론 환경에서 사용됩니다. README에 설명된 주요 기능: - 지연을 최소화하기 위해 바이트 스트림으로 직렬화하는 대신 RTP 패킷을 IEEE80211 패킷에 일대일로 매핑합니다. - 조정 가능한 설정을 갖춘 전방 오류 정정(FEC)을 제공하며, 기본 설정은 12개 패킷 블록에서 손실된 4개 패킷을 복구할 수 있습니다. amd64, arm32, arm64에서 SIMD 가속 FEC는 순수 C 버전보다 5-10배 빠르다고 주장합니다. - 영상 다운링크와 함께 상향/하향 링크용 양방향 MAVLink 텔레메트리를 제공합니다. - 일반 트래픽을 위한 IPv4 터널을 제공하지만, README는 raw UDP 스트림보다 오버헤드가 더 크다고 언급합니다. - RX RSSI를 기반으로 TX 카드를 선택하여 자동 TX 다이버시티를 제공합니다. - libsodium을 사용한 스트림 암호화 및 인증을 제공합니다. - 단일 USB 버스 병목을 피하기 위해 서로 다른 호스트의 카드에서 데이터를 수집하는 분산 동작을 지원합니다. - 작은 패킷마다 WiFi 패킷을 하나씩 보내지 않도록 MAVLink 및 터널 패킷을 집계합니다. - 링크 중단 없이 동적 FEC 및 라디오 변조 변경을 지원합니다. - 오프라인 디버깅을 위해 MAVLink 파서를 포함한 전체 채널 상태 로깅을 제공합니다. - 채널 또는 데이터/FEC 패킷의 우선순위를 지정하기 위한 Linux 트래픽 셰이퍼를 지원합니다. - Raspberry Pi 또는 기타 gstreamer/OpenGL 지원 시스템용 OSD를 제공하며, 모든 화면 해상도와 호환됩니다. - 지원 CPU 아키텍처: arm32v7, arm64v8, amd64, mips64le, s390x, ppc64le, i386, 즉 커널 >= 4.x 및 USB 포트가 있는 Linux입니다. 지원 WiFi 하드웨어: - RTL8812au(안정, 802.11ac)는 외부 패치 드라이버가 필요하며, 5GHz 모드의 ALPHA AWUS036ACH로 테스트되었습니다. - RTL8812eu(안정, 802.11ac)는 외부 패치 드라이버가 필요하며, LB-LINK BL-M8812EU2 모듈로 테스트되었습니다. - Atheros AR9350(안정, 802.11n, LDPC)은 별도 설정 없이 작동하지만 TX 전력을 제어하려면 커널 패치가 필요하며, TP-Link CPE510으로 테스트되었고 OpenWRT를 실행하는 유사한 ath9k SoC 장치에서도 작동할 것으로 예상됩니다. Atheros SoC의 경우 CPU, Flash 및 RAM 제한 때문에 클러스터 모드(베타)를 권장합니다. RX 전용으로 사용하는 경우 모니터링 모드를 지원하는 모든 카드가 작동할 수 있습니다. 시작하기: README는 PX4 가이드와 Setup HOWTO 위키를 안내합니다. 빠른 시작 옵션에는 Releases에서 Raspberry Pi 이미지를 다운로드하고, SD 카드 두 장에 플래싱하고, WiFi 어댑터를 연결한 뒤 systemd 서비스(지상국에서는 wifibroadcast@gs, rtsp, fpv-video, osd, 드론에서는 wifibroadcast@drone, fpv-camera)를 활성화하는 것이 포함됩니다. Debian/Ubuntu 지상국 경로는 DKMS를 통해 패치된 RTL8812AU 또는 RTL8812EU 드라이버를 설치하고 install_gs.sh를 실행합니다. 링크 모니터링은 wfb-cli gs를 사용합니다. 문제 해결은 journalctl 로그, drone.key/gs.key 일치, /etc/wifibroadcast.cfg의 WiFi 채널 및 링크 도메인 일치를 다룹니다. FAQ 주요 내용: 패킷 크기가 3993 이하인 모든 UDP 데이터를 전송할 수 있으며, 예를 들어 RTP의 x264/265, MAVLink, 또는 터널을 통한 일반 IPv4가 있습니다. WFB-ng는 특정 GPU에 묶여 있지 않으며 UDP 패킷에서 동작하고, RTP 스트림에는 비디오 인코더가 필요합니다. 원래 wifibroadcast와 비교하면 UDP를 데이터 소스로 사용하고 하나의 소스 UDP 패킷을 하나의 라디오 패킷으로 패킹하며 라디오 패킷 크기가 가변적인데, README는 이것이 비디오 지연을 크게 줄인다고 설명합니다. 빌드 옵션에는 인라인 make, RPM, DEB 및 bdist tar.gz가 포함됩니다. 지상국과 드론용 암호화 키는 wfb_keygen으로 생성합니다. 이 프로젝트는 보증이 없는 GPLv3 자유 소프트웨어이며, 커뮤니티 지원은 Telegram 그룹을 통해 제공됩니다. 데이터 전송 표준 RFC 초안이 문서에 포함되어 있습니다.