SynoKernel WiFi¶
Experimental, at your own risk
The kernel modules of SynoCommunity packages are outside of what Synology supports: a module that does not suit the kernel can crash the NAS, and DSM updates may break them. Support is limited: read this documentation, and check the issues already open, before opening one. Do not use them on a NAS you cannot afford to restart or recover.
Provides drivers of USB WiFi adapters for DSM 6 and DSM 7, with the wireless
stack of the Linux kernel, cfg80211 and mac80211. DSM 7 kernels are built
without it, as Synology dropped WiFi adapters from DSM 7; on DSM 6 the package
adds adapters DSM does not support. SRM is not supported: the router has its
own wireless stack.
Package Information¶
| Property | Value |
|---|---|
| Package Name | synokernel-wifi |
| License | GPLv2 |
| Dependencies | SynoCli Kernel Tools 2.1 or newer (module loading and device profiles), SynoCli WiFi Tools (connection) |
Included Drivers¶
| Profile | Chips | Adapters |
|---|---|---|
rtl88x2bu |
Realtek RTL8812BU, RTL8822BU | TP-Link Archer T3U, T3U Plus, T4U v3, ASUS USB-AC55 B1, D-Link DWA-181/182/183, Netgear A6150 |
rt2800usb |
Ralink RT2770 to RT5372 | Panda PAU05/PAU06, Alfa AWUS036NH |
rtl8192cu |
Realtek RTL8188CUS, RTL8192CU | Edimax EW-7811Un and other nano adapters |
rtl8xxxu |
Realtek RTL8188EU, RTL8192EU, RTL8723BU | kernels 4.4 and newer |
mt7601u |
MediaTek MT7601U | 150 Mbps nano adapters, kernels 4.4 and newer |
mt76x0u, mt76x2u |
MediaTek MT7610U, MT7612U | Alfa AWUS036ACM, TP-Link Archer T2U v1, kernels 5.10 |
ath9k_htc |
Atheros AR9271, AR7010 | TP-Link TL-WN722N v1, Alfa AWUS036NHA, kernels with LED triggers |
carl9170 |
Atheros AR9170 | Netgear WN111 v2, TP-Link TL-WN821N v2 |
rtl8821cu |
Realtek RTL8811CU, RTL8821CU | |
rtl8821au |
Realtek RTL8811AU, RTL8821AU | kernels 4.4 and newer |
rtl8812au |
Realtek RTL8812AU | kernels 4.4 and newer |
rtl8814au |
Realtek RTL8814AU | kernels 4.4 and newer |
rtw88-8822bu, rtw88-8821cu, rtw88-8822cu, rtw88-8723du, rtw88-8812au, rtw88-8821au, rtw88-8814au |
Realtek RTL8822BU, RTL8821CU, RTL8822CU, RTL8723DU, RTL8812AU, RTL8821AU, RTL8814AU | kernels 5.10 |
The rtl88x2bu, rtl8821cu, rtl8821au, rtl8812au and rtl8814au profiles
load the drivers of the Linux community for
these Realtek chips; rtw88-* load rtw88,
the mac80211 driver of the same chips in recent kernels, built out of tree.
For a chip both cover, load one profile or the other, not both. The others are
the drivers of each kernel, so newer kernels offer more of them. synocli-kernelmodule list tells which profiles
the kernel of the NAS can load. The firmware they need comes from
linux-firmware.
Wireless extensions (iwconfig) are not available: they are part of the
kernel itself. Adapters are set up through nl80211, with iw and
wpa_supplicant.
Usage¶
The modules are not loaded on installation: load those of your adapter, as
root, with sudo -i in front (sudo alone does not find the commands of packages), with the
synocli-kernelmodule helper of SynoCli Kernel Tools:
iw dev names the interface of the adapter, usually wlan0.
Connecting to a network¶
SynoCli WiFi Tools connects the NAS, a dependency of
this package: its synocli-wifi command and a profile per network, written by its
installation wizard or by synocli-wifi new:
sudo -i synocli-kernelmodule --profile rtl88x2bu start
sudo -i synocli-wifi --profile MyNetwork start
Regulatory domain¶
The kernel starts in the world regulatory domain, which leaves out most 5 GHz
channels. The country of a profile of synocli-wifi sets it; by hand, here for Canada:
The rules come from wireless-regdb:
regulatory.db on kernels 4.15 and newer, compiled into cfg80211 on older
ones, so no CRDA is needed.