G32S10 WDT LL 接口

1. LL 与基础辅助接口规范

1.1 LL 层实现边界

LL 层接口是寄存器访问的薄封装，特点如下。

• 通过 static inline 方式提供。

• 不维护软件状态。

• 不做完整业务流程编排。

• 一般不返回 error_code_t。

• 调用者需要保证实例和参数合法。

1.2 LL 层公开宏

LL 层直接使用 wdt_regs.h 中的寄存器和位域宏。

1.3 实例辅助与时钟状态

1.3.1 ll_wdt_is_instance

static inline bool ll_wdt_is_instance(const wdt_regs_t *wdtx);

功能：判断指针是否为 SDK 识别的 WDT 实例。

1.3.2 ll_wdt_is_hp_instance

static inline bool ll_wdt_is_hp_instance(const wdt_regs_t *wdtx);

功能：判断指针是否为 HP_WDT。

1.3.3 ll_wdt_clock_status_get

static inline uint32_t ll_wdt_clock_status_get(wdt_regs_t *wdtx);

功能：读取 WDT clock status 寄存器。

1.3.4 ll_wdt_clock_disable

static inline void ll_wdt_clock_disable(wdt_regs_t *wdtx);

功能：写 clock disable 寄存器，请求关闭 WDT 模块时钟。

1.3.5 ll_wdt_clock_enable

static inline void ll_wdt_clock_enable(wdt_regs_t *wdtx);

功能：写 clock enable 寄存器，请求打开 WDT 模块时钟。

1.4 FULL、计数器和喂狗

1.4.1 ll_wdt_full_set

static inline void ll_wdt_full_set(wdt_regs_t *wdtx, uint32_t value);

功能：写 FULL 寄存器。

补充说明：调用者应保证 value 不超过 WDT_COUNTER_MAX。

1.4.2 ll_wdt_full_get

static inline uint32_t ll_wdt_full_get(wdt_regs_t *wdtx);

功能：读取 FULL 寄存器。

1.4.3 ll_wdt_counter_enable

static inline void ll_wdt_counter_enable(wdt_regs_t *wdtx);

功能：使能 WDT 计数器。

1.4.4 ll_wdt_counter_disable

static inline void ll_wdt_counter_disable(wdt_regs_t *wdtx);

功能：关闭 WDT 计数器。

1.4.5 ll_wdt_count_get

static inline uint32_t ll_wdt_count_get(wdt_regs_t *wdtx);

功能：读取当前 WDT 计数值。

1.4.6 ll_wdt_counter_clear

static inline void ll_wdt_counter_clear(wdt_regs_t *wdtx);

功能：清 WDT 计数器，通常用于喂狗。

1.5 CONTROL 位域

1.5.1 ll_wdt_control_get

static inline uint32_t ll_wdt_control_get(wdt_regs_t *wdtx);

功能：读取 CONTROL 寄存器。

1.5.2 ll_wdt_prescaler_set

static inline void ll_wdt_prescaler_set(wdt_regs_t *wdtx, uint8_t prescaler);

功能：设置 WDT 分频字段。

1.5.3 ll_wdt_prescaler_get

static inline uint8_t ll_wdt_prescaler_get(wdt_regs_t *wdtx);

功能：读取 WDT 分频字段编码。

1.5.4 ll_wdt_rtc_clock_enable

static inline void ll_wdt_rtc_clock_enable(wdt_regs_t *wdtx);

功能：使能 CONTROL 寄存器中的 RTC 时钟输入位。

1.5.5 ll_wdt_rtc_clock_disable

static inline void ll_wdt_rtc_clock_disable(wdt_regs_t *wdtx);

功能：关闭 CONTROL 寄存器中的 RTC 时钟输入位。

1.5.6 ll_wdt_reset_mode_set

static inline void ll_wdt_reset_mode_set(wdt_regs_t *wdtx, uint32_t mode);

功能：设置 WDT 复位模式字段。

1.5.7 ll_wdt_reset_mode_get

static inline uint32_t ll_wdt_reset_mode_get(wdt_regs_t *wdtx);

功能：读取当前 WDT 复位模式字段。

1.6 中断和状态

1.6.1 ll_wdt_interrupt_status_get

static inline uint32_t ll_wdt_interrupt_status_get(wdt_regs_t *wdtx);

功能：读取 WDT 中断状态寄存器。

1.6.2 ll_wdt_interrupt_status_clear

static inline void ll_wdt_interrupt_status_clear(wdt_regs_t *wdtx);

功能：在 FULL 状态已置位后清除 WDT FULL 中断状态。

补充说明：

• 受 G32S10 IR_CLR IC 限制，不能在启动或初始化阶段调用该接口预清状态。

• LL 实现会先读取 IR[25]，只有 FULL 已置位时才写 IR_CLR。

1.6.3 ll_wdt_interrupt_mask_get

static inline uint32_t ll_wdt_interrupt_mask_get(wdt_regs_t *wdtx);

功能：读取 WDT 中断 mask 状态寄存器。

1.6.4 ll_wdt_interrupt_enable

static inline void ll_wdt_interrupt_enable(wdt_regs_t *wdtx);

功能：使能 WDT FULL 中断。

补充说明：

• WDT IE 位采用 mask 语义，写 ie_clr 清除 mask，FULL 中断进入 unmasked 状态。

1.6.5 ll_wdt_interrupt_disable

static inline void ll_wdt_interrupt_disable(wdt_regs_t *wdtx);

功能：关闭 WDT FULL 中断。

补充说明：

• WDT IE 位采用 mask 语义，写 ie_set 设置 mask，FULL 中断进入 masked 状态。

1.6.6 ll_wdt_pending_get

static inline uint32_t ll_wdt_pending_get(wdt_regs_t *wdtx);

功能：读取当前有效 pending 中断。

补充说明：

• pending 通常由中断状态和中断使能共同决定。

• HAL IRQ handler 使用该接口判断是否需要调用用户回调。

1.7 软复位

1.7.1 ll_wdt_soft_reset

static inline void ll_wdt_soft_reset(wdt_regs_t *wdtx);

功能：向 SOFT_RST 寄存器写入触发值，触发 WDT 模块软复位。

1.7.2 ll_wdt_soft_reset_status_get

static inline uint32_t ll_wdt_soft_reset_status_get(wdt_regs_t *wdtx);

功能：读取软复位状态寄存器。

1.7.3 ll_wdt_soft_reset_status_clear

static inline void ll_wdt_soft_reset_status_clear(wdt_regs_t *wdtx);

功能：清除软复位完成状态。

2. 寄存器映射与位域约定

2.1 寄存器结构体

wdt_regs_t 按 WDT 寄存器偏移定义。

2.2 关键位域

2.3 寄存器辅助宏

wdt_regs.h 保留以下寄存器辅助宏，用于 LL 层实现位域读写。