增加说明文档

doc/后台接入协议.docx

@@ -0,0 +1,45 @@
+                        数据分发后台接入协议
+                                    作者
+                                    日期
+                                    修改
+                                   郑瀚榉
+                                  2023-06-07
+                              订单数据上传
+                                   郑瀚榉
+                                  2023-06-14
+                              增加响应信息
+                                       
+订单数据上传后台
+通讯方式
+HTTP
+请求
+POST
+数据类型
+JSON
+客户端
+转化器
+服务端
+后台
+                                    例子
+                                      url
+http:ip:port/xxx
+订单数据
+{
+    "carryTime":"2023-02-17 15:59:29", //提枪时间
+    "hangTime":"2023-02-17 16:00:57", //挂枪时间
+    "amount":"324.50",//金额
+    "gunNo":"30", //油枪号
+    "quantity":"41.55",//升数
+    "balance":"2570.86",//卡余额
+    "oilsPrice":"7.81", //油品单价
+    "id":"2023021715553939700",//订单id
+    "oilGrade":"92#",//油品
+    "cardNo":"01000114400024875652" //卡号  
+}
+响应
+{
+    "code":0,  //0表示成功，其他值可自定义
+    "msg":"success",//值自定义
+    "data":"SUCCESS"   //值自定义
+}
+

doc/接入网络控制盒现场升级油机说明.docx

@@ -0,0 +1,24 @@
+接入网络控制盒升级油机配置和注意
+ 正常升级油机程序，待程序完成升级后进行两项的配置，一为网络接入开启，二为使能读卡数据传输开关。
+
+油机环境
+ 中石化后台+油机（如果是，就可以了）
+
+油机配置1（第三方网络配置）
+ 升级版本，待油机启动完成后，通过手持机进入设置，先进入4级菜单，锁定4.5.5菜单，可以看到如下图示：
+  
+
+  进入到选择THIRDPARTY,并且选择Enabled。
+ 如下图左侧点击OK进入配置IP，为油站上的网络控制盒IP
+   
+  继续配置2
+油机配置2（使能开关配置）
+ 升级版本后，待油机启动完成后，通过手持机进入设置，锁定4.16菜单，可以看到如图
+  
+  
+  同时进入Sinopec Setting 如图Fig2：
+  
+  
+  选择ENABLED，随后退出手持机，待保存和配置完成。(稍等配置完成)
+ 可以正常加油。
+ 确认数据是否上传。

doc/智慧加油站数据分发系统说明--1.0.1版本.docx

@@ -0,0 +1,84 @@
+                       智慧加油站数据分发系统
+前言：
+本中间件主要使用者是售后人员，后续有需要可以提供给客户使用，该中间件主要实现将油机的数据进行转换，然后上传到第三方平台，油站管理设计是一个油站有多台油机，一台油机有多把枪进行设计。
+注意：油站编号与油机ip地址必须是唯一！
+一、登录界面
+登录的账号：test     密码：hs666
+
+二、首页
+
+1、工控机ip地址修改
+步骤一：上传编写好的ip地址配置文件interfaces，如：
+
+详细内容请查看interfaces文件
+步骤二：点击按钮"重启工控机"
+完成上面两步骤即可修改工控机ip地址
+2、socket开启
+将上面设置的ip地址输入到下面ip地址的输入框中，填入的是跟油机ip同一个网段的ip地址
+输入之后点击按钮"开启"即可有油机连接上工控机进行数据交互。
+
+三、油站管理
+售后人员可以在油站管理中对油站进行增删改查
+1、添加油站
+添加油站的时候，编号的值必须是唯一的。
+
+
+
+
+
+
+
+
+
+
+
+2、编辑
+油站一旦建立则油站的，油站的编号就不可以再修改，如果填错了可以删除再重新新建油站。
+
+
+3、数据配置
+该页面配置数据上传的后台与组装数据格式。在油站管理的最右边有"数据"配置按钮，点击进入即可选择配置需要上传的数据 与上传后台的地址，数据标识由研发提供，出厂有默认值，一般情况数据头不需要修改，只要修改第三方上传的ip地址。
+注意：数据标识由研发提供，第三方后台地址由第三方提供。
+ 
+在每条数据新建之后都有一个"配置"按钮，可以在"配置"按钮中选择组装需要上传的数据，如果需要可以在数据前面通过勾选来选择。
+
+
+注意：这些数据都是可以在字典管理中配置数据，该数据一般在出厂前已经配置好，如果后续没有程序升级，一般不需要变动。
+
+四、油机配置
+油站的右边有油机的配置按钮，点击"油机"即可进入油机配置页面
+
+
+
+三、油机配置
+进入油机配置页面可以对油机进行增删改查。
+1、添加油机
+添加油机ip必须唯一，有几台油机就新增几台！
+
+
+
+
+
+
+
+
+
+
+2、油枪配置
+在油机配置页面有油枪配置按钮，点击即可进入油枪配置页面。
+
+五、油枪配置
+进入油枪配置可以对油枪进行增删改查，具体请看下面截图
+
+
+
+六、字典管理
+在字典配置页面中需要注意：默认字典编号不可以修改
+
+
+注意：在字典管理页面中配置数据标识，该下面红框中的类别编号是数据标识，该数据标识由研发另外提供文档说明。
+
+
+在每条数据后面都有字典项配置，点击进去可以对该数据进行配置，一般出厂前已经配置，"是否默认"即是否是默认提供给客户的数据，一般是"是"！
+
+

doc/生产使用文档说明.docx

@@ -0,0 +1,73 @@
+                  智慧油站数据分发系统部署说明
+步骤一：拷贝文件
+用U盘拷贝click.sh和sgs-master.zip文件到桌面
+
+
+
+
+
+
+
+
+
+
+步骤二：打开命令行终端
+双击桌面的LXTerminal即可打开
+
+
+
+
+
+
+
+
+
+
+
+注意：如果桌面没有LXTerminal命令行终端可以在桌面的最右下角中将其添加到桌面或打开
+
+
+
+
+
+
+
+
+
+
+
+
+
+步骤三：切换root用户（sudo su）
+命令：sudo su
+输入上面的命令回车即可
+
+
+
+
+
+
+
+
+
+
+
+
+
+步骤四：打开桌面文件夹（cd /home/linaro/Desktop）
+命令：cd /home/linaro/Desktop
+输入上面命令回车即可
+
+步骤五：授权click.sh文件（chmod 777 click.sh）
+命令：chmod 777 click.sh
+输入上面指令回车即可
+
+步骤六：执行click.sh文件（./click.sh）
+命令：./click.sh
+执行上面的命令回车即可，上面是点斜杠
+注意：执行上面的斜杠之后等待系统重启即可完成升级
+
+步骤七：验证（top | grep java）
+命令：top |grep java
+系统重启之后再次调用终端命令行，输入上面命令如果有下面值出现可说明已经升级或部署完成，若没有值可升级或部署失败！
+