RV1126 24PIN 配置(CAM126 接 24PIN 扩展板)

同一块 CAM126B-P-24 扩展板,通过 24PIN 0.5mm FPC 接到 RV1126(CAM126) 时,硬件信号定义不变,但 RV1126 的 GPIO 编号、SDIO/UART 控制器、设备节点与 RV1126B-P 不同,需要按本页重新配置 dts 和驱动。
适用范围
- 主控:RV1126 / RV1109,Linux 4.19.111
- 扩展板:CAM126B-P-24(AIC8800D80,SDIO Wi-Fi + UART BT)
- RV1126B-P 侧配置见 Wi-Fi / 蓝牙调试
- RV1126 平台说明见 扩展板 24PIN - CAM126
1. 24PIN 引脚对照
| pin | 定义 | RV1126 GPIO | RV1126 复用功能 | 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 |
1.1 平台对照
| 项目 | RV1126(CAM126) | RV1126B-P |
|---|---|---|
| 内核 | 4.19.111 | 6.1 |
| 架构 | 32-bit ARM(Cortex-A7) | arm64 |
| SDIO 控制器 | &sdio(mmc1,dwmmc@ffc70000) | &sdmmc1(mmc2) |
| SDIO 引脚 | GPIO1_B2 ~ B7(func 1) | GPIO3_A0 ~ A5(func 1) |
| 蓝牙串口 | &uart0 → /dev/ttyS0 | &uart2 → /dev/ttyS2 |
| Wi-Fi 使能 | GPIO1_D0 | GPIO3_B6 |
| Wi-Fi 唤醒 | GPIO1_D1 | GPIO3_B7 |
| BT 复位 | GPIO3_A5 | GPIO6_A1 |
| BT 唤醒 / 唤醒主机 | GPIO3_A6 / GPIO3_A4 | GPIO6_A2 / GPIO6_A0 |
| SDIO 枚举 | mmc1: new SDIO card | mmc2: new SDIO card |
硬件前提
- SDIO 1.8V:24PIN 模块侧 SDIO 为 1.8V,RV1126 的 GPIO1 所在 IO 域(VCCIO)必须也是 1.8V。CAM126 38x38 默认
vccio3 = 3.3V,接入前需核对实际板子的 IO 域供电,必要时改压或加电平转换。 - S01 拨码:Wi-Fi / BT 使用 1 / 3,TTL 使用 2 / 4。
- UART 电平:24PIN-22/23 为 1.8V,实测可与 3.3V 短时通信,长期建议电平转换。
2. RV1126 dts 配置
以下节点加到板级 dts(例如 rv1126-38x38-v10-emmc.dts)。引脚和控制器均来自 RV1126 主 dtsi,节点名不要照抄 1126B-P 的 sdmmc1。
2.1 pwrseq、无线节点
/ {
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";
};
};
/*
* CAM126 板级 dts 已有 wireless_wlan(USB-WiFi)节点,这里直接覆盖;
* 若板级 dts 没有该节点,请改为在根节点下新增 wireless-wlan 节点。
*/
&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 使能 SDIO 与 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>;
};
说明
- RV1126 的
&sdio默认pinctrl-0 = <&sdio_clk &sdio_cmd &sdio_bus4>,引脚就是 GPIO1_B2 ~ B7,不需要再写引脚。 - CAM126 板级 dts 已有
wireless_wlan节点(原为 USB-WiFi),示例用&wireless_wlan覆盖;若你的板级 dts 没有该节点,请改为在根节点下新增wireless-wlan。 uart0_xfer/uart0_ctsn/uart0_rtsn在rv1126-pinctrl.dtsi中已定义,分别对应 GPIO1_C2/C3、C1、C0。- 控制台默认在
uart2(ttyFIQ0),uart0可安全给蓝牙使用。 - 若底板已经占用 GPIO1_B2 ~ B7 或 GPIO1_C0 ~ C3,需要先释放原功能。
2.3 内核配置
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 已包含 MMC / RFKILL;CFG80211 / MAC80211 在板级 config 片段中为 =m,沿用即可。
3. 驱动匹配
RV1126 SDK 不含 AIC8800 驱动,需要把 AIC 驱动包自行集成:
| 项目 | 值 |
|---|---|
| 驱动包 | aic8800d_linux_sdk_V5.0_2026_0509_2195ae36 |
| 驱动目录 | SDIO/driver_fw/driver/aic8800 |
| 固件目录 | SDIO/driver_fw/fw/aic8800D80 |
| SDIO ID | vendor 0xc8a1,device 0x0082,func2 0x0182 |
| 内核要求 | 4.19(需自行适配,官方未提供 RV1126 补丁) |
驱动包下载:资料下载 - AIC8800D80 Wi-Fi / 蓝牙驱动。
编译、安装固件、加载顺序与验证命令见:
4. 上电验证
# 1. SDIO 枚举
dmesg | grep -i mmc
# 期望:mmc1: new SDIO card at address ...
# 2. 模块
lsmod | grep aic8800
# aic8800_bsp / aic8800_fdrv / aic8800_btlpm
# 3. 网卡
ifconfig -a | grep wlan0
dmesg | grep -i 'New interface create'
# 4. 蓝牙
hciconfig -a
# hci0: Type: Primary Bus: UART UP RUNNING
Wi-Fi 连接、AP 模式、蓝牙扫描等操作与 RV1126 调试页 一致。
5. 常见问题
| 现象 | 原因 / 处理 |
|---|---|
mmc1 没有 new SDIO card | &sdio 未 enable、WIFI_REG_ON 未拉高、SDIO 供电 / 1.8V 不对 |
有 SDIO 卡但无 wlan0 | aic8800_fdrv 未加载,或固件路径不对 |
probe failed / 反复重连 | GPIO1_D0 时序、1.8V IO、CLK 相位;可先试 rockchip,default-sample-phase = <180> |
ttyS0 无 BT 数据 | S01 不在 1/3、BT,power_gpio 未释放、RTS/CTS 接反 |
hciconfig 无 hci0 | hciattach 未运行,或波特率 / 流控参数不对 |
| 连接 5G 速率低 | 天线、供电、aic_userconfig_8800d80.txt 是否随固件一起放入 /lib/firmware |