G32S10 MIPI DSI HAL 接口

1. 资源模型与公开类型

1.1 初始化数据包

lcd_panel_dsi_packet_t 描述一条 DSI command packet：

lcd_panel_t.dsi_init_packets 及其计数由 hal_dsi_send_init_packets() 按数组顺序发送。

2. HAL 接口规范

2.1 HAL 接口

2.1.1 hal_dsi_init

error_code_t hal_dsi_init(dsi_regs_t *dsix, dphy_tx_regs_t *phyx, const lcd_panel_t *panel);

功能说明：初始化唯一的 DSI HAL 实例，并配置 host 和 D-PHY。

参数表：

返回值表：

2.1.2 hal_dsi_deinit

error_code_t hal_dsi_deinit(dsi_regs_t *dsix);

功能说明：反初始化 DSI host 和 D-PHY TX。

参数表：

返回值表：

2.1.3 hal_dsi_enter_command_mode

error_code_t hal_dsi_enter_command_mode(dsi_regs_t *dsix);

功能说明：进入 command mode，并使用低功耗 lane 发送命令包。

参数表：

返回值表：

2.1.4 hal_dsi_enter_video_mode

error_code_t hal_dsi_enter_video_mode(dsi_regs_t *dsix, const lcd_panel_t *panel);

功能说明：配置视频时序并进入 video mode。

参数表：

返回值表：

2.1.5 hal_dsi_send_packet

error_code_t hal_dsi_send_packet(dsi_regs_t *dsix,
                                 uint8_t vc,
                                 const lcd_panel_dsi_packet_t *packet,
                                 uint32_t timeout_us);

功能说明：发送一条 DSI 命令数据包。

参数表：

返回值表：

2.1.6 hal_dsi_read_packet

error_code_t hal_dsi_read_packet(dsi_regs_t *dsix,
                                 uint8_t vc,
                                 const lcd_panel_dsi_packet_t *packet,
                                 uint8_t *data_out,
                                 uint32_t data_len,
                                 uint32_t timeout_us);

功能说明：发送一条 DSI 读命令并读取响应 payload。

参数表：

返回值表：

2.1.7 hal_dsi_send_init_packets

error_code_t hal_dsi_send_init_packets(dsi_regs_t *dsix,
                                       const lcd_panel_t *panel,
                                       uint32_t timeout_us);

功能说明：按面板定义顺序发送全部 DSI 初始化数据包。

参数表：

返回值表：

2.1.8 hal_dsi_enter_ulpm

error_code_t hal_dsi_enter_ulpm(dsi_regs_t *dsix);

功能说明：请求 D-PHY clock lane 和 data lane 进入 ULPM。

参数表：

返回值表：

2.1.9 hal_dsi_exit_ulpm

error_code_t hal_dsi_exit_ulpm(dsi_regs_t *dsix);

功能说明：请求 D-PHY clock lane 和 data lane 退出 ULPM。

参数表：

返回值表：

2.1.10 hal_dsi_get_dphy_status

error_code_t hal_dsi_get_dphy_status(dsi_regs_t *dsix, uint32_t *status_out);

功能说明：读取 PHY_STATUS 寄存器。

参数表：

返回值表：

2.1.11 hal_dsi_get_command_status

error_code_t hal_dsi_get_command_status(dsi_regs_t *dsix, uint32_t *status_out);

功能说明：读取 CMD_PKT_STATUS 寄存器。

参数表：

返回值表：

2.1.12 hal_dsi_get_irq_status

error_code_t hal_dsi_get_irq_status(dsi_regs_t *dsix,
                                        uint32_t *status0_out,
                                        uint32_t *status1_out);

功能说明：读取 INT_ST0 和 INT_ST1 寄存器。

参数表：

返回值表：

2.1.13 hal_dsi_dump_regs

error_code_t hal_dsi_dump_regs(dsi_regs_t *dsix);

功能说明：将 DSI host 寄存器状态输出到日志。

参数表：

返回值表：