Add static/embedded wireless regulatory data

Small embedded systems might:
1. Want to get rid of daemons as much as possible (therefore be built without CRDA),
2. Not receive user-space incremental updates but an entire system upgrade (with kernel).

Linux kernel since v4.15 allows loading static regulatory data from /lib/firmware/regulatory.db.

Add additional package to wireless-regdb recipe which provides such static data.

Signed-off-by Krzysztof Kozlowski <[email protected]>

---
 .../wireless-regdb/wireless-regdb_2018.05.31.bb            | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

meta-networking/recipes-connectivity/wireless-regdb/wireless-regdb_2018.05.31.bb +0 -0

index 8bb866ff1281..d40756ff2bbf 100644

meta-networking/recipes-connectivity/wireless-regdb/wireless-regdb_2018.05.31.bb +3 -0

+    install -m 0644 regulatory.db ${D}${nonarch_base_libdir}/firmware/regulatory.db
+    install -m 0644 regulatory.db.p7s ${D}${nonarch_base_libdir}/firmware/regulatory.db.p7s
 }
 
+# Install static regulatory DB in /lib/firmware for kernel to load.

Linux kernels before v4.15, allowed to be compiled with static regulatory dabatase if it was put under net/wireless/db.txt.

Add kernel_wireless_regdb class which allows in such cases to embed the wireless regulatory database directly in the Linux kernel during build process.

Usage:
1. The class should be inherited by kernel recipe (e.g. in linux-yocto_%.bbappend).
2. For Linux kernels up to v4.14, build kernel with CONFIG_EXPERT and CONFIG_CFG80211_INTERNAL_REGDB.

Signed-off-by Krzysztof Kozlowski <[email protected]>

---
 meta-networking/classes/kernel_wireless_regdb.bbclass         | 11 +++++++++++
 .../wireless-regdb/wireless-regdb_2018.05.31.bb               | 10 ++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 meta-networking/classes/kernel_wireless_regdb.bbclass

meta-networking/classes/kernel_wireless_regdb.bbclass new file +11 -0

new file mode 100644
index 000000000000..a1eb4c532667
@@ -0,0 +1,11 @@
+# Copies the regulatory plaintext database to kernel sources before compiling.
+# Linux kernel must be compiled with CONFIG_CFG80211_INTERNAL_REGDB to use it.
+
+DEPENDS += "wireless-regdb-native"
+
+SRCTREECOVEREDTASKS += "do_kernel_add_regdb"
+do_kernel_add_regdb() {
+    cp ${STAGING_LIBDIR_NATIVE}/crda/db.txt ${S}/net/wireless/db.txt
+}
+do_kernel_add_regdb[dirs] = "${S}"
+addtask kernel_add_regdb before do_build after do_configure

meta-networking/recipes-connectivity/wireless-regdb/wireless-regdb_2018.05.31.bb +1 -0

index d40756ff2bbf..0b7930718761 100644
@@ -23,6 +23,7 @@ do_install() {
 
 # Install static regulatory DB in /lib/firmware for kernel to load.
 # This requires Linux kernel >= v4.15.
+# For kernel <= v4.14, inherit the kernel_wireless_regdb.bbclass in kernel's recipe.
 PACKAGES =+ "${PN}-static"
 RCONFLICTS_${PN} = "${PN}-static"
 

meta-networking/recipes-connectivity/wireless-regdb/wireless-regdb_2018.05.31.bb +5 -0

+    install -m 0644 db.txt ${D}${libdir}/crda/db.txt
+}
+
 RSUGGESTS_${PN} = "crda"
+
+BBCLASSEXTEND = "native"

Quoted 7 lines · Krzysztof Kozlowski

Linux kernels before v4.15, allowed to be compiled with static regulatory dabatase if it was put under net/wireless/db.txt.

Add kernel_wireless_regdb class which allows in such cases to embed the wireless regulatory database directly in the Linux kernel during build process.

Quoted 5 lines

Usage:
1. The class should be inherited by kernel recipe (e.g. in linux-yocto_%.bbappend).
2. For Linux kernels up to v4.14, build kernel with CONFIG_EXPERT and CONFIG_CFG80211_INTERNAL_REGDB.

I think it will be good to add this in comments in bbclass as well.

Quoted 42 lines

Signed-off-by Krzysztof Kozlowski <[email protected]>

---
 meta-networking/classes/kernel_wireless_regdb.bbclass         | 11 +++++++++++
 .../wireless-regdb/wireless-regdb_2018.05.31.bb               | 10 ++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 meta-networking/classes/kernel_wireless_regdb.bbclass

meta-networking/classes/kernel_wireless_regdb.bbclass new file +11 -0

new file mode 100644
index 000000000000..a1eb4c532667
@@ -0,0 +1,11 @@
+# Copies the regulatory plaintext database to kernel sources before compiling.
+# Linux kernel must be compiled with CONFIG_CFG80211_INTERNAL_REGDB to use it.
+
+DEPENDS += "wireless-regdb-native"
+
+SRCTREECOVEREDTASKS += "do_kernel_add_regdb"
+do_kernel_add_regdb() {
+    cp ${STAGING_LIBDIR_NATIVE}/crda/db.txt ${S}/net/wireless/db.txt
+}
+do_kernel_add_regdb[dirs] = "${S}"
+addtask kernel_add_regdb before do_build after do_configure

meta-networking/recipes-connectivity/wireless-regdb/wireless-regdb_2018.05.31.bb +1 -0

index d40756ff2bbf..0b7930718761 100644
@@ -23,6 +23,7 @@ do_install() {
 
 # Install static regulatory DB in /lib/firmware for kernel to load.
 # This requires Linux kernel >= v4.15.
+# For kernel <= v4.14, inherit the kernel_wireless_regdb.bbclass in kernel's recipe.
 PACKAGES =+ "${PN}-static"
 RCONFLICTS_${PN} = "${PN}-static"
 

@@ -31,4 +32,13 @@ FILES_${PN}-static = " \
     ${nonarch_base_libdir}/firmware/regulatory.db.p7s \
 "
 

meta-networking/recipes-connectivity/wireless-regdb/wireless-regdb_2018.05.31.bb FILES_${PN}-static = " \ · line 38

Quoted 4 lines

meta-networking/recipes-connectivity/wireless-regdb/wireless-regdb_2018.05.31.bb +4 -0

+# Native users might want to use the source of regulatory DB.
+# This is for example used by Linux kernel <= v4.14 and kernel_wireless_regdb.bbclass.
+do_install_append_class-native() {
+    install -d -m 0755 ${D}${libdir}/crda

add -D to below cmd and you can avoid this line.