一、腳本是什么？

藍(lán)蜂腳本二次開發(fā)平臺(tái)是運(yùn)行在網(wǎng)關(guān)和組態(tài)頁面上的二次開發(fā)工具，通過此工具可實(shí)現(xiàn)網(wǎng)關(guān)腳本和頁面腳本的編寫，用于快速實(shí)現(xiàn)項(xiàng)目中的復(fù)雜業(yè)務(wù)場(chǎng)景和功能。為用戶提供更多的功能拓展和數(shù)據(jù)展現(xiàn)樣式。比如: 數(shù)據(jù)統(tǒng)計(jì)、報(bào)警聯(lián)動(dòng)，自動(dòng)化控制、畫面動(dòng)效等功能。

二、功能介紹

腳本功能分為網(wǎng)關(guān)腳本和頁面腳本，下面分別介紹一下二者的具體功能

2.1 網(wǎng)關(guān)腳本

網(wǎng)關(guān)腳本介紹

適用于在網(wǎng)關(guān)上進(jìn)行低代碼開發(fā)的腳本工具，可在網(wǎng)關(guān)上快速實(shí)現(xiàn)復(fù)雜的業(yè)務(wù)場(chǎng)景（網(wǎng)關(guān)現(xiàn)有標(biāo)準(zhǔn)功能不具備的）

可實(shí)現(xiàn)數(shù)據(jù)統(tǒng)計(jì)分析、數(shù)據(jù)處理、聯(lián)動(dòng)控制、協(xié)議解析等自定義功能。

網(wǎng)關(guān)腳本特點(diǎn)：

1自由靈活

2.快速實(shí)現(xiàn)

3.功能擴(kuò)展

網(wǎng)關(guān)腳本功能拓?fù)鋱D

2.2 頁面腳本

功能介紹

頁面腳本運(yùn)行在組態(tài)頁面中的工具，通過頁面腳本在組態(tài)頁面中實(shí)現(xiàn)動(dòng)畫效果、綁定數(shù)據(jù)等、批量調(diào)參等操作，讓組態(tài)頁面靈活多變，可視化效果更豐富

實(shí)現(xiàn) 運(yùn)輸帶、流水線、一鍵開啟閥門、批量調(diào)參等

頁面腳本特點(diǎn)：

1.編寫簡單

2.控件屬性可控

3.結(jié)果可視化

頁面腳本功能拓?fù)鋱D

三、腳本能做什么？

l 大數(shù)據(jù)統(tǒng)計(jì)，比如：數(shù)據(jù)日?qǐng)?bào)、周報(bào)、月報(bào)、設(shè)備運(yùn)行時(shí)長、統(tǒng)計(jì)流量等

l 跨設(shè)備點(diǎn)對(duì)點(diǎn)數(shù)據(jù)傳輸

l 平臺(tái)監(jiān)控?cái)?shù)據(jù)的同時(shí)，通過MQTT轉(zhuǎn)發(fā)數(shù)據(jù)

l 定時(shí)、周期性、多條件下的設(shè)備啟停

l 批量參數(shù)控制，一鍵即可開啟多個(gè)閥門、泵站、寫入?yún)?shù)等

l 報(bào)警聯(lián)動(dòng)設(shè)備，報(bào)警即關(guān)閘，正?？砷_閘

l 存儲(chǔ)車間產(chǎn)量，記錄，計(jì)算能耗成本

四、腳本的優(yōu)勢(shì)

1.輕松解決問題

腳本功能是免費(fèi)，實(shí)現(xiàn)復(fù)雜業(yè)務(wù)或功能，無需定制化開發(fā)，幾行代碼就搞定

2. 降低平臺(tái)負(fù)載

腳本程序獨(dú)立運(yùn)行在網(wǎng)關(guān)內(nèi)，不會(huì)增加云平臺(tái)服務(wù)器壓力，巧妙的腳本還可以降低云平臺(tái)的計(jì)算負(fù)載

3.云邊協(xié)同

組態(tài)和網(wǎng)關(guān)都可運(yùn)行腳本，能夠共同處理業(yè)務(wù)，實(shí)現(xiàn)云邊協(xié)同

4.開放性高

開放大量API函數(shù)，支持多種運(yùn)行環(huán)境，非常適合進(jìn)行二次開發(fā)

5.簡單易學(xué)習(xí)

使用JavaScript作為編程語言，上手容易，簡單學(xué)習(xí)即可編寫腳本

6.支持并發(fā)執(zhí)行

一臺(tái)網(wǎng)關(guān)可同時(shí)運(yùn)行多個(gè)腳本程序，舉例：進(jìn)行數(shù)據(jù)統(tǒng)計(jì)的同時(shí)也可實(shí)現(xiàn)MQTT數(shù)據(jù)轉(zhuǎn)發(fā)

五、腳本應(yīng)用案例

5.1統(tǒng)計(jì)空壓機(jī)運(yùn)行時(shí)長

場(chǎng)景描述：

統(tǒng)計(jì)空壓機(jī)設(shè)備的運(yùn)行時(shí)長，記錄一天中空壓設(shè)備開啟的時(shí)間和累計(jì)運(yùn)行總時(shí)長

解決方案：

空壓機(jī)設(shè)備PLC接入EG20網(wǎng)關(guān)作為監(jiān)測(cè)模塊，同時(shí)配合EMCP物聯(lián)網(wǎng)云平臺(tái)進(jìn)行設(shè)備監(jiān)測(cè)

1. 云平臺(tái)創(chuàng)建對(duì)應(yīng)設(shè)備，作為空壓機(jī)處理器監(jiān)控設(shè)備

2. 登錄EMCP物聯(lián)網(wǎng)云平臺(tái)，創(chuàng)建空壓設(shè)備，可命名為空壓控制設(shè)備，添加對(duì)應(yīng)的驅(qū)動(dòng)，和配置網(wǎng)關(guān)

3. 創(chuàng)建兩個(gè)內(nèi)部變量：今日運(yùn)行時(shí)長: equip_run_todayl_time和累計(jì)運(yùn)行總時(shí)長:equip_run_total_time,用于存儲(chǔ)設(shè)備運(yùn)行數(shù)據(jù)

4. 創(chuàng)建設(shè)備變量：run_state, 作為空壓機(jī)開啟的變量點(diǎn)，根據(jù)廠商提供的點(diǎn)位表設(shè)置好對(duì)應(yīng)的數(shù)據(jù)類型和寄存器地址。

5. 在后臺(tái)管理功能>>腳本管理中，創(chuàng)建一個(gè)腳本，執(zhí)行策略選擇周期執(zhí)行，執(zhí)行間隔60秒

6. 編寫如下腳本程序，通過腳本程序判斷空壓機(jī)是否開啟，開啟后記錄對(duì)應(yīng)時(shí)間，關(guān)閉則不記錄，最終實(shí)現(xiàn)記錄今日和累計(jì)運(yùn)行時(shí)長

 signalArray.forEach(function(signal){

//判斷空壓機(jī)是否開機(jī)

     if(signal.key=='run_state' && Number(signal.value)==1){

       signalArray.forEach(function(signal2){

       if(signal2.key == 'equip_run_todayl_time'){

          if(new Date().getHours()===0 && new Date().getMinutes()===0 && new Date().getSeconds()===0){

//每天0時(shí)，將今日設(shè)備運(yùn)行數(shù)據(jù)置為0

            API.writeSignalValue('equip_run_todayl_time','0')

          }else{

//空壓機(jī)開機(jī)狀態(tài)下，計(jì)算并將運(yùn)行時(shí)長寫入內(nèi)部變量

             API.writeSignalValue('equip_run_todayl_time',Number(signal2.value)+1)

          }

       }

       if(signal2.key == 'equip_run_total_time'){

           API.writeSignalValue('equip_run_total_time',Number(signal2.value)+1)

       }

     })

     }

   })

}

5.2 污水站定時(shí)開閘放水

場(chǎng)景描述：

污水處理站需要每周一10點(diǎn)定時(shí)執(zhí)行開關(guān)閘放水一個(gè)小時(shí) 。

解決方案：

污水站PLC接入EG20網(wǎng)關(guān)作為監(jiān)測(cè)模塊，同時(shí)配合EMCP物聯(lián)網(wǎng)云平臺(tái)進(jìn)行設(shè)備監(jiān)測(cè)

1. 云平臺(tái)創(chuàng)建對(duì)應(yīng)設(shè)備，作為污水站處理器控制設(shè)備

2. 登錄EMCP物聯(lián)網(wǎng)云平臺(tái)，創(chuàng)建污水站梳理控制設(shè)備，添加對(duì)應(yīng)的驅(qū)動(dòng)，和配置網(wǎng)關(guān)

3. 創(chuàng)建變量，pool_switch，作為污水站開閘控制的變量點(diǎn)

4. 在后臺(tái)管理功能>>腳本管理中，創(chuàng)建一個(gè)腳本，設(shè)置運(yùn)行環(huán)境為：條件執(zhí)行，表達(dá)式為：#{hour}==10 || #{hour}==11，執(zhí)行頻次為單次執(zhí)行

5. 編寫如下腳本程序，即可實(shí)現(xiàn)開關(guān)閘（pool_switch）每周一10點(diǎn)定時(shí)開啟進(jìn)行放水，11點(diǎn)關(guān)閉

具體代碼示例如下：

function main(signalArray){

 if(new Date().getDay()==1){

if(new Date().getHours()==10){

//滿足條件后，向pool_switch 變量寫入數(shù)值1，執(zhí)行開閘操作

     API.writeSignalValue("pool_switch","1")

}else if(new Date().getHours()==11){

 //不滿足條件，向pool_switch 變量寫入數(shù)值1，執(zhí)行關(guān)閘操作

     API.writeSignalValue("pool_switch","0")

   }

 }

5.3 一鍵關(guān)閉多個(gè)卷簾門

場(chǎng)景描述：

農(nóng)業(yè)大棚控制卷簾門比較多，需要組態(tài)頁面中逐一手動(dòng)開啟卷簾門開關(guān)，操作比較繁瑣，客戶需要點(diǎn)擊組態(tài)中一個(gè)控件，對(duì)5個(gè)卷簾門同時(shí)進(jìn)行開啟或關(guān)閉操作

解決方案：

1. 組態(tài)編輯中，放入一個(gè)按鈕控件，一個(gè)輸入框控件，按鈕用于執(zhí)行寫入數(shù)值操作，輸入框用決定寫入數(shù)值，輸入1，點(diǎn)擊按鈕可以進(jìn)行閘門開啟，輸入0，點(diǎn)擊按鈕可進(jìn)行閘門關(guān)閉

2. 定義好5個(gè)變量，分辨代表卷簾門的控制變量，舉例：可設(shè)置變量名稱為：['變量1','變量2','變量3','變量4','變量5']，每個(gè)變量代表一個(gè)閘門。

3. 點(diǎn)擊按鈕控件，勾選單擊時(shí)間，選擇腳本選項(xiàng)，進(jìn)行編寫腳本代碼，邏輯是點(diǎn)擊按鈕執(zhí)行輸入框的值，并向?qū)?yīng)變量進(jìn)行寫入數(shù)值操作

具體腳本代碼如下

function click(API){

//通過控件ID獲取到輸入控件的值

 const value = API.getWidgetById(741).value

 const arr = ['變量1','變量2','變量3','變量4','變量5']

 arr.forEach((name, index) => {

setTimeout(() => {

//執(zhí)行寫值操作

     API.writeValueByName(name,value).then(resp => {

       console.log(name + '寫入變量成功!')

     }).catch(err => {

       console.log(name + '寫入變量失敗!')

     })

   },100*index)

 })

}

六、常見問題

問題1：

腳本功能收費(fèi)嗎？

解答：

腳本功能是免費(fèi)的，已開放給全部客戶

問題2：

腳本功能入口在哪里？

解答：

網(wǎng)關(guān)腳本功能入口位于：后臺(tái)管理>>設(shè)備管理>>新增/編輯設(shè)備>>腳本管理，您可以創(chuàng)建和編輯腳本

頁面腳本功能入口位于：后臺(tái)管理>>設(shè)備管理>>新增/編輯設(shè)備>>組態(tài)頁面管理>>右上角設(shè)置>>頁面管理功能，可編寫頁面腳本代碼

問題3：

為什么提示我暫不支持腳本功能

解答：

1.您的賬戶必須開啟腳本編輯權(quán)限，如果未開啟，則無法使用

2.您的網(wǎng)關(guān)必須滿足以下兩個(gè)條件，才可以創(chuàng)建腳本功能

1）目前僅EG20型號(hào)網(wǎng)關(guān)支持腳本功能，其他網(wǎng)關(guān)后期會(huì)陸續(xù)支持

2）網(wǎng)關(guān)固件版本必須大于3.0及以上

如果以上條件有任意一個(gè)不滿足，則在腳本管理功能中會(huì)提示暫不支持，您可以可咨詢您的商務(wù)人員了解詳情

問題4：

數(shù)據(jù)中心是否可使用腳本

解答：

數(shù)據(jù)中心可使用腳本功能，可在數(shù)據(jù)中心組態(tài)頁面中編輯頁面腳本。

問題5：

網(wǎng)關(guān)斷電/離線后腳本還能運(yùn)行嗎？

解答：

如果網(wǎng)關(guān)離線，則腳本可運(yùn)行，如果網(wǎng)關(guān)斷電，則腳本不可運(yùn)行

問題6：

關(guān)閉組態(tài)頁面后，頁面腳本還能運(yùn)行嗎？

解答：

關(guān)閉組態(tài)頁面后，頁面腳本不可運(yùn)行

問題7：

我有腳本需求，但是自己不會(huì)寫腳本怎么辦？

解答

如果您有相關(guān)腳本方面的應(yīng)用需求，歡迎聯(lián)系藍(lán)蜂物聯(lián)網(wǎng)商務(wù)人員進(jìn)行溝通洽談，我們將積極與您對(duì)接，竭誠為您解決問題。