通过 Lager CLI 控制逻辑分析仪 Net,用于数字信号采集、协议解码和触发配置。
Rigol MSO5000 的触发。 通道控制、采集、测量、光标,以及边沿触发和 SPI 触发均可工作。脉冲、I2C 和 UART 触发会在任何内容到达示波器之前被拒绝:命令打印 Error: a Rigol MSO5000 supports edge and SPI triggers through lager, not <type>. Nothing was changed on the scope. 并以 1 退出。
语法
全局选项
命令
退出码
失败的命令会打印错误并以 1 退出。这包括 Net 名称不是逻辑 Net,以及来自 Box 的错误。成功的命令以 0 退出。
命令参考
enable
为指定的 Net 启用逻辑分析仪通道。
如果示波器的逻辑分析仪处于关闭状态,enable 会打开它。然后它显示该 Net 的通道,并把该通道设为活动通道。通道必须是 D0 到 D15。
disable
停用逻辑分析仪通道。
disable 会隐藏该 Net 的通道。当没有任何数字通道保持显示时,
disable 还会关闭逻辑分析仪。
start
开始连续波形采集。
start-single
开始单次波形采集(一次性)。
stop
停止波形采集。
measure 子命令
measure period
测量信号周期。
measure freq
测量信号频率。
measure dc-pos / measure dc-neg
测量正占空比或负占空比。
measure pw-pos / measure pw-neg
测量正脉宽或负脉宽。
trigger 子命令
trigger edge
设置边沿触发配置。
选项:
--mode - 触发模式:normal、auto、single(默认 normal)
--coupling - 耦合方式:dc、ac、low_freq_rej、high_freq_rej(默认 dc)
--source NET - 触发源 Net
--slope - 触发边沿:rising、falling、both
--level FLOAT - 触发电平,单位伏特
trigger pulse
设置脉冲触发配置。Rigol MSO5000 会拒绝这个触发。请参阅本页顶部的说明。
选项:
--mode - 触发模式
--coupling - 耦合方式
--source NET - 触发源
--level FLOAT - 触发电平
--trigger-on - 触发条件:gt(宽于 --upper 的脉冲)、lt(窄于 --lower 的脉冲)或 gtlt(宽度介于 --lower 和 --upper 之间的脉冲)。该条件不选择极性。缺少所需的宽度时,命令不会更改任何宽度条件,并打印一条提示。
--upper FLOAT - 脉宽上限
--lower FLOAT - 脉宽下限
trigger i2c
设置 I2C 协议触发。Rigol MSO5000 会拒绝这个触发。请参阅本页顶部的说明。
选项:
--mode - 触发模式
--coupling - 耦合方式
--source-scl NET - SCL 触发源
--source-sda NET - SDA 触发源
--level-scl FLOAT - SCL 触发电平
--level-sda FLOAT - SDA 触发电平
--trigger-on - 触发条件:start、restart、stop、nack、address、data、addr_data
--address INT - 地址值(用于地址触发),以十进制整数表示。7 位地址最大 127,8 位最大 255,10 位最大 1023。
--addr-width - 地址宽度:7、8 或 10 位
--data INT - 数据值(用于数据触发),以十进制整数表示
--data-width - 数据宽度:1-5 字节
--direction - 方向:write、read、rw
trigger uart
设置 UART 协议触发。Rigol MSO5000 会拒绝这个触发。请参阅本页顶部的说明。
选项:
--mode - 触发模式
--coupling - 耦合方式
--source NET - 触发源
--level FLOAT - 触发电平
--trigger-on - 触发条件:start、error(帧错误)、cerror(奇偶校验错误)、data
--parity - 校验位:even、odd、none
--stop-bits - 停止位:1、1.5、2
--baud INT - 波特率(110 至 20000000)
--data-width INT - 数据宽度,单位位:5 至 8
--data INT - 触发所用的数据值,以十进制整数表示
trigger spi
设置 SPI 协议触发。
选项:
--mode - 触发模式
--coupling - 耦合方式
--source-mosi-miso NET - MOSI/MISO 信号源
--source-sck NET - SCK 信号源
--source-cs NET - CS 信号源
--level-mosi-miso FLOAT - MOSI/MISO 电平
--level-sck FLOAT - SCK 电平
--level-cs FLOAT - CS 电平
--data INT - 触发数据值,以十进制整数表示。最大为 2^width − 1。
--data-width INT - 数据宽度,单位位:4 至 32
--clk-slope - 时钟边沿:positive、negative
--trigger-on - 触发条件:timeout、cs
--cs-idle - CS 空闲状态:high、low。配合 --trigger-on cs 时,high 表示在 CS 为低时触发,low 表示在 CS 为高时触发。
--timeout FLOAT - 超时长度。除非同时给出 --timeout,否则 --trigger-on timeout 不会改变任何设置。
cursor 子命令
cursor set-a / cursor set-b
设置光标 A 或 B 的位置。
cursor move-a / cursor move-b
移动光标位置。
cursor hide
隐藏光标。
示例
受支持的硬件
说明
逻辑 Net 采集的是数字信号(高/低电平状态)
协议触发(I2C、UART、SPI)需要正确配置电平
用 lager nets 查看可用的逻辑 Net
Analog Net 和 Logic Net 可以组合用于混合信号分析
--address 和 --data 之类的整数选项取十进制值。0x50 这样的十六进制字符串会被拒绝。