1.  交採APP基本原理

通過SPI匯流排週期性的召測交流採集底板的“實時資料”，對“實時資料”變換、加工、統計分析得到“分析資料”和“統計資料”後，通過MQTT匯流排把這些資料同步到“資料中心”供其他APP使用，其他APP可從“資料中心”獲取資料使用。預設的執行引數、過載過壓定值等(104APP管理))從配置檔案獲得、啟動後再從“資料中心”獲取，如果“資料中心”裡沒有，就用預設的，“資料中心“裡的配置項更新後，APP能及時感知到。

2.  功能介紹

對其他APP呈現的功能有：

1、註冊裝置模型“ADC”到“資料中心”，每秒傳送“實時資料”、“分析資料”到資料中心。

裝置模型為ADC,裝置例項標識為{

               "model":"ADC",

               "port":"1",

               "addr":"1",

               "desc":"jiao liu cai ji"

          }

2、可校正誤差。校正流程見後面章節。

3、可升級交採板的程式。升級方法見後面章節。

 

“實時資料”是指實時的電壓、電流等，包含條目及格式見配置檔案jc_apcfg.json的“JC_MODEL”條目體的前部分。具體資料專案有：

頻率、

3相電壓、零序電壓、

3相電流、中線電流、零序電流、

3相有功功率、總有功率、3相無功功率、總無功功率、

3相功率因數、總功率因數、

3相電壓相角、3相電流相角、

3相電壓畸變率、3相電流畸變率、

電壓不平衡度、電流不平衡度、

負載率、

2到19次電壓諧波、2到19次電流諧波、

4路開入量狀態。

“分析資料”是指電壓越限、過載事件等，包含條目及格式見配置檔案的“JC_MODEL”條目體的後部分。具體資料專案有：

3相電壓日合格率、

3相電壓日越上限時間、3相電壓日越下限時間、

3相電壓月合格率、3相電壓月越上限時間、3相電壓月越下限時間、

3相平均電壓、

總失壓事件、

總斷相事件、

電壓不平衡越限事件、電流不平衡越限事件、

上電事件、停電事件、

過載事件、過載事件、

3相過壓事件、3相欠壓事件

“統計資料”是指電壓合格率、日極值檔案等，每天生成一個檔案，儲存路徑及檔案格式見江蘇省《配變終端招標規範》。具體有如下檔案：

序號	功能	路徑	檔名
1	電壓日合格率	HISTORY/VOLT_DAY	voltYYYYMMDD.msg
2	電壓日越限		volttYYYYMMDD.msg
3	電壓月合格率	HISTORY/VOLT_MON	voltYYYYMM.msg
4	電壓月越限		volttYYYYMM.msg
5	日過載	HISTORY/OL	hlYYYYMMDD.msg
6	日過載	HISTORY/OL	olYYYYMMDD.msg
7	日凍結	HISTORY/FRZ	frzYYYYMMDD.msg
8	定點	HISTORY/FIXPT	fixptYYYYMMDD.msg
9	極值	HISTORY/EXV	exvYYYYMMDD.msg

“電能量資料”有：

    3相組合有功電能量；

    3相組合無功電能量；

    3相組合視在電能量等

3.  配置檔案說明

配置檔案jc_appcfg.json,位於交採APP執行檔案目錄下。

序號	配置項	說明
1	MQTT_BROKER	MQTT代理ip地址
2	IMP_SAVE_PERIOD	電能量檔案的儲存時間間隔，單位分鐘
3	SPIDEV_JC	和交採底板通訊的SPI裝置資訊，有路徑、波特率、模式、字位數
4	PATH_COEFF_7022	校表係數儲存路徑
5	PATH_DIANLIANG1	電能量檔案儲存路徑
6	PATH_DIANLIANG2	電能量檔案儲存路徑
7	DI_SCAN_TIME	開入量防抖動時間
8	RONG_LIANG	變壓器容量預設值
9	PT_1CI	PT1次預設值
10	PT_2CI	PT2次預設值
11	CT_1CI	CT1次預設值
12	CT_2CI	CT2次預設值
13	JC_MODEL	資料中心的ADC資料模型
14	JC_MODEL/ topicPub	模型釋出主題
15	JC_MODEL/topicSub	訂閱模型釋出結果
16	JC_REGISTER	資料中心的設備註冊
17	JC_REGISTER/topicPub	設備註冊主題
18	JC_REGISTER/topicSub	訂閱設備註冊結果
19	JC_ADCGUID	資料中的裝置GUID
20	JC_ADCGUID/ topicPub	獲取GUID
21	JC_ADCGUID/ topicSub	訂閱GUID結果
22	JC_NOTIFY	資料中心的資料更新主題
23	JC_SOE	資料中心的開入量變位上報主題

 

4.  安裝

用智芯公司開發的APP打包工具appSignTool來安裝，使用方法參考《APP打包工具使用說明.doc》，具體過程如下：

第1步，建立APP安裝包，既*.tar包

把appSignTool下載到目標板某目錄裡，保證有合適的許可權，把APP執行檔案SCBASEADC8.1.10、配置檔案jc_appcfg.json、庫檔案放在目標板某一目錄/home/sgitg/jc。執行打包命令：./appSignTool -f /home/sgitg/jc -b SCBASEADC8.1.10 -v v8.1.10 -o SCBASEADC，生成了SCBASEADC.tar

第2步，安裝*.tar包

執行如下命令：container install appjc SCBASEADC.tar -disk 100m -dev /dev/spidev2.0:/dev/spidev2.0 -v /data/app:/data/app。此命令映射了SPI裝置、APP的工作目錄。

可通過容器工具集檢視安裝是否成功、以及APP執行狀態。

交採APP執行檔名稱類似SCBASEADCx.x.x，配置檔名稱為jc_appcfg.json。

5.  交採APP工作目錄

交採APP使用了幾個目錄：

    配置檔案目錄：/data/app/SCBASEADC/configFile/,如果沒有此目錄，交採APP會主動建立，如果此目錄下沒有配置檔案，就拷貝tar包裡的jc_appcfg.json到此，如果有，就使用其。

    日誌檔案目錄：/data/app/SCBASEADC/logFile/,暫時沒用

    常用檔案目錄：/data/app/SCBASEADC/commFile/,含有電能量檔案、校表文件等。

 

6.  使用注意事項

mqtt匯流排、datacenter 已經正常執行；保正只有一個交採APP在執行；依賴庫應正確安裝；配置檔案jc_appcfg.json放在執行檔案目錄下。

過載定值、失壓定值在資料中心裡定義。由104APP來初始化和更新。

 

7.  檢視APP日誌

APP的日誌是用printf打印出的，如果APP是用container工具集安裝的，那麼日誌檢視及提取方法可用container工具來實現。

8.  除錯

./SCBASEADC -pr 可列印實時資料；

./SCBASEADC -ph 可列印諧波資料；

可通過MQTT工具訂閱交採APP傳送到MQTT總線上的資料，broker地址是終端的IP地址、埠是1883。主題是appjc/notify/event/database/ADC/#

9.  配置SPI裝置路徑

修過配置檔案jc_appcfg.json裡的條目SPIDEV_JC/ PATH即可。

 

10. 如何升級交採板程式

在終端裡、容器外，執行如下./SCBASEADC -pF jc7_2.hex，見到提示資訊“jc update1 success”表示升級成功，大致用時6秒左右。其中hex檔案是交採板的程式，升級後不影響校表引數。

注意先停止容器裡的交採APP，以便保證SPI裝置不被佔用。

 

11. 如何電能量清零

1、      電能量檔案的儲存路徑

電能量檔案的儲存路徑在配置檔案jc_appcfg.json裡指定，有兩個檔案，名稱是jc_engAcc1.json和jc_engAcc2.json,如下所示；

 

預設在/data/app/SCBASEADC/commFile路徑下，或者在配置檔案裡指定的路徑下。

2、      清除電能量檔案

假設電能量檔案儲存在預設路徑下，使用如下步驟：

第1步，停止終端的輸入電流

第2步，停止交採APP，比如用命令

container stop c_base

第3步，進入A電能量檔案所在目錄，比如用命令

cd /data/app/SCBASEADC/commFile;ls

刪除名稱為是jc_engAcc1.json和jc_engAcc2.json的檔案即可。

 注意實際情況中，容器名和APP名稱可能和上述不同。

第4步，重新啟動交採APP，再用104主站召測電能量

12. 如何校準

本APP有校準“交流採集板”精度的功能，通過APP的啟動引數來實現，過程如下。

7.1 準備

準備工作有：

連線標準源到終端，,設定標準源的3相電壓輸出為220V；

登入Xshell，用SSH方式連線到終端的FE0口（使用者名稱、密碼、埠號和終端系統版本相關），提升操作終端的Linux許可權為root使用者許可權（sudo -s）；

拷貝校表執行檔案SCBASEADC和配置檔案jc_appcfg.json到終端的/home/sysadm下，修改SCBASEADC的執行許可權；

停止交流採集APP（container stop c_base）；或者使用命令docker stop $(docker ps -qa)來停止所有的容器，以保證只有一個交採APP程序在執行。

清除交採APP的工作目錄（rm -rf /data/app/SCBASEADC）。

按順序開始如下校正步驟，不可顛倒。

校表執行檔案為 ，配置檔案為 ，可從此拷貝出。

7.2 校正點1

 1、把標準源輸出設定為電壓220V，電流5A，功率因數1.0

 2、等源穩定後，輸入：./SCBASEADC -pm1 -V220 -I5 -F1.0

大致等待15秒後,APP會自動退出，如果列印資訊裡有“jc caliberate ok”，即表示此步驟成功；否則不成功,應檢查終端硬體。

 

3、再用命令列輸入：./SCBASEADC  -pr

 

收到電壓、電流值後用ctrl+c退出，

VA表示A相電壓值，IA表示A相電流值，FA表示A相的功率因數值，PA表示A相的有功功率值，QA表示A相的無功功率值，

此步驟應使3相電壓值和電流值的誤差小於2/1000.否則應檢查接線或者終端硬體。

電壓誤差計算公式為(VA-220)/220.0

電流誤差計算公式為(IA-5)/5.0

7.3 校正點2

1、把標準源設定為電壓220V，電流5A， 功率因數為0.5L

2、等源穩定後，輸入命令列：./SCBASEADC -pm2 -V220 -I5 -F0.5

交採APP的列印資訊類似上述。

3、再用命令列輸入：./SCBASEADC  -pr

交採APP的列印資訊和上述類似，收到電壓、電流值後用ctrl+c退出，計算功率因數誤差值，公式為(FA-0.5)/0.5，此步驟應使3相功率因數誤差值小於3/1000.

7.4 校正點3

1、把標準源設定為220V 0.25A 0.5L (電流檔換到1A)

2、等源穩定後，輸入命令列：./SCBASEADC -pm4 -V220 -I0.25 F0.5

APP的列印資訊類似上述。注意是-pm4,開發歷史導致的。

3、再用命令列輸入：./SCBASEADC  -pr

交採APP的列印資訊和上述類似，收到電壓、電流值後用ctrl+c退出，計算功率因數誤差值，公式為(FA-0.5)/0.5，此步驟應使3相功率因數誤差值小於3/1000.

7.5 匯出校表文件

校表文件儲存在執行檔案路徑下，可匯出用來備份溯源，名稱為jc_7022.json；校表文件在底板的EEPROM裡也有一份，掉電不會丟失。當主控板的交採APP執行檔案目錄下有jc_7022.json時，就啟用他，沒有的話，就用底板EEPROM裡的。

 

13. 輔助工具

Linux除錯終端軟體Xshell，

104通訊協議除錯主站軟體KW2000，

MQTT匯流排監測工具MQTTFX,MQTTBOX

14. 常見問題

序號	問題/現象	可能原因	解決辦法
1	資料異常	多個例項在轉著，容器異常，電壓電流輸入接線不牢靠，底板的互感器相關電路異常	保證只有一個交採APP在執行，或者容器反覆啟動
2	打不開SPI裝置，APP沒啟動	配置檔案的SPI路徑不對，使用者許可權不夠，無執行屬性,啟動容器時沒有對映SPI裝置	sudo -s
3	功率負值	電流線接反，太陽能發電	正常現象
4	104資料不更新	MQTT程序異常	檢視程序狀態
5	電壓電流值異常	沒校表	重新校表
6	安裝不上APP	系統版本不匹配，工具集不匹配，相關庫檔案不匹配，使用者許可權	升級到最新版本
7	校表不成功	電流線接反，相序不對	調整功率源接線
8	升級交採板程式不成功	連線線不良、交採板無程式、SPI裝置沒開啟	放置配置檔案

 釘釘技術交流群：

 

相關推薦