RV1126 24PIN Configuration (CAM126 with 24PIN Expansion Board)

When the same CAM126B-P-24 expansion board is connected to RV1126 (CAM126) through a 24PIN 0.5mm FPC cable, the hardware signal definition stays the same, but the RV1126 GPIO numbers, SDIO/UART controllers, and device nodes differ from RV1126B-P. The dts and driver must be configured as described on this page.
- SoC: RV1126 / RV1109, Linux 4.19.111
- Expansion board: CAM126B-P-24 (AIC8800D80, SDIO Wi-Fi + UART BT)
- For RV1126B-P configuration, see Wi-Fi / Bluetooth Debugging
- For the RV1126 platform description, see Expansion Board 24PIN - CAM126
1. 24PIN Pin Mapping
| pin | Definition | RV1126 GPIO | RV1126 Mux Function | RV1126B-P GPIO |
|---|---|---|---|---|
| 1 | GND | |||
| 2 | GND | |||
| 3 | VCC5V0 | |||
| 4 | VCC5V0 | |||
| 5 | USB_HOST_DP | Y1 (Ball) | USB Host D+ | |
| 6 | USB_HOST_DM | Y2 (Ball) | USB Host D- | |
| 7 | GND | |||
| 8 | ADKEY_IN0 | E17 (Ball) | SARADC_IN0 | |
| 9 | GND | |||
| 10 | WIFI_WAKE_HOST | GPIO1_D1 | GPIO | GPIO3_B7 |
| 11 | BT_RST | GPIO3_A5 | GPIO | GPIO6_A1 |
| 12 | BT_WAKE | GPIO3_A6 | GPIO | GPIO6_A2 |
| 13 | BT_WAKE_HOST | GPIO3_A4 | GPIO | GPIO6_A0 |
| 14 | WIFI_REG_ON | GPIO1_D0 | GPIO | GPIO3_B6 |
| 15 | SDIO_D0 | GPIO1_B4 | SDIO func1 | GPIO3_A2 |
| 16 | SDIO_D1 | GPIO1_B5 | SDIO func1 | GPIO3_A3 |
| 17 | SDIO_D2 | GPIO1_B6 | SDIO func1 | GPIO3_A4 |
| 18 | SDIO_D3 | GPIO1_B7 | SDIO func1 | GPIO3_A5 |
| 19 | SDIO_CMD | GPIO1_B3 | SDIO func1 | GPIO3_A1 |
| 20 | SDIO_CLK | GPIO1_B2 | SDIO func1 | GPIO3_A0 |
| 21 | UART0_RTSN | GPIO1_C0 | UART0 func1 | GPIO3_A6 |
| 22 | UART0_TX | GPIO1_C3 | UART0 func1 | GPIO3_B1 |
| 23 | UART0_RX | GPIO1_C2 | UART0 func1 | GPIO3_B0 |
| 24 | UART0_CTSN | GPIO1_C1 | UART0 func1 | GPIO3_A7 |
Source: 1126-1126BP-24pin.xlsx / 1126pin2pin1126BP-GPIO.xlsx
1.1 Platform Comparison
| Item | RV1126 (CAM126) | RV1126B-P |
|---|---|---|
| Kernel | 4.19.111 | 6.1 |
| Architecture | 32-bit ARM (Cortex-A7) | arm64 |
| SDIO controller | &sdio (mmc1, dwmmc@ffc70000) | &sdmmc1 (mmc2) |
| SDIO pins | GPIO1_B2 ~ B7 (func 1) | GPIO3_A0 ~ A5 (func 1) |
| Bluetooth UART | &uart0 → /dev/ttyS0 | &uart2 → /dev/ttyS2 |
| Wi-Fi enable | GPIO1_D0 | GPIO3_B6 |
| Wi-Fi wake | GPIO1_D1 | GPIO3_B7 |
| BT reset | GPIO3_A5 | GPIO6_A1 |
| BT wake / wake host | GPIO3_A6 / GPIO3_A4 | GPIO6_A2 / GPIO6_A0 |
| SDIO enumeration | mmc1: new SDIO card | mmc2: new SDIO card |
- SDIO 1.8V: the SDIO interface on the 24PIN module side is 1.8V, so the VCCIO domain feeding GPIO1 on RV1126 must also be 1.8V. The CAM126 38x38 board defaults to
vccio3 = 3.3V; verify the actual IO domain supply before connecting, and change the voltage or add level shifters if necessary. - S01 DIP switch: 1 / 3 for Wi-Fi / BT, 2 / 4 for TTL.
- UART level: 24PIN-22/23 are 1.8V. Short-term communication with 3.3V has been tested, but level shifters are recommended for long-term use.
2. RV1126 dts Configuration
Add the following nodes to the board dts (for example, rv1126-38x38-v10-emmc.dts). All pins and controllers come from the RV1126 main dtsi; do not copy the 1126B-P sdmmc1 node names.
2.1 Pwrseq and Wireless Nodes
/ {
sdio_pwrseq: sdio-pwrseq {
compatible = "mmc-pwrseq-simple";
pinctrl-names = "default";
pinctrl-0 = <&wifi_enable_h>;
/* 24PIN-14 WIFI_REG_ON */
reset-gpios = <&gpio1 RK_PD0 GPIO_ACTIVE_LOW>;
};
wireless-bluetooth {
compatible = "bluetooth-platdata";
/* 24PIN-21 UART0_RTSN */
uart_rts_gpios = <&gpio1 RK_PC0 GPIO_ACTIVE_LOW>;
pinctrl-names = "default", "rts_gpio";
pinctrl-0 = <&uart0_rtsn>;
pinctrl-1 = <&uart0_rtsn_gpio>;
/* 24PIN-11 BT_RST */
BT,power_gpio = <&gpio3 RK_PA5 GPIO_ACTIVE_HIGH>;
/* 24PIN-12 BT_WAKE */
BT,wake_gpio = <&gpio3 RK_PA6 GPIO_ACTIVE_HIGH>;
/* 24PIN-13 BT_WAKE_HOST */
BT,wake_host_irq = <&gpio3 RK_PA4 GPIO_ACTIVE_HIGH>;
status = "okay";
};
};
/*
* The CAM126 board dts already defines wireless_wlan (for USB Wi-Fi),
* so override it here. If your board dts has no such node, add a
* wireless-wlan node under the root node instead.
*/
&wireless_wlan {
wifi_chip_type = "aic8800";
/delete-property/ WIFI,poweren_gpio;
pinctrl-names = "default";
pinctrl-0 = <&wifi_wake_host>;
/* 24PIN-10 WIFI_WAKE_HOST */
WIFI,host_wake_irq = <&gpio1 RK_PD1 GPIO_ACTIVE_HIGH>;
status = "okay";
};
&pinctrl {
sdio-pwrseq {
wifi_enable_h: wifi-enable-h {
rockchip,pins = <1 RK_PD0 RK_FUNC_GPIO &pcfg_pull_none>;
};
};
wireless-wlan {
wifi_wake_host: wifi-wake-host {
rockchip,pins = <1 RK_PD1 RK_FUNC_GPIO &pcfg_pull_up>;
};
};
wireless-bluetooth {
uart0_rtsn_gpio: uart0-rtsn-gpio {
rockchip,pins = <1 RK_PC0 RK_FUNC_GPIO &pcfg_pull_none>;
};
};
};
2.2 Enabling SDIO and UART0
&sdio {
max-frequency = <200000000>;
bus-width = <4>;
cap-sd-highspeed;
cap-sdio-irq;
keep-power-in-suspend;
non-removable;
supports-sdio;
rockchip,default-sample-phase = <90>;
sd-uhs-sdr104;
mmc-pwrseq = <&sdio_pwrseq>;
status = "okay";
};
&uart0 {
status = "okay";
pinctrl-names = "default";
pinctrl-0 = <&uart0_xfer &uart0_ctsn &uart0_rtsn>;
};
- The RV1126
&sdionode already defaults topinctrl-0 = <&sdio_clk &sdio_cmd &sdio_bus4>, which are GPIO1_B2 ~ B7. You do not need to list the pins again. - The CAM126 board dts already defines a
wireless_wlannode (for USB Wi-Fi); the example overrides it with&wireless_wlan. If your board dts has no such node, add awireless-wlannode under the root node instead. uart0_xfer/uart0_ctsn/uart0_rtsnare defined inrv1126-pinctrl.dtsiand map to GPIO1_C2/C3, C1, and C0 respectively.- The console defaults to
uart2(ttyFIQ0), souart0is free for Bluetooth. - If the base board already uses GPIO1_B2 ~ B7 or GPIO1_C0 ~ C3, release the original functions first.
2.3 Kernel Configuration
CONFIG_CFG80211=y
CONFIG_CFG80211_WEXT=y
CONFIG_MAC80211=m
CONFIG_RFKILL=y
CONFIG_MMC=y
CONFIG_MMC_DW=y
CONFIG_MMC_DW_ROCKCHIP=y
CONFIG_MODULES=y
rv1126_defconfig already includes MMC / RFKILL; CFG80211 / MAC80211 are =m in the board config fragments, so keep them as they are.
3. Driver Matching
The RV1126 SDK does not include the AIC8800 driver. Integrate the AIC driver package yourself:
| Item | Value |
|---|---|
| Driver package | aic8800d_linux_sdk_V5.0_2026_0509_2195ae36 |
| Driver directory | SDIO/driver_fw/driver/aic8800 |
| Firmware directory | SDIO/driver_fw/fw/aic8800D80 |
| SDIO ID | vendor 0xc8a1, device 0x0082, func2 0x0182 |
| Kernel requirement | 4.19 (adapt it yourself; AIC provides no RV1126 patch) |
Driver download: Downloads - AIC8800D80 Wi-Fi / Bluetooth Driver.
For build steps, firmware installation, load order, and verification commands, see:
4. Power-On Verification
# 1. SDIO enumeration
dmesg | grep -i mmc
# Expected: mmc1: new SDIO card at address ...
# 2. Modules
lsmod | grep aic8800
# aic8800_bsp / aic8800_fdrv / aic8800_btlpm
# 3. Network interface
ifconfig -a | grep wlan0
dmesg | grep -i 'New interface create'
# 4. Bluetooth
hciconfig -a
# hci0: Type: Primary Bus: UART UP RUNNING
Wi-Fi connection, AP mode, Bluetooth scanning, and other operations are the same as on the RV1126 debugging page.
5. Troubleshooting
| Symptom | Cause / Fix |
|---|---|
mmc1 shows no new SDIO card | &sdio not enabled, WIFI_REG_ON not pulled high, or SDIO power / 1.8V is incorrect |
SDIO card detected but no wlan0 | aic8800_fdrv not loaded, or wrong firmware path |
probe failed / repeated reconnect | GPIO1_D0 timing, 1.8V IO, or CLK phase; try rockchip,default-sample-phase = <180> first |
No BT data on ttyS0 | S01 not at 1/3, BT,power_gpio not released, or RTS/CTS swapped |
No hci0 from hciconfig | hciattach not running, or wrong baud rate / flow control parameters |
| Low 5G throughput | Antenna, power supply, or aic_userconfig_8800d80.txt not installed into /lib/firmware together with the firmware |