纸飞机调试助手文档 ComAssistant Docs

多窗口绘图(STAMP协议)

多窗口绘图(STAMP协议)

适用场合

STAMP协议适用于需要由下位机来指定X轴或者时间信息的场合

STAMP协议介绍

STAMP协议是[[04-多窗口绘图-文本数据-text协议]]的拓展,读者朋友可以跳转阅读,相比于TEXT协议,STAMP协议可以由下位机来指定X轴,大多数情况下X轴用来填充系统运行时间,用于数据和时间对齐有较高要求的场合。STAMP协议格式如下:

{title}string

其中:

  • 对于同一个title,不同行的stamp一定是递增的实数数据
  • title是自定义的英文标题,你可以取任何你喜欢的title,通常我喜欢按照功能来取名
  • string是你想要打印的英文内容,注意这是一个换行符(0x0A)结尾的字符串,当string为逗号分隔数字时(如1,2,3,4)纸飞机便可以自动地进行绘图
  • 绘图演示

    首先我们要确保软件选择了正确的协议,打开数据可视化,并打开串口 在这里插入图片描述

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

    // 注意:每行数据后都有一个不可见字符换行符(\n)结尾
    {plotter}1,2,3
    {plotter}4,5,6

    这组数据可以这样理解:

  • 第一行是一组名为plotter的数据包,时间信息是0.2,数据包的内容是1,2,3,分别代表了3根曲线的一组点;
  • 第二行又是一组名为plotter的数据包,时间信息是0.4,数据包的内容是4,5,6,分别代表了3根曲线的一组点;
  • 所以这个示例数据里,plotter数据包里包含了3条曲线,每条曲线都有2个数据点
  • 绘图结果如下 在这里插入图片描述

    多窗口绘图

    上一节我们实现了单窗口绘图,这一节演示一下多窗口绘图,这在多任务工作时非常有用。利用协议中的title属性就可以轻松实现。示例数据如下

    {voltage}1,2
    {current}3,4
    {voltage}5,6
    {current}7,8

    这组数据展示了两组数据,分别是voltage和current,纸飞机可以自动识别出不同的title,并显示在不同的窗口 在这里插入图片描述

    双击窗口标题即可快速独立显示窗口 在这里插入图片描述

    注意:时间戳禁止出现回滚,如果回滚必须清空一下曲线,否则曲线绘制也会回滚!!