rsgltzyd/HeavenlyHeroStar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
HeavenlyHeroStar/README.md
T
rsgltzyd efb3c8f304 docs: 更新 README.md，添加触摸控制芯片与 IMU 传感器的 I2C 总线共享信息 
- 修改触摸控制芯片 CST816 和六轴惯性测量单元 QMI8658A 的描述，说明它们共用 I2C 总线（IO47/IO48）
- 更新触摸屏和 IMU 传感器的引脚信息，确保文档准确反映硬件配置
- 添加 I2C 设备与固件配置部分，提供设备地址和说明
2026-07-05 21:29:47 +08:00

12 KiB
Raw Permalink Blame History

Suppor

Supported Targets ESP32 ESP32-C2 ESP32-C3 ESP32-C5 ESP32-C6 ESP32-C61 ESP32-S2 ESP32-S3 ESP32-P4 ESP32-H2

外围硬件

硬件类别 组件/型号 关键参数/功能 备注
核心处理器 ESP32-S3R8 Xtensa 32位LX7双核，主频240MHz 乐鑫高性能芯片
存储 内置 SRAM 512KB 芯片内部
内置 ROM 384KB 芯片内部
叠封 PSRAM 8MB 用于运行代码，性能优异
外接 Flash 16MB (W25Q128) 存储程序和数据
显示与触摸 LCD 屏幕 1.9英寸，170×320分辨率，262K彩色 驱动IC为ST7789V2
触摸控制芯片 CST816 (电容式) 触控版特有，I2C 与 IMU 共用 IO47/IO48
无线通信 Wi-Fi 2.4GHz, 802.11 b/g/n
蓝牙 Bluetooth 5 (BLE)
板载天线 贴片陶瓷天线
外部天线接口 IPEX-1 连接器 触控版特有，需修改焊盘启用
传感器 六轴惯性测量单元 QMI8658A 与 CST816 共用 I2C 总线（IO47/IO48）
存储扩展 Micro SD 卡槽 支持Micro SD卡 位于PCB背面
电源管理 电池接口 MX1.25 连接器 支持3.7V锂电池充放电
USB供电 USB Type-C 接口 同时用于下载调试
充电指示灯 红色LED 充电时亮起，充满熄灭
用户交互与调试 复位按键 RESET 系统复位
启动按键 BOOT 用于下载模式和引导
扩展接口 Pico兼容排针 引出丰富GPIO 兼容树莓派Pico生态，可连接扩展板

外围接口

接口名称 接口类型 引脚/GPIO 功能说明
LCD 显示屏 SPI IO9 LCD_RST（复位）
IO10 LCD_CLK（时钟）
IO11 LCD_DC（数据/命令）
IO12 LCD_CS（片选）
IO13 LCD_DIN（数据输入）
IO14 LCD_BL（背光控制，PWM）
触摸屏 / I2C 总线 I2C IO47 TP_SDA / IMU_SDA（与 IMU 共用）
(CST816 + QMI8658) IO48 TP_SCL / IMU_SCL（与 IMU 共用）
GPIO IO17 TP_RESET（复位）
IO21 TP_INT（中断）
SD 卡 SPI IO5 SD_CS（片选）
IO39 SD_CLK（时钟）
IO40 SD_MISO（主入从出）
IO41 SD_MOSI（主出从入）
IMU 传感器 I2C IO47 IMU_SDA（与 TP 共用，见上）
(QMI8658A) IO48 IMU_SCL（与 TP 共用，见上）
GPIO IO8 IMU_INT1（中断1）
IO7 IMU_INT2（中断2）
UART0 串口 UART IO43 U0_TX（发送）
IO44 U0_RX（接收）
用户按键 GPIO IO0 BOOT0（启动/下载模式）
IO4 KEY_IO（用户按键）
用户 LED GPIO IO16 LED_A（指示灯）
电池检测 ADC IO3 BAT_ADC（电池电压采集）
USB Type-C USB VBUS/D+/D- 供电 + 程序下载 + 串口通信
锂电池接口 电源 J1 电池充电与供电（ETA6098）
WiFi/蓝牙天线 射频 J5 (U.FL-IPEX) 外接天线座
TF 卡座 SPI TF1 MicroSD 卡扩展存储
外部 Flash SPI U5 (W25Q32) 4MB 板载 Flash
扩展排针 J3 混合 IO0~IO14 20Pin 排针，引出主要 GPIO
扩展排针 J4 混合 IO14~IO48等 20Pin 排针，含 USB/3V3/地

I2C 设备与固件配置

触控版 PCB 上 CST816（触摸） 与 QMI8658A（IMU） 挂载在同一条 I2C 总线（I2C_NUM_0，SDA=IO47，SCL=IO48）。固件在 main/bsp/board_config.h 中定义引脚，触摸与 IMU 驱动共用该总线句柄。

设备 I2C 地址（7-bit） 说明
CST816S 由驱动自动探测 电容触摸
QMI8658A 0x6A 或 0x6B 由 SDO 电平决定；本板实测多为 0x6B

IMU 中断引脚（IO8 / IO7）当前固件采用轮询采样，Phase 4 可改为中断驱动。

Wi-Fi Station Example

(See the README.md file in the upper level 'examples' directory for more information about examples.)

This example shows how to use the Wi-Fi Station functionality of the Wi-Fi driver of ESP for connecting to an Access Point.

How to use example

Configure the project

Open the project configuration menu (idf.py menuconfig).

In the Example Configuration menu:

  • Set the Wi-Fi configuration.
    • Set WiFi SSID.
    • Set WiFi Password.

Optional: If you need, change the other options according to your requirements.

Build and Flash

Build the project and flash it to the board, then run the monitor tool to view the serial output:

Run idf.py -p PORT flash monitor to build, flash and monitor the project.

(To exit the serial monitor, type Ctrl-].)

Attach USB device in WSL

If you are using Windows Subsystem for Linux (WSL) and need to forward the ESP board from Windows to WSL, you can attach the device with:

usbipd attach --wsl --busid 3-1 --auto-attach

Replace 3-1 with the actual bus ID of your device from usbipd list. This allows the board to be detected by the ESP-IDF tools in WSL.

See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.

Example Output

Note that the output, in particular the order of the output, may vary depending on the environment.

Console output if station connects to AP successfully:

I (589) wifi station: ESP_WIFI_MODE_STA
I (599) wifi: wifi driver task: 3ffc08b4, prio:23, stack:3584, core=0
I (599) system_api: Base MAC address is not set, read default base MAC address from BLK0 of EFUSE
I (599) system_api: Base MAC address is not set, read default base MAC address from BLK0 of EFUSE
I (629) wifi: wifi firmware version: 2d94f02
I (629) wifi: config NVS flash: enabled
I (629) wifi: config nano formatting: disabled
I (629) wifi: Init dynamic tx buffer num: 32
I (629) wifi: Init data frame dynamic rx buffer num: 32
I (639) wifi: Init management frame dynamic rx buffer num: 32
I (639) wifi: Init management short buffer num: 32
I (649) wifi: Init static rx buffer size: 1600
I (649) wifi: Init static rx buffer num: 10
I (659) wifi: Init dynamic rx buffer num: 32
I (759) phy: phy_version: 4180, cb3948e, Sep 12 2019, 16:39:13, 0, 0
I (769) wifi: mode : sta (30:ae:a4:d9:bc:c4)
I (769) wifi station: wifi_init_sta finished.
I (889) wifi: new:<6,0>, old:<1,0>, ap:<255,255>, sta:<6,0>, prof:1
I (889) wifi: state: init -> auth (b0)
I (899) wifi: state: auth -> assoc (0)
I (909) wifi: state: assoc -> run (10)
I (939) wifi: connected with #!/bin/test, aid = 1, channel 6, BW20, bssid = ac:9e:17:7e:31:40
I (939) wifi: security type: 3, phy: bgn, rssi: -68
I (949) wifi: pm start, type: 1

I (1029) wifi: AP's beacon interval = 102400 us, DTIM period = 3
I (2089) esp_netif_handlers: sta ip: 192.168.77.89, mask: 255.255.255.0, gw: 192.168.77.1
I (2089) wifi station: got ip:192.168.77.89
I (2089) wifi station: connected to ap SSID:myssid password:mypassword

Console output if the station failed to connect to AP:

I (589) wifi station: ESP_WIFI_MODE_STA
I (599) wifi: wifi driver task: 3ffc08b4, prio:23, stack:3584, core=0
I (599) system_api: Base MAC address is not set, read default base MAC address from BLK0 of EFUSE
I (599) system_api: Base MAC address is not set, read default base MAC address from BLK0 of EFUSE
I (629) wifi: wifi firmware version: 2d94f02
I (629) wifi: config NVS flash: enabled
I (629) wifi: config nano formatting: disabled
I (629) wifi: Init dynamic tx buffer num: 32
I (629) wifi: Init data frame dynamic rx buffer num: 32
I (639) wifi: Init management frame dynamic rx buffer num: 32
I (639) wifi: Init management short buffer num: 32
I (649) wifi: Init static rx buffer size: 1600
I (649) wifi: Init static rx buffer num: 10
I (659) wifi: Init dynamic rx buffer num: 32
I (759) phy: phy_version: 4180, cb3948e, Sep 12 2019, 16:39:13, 0, 0
I (759) wifi: mode : sta (30:ae:a4:d9:bc:c4)
I (769) wifi station: wifi_init_sta finished.
I (889) wifi: new:<6,0>, old:<1,0>, ap:<255,255>, sta:<6,0>, prof:1
I (889) wifi: state: init -> auth (b0)
I (1889) wifi: state: auth -> init (200)
I (1889) wifi: new:<6,0>, old:<6,0>, ap:<255,255>, sta:<6,0>, prof:1
I (1889) wifi station: retry to connect to the AP
I (1899) wifi station: connect to the AP fail
I (3949) wifi station: retry to connect to the AP
I (3949) wifi station: connect to the AP fail
I (4069) wifi: new:<6,0>, old:<6,0>, ap:<255,255>, sta:<6,0>, prof:1
I (4069) wifi: state: init -> auth (b0)
I (5069) wifi: state: auth -> init (200)
I (5069) wifi: new:<6,0>, old:<6,0>, ap:<255,255>, sta:<6,0>, prof:1
I (5069) wifi station: retry to connect to the AP
I (5069) wifi station: connect to the AP fail
I (7129) wifi station: retry to connect to the AP
I (7129) wifi station: connect to the AP fail
I (7249) wifi: new:<6,0>, old:<6,0>, ap:<255,255>, sta:<6,0>, prof:1
I (7249) wifi: state: init -> auth (b0)
I (8249) wifi: state: auth -> init (200)
I (8249) wifi: new:<6,0>, old:<6,0>, ap:<255,255>, sta:<6,0>, prof:1
I (8249) wifi station: retry to connect to the AP
I (8249) wifi station: connect to the AP fail
I (10299) wifi station: connect to the AP fail
I (10299) wifi station: Failed to connect to SSID:myssid, password:mypassword

Running the example on ESP Chips without Wi-Fi

This example can run on ESP Chips without Wi-Fi using ESP-Hosted. See the Two-Chip Solution section in the upper level README.md for information.

Troubleshooting

For any technical queries, please open an issue on GitHub. We will get back to you soon.

Reference in New Issue View Git Blame Copy Permalink