Skip to content

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IEEE 802.11p/bd Linux Driver Suite

This repository provides instructions and build guides to enable IEEE 802.11p (and experimental IEEE 802.11bd) functionality on devices using ath9k- and ath10k- based devices. It covers a variety of platforms including Raspberry Pi, NVIDIA Jetson, and generic x86 systems, offering kernel patches, and example setups targetted toward vehicular networking and research applications.


Consider our version of Vanetza, Vanetza-NAP, which significantly facilitates the use of ITS-G5 https://github.com/nap-it/vanetza-nap


Contributions Overview

Below is an overview of the main contributions of this work:

  • ath10k:
    1. Enabled baseline ITS-G5 functionality by building on prior work from HPI Potsdam.
    2. Enabled correct reception of broadcast frames in OCB mode.
    3. Fixed STA state synchronization issues between mac80211 and firmware, which previously caused the first frame transmitted to a new STA to be dropped.
    4. Corrected HTT receive buffer sizing to properly support higher MTUs (up to 2304 bytes).
  • mac80211: Fixed an issue where the first received frame from a STA was dropped in OCB mode (affecting both ath9k and ath10k).
  • mac80211/cfg80211: Reverted multiple upstream commits (with necessary adaptations) affecting more recent kernels, which had removed certain 5/10 MHz channel width functionality.

This work has been published as a paper entitled "A Unified Linux Driver Suite for IEEE 802.11bd and 802.11p for Atheros Chipsets", accepted to the IEEE Vehicular Networking Conference (VNC) 2026, to be held in June 2026. The paper provides a more comprehensive description of the design and implementation choices underlying the enabling of IEEE 802.11p functionality on ath10k-based hardware, along with an extended evaluation of the resulting system. In addition to detailing the required modifications to the Linux networking stack and driver components, it presents further experimental results characterising performance and behaviour under realistic vehicular communication conditions. The study also includes exploratory measurements related to 802.11bd-like operation, offering initial insight into achievable performance when extending legacy 802.11p configurations.

Equipment

Devices

Name / Family Tutorial Link Product Page Product Photo
x86 Tutorial - -
Raspberry Pi 5 Tutorial https://www.raspberrypi.com/products/raspberry-pi-5/ Raspberry Pi 5
NVIDIA Jetson Orin Nano Tutorial https://developer.nvidia.com/embedded/learn/get-started-jetson-orin-nano-devkit NVIDIA Jetson Orin Nano Devkit

Wireless Network Adapters

The following Wi-Fi network adapters have been tested and validated to work correctly in most situations (see individual notes for your target device):

Product Name Chipset Driver Notes Product Page Product Photo
MikroTik R11e-5HnD AR9580 ath9k Possible power limitations (see individual notes for your target device) https://www.mikrotik-store.eu/en/mikrotik-r11e-5hnd MikroTik R11e-5HnD
Compex WLE200NX 7A AR9280 ath9k None https://compex.com.sg/wp-content/uploads/2018/10/wle200nx-hw-guide-v1.pdf Compex WLE200NX 7A
Compex WLE900VX 7CA QCA9890 ath10k None https://compex.com.sg/shop/wifi-module/802-11ac-wave-1/wle900vx-i-wifi5-11ac-qca9880-qca9890/ Compex WLE900VX 7CA

The following network adapters may exhibit limited functionality or may have not been tested yet (see notes bellow):

Product Name Chipset Driver Notes Product Page Product Photo
Compex WLE600VX 7AA QCA9882 ath10k Untested. Probably locked to 20MHz channel width https://compex.com.sg/shop/wifi-module/802-11ac-wave-1/wle600vx-wifi5-11ac-qca9882-qca9892/ Compex WLE600VX 7AA
Compex WLE600VX 7CA QCA9892 ath10k Untested. Should work fine. https://compex.com.sg/shop/wifi-module/802-11ac-wave-1/wle600vx-i-wifi5-11ac-qca9882-qca9892/ Compex WLE600VX 7CA
Compex WLE900VX 7AA QCA9880 ath10k Locked to 20MHz channel width https://compex.com.sg/shop/wifi-module/802-11ac-wave-1/wle900vx-wifi5-11ac-qca9880-qca9890/ Compex WLE900VX 7AA
MikroTik R11e-5HacT QCA9880 ath10k Locked to 20MHz channel width. Possible TX power issues caused by insufficient power delivery (see individual notes for your target device) https://mikrotik.com/product/R11e-5HacT MikroTik R11e-5HacT

Credits / References

Contributors:

License

linux-11p-bd-suite is licensed under LGPLv3, see license file for details.

About

This repository provides instructions and build guides to enable IEEE 802.11p (and experimental IEEE 802.11bd) functionality on devices using ath9k- and ath10k- based devices. It supports Raspberry Pi, NVIDIA Jetson, and generic x86 systems, offering kernel patches, and example setups targetted toward vehicular networking and research applications.

Resources

Stars

4 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors