Skip to content

逻辑分析仪页面帮助 ​

整理自当前功能页问号帮助,参数与时序差异已按当前实现校正。返回操作步骤。

这个页面在做什么 ​

用 PIO 采样 GPIO,送到浏览器绘制波形并做软件协议解码。它是数字逻辑分析,不测模拟电压幅度。切换网页不会自动停止采集;需要释放引脚时主动停止。

引脚与通道 ​

可用 GPIO2–5、GPIO8–11;通道数为 1、2、4,采集从起始脚开始的连续引脚,不能跨过未引出的区间。4 通道只能从 GPIO2 或 GPIO8 开始;2 通道只能从能容纳完整两脚的起点开始。

采样率与带宽 ​

自由运行预设为 5k、10k、20k、50k、100k、200k、500k、1M、2M、5M samples/s。非自由运行额外提供 10M、20M、50M、100M、200M。实际采样率见状态,不假设与请求值完全一致。

打包原始数据约为采样率×通道数÷8 字节/秒,未计协议开销;压缩效果取决于信号变化。高速档、分数分频和连续 USB 吞吐都需结合实际状态验证。

触发 ​

  • 自由运行:连续采样并实时传输。
  • 上升沿/下降沿:硬件等待指定脚的下一次边沿,然后采集一段数据。触发脚可在采样范围内或范围外。
  • 手动:点击「手动触发」才开始采样。
  • 非自由运行模式采满缓冲或达到指定深度后停止,再传输结果,不保留预触发数据;T 标在首个采样点。
  • 高速档位显示实际平均采样率;采用分数分频时,采样间隔存在抖动。

深度、窗口与缓存 ​

深度决定采多少,窗口决定看多长;二者不是同一参数。浏览器按采样率、通道数、窗口和设备能力分配环形历史,后到数据会覆盖最旧数据,超出历史的数据不能通过缩放找回。

板上 DMA A/B 是另一层缓冲;不要把浏览器几十或几百 MB 的历史容量当作 MCU RAM。运行中可改显示窗口,不改变已设定的采样硬件时钟。

缩放与平移 ​

  • 滚轮:以鼠标所在的位置为中心缩放。
  • 工具栏:放大 / 缩小 / 适应(把采到的全部铺满窗口)/ 跟随最新数据(让最新的采样贴着右边缘,采集时默认开着)。
  • 平移画面:在顶部的时间标尺上左右拖动,波形跟着手走;按住右键或 Shift 在波形上拖、或者在触摸屏上直接用手指拖,也一样。
  • 只有采到的数据能显示:窗口比已采的长时,画面上是已经采到的全部,不会空出一块。
  • 触摸屏:双指张开放大、合拢缩小,缩放中心跟随双指中点;单指拖动平移,轻点依次放置 A/B 标记。

框选放大 ​

  • 鼠标左键在波形上拖出一段,松开:这一段放大到窗口的 90%,前后各留一点,方便接着往下框。
  • 两端一大片各通道都不动的波形会一起裁掉,只留一小截,所以一框就落到真正有变化的地方。
  • 拖动时画面是停住的,不会在手下滚走;松手后「跟随最新数据」自动关掉,因为你在回看历史,点一下那个按钮就回到实时。
  • 框选只是移动视图,数据一条都不会少:缩小、滚轮往回滚、或者「适应」,随时回到全部。
  • 单击不会改变视图:框选要把左键按住拖出一段。

光标与读数 ​

  • 鼠标停在波形上:顶部标尺显示光标所在的时刻,每一行右侧显示该行在这一点的电平。
  • 标尺上的刻度按时间自动选取;左边一列是通道名,颜色与顶部图例一致。

把波形读成协议 ​

可将采样波形在浏览器软件解码为 I2C、SPI、UART、1-Wire、Modbus、I²S、JTAG、SWD。配置实际采样通道与协议参数,SPI 需匹配 CPOL/CPHA,UART 需匹配波特率与帧格式。解析带跟随波形缩放平移,可查看完整字段。解码不修复丢样、错误时钟或电气问题,缺失的上下文不能被自动补回。

状态与统计 ​

  • 右下角:这次采到的点数与覆盖的时长;有丢包时另外写「丢包 N 处」。
  • 顶部状态:采集中 / 等待触发 / 已采满 / 未开始。
  • 丢包说明设备到浏览器的链路没跟上采样率,波形上对应位置画一条红色虚线。降低采样率或减少通道数通常能解决。

清空、停止与后台采集 ​

  • 工具栏最左边的「清空」丢掉已经采到的样本、采集继续跑,用来换成眼前的这一段再看。
  • 「停止」结束这次采集;离开本页不会停止,采集在后台继续,回来时波形接着补上。

常见问题 ​

  • 波形不动了:跟随被关掉了(正在回看历史),点「跟随最新数据」。
  • 波形栏写着「缓存只够 …」:窗口比环形缓存长,画面上滚动的是缓存里那一整段,能回看的就到那里为止。
  • 点了开始却没有波形:可能还在等触发(状态行写着在等哪根脚的边沿),或者选的边沿一直没出现。
  • 波形上有红色虚线:丢包,降采样率或减少通道数。
  • 框选没反应:只是单击了一下,框选要把左键按住拖出一段。

与旧版帮助的差异 ​

本文以当前控件和固件为准。SPI 的 r/R 不能仅凭旧注释推断片选行为;I2C 的 START/STOP 不使用逻辑分析仪触发模式解释;采样率和脚本执行方式也可能随版本变化。