Browse Source

更新iot服务描述

luoguangyi 2 years ago
parent
commit
c3af30a81f
2 changed files with 18 additions and 10 deletions
  1. 15 9
      docs/iot/description.md
  2. 3 1
      docs/iot/message.md

+ 15 - 9
docs/iot/description.md

@@ -327,7 +327,7 @@ ii. 否则,使用最新的修补数据。
 | 服务名称         | 服务说明                                                     | 说明 |
 | ---------------- | ------------------------------------------------------------ | ---- |
 | iot-client       | iot采集集成,负责集成各种IOT数据,对接各种二方、三方系统,各种协议的数据 |      |
-| iot-project      | 边缘端IOT数据,上传下达的转发服务,所有iot数据都是传输到iot-project,然后再转发到iot-collect/iot-control,只是上传下达的搬运工,不生产数据,也不处理数据。iot-project也可以提供边缘端的一些实时数据查询和websocket推送能力; |      |
+| iot-project      | 边缘端IOT数据,上传下达的转发服务,所有iot数据都是传输到iot-project,然后再转发到iot-collect,只是上传下达的搬运工,不生产数据,也不处理数据。iot-project也可以提供边缘端的一些实时数据查询和websocket推送能力; |      |
 | iot-collect      | 云端采集控制程序,这个服务是几个服务中唯一对业务方提供接口的服务,iot-collec提供主要接口:查询采集实时数据、查询分精度数据、采集值统计下发控制指令、查询指令结果,实时websocket推送数据等。 |      |
 | compute-engine   | 分精度计算程序,根据数据库中配置的项目ID+表号+功能号+最小分精度类型,计算出对应的分精度;其实有两个程序。 |      |
 | iot-onlinestatus | 计算设备和系统的在离线状态;这是一个证明自己还或者的命题,正常理解中,在离线状态应该可以采集到,是一种IOT数据,但是实际情况下,在离线状态采集不到,大部分对象不会证明自己还活着,需要根据对象有没有其他的活动来推断;具体就是:如果对象在最近一段时间 有过其他的采集数据,那么设置设备在线,反之离线。 |      |
@@ -380,7 +380,7 @@ ii. 否则,使用最新的修补数据。
 
 ##### 有状态体现在两点:	1.实时数据本地内存缓存、	2.云边通讯TCP、UDP,集群有通讯问题
 
-iot服务只有一式两份的iot-collect/iot-control服务对外提供接口:采集实时数据、分精度数据、采集值统计、控制指令、查询指令结果。
+iot服务iot-collect对外提供接口:采集实时数据、分精度数据、采集值统计、控制指令、查询指令结果。
 
 提供的核心接口就是实时数据、分精度数据,分精度数据数据量,每次从数据库查询。实时数据查询具有批量和高并发的特点,所以实时数据有内存缓存,并且每次有IOT数据后实时更新缓存,查询的时候不查库只查内存。
 
@@ -432,9 +432,9 @@ zkt-control:远端控制服务,负责日程、模式、日历和定时控制
 
 zkt-project-control:边缘端控制服务,接受zkt-project-control的定时轮询下发的指令,并在指令设置的时间下发指令到iot-project;
 
-iot-project:边缘iot服务,http方式接受控制指令,并转发指令到iot-client服务,同时下发记录同步到iot-control
+iot-project:边缘iot服务,http方式接受控制指令,并转发指令到iot-client服务,同时下发记录同步到iot-collect
 
-iot-control:云端控制服务,http方式接受控制指令,也接受iot-project控制记录保存到hbase;
+iot-collect:云端采集控制服务,http方式接受控制指令,也接受iot-project控制记录保存到hbase;
 
 iot-client:对接设备或者子系统进行具体的采集和控制
 
@@ -446,15 +446,15 @@ iot-client:对接设备或者子系统进行具体的采集和控制
 
 | 库名           | 表名               | 表说明           | 服务        | 数据库类型 |
 | -------------- | ------------------ | ---------------- | ----------- | ---------- |
-| db_public      | originalsetpresent | 控制指令实时值   | iot-control | hbase      |
-| db_public      | originalset        | 控制指令历史记录 | iot-control | hbase      |
+| db_public      | originalsetpresent | 控制指令实时值   | iot-collect | hbase      |
+| db_public      | originalset        | 控制指令历史记录 | iot-collect | hbase      |
 | control-center | command_resul      | 下发指令会记录   | zkt-control | mysql      |
 
 ### 7.4、接口
 
 [接口文档](http://39.102.54.110:9009/iot/iot.html#%E5%90%8C%E6%AD%A5%E6%8E%A7%E5%88%B6):http://39.102.54.110:9009/iot/iot.html#%E5%90%8C%E6%AD%A5%E6%8E%A7%E5%88%B6
 
-iot-project(iot-control)手动控制接口:
+iot-project(iot-collect)手动控制接口:
 
 ```
 http://ip:port/sync_pointset_post
@@ -470,14 +470,22 @@ http://ip:port/sync_pointset_post
 
 1.新建模式、日程、绑定设备、日历绑定模式(详见产品文档,产品使用说明等)
 
+
+
 2.到达设置时间点后观察hbase数据库记录,如果有记录,说明没问题,没记录的时候:检查设备的绑点、
 
 手自动状态设定、日程日历设定、数据库记录和相关服务日志;
 
+
+
 3.自动控制前先保证手动控制是可以控制成功,手动控制后记得修改回去对应的手自动状态;
 
+
+
 4.云-》边的指令默认15分钟下发一次,每次下发的时候下发15分钟后的2小时的指令,极限时间是15+15=30分钟,所以新建日程中30分钟后的指令才是一定可以下发,15分钟内的一定不会下发下去的;
 
+
+
 ```
 相关时间的可选默认配置如下:
 #每次下发2个小时的定时控制时令
@@ -496,8 +504,6 @@ command.cycle.minute=15
 
 [iot-collect部署文档](https://thoughts.teambition.com/workspaces/5f7001fdd8b0840016e073e7/docs/5fe1af23eaa11900016f409a)
 
-[iot-control部署文档](https://thoughts.teambition.com/workspaces/5f7001fdd8b0840016e073e7/docs/5fe1b5884cc5830001a3f212)
-
 [iot-project部署文档](https://thoughts.teambition.com/workspaces/5f7001fdd8b0840016e073e7/docs/60094e5ceaa11900015f142a)
 
 [iot云端服务接口](http://39.102.40.239:9991/swagger-ui.html#/)

+ 3 - 1
docs/iot/message.md

@@ -179,6 +179,8 @@ buildingheart是iot-project和iot-collect服务的心跳报文,作为云端控
 
 ### ***2.3 事件消息上传***
 
+香港置地火警使用过,目前应该已经没有使用场景了;时间类型的数据不具有表号-功能号标识,无法映射到物理世界物模型.
+
 数据上报包	iot-client -> iot-project-->iot-collect
 
 | 建筑 | 网关 | 类型      | 时间 | 序号 | 消息类型 | 消息内容 |
@@ -243,7 +245,7 @@ buildingheart是iot-project和iot-collect服务的心跳报文,作为云端控
 
 1101070037;1;senddownsetack;20010203040506;123;1001;11;3.1;20010203040507;success
 
-### ***3.3 点位设置通知***
+### ***3.3 点位设置通知同步***
 
 直接通过iot-project进行的控制设定,通过点位设置通知同步到iot-collect,然后保存到数据库中;