Rtl8822cs sdio board on M5

Does someone experiments this board on M5 with the last ARMBIAN binary. It seems that the dts for wifi port description is not present. The wlan does’nt appear in ifconfig.

You talking about the add-on M5 specific wifi/bluetooth adapter? I got it working and posted about how to do it a few minutes ago.

here’s the summary of the other post:

modify /boot/boot.ini by modifying the following line (typically line 96) and add the wifi_bt_rtl8822cs driver overlay:

 setenv overlays "i2c0 spi0 uart1 wifi_bt_rtl8822cs"

update /etc/modules to load driver at boot:

sudo echo “88x2cs” >> /etc/modules-load.d/modules.conf

load driver immediately without need for reboot:

modprobe 88x2cs


thanks for your post, I did’nt got issue to start WIFI on M5 with the BANANA PI distro available on there site, I did like you describe. The problem I experiments is the stability of wifi driver which disconnects randomly all station. So I try with the last build on the ARMBIAN site. the last version 6.1.x boot fine but unfortunatly on these builds the DTB does not describe the wifi RTL8822 board and the overlay is not there. On top the structure of the DTB change on ARMBIAN version so the overlay for the board available on old banana distro is incompatible. The M2 PRO with the wifi on board works perfectly with the last ARMBIAN distro. Gerard

There is an instruction what to do to get wifi working https://www.armbian.com/bananapi-m5/


I download the last build :


Has you can see in the README.meson-overlays file there is no trace of the rtl8822 board overlay :

This document describes overlays provided in the kernel packages For generic Armbian overlays documentation please see https://docs.armbian.com/User-Guide_Allwinner_overlays/


meson (Amlogic)

Provided overlays:

  • i2c8

Overlay details:


Activates TWI/I2C bus 8

I2C8 pins (SCL, SDA): GPIO1-C4, GPIO1-C5

and there are no file about this board in the directory :

[email protected]:/media/gerard/armbi_root/boot/dtb-6.1.11-meson64/amlogic/overlay$ ls -l total 36 -rwxr-xr-x 1 root root 232 févr. 18 01:07 meson-fixup.scr

-rwxr-xr-x 1 root root 377 févr. 18 01:07 meson-g12-gxl-cma-pool-896MB.dtbo

-rwxr-xr-x 1 root root 343 févr. 18 01:07 meson-i2cA.dtbo

-rwxr-xr-x 1 root root 343 févr. 18 01:07 meson-i2cB.dtbo

-rwxr-xr-x 1 root root 238 févr. 18 01:07 meson-uartA.dtbo

-rwxr-xr-x 1 root root 238 févr. 18 01:07 meson-uartC.dtbo

-rwxr-xr-x 1 root root 759 févr. 18 01:07 meson-w1AB-gpio.dtbo

-rwxr-xr-x 1 root root 490 févr. 18 01:07 meson-w1-gpio.dtbo

-rwxr-xr-x 1 root root 339 févr. 18 01:07 README.meson-overlays

[email protected]:/media/gerard/armbi_root/boot/dtb-6.1.11-meson64/amlogic/overlay$

so except if the device description is in the board dtb (difficult to see) or if I did’nt understand something , I don’t see how the boot could load the device description.

Did you boot this version on an M5 with tis board ?




I know quite well the procedure (you give) to declare the board and use it for the old version of armbian (the one available on the BANANA-PI site and it works , but the driver or the OS are buggy and the driver drops all the station randomly and is not reliable. It’s why I try the last release on the ARMBIAN 23.02.2. On this distrib the boot sequence change and there are no more overlay for the wifi board.

regards Gerard

Its not overlay, but different DT file

add this to /boot/armbianEnv.txt



I will test that next week. does that means that “fdtfile=amlogic/meson-sm1-bananapi-m2-pro.dtb” is missing in /boot/armbianEnv.txt ? and why to boot M5 with M2-pro dtb file ?


It seems like anything past the ancient 4.9 kernel goes bonkers and it’s one of the reasons I replaced the m5 with a genuine rpi. the initial cost savings has not and is not worth the headache of this little board that “could have…”. My wifi dongle drops in and out on 5.x kernels on this thing too. Frustrating…

Sidenote: How did you even get that image to boot though? I’ve been unsuccessful 10 times trying to get any of those to even boot.


You can get the file on https://www.armbian.com/bananapi-m5/ and linux boots fine on M5 but does’nt recognize the 8822cs board. I will test next week the propose setup of Igor.


I might overlook this. You have M5 with wifi on board? That is something different and might not work OOB if wired in some different way that M2 Pro … anyway, worth trying.

https://wiki.banana-pi.org/Banana_Pi_BPI-M5#Armbian try this 2023-01-31 relase images, the driver seems not stable, but works.

you shoud add rtl8822cs to overlay in /boot/armbianEnv.txt, default is not enable.

@igor the rtl8822cs board is connected on the gpio connector and works with the sdio protocol. Gerard


I confirm that 8822cs wifi external board on gpio connector is not recognized by

Armbian_23.02.2_Bananapim5_bullseye_current_6.1.11_minimal.img with
explicit fdtfile=amlogic/meson-sm1-bananapi-m2-pro.dtb or fdtfile=amlogic/meson-sm1-bananapi-m5.dtb

in armbianEnv.txt.

Both boots fine.


official armbian only support the bananapi m2pro onboard 8821cu or 8821cu usb dongle, not support 40pin 8822cs external board.

The upstream Linux 6.2.y kernel supports RTL8822CS in the rtw88 driver and the mezzanine has been tested (working fine) with M5 and M2S boards. Older Linux kernels require the vendor driver or a pile of rtw88 patches need backporting. The following patch prepares support for the mezzanine board. You only need to enable the sd_emmc_a and uart_a nodes through an overlay or fdtput.

From a custom Linux image (not Armbian) - dmesg: http://ix.io/4qpF

I download “Welcome to Armbian 23.02.2 Bullseye with Linux 6.1.11-meson64” on M5 with optional RTL8822CS WiFi/BT mezzanine board.

I add “overlays=uartA” in /boot/armbianEnv.txt there is no dtb file for sd_mmc_a in overlay directory (see list in my previous post) I add the module 88x2cs in /etc/modules. I reboot and the wifi interface is not there in ifconfig.

Does some one sees this config working with this software and if yes how to configure it ? thanks for your help. Gerard