Skip to content

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:

synocli-kernelmodule list
sudo -i synocli-kernelmodule --profile rtl88x2bu start
sudo -i iw dev

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:

sudo -i iw reg set CA
sudo -i iw reg get

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.