驅動視圖

整體展示結構為：驅動-連接-設備-點位。

左側為驅動-連接列表，驅動即數采協議包，如下圖所示，左側驅動列表包括bacnet、device_simulator、iec61850、modbus，驅動下可以通過導入點表添加多條連接，如下圖所示modbus驅動下有CON57、CON58等連接。

左側窗口選中驅動，可以查看各條連接狀態、連接/斷連時間，數采點個數、屬性點個數和進度，點擊詳情，可以查看連接配置。

數采點，指從PLC或DCS中直接采集到的原始變量，原始變量經過bit拆分、json提取得到屬性點。如一個DWORD數采點拆分得到多個屬性點。 進度條，驅動、連接、設備都有各自維度的屬性點進度統計。

進度=100%，代表從連接建立開始，下面所有的屬性點都正常上報過。

進度<100%，代表截止目前有屬性點未上報過，需要排查連接配置、設備配置、數采地址配置、加工公式配置是否正確。 左側窗口選中驅動下的某條連接，可以在右側窗口看到該連接下的設備列表、各設備接入進度，點擊詳情可以查看設備配置。雙擊某一行或點擊查看屬性點可以進入設備下的屬性點列表。

屬性點列表，可以看到某個設備下各屬性點實時值、質量碼、時間戳，其中質量碼0代表正常，0xC0（192）代表連接已斷開（此時展示的實時值為系統緩存值），有寫權限的屬性點位會有寫入按鈕。 屬性點有3個狀態，如下

雙擊某一行或點擊查看詳情可以進入屬性點詳情頁面。

屬性點詳情，基礎信息包括驅動-連接-設備-數采點-公式轉換-屬性點狀態，便于異常問題定位。

數采點，指從PLC或DCS中直接采集到的原始變量，原始變量經過bit拆分、json提取得到屬性點。如一個DWORD數采點拆分得到多個屬性點。數采點和屬性點都有唯一的標識符ID。

歷史數據，支持表格、圖表2種展示方式。表格方式更準確，圖表方式適合看趨勢。圖表展示時，會根據時間范圍做間隔采樣，即降采樣，采樣方法為在固定的時間間隔內抽取數據，有數據則展示，無數據不展示（未采取平均值、最大值、最小值等補值手段）。

設備視圖

支持按連接編碼、模板名稱或編碼、設備名稱或編碼、設備數采狀態、屬性名稱或編碼組合搜索，模糊搜索。其中模板名稱或編碼、設備名稱或編碼是必選，其他可選。

模板管理

相同的設備配置可以復用一套模板，參考下文的模板表excel說明。 模板搜索：支持按模板名稱、模板編碼搜索，模糊搜索。更新時間：模板表有修改，重新導入后，更新時間會變化。更新時間支持時間排序。

單個模板有2種視圖，屬性視圖和采集視圖。屬性視圖中屬性按照屬性組名稱歸類。

下圖為OPC UA協議的采集視圖（通過OPC UA掃描導入）。

excel點表介紹

以一個例子來展開說明3張表的差異，假設工廠中通過PLC接入了 10個電機、1個機械臂，且10個電機在PLC協議地址空間中是對稱的，則可以創建1張電機模板表，1張電機設備表，1張機械臂設備表，1張機械臂設備點位表。如果PLC連接協議一樣，變頻器設備表和機械臂設備表也可以合2為1。

模板表詳細說明

電機的模板表（技術屬性模板表）如下（以OPC DA協議為例）：

藍色列代表IT信息（屬性編碼、屬性名稱、存儲類型、單位、取值范圍等），*代表必選，其他字段選填。

綠色列代表OT信息（數采地址、數采加工公式）。 灰色列代表分隔符，沒有實際意義。

提示：模板表的綠色列字段跟具體的協議強相關，如OPC DA的綠色列有ItemID、ValueType、IsWritable列，MODBUS的綠色列有寄存器偏移地址，OPC UA的綠色列有nodeid偏移地址等等。

整個表格傳遞的信息是IT屬性 = 數據轉換公式Expression + OT點。

表頭包含如下信息

提示：模板表支持添加多張excel sheet頁，每張sheet頁代表一張新的模板。

每列字段含義如下

設備表詳細說明

設備配置表，包含10臺電機的鏈接信息，樣例如下

藍色列代表IT信息，如設備名稱、模板編碼。

綠色列代表OT信息，如數采連接地址、數采采樣頻率等，具體請參考對應的協議接入說明。 灰色列作為分隔符列，沒有實際含義。 資產模板編碼列代表設備引用了哪個模板，可以為空，為空代表設備的點位配置由點位表記錄。

設備配置表可以添加多個設備，多個PLC，多套DCS的連接。

點位表詳細說明

點位表主要用于散點設備的接入，散點設備指設備點位地址無規律、無法使用模板表，此時可以使用設備表 + 點位表完成數采實施。點位表和模板表的差異點，在于OT地址列是完整的。

前面的例子中，點位表的樣例如下：

MODBUS點位接入流程

該章節包含以下內容

模板表配置說明

表格下載：控制臺->采集->模板管理->導入模板->驅動名稱選中"modbus"->點擊下載。

綠色列代表驅動配置：

驅動程序采用MODBUS尋址，功能碼+寄存器地址（0~65535），其他尋址模式需要進行轉化。

指從設備中讀取的數據格式，同時驅動程序通過相應的數據類型來告知讀取一個、兩個、四個或八個寄存器或者可能的布爾值；

1）BOOL（布爾型）

2）INT16（16位有符號整型）

3）UINT16（16位無符號整型）

4）INT32（32位有符號整型）

5）UINT32（32位無符號整型）

6）INT64（64位有符號整型）

7）UINT64（64位無符號整型）

8）DOUBLE（雙精度浮點型）

9）FLOAT（單精度浮點型）

1）0x01（讀線圈寄存器）

2）0x02（讀離散輸入寄存器）

3）0x03（讀保持寄存器）

4）0x04（讀輸入寄存器）

1）0x05（寫單個線圈寄存器）

2）0x06（寫單個保持寄存器）

3）0x0F（寫多個線圈寄存器）

4）0x10（寫多個保持寄存器）

是否允許驅動程序將其和與其相鄰的點位進行合并讀取。

是否交換保持/輸入寄存器內的字節順序。

是否交換多個保持/輸入寄存器之間的順序。

縮放原始數據，目前支持“線性”縮放.

設備表配置說明

綠色列代表跟數采相關的配置。 連接配置：

MODBUS-TCP通訊的服務器的以太網IP地址。

MODBUS-TCP通訊默認端口為502。

設備配置：

設備在MODBUS-TCP通訊的服務器上的從站地址。

點位讀取周期，單位ms。

點位讀取超時，單位ms。

同模板表。

操作路徑：模板管理->導入模板->選擇對應的數采驅動->上傳文件。

提示：

操作路徑：點表配置->驅動視圖->選擇對應驅動->導入點表->設備表->上傳文件。

提示：

點擊部署，讓以上點表配置生效，該過程需要幾分鐘。

提示：啟用主備配置后，會多一個主備部署的按鈕，主備部署可以讓點表配置、告警配置等工程配置信息同步一份到另一臺主機。建議定期做主備配置同步，以免兩臺機器配置不一致，造成使用上的混亂。

常見問題FAQ

OPC DA點位接入流程

OPC DA常用于散點設備的接入，散點設備的接入使用設備表 + 點位表。

1）模板表配置說明

2）設備表配置說明

3）點位表配置說明

4）導入模板表

操作路徑：數采 -> 模板管理 -> 導入模板 -> 選擇opcda驅動 ->上傳文件。

5）導入設備表

操作路徑：數采 -> 點表配置 -> 驅動視圖 -> 選擇opcda驅動 -> 導入點表 -> 設備配置表 ->上傳文件。

6）資源部署

點擊部署，讓以上點表配置生效，該過程需要幾分鐘。

三色燈異常診斷

連接狀態

連接狀態包含連接、異常。

屬性點三色燈

針對異常的點位，數采一體機提供診斷功能，用來快速排查問題。

各階段異常的原因：

狀態燈是根據點位上報情況推導出來的，不強依賴驅動上報的連接狀態、設備狀態虛擬點位。

Q. 和驅動上報的虛擬點位之間的關系？

連接成功、設備上線的虛擬點位上報不會影響狀態燈。

連接斷開的虛擬點位上報，會重置該連接及其下的設備、點位的狀態，變紅。

設備下線的虛擬點位上報，會重置該設備及其下的點位的狀態，變紅。

Q. 和部署之間的關系？

部署會重連修改過的連接，會重置該連接及其下的設備、點位的狀態，導致相關狀態都變紅。

Q. 和點位質量碼之間的關系？

點位質量碼為零，認為該點位正常，顯示綠色。

點位質量碼為非零，認為該點位異常，顯示紅色。

告警模板

典型場景：大量I/O數字量需要批量配置告警信息

操作路徑：告警模板 -> 新建模板 -> 填寫模板信息 -> 在excel模板表或點位表填寫告警模板編碼

步驟一：創建告警模板

步驟二：操作路徑1：采集->模板管理->選擇對應的模板->查看->屬性視圖->選擇屬性->編輯->選擇告警模板->保存，然后部署。

操作路徑2：在excel點表（模板表或點位表）中填充告警模板編碼，并在控制臺重新導入excel模板表，然后部署。

步驟3：資源部署 -> 本機部署

步驟4：查看告警事件

未解除：指進行中的告警（告警條件被觸發，且當前仍滿足觸發條件）已解除：指已消除的告警（告警條件曾被觸發，當前觸發條件不滿足）

告警確認：運維人員通過手動確認告警，來保障整個自動化系統的正常運行。 告警搜索：支持通過時間窗口、設備資產編碼來搜索過濾告警。

常見問題

Q. 新建或修改告警模板后是否需要部署？

不需要部署，保存即生效。

Q. 如何配置或恢復兩臺機器之間的告警數據同步？

一、清理原有數據庫
1、docker stop postgres12
2、docker rm postgres12
3、rm -rf /datafactory_data/postgres 

二、下載新的pg安裝文件：
wget http://xxx/postgres12_install_file.tar.gz

三、重新走一遍雙機postgres的安裝流程
sudo mkdir -p /datafactory_data/postgres/
sudo ./install_PG.sh /datafactory_data/postgres/
sudo ./config_PG_step1.sh
# 在LE1上執行
sudo ./config_PG_step2.sh ${LE2_IP} 5432
# 在LE2上執行
sudo ./config_PG_step2.sh ${LE1_IP} 5432

阿里云IoT

一體機內部和阿里云IoT平臺有2條通道，一條為管控通道，一條為數據通道。

管控通道：對應一個管控通道三元組，管控通道用于云端下發各種參數配置。 數據通道：對應N個數據通道三元組，數據通道用于一體機上報數據。由于上云數據通常較大，物聯網平臺單條連接流量上限約1MB/s，可以在一體機上配置起N條鏈接，N條鏈接對應N個三元組。配置方法見后續說明。數據通道對應物聯網平臺的虛擬網方案（子設備數據可以選擇任意一條通道上云），同時配合物聯網連接型實例，一體機做了數據聚合、壓縮優化。因此配置時重點關注以下幾點

配置步驟如下

控制通道配置

在物模型映射，查看數字工廠對應的物聯網平臺LP（Link Platform）對應的接入地址。

提示： 1. 域名后面需要拼接端口，端口固定為1883。如：iot-xxxxoktpaa.mqtt.iothub.aliyuncs.com:1883。 2. 物聯網平臺需要區分連接型實例和普通實例！兩者在一體機中的配置不同，前者需要開啟數據壓縮選項，支持更大并發，后者不支持壓縮。

對接物聯網平臺：使能開關，在開關打開后數采一體機開始嘗試和阿里云物聯網平臺進行連接。

ProductKey：產品名稱，在阿里云物聯網平臺上進行產品創建時生成。

DeviceName：設備名稱，在阿里云物聯網平臺上進行設備創建時生成。

deviceSecret：設備密鑰，阿里云物聯網平臺上進行設備創建時生成。

物聯網平臺接入地址：阿里云物聯網平臺接入地址，對應實例的連接地址。

設備過濾規則：對應上元數據轉發的OT數據的過濾規則，參考下文中的過濾規則集說明。

數據通道配置

操作路徑：登錄物聯網平臺，選擇對應的企業實例，任意一個創建產品和設備，保存設備三元組。

和控制通道不同，阿里云Iot數據通道配置通過現場施工時進行后臺修改配置文件完成，對應配置文件路徑如下：

vim /linkedge/gateway/build/config/data_cloudproxy/data_proxy_client.json

配置文件中包含數據上云的N個三元組信息，需要上云的數據流量事先進行規劃。

下文以3對三元組為例，進行配置說明。

{
  "identityInform":[
  {
    "ProductKey": "g4kneyYU5SY",
    "DeviceName": "IndustryDeviceAsset230_111",
    "DeviceSecret": "xxxxxx"
  },
  {
    "ProductKey": "g4kneyYU5SY",
    "DeviceName": "IndustryDeviceAsset230_222",
    "DeviceSecret": "xxxxxxx"
  },
  {
    "ProductKey": "g4kneyYU5SY",
    "DeviceName": "IndustryDeviceAsset230_333",
    "DeviceSecret": "xxxxxxxxx"
  }]
}

消息隊列kafka

作為南向接入設備，數采一體機在支持采集的設備數據上行轉發到公有云場景的同時，也存在支持將采集的設備數據轉發到三方數據中臺的場景。消息隊列kafka功能提供了的數采一體連接三方數據中臺kafka_server的相關配置能力，當進行對應連接信息的錄入后，數采一體機能夠實現和三方數據中臺kafka_server的遠程連接和南向工業數據采集后的轉發能力。

工作原理

數采一體機連接三方數據中臺kafka_server進行上行數據轉發的工作原理類似于kafka的標準生產者（producer）的流程，主要包括：

數采一體機作為kafka_client和指定的kafka_server建立連接，對應kafka_server的連接信息來自界面配置，主要包括：broker連接地址、sasl鑒權信息（用戶名/密碼）、cert證書（安全連接）等。

數據一體機作為數據的生產者（producer）向kafka_broker的指定topic轉發數據，當前主要支持設備數據和告警數據的數據轉發，需要在界面指定broker映射的不同topic。

配置說明

對于消息隊列kafka的轉發配置，在數采一體機上提供了可視化界面，對應側邊欄：數據轉發--->kafka轉發。

kafka轉發的配置信息默認只讀，需要點擊“編輯”按鈕進行編輯操作。

是否開啟：kafka轉發的使能開關，在開關打開后數采一體機開始嘗試和三方數據中臺的kafka_broker進行連接。

broker地址：三方數據中臺的broker地址，支持通過“;”符號連接多個，地址組成包括：ip地址（域名） + port端口號。

設備數據Topic：三方數據中臺作為kafka_broker提供的設備上報屬性數據的topic，需要在kafka_broker側進行規劃和配置。

告警數據Topic：三方數據中臺作為kafka_broker提供的上報告警數據的topic，需要在kafka_broker側進行規劃和配置。

啟用SASL鑒權：連接kafka_broker鑒權開關，在kafka_broker連接需要開啟時打開。

SASL鑒權信息：對應kafka_broker連接時輸入正確的鑒權信息，包括用戶名/密碼。

kafka證書：對應kafka_broker需要證書認證時進行上傳，默認支持一個證書，后面上傳會覆蓋前面上傳的證書。

設備過濾規則：對應kafka轉發的OT數據的過濾規則，參考下文中的過濾規則集說明。

常見問題

Q. kafka_broker多個地址的錄入

本地控制臺支持多個kafka_broker地址的輸入，在kafka_broker在集群模式下需要多地址錄入的場景下，可以在本地控制臺上通過“;”進行不同地址間的隔離。

過濾規則集

考慮作為生產制造過程中產生的OT數據并非都是北向設備需要的，因此需要在數采一體機設備數據上云轉發前實現報文按照一定維度的過濾，以此提升帶寬利用率。數據一體機當前提供了按照設備維度的上報屬性數據的過濾能力，并支持為重復數據設置過濾時間窗，以滿足提高上行數據有效性的訴求。

工作原理

數采一體機的過濾規則主要支持三種類型：

數據一體機的過濾規則集支持創建多個，用戶可以根據需求創建多條不同類型和指定多個設備的過濾規則。但過濾規則的生效需要通過和對應的上云連接進行綁定，為了防止規則間的沖突，一個上云連接只支持綁定一條規則，當前支持的綁定模式包括mqtt（阿里云物聯網平臺）和kafka（三方數據中臺）。

過濾規則除了支持按照設備維度進行屬性過濾外，還支持設備屬性在時間維度上的時間窗過濾，通過時間窗設置：對于在周期時間內（從收到報文開始進行技術）屬性值相同的設備屬性上報認為是重復數據，在上報前進行過濾處理。

配置說明

對于過濾規則集的添加、編輯和刪除，數采一體機提供了可視化界面，對應側邊欄：數據轉發--->過濾規則集

通過過濾規則集界面上“新建規則”按鈕創建規則，輸入規則編碼、規則類型、去重間隔（去重時間窗）、選中設備等信息創建過濾規則。其中規則類型分為三種，全量同步規則不需要選設備。

在規則創建后，可以通過過濾規則集界面中選中規則進行編輯和刪除操作，控制臺還提供了批量刪除功能方便刪除的批量操作。

在規則創建后，通過在上云鏈路對應界面中進行綁定生效。當前支持mqtt（阿里云物聯網平臺）和kafka（三方數據中臺）兩種上云方式，分別對應數據轉發菜單中“阿里云IoT”和“kafka轉發”配置中的“設備過濾規則”的選項配置。

常見問題

Q. 配置過濾規則集并綁定到kafka轉發后，告警轉發沒有進行過濾生效

過濾規則當前只對設備屬性數據進行過濾，對告警數據不進行過濾，過濾規則對于告警的轉發無效。

Q. 修改綁定到kafka轉發或者阿里云IoT的過濾規則，發現存在設置的時間窗內相同屬性值的設備屬性重復上報

過濾規則支持熱加載，在用戶修改已綁定到上元轉發的規則立即生效。但在規則生效后對已有設備屬性的時間窗信息會重新加載，已有時間窗內的數據會被重置。

Q. 界面配置了多條過濾規則（白名單）方式，但無法進行多個規則綁定到同一條轉發鏈路

數據轉發設置多條過濾規則意味著計算的冗余和性能的下降，當前轉發鏈路只支持綁定一條設備過濾規則，需要將相同維度過濾放到一條過濾規則中。

主備配置

工作原理

資產一體機使用VRRP協議來實現兩臺主機之間的狀態同步、主機選舉；備機上的數采驅動、規則告警、數據轉發服務處于熱備狀態。

配置說明

是否開啟：控制是否啟用主備功能。

本機地址：填寫本機的局域網IP地址，和對端主機處于同一網絡。

對端地址：規則同“本機地址”，填寫互為主備的另一臺網關/服務器。

配置密鑰：同控制臺的賬戶/密碼，用于訪問主/備機服務的。

主備調試：調試開關，關閉后意味著本機禁止參與主備搶占，此時對端會進入主機狀態（mater）。

狀態：當前主備工作狀態，一共4個狀態：主機、備機、異常、禁用。

主備策略：支持兩種策略。

提示：“XX 優先”模式下，XX發生異常會切換為備機（backup），異常消失后會再切換為主機（master）。

浮動虛擬IP：主備服務器器統一對外提供服務的IP，該IP會跟隨著主機；配置主備功能后，建議后續使用該IP來訪問控制臺，以及MQTT和HTTP openAPI。

常見問題

Q. 兩節點同時為“主機”

查看防火墻

sudo systemctl status firewalld.service