Skip to main content

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

Navigation bar

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.

Scope

1. 24PIN Pin Mapping​

pinDefinitionRV1126 GPIORV1126 Mux FunctionRV1126B-P GPIO
1GND
2GND
3VCC5V0
4VCC5V0
5USB_HOST_DPY1 (Ball)USB Host D+
6USB_HOST_DMY2 (Ball)USB Host D-
7GND
8ADKEY_IN0E17 (Ball)SARADC_IN0
9GND
10WIFI_WAKE_HOSTGPIO1_D1GPIOGPIO3_B7
11BT_RSTGPIO3_A5GPIOGPIO6_A1
12BT_WAKEGPIO3_A6GPIOGPIO6_A2
13BT_WAKE_HOSTGPIO3_A4GPIOGPIO6_A0
14WIFI_REG_ONGPIO1_D0GPIOGPIO3_B6
15SDIO_D0GPIO1_B4SDIO func1GPIO3_A2
16SDIO_D1GPIO1_B5SDIO func1GPIO3_A3
17SDIO_D2GPIO1_B6SDIO func1GPIO3_A4
18SDIO_D3GPIO1_B7SDIO func1GPIO3_A5
19SDIO_CMDGPIO1_B3SDIO func1GPIO3_A1
20SDIO_CLKGPIO1_B2SDIO func1GPIO3_A0
21UART0_RTSNGPIO1_C0UART0 func1GPIO3_A6
22UART0_TXGPIO1_C3UART0 func1GPIO3_B1
23UART0_RXGPIO1_C2UART0 func1GPIO3_B0
24UART0_CTSNGPIO1_C1UART0 func1GPIO3_A7

Source: 1126-1126BP-24pin.xlsx / 1126pin2pin1126BP-GPIO.xlsx

1.1 Platform Comparison​

ItemRV1126 (CAM126)RV1126B-P
Kernel4.19.1116.1
Architecture32-bit ARM (Cortex-A7)arm64
SDIO controller&sdio (mmc1, dwmmc@ffc70000)&sdmmc1 (mmc2)
SDIO pinsGPIO1_B2 ~ B7 (func 1)GPIO3_A0 ~ A5 (func 1)
Bluetooth UART&uart0 → /dev/ttyS0&uart2 → /dev/ttyS2
Wi-Fi enableGPIO1_D0GPIO3_B6
Wi-Fi wakeGPIO1_D1GPIO3_B7
BT resetGPIO3_A5GPIO6_A1
BT wake / wake hostGPIO3_A6 / GPIO3_A4GPIO6_A2 / GPIO6_A0
SDIO enumerationmmc1: new SDIO cardmmc2: new SDIO card
Hardware Prerequisites
  1. 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.
  2. S01 DIP switch: 1 / 3 for Wi-Fi / BT, 2 / 4 for TTL.
  3. 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>;
};
Notes
  • The RV1126 &sdio node already defaults to pinctrl-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_wlan node (for USB Wi-Fi); the example overrides it with &wireless_wlan. If your board dts has no such node, add a wireless-wlan node under the root node instead.
  • uart0_xfer / uart0_ctsn / uart0_rtsn are defined in rv1126-pinctrl.dtsi and map to GPIO1_C2/C3, C1, and C0 respectively.
  • The console defaults to uart2 (ttyFIQ0), so uart0 is 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:

ItemValue
Driver packageaic8800d_linux_sdk_V5.0_2026_0509_2195ae36
Driver directorySDIO/driver_fw/driver/aic8800
Firmware directorySDIO/driver_fw/fw/aic8800D80
SDIO IDvendor 0xc8a1, device 0x0082, func2 0x0182
Kernel requirement4.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​

SymptomCause / 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 wlan0aic8800_fdrv not loaded, or wrong firmware path
probe failed / repeated reconnectGPIO1_D0 timing, 1.8V IO, or CLK phase; try rockchip,default-sample-phase = <180> first
No BT data on ttyS0S01 not at 1/3, BT,power_gpio not released, or RTS/CTS swapped
No hci0 from hciconfighciattach not running, or wrong baud rate / flow control parameters
Low 5G throughputAntenna, power supply, or aic_userconfig_8800d80.txt not installed into /lib/firmware together with the firmware
AI Translation Notice

This page was translated into English by AI and is provided for reference only. The original document is written in Chinese. If there is any discrepancy, the Chinese version prevails.

本页英文内容由 AI 自动翻译生成,仅供参考;原文为中文,如有差异请以中文原文为准。

查看中文原文 / View the Chinese original →