PY32F403 on CLing

PUYA CANFD — 经典帧基址 ID 轮询收发

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

CANFD — 经典帧基址 ID 轮询收发

固件库: PY32F403_Firmware V1.4.5
芯片: PY32F403
源文件: PUYA/PY32F403_Firmware_V1.4.5/Projects/PY32F403-STK/Example/CANFD/CANFD_Classic_BaseID_polling/Src/main.c

功能简介

CAN / CAN-FD 是汽车与工业中最可靠的串行总线，采用差分信号（CANH/CANL），多主、带仲裁、抗干扰强。PY32F403 内置 CANFD 控制器，兼容经典 CAN 2.0B 与 CAN-FD。

本示例演示经典帧（Classic，非 FD）模式 + 轮询收发：

配置 CANFD 为经典帧、正常模式，波特率 250Kbps（Nominal 段配置）；
设置过滤器：只接收 ID 高 11 位为 0x12F 的报文（MaskID = 0 表示仅比较 ID 本身）；
往发送 FIFO（PTB）放入一帧 ID=0x123、8 字节数据 {1..8}，激活发送；
轮询等待接收 FIFO 非空，读回后用 printf 打印长度与数据。

这是“自收发”验证：同一控制器既发又收（需外部接好终端电阻，或回环模式）。经典帧即普通 CAN 2.0，每帧最多 8 字节；FD 帧可到 64 字节。

硬件准备

PY32F403 开发板（带 CANFD 收发器，或外接 TJA1050/MCP2551）
CANH、CANL 双绞线，总线两端各接 120Ω 终端电阻
接好调试串口（用于 printf 观察）
单板自测时可启用回环（修改 Mode 为 CANFD_MODE_LOOPBACK）

完整代码

#include "main.h"

CANFD_HandleTypeDef CanfdHandle;
CANFD_FilterTypeDef CanfdFilter;
CANFD_TxHeaderTypeDef CanfdTxHeader;
uint8_t TxData[] = {0x1,0x2,0x3,0x4,0x5,0x6,0x7,0x8};

CANFD_RxHeaderTypeDef CanfdRxHeader;
uint8_t RxData[8] = {0};
uint8_t DLCtoBytes[] = {0,1,2,3,4,5,6,7,8,12,16,20,24,32,48,64}; /* DLC→字节数 */

int main(void)
{
  uint32_t i = 0;
  HAL_Init();
  APP_SystemClockConfig();     /* 系统时钟：HSE */
  BSP_USART_Config();          /* 调试串口（printf 用） */

  /* CANFD 基本配置 */
  CanfdHandle.Instance                   = CANFD;
  CanfdHandle.Init.FrameFormat           = CANFD_FRAME_CLASSIC;  /* 经典帧 */
  CanfdHandle.Init.Mode                  = CANFD_MODE_NORMAL;    /* 正常模式 */
  CanfdHandle.Init.Prescaler             = 1U;
  CanfdHandle.Init.NominalSyncJumpWidth  = 16U;  /* 250KHz */
  CanfdHandle.Init.NominalTimeSeg1       = 64U;
  CanfdHandle.Init.NominalTimeSeg2       = 16U;
  CanfdHandle.Init.DataSyncJumpWidth     = 16U;
  CanfdHandle.Init.DataTimeSeg1          = 64U;
  CanfdHandle.Init.DataTimeSeg2          = 16U;
  CanfdHandle.Init.SecondSamplePointOffset = 0U;
  if (HAL_CANFD_Init(&CanfdHandle) != HAL_OK) APP_ErrorHandler();

  /* 过滤器：仅接收 ID = 0x12F（标准 11 位） */
  CanfdFilter.IdType        = CANFD_STANDARD_ID;
  CanfdFilter.FilterChannel = CANFD_FILTER_CHANNEL_0;
  CanfdFilter.Rank          = CANFD_FILTER_RANK_CHANNEL_NUMBER;
  CanfdFilter.FilterID      = 0x12F;
  CanfdFilter.FilterFormat  = 0xFFFFFFFF;
  CanfdFilter.MaskID        = 0x0;  /* 只比较 ID 本身 */
  CanfdFilter.MaskFormat    = 0xFFFFFFFF;
  if (HAL_CANFD_ConfigFilter(&CanfdHandle, &CanfdFilter) != HAL_OK) APP_ErrorHandler();

  if (HAL_CANFD_Start(&CanfdHandle) != HAL_OK) APP_ErrorHandler();

  /* 组装并发送一帧（PTB 优先发送缓冲区） */
  CanfdTxHeader.Identifier  = 0x123;
  CanfdTxHeader.IdType      = CANFD_STANDARD_ID;
  CanfdTxHeader.TxFrameType = CANFD_DATA_FRAME;
  CanfdTxHeader.FrameFormat = CANFD_FRAME_CLASSIC;
  CanfdTxHeader.Handle      = 0x0;
  CanfdTxHeader.DataLength  = CANFD_DLC_BYTES_8;
  if (HAL_CANFD_AddMessageToTxFifo(&CanfdHandle, &CanfdTxHeader, TxData,
                                    CANFD_TX_FIFO_PTB) != HAL_OK) APP_ErrorHandler();
  if (HAL_CANFD_ActivateTxRequest(&CanfdHandle, CANFD_TXFIFO_PTB_SEND) != HAL_OK)
    APP_ErrorHandler();

  /* 轮询等待接收 FIFO 有数据 */
  while (__HAL_CANFD_GET_RX_FIFO_FILL_LEVEL(&CanfdHandle) == CANFD_RX_FIFO_EMPTY) {}
  if (HAL_CANFD_GetRxMessage(&CanfdHandle, &CanfdRxHeader, RxData) != HAL_OK)
    APP_ErrorHandler();

  /* 打印结果 */
  printf("decimal data length: %d\r\n", DLCtoBytes[CanfdRxHeader.DataLength]);
  printf("hexadecimal data: \r\n");
  for (i = 0; i < DLCtoBytes[CanfdRxHeader.DataLength]; i++)
    printf("%x ", RxData[i]);

  while (1) {}
}

代码分段讲解

1. 经典帧 vs FD 帧

CANFD_FRAME_CLASSIC：经典 CAN 2.0，DLC 最大 8 字节。
CANFD_FRAME_FD：CAN-FD，支持更长数据段与更高数据波特率（Data 段可独立配置 DataTimeSeg1/2）。

2. 波特率配置（BIT Timing）

CAN 波特率由同步段 + BS1 + BS2 与分频决定。本例 Nominal 段 (SJW16 + TS1 64 + TS2 16) 配合 Prescaler=1 得到 250K。实际配置需对照 PY32F403 参考手册的时钟树（CANFD 时钟源）。

3. 过滤器（Filter）

CANFD 用过滤器决定“哪些报文进 RX FIFO”。MaskID = 0 表示只按 FilterID（0x12F）精确匹配；若想接收某一范围，可设 Mask 屏蔽某些位（如只比较高 8 位）。

4. 发送 FIFO 与轮询

AddMessageToTxFifo(..., PTB)：把报文放进优先发送缓冲区（PTB），然后 ActivateTxRequest(PTB_SEND) 触发发送。
接收用 __HAL_CANFD_GET_RX_FIFO_FILL_LEVEL 轮询是否有数据，再 GetRxMessage 取出。

实验现象

串口打印：

1
2
3

decimal data length: 8
hexadecimal data:
1 2 3 4 5 6 7 8

在回环/正常模式下，发出的 8 字节被自身（或另一节点）正确接收。

常见问题

收不到数据？
- 检查 CANH/CANL 是否接反、是否接了 120Ω 终端电阻、总线是否正常（示波器看差分波形）。
- 过滤器 FilterID/MaskID 与发送 ID 不匹配会被硬件丢弃。
- 单板自测请用 CANFD_MODE_LOOPBACK，可无需外部收发器。
波特率不对/错误帧多？
- 仔细核算 BIT Timing 与 CANFD 的时钟源频率；经典帧与 FD 帧的 Nominal/Data 段参数要分别正确。
想用中断/DMA？
- 同目录有 CANFD_ExtendedID_IT 等中断版；轮询版最简单，适合入门。

小结

CANFD 流程：Init → ConfigFilter → Start → AddMessageToTxFifo → ActivateTxRequest → 等待/读取 Rx。
经典帧每帧 ≤8 字节；FD 帧更长更快。
过滤器决定接收范围；总线必须差分接线 + 终端电阻。

拓展应用

汽车/工业节点通信：定义 ID 优先级与报文矩阵。
多节点组网：用过滤器分组，主从轮询采集传感器。
升级为 CAN-FD：提高数据段波特率，传输大块数据（如固件、图像）。
配合中断实现“收到即处理”的实时通信。

PUYA ESMC — 外部串行存储器控制器（QSPI Flash 读写）

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

ESMC — 外部串行存储器控制器（QSPI Flash 读写）

固件库: PY32F403_Firmware V1.4.5
芯片: PY32F403
源文件: PUYA/PY32F403_Firmware_V1.4.5/Projects/PY32F403-STK/Example/ESMC/ESMC_ReadWrite_Polling/Src/main.c

功能简介

PY32F403 带有 ESMC（External Serial Memory Controller，外部串行存储器控制器），可硬件驱动 QSPI / Octo-SPI / HyperBus 等串行存储器。相比用 GPIO 软件模拟，ESMC 由硬件时序控制器直接发指令/地址/数据，支持单线、双线、四线（Quad）模式，速度快且 CPU 负担小。

本示例演示用 ESMC 驱动板载 P25Q64（容量 8MB 的 QSPI NOR Flash），完成完整写读流程：

准备 4096 字节测试数据（0,1,2,…,255 循环）；
ESMC 初始化（时钟分频、单线模式、关闭双 Flash）；
写使能 → 等状态寄存器 BUSY 清零；
扇区擦除（4KB）；
开启 QE（Quad Enable） 位，使能四线模式；
四线页编程（按 256 字节/页写入）；
四线快读 回读；
校验一致则点亮绿灯。

这是 F403 的“特色外设”示例：把外置 Flash 当大容量存储用，典型用于字库、图片、音频、固件备份。

硬件准备

PY32F403 开发板（板载或外接 P25Q64 QSPI Flash，接 ESMC 的 IO0~IO3 / CLK / CS）
板载 LED（指示结果）
无需串口，结果用 LED 表示

完整代码（核心流程）

#include "main.h"
#define BUFFERSIZE 4096

ESMC_HandleTypeDef hesmc;
ESMC_InitTypeDef   ESMC_initTypeDef;
uint8_t aRxBuffer[BUFFERSIZE];
uint8_t aTxBuffer[BUFFERSIZE];

int main(void)
{
  uint32_t i = 0, cnt = 0, progAddr = 0;
  uint8_t *pData = NULL;
  uint32_t address = 0;

  HAL_Init();
  BSP_LED_Init(LED_GREEN);

  for (i = 0; i < BUFFERSIZE; i++) aTxBuffer[i] = i % 256; /* 测试数据 */

  APP_EsmcInit();              /* 1. ESMC 初始化 */

  APP_WriteEnable();           /* 2. 写使能 */
  while (APP_GetFlashStatus(0x05) & 0x01) {}   /* 等 BUSY 清 */

  APP_EraseSector(address);    /* 3. 扇区擦除 */
  while (APP_GetFlashStatus(P25Q64_READ_STATUS_REG_CMD) & 0x01) {}

  /* 4. 开启 QE 位（四线使能） */
  flashStatus = APP_GetFlashStatus(P25Q64_READ_STATUS_REG_1_CMD);
  flashStatus |= 0x02;
  APP_WriteEnable();
  while (APP_GetFlashStatus(0x05) & 0x01) {}
  APP_SetFlashStatus(flashStatus, P25Q64_WRITE_STATUS_REG_1_CMD);
  while (APP_GetFlashStatus(P25Q64_READ_STATUS_REG_CMD) & 0x01) {}

  /* 5. 分页编程（每页 P25Q64_PAGE_SIZE 字节） */
  cnt = BUFFERSIZE; progAddr = address; pData = aTxBuffer;
  while (cnt / P25Q64_PAGE_SIZE > 0)
  {
    APP_PageProgram(pData, progAddr, P25Q64_PAGE_SIZE);
    while (APP_GetFlashStatus(P25Q64_READ_STATUS_REG_CMD) & 0x01) {}
    cnt      -= P25Q64_PAGE_SIZE;
    progAddr += P25Q64_PAGE_SIZE;
    pData    += P25Q64_PAGE_SIZE;
  }
  if (cnt > 0) { APP_PageProgram(pData, progAddr, cnt);
                 while (APP_GetFlashStatus(P25Q64_READ_STATUS_REG_CMD) & 0x01) {} }

  /* 6. 读取并校验 */
  APP_DataRead(aRxBuffer, address, BUFFERSIZE);
  if (HAL_OK != APP_DataCheck(aRxBuffer, aTxBuffer, BUFFERSIZE))
  {
    BSP_LED_Off(LED_GREEN);
    APP_ErrorHandler();
  }
  BSP_LED_On(LED_GREEN);   /* 成功：绿灯 */
  while (1) {}
}

/* ESMC 初始化：开时钟，配分频/模式 */
static void APP_EsmcInit(void)
{
  __HAL_RCC_ESMC_CLK_ENABLE();
  hesmc.Instance = ESMC;
  ESMC_initTypeDef.ClockPrescaler = 0x8;          /* 时钟分频 */
  ESMC_initTypeDef.ClockMode      = ESMC_CLOCK_MODE_0;
  ESMC_initTypeDef.DualFlash      = ESMC_DUALFLASH_DISABLE;
  hesmc.Init = ESMC_initTypeDef;
  HAL_ESMC_Init(&hesmc);
}

/* 发一条 QSPI 指令：先 HAL_ESMC_Command 描述“指令/地址/数据”格式，再收发数据 */
static void APP_PageProgram(uint8_t *pData, uint32_t addr, uint32_t nBytes)
{
  ESMC_CommandTypeDef cmdStc = {0};
  APP_WriteEnable();
  cmdStc.TransferFormat    = ESMC_TRANSFER_FORMAT_QUAD;  /* 四线传输 */
  cmdStc.InstructionMode   = ESMC_INSTRUCTION_SINGLE_LINE; /* 指令仍单线 */
  cmdStc.Instruction       = P25Q64_QUAD_INPUT_PAGE_PROG_CMD;
  cmdStc.AddressMode       = ESMC_ADDRESS_SINGLE_LINE;
  cmdStc.AddressSize       = ESMC_ADDRESS_24_BITS;
  cmdStc.Address           = addr;
  cmdStc.DataMode          = ESMC_DATA_WRITE;
  cmdStc.NbData            = nBytes;
  cmdStc.CSPinSel          = ESMC_SELECT_PIN_CS0;
  HAL_ESMC_Command(&hesmc, &cmdStc, 0x0000FFFF);
  HAL_ESMC_Transmit(&hesmc, pData, 0x0000FFFF);   /* 送出数据 */
}

代码分段讲解

1. ESMC 的命令模型

ESMC 把一次 Flash 访问拆成 “命令描述 + 数据传输” 两步：

HAL_ESMC_Command()：用 ESMC_CommandTypeDef 描述本次操作的指令码、指令线数（单/双/四）、是否带地址、地址位数、数据方向（读/写）、数据线数、数据长度、CS 引脚等。
随后的 HAL_ESMC_Transmit / Receive：按上面的描述真正搬数据。

这种“描述符 + 传输”模型非常灵活，一套 API 即可适配各种 QSPI 器件。

2. 单线 vs 四线

指令阶段：几乎所有 Flash 都用单线发指令码（INSTRUCTION_SINGLE_LINE），成本低、兼容好。
数据阶段：开启 QE 后可用 ESMC_TRANSFER_FORMAT_QUAD 四线读写，速度翻多倍。
读数据用 P25Q64_1I4O_FAST_READ_CMD（指令单线、数据四线快读），写用 P25Q64_QUAD_INPUT_PAGE_PROG_CMD。

3. 写使能与 BUSY 轮询

QSPI Flash 有写保护：任何擦/写前必须先发 Write Enable（06h）指令；操作期间状态寄存器 BUSY 位为 1，必须轮询等到清零（while (GetFlashStatus & 0x01)）才能下一步。这是所有 SPI NOR Flash 的通用约定。

4. QE 位与页编程

QE（Quad Enable）：状态寄存器 1 的 bit1，置 1 后 IO2/IO3 才用于四线传输；首次使用需写状态寄存器开启。
页编程：P25Q64 每页 256 字节，一次最多写一页；跨页要分多次，且每次写前地址所在扇区需已擦除。

实验现象

程序完成“擦除→写→读→校验”后 绿灯常亮；
任一环节失败则卡在 APP_ErrorHandler（绿灯不亮或熄灭），可结合调试定位。

常见问题

绿灯不亮 / 校验失败？
- 确认板载 Flash 型号确为 P25Q64（指令宏 P25Q64_* 匹配）；不同型号指令/页大小不同。
- 确认 CS/CLK/IO0~IO3 接线与 ESMC 引脚映射一致。
- QE 位未成功开启会导致四线读写失败——检查 APP_SetFlashStatus 流程。
写不进去？
- 写前必须 WriteEnable 且等待上一次 BUSY 清零；目标区必须已擦除（全 0xFF）。
想用 DMA/中断？
- 同目录有 ESMC_ReadWrite_DMA、ESMC_ReadWriteQuad_IT，大批量数据用 DMA 更高效。

小结

ESMC 通过“命令描述符 + 传输”统一驱动 QSPI/Octo 串行存储器。
QSPI Flash 写流程固定：WriteEnable → 等 BUSY → 擦除/编程 → 等 BUSY → 校验。
开 QE 后用四线模式大幅提速；指令通常仍单线发送。

拓展应用

存放字库/图片/UI 资源，MCU 内部 Flash 只放代码。
做“外部数据记录仪”（日志、采样缓存）。
配合 XIP（片上执行）把代码放到外置 Flash 运行，扩展程序空间。
DMA 方式搬运大块音频/视频资源到 LCD/Codec。

PUYA I2S — 主机轮询收发（双板）

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

I2S — 主机轮询收发（双板）

固件库: PY32F403_Firmware V1.4.5
芯片: PY32F403
源文件: PUYA/PY32F403_Firmware_V1.4.5/Projects/PY32F403-STK/Example/I2S/I2S_TwoBoard_CommunicationMaster_Polling/Src/main.c

功能简介

I2S（Inter-IC Sound）是专为数字音频设计的同步串行总线，三线（SCK 位时钟、WS 声道选择、SD 数据）+ 可选 MCLK 主时钟，常用于连接音频 DAC/ADC、CODEC、MEMS 麦克风。

PY32F403 的 SPI2 外设可复用为 I2S。本示例演示主机（Master）轮询收发：

先配置为 I2S_MODE_MASTER_TX，发送 16 个 16 位样本；
再切换为 I2S_MODE_MASTER_RX，接收 16 个样本；
轮询等待每步完成，最后比较收发数据；
一致则点亮绿灯，不一致则闪烁报警。

I2S 与 SPI 分时复用同一组引脚，区别在 HAL_I2S_Init 时选 I2S_* 模式而非 SPI_*。

硬件准备

两块 PY32F403 开发板（一主一发/收，或一块自连回环）
交叉连接 I2S 信号：主 SCK↔从 SCK，主 WS↔从 WS，主 SD↔从 SD（MOSI/MISO），共地
板载 LED / 按键用于交互（示例需按键触发一次传输）

完整代码（主机部分）

#include "main.h"

I2S_HandleTypeDef I2sHandle;
uint16_t TxBuff[16] = {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16};
uint16_t RxBuff[16] = {0};
#define DATA_LENGTH 16

int main(void)
{
  HAL_Init();
  APP_SystemClockConfig();         /* 系统时钟：HSI */
  BSP_LED_Init(LED_GREEN);
  BSP_PB_Init(BUTTON_KEY, BUTTON_MODE_GPIO);

  while (BSP_PB_GetState(BUTTON_KEY) == 1) {}  /* 等按键触发 */

  /* === 主机发送 === */
  I2sHandle.Instance        = SPI2;            /* I2S 复用 SPI2 */
  I2sHandle.Init.Mode       = I2S_MODE_MASTER_TX; /* 主机发送 */
  I2sHandle.Init.Standard   = I2S_STANDARD_PHILIPS; /* 飞利浦标准 */
  I2sHandle.Init.DataFormat = I2S_DATAFORMAT_16B;  /* 16 位数据 */
  I2sHandle.Init.MCLKOutput = I2S_MCLKOUTPUT_DISABLE;
  I2sHandle.Init.AudioFreq  = I2S_AUDIOFREQ_8K;    /* 8kHz 采样率 */
  I2sHandle.Init.CPOL       = I2S_CPOL_HIGH;       /* 时钟极性 */
  if (HAL_I2S_Init(&I2sHandle) != HAL_OK) APP_ErrorHandler();

  if (HAL_I2S_Transmit(&I2sHandle, (uint16_t*)TxBuff, DATA_LENGTH, 5000) != HAL_OK)
    APP_ErrorHandler();
  while (HAL_I2S_GetState(&I2sHandle) != HAL_I2S_STATE_READY) {}

  HAL_Delay(1);  /* 给从机一点准备时间 */

  /* === 主机接收 === */
  I2sHandle.Init.Mode = I2S_MODE_MASTER_RX;     /* 切换为主机接收 */
  if (HAL_I2S_Init(&I2sHandle) != HAL_OK) APP_ErrorHandler();

  if (HAL_I2S_Receive(&I2sHandle, (uint16_t*)RxBuff, DATA_LENGTH, 5000) != HAL_OK)
    APP_ErrorHandler();
  while (HAL_I2S_GetState(&I2sHandle) != HAL_I2S_STATE_READY) {}

  APP_CheckEndOfTransfer();   /* 比较收发，亮灯/闪烁 */
  while (1) {}
}

代码分段讲解

1. 标准与极性

I2S_STANDARD_PHILIPS：标准飞利浦格式（WS 在第二个时钟沿变化，SD 在 WS 变化后一位有效）。另有 MSB/LSB 对齐、PCM 等格式，按 CODEC 手册选。
CPOL：串行时钟空闲极性，必须与对端一致。

2. 采样率 AudioFreq

I2S_AUDIOFREQ_8K 决定 SCK/WS 频率。HAL 会根据系统时钟自动计算分频；常见值 8k/16k/44.1k/48k。实际可用频率受主时钟约束，复杂场景需打开 MCLK 并精确配置。

3. 主机切换发/收

同一 I2sHandle 重新 HAL_I2S_Init 改 Mode 即可在 TX/RX 间切换（本例用两块板对传，先发后收）。真实音频链路通常是固定方向：MCU 做发送端驱动 DAC，或做接收端读 ADC。

4. 轮询

HAL_I2S_Transmit/Receive(..., Timeout) 阻塞直到完成或超时，代码简单但占 CPU。大数据量/连续音频建议用 IT 或 DMA 版（同目录有 _DMA / _IT）。

实验现象

按键后主机发送 {1..16}，再接收一帧；
收发一致（回环或正确对接），绿灯常亮；不一致则绿灯 500ms 闪烁。

常见问题

没声音 / 收不到数据？
- 确认 I2S 引脚（SCK/WS/SD）与 SPI2 复用引脚一致，且主从 Standard/CPOL/DataFormat/AudioFreq 完全相同。
- 主从共地，接线交叉正确。
想连续播放音频？
- 用 HAL_I2S_Transmit_DMA + 双缓冲，从 Flash/SD 卡取 PCM 数据不断送 DAC（如 WM8978、MAX98357A）。
采样率不准/有杂音？
- 检查系统时钟与 MCLK 配置；音频对时钟精度敏感，必要时开 MCLK 输出给 CODEC 作基准。

小结

I2S 配置要点：标准格式、数据位宽、声道极性 CPOL、采样率、主/从模式。
SPI2 可复用为 I2S，引脚与 SPI 相同。
轮询版适合教学；音频流用 DMA/中断。

拓展应用

驱动 I2S DAC（MAX98357A）播放 WAV/提示音。
读取 I2S MEMS 麦克风做录音/声控。
接 CODEC（WM8978）做双向音频（通话/采集）。
DMA + 双缓冲实现不间断音频流。

普冉半导体 (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 示例与之配对，并在对应文档中加以说明。

目录导航

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

PY32F403 on CLing

PUYA CANFD — 经典帧 基址 ID 轮询收发

CANFD — 经典帧 基址 ID 轮询收发

功能简介

硬件准备

完整代码

代码分段讲解

1. 经典帧 vs FD 帧

2. 波特率配置（BIT Timing）

3. 过滤器（Filter）

4. 发送 FIFO 与轮询

实验现象

常见问题

小结

拓展应用

PUYA ESMC — 外部串行存储器控制器（QSPI Flash 读写）

ESMC — 外部串行存储器控制器（QSPI Flash 读写）

功能简介

硬件准备

完整代码（核心流程）

代码分段讲解

1. ESMC 的命令模型

2. 单线 vs 四线

3. 写使能与 BUSY 轮询

4. QE 位与页编程

实验现象

常见问题

小结

拓展应用

PUYA I2S — 主机轮询收发（双板）

I2S — 主机轮询收发（双板）

功能简介

硬件准备

完整代码（主机部分）

代码分段讲解

1. 标准与极性

2. 采样率 AudioFreq

3. 主机切换发/收

4. 轮询

实验现象

常见问题

小结

拓展应用

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

PUYA MCU 示例代码库

固件库版本一览

HAL 库 vs LL 库

目录导航

PUYA CANFD — 经典帧基址 ID 轮询收发

CANFD — 经典帧基址 ID 轮询收发