1.アプリの基本原則
ベースボードの「リアルタイムデータ」をSPIバスを介して定期的に収集および分析します。「リアルタイムデータ」を変換、処理、および統計分析して「分析データ」と「統計データ」を取得したら、MQTTバスを介してこれらのデータを「データ」に同期します。 「センター」は他のアプリが使用しており、他のアプリは「データセンター」からデータを取得できます。（デフォルトの動作パラメーター、過負荷および過電圧設定など（104APP管理））構成ファイルから取得し、起動後に「データセンター」から取得します。「データセンター」にない場合は、デフォルトの「データセンター」を使用します。構成アイテムが更新された後、APPはそれを時間内に検出できます。
2.機能紹介
他のアプリに提示される機能は次のとおりです。
1.デバイスモデル「ADC」を「データセンター」に登録し、「リアルタイムデータ」と「分析データ」を毎秒データセンターに送信します。
デバイスモデルはADCで、デバイスインスタンス識別子は{
"モデル"： "ADC"、
"ポート"： "1"、
"addr"： "1"、
"desc"： "jiao liu cai ji"
}
2.エラーを修正できます。校正プロセスについては、次の章を参照してください。
3.配信ボードの手順をアップグレードできます。アップグレード方法については、以下の章を参照してください。
「リアルタイムデータ」とは、エントリやフォーマットを含む、リアルタイムの電圧、電流などを指します。構成ファイルjc_apcfg.jsonの「JC_MODEL」エントリ本体の前部を参照してください。具体的なデータ項目は次のとおりです。
頻度、
三相電圧、ゼロシーケンス電圧、
三相電流、中性電流、零相電流、
三相有効電力、総有効電力、三相無効電力、総無効電力、
三相力率、総力率、
三相電圧位相角、三相電流位相角、
三相電圧ひずみ率、三相電流ひずみ率、
電圧不平衡、電流不平衡、
負荷係数、
2-19電圧の高調波、2-19電流の高調波、
4方向オープン入力ステータス。
「分析データ」とは、エントリーやフォーマットを含む、電圧オーバーラン、過負荷イベントなどを指します。構成ファイルの「JC_MODEL」エントリー本体の後ろの部分を参照してください。具体的なデータ項目は次のとおりです。
三相電圧の毎日の通過率、
三相電圧毎日上限時間、三相電圧毎日下限時間、
三相電圧月間通過率、三相電圧月間上限時間、三相電圧月間下限時間、
三相平均電圧、
総減圧イベント、
合計フェーズ障害イベント、
電圧不平衡交差制限イベント、電流不平衡交差制限イベント、
電源投入イベント、電源障害イベント、
過負荷イベント、重負荷イベント、
三相過電圧イベント、三相低電圧イベント
「統計データ」とは、電圧認定率や日々の極値ファイルなどを指します。ファイルは毎日生成されます。保存場所とファイル形式については、江蘇省配電用変圧器入札規則をご覧ください。具体的なドキュメントは次のとおりです。
| シリアル番号 |
機能 |
パス |
ファイル名 |
| 1 |
電圧通過率 |
HISTORY / VOLT_DAY |
voltYYYYMMDD.msg |
| 2 |
電圧の毎日の制限 |
volttYYYYMMDD.msg |
|
| ３ |
電圧月間通過率 |
HISTORY / VOLT_MON |
voltYYYYMM.msg |
| 4 |
電圧月限 |
volttYYYYMM.msg |
|
| 5 |
毎日のリロード |
歴史/ OL |
hlYYYYMMDD.msg |
| 6 |
毎日の過負荷 |
歴史/ OL |
olYYYYMMDD.msg |
| 7 |
毎日凍結 |
歴史/ FRZ |
frzYYYYMMDD.msg |
| 8 |
定点 |
歴史/修正 |
fixptYYYYMMDD.msg |
| 9 |
極端な価値 |
HISTORY / EXV |
exvYYYYMMDD.msg |
「電気エネルギーデータ」は次のとおりです。
三相結合アクティブ電気エネルギー;
三相結合無効電力量;
三相複合見かけの電気エネルギーなど
3.設定ファイルの説明
構成ファイルjc_appcfg.jsonは、アプリの実行ファイルディレクトリにあります。
| シリアル番号 |
構成アイテム |
解説 |
| 1 |
MQTT_BROKER |
MQTTプロキシIPアドレス |
| 2 |
IMP_SAVE_PERIOD |
電気エネルギーファイルの保存間隔（分単位） |
| ３ |
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.インストール
インストールには、Zhixinが開発したAPPパッケージツールのAPPSignToolを使用します使用方法については、「APPパッケージツールの使用説明書.doc」を参照してください。
最初のステップは、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パッケージをインストールする
次のコマンドを実行します。containerinstall 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设备没打开 |
放置配置文件 |
钉钉技术交流群：
