/********************************************************************************************************************* * MSPM0G3507 Opensource Library 即（MSPM0G3507 开源库）是一个基于官方 SDK 接口的第三方开源库 * Copyright (c) 2022 SEEKFREE 逐飞科技 * * 本文件是 MSPM0G3507 开源库的一部分 * * MSPM0G3507 开源库 是免费软件 * 您可以根据自由软件基金会发布的 GPL（GNU General Public License，即 GNU通用公共许可证）的条款 * 即 GPL 的第3版（即 GPL3.0）或（您选择的）任何后来的版本，重新发布和/或修改它 * * 本开源库的发布是希望它能发挥作用，但并未对其作任何的保证 * 甚至没有隐含的适销性或适合特定用途的保证 * 更多细节请参见 GPL * * 您应该在收到本开源库的同时收到一份 GPL 的副本 * 如果没有，请参阅 * * 额外注明： * 本开源库使用 GPL3.0 开源许可证协议 以上许可申明为译文版本 * 许可申明英文版在 libraries/doc 文件夹下的 GPL3_permission_statement.txt 文件中 * 许可证副本在 libraries 文件夹下 即该文件夹下的 LICENSE 文件 * 欢迎各位使用并传播本程序 但修改内容时必须保留逐飞科技的版权声明（即本声明） * * 文件名称 zf_common_debug * 公司名称 成都逐飞科技有限公司 * 版本信息 查看 libraries/doc 文件夹内 version 文件 版本说明 * 开发环境 MDK 5.37 * 适用平台 MSPM0G3507 * 店铺链接 https://seekfree.taobao.com/ * * 修改记录 * 日期 作者 备注 * 2025-06-1 SeekFree first version ********************************************************************************************************************/ #ifndef _zf_common_debug_h_ #define _zf_common_debug_h_ #include "zf_common_typedef.h" #define DEBUG_UART_INDEX ( UART_0 ) // 指定 debug uart 所使用的的串口 #define DEBUG_UART_BAUDRATE ( 115200 ) // 指定 debug uart 所使用的的串口波特率 #define DEBUG_UART_TX_PIN ( UART0_TX_A10 ) // 指定 debug uart 所使用的的串口引脚 #define DEBUG_UART_RX_PIN ( UART0_RX_A11 ) // 指定 debug uart 所使用的的串口引脚 #define DEBUG_UART_USE_INTERRUPT ( 1 ) // 是否启用 debug uart 接收中断 #if DEBUG_UART_USE_INTERRUPT // 条件编译 只有在启用串口中断才编译 #define DEBUG_UART_PRIORITY (UART0_INT_IRQn) // 对应串口中断的中断编号 mspm0g350x IRQn_Type 枚举体 #define DEBUG_UART_PRIORITY0_7 (1) // 中断优先级 #endif //------------------------------------------------------------------------------------------------------------------- // 函数简介 断言 // 参数说明 x 判断是否触发断言 0-触发断言 1-不触发断言 // 返回参数 void // 使用示例 zf_assert(0); // 备注信息 一般用于参数判断 zf_assert(0) 就断言报错 // 默认情况下会在 Debug UART 输出 // 但如果使用开源库内屏幕接口初始化了屏幕 则会在屏幕上显示 //------------------------------------------------------------------------------------------------------------------- #define zf_assert(x) ( debug_assert_handler((x), __FILE__, __LINE__) ) //------------------------------------------------------------------------------------------------------------------- // 函数简介 Log 信息输出 // 参数说明 x 判断是否触发输出 0-触发输出 1-不触发输出 // 参数说明 *str 需要输出的 Log 信息 // 返回参数 void // 使用示例 zf_log(0, "Error"); // 备注信息 调试信息输出 用来做一些报错或者警告之类的输出 // 默认情况下会在 Debug UART 输出 // 但如果使用开源库内屏幕接口初始化了屏幕 则会在屏幕上显示 //------------------------------------------------------------------------------------------------------------------- #define zf_log(x, str) ( debug_log_handler((x), (str), __FILE__, __LINE__) ) typedef struct { uint16 type_index; // 显示类型 0-串口 1-屏幕 uint16 display_x_max; // 屏幕显示范围 uint16 display_y_max; // 屏幕显示范围 uint8 font_x_size; // 屏幕显示字体大小 uint8 font_y_size; // 屏幕显示字体大小 void (*output_uart) (const char *str); // 串口显示函数指针 void (*output_screen) (uint16 x, uint16 y, const char *str); // 屏幕字符串显示函数指针 void (*output_screen_clear) (void); // 屏幕清屏函数指针 }debug_output_struct; uint32 debug_send_buffer (const uint8 *buff, uint32 len); // 调试串口发送缓冲区 #define DEBUG_RING_BUFFER_LEN ( 64 ) // 定义环形缓冲区大小 默认 64byte void debug_interrupr_handler (void); uint32 debug_read_ring_buffer (uint8 *buff, uint32 len); void debug_assert_enable (void); void debug_assert_disable (void); void debug_assert_handler (uint8 pass, char *file, int line); void debug_log_handler (uint8 pass, char *str, char *file, int line); void debug_output_struct_init (debug_output_struct *info); void debug_output_init (debug_output_struct *info); void debug_init (void); #endif