差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- openinstru_protocol [2021/02/22 21:37]
gongyusu
+++ openinstru_protocol [2021/02/22 22:02] (当前版本)
gongyusu
@@ 行 1: / 行 1: @@
+## 命令格式
+----
+  * 下面的JSON数据已扩展以提高可读性。在传输之前，应将所有JSON缩小（删除空白）.
+  * 除非另有说明，否则使用HTTP时，所有命令均使用POST方法发送.
+  * 所有Digilent Instrumentation协议命令必须是JSON对象或分块传输:
+    * **JSON对象**
+      * 必须以'{'字符开头，并以'}'字符结尾.
+      * 可能后跟一个或多个'\ r \ n'.
+    *  **大块转移**
+      * 由一个或多个块组成.
+      * 每个块必须以ASCII十六进制格式的块中的字节数开头，后跟一个'\ r \ n'，二进制数据和一个'\ r \ n'.
+        * 块长度在块长度和数据之间不包含'\ r \ n'.
+        * 块长度不包含二进制数据后的尾随'\ r \ n'.
+      * 每个分块传输都以零长度的分块终止.
+      * Ex.
+<code>
+\r\n
+chunk1\r\n
+\r\n
+somedata\r\n
+E\r\n
+ in\r\n\r\nchunks.\r\n
+\r\n
+\r\n
+</code>
+## 多命令
+----
+可以使用多命令在单个事务中发送多个命令。
+### 举例:
+<WRAP group>
+<WRAP half column>
+**Command**
+<code>
+{
+   "dc":{
+      "1":[
+         {
+            "command":"setVoltage",
+            "voltage":3300
+         },
+         {
+            "command":"getVoltage"
+         }
+      ],
+      "2":[
+         {
+            "command":"setVoltage",
+            "voltage":5000
+         }
+      ]
+   }
+}
+</code>
+</WRAP>
+<WRAP half column>**Response**</WRAP>
+<code>
+{
+   "dc":{
+      "1":[
+         {
+            "command":"setVoltage",
+            "statusCode":0,
+            "wait":500
+         },
+         {
+            "command":"getVoltage",
+            "statusCode":0,
+            "wait":100,
+            "voltage":3300
+         }
+      ],
+      "2":[
+         {
+            "command":"setVoltage",
+            "statusCode":0,
+            "wait":500
+         }
+      ]
+   }
+}
+</code>
+</WRAP>
+\\
+\\
 ## 波形发生器部分
 提供访问任意波形发生器的数据和功能的命令
@@ 行 116: / 行 208: @@
 </WRAP>
-<WRAP half column>**Response**</WRAP>
+<WRAP half column> **Response** </WRAP>
 <code>
 {
@@ 行 136: / 行 228: @@
 \\ \\
-#### 运行
+### 运行
 ----
 运行AWG通道
-** 命令 **
+#### 命令
   * **awg** - (Object) - The arbitrary waveform generator object.
     * **#** - (Array<Object>) - An array of command objects to apply to the awg channel.
       * **command** - (String) - The Run command: “run”
-** 响应 **
+#### 响应
   * **awg**  - (Object) - The arbitrary waveform generator object.
     * **#** - (Array<Object>) - An array of command objects applied to the awg channel.
@@ 行 190: / 行 283: @@
 \\
-#### 停止
+### 停止
 ----
 停止AWG通道
-**命令**
+#### 命令
   * **awg** - (Object) - The arbitrary waveform generator object.
     * **#** - (Array<Object>) - An array of command objects to apply to the awg channel.
       * **command** - (String) - The Stop command: “stop”
-**响应**
+#### 响应
   * **awg**  - (Object) - The arbitrary waveform generator object.
     * **#** - (Array<Object>) - An array of command objects applied to the awg channel.
@@ 行 245: / 行 338: @@
-### 直流电压
+## 直流电压
 提供访问直流电压数据和函数的命令
-#### 获取当前状态
+### 获取当前状态
 ----
 Get the current state of the instrument's channel
-**Command**
+#### 命令
   * **dc** - (Object) - The DC power supply object.
     * **#** - (Array<Object>) - An array of command objects to apply to the DC power supply channel.
       * **command** - (String) - The Get Current State command: “getCurrentState”
-**Response**
+#### 响应
   * **gpio** - (Object) - The DC power supply object.
     * **#** - (Array<Object>) - An array of command objects applied to the DC power supply  channel.
@@ 行 272: / 行 365: @@
 <WRAP group>
 <WRAP half column>
-**Command**
+**命令**
 <code>
 {
@@ 行 285: / 行 378: @@
 </code>
 </WRAP>
-<WRAP half column>**Response**</WRAP>
+<WRAP half column>**响应**</WRAP>
 <code>
 {
@@ 行 304: / 行 397: @@
 \\
-#### 获取电压值
+### 获取电压值
 ----
@@ 行 310: / 行 403: @@
 Get the output voltage(s) of the specified DC power supply channel(s).
-**Command**
+#### 命令
   * **dc** - (Object) - The DC power supply object.
     * **#** - (Array<Object>) - An array of command objects to apply to the DC power supply channel.
       * **command** - (String) - The Get Voltage command: “getVoltage”
-**Response**
+#### 响应
   * **gpio** - (Object) - The DC power supply object.
     * **#** - (Array<Object>) - An array of command objects applied to the DC power supply  channel.
@@ 行 327: / 行 420: @@
 <WRAP group>
 <WRAP half column>
-**Command**
+**命令**
 <code>
 {
@@ 行 359: / 行 452: @@
 \\
-#### 设置电压
+### 设置电压
 ----
@@ 行 365: / 行 458: @@
 Set the output voltage(s) of the specified DC power supply channel(s).
-**Command**
+#### 命令
   * **dc** - (Object) - The DC power supply object.
     * **#** - (Array<Object>) - An array of command objects to apply to the DC power supply channel.
@@ 行 371: / 行 464: @@
       * **voltage** - (Integer) - The desired voltage in mV.
-**Response**
+#### 响应
   * **gpio** - (Object) - The DC power supply object.
     * **#** - (Array<Object>) - An array of command objects applied to the DC power supply  channel.