====== OpenWrt Custom wireless-regdb ======

Note: Do not use the patch below if you are in Singapore, as wireless-regdb is now maintained once again and updated Singapore regulatory rules have been released.


This information is just provided for reference in case one needs to test changes to wireless-regdb on an OpenWrt wireless AP.
===== Motivation =====

As wireless-regdb had[[http://lists.infradead.org/pipermail/wireless-regdb/2023-May/001439.html|no]] [[https://wireless.wiki.kernel.org/en/developers/regulatory/wireless-regdb#sending_updates_to_the_regulatory_database#sending_updates_to_the_regulatory_database|maintainer]] it was unlikely that [[http://lists.infradead.org/pipermail/wireless-regdb/2023-September/001454.html|my Wi-Fi 6E regulatory updates for Singapore]] would propagate to Linux distributions anytime soon (as of the September 2023 IMDA TS SRD release).

Thankfully, it is pretty straightforward to set up a functional Wi-Fi 6E network, as only the Access Point requires a regulatory update, while stations (clients) do not. This is because the regulatory framework restricts [[https://wireless.wiki.kernel.org/en/developers/regulatory/processing_rules#beacon_hints|the initiation of radiation (beacons)]], while clients are free to connect to any frequency the hardware is able to receive beacons on (even if it cannot initiate radiation on that frequency).

===== I Am Lazy and Trusting =====

Running OpenWrt 23.05.2? Here is my prebuilt package using the steps below (Option B): {{ :projects:software:wireless-regdb_2023-09-03-ab7ed562-1_all.ipk |}}

  - ''ssh root@YOUR_ROUTER_IP''
  - ''opkg install %%http://ndoo.sg/_media/projects:software:wireless-regdb_2023-09-03-ab7ed562-1_all.ipk%%''
  - ''reboot''

===== Building a Custom wireless-regdb Package =====

==== Prerequisite - Prepare OpenWrt Build Environment ====

  - Install [[https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem|OpenWrt build prerequisites]]
  - Clone OpenWrt source (adjust branch as needed, depending on what you're running):\\ ''%%git clone --depth=1 --branch v23.05.2 https://github.com/openwrt/openwrt.git%%''
  - Configure the build:\\ ''make menuconfig''
    - Target system: ''x86'' (or respective to the computer you are building on) to save CPU time by not having to cross-compile (the wireless-regdb package is noarch)
    - Target profile: ''Generic x86'' (this is the default)
    - Firmware → wireless-regdb → ''<M>''
    - Exit and save
  - Build tools and toolchain (this will take ~30 min, depending on your CPU performance):\\ ''make -j$(getconf _NPROCESSORS_ONLN) tools/install''\\ ''make -j$(getconf _NPROCESSORS_ONLN) toolchain/install''

==== Option A - Quick and Dirty - Using a Patch ====

This is quick and dirty because (1) it generates a package with the same version number (unless you update the Makefile metadata) and (2) it will break with a change in wireless-regdb releases that change db.txt or (3) the patch series that comes with OpenWrt.

This was only tested on OpenWrt=v23.05.2 and wireless-regdb=2023.09.01.

  - Download the snippet below to your cloned OpenWrt repo (it goes in ''package/firmware/wireless-regdb/patches/''):\\ <file diff package/firmware/wireless-regdb/patches/999-SG-regd-2023-sep.patch>
Index: wireless-regdb-2023.09.01/db.txt
===================================================================
--- wireless-regdb-2023.09.01.orig/db.txt
+++ wireless-regdb-2023.09.01/db.txt
@@ -1584,25 +1584,27 @@ country SE: DFS-ETSI
 	# 60 GHz band channels 1-4 (ETSI EN 302 567)
 	(57000 - 66000 @ 2160), (40)
 
-# https://www.imda.gov.sg/-/media/Imda/Files/Regulation-Licensing-and-Consultations/ICT-Standards/Telecommunication-Standards/Radio-Comms/IMDATSSRD.pdf
-# IMDA TS SRD, Issue 1 Revision 1, April 2019, subsequently "IMDA TS SRD"
-# 2400 - 2483.5 MHz: IMDA TS SRD, Table 1 (25); ANSI C63.10-2013 and FCC Part 15 Section 15.247 or EN 300 328
-# 5150 - 5350 MHz: IMDA TS SRD, Table 1 (29); FCC Part 15 Section 15.407 (1) 5.15-5.25 GHz (2) 5.25-5.35 GHz; EN 301 893
-# 5470 - 5725 MHz: IMDA TS SRD, Table 1 (30); FCC Part 15 Section 15.407 (2) 5.47-5.725 GHz; EN 301 893
-# 5725 - 5850 MHz: IMDA TS SRD, Table 1 (27); FCC Part 15 Section 15.247; FCC Part 15 Section 15.407 (3) 5.725-5.85 GHz
-# 57000 - 66000 MHz: IMDA TS SRD, Table 1 (31); ETSI EN 302 567
-# Note: 27dBm for 5470-5725MHz bands is 3dBm reduction per FCC Part 15 Section 15.407 (2) 5.47-5.725 GHz; EN 301 893 as referenced by IMDA TS SRD
+# https://www.imda.gov.sg/-/media/imda/files/regulation-licensing-and-consultations/ict-standards/telecommunication-standards/radio-comms/imdatssrd.pdf
+# IMDA TS SRD, Issue 1 Revision 3, Sep 2023, subsequently "IMDA TS SRD"
+# 2400 - 2483.5 MHz: IMDA TS SRD, Table 1 Sub-band 32e
+# 5150 - 5350 MHz: IMDA TS SRD, Table 1 Sub-band 33a
+# 5470 - 5725 MHz: IMDA TS SRD, Table 1 Sub-band 34
+# 5725 - 5850 MHz: IMDA TS SRD, Table 1 Sub-band 35
+# 5945 - 6425 MHz: IMDA TS SRD, Table 1 Sub-band 45b
+# 57000 - 66000 MHz: IMDA TS SRD, Table 1 Sub-band 40
+# Note: 500mW for 5470-5725MHz bands per FCC Part 15 Section 15.407 (2) 5.47-5.725 GHz as referenced by IMDA TS SRD
 #  AU and BG regulatory domains use the same interpretation of cited FCC and ETSI standards
-# Note: The transmit power for 5250-5350MHz bands can be raised by 3dBm when TPC is implemented: IMDA TS SRD Table 1 (29)
-# Note: The transmit power for 5470-5725MHz bands can be raised by 3dBm when TPC is implemented: IMDA TS SRD Table 1 (30)
+# Note: The transmit power for 5250-5350MHz bands can be raised by 3dBm when TPC is implemented: IMDA TS SRD, Table 1 Sub-band 33a
+# Note: The transmit power for 5470-5725MHz bands can be raised by 3dBm when TPC is implemented: IMDA TS SRD Table 1 Sub-band 34
 
 country SG: DFS-FCC
-	(2400 - 2483.5 @ 40), (23)
-	(5150 - 5250 @ 80), (23), AUTO-BW
-	(5250 - 5350 @ 80), (20), DFS, AUTO-BW
-	(5470 - 5725 @ 160), (27), DFS
-	(5725 - 5850 @ 80), (30)
-	(57000 - 66000 @ 2160), (40)
+	(2400 - 2483.5 @ 40), (200 mW)
+	(5150 - 5250 @ 80), (200 mW), AUTO-BW
+	(5250 - 5350 @ 80), (100 mW), DFS, AUTO-BW
+	(5470 - 5725 @ 160), (500 mW), DFS, AUTO-BW
+	(5725 - 5850 @ 80), (1000 mW), AUTO-BW
+	(5945 - 6425 @ 320), (250 mW), NO-OUTDOOR
+	(57000 - 66000 @ 2160), (10000 mW)
 
 # SI as part of EU/CEPT accepted decisions 2005/513/EC (5GHz RLAN, EN 301 893)
 # and 2006/771/EC (amended by 2008/432/EC, Short-Range Devices, EN 300 440)</file>
  - ''make package/firmware/wireless-regdb/{clean,compile} V=s''
  - Locate your freshly baked package:\\ ''$ ls bin/packages/*/base/wireless-regdb*.ipk''\\ ''bin/packages/powerpc_8548/base/wireless-regdb_2023.09.01-1_all.ipk''

==== Option B - Cleaner - Using Our Own wireless-regdb Repository ====

This is cleaner because the generated package version will track both the source commit ID and date, making it unambigious which package you have installed.

=== Make Changes to wireless-regdb's regulatory.txt ===

Long way:

  - Clone [[https://git.kernel.org/pub/scm/linux/kernel/git/sforshee/wireless-regdb.git|wireless-regdb Git]]
  - Apply [[http://lists.infradead.org/pipermail/wireless-regdb/2023-September/001454.html|[wireless-regdb] [PATCH] wireless-regdb: Update regulatory rules for Singapore (SG) for September 2023]]
  - Upload the source somewhere

Short way:

  - [[https://github.com/ndoo/wireless-regdb|My GitHub repo]]

=== Building wireless-regdb Package from Our Custom Repo ===

The proper way to do this would be to create a new OpenWrt package with a different name, e.g. wireless-regdb-sg6e that provides wireless-regdb, but we just want quick and dirty hack for Wi-Fi 6E enablement while waiting for wireless-regdb's next release, we can just edit the existing wireless-regdb Makefile to pull from our Git repo with the changes we want.


  - Download the snippet below to your cloned OpenWrt repo and run ''git apply wireless-regdb-sg.patch'' (or just patch it by hand):\\ <file diff wireless-regdb-sg.patch>
diff --git a/package/firmware/wireless-regdb/Makefile b/package/firmware/wireless-regdb/Makefile
index dfff35f..2430532 100644
--- a/package/firmware/wireless-regdb/Makefile
+++ b/package/firmware/wireless-regdb/Makefile
@@ -1,12 +1,13 @@
 include $(TOPDIR)/rules.mk
 
 PKG_NAME:=wireless-regdb
-PKG_VERSION:=2023.09.01
 PKG_RELEASE:=1
 
-PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.xz
-PKG_SOURCE_URL:=@KERNEL/software/network/wireless-regdb/
-PKG_HASH:=26d4c2a727cc59239b84735aad856b7c7d0b04e30aa5c235c4f7f47f5f053491
+PKG_SOURCE_URL:=https://github.com/ndoo/wireless-regdb
+PKG_SOURCE_PROTO:=git
+PKG_SOURCE_DATE:=2023-09-03
+PKG_SOURCE_VERSION:=ab7ed5625f21f9e9627eb71b213ea5098f25582a
+PKG_MIRROR_HASH:=SKIP
 
 PKG_MAINTAINER:=Felix Fietkau <nbd@nbd.name>

</file>\\ (You may have to add/remove a newline if you are getting an error during apply, due to DokuWiki limitations)\\ To use your own wireless-regdb repo, change the following variables:
    * PKG_SOURCE_URL - Git repo URL
    * PKG_SOURCE_VERSION - Git commit hash
    * PKG_SOURCE_DATE - Git commit date
  - Download the custom wireless-regdb:\\ ''make package/firmware/wireless-regdb/download V=s''
  - Fix the hash in the makefile:\\ ''make package/firmware/wireless-regdb/check V=s FIXUP=1''
  - Build wireless-regdb:\\ ''make package/firmware/wireless-regdb/compile''
  - Locate your freshly baked package:\\ ''$ ls bin/packages/*/base/wireless-regdb*.ipk''\\ ''bin/packages/powerpc_8548/base/wireless-regdb_2023-09-03-ab7ed562-1_all.ipk''


===== Installing your Custom wireless-regdb Package =====

  - Copy the package to your AP:\\ ''scp -O bin/packages/*/base/wireless-regdb*.ipk root@YOUR_ROUTER_IP:/tmp/''
  - Install the package on your AP:\\ ''ssh root@YOUR_ROUTER_IP''\\ ''opkg install %%--%%force-downgrade /tmp/wireless-regdb*.ipk''
  - Reboot your AP:\\ ''ssh root@YOUR_ROUTER_IP''\\ ''reboot''
  - Try out your updated regulatory rules!

===== Notes =====

  * I tested this with an [[https://asiarf.com/product/wi-fi-6e-mini-pcie-module/|AsiaRF AW7916-NPD]], which is relatively well-supported in OpenWrt with packages ''kmod-mt7915e kmod-mt7916-firmware''