示波器
提供示波器仪器数据和功能访问的命令。
得到当前状态
获取仪器通道的当前状态
命令
-
osc-(对象)-示波器对象。
-
＃- (Array
-
命令—(String)—Get CurrentState命令:" getCurrentState "
-
-
响应
-
osc-(对象)-示波器对象。
-
＃- (Array
-
命令—(String)—Get CurrentState命令:" getCurrentState "
-
statusCode—(整数)—表示设备状态的数值。看到Digilent Instrumentation协议状态代码
-
等待-(整数)-设备准备好处理另一个命令之前等待的毫秒数。
-
状态-(字符串)-仪器通道的状态:“武装”，“获取”，“空闲”，或“触发”。
-
acqCount:—(整数)—通道采集计数。这个值随着每次成功的收购而增加。
-
actualVOffset—(整数)—mV中实际的电压偏移量。
-
actualSampleFreq—(整数)—实际采样频率，单位为mHz。
-
actualGain-(整数)-实际使用的增益。
-
actualBufferSize-(整数)-样本中使用的实际缓冲区大小。
-
triggerDelay—(整数)—pS实际触发延时。
-
-
例子
命令
{" osc ":{" 1 ":[{“命令”:“getCurrentState”}]}}
响应
{"osc": {"1": [{"command": "getCurrentState"， "statusCode": 0， "wait": 0， "state": "triggered"， "acqCount": 10， "actualVOffset": 0， "actualSampleFreq": 1000000， "actualGain": 0.25， "actualBufferSize": 32000， "triggerDelay": 0}]}
读
从设备读取数据。如果设备的acqCount大于或等于命令的acqCount，则返回数据。如果设备的acqCount小于命令的acqCount，设备响应它的触发状态和一个可选的估计时间之前，一个新的缓冲区将是可用的。
数据以分块传输的形式返回。第一个数据块是一个JSON对象，它描述了接下来的二进制数据块。二进制数据类型和分辨率在设备枚举中定义，单位为mV。二进制数据中的第一个字节对应于缓冲区中的第一个样本(按时间顺序是最早的样本)。
命令
-
＃- (美国信息交换标准代码十六进制)-数据块中的字节数美国信息交换标准代码十六进制，后面跟着' r\n'。
-
osc-(对象)-示波器对象。
-
＃- (Array
-
命令—(String)—Read命令:Read。
-
-
响应
-
osc-(对象)-示波器对象。
-
＃- (Array
-
命令—(String)—Read命令:Read。
-
statusCode—(整数)—表示设备状态的数值。看到Digilent Instrumentation协议状态代码
-
等待-(整数)-设备准备好处理另一个命令之前等待的毫秒数。
-
binaryOffset-(整数)-二进制数据块中的缓冲区的第一个字节。
-
binaryLength—(整数)—以字节为单位的缓冲区大小。
-
acqCount-(整数)—采集计数。
-
actualSampleFreq—(整数)—用于生成数据缓冲区的实际采样频率，单位为mHz。
-
pointOfInterest-(整数)-缓冲区中感兴趣点的样本索引，如果感兴趣点不在缓冲区中，则为-1。
-
triggerIndex-(整数)-触发器在缓冲区中发生的样本索引，或者-1如果触发器不在缓冲区中。
-
triggerDelay-(整数)-从兴趣点到触发器之间的时间，单位为pS。负的triggerDelay意味着兴趣点按时间顺序在触发之前。
-
actualVOffset-(整数)-在mV中获取缓冲区时使用的电压偏移值。
-
actualGain-(十进制)-获取数据缓冲区时使用的增益值。
-
例子:
命令
{" osc ":{" 1 ":[{“命令”:“读”、“acqCount”:101}]}}
响应
160 \ r \ n{“osc”:{" 1 ":[{“命令”:“读”、“statusCode”:0,“等待”:0,“binaryOffset”:0,“binaryLength”:1024年,“acqCount”:3,“actualSampleFreq”:6250000000,“pointOfInterest”:256年,“triggerIndex”:256年,“triggerDelay”:0“actualVOffset”:48岁“actualGain”:1}]}}\ r \ n \ r \ n 400 < 1024字节BLOB > 0 \ r \ n \ r \ n \ r \ n
设置参数
设置指定示波器通道的指定参数。
命令
-
osc-(对象)-示波器对象。
-
＃- (Array
-
命令—(String)—Set Parameters命令:" setParameters "。
-
bufferSize-(整数)-样本中所需的缓冲区大小。
-
获得-(整数)-期望增益。
-
vOffset-(整数)-所需的电压偏移量，单位为mV。
-
sampleFreq—(整数)—采样频率，单位为mHz。
-
triggerDelay—(整数)—期望的触发延时，单位为pS。
-
-
响应
-
osc-(对象)-示波器对象。
-
＃- (Array
-
命令—(String)—Set Parameters命令:" setParameters "
-
statusCode—(整数)—表示设备状态的数值。看到Digilent Instrumentation协议状态代码
-
actualVOffset—(整数)—mV中实际的电压偏移量。
-
actualSampleFreq—(整数)—实际采样频率，单位为mHz。
-
等待-(整数)-设备准备好处理另一个命令之前等待的毫秒数。
-
-
例子:
命令
{"osc":{"1":[{"command":"setParameters"， "bufferSize": 32000， "gain": 0.25， "vOffset":3000， "sampleFreq": 1000000， "triggerDelay": 100000}]}
响应
{"osc":{"1":[{"command":"setParameters"， "statusCode":0， "actualVOffset":3100， "actualSampleFreq": 1000000， "wait":0}]}}