腳本驅(qū)動開發(fā)工具接口函數(shù)

1、昆侖通態(tài),腳本驅(qū)動開發(fā)工具接口函數(shù),腳本驅(qū)動開發(fā)工具接口函數(shù),設(shè)備屬性； 設(shè)備通道； 設(shè)備命令； 全局變量； 設(shè)備腳本；,設(shè)備屬性,設(shè)備屬性的定義； 設(shè)備屬性的添加和刪除； 設(shè)備屬性的使用； 設(shè)備屬性在組態(tài)軟件的應(yīng)用；,設(shè)備屬性的定義,設(shè)備屬性是腳本驅(qū)動跟MCGSE組態(tài)軟件之間的配置接口，組態(tài)工程通過設(shè)置設(shè)備屬性來對腳本驅(qū)動進(jìn)行一定的調(diào)整和設(shè)置。 設(shè)備屬性是腳本驅(qū)動的一個基本組成元素，其目的是用來在腳本驅(qū)動開發(fā)完成之后，在MCGSE組態(tài)環(huán)境中對腳本驅(qū)動組態(tài)時候可以修改一些與現(xiàn)場、環(huán)境相關(guān)的設(shè)備參數(shù)值，使腳本驅(qū)動能夠適應(yīng)不同的環(huán)境。,設(shè)備屬性添加和刪除,執(zhí)行菜單命令驅(qū)動編輯添加屬性，系統(tǒng)會顯示添

2、加設(shè)備屬性對話框,要添加的屬性名稱,屬性類型：整型、浮點(diǎn)型,屬性值的有效范圍,屬性值的默認(rèn)值,設(shè)備屬性添加和刪除,選中設(shè)備窗口中的設(shè)備根節(jié)點(diǎn)，展開下面的設(shè)備屬性節(jié)點(diǎn) 選中要刪除的屬性 執(zhí)行菜單命令驅(qū)動編輯刪除當(dāng)前節(jié)點(diǎn)，系統(tǒng)會顯示刪除確認(rèn)對話框,設(shè)備屬性的使用,設(shè)備屬性可以在腳本驅(qū)動的所有腳本中全局使用。設(shè)備屬性表示了用戶對腳本驅(qū)動所進(jìn)行的一些參數(shù)設(shè)置和調(diào)整。在設(shè)備腳本中必須讀取這些參數(shù)，以按照用戶需要的方式控制腳本驅(qū)動的工作方式。,設(shè)備屬性在組態(tài)軟件的應(yīng)用,腳本驅(qū)動中的設(shè)備屬性在MCGSE組態(tài)軟件中看起來是下圖的樣子 ：,設(shè)備通道,設(shè)備通道定義； 設(shè)備通道添加和刪除； 操作設(shè)備通道； 設(shè)備通道

3、輸出時間間隔； 設(shè)備通道在組態(tài)中的應(yīng)用；,設(shè)備通道定義,設(shè)備通道是腳本驅(qū)動跟實(shí)時數(shù)據(jù)對象之間的接口，它用于實(shí)現(xiàn)腳本驅(qū)動中的數(shù)據(jù)輸出功能。在組態(tài)環(huán)境和運(yùn)行環(huán)境下，腳本驅(qū)動通過設(shè)備通道向工程中的實(shí)時數(shù)據(jù)對象定時上報采集到的數(shù)據(jù)；,設(shè)備通道的添加和刪除,添加一個新的設(shè)備通道： 執(zhí)行菜單命令驅(qū)動編輯添加通道，系統(tǒng)會顯示添加設(shè)備通道對話框,輸入通道名稱,通道類型,增加連續(xù)通道個數(shù),設(shè)備通道的添加和刪除,刪除一個設(shè)備通道： 選中設(shè)備窗口中的腳本驅(qū)動根節(jié)點(diǎn)，展開設(shè)備通道節(jié)點(diǎn) 選中要刪除的設(shè)備通道 執(zhí)行菜單命令驅(qū)動編輯刪除當(dāng)前節(jié)點(diǎn)，系統(tǒng)會顯示刪除確認(rèn)對話框,操作設(shè)備通道,通道標(biāo)識，系統(tǒng)用通道名稱和通道編號兩種

4、方式來唯一標(biāo)識一個通道。通道的編號是從開始的，每一個通道的編號順序與在設(shè)備窗口下的設(shè)備通道列表中的排列顯示順序是一致的 ； 通道接口函數(shù)，通道操作函數(shù)分為寫通道、讀通道、通道輔助功能三類函數(shù)；,通道接口函數(shù),通道輔助功能 GetCurrentChannelNum，得到當(dāng)前觸發(fā)單通道寫的通道； GetChannelCount，得到驅(qū)動通道總數(shù)； 讀通道 GetIntChannelValueByName， GetSingleChannelValueByName GetIntChannelValueByNum GetSingleChannelValueByNum 寫通道 SetIntChannelV

5、alueByName SetSingleChannelValueByName SetIntChannelValueByNum SetSingleChannelValueByNum,設(shè)備通道輸出時間間隔,最小采集周期，用戶在可以在組態(tài)軟件中設(shè)置腳本驅(qū)動的最小采集周期 ； 采集腳本的執(zhí)行時間，用戶編寫的采集腳本在運(yùn)行過程中也會耗費(fèi)一定的時間。所耗費(fèi)的時間長短隨腳本的不同而變化。采集腳本是決定腳本驅(qū)執(zhí)行效率最關(guān)鍵的一個因素。高質(zhì)量的采集腳本執(zhí)行效率高且執(zhí)行時間也短。,設(shè)備通道在組態(tài)中的應(yīng)用,設(shè)備通道輸出的數(shù)據(jù)僅能被實(shí)時數(shù)據(jù)對象接收和保存。 在組態(tài)軟件中的關(guān)聯(lián)方法為打開設(shè)備屬性設(shè)置對話框，選中通道連接

6、選項卡，選中要設(shè)置的通道行，在第一列中輸入要關(guān)聯(lián)的實(shí)時數(shù)據(jù)對象。如圖所示：,設(shè)備命令,設(shè)備命令的定義； 設(shè)備命令的添加和刪除； 設(shè)備命令的使用；,設(shè)備命令的定義,在組態(tài)工程中可以通過向腳本驅(qū)動發(fā)送設(shè)備命令來控制腳本驅(qū)動的工作。組態(tài)工程的運(yùn)行過程中，只能通過設(shè)備命令來對其進(jìn)行控制，設(shè)備命令是對腳本驅(qū)動唯一的動態(tài)控制方法。設(shè)備命令只能在組態(tài)工程的腳本中調(diào)用，而不能在腳本驅(qū)動內(nèi)部的設(shè)備腳本中調(diào)用。 如果需要在組態(tài)工程的運(yùn)行過程中動態(tài)的控制腳本驅(qū)動的工作方式，則需要在腳本驅(qū)動中添加適當(dāng)?shù)脑O(shè)備命令，然后在組態(tài)工程中需要的地方調(diào)用設(shè)備命令以控制腳本驅(qū)動的工作方式。對于在組態(tài)工程運(yùn)行前就可以確定并且在運(yùn)行過

7、程中不需要再改變(或者在運(yùn)行過程中禁止改變)的工作方式，則可以使用設(shè)備屬性來實(shí)現(xiàn)工作方式的控制。,設(shè)備命令的添加和刪除,添加一個設(shè)備命令到腳本驅(qū)動中。執(zhí)行菜單命令驅(qū)動編輯添加命令，系統(tǒng)會顯示添加設(shè)備命令對話框,設(shè)備命令的名稱,傳入?yún)?shù)的名稱,傳入?yún)?shù)類型,設(shè)備命令的添加和刪除,刪除指定的設(shè)備命令。 選中設(shè)備窗口中的腳本驅(qū)動根節(jié)點(diǎn)，展開設(shè)備命令節(jié)點(diǎn) 選中要刪除的設(shè)備命令 執(zhí)行菜單命令驅(qū)動編輯刪除當(dāng)前節(jié)點(diǎn)，系統(tǒng)會顯示刪除確認(rèn)對話框,設(shè)備命令的使用,在組態(tài)環(huán)境下，腳本驅(qū)動的設(shè)備命令會在對象幫助窗口中顯示。如在腳本驅(qū)動中添加如下的設(shè)備命令，則在組態(tài)環(huán)境下的對象幫助窗口中，展開該腳本驅(qū)動設(shè)備的方法，則可

8、以看到設(shè)備命令。其中，左圖為腳本驅(qū)動開發(fā)環(huán)境，右圖為組態(tài)環(huán)境 在組態(tài)環(huán)境中，雙擊對象幫助窗口中“方法”下面的設(shè)備命令，即可把設(shè)備命令添加到腳本中。注意：上述使用設(shè)備命令的方式僅適用于腳本驅(qū)動而不能用于普通的DLL驅(qū)動。,全局變量,全局變量的定義； 全局變量的添加和刪除； 全局變量的使用,全局變量的定義,全局變量用于保存數(shù)據(jù)，它在所有的腳本中都可使用，并且在整個腳本驅(qū)動的運(yùn)行期內(nèi)都可見，它主要用于： 可以在不同的腳本之間共享信息 ； 在腳本驅(qū)動運(yùn)行時期內(nèi)可以持續(xù)地保存的數(shù)據(jù)，尤其是保存一些腳本驅(qū)動運(yùn)行時的狀態(tài)信息 ；,全局變量的添加和刪除,執(zhí)行菜單命令驅(qū)動編輯|添加全局變量，系統(tǒng)會顯示添加全局變

9、量對話框：,輸入全局變量的名稱,選擇全局變量的類型,是否設(shè)置為數(shù)組,全局變量的添加和刪除,選中要刪除的全局變量 ，執(zhí)行菜單命令驅(qū)動編輯|刪除當(dāng)前結(jié)點(diǎn)，系統(tǒng)會顯示刪除確認(rèn)畫面：,全局變量的使用,建議在使用全局變量之前執(zhí)行必要的初始化操作，以保證腳本驅(qū)動內(nèi)的所有全局變量的初始狀態(tài)是預(yù)期的狀態(tài)。全局變量的初始化應(yīng)在初始化腳本中完成。系統(tǒng)保證在運(yùn)行環(huán)境下最先調(diào)用初始化腳本； 在腳本中引用全局變量跟使用局部變量的方法相同；,設(shè)備腳本,初始化腳本：MCGSE組態(tài)軟件運(yùn)行環(huán)境調(diào)用該腳本執(zhí)行腳本驅(qū)動的初始化操作。腳本名稱為“InitDevice”； 采集腳本：采集腳本會在每一個采集周期到達(dá)之后，被MCGSE組態(tài)軟件運(yùn)行環(huán)境所調(diào)用。該腳本實(shí)現(xiàn)了從設(shè)備采集數(shù)據(jù)并向組態(tài)工程上報采集、處理后的數(shù)據(jù)。它的腳本名稱為“CollectData”。 單通道寫腳本：在組態(tài)軟件的運(yùn)行環(huán)境下，當(dāng)與通道關(guān)聯(lián)的實(shí)時數(shù)據(jù)對象的值被組態(tài)工程的用戶手動修改后，運(yùn)行環(huán)境會調(diào)用單通道寫腳本。用于接收用戶的輸入并向設(shè)備發(fā)送控制命令。它的腳本名稱為“SingleC