====== wireless-regdb Singapore Updates ======

===== Prerequisites =====

  * Linux with git installed (guide is written with Linux in mind)
  * Configure your email and name for the commit and commit sign-off:\\ <code bash>git config --global user.email "you@example.org"
git config --global user.name "Your Name"</code>
  * [[https://git-send-email.io/|Set up git send-email]]

===== Updating wireless-regdb and Submitting a Patch =====

  - Check latest IMDA TS SRD on [[https://www.imda.gov.sg/regulations-and-licensing-listing/ict-standards-and-quality-of-service/telecommunication-and-security-standards/radio-communication-equipment-standards|IMDA Radio-communication Equipment Standards]]
  - Clone wireless-regdb:\\ ''git clone %%https://git.kernel.org/pub/scm/linux/kernel/git/wens/wireless-regdb.git%% && cd wireless-regdb''
  - Open ''db.txt'' in a text editor:\\ ''$EDITOR db.txt''
  - Find ''country SG: DFS-FCC''
  - Make your changes and don't forget to update the relevant comments above the SG block with appropriate reference to the TS SRD
  - Exit $EDITOR
  - Double-check your changes:\\ ''git diff HEAD~1''
  - Build test:\\ ''make clean && make''
    * You may have to install M2Crypto e.g. ''dnf install python3-m2crypto'' on Fedora
    * To functionality test on OpenWrt, see [[projects:software:openwrt_custom_wireless-regdb|]]
  - Add the changed file:\\ ''git add db.txt''
  - Commit:\\ ''git commit -s''
    * Commit title/first line: "Update regulatory rules for Singapore (SG) for [MONTH] [YEAR]" or refer to [[https://lists.infradead.org/pipermail/wireless-regdb/|wireless-regdb list archives]] for appropriate subjects
    * Describe your motivations (if relevant), what was changed, and references to authoritative texts; in most situations this would be excerpts from the comments made in ''db.txt''
  - Double-check your commit message:\\ ''git log -n1''
  - Generate a patch from your commit: \\ ''git format-patch HEAD~1''
  - Send patch to mailing list (dry run):\\ ''git send-email %%--%%dry-run %%--%%to=linux-wireless@vger.kernel.org %%--%%cc=wireless-regdb@lists.infradead.org *.patch''
    * Verify that only one patch is in the first line of output and it is the intended patch to send, otherwise replace ''*.patch'' with the specific one you wanted to send
    * Verify the **Subject:** line
    * Verify the **From:**, **To:**, **CC:** lines
  - When you are happy, run the same command as above, removing the ''%%--%%dry-run'' argument
  - Check the [[https://lists.infradead.org/pipermail/wireless-regdb/|wireless-regdb list archives]] to confirm your patch has been received

===== References =====

  * [[https://wireless.wiki.kernel.org/en/developers/regulatory/wireless-regdb]]