主题中讨论的其他器件：SysConfig
CC23XX 调试日志记录特性
我们最近在 CC23xx 器件的 SimpleLink 低功耗 F3 SDK 上发布了新的调试记录功能。 日志功能使用户能够将调试消息输出到 IDE 中的日志中、类似于串行终端中的 UART 消息。 这样可以通过使用上一张幻灯片中显示的 而无需使用 UART 外设 。 这篇文章将提供一些示例、以帮助实现此功能。
日志驱动程序示例
日志示例 包含在 CC23xx 的 SimpleLink 低功耗 F3 SDK 中。 日志示例展示了日志驱动程序的工作原理、是向自定义项目添加日志功能的有用参考。 该驱动程序实现了输出可通过运行时对象查看器(ROV)查看的自定义调试消息所需的功能。 示例日志工程中包括一个计数器、该计数器每五秒输出更新的数字、以及两个初始"Hello World！" 输出、以确认日志正在工作。
向其它程序添加日志功能
日志功能可以添加到 SDK 中的任何其他工程。 为此、请通过 SysConfig 添加日志模块。 这些 SysConfig 日志模块可以出于不同的目的进行自定义、在此示例中、使用了日志驱动程序示例中的默认名称和设置。 在日志 SysConfig 模块中、您可以自定义日志的发送位置、并过滤日志驱动程序发送的调试消息。
要在任何程序中实现日志功能、首先应添加预定义符号(ti_log_log_enable)以启用日志功能。 通过右键点击工程并转至 Properties->Build->Arm compiler->Predefined Symbols、可以找到预定义符号段。 下图显示了要添加的内容。
此外、还需要在"文件搜索路径"中添加头文件。
默认路径： $｛COM_TI_SIMPLELINK_LOWPOWER_F3_SDK_INSTALL_DIR｝/source/ti/log/lib/ticlang/m0p/log_cc23x0r5.a
右键点击工程并转到"Properties"->"Build"->"Arm Linker"->"File Search Path"即可访问文件搜索路径。 下面的第二个图像将显示需要添加到 包括库文件或命令文件作为输入(--library、-l) 。
接下来、需要设置 SysConfig 中的模块。 根据应用的不同、模块的设置可能有所不同、但对于此示例、可以使用日志驱动程序示例的默认模块。 此图 显示了一个 设置示例、包括全局参数部分。
在此图中、创建了两个模块。
需要将针对日志的 include 语句添加到 BLE 示例的主程序和主程序的 include 部分中。 除此之外、下面的两行代码应该被添加到程序的主函数中。
下面两行代码是如何向 LogModule_App1和 LogModule_App2发送具有调试日志级别的调试消息。
之后、需要在调试模式下运行程序。 要打开日志菜单、请转至 Tools -> Runtime Object View。 在 ROV 中、打开 LogSinkBuf。 在这里有两个"Hello World！" 应看到输出。
上图中圈出了"Constant refresh"按钮。 当以恒定速率接收消息时、此功能非常有用。
附加的 print 语句可添加到不同的函数和中断。 这样可以简化信息的调试和输出。 有关此特性的更多信息、请阅读 《BLE5堆栈用户指南》中包含的 TI 驱动程序 API 指南中的日志 API 说明。
