VNC與工控機接口協(xié)議規(guī)范

1、1. 說明1.1. 通訊方式 1. 工控機和 VNC 采用 RS232 異步通信協(xié)議。 2. 通訊參數(shù)： 數(shù)據(jù)位 停止位 起始位 奇偶校驗位 波特率 8 1 1 無 19200 3. 超時時間：最長應答時間不超過 1000 毫秒，工控機收到 VNC 指令以后，在 100 毫秒內(nèi)必須應答，超時應答無效。 4. 指令發(fā)起方式：指令只能由 VNC 發(fā)起，工控機進行應答。如果工控機有配置下發(fā)或者需要進行出貨，則可以通過對 POLL 指令的應答返回信息。這樣的情況下 VNC 需要再返回一個 ACK 或者 NAK。 1.2. 注意事項 1. 如果用戶已經(jīng)投入硬幣或者插入紙幣，必須交易結束后（找零或退幣）后

2、才能接收工控機的出貨指令。 2. 為了避免出貨沖突，VNC 只能在 3 秒內(nèi)出貨一次。 3. 如果 VNC 與工控設備連續(xù) 10 秒交互失敗，則需要重新簽到。 4. 門由打開狀態(tài)變?yōu)殛P閉狀態(tài)后，VNC 重新進入初始狀態(tài)，需要重新簽到。 5. 用戶輸入貨道編號后，VNC 將此貨道的信息發(fā)送工控機。連續(xù)通知 4-5 秒，直到收到工控機的 ACK。如果此貨道不能出貨（無貨或者料道故障、暫停營業(yè)、門打開）則都不需要上報給工控機，相當于沒有選擇；如果按鍵對應了多個料道，則返回一個能出貨的料道。 2. 報文說明 2.1. VNC 報文結構 幀格式 指令 特征字 數(shù)據(jù) 校驗位 1（byte） 3（bytes

3、） N（bytes） 1（byte） 描述： 字段 描述 指令 標明具體交互指令。 特征字 0xEF、0xEE、0xFE，如果報文沒有數(shù)據(jù)，則不需要特征字。 注意： 1、 VNC回復的ACK或NAK報文沒有特征字節(jié)。 2、 POLL指令應答報文中也沒有特征字節(jié)。 數(shù)據(jù) 交互數(shù)據(jù)。 校驗位 和校驗。 2.2. 數(shù)據(jù)類型 符號 描述 N 或 n 數(shù)字數(shù)據(jù)， N1 或 n1 表示是數(shù)字數(shù)據(jù)且長度為 1byte。 A 或 a 字母表數(shù)據(jù)，A2 或 a2 表示是字母表數(shù)據(jù)且長度為 2bytes。 B 或 b 1. 二進制數(shù)據(jù)：金額、數(shù)量、商品序號等信息。 如：0xFF 即 255，高位在前低位在后。 2

4、. BCD 碼：帳號、日期、時間等。 數(shù)據(jù)為 0-F，可以將兩位壓縮成 1 位，如“A7”壓縮成 0xA7; 如月份“6”月壓縮成月份為 0x06。 例如：2015 年 5 月 13 日，則 BCD 碼為：0x20150513。 例如：14 點 30 分 28 秒，則 BCD 碼為：0x143028。 3. B1 或 b1 表示是二進制數(shù)據(jù)且長度為 1byte。 2.3. VNC 指令 指令 值 描述 貨柜連接信息 0x74 1、 貨柜的連接信息表示哪些貨柜連接上了。 2、 簽到后發(fā)送。 3、 有貨柜連接上或者斷開后發(fā)送。 貨道設置信息 0x75 1、 貨道的設置信息。 2、 簽到后發(fā)送。 3

5、、 貨道改變后發(fā)送。 POLL 輪詢 0x76 VNC 每隔 300ms 秒發(fā)送此指令到工控機，這里面包括收到貨幣的情況以及用戶輸入商品的信息。同時工控機如果有配置需要下發(fā)或者是需要出貨的時候，將數(shù)據(jù)放到回復 POLL 指令的 ACK 報文中。 簽到 0x78 1、 VNC 初始階段發(fā)送，直到成功應答后才發(fā)送其他指令。 2、 在門由開啟變?yōu)殛P閉狀態(tài)時需要重新簽到。 3、 主柜類型改變后需要重新簽到。 4、 擴展柜類型有添加或者移除需要重新簽到。 5、 簽到后各個幀的發(fā)送序列為（每幀間隔 500ms）： a）貨柜連接信息。 b）貨道設置信息。 c）貨道價格信息（按照貨柜編號依次發(fā)送）。 d）貨道

6、故障信息（按照貨柜編號依次發(fā)送）。 e）機器運行信息。 f）系統(tǒng)配置信息。 貨道故障（有貨無貨）信息 0x79 1、 各個貨道故障或（有貨無貨）信息。 2、 簽到后發(fā)送。 3、 一個貨道從故障（非故障）變?yōu)榉枪收希ü收希┖蟀l(fā)送。 VNC 配置信息 0x7A 1、 相關系統(tǒng)配置設置參數(shù)。 2、 簽到后發(fā)送。 3、 相應參數(shù)改變后發(fā)送。 商品銷售匯總信息 0x7B 1、 商品銷售匯總信息，按貨道進行統(tǒng)計。 2、 POLL 幀里主動請求獲取銷售數(shù)據(jù)后發(fā)送。 出貨 0x7C VNC 出貨結束后，將出貨的信息發(fā)送到工控機。 機器運行（故障）信息 0x7D 1、 售貨機運行（故障）狀態(tài)。 2、 簽到后發(fā)送

7、。間隔 30 秒鐘發(fā)送。 貨道價格信息 0x7F 1、 各個貨道的價格信息。 2、 簽到后發(fā)送。 3、 貨道價格設置完成后發(fā)送。 4、 貨道價格由外部（如遙控器，手柄）改變后發(fā)送。 POS 機狀態(tài)信息 0x81 1、 POS 機的狀態(tài)信息。 2、 POS 機狀態(tài)發(fā)生改變后發(fā)送。 貨道優(yōu)惠信息 0x82 1、 各個貨道的優(yōu)惠信息。 2、 優(yōu)惠信息設置完成后發(fā)送。 3、 貨道優(yōu)惠信息或者價格信息改變后發(fā)送。 4、 簽到后發(fā)送。 2.4. 應答報文 1. ACK 報文 報文的正文只有一個字節(jié) 0x00,這個就是 ACK 報文，一般表示收到指令的確認。 指令 數(shù)據(jù) 校驗和 1（byte） 0x00 （

8、1byte） 1（byte） 2. NAK 報文 報文的正文只有一個字節(jié) 0x15,這就是 NAK 報文，一般用于表示收到指令但執(zhí)行失敗，一般原因是報文的內(nèi)容不符合規(guī)范。 指令 數(shù)據(jù) 校驗和 1（byte） 0x15 1(byte) 3. 輪詢應答報文 輪詢應答報文是 VNC 發(fā)送輪詢指令到工控機，工控機需要發(fā)送配置或者是出貨的時候，回復此報文（沒有配置和不需要出貨時候則直接回復 ACK 報文）。 指令 數(shù)據(jù) 校驗和 1（byte） 交易碼 1（byte） N（bytes） 1（byte） 在數(shù)據(jù)字段中，第一位是交易碼。表示工控機要執(zhí)行的動作。 交易碼 名稱 描述 0x02 設置系統(tǒng)時間 設置

9、 VNC 的系統(tǒng)時間。 0x03 出貨請求 通知 VNC 出貨。 0x04 設置貨道價格信息 設置貨道的價格。 0x05 設置系統(tǒng)配置信息 制冷、加熱等系統(tǒng)配置信息。 0x06 清除銷售統(tǒng)計 清除銷售統(tǒng)計。 0x07 獲取銷售信息 獲取銷售信息。 0x08 開始設置貨道價格 開始設置貨道價格。通知 VNC 要開始設置貨道的價格。 不支持此功能可以忽略此幀，回復 ACK 即可。 0x09 貨道價格設置完成 設置貨道價格完成。通知 VNC 貨道價格設置完成。 不支持此功能可以忽略此幀，回復 ACK 后在一定時間內(nèi)需時上報貨道價格信息。 0x0A 設置貨道優(yōu)惠信息 設置貨道優(yōu)惠信息。 2.5. 指令

10、應答流程說明 1. 一般流程 說明：VNC 發(fā)送（除 POLL 指令）指令，工控機直接回復 ACK 報文，不附帶任何數(shù)據(jù)。 VNC 工控機 VNC指令 ACK 2. POLL 指令工控機有數(shù)據(jù)下發(fā)流程說明：VNC 發(fā)出 POLL 指令，工控機附帶數(shù)據(jù)響應，VNC 回應成功或者失敗。 注意：工控機有數(shù)據(jù)響應時，報文中不需要攜帶特征字。 VNC 工控機 VNC指令 工控機響應（攜帶數(shù)據(jù)） ACK或NAK 注意：VNC 收到工控機的 POLL ACK 指令以后，如果發(fā)現(xiàn)報文有問題或者校驗不成功則回復NAK 報文，否則回復 ACK 報文。 3. VNC 指令 3.1. 簽到 字段 屬性 描述 主控板版

11、本號 B2 主控板版本號。 驅動板版本號 B2 驅動板版本號。 VNC 協(xié)議版本號 B1 協(xié)議版本號，1-255。V1.3 協(xié)議版本號是 1；此協(xié)議是 V1.4，版本號為 2。依次累加。 售貨機編號 B4 BCD 碼，八位數(shù)字壓縮碼。 時間 B7 BCD 碼，YYYYMMDDHHMMSS，14 位 VNC 時間壓縮碼。 主柜類型 B1 貨柜的類型：0x01 飲料機，0x02 綜合機（綜合機包括彈簧機和履帶機），0x03 - 格子機。 注意： 1、 如果主柜是綜合機則擴展柜里面不允許有飲料機； 2、 如果主柜是格子機則擴展柜只能是格子機。 3、 主柜的貨柜編號為 0。 主柜貨道數(shù) B1 主柜的貨

12、道數(shù)。 16 個擴展柜信息 B32 1、 表示 1-16 貨柜信息，貨柜編號一次為 1-16。 2、 每兩個 byte 表示一個柜的信息，如果沒有則為 0。 3、 貨柜類型：0x01 飲料機，0x02 綜合機（綜合機包括彈簧機和履帶機），0x03 - 格子機。 Byte1：表示貨柜 1 的類型。 Byte2：表示貨柜 1 貨道的數(shù)量。 Byte3：表示貨柜 2 的類型。 Byte4：表示貨柜 2 貨道的數(shù)量。 Byte31：表示貨柜 16 的類型。 Byte32：表示貨柜 16 貨道的數(shù)量。 注意：屬性中 B2，就表示數(shù)據(jù)是 2 進制，兩個字節(jié)。 工控機應答 ACK。 3.2. POLL 指令

13、 字段 屬性 描述 用戶投入現(xiàn)金金額 B6 此信息每次都要發(fā)送。 Byte1-2：接收的總金額,0 65535,以分為單位，比如 1005 表示 10.5 元。 Byte3-4：紙幣器接收金額。 Byte5-6：硬幣器接收金額。 鍵盤輸入貨道 B4 Byte1：貨柜編號。 Byte2：貨道編號。（沒有按鍵為 0x00）。 Byte3-4：商品價格 0-65535。以分為單位。 工控機應答 ACK 或其它數(shù)據(jù)。 3.3. 出貨 字段 屬性 描述 貨柜編號 B1 貨柜編號：0-16。 貨道編號 B1 貨道編號：1-100。 售賣金額 B2 0-65535，以分為單位。 支付方式 B1 支付方式定義

14、如下： 1、 04 - 現(xiàn)金支付。 2、 05 刷卡。 3、 其他非本地支付方式由工控機發(fā)送出貨請求中填充。如：出貨請求中支付方式為 1，則這里的支付方式為 1。 出貨狀態(tài) N1 1. 0 - 出貨成功。 2. 1 - 該貨道無貨或者故障。 3. 2 - 其他原因沒有出貨。 4. 3 報文信息不正確。 5. 4 支付失敗。 流水號 B3 由工控機發(fā)起的出貨請求，在發(fā)送出貨幀時候由工控機填充，否則主控板在此基礎上自動累加這個值。 工控機應答 ACK 3.4. 貨柜連接信息 字段 屬性 描述 貨柜連接信息 B3 Bit0：表示主機（貨柜 0）是否連接。 Bit1：表示貨柜 1 是否連接。 Bit2

15、：表示貨柜 2 是否連接。 . Bit16 表示貨柜 16 是否連接。 貨柜是否支持設置價格到 VNC B3 Bit0：表示主機（貨柜 0）是否支持設置價格。 Bit1：表示貨柜 1 是否支持設置價格。 Bit2：表示貨柜 2 是否支持設置價格。 . Bit16 表示貨柜 16 是否支持設置價格。 3.5. 貨道設置信息 字段 屬性 描述 貨柜編號 B1 貨柜編號：0-16。 貨道設置信息 B13 表示 1-100 貨道是否設置（這里的設置表示 VNC 是否支持該貨道）。各字節(jié)相應位 0 表示未設置，1 表示設置。 比如：彈簧機貨道編號從 10 開始，則 Byte1 為；s。Byte2 的第

16、0 個 Bit 也為 0，第 1 個 Bit 代表 10 貨道設置。 Byte1：1-8 貨道。 Byte2：9-16 貨道。 Byte3：17-24 貨道。 Byte4：25-32 貨道。 Byte5：33-40 貨道。 Byte6：41-48 貨道。 Byte7：49-56 貨道。 Byte8：57-64 貨道。 Byte9：65-72 貨道。 Byte10：73-80 貨道。 Byte11：81-88 貨道。 Byte12：89-96 貨道。 Byte13：97-104 貨道。 工控機應答 ACK。 3.6. 貨道故障（有貨無貨）信息 字段 屬性 描述 貨柜編號 B1 貨柜編號：0-16

17、。 貨道是否故障 B13 表示 1-100 貨道的故障（有貨無貨）信息。飲料機各字節(jié)相應位 0 表示有貨，1 表示故障或者是無貨。綜合機或格子機各字節(jié)相應位 0 表示正常，1 表示故障。如果格子機可以檢測到有貨沒貨則 0 表示有貨，1 表示沒貨。 Byte1：1-8 貨道。 Byte2：9-16 貨道。 Byte3：17-24 貨道。 Byte4：25-32 貨道。 Byte5：33-40 貨道。 Byte6：41-48 貨道。 Byte7：49-56 貨道。 Byte8：57-64 貨道。 Byte9：65-72 貨道。 Byte10：73-80 貨道。 Byte11：81-88 貨道。 B

18、yte12：89-96 貨道。 Byte13：97-104 貨道。 工控機應答 ACK 3.7. 機器運行信息 字段 屬性 描述 運行狀態(tài) B1 BIT2：0主控板模式按鈕沒有按下；1按下模式按鈕（控制板上默認門打開，并且按下模式按鈕，可進行菜單中參數(shù)設置），注意：無此功能該位置位 0. Bit1：0 - 門關，1 - 門開。 Bit0：0 營業(yè)，1 - 暫停營業(yè)。 售貨機狀態(tài) B1 Bit7:讀卡器無應答。 Bit6：紅外模塊故障。 Bit5：右室溫度異常。 Bit4：左室溫度異常。 Bit3：右室溫度傳感器故障。 Bit2：左室溫度傳感器故障。 Bit1：系統(tǒng)時鐘不正常。 Bit0：驅動板

19、無應答。 紙幣器狀態(tài) B1 Bit7：保留。 Bit6：紙幣堵塞（紙幣器口）。 Bit5：紙幣器錢箱滿（錢箱）。 Bit4：紙幣器錢箱被取走（錢箱）。 Bit3：紙幣器ROM 校驗錯。 Bit2：紙幣器傳感器故障。 Bit1：紙幣器驅動馬達故障。 Bit0：紙幣器無應答。 硬幣器狀態(tài) B1 Bit7：硬幣器1 元缺幣（錢幣）。 Bit6：硬幣器1 分缺幣（錢幣）。 Bit5：硬幣支出堵塞（硬幣口）。 Bit4：硬幣接收堵塞（硬幣口）。 Bit3：硬幣器ROM 校驗錯。 Bit2：硬幣器傳感器故障。 Bit1：硬幣器工作電壓低（警告）。 Bit0：硬幣器無應答。 硬幣器檢測到硬幣數(shù)量 B4 By

20、te1-2：0.5元個數(shù)。 Byte3-4：1元個數(shù)。 紙幣數(shù)量 B2 紙幣數(shù)量（VNC計算所得）。 工控機應答 ACK 3.8. 系統(tǒng)配置信息 字段 屬性 描述 照明狀態(tài) B1 0x00：自動， 0x01：常閉，0x02：常亮。 日光燈時間 B4 采用 BCD 碼，不支持則為 0x99, 0x99, 0x99, 0x99。 Byte1-2：開燈時間 HHMM 壓縮。 Byte3-4：停止時間 HHMM 壓縮。 溫控狀態(tài) B1 0x00：制冷，0x01：制熱，0x02：關閉（常溫），0x99：不支持。 如果售貨機分左室和右室則分別控制左室和右室的溫度。 節(jié)能時間 B4 采用 BCD 碼。不支持

21、則為 0x99, 0x99, 0x99, 0x99。 Byte1-2：節(jié)能開啟時間，HHMM 壓縮。 Byte3-4：節(jié)能關閉時間，HHMM 壓縮。 制冷溫度 B1 制冷設定溫度。 Bit7：0 正值，1 負值。 B1 制冷實際溫度。 Bit7：0 正值，1 負值。 加熱溫度 B1 加熱設定溫度。 Bit7：0 正值，1 負值。 B1 加熱實際溫度。 Bit7：0 正值，1 負值。 工控機應答 ACK 3.9. 貨道價格信息 字段 屬性 描述 貨柜編號 B1 貨柜編號：0-16。 貨道價格信息 B200 1-100 貨道的價格信息，每 2 個 byte 表示一個貨道的價格。以分為單位：如 0x

22、01 表示 0.01 元;0xFF 表示 2.55 元;0xFFFF 表示655.35 元。 工控機應答 ACK 3.10. 商品銷售匯總信息 字段 屬性 描述 貨柜編號 B1 貨柜編號：0-16。 貨道銷售總數(shù)量 B200 1-100 貨道銷售商品總數(shù)，每 2 個 byte 表示一個貨道銷售商品總量。 時間 B7 BCD 碼。YYYYMMDDHHMMSS，此出的時間是清零時間不是發(fā)送時間。 工控機應答 ACK。 3.11. POS 狀態(tài)信息 字段 屬性 描述 POS 機狀態(tài) N1 POS 機器的狀態(tài)信息 1、0 - 等待刷卡 2、1 - 認證中。 3、2 - 授權成功。 4、3 - 授權失敗

23、。 說明：當接收到 POS 機授權成功的消息后，用戶如果是通過按鈕選的商品則 VNC 直接扣款 s 出貨，否則工控機當以當前屏幕選擇的商品發(fā)送出貨指令；VNC 通過 POS 機扣款出貨后只需要將出貨的信息上報給工控機。 不支持此功能可以忽略此幀。 工控機應答 ACK。 3.12. 貨道優(yōu)惠信息 字段 屬性 描述 貨柜編號 B1 貨柜編號：0-16。 貨道優(yōu)惠信息 B200 1-100 貨道的優(yōu)惠信息。每 2 個 byte 表示一個貨道的優(yōu)惠金額，單位分。 工控機應答 ACK。 4. 工控機應答 4.1. 設置系統(tǒng)時間 字段 屬性 描述 交易碼 B1 0x02。 時間 B7 BCD 碼，YYYY

24、MMDDHHMMSS，14 位時間壓縮碼。 VNC 應答 ACK 4.2. 出貨請求 字段 屬性 描述 交易碼 B1 0x03。 貨柜編號 B1 貨柜編號：0-16。 貨道編號 B1 貨道編號：1-100。 變價出貨 B1 是否變價出貨，變價出貨為 1，否則為 0。如果是移動支付方式則應該設置變價出貨，本地支付則不變價出貨。 售賣金額 B2 0 65535，以分為單位。如果是移動支付則售賣金額是 0，否則原價。 支付方式 B1 支付方式定義如下： 1、 04 - 現(xiàn)金支付。 2、 05 刷卡。 3、 其他取值為（1-3，6-255）。 流水號 B3 注意：兩次相連的流水號不能重復。 注意： 1、 在門打開或者是暫停營業(yè)的狀態(tài)，是不能進行出貨的。 2、 VNC 應答 ACK 4.3. 設置貨道價格信息 字段 屬性 描述 交易碼 B1 0x04。 貨柜編號 B1 貨柜編號：0-16。 貨道編號 B1 貨道編號：1-100。 商品價格 B2 以分為單位，如：0x01 表示 0.01 元；0xFFFF 表示 655.35 元。 注意： 1、 貨道信息只有在商品信息更新以后