VXCOMM.EXE 相關說明 [English]
[简体中文 (Simplified Chinese)]

[最後修改日期 2008/02/19 ]

[ 功能說明 ][ 版本說明 ] [ 命令列參數說明 ][ 5DigitLED顯示說明 ][ 新功能使用 ]

功能說明
1. 使用 TCP/IP 連機，TCP port 10000 作為下命令的 port，port 10000+n 作為與 COM n 雙向 bypass 資料用。
2. port 10000 可以適用的命令如下表：
命令 說明 範例 版本

00[參數]

 結束時vxcomm.exe返回MiniOS7控制畫面。一般不會用到，測試程式時方便重新下載程式。

參數說明：

  • 只有 "quit" 才會結束，其他則不處理。

回應值：無

　

 [in]: 00quit
[out]: 沒有回應值		 　

01

 讀取vxcomm.exe的版本資訊。

回應值：vm.n.rr[mm/dd/yyyy]

　

 [in]: 01
[out]: v3.2.23[07/29/2005]		 　

02[參數]

設定COM PORT的baudrate。（與06相同，但設定值不存到EEPROM）

參數說明：
參數=CBBBB

  • C：comport。1~8代表COM1~COM8。
  • BBBB位數不一定，依所設的baudrate而定，例如9600、115200等。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 02138400
[out]: OK		 　

03[參數]

設定COM PORT 的 data format。（與07相同，但設定值不存到EEPROM）

參數說明：
參數=CDPS

  • C：comport。1~8代表COM1~COM8。
  • D：databit。7或是 8。COM3 以上也可以是 5 或 6。
  • P：parity。
    •     1. n, 0：none parity。
        2. e, 1：even parity。
        3. o, 2：odd parity。
  • S：stop bits。1 或是 2。（COM1/2目前只有 1 stop bit）

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 0328N1
[out]: OK		 　

04[參數]

讀取系統的 reset 狀態。[10/19/2001 新增]

參數說明：
參數=CC

  • CC：Status bit。00~31。

    • 可提供給最多 32 個 Client 端使用。
    使用此功能的 Client 必須協調好各自使用不同的 status bit。該 status bit 被查詢過之後，就會被 reset 。也就是第一次查詢是 1 ，第二次以後就會變成 0，直到系統重新reset 後，才會又出現一次 1。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 0403
[out]: 031		 　

05[參數]

設定COM PORT 的 RTS 及 DTR 信號。

參數說明：
參數=CS[D]

  • C：comport。1~8，代表 COM1~COM8。
  • S：RTS status。0：inactive，1：active。
  • D：DTR status。若不設定此參數，其 DTR 輸出不會變更（保持在原先的輸出狀態）。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 0511
[out]: OK

[in]: 054D
[out]: OK		 　
06[參數] 設定 COM PORT 的 baudrate。（與 02 相同，但設定值有存到EEPROM）

參數說明：
參數=CBBBB

  • C：comport。1~8，代表 COM1~COM8。
  • BBBB 位數不一定，依所設的 baudrate 而定，例如 9600 、115200等。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 06138400
[out]: OK		 　

07[參數]

設定 COM PORT 的 data format。（與 03 相同，但設定值有存到EEPROM）

參數說明：
參數=CDPS

  • C：comport。1~8，代表 COM1~COM8。
  • D：databit。7 或是 8，COM3 以上也可以是 5 或 6。
  • P：parity。
    •     1. n, 0：none parity。
        2. e, 1：even parity。
        3. o, 2：odd parity。
  • S：stop bits。1 或是 2。（COM1/2 目前只有 1 stop bit。）

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 0728N1
[out]: OK		 　

08[參數]

設定 vxcomm.EXE 端的 IP address。如果設定成功，client 端程式必須重新聯機到新的 IP 才可繼續工作。

參數說明：
參數=iiippplllPPP

  • iii/ppp/lll/PPP為 3 位元數數字 000~255。前面需補 0。

回應值：

  • 成功時：OK..Reconnect。（client 端有可能收不到。）
  • 錯誤時：ERROR。
 [in]: 08192168001255
[out]: OK..Reconnect		 　

09[參數]

設定 COM PORT 接收資料的 TIMEOUT 時間。

Vcom3008 之後版本，搭配 command 30（16550 fifo trigger level）來使用。

  1. COM port 收到的資料，先放在 buffer 裡，等到 buffer 滿了或一段時間沒有資料進來，再一起送出。等待一段沒有資料進來的時間即是此設定的 TIMEOUT 值。
  2. 最長的 TIMEOUT 時間，Hardware trigger level-1+3bytes=Hardware trigger level+2bytes 時間。（如果 trigger level 設成 1 即是 1byte）

參數說明：
參數=ptttt

  • p：comport。1~8，代表 COM1~COM8。
  • tttt：0~99999，單位為 ms。"a" 或 "A" 由系統自動設定成預設值，即 Hardware trigger level +2 bytes 依 COM port Baudrate 來決定時間。
  • 不輸入 tttt 表示詢問設定值。
  • 例：COM1 之 default timeout 為 1（Hardware trigger level）+ 2 bytes。

回應值：

  • 成功時：傳回最後設定值、格式 [09ptttt]（24 設為 0 則為 ptttt）。
  • 錯誤時：ERROR。
 [in]: 091
[out]: 13

[in]: 0910020
[out]: 120（1: port number, 20: 設定值）

[in]: 091a
[out]: 12

3.0.08 修改　

10

讀取 server 名稱。例如：7188E1、7188E2 等。

回應值：7188En。n=1、2、3、4、5 或 8。

 [in]: 10
[out]: 7188E2		 　

11[參數]

測試命令，會回應"<測試命令>"

參數說明：

  • 參數=任意字串，但長度不可超過 80 bytes。

回應值：

  • 成功時：<任意字串>。即是於測試字串前後加上<>。
  • 錯誤時：ERROR。
 [in]: 11TEST
[out]: <TEST>		 　

12[參數]

設定 vxcomm.EXE 端的 gateway。

參數說明：
參數=iiippplllPPP

  • iii/ppp/lll/PPP 為 3 位元數數字 000~255。前面要補 0 。

回應值：

  • 成功時：OK..Reconnect。（client 端有可能收不到。）
  • 錯誤時：ERROR。
 [in]: 12092168000001
[out]: OK..Reconnect		 　

13

讀取 vxcomm.EXE 端的 gateway。

回應值：目前設定的 gateway IP address，nnn.nnn.nnn.nnn，nnn前不補 0 。

　

 [in]: 13
[out]: 192.168.0.1		 　

14[參數]

 設定 vxcomm.EXE 端的 IP mask。

參數說明：
參數=mmmMMMmmmMMM

  • mmm/MMM 為 3 位元數數字 000~255。前面需補 0。

回應值：

  • 成功時：OK..Reconnect。（client 端有可能收不到。）
  • 錯誤時：ERROR。
 [in]: 14255255000000
[out]: OK..Reconnect 		　

15

 讀取 vxcomm.EXE 端的 IP mask。

回應值：目前設定的 MASK，nnn.nnn.nnn.nnn，nnn前不補 0 。

　

 [in]: 15
[out]: 255.255.0.0 		　

16[參數]

讀取 COM PORT 目前設定值。

參數說明：
參數=C

  • C：comport。1~8，代表 COM1~COM8。

回應值：baudrate, data, parity, stop。例如：9600,N,8,1。

　

 [in]: 162
[out]: 9600,N,8,1		 　

17[參數]

 讀取某個 input port 的值。

參數說明：
參數=pppp

  • pppp：四個 16 進制數字。例如 0x300要輸入"0300"。

回應值：

  • 成功時：由該 input port 讀回的值。
  • 錯誤時：ERROR。
 [in]: 170003
[out]: 55 		　

18[參數]

 由某個 output port 輸入 data。

參數說明：
參數=ppppdd

  • pppp：四個 16 進制數字，要輸出的 port。例如 0x300 要輸入 "0300"。
  • dd：兩個 16 進制數字，要輸出的值。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 180010aa
[out]:  		　

19[參數]

bypass command 給 user function。

參數說明：參數由 user 自己寫的副程式處理。

回應值：由 user 自己寫的副程式決定。

　

 [in]:
[out]:		 　

20[參數]

設定 5DigitLed 的顯示模式。

參數說明：
參數=0 或 1。

  • 0：不顯示訊息。
  • 1：顯示目前的設定值。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 201
[out]: OK		 　

21

讀取 vxcomm.EXE 端的 MAC。

回應值：nn:nn:nn:nn:nn:nn，nn 為 16 進位。

　

 [in]: 21
[out]: 71:88:03:3b:02:c7		 　

22

讀取 vxcomm.EXE 端的 MiniOS7 版本資訊。

回應值：

　

 [in]: 21
[out]: v2.0.2(2005/7/1) 		　

23[參數]

直接 bypass command 給 user function，包含 socket number 以及 data length。

參數說明：參數由 user 自己寫的副程式處理。

回應值：由 user 自己寫的副程式決定。

　

 [in]:
[out]:		 2.6.14　

24[參數]

設定 command 回應值模式。

參數說明：
參數=m

  • m=0：回應值不含命令編號。
  • m=1：回應值含命令編號。在此模式下，所有命令回應值最前面加上兩位命令編號。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 240
[out]:OK

[in]:241
[out]:24OK

 　

25[參數]

 詢問系統狀態或是設定值。

參數說明：
參數=m

  • m='S'：詢問系統的 timeout 時間設定值。
  • m='W'：詢問 socket 的 timeout 時間設定值。
  • m='N'：詢問目前的最大 SOCKET 個數。
  • m='M'：詢問目前的工作模式是 /M0 還是 /M1。
  • m='B'：詢問 Broadcast 封包接受與否，B1 接收 B0 不接收，default=B0。
  • m='E'：詢問命令回應模式，E0 不回應命令號碼，E1 回應命令號碼。
  • m='L'：詢問 Led5 顯示控制設定，L0 (不顯示 Led5)，L1 (顯示 Led5) 。
  • m='I'：詢問系統 NAME/IP/MASK/GATEWAY/MAC。
  • m='UDP'：詢問 UDP 的設定值，UDP=0 (關閉 UDP 功能)，UDP=1 (開啟 UDP 功能)，UDP=2 (當沒有 TCP 連線，開啟 UDP 功能，當有 TCP 連線，關閉 UDP 功能)。

回應值：

  • 成功時：mxxx。m='S'、'W'、'N' 或 'M' 等。
  • 錯誤時：ERROR。
 [in]: 25M
[out]: M=0

[in]: 25S
[out]: S=0

[in]: 25UDP
[out]: UDP=2

 3.0.02 established

3.0.10modified

26[參數]

 設定系統參數。

參數說明：
參數：m=n。

  • m='SAVE'：設定系統參數是否要儲存於 EEPROM 中。若不設定此參數時，其預設值為 SAVE=0。
  • m='B'：設定 Broadcast 封包接收與否。
  • m='S'：設定系統 TIMEOUT 時間。
  • m='W'：設定 socket 聯機 TIMEOUT 時間。
  • m='M'：設定工作模式 (M0/M1)。
  • m='E'：設定命令回應模式。
  • m='I'：設定系統 IP/MASK/GATEWAY/MAC。可以設定任意項目，不同項目用 ',' 分開。 IP/ MASK/ GATEWAY/ MAC 需用大寫。
  • m='UDP'：設定 UDP UDP 模式，UDP=0 (關閉 UDP 功能)，UDP=1 (開啟 UDP 功能)，UDP=2 (當沒有 TCP 連線，開啟 UDP 功能；當有 TCP 連線，關閉 UDP 功能)。
  • 以上可同時設定多筆項目，不同項目需用 ',' 分開。

回應值：

  • 成功時：m=n。m='SAVE'、''B、'N' 或 'M' 等。n=設定值
  • 錯誤時：ERROR。
 [in]: 26SAVE=1,M=1,B=0
[out]: SAVE=1,M=1,B=0

[in]: 26M=1,B=0,S=300000
[out]: M=1,B=0,S=300000

[in]: 26UDP=1
[out]: UDP=1

 3.0.02 established

3.0.10modified

27[參數]

對 COM Port 送出 Break 信號。

參數說明：
參數=CM

  • C：送出信號之 COM port 1~8，代表 COM1~COM8。
  • M：1：Break Enable、0：Break Disable。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 2711
[out]:OK

[in]: 2710
[out]: OK

 　

28[參數]

 設定/詢問 cts/rts flow control 模式。 

參數說明：
參數=p[mn]

  • p：COM port，只有 '1'、'3'、'4' 及 '5' 有支援 cts/rts 信號。
  • m,n：模式，m 設定 cts 模式，n 設定 rts 模式。
    • 設定值：'0'~'3'。
        '0'：Disable.
        '1'：Enable (RTS must control by user program).
        '2'：Enable, auto control by hardware.
        '3'：Enalbe, auto control by software (Library).
    For CTS mode '1' and '3' are the same.
    如果不給 mn 設定值的話，就直接傳回目前的設定值。

回應值：

  • 成功時：OK。
  • 錯誤時：ERROR。
 [in]: 28111
[out]: 111

[in]: 281
[out]: 111

 3.0.07　

29[參數]

詢問 cts 狀態。

參數說明：
參數=p

  • p：COM port，只有 '1'、'3'、'4' 及 '5' 有支援 cts/rts 信號。

回應值：

  • 成功時：CTSn=0 或 CTSn=1，n：COM port。
  • 錯誤時：傳回 "No CTSn SIGNAL" n：COM port。
 [in]: 291
[out]: CTS1=1

[in]: 291
[out]: CTS1=0

3.0.07　

30[參數]

 送任何資料至 port 10000，回應相同的資料包括命令 30。

參數說明：
參數=ssss

  • ssss：任何可見的字元皆可輸入(最長的長度為 1460 bytes)

回應值：

  • 成功時：傳回輸入的資料。
  • 錯誤時：無。
 [in]: 30123456789
[out]: 30123456789

[in]: 30
[out]: 30

 3.0.08　

31[參數]

設定 16550 FIFO trigger level。(COM3以上才可設定)

可以設定的值為1、4、8 及 14(目前如果程式不去設定的話，使用預設的值為 8)

參數說明：
參數=p[LL]

  • p：COM port 3~8，代表 COM3~COM8。
  • LL：'1'、'4'、'8'、'14' 四選一。('01'、'04' 或 '08' 亦可)
  • 不給 LL 表示詢問目前設定值。

回應值：

  • 成功時：傳回最後的設定值，格式 30pLL。
  • 錯誤時：無。
 [in]: 31
[out]: CTS=1

[in]:31
[out]: CTS1=0

3.0.08　

32[參數]

設定 COM port BUFFER 的 trigger level，也就是如果收到設定的 bytes 數，就把 DATA 往回傳。

這在每次都收到一定的響應資料長度時就很好用，不用再等 timeout，可以比較快收到響應值。

參數說明：
參數=p[nnnn]

  • p：COM port 1~8，代表 COM1~COM8。
  • nnnn：'0'~'1460'，不給 nnnn 值表示詢問設定值。

回應值：

  • 成功時：傳回最後的設定值，格式 30pnnnn。
  • 錯誤時：無。
 [in]: 321
[out]: 10

[in]: 3221460
[out]: 21460

3.0.08　

33[參數]

用來更新檔案用

參數說明：
   "33dir\n","33dir
   "a\r"：dir a
   "33dir b\r"：dir b
   "33load a size\r"：ask for download file (1)
   "33+FILE DATA"：download file (2).....(1)(2) 要用程式處理。
   "33del a\r"：delete files in disk a
   "33del b\r"：delete fiels in disk b
   "33reset\r"： reset 7188e(by WDT)
   "33fileno a\r"：get file number & free space in disk a
   "33fileno b\r"：get file number & free space in disk b

回應值：

  • 成功時：傳回 7188E 回傳值。
  • 錯誤時：無。
 [in]: 33fileno a
[out]: 1 99286

[in]: 33del a
[out]: Delete file(s) in disk A OK.

 3.0.09

34

讀取 Vcomnnnn.exe 的函數庫版本及日期 (7188el.lib 及 tcpipl.lib)

參數說明：無

回應值：
7188el.lib Ver. n.nn[cc cc cccc],tcpipL.lib Ver.n.nn[cc cc cccc]

　

 [in]: 34

[out]: 7188el.lib Ver. 2.1[Jul 05 2005],tcpipL.lib Ver.1.16[Jul 29 2005]　

 3.0.10

35

清除輸出 (output) 或輸入 (input) 的 buffer。

參數說明：
參數=ptr

  • p：COM port 1~8，代表 COM1~COM8。
  • t：'1' clear tx output buffer。
  • r：'1' clear rx input buffer。

回應值：無

　

[in]: 35111
[out]: 		3.2.0

36

回應系統的 timeticks 值。

參數說明：無

回應值：

　

 [in]: 36
[out]: TIMETICKS=4219529 		3.2.0　

37

讀取 COM PORT 的 MSR (Modem status register)

參數說明：
參數=p

  • p：COM port 1~8，代表 COM1~COM8。

回應值：

  • 成功時：MSRx=nn。x 為 COM port number，nn 為 Modem status register 值。
  • 錯誤時：ERROR。
 [in]: 371
[out]: MSR1=30 		3.2.1
3. 與 COM n bypass 資料有兩種模式：/m1 為一問一答模式。/m0 為一問 (或是不問) 多答模式。
4. 一問一答模式： 5. 一問 (或是不問) 多答模式：
版本編號 主要功能說明
3.2.3
  1. 修改系統架構（跟 COM PORT 有關的部份），以便在各個模組上使用。[2004/11/23]
    跟 COM PORT 有關的副程式各自提供，採用統一副程式介面。
  2.  (A)使用新版 TCPIP LIB 測試。 [2005/04/13] (B)發現使用 DHCP 會有問題。(原先的舊版也是一樣)原因待查。
  3. 用超級終端機測試 Z-modem 傳檔案時發現設定
    H/W flow control 時，RTS 輸出會一直是LOW，以致對方 DATA 傳不進來。
    這是 LIB 的問題，已經解決。(只要是 16c550 的 COM PORT 都有這一個問題)
  4. 測試傳檔案時，同以前一樣結果，從 TCPIP 這端傳進來，由 RS-232 傳出去的
    都很穩定。但是另一個方向就很容易出現封包錯誤重傳的狀況。嚴重時會掛掉。
    vcom3223.exe 版本測試版更新[2005/04/22]
  5. 修正命令 28 會由 COM1 送出訊息。
  6. 修正命令 "26IP=....." 會傳回 ERROR。
  7. 修正命令 "292/296/297" 程式會掛掉的問題。跟之前 VC8_3301.EXE同樣的問題。
  8. 修正命令 05 會由 COM1 送出訊息。(已經拿掉)[2005/04/26]
  9. web 設定功能。修正原先使用 FireFox 連線設定不會成功的問題。
  10. 拿掉程式執行之後會從 COM1 顯示 LIB 版本訊息。[2005/05/04])
  11. 命令 33 (使用 tcp 上傳檔案) 有關的程式碼作了一點點精簡，程式碼可以減小約
    200 bytes。
    [*]這一個 vcom3223.exe 有用 UPX 壓縮過。
    *****************************************************************************************
  12. 拿掉 UDP 功能顯示的除錯訊息。[2005/05/23]
    VLIB3223.LIB 跟 VCOM3223.EXE(有壓縮) 都有更新
    *****************************************************************************************
  13. 把原先計時使用 *TimeTicks 改成使用 STOPWATCH.[2005/06/20]
  14. TCPIP LIB 裡頭原先使用 *TimeTicks 的部份改成呼叫 GetTimeTicks().
  15. mac address 的前 3 碼使用始於 ICPDAS 的 "00:0d:e0".(由 TCPIP LIB 設定的)
  16. port 10000 命令如果一次收到兩個(或以上)時，原先的版本只會處理第一個命令，
    後面的命令變成有收到，但沒處理。解決這個問題。[07/26]
  17. LED(L1) 原先每秒會閃一次。(亮0.5秒，熄滅0.5秒)這一版加上在 /M0 模式維持原來的方式每秒閃一次。在 /M1 模式下則改為 每秒閃兩次。亮 0.1秒，熄滅0.1秒，亮0.1秒，熄滅0.7秒。
    這樣由 L1 就可以看出目前的模式是 /M0 還是 /M1。[07/23]
  18. 修正 port 10000 命令 "00quit" 如果命令本身沒有用 CR 結束的話，可能不會被處理。[07/26]
  19. 修正 ethernet 線拔掉之後再送 DATA 過一段時間會被 WDT reset 的問題。[需要更新
    TCPIPL.LIB]當偵測到線被拔掉時，LED 會變成每秒閃 5 次。(就是看到 LED 閃的很快)
  20. 修改 ping gateway 功能，原先預設值為 enable，俢改成 disable。使用 ping 功能時，其命令參數加上 "/ping=nnn"，nnn 為 ping 的次數，使用時 nnn 最好 >=2。[2006/04/28]
  21. 修改 Web 設定畫面。[2006/04/28]
  22. 加入命令參數 "/P23" 及 "/HTTP"，設定 Telnet 及 Web server 功能。其預設值皆為 enable，若欲關閉 Telnet 功能，可使用 "/P23=0"，若欲關閉 Web server 功能，可使用 "/HTTP=0"。 [2006/08/22]
3.2.2
  1. 3.2.2 版開始(vcom322.C) [2004/09/16]
     (A)加上 web 設定功能。
  2. 加上 telnet 功能(port 23) [2004/10/14]
  3. 開始加上 DHCP 功能 [2004/11/01]
3.2.1
  1. 3.2.1 版開始(vcom321.C) [2004/05/25]

    加上 3010 版的 UDP 功能。

  2. 加上可以使用檔案 "vcom.ini" 設定參數 [2004/06/29]
  3. (A)加上可以設定 COM PORT IN/OUT buffer 大小 [2004/07/01]
        "/SIpxxxx","/SOpxxxx"
       (B)加上可以設定由 TCP 端送出DATA 的 buffer 大小
        "/STpxxxx"
  4. (A)加上可以設定 DTR 輸出。(修改命令 05)[2004/07/16]
    (B)加上可以詢問 MSR。(加上命令 37)
  5. (A)加上命令列參數可以設定 COM PORT 的 baud rate 跟 data format。[2004/08/20]
    例如 "/COMp=9600,N,8,1" 
  6. 開始加上 3010 的 COMMAND 25/26 所提供的功能。 [2004/10/20]
3.2.0
  1. 3.2.00 版開始 [2004/03/24]
  2. 新增項目: [2004/03/24]
    加上 client 端連線成功時，直接呼叫
    void Port9999Start(int skt);
    void Port502Start(int skt);
    void PortUserStart(int skt);的功能。
  3. Poer9999/Port520 的預設值都改成 0。有需要的USER要自行設定
  4. 加上一個命令列參數 "/Y"，可以設定8KE4/8KE8 模式 [2004/04/19]
  5. 加上一個命令列參數 "/Z"，等待對方回應ACK時間 [2004/04/19]
  6. 加上可以自動判斷 8KE4/8KE8 [2004/04/20]
  7. 加上 VCOM3010 提供的命令 35/36。  [2004/05/24]
    * 盡量不使用 GetComportNumber().(有用參數 /1,/a,/x,/2,/3,/4,/5 時就不會檢查)
  8. 加上可以用檔案(檔名固定為 "VCOM.INI") 來設定命令列參數。
      (所有的命令列參數都可以使用。
       VCOM320.EXE 會自動找這一個檔案，找到就使用。)
      目前設定值使用的優先順序為：
      預設值 < eeprom 存值 < vcom.ini 設定 < 命令列設定。[2004/7/5]
  9. (A)加上可以設定 COM PORT IN/OUT buffer 大小
        "/SIpxxxx": 設定 input buffer size.(default 是 1024 bytes)
        "/SOpxxxx": 設定 output buffer size.(default 是 1024 bytes)  [2004/7/5]
    (B)加上可以設定由 TCP 端送出DATA 的 buffer 大小
        "/SCpxxxx":設定來自 COM PORT等待從 TCP 送出的 DATA buffer 大小。[2004/7/5]
  10. 新增可以設定 COM PORT 的參數 [2004/8/20]
3.0.10
  1. 加上listen port 23,支持由telnet 下原先port 10000的命令[11/08/2002]
    1. telnet 端的設定:
      1. local-echo 請關閉
      2. ENTER 鍵只送出CR就可以（會回應 CR+LF）
  1. vcom3010 端的設定：

請用 "vcom3010 \e01" 來設定回應時以 CR+LF 結尾。
(目前 telnet 同時只能有一個 client 端聯機進來，第二個以後會馬上被斷線。以後有需要再修改成可以同時讓多個client端聯機進來)
 

  1. 加上 listen udp port 57188,如果有收到任何 message，就送出模組名稱及
    設定值給對方 IP 的 UDP PORT 54321。
    例如回應：
    7188E5,IP=192.168.188.187,mask=255.255.0.0,gateway=192.168.255.254
    7188E8,IP=192.168.188.189,mask=255.255.0.0,gateway=192.168.0.1

    *****     響應訊息修改[11/12/2002] ***** 目前共五行，每行以 CR+LF(0x0d+0x0a)結尾。
    NAME=7188E5
    IP=192.168.188.187
    mask=255.255.0.0
    gateway=192.168.255.254
    mac=00:71:88:39:b0:21
    ************************

     執行命令 "7188eu /s:255.255.255.255 /p:57188"，即可得到回應
3.0.09
  1.  port1000加上命令 33支援檔案更新的功能[09/04/2002]
  2. 加上一個命令列參數，設回應命令的結尾[09/09/2002]
  3. 修正mask沒設定好的問題[9/12/2002]
  4. 加上一個變數儲存系統執行的次數/值存到EEPROM裏頭[9/13/2002]
  5. 加上送出封包成功時，reset system/socket timeout timer.[9/23/2002]
  6. COM2改DMA模式接收data(配合此功能，os需更新到e-020924.img及之後版本)[9/26/2002]
  7. 修改Com1使用DMA接收data，RTS control做了一些修正。[10/1/2002]
  8. 修改命令"09pA"成使用預設值，('a'或'A'由系統自動設定預設值) [10/18/2002]
  9. 加上一個命令列選項 "/L0"，可以 disable led5 的顯示
    （對於沒有 5DigitLed 的版本，可以省下顯示 led5 所花的時間。）[10/18/2002]
  10. 取消[命令列參數] "/N" 功能。
    拿掉一些已經用不著的 code[10/29/2002]
  11. 修正 com port 判斷相關問題，可以支持 x512(7188E7).[10/30/2002]
  12. 修正 COMMAND 15 會送出一些亂碼的問題[10/31/2002]
  13. 支援命令34讀取Librariy的版本號碼日期
  14. 加上一個命令列參數 "/pxxxx".，可以設定 PORT10000。[07/23/2003]
  15. LED 顯示 11111. 在顯示完 IP 之後加上 顯示 Port10000。
    例如 Port10000=54332 --> 顯示 "5.4.3.3.2."
     前面不足五位會補空白，每一位旁邊都加 '.'。
  16. Vcom3009.lib修改 /st300無法reset 7188e [08/14/2003]
  17. 修改可以使用07命令來設定COM port 的parity 為Mark and space [11/07/2003]
  18. COM1 DMA 支援 2 stop bits(7N2,7E2,7O2) [2004/01/12]
3.0.08
  1.  port1000加上命令 30,31,32, 修改命令09[08/13/2002]
3.0.07
  1.  加上 COM1 使用 DMA 接收的功能。（送沒有使用DMA）[04/25/2002]
  2. 增加 rts/cts 的支持[06/25/2002]
3.0.06
  1.  加上 com port 收送 break 信號的功能。[04/09/2002]
3.0.05
  1. For X-server 加上 PortUser 。[02/18/2002]
  2. Port9999,Port502,PortUSer 如果是 0 的話就不 listen。[02/18/2002]
3.0.04
  1.  Port 9999 跟 Port 502 改用變數，在 user.c 的 UserInit()可以改成 user 想要用的 port.[90/01/18]
  2.  Port 10000 也改成使用變數，在 user.c 的 UserInit()也可以改成 user 想要用的 port.[91/02/06]
3.0.03
  1. 修改 OpMode=0 的處理方式[12/19/2001]
  2. 修改 UserLoop function 每個 loop 只呼叫一次[12/28/2001]
3.0.02
  1. 加上給 user 使用的命令"25","26"。
  2. 支援 TCP PORT 9999/502
  3. 修正 COM7 的錯誤。
3.0.01
  1. 支援到 7188E8。[11/01/2001]
3.0.00
  1. 從 2.6.14修改。
  2. 支援到 7188E5。[10/23/2001]

2.6.14
  1. 從 2.6.12 修改
  2. 加上給 user 使用的命令"23"
  3. 系統 timeout 預設值為 0 ，就是沒有 timeout。當設定系統 timeout 值時，只要超過該時間沒有任何封包送進來，系統就會被 WatchDog RESET。
  4. 系統的 timetick 值恢復正常，tcpack delay時間設為 0 ms。（有一個現象會發生，就是會比以前多送出一個 ack 封包，但應該沒影響。）
  5. 在 multi-client 模式下，以 timeout 時間來判斷 com port 端的資料結束與否。而不以特殊字元來判斷（例如：0x0D）。
  6. comport 設定值的儲存，加上一個 byte 的checksum。讀取時如果checksum不對的話就會被設定成預設值 9600,N,8,1。
  • xserver 目前測試的版本。也是目前 7188e1/2/x/a 的出貨版本。

2.6.13
  1. 從 2.6.12 修改
  2. comport 設定值的儲存，加上一個 byte 的checksum。讀取時如果checksum不對的話就會被設定成預設值 9600,N,8,1。
  3. 加上一個 debug port (7188)。
    • 可以下命令把某個或全部 socket 聯機切斷。

    • 可以列出目前所有聯機 socket 的訊息。

  • xserver 目前測試的版本。
  • 容易掛掉。（每次有增加新功能後就更容易掛掉。）
2.6.12
  1.  加上 一問一答模式。（就是 /m1 模式，2.6.11之前只有 /m0 模式。）
2.6.11
  1. 開始支持 multi-client(2.6.1x 是屬於 multi-client 的版本。 )
2.6.10
  1. 準備支持 multi-client，但是還沒支持。
2.6.01  
2.6.00  (2.6.0x 是屬於 single-client 的版本。 )
命令列參數說明
命令：VXCOMM [/option] (option 不分大小寫)                
參數 [/option]

說明

備註
/1
 		7188E1

 
/2
 		7188E2 （7188EA請使用 /A，7188EX 請改用 /X。）

 
/3 7188E3 3.0.00目前可以支援 E3
/4 7188E4 3.0.00目前支持到 E4
/5 7188E5 3.0.00目前支持到 E5
/8 7188E8 3.0.00目前支持到 E5
/A 7188EA，com port number=2。（設定使用 7188EA，10 命令會回應 7188EA。） 3.0.00[10/23/2001] 加上
/X 7188EX，com port number=2。 （設定使用 7188EX，10 命令會回應 7188EX。） 3.0.00[10/23/2001] 加上
/M0 COMPORT 收到的資料會傳給每一個聯機進來的client端。

2.6.11之前只有這個模式
/M1 一問一答模式 〔預設模式〕

2.6.12之後才有這個模式
/Wxxx 設定聯機進來的 socket 連線 timeout 時間，若此 socket 在 timeout 時間內無任何封包傳送，則將關閉此 socket。此 時間單位為秒。（0 表示沒有 TIMEOUT 設定 ）

 
/STxxx 設定系統的 timeout 時間。單位是秒。（0 表示沒有 TIMEOUT 設定 ）

 
/Txxx 設定一問一答模式的 timeout 時間，單位ms。預設值是 100 ms。

/m1 模式下使用
"/FCnnnnn"
 		 設定 cts 控制模式。
nnnnn 可以是一個到五個數字，分別依序代表 com1-com5 的設定值。n:0~3請參照命令28 參數說明  		3.0.07之後
"/FRnnnnn"
 		 設定 rts 控制模式
nnnnn 可以是一個到五個數字，分別依序代表 com1-com5 的設定值。n:0~3請參照命令28 參數說明  		3.0.07之後
"/Ehh"
 		 設定 回應命令的結尾
hh 是一個16進位元數字，預設值為0 例:設成0x0A就用"/E0A"
設成0xFF就用"/EFF" 
設定0表示不用結束字元，也就是不加任何字元在結尾。
  		3.0.09之後
"/L0" 加上一個命令列選項 "/L0"，可以 disable led5 的顯示。

（對於沒有 5DigitLed 的版本，可以省下顯示 led5 所花的時間。）
 

 3.0.09之後
"/SIpnnn" 設定 COM PORT 的 INPUT BUFFER 大小。
最大 32767。
p:COM1~COM8		 3.2.0 [2004/07/05]之後
 "/SOpnnn" 設定 COM PORT 的 OUTPUT BUFFER 大小。最大 32767。

p:COM1~COM8

 3.2.0 [2004/07/05]之後
 "/SCpnnn" 設定 COM PORT 所對應的 TCP 端 OUTPUT BUFFER 大小 ，最大為 32767。

3.2.0 [2004/07/05]之後
"/Bn" n='0': 設定成不接收廣播封包。不接受廣播封包時，系統會比較穩定。但是無法支援 UDP 廣播搜尋模組的功能。
n='1': 設定成可接收廣播封包。		 3.2.0 [2004/07/05]之後
"/Un" n='0': 設定不支援 UDP 功能。
n='1': 設定成支援 UDP 功能。
UDP 功能:1.可以用 UDP 廣播方式找出目前網域裡頭有哪些執行 vcom320/vcom3010 的模組，
2.可以透過 UDP 封包來設定模組的 IP/MASK/GATEWAY。		 3.2.0 [2004/07/05]之後
"/Dpnnn" 設定 COM PORT INPUT 資料的等待時間。
從 COM PORT 讀進來的資料會被放到一個 BUFFER，並啟動 timer，如果經過這一個設定沒有再收到資料，
就會把這些已經收進來的資料從 TCP/IP 送出。
預設值會根據該 PORT 的 baud rate 以及 UART fifo 的 triglevel 來決定。
時間單位 ms。

p:COM1~COM8

 3.2.0 [2004/07/05]之後
"COMp=nnn-n-P-n" 設定 COM PORT 的 baud rate, data bits, parity,stop bits。
(命令一定要有 '=')
nnn 大於 8 就是設定 baud rate。
n= '1' 或 '2' 設定 stop bits。
n= '5' 或 '6' 或 '7' 或 '8' 設定 data bits。
P= 'N'/'n': None Parity.
'E'/'e': Even Parity.
'O'/'o': Odd Parity.
'M'/'m': Mark Parity.
'S'/'s': Space Parity.
 順序可以對調，中間用減號('-')隔開。使用 "9600-N-8-1" 跟 "8-N-1-9600" 結果是一樣的。

3.2.0 [2004/8/20]之後
"/Nxxx" 設定 X-board 名稱。
"xxx" 會被 COPY 到變數 xBoardName 裡頭。		 3.2.0 [2004/07/05]之後
"/ping=nnn" 設定 ping gateway ，nnn 為 ping 的次數，使用時 nnn 最好 >=2。 3.2.3 [2006/04/28]之後
"/P23=n" 設定 Telnet 功能。
n='0': 設定不支援 Telnet 功能。
n='1': 設定成支援 Telnet 功能。
不設做設定時，其預設值為 "/P23=1" 		3.2.3 [2006/08/22]之後
"/HTTP=n" 設定 Web server 功能。
n='0': 設定不支援 Web server 功能。
n='1': 設定成支援 Web server 功能。
不設做設定時，其預設值為 "/HTTP=1" 		3.2.3 [2006/08/22]之後
底下參數屬於測試時期使用，正式出貨的版本不一定會保留。
/Kxxx 設定 tcp/ip 的 ACK delay 時間。 當收到對方資料後，如果沒有其它訊息要回應會對方且超過此時間後，會回應對方一個ACK, 單位ms。預設值：2。 由 /A 改成 /K [10/23/2001] 修改
/Cxxx 設定 max close delay 時間。單位 ms。預設值：500。  
/Pxxxxx 可以設定 PORT10000，改變Command port 10000, 如果PORT10000改為200，則COM port依序會變為201~208. 3.0.09 [07/23/2003]之後
/S1 Command port 及每一個COM port 只允許一個TCP/IP 連線進來, 其它的連線被會中斷 3.0.09[10/29/2003]之後
/S3nnn 設定COM3 的Input buffer 大小。最大32767 3.2.0
/Rxxx 設定 8019as 沒收到封包的最大時間。單位 ms。預設值：0。（不會 RESET。） 3.0.00[10/23/2001] 之後

(已停用)
/Zxxx 設定等待對方回應ACK時間，當timeout,會重發TCP 封包預設值：1000 ms 3.2.0[03/24/2004]之後
/Y 設定8KE4/8KE8 模式 3.2.0[2004/04/19]之後
/DHCP=x 設定DHCP功能 /dhcp0 (Disable) , /dhcp1 (Enable) 3.2.23[2005/04/13]之後
注意： 以上命令字元需為大寫

VXCOMM.EXE 5DigitLED/Led 顯示說明
  • 紅色 LED 每秒閃一次。亮 0.5 秒，熄掉 0.5 秒。
  • 5DifitLed 顯示每秒更新一次，共分成四個部份：
    •  11111. 顯示 IP address.
      接著四次顯示：
      1. xxx
      2. xxx
      3. xxx
      4. xxx
      為 IP ADDRESS 的第 1/2/3/4 碼。
    • 顯示完 IP 之後,會顯示 Port10000 number。
          例如 Port10000=54332 --> 顯示 "5.4.3.3.2."
                前面不足五位會補空白，每一位旁邊都加 '.'。
    •  22222. 顯示 com port 的 baudrate 設定。
      接著       N 次顯示系統 N 個 com port 的設定值（顯示值是實際值除以 100）
      1.1152
      2.  96
      3. 384
      4.1152
      ....
    •  33333. 顯示 com port 的 data format 設定。
      接著       N 次顯示系統 N 個 com port 的 data format 設定值。
      1. 801
      2. 801
      3. 811
      4. 701
      ....
    •  44444. 顯示聯機及系統 reset 狀態。
      1.ff.cc
      • ff：以十進位表示目前還有多少的 free 的 socket。
      • cc：以十進位表示目前聯機的 socket 個數。
      • For example: 1.26.01

      2.cccc

      • cccc：以十進位表示為 reset 的次數，從 7188E 第一次執行到現在為止 reset 的次數 (此值會存於EEPROM)
      • For example: 2.0610

      3.cccc

      • cccc：以十進表示，現在有多少個封包傳入 7188E
      • For example: 3.0126 , 126封包傳入7188E

      4.cccc

      • Flag顯示 (debug使用)，0000 代表硬體可以將封包傳出，0001代表硬體不可以將封包傳出 (7188e的TCP/IP可能有問題)

      5.cccc

      • TCP/IP chip 8019s reset 次數,每次 7188E 開機後，此值會重新計算，而且會 reset 8019s 1次，故正常的值應該為 0001
 

其他說明事項：

  1. 當使用一問一答模式時（/m1），沒有送任何命令或資料到 7188E 是收不到任何回應的。
  2. 當使用 /m0 （該叫什麼名稱比較好？）模式時，如果兩個以上的 client 端都要送data到 485 port 時，client 端需要考慮錯開 485 端的回應時間，不然當 485 的另一端有回應，又要送出 data 會出現亂碼。其實最好只有一個在送命令，其他的都等著收回應資料就好。如果是 RS-232 就不會有這個半雙工的問題，但仍要考慮另一端能否處理多個 client 端送過來參雜的命令或資料。
  3. 如果要用 232 以 Zmodem 傳檔案，應該是用 /m0 模式，只能有一個 client 端連進來。
  4. /U1 支援 UDP search 模組以及設定模組功能。
    其中 UDP search 模組 需要在 /B1 的狀況下才能用。
    USER 如果不用 UDP 的話是不需要用到 /B1。


發現任何錯誤請發mail 至 service@icpdas.com

[ 功能說明 ][ 版本說明 ]  [ 命令列參數說明 ][ 5DigitLED顯示說明 ]

[English][简体]

2008/02/19 13:05:36 +0800