MCU示例库 on CLing

乐鑫 ESP32 — WiFi+蓝牙双模 SoC 入门

Wed, 09 Sep 2026 09:00:00 +0800

ESP32 MCU 示例代码库

厂商: 乐鑫 (Espressif)
芯片: ESP32 / ESP32-S2 / ESP32-S3 / ESP32-C3
开发框架: ESP-IDF（Espressif IoT Development Framework）

ESP32 是什么？

ESP32 是乐鑫推出的 WiFi + 蓝牙双模 SoC，集成度极高：

特性	参数
CPU	Xtensa LX6 双核，240MHz
WiFi	802.11 b/g/n
蓝牙	BT 4.2 + BLE
RAM	520KB SRAM
Flash	外置，4~16MB
GPIO	34 个
ADC	18 通道，12 位
接口	SPI、I2C、UART、I2S、SDIO、CAN

为什么用 ESP32？

自带 WiFi 和蓝牙，不需要外接模块
价格便宜（~10 元）
生态成熟，开源项目多
支持 Arduino 和 ESP-IDF 两种开发方式

开发环境

ESP-IDF（官方框架）

# 安装 ESP-IDF
git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
./install.sh

# 编译和烧录
idf.py set-target esp32
idf.py build
idf.py -p /dev/ttyUSB0 flash monitor

Arduino IDE（更简单）

安装 Arduino IDE
添加 ESP32 开发板 URL：https://dl.espressif.com/dl/package_esp32_index.json
安装 ESP32 开发板包
选择板子和端口，直接写代码

项目结构

project_test/
├── CMakeLists.txt          # 项目 CMake 配置
├── sdkconfig               # SDK 配置（menuconfig 生成）
├── main/
│   ├── CMakeLists.txt      # 主模块 CMake 配置
│   └── hello_world_main.c  # 主程序
└── README.md

示例列表

示例	说明
Hello World	打印芯片信息，ESP32 入门第一个实验

学了 ESP32 能做什么？

项目	原理	难度
智能家居	WiFi + MQTT + 手机 APP 控制家电	⭐⭐⭐
物联网传感器	WiFi 上传温湿度数据到云平台	⭐⭐
蓝牙遥控车	BLE 连接手机，控制电机	⭐⭐⭐
网络摄像头	ESP32-CAM + WiFi 视频流	⭐⭐⭐⭐
天气站	WiFi 获取天气 API，LCD 显示	⭐⭐⭐
OTA 远程升级	WiFi 下载新固件，自动更新	⭐⭐⭐⭐
WiFi 遥控器	ESP32 建 Web 服务器，手机浏览器控制	⭐⭐⭐
蓝牙音箱	A2DP 蓝牙音频流	⭐⭐⭐⭐

华大半导体 (HDSC / XHSC) HC32 MCU 示例代码库

Tue, 08 Sep 2026 14:52:21 +0800

HC32 MCU 示例代码库

厂商: 华大半导体 (HDSC / XHSC)
芯片: HC32F460

华大半导体 HC32F460 系列，基于 Cortex-M4 内核，主频 200MHz，工业级。

固件库版本一览

固件库名称	版本	芯片
HC32F460 Demo SDK	—	HC32F460

HC32 用的是 ddl 库（Device Driver Library），不是 STM32 那套标准外设库。函数命名风格是 PORT_xxx()、USART_xxx()、TIMER0_xxx()，配置全部通过 stc_xxx_t 结构体完成。两个和 STM32 最不一样的地方：

GPIO 不用开外设时钟，但其他外设都要 PWC_FcgxPeriphClockCmd()。

中断要手动注册：用 enIrqRegistration() 把「中断源」绑到「向量号」和「回调函数」上。

学习路线

建议按顺序阅读，由易到难，前面是后面的基础：

顺序	外设	学什么	难度
1	GPIO	点亮 LED，控制引脚高低电平	★
2	USART	串口收发 + printf 调试打印	★★
3	Timer0	定时中断，不再用死等延时	★★
4	KEY	按键输入 + 外部中断 + 消抖	★★
5	QSPI	外扩 Flash，映射地址直接读	★★★
6	SDIOC	SD 卡读写，GB 级存储	★★★
7	SPI LCD	彩屏显示文字与图形	★★★

前四章是必修基础（GPIO / 串口 / 定时器 / 中断），几乎所有项目都用得上。后三章是外设扩展（存储 + 显示），做完整产品时按需取用。

目录导航

左侧导航按外设模块分类。每个外设目录下有：

_index.md：该外设的原理讲解、寄存器概念、配置套路、引脚表
示例页：完整代码（带详细中文注释）+ 逐段讲解 + 实验现象 + 常见问题 + 拓展应用

所有代码都来自官方 HC32F460 Demo SDK 的 example/HC32F460JEUA/ 目录，每篇文档开头标注了对应的源码路径。

华大半导体 (HDSC) CIU32 MCU 示例代码库

Tue, 08 Sep 2026 14:52:21 +0800

CIU32 MCU 示例代码库

厂商: 华大半导体 (HDSC)
芯片: CIU32F003

华大半导体 CIU32F003 系列标准外设库，基于 Cortex-M0 内核，超低功耗。

固件库版本一览

固件库名称	版本	芯片
CIU32F003_STDLib	V1.0.3	CIU32F003

开发工具

工具	版本
HED.CIU32F003_DFP_MDK	V1.0.0
HB1025B 核心板	V1.3

目录导航

左侧导航按外设模块分类，每个模块下列出所有子示例。每个示例包含功能说明、关键配置代码、源文件路径。

普冉半导体 (Puya) PUYA MCU 示例代码库

Tue, 08 Sep 2026 14:52:21 +0800

PUYA MCU 示例代码库

厂商: 普冉半导体 (Puya)
芯片: PY32F002A、PY32F003、PY32F030、PY32F403、PY32L020

普冉 PY32 系列超低成本 MCU，基于 Cortex-M0+/M4 内核。

固件库版本一览

固件库名称	版本	芯片
PY32F0xx_Firmware	V1.5.0	PY32F002A, PY32F003, PY32F030
PY32F002B_Firmware	V1.2.1	PY32F002B
PY32F403_Firmware	V1.4.5	PY32F403
PY32L020_Firmware	V1.2.1	PY32L020
ebf_py32f030	20250102	PY32F030

HAL 库 vs LL 库

PUYA 的每个系列固件库都同时提供 两套 API，源码分别放在两个示例目录中：

目录	库类型	函数前缀	特点
`Example/`	HAL 库（Hardware Abstraction Layer）	`HAL_`（如 `HAL_GPIO_TogglePin`）	封装度高、跨系列可移植性强，适合快速开发、原型验证
`Example_LL/`	LL 库（Low-Layer）	`LL_`（如 `LL_GPIO_TogglePin`）	接近寄存器操作、代码精简、执行效率高，适合性能敏感 / 资源紧张场景

如何选择？

想尽快跑通功能、后续可能换芯片系列 → 用 HAL 库。
追求最小代码体积、最短中断延迟、对寄存器行为完全掌控 → 用 LL 库。
两者并不互斥：可以在 HAL 工程中直接调用 LL 函数做精细控制（PUYA 的 LL 头文件与 HAL 共存于同一套驱动）。

本站的文档约定

HAL 库版本文档标题标注 （HAL 库），并在 tags 中加入 HAL；
LL 库版本文档标题标注 （LL 库），并在 tags 中加入 LL；
每篇 LL 文档开头都有一段「HAL vs LL」提示框，讲解该外设下两套库的写法差异。

核心外设的 HAL / LL 对照示例（PY32F0xx V1.5.0）：

外设	HAL 版	LL 版
GPIO 翻转	GPIO_Toggle（HAL）	GPIO_Toggle（LL）
USART 轮询	USART_HyperTerminal_Polling（HAL）	USART_HyperTerminal_Polling_Init（LL）
ADC 单通道	ADC_TempSensor（HAL）	ADC_TempSensor_Init（LL）
TIM1 PWM	TIM1_PWM（HAL）	TIM1_PWM_Init（LL）
I2C 主机轮询	I2C 主机轮询（HAL）	I2C 主机轮询（LL）
SPI 全双工主机	SPI 全双工主机 DMA（HAL）	SPI 全双工主机 IT（LL）
DMA 内存搬运	DMA_SramToSram（HAL）	DMA_SramToSram（LL）
Flash 页擦写	FLASH_PageEraseAndWrite（HAL）	FLASH_PageEraseAndWrite（LL）

注：PUYA 的 LL 示例库中，部分外设没有与 HAL 同名示例（如 LL 的 SPI 仅有 DMA/中断版、ADC 无 TriggerSW_Polling 版）。本站选取功能等价的 LL 示例与之配对，并在对应文档中加以说明。

目录导航

左侧导航按外设模块分类，每个模块下列出所有子示例。每个示例包含功能说明、关键配置代码、源文件路径。

雅特力 (Artery) AT32 MCU 示例代码库

Tue, 08 Sep 2026 14:52:21 +0800

AT32 MCU 示例代码库

厂商: 雅特力 (Artery)
芯片: AT32F403A、AT32F407

雅特力 AT32F403A/407 系列固件库，基于 Cortex-M4 内核，主频 240MHz。

固件库版本一览

固件库名称	版本	芯片
AT32F403A_407_Firmware_Library	V2.2.2	AT32F403A, AT32F407

开发工具

工具	版本
Keil5_AT32MCU_AddOn	V2.4.8
IAP_using_USB_HID (文档)	V2.0.2

目录导航

左侧导航按外设模块分类，每个模块下列出所有子示例。每个示例包含功能说明、关键配置代码、源文件路径。

意法半导体 (ST) STM32 MCU 示例代码库

Tue, 08 Sep 2026 14:52:21 +0800

STM32 MCU 示例代码库

厂商: 意法半导体 (ST)
芯片: STM32F103

STM32F103 系列，野火 EBF STM32F03 Mini 开发板 HAL 库例程。

固件库版本一览

固件库名称	版本	芯片
ebf_stm32f103_mini_hal_code	HAL	STM32F103

目录导航

左侧导航按外设模块分类，每个模块下列出所有子示例。每个示例包含功能说明、关键配置代码、源文件路径。

兆易创新 (GigaDevice) GD32 MCU 示例代码库

Tue, 08 Sep 2026 14:52:21 +0800

GD32 MCU 示例代码库

厂商: 兆易创新 (GigaDevice)
芯片: GD32F103C8T6、GD32F303

兆易创新 GD32 系列国产 MCU，Pin-to-Pin 兼容 STM32。GD32F103 基于 Cortex-M3，GD32F30x 基于 Cortex-M4。

固件库版本一览

固件库名称	版本	芯片
GD32F30x_Firmware_Library	V3.0.3	GD32F103C8T6, GD32F303
drg_gd32f103c8t6	DRG GD-1	GD32F103C8T6, GD32F303

目录导航

左侧导航按外设模块分类，每个模块下列出所有子示例。每个示例包含功能说明、关键配置代码、源文件路径。