#ifndef PWR_HOLD_H
#define PWR_HOLD_H

#include "gd32f4xx.h"
#include "board_config.h"

/**
 * @brief 初始化电源保持脚（PA11，PMOS 自锁保持）。
 * @details 在 main 入口、一切外设初始化之前调用：推挽输出高，立即维持
 *          PMOS 导通（手动上电后由 MCU 接替按键/外部电路保持供电）。
 *          引脚定义见 board_config.h 的 PWR_HOLD_*。
 */
void pwr_hold_init(void);

/**
 * @brief 保持脚置高（PMOS 导通，维持供电）。
 */
void pwr_hold_on(void);

/**
 * @brief 保持脚置低（预留软关机：PMOS 断开，设备自行掉电）。
 * @warning 调用后本系统失电，函数不会返回——仅用于软关机流程收尾。
 */
void pwr_hold_off(void);

#endif // PWR_HOLD_H