GPIO_Toggle on CLing

PUYA GPIO — GPIO 翻转输出（HAL 库）

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

GPIO — GPIO 翻转输出（HAL 库）

固件库: PY32F0xx_Firmware V1.5.0
芯片: PY32F030（PY32F002A / F003 同库可参考）
源文件: PUYA/PY32F0xx_Firmware_V1.5.0/Projects/PY32F030-STK/Example/GPIO/GPIO_Toggle/Src/main.c

功能简介

本示例演示如何让一个 GPIO 引脚工作于推挽输出模式，并在主循环中周期性翻转其电平。GPIO（通用输入输出）是 MCU 最基础、最常用的外设，所有“点灯”“驱动继电器”“软件模拟时序”都建立在它之上。

示例中 LED 连接在 PA11（开发板丝印 LED3），程序每 250ms 翻转一次该引脚，人眼即可看到 LED 闪烁。

硬件准备

PY32F030 开发板（或 PY32F002A / F003 官方 STK 板）
板载 LED（PA11，对应 LED3）
一根 USB 数据线用于供电与下载
无需额外外接元件

提示：如果你手上的板子 LED 不在 PA11，请修改下方宏定义中的引脚即可。

完整代码

#include "main.h"

/* 把板载 LED3 映射成一组好记的宏，方便后续修改 */
#define LED_GPIO_PIN          LED3_PIN          /* LED 引脚：PA11 */
#define LED_GPIO_PORT         LED3_GPIO_PORT    /* LED 端口：GPIOA */
#define LED_GPIO_CLK_ENABLE() LED3_GPIO_CLK_ENABLE() /* 开启 GPIOA 时钟 */

/* 静态函数声明：GPIO 初始化 */
static void APP_GpioConfig(void);

int main(void)
{
  /* 1. 复位所有外设，并初始化 HAL 库与 SysTick 时基 */
  HAL_Init();

  /* 2. 配置 LED 引脚为推挽输出 */
  APP_GpioConfig();

  /* 3. 主循环：每 250ms 翻转一次 LED 电平 */
  while (1)
  {
    HAL_Delay(250);                              /* 阻塞延时 250ms */
    HAL_GPIO_TogglePin(LED_GPIO_PORT, LED_GPIO_PIN); /* 翻转引脚电平 */
  }
}

/**
  * @brief  GPIO 引脚配置函数
  */
static void APP_GpioConfig(void)
{
  GPIO_InitTypeDef GPIO_InitStruct = {0};

  LED_GPIO_CLK_ENABLE();                        /* 必须先开时钟，否则配置无效 */

  GPIO_InitStruct.Pin   = LED_GPIO_PIN;
  GPIO_InitStruct.Mode  = GPIO_MODE_OUTPUT_PP;  /* 推挽输出模式 */
  GPIO_InitStruct.Pull  = GPIO_PULLUP;          /* 启用上拉 */
  GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; /* 引脚翻转速度：高速 */
  HAL_GPIO_Init(LED_GPIO_PORT, &GPIO_InitStruct);
}

/**
  * @brief  错误处理：卡死在此处便于调试
  */
void APP_ErrorHandler(void)
{
  while (1)
  {
  }
}

代码分段讲解

1. 时钟使能

LED_GPIO_CLK_ENABLE() 展开为 __HAL_RCC_GPIOA_CLK_ENABLE()。在 PY32（与 STM32 一致）中，任何外设使用前都必须先开启其时钟，否则写寄存器无效。这是初学者最容易遗漏的一步。

2. 引脚模式

GPIO_MODE_OUTPUT_PP：推挽输出。输出高电平时由 VDD 驱动，输出低电平时由内部 NMOS 拉到 GND，驱动能力较强，适合直接驱动 LED。
与之相对的 GPIO_MODE_OUTPUT_OD 为开漏输出，常用于 I2C 等需要“线与”的总线。

3. 翻转与延时

HAL_GPIO_TogglePin()：读取引脚当前电平后取反再写回，是最常用的“闪烁”原语。
HAL_Delay(250)：基于 SysTick 的毫秒级阻塞延时，由 HAL_Init() 内部完成初始化。注意它是阻塞的，期间 CPU 不能做别的事（真实项目推荐用定时器中断替代）。

实验现象

板载 LED（PA11）以约 2Hz（每 250ms 一次）的频率闪烁。
用示波器/逻辑分析仪测量 PA11，可见周期为 500ms 的方波。

常见问题

下载后 LED 不闪？
- 确认引导/下载模式与复位电路正常；确认 LED 实际连接引脚与代码中 LED3_PIN 一致（不同板型可能接在 PB0 / PB1 / PA5）。
- 检查是否选择了正确的芯片型号（PY32F030x8），Flash 容量不同会导致下载失败。
编译报 LED3_PIN 未定义？
- 该宏定义在 Drivers/BSP/PY32F030xx_Start_Kit/py32f030xx_Start_Kit.h 中，确认工程已包含该 BSP 头文件。
闪烁很快/很慢？
- 直接调整 HAL_Delay() 的参数；若使用内部 HSI 且频率与工程设定不一致，实际延时会有偏差。
想用定时器非阻塞闪烁？
- 参考同系列 TIMERx 示例，用定时器更新中断翻转引脚，主循环可空出来做其他任务。

小结

GPIO 输出只需三步：开时钟 → 配置引脚模式 → 写/翻转电平。
HAL_GPIO_TogglePin() + HAL_Delay() 是最简单的闪烁模板，适合作为每个新板子的“点灯”验证程序。
推挽输出（OUTPUT_PP）适合直接驱动 LED；开漏输出（OUTPUT_OD）适合总线应用。

拓展应用

把 HAL_Delay 换成定时器中断，实现“非阻塞”多任务闪烁（如多个 LED 不同频率）。
读取按键（GPIO_INPUT + HAL_GPIO_ReadPin）实现“按键控制 LED 亮灭”。
用 GPIO_SPEED_FREQ_VERY_HIGH 配合精确延时，用单引脚“软”模拟单总线协议（如 DHT11、WS2812）。
结合 PWM（见 TIM1_PWM 示例）做 LED 呼吸灯。

CIU32 GPIO — GPIO 翻转输出

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

GPIO — GPIO 翻转输出

固件库: CIU32F003_STDLib V1.0.3
芯片: CIU32
源文件: CIU32/CIU32F003_STDLib_V1.0.3/Projects/GPIO/GPIO_Toggle/Source/main.c

功能简介

本示例演示如何配置 GPIO 引脚为输出模式，并通过软件翻转引脚电平。GPIO 是 MCU 最基本的外设，几乎所有项目都会用到。

硬件准备

开发板上的 LED 灯（通常连接在 PA5、PB0、PB1 等引脚）
无需额外接线

完整代码

#include "main.h"

int main(void)
{      
    /* ϵͳʱ */
    system_clock_config(); 

    /* Systickʼ */
    std_delay_init();

    /* GPIOʼ */
    gpio_init();

    while(1)
    {
        std_gpio_toggle_pin(LED_GPIO_PORT,LED_PIN);
        std_delayms(300);
    }
}

代码讲解

系统时钟初始化：配置 MCU 的主频和时钟树。不同芯片的时钟配置不同，一般由工具生成。

GPIO 配置：设置引脚为输出/输入模式，选择推挽/开漏输出，配置上拉/下拉。

实验现象

对应 GPIO 引脚电平交替翻转
可用示波器或 LED 观察

注意事项

确认 LED 连接的引脚与代码中一致
输出模式一般选择推挽输出（Push-Pull）

PUYA GPIO — GPIO 翻转输出

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

GPIO — GPIO 翻转输出

固件库: PY32F002B_Firmware V1.2.1
芯片: PUYA
源文件: PUYA/PY32F002B_Firmware_V1.2.1/Projects/PY32F002B-STK/Example/GPIO/GPIO_Toggle/Src/main.c

功能简介

本示例演示如何配置 GPIO 引脚为输出模式，并通过软件翻转引脚电平。GPIO 是 MCU 最基本的外设，几乎所有项目都会用到。

硬件准备

开发板上的 LED 灯（通常连接在 PA5、PB0、PB1 等引脚）
无需额外接线

完整代码

#include "main.h"
#define LED_GPIO_PIN                 LED3_PIN
#define LED_GPIO_PORT                LED3_GPIO_PORT
#define LED_GPIO_CLK_ENABLE()        LED3_GPIO_CLK_ENABLE()

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

实验现象

对应 GPIO 引脚电平交替翻转
可用示波器或 LED 观察

注意事项

确认 LED 连接的引脚与代码中一致
输出模式一般选择推挽输出（Push-Pull）

PUYA GPIO — GPIO 翻转输出

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

GPIO — GPIO 翻转输出

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

功能简介

本示例演示如何配置 GPIO 引脚为输出模式，并通过软件翻转引脚电平。GPIO 是 MCU 最基本的外设，几乎所有项目都会用到。

硬件准备

开发板上的 LED 灯（通常连接在 PA5、PB0、PB1 等引脚）
无需额外接线

完整代码

#include "main.h"
#define LED_GPIO_PIN                 LED3_PIN
#define LED_GPIO_PORT                LED3_GPIO_PORT
#define LED_GPIO_CLK_ENABLE()        LED3_GPIO_CLK_ENABLE()

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

实验现象

对应 GPIO 引脚电平交替翻转
可用示波器或 LED 观察

注意事项

确认 LED 连接的引脚与代码中一致
输出模式一般选择推挽输出（Push-Pull）

PUYA GPIO — GPIO 翻转输出

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

GPIO — GPIO 翻转输出

固件库: PY32L020_Firmware V1.2.1
芯片: PUYA
源文件: PUYA/PY32L020_Firmware_V1.2.1/Projects/PY32L020-STK/Example/GPIO/GPIO_Toggle/Src/main.c

功能简介

本示例演示如何配置 GPIO 引脚为输出模式，并通过软件翻转引脚电平。GPIO 是 MCU 最基本的外设，几乎所有项目都会用到。

硬件准备

开发板上的 LED 灯（通常连接在 PA5、PB0、PB1 等引脚）
无需额外接线

完整代码

#include "main.h"
#define LED_GPIO_PIN                 LED3_PIN
#define LED_GPIO_PORT                LED3_GPIO_PORT
#define LED_GPIO_CLK_ENABLE()        LED3_GPIO_CLK_ENABLE()

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

实验现象

对应 GPIO 引脚电平交替翻转
可用示波器或 LED 观察

注意事项

确认 LED 连接的引脚与代码中一致
输出模式一般选择推挽输出（Push-Pull）

PUYA GPIO — GPIO 翻转输出（LL 库）

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

GPIO — GPIO 翻转输出（LL 库）

HAL vs LL：PUYA 固件库提供 HAL 和 LL 两套 API。

HAL 库：封装度高，可移植性强，适合快速开发

LL 库：接近寄存器操作，代码精简效率高，适合性能敏感场景本文使用 LL 库版本。

固件库: PY32F0xx_Firmware V1.5.0
芯片: PY32F030（PY32F002A / F003 同库可参考）
源文件: PUYA/PY32F0xx_Firmware_V1.5.0/Projects/PY32F030-STK/Example_LL/GPIO/GPIO_Toggle/Src/main.c

功能简介

本示例与 HAL 版功能完全相同：让一个 GPIO 引脚工作于输出模式，主循环里周期性翻转电平，板载 LED（PA11，丝印 LED3）闪烁。区别只在于底层 API 用的是 LL 库而非 HAL 库。

通过这一最简单示例，可以直观体会 HAL 与 LL 的写法差异：

HAL 用 HAL_GPIO_Init() 传一个 GPIO_InitTypeDef 结构体完成配置；
LL 直接调用 LL_GPIO_SetPinMode() 一行设置模式，更接近“操作寄存器”，代码更短、依赖更少。

硬件准备

PY32F030 开发板（或 PY32F002A / F003 官方 STK 板）
板载 LED（PA11，对应 LED3）
一根 USB 数据线用于供电与下载
无需额外外接元件

提示：若你手上板子的 LED 不在 PA11，修改下方 LED3_PIN 相关宏即可。

完整代码

#include "main.h"
#include "py32f030xx_ll_Start_Kit.h"

/* 把板载 LED3 映射成一组好记的宏，方便后续修改 */
#define LED_GPIO_PIN                   LED3_PIN
#define LED_GPIO_PORT                  LED3_GPIO_PORT
#define LED_GPIO_CLK_ENABLE()          LED3_GPIO_CLK_ENABLE()

/* 函数声明 */
static void APP_SystemClockConfig(void);
static void APP_GpioConfig(void);

int main(void)
{
  /* 1. 配置系统时钟（LL 版需要手动配时钟，HAL 在 HAL_Init 里代劳了部分） */
  APP_SystemClockConfig();

  /* 2. 配置 LED 引脚为输出 */
  APP_GpioConfig();

  /* 3. 先熄灭 LED（输出高电平，低电平点亮，取决于硬件） */
  LL_GPIO_SetOutputPin(LED_GPIO_PORT, LED_GPIO_PIN);

  /* 4. 主循环：每 100ms 翻转一次 */
  while (1)
  {
    LL_mDelay(100);                                   /* LL 自带的毫秒延时 */
    LL_GPIO_TogglePin(LED_GPIO_PORT, LED_GPIO_PIN);   /* 翻转引脚电平 */
  }
}

/**
  * @brief  系统时钟配置
  */
static void APP_SystemClockConfig(void)
{
  /* 使能 HSI 并等待就绪 */
  LL_RCC_HSI_Enable();
  while (LL_RCC_HSI_IsReady() != 1) {}

  /* AHB 不分频 */
  LL_RCC_SetAHBPrescaler(LL_RCC_SYSCLK_DIV_1);

  /* 选 HSISYS 作为系统时钟源 */
  LL_RCC_SetSysClkSource(LL_RCC_SYS_CLKSOURCE_HSISYS);
  while (LL_RCC_GetSysClkSource() != LL_RCC_SYS_CLKSOURCE_STATUS_HSISYS) {}

  /* APB1 不分频，并初始化 1ms 时基与系统时钟全局变量 */
  LL_RCC_SetAPB1Prescaler(LL_RCC_APB1_DIV_1);
  LL_Init1msTick(8000000);
  LL_SetSystemCoreClock(8000000);
}

/**
  * @brief  GPIO 引脚配置
  */
static void APP_GpioConfig(void)
{
  /* 必须先开时钟，否则配置无效（LL 不会自动帮你开） */
  LED_GPIO_CLK_ENABLE();

  /* 一行设置引脚为输出模式，复位后默认就是推挽、低速、无上下拉 */
  LL_GPIO_SetPinMode(LED_GPIO_PORT, LED_GPIO_PIN, LL_GPIO_MODE_OUTPUT);

  /* 下面这些都是“复位默认值”，注释掉也能工作，写出来便于理解
  LL_GPIO_SetPinOutputType(LED_GPIO_PORT, LED_GPIO_PIN, LL_GPIO_OUTPUT_PUSHPULL);
  LL_GPIO_SetPinSpeed(LED_GPIO_PORT, LED_GPIO_PIN, LL_GPIO_SPEED_FREQ_LOW);
  LL_GPIO_SetPinPull(LED_GPIO_PORT, LED_GPIO_PIN, LL_GPIO_PULL_NO);
  */
}

/**
  * @brief  错误处理：卡死在此处便于调试
  */
void APP_ErrorHandler(void)
{
  while (1) {}
}

代码分段讲解

1. LL 没有“统一初始化入口”

HAL 版第一行是 HAL_Init()，它顺手初始化了 HAL 库、SysTick、中断优先级等。LL 版没有这个总入口，所以你需要自己调用 APP_SystemClockConfig() 把系统时钟配好，否则 LL_mDelay() 的时基是错的。

2. 时钟使能：LL 更“裸”

HAL：__HAL_RCC_GPIOA_CLK_ENABLE()（由 LED_GPIO_CLK_ENABLE() 宏展开）。
LL：LED_GPIO_CLK_ENABLE() 这个宏本身两版都用，但它的底层就是直接写 RCC 寄存器。关键点：LL 不会在初始化时自动开时钟，忘记开时钟是 LL 初学者最常见的 bug。

3. 引脚配置：结构体 vs 直接函数

HAL：HAL_GPIO_Init() 接收 GPIO_InitTypeDef，一次设置 Pin/Mode/Pull/Speed。
LL：LL_GPIO_SetPinMode() 单功能函数，一行只做一件事。优点是不需要构造结构体、代码更短；缺点是多个属性要分多行写（不过多数属性复位值就是你要的）。

4. 翻转与延时

LL_GPIO_TogglePin() 与 HAL_GPIO_TogglePin() 语义一致，都是读-反-写。
LL_mDelay(100) 对应 HAL 的 HAL_Delay(100)，都是基于 SysTick 的阻塞毫秒延时。注意 LL 版延时前必须先调 LL_Init1msTick() 设定正确的 tick 频率（在 APP_SystemClockConfig 里已做）。

实验现象

板载 LED（PA11）以约 5Hz（每 100ms 一次）的频率闪烁，比 HAL 版（250ms）更快。
用示波器/逻辑分析仪测量 PA11，可见周期约 200ms 的方波。

常见问题

LED 不闪 / 闪得很怪？
- 先确认 APP_SystemClockConfig() 里 LL_Init1msTick() 的参数和 LL_SetSystemCoreClock() 与实际 HSI 频率一致（本例 8MHz）。参数不对，LL_mDelay 时序会整体偏移。
- 确认 LED 实际引脚与 LED3_PIN 一致。
编译报 LL_GPIO_xxx 未定义？
- LL 函数分散在 stm32py32..._ll_gpio.h 等头文件中，确认工程已包含 py32f030xx_ll_Start_Kit.h 以及对应的 LL 驱动头。
想改成非阻塞闪烁？
- 同 HAL 版思路，用 TIM 更新中断翻转引脚；LL 里对应 LL_TIM_xxx 系列函数（见 TIM1_PWM_Init 示例）。

小结

LL 版 GPIO 输出三步依然是：开时钟 → 设模式 → 翻转/写电平，但全部由 LL_GPIO_* / LL_RCC_* 直接操作完成。
与 HAL 的最大区别：LL 没有 HAL_Init() 这种“一站式”初始化，系统时钟、LL_mDelay 时基都要自己配。
代码更短、编译体积更小、对寄存器行为更透明——这是 LL 的核心价值。

拓展应用

把 LL_mDelay 换成 TIM 中断，做多 LED 不同频率非阻塞闪烁。
配合 LL_GPIO_SetPinOutputType() 把引脚设为开漏（LL_GPIO_OUTPUT_OPENDRAIN），驱动需要线与的总线设备。
用 LL_GPIO_ReadInputPort() 读取按键，实现按键控制 LED（LL 版 GPIO_INPUT 思路同 HAL）。
结合 TIM1_PWM_Init 示例，用 LL_TIM_OC_SetCompareCHx() 做呼吸灯。