Merge pull request #21 from inhandnet/pre-release

Add doc

DeviceSupervisor-2.0-Upgrade-Notes.md

@@ -0,0 +1,39 @@
+# DeviceSupervisor 2.0升级注意事项
+以下将版本号为**1.2.X**的DeviceSupervisor简称为**DS 1.0**，将版本号为**2.X.X**的 DeviceSupervisor简称为**DS 2.0**，将DS 1.0升级到DS 2.0需要注意以下事项。
+
+## 全局说明
+1. 仅支持1.2.9及以上的DS 1.0版本平滑升级至DS 2.0；
+2. 升级后DS 1.0的配置信息将会被翻译为DS 2.0的配置，升级后不能再回退到DS 1.0版本；
+3. 平滑升级后,调用DS 1.0 **get_tag_config** API获取到的配置格式有变更；
+4. DS 2.0的配置和DS 1.0不一致，DS 1.0的配置文件无法导入DS 2.0。
+
+## 升级后的名词解释
+- 设备 --> 控制器
+- 变量 --> 测点
+- 告警策略 --> 告警规则
+- 分组(轮询间隔) --> 分组(上报间隔)
+- 新增控制器“轮询间隔”
+
+## 各功能模块更新说明
+### 测点监控
+1. 升级后OPCUA/EtherNetIP的测点配置信息将被丢弃；
+2. 数据类型 **BOOL** 将被转换成 **BIT**类型；
+3. DS 1.0支持多个相同控制器，DS 2.0只支持一个；
+4. DS 1.0 的**只写**模式变量升级后将变成**可读可写**模式；
+5. 平滑升级后，modbus地址变化：**20000->110000,40000->310000,50000->410000**；
+6. 平滑升级后，测点上传模式，realtime -> periodic。
+
+### 告警
+1. 升级后DS 1.0存储的历史告警和离线缓存数据将会被清除；
+2. DS 2.0中的告警策略不再支持“直接使用地址”策略，升级后采用该方式的告警策略将会失效；
+3. 升级后DS 1.0的告警分组被删除，DS 2.0仅按照告警名称来区分不同的告警，需要注意DS 1.0云服务脚本如果引用了空的告警分组，则升级后此脚本可能因为没有告警分组无法运行，请在云服务脚本，手动选择触发源类型。
+
+### 云服务
+1. DS 1.0 升级后 **write_plc_values** API将不在支持匿名设备名称的方式修改测点值，即修改PLC值需要指定控制器名称。故DS 1.0的阿里云属性设置脚本会失效，需要在脚本中指定需要修改的设备（DS 2.0称为控制器）名称；
+2. 升级后DS 1.0的阿里云自定义RRPC脚本，topic的响应会失效，但脚本功能可以正常执行，建议使用DS 2.0的API修改脚本；
+3. 平滑升级不支持GreenGrass Core相关配置迁移；
+4. 平滑升级后，云服务所用证书名称会变成DS 2.0默认的证书名称，不影响功能使用。
+
+### 参数设置
+1. 平滑升级后，自定义参数新增SN和MAC两个参数，DS 1.0内置的参数gateway_sn也会显式添加出来，如果脚本中使用了gateway_sn，请谨慎删除gateway_sn，可以使用DS 2.0新增的SN代替gateway_sn；
+2. 平滑升级后，参数设置取消了历史数据最大条数这一项。

index.rst

@@ -50,3 +50,4 @@ Device Supervisor App为用户提供了便捷且可靠的数据采集、数据
    AliyunIoT-CN.md
    AWSIoT-CN.md
    AzureIoT-CN.md
+   DeviceSupervisor-2.0-Upgrade-Notes.md