字符串通訊協(xié)議詳解

“字符串通訊協(xié)議”允許用戶通過(guò)字符串控制振動(dòng)盤的動(dòng)作。要使用該模式，需要在RS232或RS485的設(shè)置里，將“通訊協(xié)議”設(shè)置為“1—字符串模式”。上位機(jī)使用ASCII碼模式（字符串模式）發(fā)送數(shù)據(jù)。

l  軟件版本V1.30（包含）以后的軟件，才支持該指令模式。

l  指令區(qū)分大小寫。

l  系統(tǒng)界面要返回到主界面，否則通訊中斷!

1. LED背光控制 LEDON/LEDOFF

l  指令作用  開(kāi)啟或關(guān)閉振動(dòng)盤背光源

l  指令格式  LEDON  或  LEDOFF

l  指令舉例  LEDON—開(kāi)啟背光; LEDOFF—關(guān)閉背光;

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

l  錯(cuò)誤回復(fù)  ErrCmd—錯(cuò)誤的指令格式

2. LED背光亮度設(shè)置 SetBrightness

l  指令作用  設(shè)置LED背光源的亮度，百分比。

l  指令格式  SetBrightnessxx

l  指令舉例  SetBrightness50  設(shè)置背光源亮度為50%

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

l  錯(cuò)誤回復(fù)  BrightnessNOTNum—背光亮度數(shù)字部分錯(cuò)誤；

  BrightnessOverRange—背光亮度超出范圍，取值范圍10%~100%；

3. 獲取LED背光亮度 GetBrightness

l  指令作用  獲取LED背光源的亮度，百分比。

l  指令格式  GetBrightness

l  指令舉例  GetBrightness

l  指令回復(fù)  GetBrightnessxx，例如GetBrightness50，表示當(dāng)前的亮度是50%。

4開(kāi)始單一動(dòng)作 ActionON

l  指令作用  開(kāi)始某一個(gè)單一動(dòng)作。

l  指令格式  ActionONxx

l  指令舉例  ActionON09 開(kāi)始動(dòng)作09振動(dòng)。

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。在發(fā)送停止指令之前，振動(dòng)盤不會(huì)停止振動(dòng)。

l  錯(cuò)誤回復(fù)  CmdLengthErr—指令長(zhǎng)度錯(cuò)誤；

          ActionCmdStartErr—指令開(kāi)頭部分錯(cuò)誤（格式錯(cuò)誤）；

                    ActionCodeNOTNum—指令編碼錯(cuò)誤（不是合法數(shù)字）；

                    ActionCodeOverRange—指令編碼超出范圍（1~11）；

5 停止單一動(dòng)作 ActionOFF

l  指令作用  停止單一動(dòng)作

l  指令格式  ActionOFF

l  指令舉例  ActionOFF 立即停止單一動(dòng)作輸出。振動(dòng)盤停止振動(dòng)。

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

6 設(shè)置單一動(dòng)作的頻率 SetActionxxFRQ

l  指令作用  設(shè)置某一個(gè)單一動(dòng)作的頻率。

l  指令格式  SetActionxxFRQxxx

l  指令舉例  SetAction01FRQ58.9 設(shè)置動(dòng)作01的頻率為58.9Hz

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

錯(cuò)誤指令  ActionCodeNOTNum—指令編碼錯(cuò)誤（不是合法數(shù)字）；

                    ActionCodeOverRange—指令編碼超出范圍（取值范圍：1~11）；

                    ActionFrqNOTNum—頻率不正確（不是合法數(shù)字）；

                    ActionFrqOverRange—頻率超出范圍（取值范圍：10Hz~100Hz）；

7. 獲取單一動(dòng)作的頻率 GetActionxxFRQ

l  指令作用  設(shè)置某一個(gè)單一動(dòng)作的頻率。

l  指令格式  GetActionxxFRQ

l  指令舉例  GetAction01FRQ  獲取動(dòng)作01的頻率

l  指令回復(fù)  GetActionxxFRQxxx，如：GetAction01FRQ58.9，表示動(dòng)作01頻率為58.9Hz

l  錯(cuò)誤指令  ActionCodeNOTNum—動(dòng)作編碼錯(cuò)誤（不是合法數(shù)字）；

  ActionCodeOverRange—動(dòng)作編碼超出范圍（取值范圍：1~11）；

8. 設(shè)置單一動(dòng)作的振幅 SetActionxxDTY

l  指令作用  設(shè)置某一個(gè)單一動(dòng)作的振幅。百分比。

l  指令格式  SetActionxxDTYxxx

l  指令舉例  SetAction01DTY35 設(shè)置動(dòng)作01的振幅為35%

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

l  錯(cuò)誤回復(fù)  ActionCodeNOTNum—動(dòng)作編碼錯(cuò)誤（不是合法數(shù)字）；

  ActionCodeOverRange—動(dòng)作編碼超出范圍（取值范圍：1~11）；

  ActionDtyNOTNum—振幅不正確（不是合法數(shù)字）；

  ActionDtyOverRange—振幅超出范圍（取值范圍：10%~90%）；

9. 獲取單一動(dòng)作的振幅 GetActionxxDTY

l  指令作用  獲取某一個(gè)單一動(dòng)作的振幅。百分比。

l  指令格式  GetActionxxDTY

l  指令舉例  GetAction09DTY 獲取動(dòng)作09的振幅

l  指令回復(fù)  GetActionxxDTYxx，如：GetAction09DTY35，表示動(dòng)作09振幅為35%；

l  錯(cuò)誤回復(fù)  ActionCodeNOTNum—動(dòng)作編碼錯(cuò)誤（不是合法數(shù)字）；

  ActionCodeOverRange—動(dòng)作編碼超出范圍（取值范圍：1~11）；

10. 設(shè)置數(shù)字量輸入用途 SetDIxPurpose

l  指令作用  設(shè)置數(shù)字量輸入x的用途。

l  指令格式  SetDIxPurposex

l  指令舉例  SetDI1Purpose2 設(shè)置數(shù)字量輸入1的用途為單一振動(dòng)。

（0—不用；1—背光控制；2—單一振動(dòng)；3—急停；4—動(dòng)作組合）

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

l  錯(cuò)誤回復(fù)  DIIndexNOTNum—數(shù)字量輸入端口號(hào)錯(cuò)誤（不是合法數(shù)字）；

  DIIndexOverRange—數(shù)字量輸入端口號(hào)超出范圍（取值范圍：1~6）；

  DIPurposeNOTNum—數(shù)字量輸入的用途編號(hào)錯(cuò)誤（不是合法數(shù)字）；

  DIPurposeOverRange—數(shù)字量輸入用途編碼超出范圍（0~4）；

11. 獲取數(shù)字量輸入用途 GetDIxPurpose

l  指令作用  獲取數(shù)字量輸入x的用途。

l  指令格式  GetDIxPurpose

l  指令舉例  GetDI5Purpose設(shè)置數(shù)字量輸入1的用途為單一振動(dòng)。

（0—不用；1—背光控制；2—單一振動(dòng)；3—急停；4—動(dòng)作組合）

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

l  錯(cuò)誤回復(fù)  DIIndexNOTNum—數(shù)字量輸入端口號(hào)錯(cuò)誤（不是合法數(shù)字）；

  DIIndexOverRange—數(shù)字量輸入端口號(hào)超出范圍（取值范圍：1~6）；

12. 設(shè)置數(shù)字量輸入動(dòng)作編碼 SetDIxCodex

l  指令作用  設(shè)置數(shù)字量輸入x的動(dòng)作編碼。

l  指令格式  SetDIxCodex

l  指令舉例  SetDI2Code9 設(shè)置數(shù)字量輸入2的動(dòng)作編碼為9。

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

注意：只有在數(shù)字量輸入的用途為2或4的時(shí)候，該參數(shù)才有效。

l  錯(cuò)誤回復(fù)  DIIndexNOTNum—數(shù)字量輸入端口號(hào)錯(cuò)誤（不是合法數(shù)字）；

  DIIndexOverRange—數(shù)字量輸入端口號(hào)超出范圍（取值范圍：1~6）；

13. 獲取數(shù)字量輸入動(dòng)作編碼 GetDIxCode

l  指令作用  獲取數(shù)字量輸入x的動(dòng)作編碼。

l  指令格式  GetDIxCodex

l  指令舉例  GetDI2Code 獲取數(shù)字量輸入2的動(dòng)作編碼。

l  指令回復(fù)  GetDIxCodex，如：GetDI2Code10，DI2的動(dòng)作編碼為10.

l  錯(cuò)誤回復(fù)  DIIndexNOTNum—數(shù)字量輸入端口號(hào)錯(cuò)誤（不是合法數(shù)字）；

  DIIndexOverRange—數(shù)字量輸入端口號(hào)超出范圍（取值范圍：1~6）；

14. 運(yùn)行動(dòng)作組合  RunGroupxx

l  指令作用  運(yùn)行動(dòng)作組合xx。動(dòng)作組合運(yùn)行完畢，會(huì)自動(dòng)停止。

l  指令格式  RunGroupxx

l  指令舉例  RunGroup01  運(yùn)行動(dòng)作組合01.

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

l  錯(cuò)誤回復(fù)  GroupIndexNOTNum—動(dòng)作組合編號(hào)錯(cuò)誤（不是合法數(shù)字）；

  GroupIndexOverRange—動(dòng)作組合編號(hào)超出范圍（取值范圍：1~10）；

軟件版本V1.55以及以后的版本,動(dòng)作組合完成之后,字符串協(xié)議下,發(fā)送完成指令給上位機(jī), 回復(fù)字符串"RunGroupDone".

15. 設(shè)置動(dòng)作組合 SetGroup

l  指令作用  設(shè)置動(dòng)作組合的參數(shù)。

l  指令格式  SetGroupxx:a,b;c,d;e,f;g,h;i,j;

其中，a — 第1條動(dòng)作的編碼；

           B — 第1條動(dòng)作的時(shí)間；

           C — 第2條動(dòng)作的編碼；

           D — 第2條動(dòng)作的時(shí)間；

      E — 第3條動(dòng)作的編碼；

      F — 第3條動(dòng)作的時(shí)間；

      G — 第4條動(dòng)作的編碼；

      H — 第4條動(dòng)作的時(shí)間；

      I —  第5條動(dòng)作的編碼；

      J —  第5條動(dòng)作的時(shí)間；

l  指令舉例  SetGroup01:9,800;10,900;11,1200;12,500;11,600; 如下圖設(shè)置效果。

l  指令回復(fù)  振動(dòng)盤原樣回復(fù)指令。

l  錯(cuò)誤回復(fù)  GroupIndexNOTNum—動(dòng)作組合編號(hào)錯(cuò)誤（不是合法數(shù)字）；

  GroupIndexOverRange—動(dòng)作組合編號(hào)超出范圍（取值范圍：1~10）；

  SeparatorLost—字符串中缺少分隔符（逗號(hào)和分號(hào)）；

  ParameterNOTNum—部分參數(shù)不是合法數(shù)字；

  CodeOverRange—動(dòng)作編碼超出范圍（取值范圍：0~12）

16. 獲取動(dòng)作組合 GetGroup

l  指令作用  獲取動(dòng)作組合的設(shè)置參數(shù)。

l  指令格式  GetGroupxx

l  指令舉例  GetGroup01  獲取第1組動(dòng)作組合的配置參數(shù)。

l  指令回復(fù)  GetGroup01:9,800;10,900;11,1200;12,500;11,600;

l  錯(cuò)誤回復(fù)  GroupIndexNOTNum—動(dòng)作組合編號(hào)錯(cuò)誤（不是合法數(shù)字）；

  GroupIndexOverRange—動(dòng)作組合編號(hào)超出范圍（取值范圍：1~10）；

17. 保存當(dāng)前配置 SaveSET

l  指令作用  版本V1.40以后增加的該指令，保存當(dāng)前配置到FLASH中。

l  指令格式  SaveSET

l  指令舉例  SaveSET

l  指令回復(fù)  原樣回復(fù)指令。

18. 加載配方LoadRecipe

l  指令作用  版本V1.52以后增加的該指令，通過(guò)串口字符串控制加載配方。

l  指令格式  LoadRecipen （其中n的取值范圍1~9）

l  指令舉例  LoadRecipe1 – 加載配方1到單一動(dòng)作中

l  指令回復(fù)  原樣回復(fù)指令。

19. 繼電器控制指令RELAY0/RELAY1

l  指令作用  版本V1.46以后，控制器增加板載繼電器。將其設(shè)置為“獨(dú)立繼電器”時(shí)，可通過(guò)指令來(lái)控制其動(dòng)作。

l  指令格式  RELAY0—關(guān)閉繼電器；RELAY1—開(kāi)啟繼電器。

l  指令舉例  RELAY0 或RELAY1

l  指令回復(fù)  原樣回復(fù)指令。