功能支持

可用状态

标记	含义
🟢 默认包含	默认构建已选择此功能所需的支持；使用时可能仍需配置
🟡 已实现	已有驱动或协议实现
🟠 开发中	集成尚未完成
🔴 未提供	本仓库未提供相应的 ESP32-S31 实现

这些标记描述构建配置和驱动支持情况。

系统

功能	可用状态	备注
Linux、Sv32 MMU 和 flash XIP	🟢 默认包含	按 16 MiB flash 和 16 MiB PSRAM 配置
双核 SMP	🟢 默认包含	两个 HP hart 均配置为运行 Linux
持久化根文件系统	🟢 默认包含	SquashFS 配合 JFFS2 可写层
可移动存储与 swap	🟢 默认包含	FAT/VFAT、内置 ext4、SD/MMC、USB 存储和 swap
运行时覆盖层	🟢 默认包含	外设选择、引脚路由和设置保存
CPU 动态调频	🟢 默认包含	共享的 80、160、240 和 320 MHz 策略
CPU 空闲	🟢 默认包含	固件辅助的 WFI
LP 固件和邮箱	🟡 已实现	remoteproc、PING/PONG、定时器和 GPIO 诊断
Suspend-to-idle	🟡 已实现	LP 定时唤醒诊断使用 HP CPU 轮询
定时深度休眠	🟡 已实现	定时唤醒使用冷启动路径
正常关机	🟡 已实现	不设置定时唤醒；通过外部复位或重新上电启动
Suspend-to-RAM 和 LP GPIO 唤醒	🟡 已实现	已有定时/GPIO 唤醒路径

Linux、LP 固件和 OpenSBI 使用一致的休眠协议定义。命令和唤醒源设置见电源管理。源码参考： Linux 休眠结构、 OpenSBI 检查。

无线

功能	可用状态	备注
Wi-Fi STA	🟢 默认包含	mac80211/cfg80211 单 STA；`iw`、`wpa_supplicant`
蓝牙	🟢 默认包含	BTstack 配合直接 HCI；另有 Linux HCI 前端可选
AP、AP+STA 和受保护 AP	🔴 未提供	当前 SoftMAC 前端不公开这些模式
软件监听	🟠 开发中	共用 STA 过滤接收路径，不是完整混杂捕获
企业认证	🟠 开发中	没有 EAP 厂商凭据接口
活动 Wi-Fi 挂起	🔴 未提供	接口运行时返回 `EBUSY`，没有活动连接恢复实现

提供的根文件系统使用 BTstack。尝试使用 BlueZ 还需要选择 Linux HCI 前端，并修改 rootfs 软件包及 post-build 设置：当前 post-build 脚本会删除 BlueZ、 D-Bus 及相关库文件。仅选择 BlueZ 软件包并不足够。见 post-build 删除规则。

可用的配置方式见 Wi-Fi 与蓝牙和进阶 Wi-Fi。

外设

功能	可用状态	备注
GPIO 和 UART0 控制台	🟢 默认包含	GPIO 字符设备及 UART0 控制台
可选 UART	🟡 已实现	UART1/2 路由及 UART3 DMA；预置 UART3 HIL 用例使用内部回环
I2C0/I2C1	🟡 已实现	已实现长传输分批处理
GPSPI2/GPSPI3 主机	🟡 已实现	8 位字；数据线设置取决于控制器及所选设备
GPSPI 目标端	🟡 已实现	DMA 传输最长 4096 字节
I2S/TDM	🟡 已实现	播放/采集和可配置帧格式；预置覆盖层使用外部 BCLK/WS
SD/MMC	🟡 已实现	插槽接线和总线宽度由覆盖层选择
以太网	🟡 已实现	需要匹配的外部 PHY 配置和接线
USB gadget	🟡 已实现	标准内核包含 ACM/ECM configfs 支持；运行时需选择功能；不在标准 HIL 测试范围内
USB 主机	🟢 默认包含	默认选择主机控制器及存储支持
AHB/AXI GDMA	🟡 已实现	两个 DMA 提供者均已内置，由相应外设驱动使用
定时器、PWM 和脉冲计数器	🟡 已实现	每个定时器组的定时器 1 为 CPU 空闲功能保留
模拟和传感器模块	🟡 已实现	ADC、DAC、触摸和比较器通过 IIO 提供接口；温度通过 hwmon 提供接口
看门狗、NVMEM、RNG 和加密	🟡 已实现	已接入各自的 Linux 子系统
TWAI/CAN	🟡 已实现	已有 SocketCAN 绑定和覆盖层
RMT	🔴 未提供	仓库中没有 ESP32-S31 的驱动或设备树节点

配置方法见使用外设，API 设置和传输限制见外设参考，默认 GPIO 分配见模组和开发板。覆盖层目录列出可选控制器。

测试

项目提供主机检查与开发板/对端测试程序。HIL 的 usb-drive 覆盖 USB 主机存储，不代表 gadget 或全部 USB 类别均受支持。命令、夹具及结果收集见HIL 测试。

验收记录应包含镜像/提交标识、开发板和模组版本、接线、传输设置、命令、PASS/FAIL/SKIP 结果，以及恢复和清理证据。无线数据传输须记录对端，休眠结论须记录唤醒原因及电流。

Flash 与持久化存储

当前布局的 persist 为 2120 KiB，内核和 rootfs 各为 6 MiB，没有 HIL 临时分区。固件更新应使用同布局的完整匹配集；更换布局先备份并重新安装。

发生 NOR 或 JFFS2 错误时，请保存完整启动日志、镜像标识和触发操作。esp32s31-flash: ROM ... failed 与 S31 overlay: failed to mount persist as JFFS2 分别指向 Flash 操作和 persist 挂载失败。根文件系统处于只读恢复环境时，不能承诺设置会保存。排查方法见调试。