纸飞机调试助手文档 ComAssistant Docs

文本数据分窗（TEXT协议）

文本数据分窗（TEXT协议）

适用场合

TEXT协议适用于需要多任务、数据需要分类提取、不需要精确时间信息、支持文本数据的场合

协议介绍

TEXT协议是纸飞机设计的简易文本协议，具有实现简单、可读性好、拓展性强的特点，支持多窗口绘图和数据分窗的功能。TEXT协议格式如下：

{title}string

其中：

  • title是自定义的英文标题，你可以取任何你喜欢的title，通常我喜欢按照功能来取名
  • string是你想要打印的英文内容，注意这是一个换行符（0x0A）结尾的字符串，软件会自动将string内容统一放置到名为title的接收窗口中，同时当string为逗号分隔数字时（如1,2,3,4）纸飞机便可以自动地进行绘图

    • 多窗口分窗演示

    首先我们要确保软件选择了正确的协议 在这里插入图片描述

    打开了数据分窗功能，并打开串口 在这里插入图片描述

    让我们看一下示例数据，假定以下数据就是纸飞机串口工具接收到的数据

    // 注意：每行数据后都有一个不可见字符换行符（\n）结尾
{plotter}0,1,2
{adc}voltage=6, current=7
{plotter}3,4,5
{adc}voltage=8, current=9

    这组数据可以这样理解：

  • 第一、三行的数据包的title为plotter，string分别为0,1,2和3,4,5。根据规则"当string为逗号分隔数字时，软件会自动绘图"，所以这两行数据会被纸飞机绘图
  • 第二、四行的数据包为adc，数据包的内容分别为voltage=4, current=5和voltage=8, current=9，不满足"逗号分隔数字"的绘图规则，所以不会被绘图，但是分窗功能对string的形式没有要求，这两行数据可以被分窗

    • 分窗结果如下： 文档截图 01