G32S10 Bus Monitor LL 接口

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

1.1 基础辅助接口

1.1.1 ll_bus_monitor_is_channel_valid

bool ll_bus_monitor_is_channel_valid(uint32_t channel);

功能说明： 判断通道序号是否在 0~`7` 范围内。

参数表：

返回值表：

1.1.2 ll_bus_monitor_is_channel_mask_valid

bool ll_bus_monitor_is_channel_mask_valid(uint32_t channel_mask);

功能说明： 判断通道 bitmask 是否非空且仅包含 bit0~bit7。

参数表：

返回值表：

1.1.3 ll_bus_monitor_channel_mask_from_index

uint32_t ll_bus_monitor_channel_mask_from_index(uint32_t channel);

功能说明： 根据通道序号生成对应 bitmask；通道非法时返回 0。

参数表：

返回值表：

1.1.4 ll_bus_monitor_is_axi_channel

bool ll_bus_monitor_is_axi_channel(uint32_t channel);

功能说明： 判断通道是否为 AXI 通道。CH0~CH4、CH7 为 AXI 通道。

参数表：

返回值表：

1.1.5 ll_bus_monitor_is_ahb_channel

bool ll_bus_monitor_is_ahb_channel(uint32_t channel);

功能说明： 判断通道是否为 AHB 通道。CH5、CH6 为 AHB 通道。

参数表：

返回值表：

1.2 带宽监测控制接口

1.2.1 ll_bus_monitor_set_auto_mode

void ll_bus_monitor_set_auto_mode(uint32_t channel_mask);

功能说明： 将指定通道配置为自动停止模式，对应 CH_FUN_CTRL.CHn_FUN_MODE = 0。

参数表：

返回值表：

1.2.2 ll_bus_monitor_set_manual_mode

void ll_bus_monitor_set_manual_mode(uint32_t channel_mask);

功能说明： 将指定通道配置为手动停止模式，对应 CH_FUN_CTRL.CHn_FUN_MODE = 1。

参数表：

返回值表：

1.2.3 ll_bus_monitor_enable_channels

void ll_bus_monitor_enable_channels(uint32_t channel_mask);

功能说明： 启动指定通道带宽监测，对应 CH_FUN_CTRL.CHn_FUN_EN = 1。

参数表：

返回值表：

1.2.4 ll_bus_monitor_disable_channels

void ll_bus_monitor_disable_channels(uint32_t channel_mask);

功能说明： 停止指定通道带宽监测，对应 CH_FUN_CTRL.CHn_FUN_EN = 0。

参数表：

返回值表：

1.2.5 ll_bus_monitor_clear_channels

void ll_bus_monitor_clear_channels(uint32_t channel_mask);

功能说明： 清除指定通道带宽监测计数器，对应 CH_FUN_CTRL.CHn_FUN_CLR = 1。

参数表：

返回值表：

1.2.6 ll_bus_monitor_set_clk_threshold

void ll_bus_monitor_set_clk_threshold(uint32_t channel, uint32_t threshold);

功能说明： 设置单个通道自动停止阈值，对应 CH_CLK_THRES[n]。

参数表：

返回值表：

1.3 带宽监测中断接口

1.3.1 ll_bus_monitor_enable_done_irq

void ll_bus_monitor_enable_done_irq(uint32_t channel_mask);

功能说明： 使能指定通道 done 中断，对应 CH_INT_CTRL.CHn_INT_EN = 1。

参数表：

返回值表：

1.3.2 ll_bus_monitor_disable_done_irq

void ll_bus_monitor_disable_done_irq(uint32_t channel_mask);

功能说明： 关闭指定通道 done 中断，对应 CH_INT_CTRL.CHn_INT_EN = 0。

参数表：

返回值表：

1.3.3 ll_bus_monitor_clear_done_irq

void ll_bus_monitor_clear_done_irq(uint32_t channel_mask);

功能说明： 清除指定通道 done 中断状态，对应 CH_INT_CTRL.CHn_INT_CLR = 1。

参数表：

返回值表：

1.3.4 ll_bus_monitor_get_done_status

uint32_t ll_bus_monitor_get_done_status(void);

功能说明： 读取 CH_INT_STATE.CHn_CNT_DONE 状态 bitmask。

参数表：

返回值表：

1.4 计数读取接口

1.4.1 ll_bus_monitor_get_val_clk_num

uint32_t ll_bus_monitor_get_val_clk_num(uint32_t channel);

功能说明： 读取单个通道 VAL_CLK_NUM[n]。

参数表：

返回值表：

1.4.2 ll_bus_monitor_get_wval_hit_num

uint32_t ll_bus_monitor_get_wval_hit_num(uint32_t channel);

功能说明： 读取单个通道 WVAL_HIT_NUM[n]。

参数表：

返回值表：

1.4.3 ll_bus_monitor_get_rval_hit_num

uint32_t ll_bus_monitor_get_rval_hit_num(uint32_t channel);

功能说明： 读取单个通道 RVAL_HIT_NUM[n]。

参数表：

返回值表：

1.5 Debug LL 接口

1.5.1 ll_bus_monitor_enable_debug

void ll_bus_monitor_enable_debug(void);

功能说明： 使能 debug 模式，对应 DBG_TRANS_EN.DEBUG_EN = 1。

参数表：

返回值表：

1.5.2 ll_bus_monitor_disable_debug

void ll_bus_monitor_disable_debug(void);

功能说明： 关闭 debug 模式，对应 DBG_TRANS_EN.DEBUG_EN = 0。

参数表：

返回值表：

1.5.3 ll_bus_monitor_get_debug_enable

bool ll_bus_monitor_get_debug_enable(void);

功能说明： 读取当前 debug 使能状态。

参数表：

返回值表：

1.5.4 ll_bus_monitor_set_debug_threshold

void ll_bus_monitor_set_debug_threshold(uint32_t channel, uint32_t threshold);

功能说明： 设置单个通道 debug 超时阈值，对应 DBG_THRES[n]。

参数表：

返回值表：

1.5.5 ll_bus_monitor_set_debug_addr_start

void ll_bus_monitor_set_debug_addr_start(uint32_t channel, uint32_t addr_start);

功能说明： 设置单个通道 debug 地址范围最小值，对应 DBG_ADDR_START[n]。

参数表：

返回值表：

1.5.6 ll_bus_monitor_set_debug_addr_end

void ll_bus_monitor_set_debug_addr_end(uint32_t channel, uint32_t addr_end);

功能说明： 设置单个通道 debug 地址范围最大值，对应 DBG_ADDR_END[n]。

参数表：

返回值表：

1.5.7 ll_bus_monitor_get_debug_channel_raw

uint32_t ll_bus_monitor_get_debug_channel_raw(uint32_t channel);

功能说明： 读取单个通道 debug 原始寄存器值，对应 DBG_DDRC_CHn。

参数表：

返回值表：

1.5.8 ll_bus_monitor_get_debug_sort_raw

uint32_t ll_bus_monitor_get_debug_sort_raw(void);

功能说明： 读取 DBG_SORT 原始值。

参数表：

返回值表：

1.5.9 ll_bus_monitor_get_debug_system0_raw

uint32_t ll_bus_monitor_get_debug_system0_raw(void);

功能说明： 读取 DBG_SYSTEM_0 原始值。

参数表：

返回值表：

1.5.10 ll_bus_monitor_get_debug_system1_raw

uint32_t ll_bus_monitor_get_debug_system1_raw(void);

功能说明： 读取 DBG_SYSTEM_1 原始值。

参数表：

返回值表：

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

2.1 寄存器映射

2.2 CH_FUN_CTRL 位域

2.3 CH_INT_CTRL 与 CH_INT_STATE 位域

2.4 AXI debug 状态位域

AXI 通道 CH0~CH4、CH7 的 DBG_DDRC_CHn 使用以下位域：

2.5 AHB debug 状态位域

AHB 通道 CH5、CH6 的 DBG_DDRC_CHn 使用以下位域：