User Tools

Site Tools


en:developers:documentation:nl80211

About nl80211

nl80211 is the new 802.11 netlink interface public header. Together with cfg80211 it is intended to replace Wireless-Extensions. nl80211 and cfg80211 are still under development.

Users of nl80211

Current users of nl80211:

libnl tiny

OpenWrt folks created a tiny version of libnl based on a git snapshot, which only contains genl, not rtnetlink or any of the netfilter stuff, and compiles down to less than 30k in binary size. You can find it here:

https://git.openwrt.org/?p=openwrt/openwrt.git;a=tree;f=package/libs/libnl-tiny;hb=HEAD

Kerneldoc for nl80211

testmode (CONFIG_NL80211_TESTMODE=y)

The nl80211 testmode command helps implementing things like factory calibration or validation tools for wireless chips.

This functionality could possibly be used for SAR testing (Specific Absorption Rate), MPE testing (Maximum Permissible Exposure), RF testing (Radio Frequency), as possibly requested by institutions such as FCC.

According to kernelnewbies.org Linux_2_6_32, testmode has been introduced by nicely described commit aff89a9b90849.

This setting is currently provided by net/wireless/Kconfig.

For a way to determine whether a wireless driver actually supports nl80211 testmode interface, see [PATCH] nl80211: add testmode to the list of supported commands.

Current users of the testmode interface are:

TODO: could list (references to) ready-made scripts which implement nicely automated / elegant workflows for SAR testing etc.

For ATH9K chipsets, there's SAR testing functionality provided via the non-testmode setting CONFIG_ATH9K_TX99. Hmm, this possibly needs conversion to (additionally?) providing the generic nl80211 testmode functionality?

vendor-specific API

Under the NL80211_CMD_VENDOR command, there's the ability to register vendor-specific behavior. For a long time, we've explicitly rejected these upstream, but after many discussions some may be allowed, subject to (at least) the following constraints:

  1. Upstream vendor commands shall not replace existing functionality.
  2. The submitter shall consider a pure nl80211 implementation and explain the reasoning against it in the commit message.
  3. Example users/use cases of the API shall be documented.
  4. The newly proposed API shall be subject to stable API rules.
  5. Unless the data inside NL80211_ATTR_VENDOR_DATA is just an opaque blob not used by the driver (but e.g. by firmware), sub-attributes shall be used inside of it, and those shall be documented.
  6. Vendor command and sub-attribute definitions shall be in a common header file location (TBD, e.g. include/uapi/nl80211-vnd-*.h)
  7. Patches introducing such commands shall be submitted separately, not “buried” in big driver patchsets. Give them a “wifi: nl80211: vendor-cmd: ” prefix to make them easily identifiable.

The goal with these rules is to enable use of vendor commands in a fashion that is transparent enough to allow later reuse by other components with similar needs, and then potentially defining “real” nl80211 API for the use case in question.

en/developers/documentation/nl80211.txt · Last modified: 2024/02/27 19:24 by Johannes Berg