常见问题
# 常见问题
提示
更多问题可以通过敢为云官网(https://www.ganweicloud.com/)的工单系统或者论坛进行提问,敢为云将第一时间进行回复。
# 安装部署
常见问题
Q: 敢为云中购买了线下部署,如何获取授权文件?
A: 获取授权文件步骤如下:
注册登录敢为云官网后在资源下载 (opens new window)页面中下载需要的IoTCenter。
参考软件包安装的相关内容安装IoTCenter。
运行\IoTCenter\bin目录下的
GWHost1.exe
在打开的窗口中获取注册码或者启动服务后在\IoTCenter\log目录下的
Error.txt
文件中查看。完成线下部署的订单后,敢为云的工作人员会主动与您进行联系,此时将注册码提供给敢为云的工作人员后,会将授权文件发动到您的邮箱中。
Q: 敢为云如何进行线上部署?实名认证以及开发者认证和相关功能如何使用?
A: 敢为云官网的帮助中心中有详细的步骤流程,注册登录敢为云官网 (opens new window)后,可以查看帮助中心对应的内容。
Q: 购买了敢为云云服务后,登录平台的账号密码是什么?
A: 无论是线上部署还是线下部署,敢为云都提供了两个默认的账号需联系相关人员获取。
Q: 线下部署IoTCenter登录时报错密码错误。
A: 在确认账号密码输入正确的情况下,出现密码错误的原因是GWUser表中的数据没有正确加密导致。修改\IoTCenter\IoTCenterWeb\publish
目录下的appsettings.json
文件中的IsAesUpdateSuccess
字段的值为false
,系统会自动对GWUser
表中的数据进行加密。如下图所示:
Q: 线下部署的IoTCenter,登录Web后菜单中只有配置管理如下图所示:
A: 此问题是由于数据库配置不正确引起的。请打开\IoTCenter\Data\AlarmCenter
目录下的AlarmCenterProperties.xml
文件,检查该文件中数据库配置是否正确,是否同时选择了MySql和Sqlite数据库。
Q: 修改的管理员密码忘记了,应该如何重置。
A: 使用平台维护工具GWEncrypt.dll
进行管理员密码重置。该工具位于\IoTCenter\bin
目录下,使用dotnet命令执行WEncrypt.dll
。示例如下:
/opt/ganwei/iotcenter/dotnet/dotnet /opt/ganwei/iotcenter/bin/GWEncrypt.dll
Windows环境中可以直接运行\IoTCenter\bin
目录下的GWEncrypt.exe
。
打开的平台维护工具如下图:
输入8,选择初始化维护密码,输入新的密码后回车既可完成管理员密码的重置。
# 平台功能
常见问题
Q: 三维平台可以连接本地服务器,确无法连接远程服务器。
A: 此问题是由于\IoTCenter\data\AlarmCenter
目录下的AlarmCenterProperties.xml
配置文件中没有配置全网监听导致。将上述文件中HostIpAddr
字段的Value
值配置为0.0.0.0
,以开启全网监听,如下图所示:
Q: 在使用Web可视化的折线图控件时,控件绑定了设备测点后只有一个数据点,而没有随着时间变化产生折线。
A: 检查控件绑定的测点的实时值是否发生了变化,若测点值没有发生变化则折线图控件只会显示一个数据点而不会产生折线。
Q: 三维可视化中的环形图控件在使用json格式数据源时,控件不显示数据。
A: Json数据应严格按照控件Json数据示例中的格式给出。
Q: 场景联动功能无法正常使用。
A: 场景联动功能需要场景联动扩展插件的支持,可以在应用商店中安装场景联动扩展插件,如下图所示:
Q: 设备测点发生告警时,没有产生工单。
A: 此问题的解决步骤如下:
从应用商店中安装工单报警插件。
配置工单报警插件,如下图所示:
设备测点的工单报警字段应选择是。
Q: 使用视频平台录像功能时,点击停止录像后在回放列表中依然显示正在录制,且录像回访播放不了。
A: 造成上述情况的原因有如下三种:
\IoTCenter\IoTCenterWeb\publish
目录下的appsetting.json
文件没有配置http端口 该端口一般为44381;流媒体服务(MediaServer)目录下的config.ini文件中关于ffmpeg可执行程序(ffmpeg.exe)的路径配置有误;
流媒体服务(MediaServer)的存放路径中不能有中文
Q: 正确配置北向应用的消息订阅功能后没有主动推送数据。
A: 北向转发规则引擎中配置过滤规则时,最小值不能填入0,如下图所示:
Q: Web可视化里图片上传后的保存路径是什么?
A: Web可视化中上传的图片存放在\IoTCenterWeb\publish\wwwroot\IoTVisualFiles\IoTVisualImage
目录下。也可以采用在图片控件中添加一张上传图片,通过查看图片路径来了解上传图片的保存路径。值得注意的是图片控件的图片路径属性中保存的是相对路径,其相对的是wwwroot
目录。
Q: 应用商店中的的协议插件、业务插件以及物模型,三者有何区别?
A: 三者的区别如下:
协议插件主要面向的是与南向设备对接的一些协议插件,实现了与设备连接,数据解析,设备控制等逻辑。安装协议插件后在添加产品时可以在驱动文件中选择该插件。
业务插件包括了扩展插件和应用插件。应用插件主要是业务流程中的一些应用模块,如工单管理,访客管理,这一类插件的共同特色是都有管理界面实现流程;扩展插件用于扩展业务流程中的功能,以适应复杂的业务场景,如定时抄表、平台级联等等都需要用到扩展插件。
物模型主要是对一类设备进行抽象建模,将设备对象抽象成数字对象,如设备中存在一些测量类和信号类数据,这些进行抽象建模后,可以将测量类和信号类分别建立模型属性,在协议解析时,按照此模型进行解析映射,实现设备属性数字化接入到平台中。安装物模型后会在产品列表中增加对应的产品。
# 开发问题
常见问题
Q: 使用自行开发的协议插件接入设备后,设备在设备列表一直显示离线状态。
A: 此问题一般是因为CEquip类中的逻辑错误导致,请检查CEquip类中的代码是否有逻辑错误,比如GetYC方法中Switch结构是否缺少了某些分支等。
Q: 协议插件开发时,init方法中使用到的Local_addr字段的含义是什么?
A: Local_Addr字段对应的是通讯端口字段。如果远端设备为客户端,IoTCenter为服务端,使用通讯端口作为本机与远端通信的端口。例如为当前主机IP加端口号,如127.0.0.1:2206,则表示协议插件内部需要创建该Tcp的服务端,客户端直接连接到此服务端。同时,通讯端口也定义了本机在运行协议插件时的线程分组标识,相同的通讯端口,将使用同一个线程来运行协议插件。更多的字段含义可以参考数据库说明以及设备管理部分的内容。
Q: 使用自行开发的协议插件接入设备后,配置了测点保存历史曲线,但无法查询到历史曲线。
A: 此问题一般是由于SetYCData(YcpTableRow r, object o)
方法中的参数o的数据类型不是数值类型导致,请确保在调用SetYCData(YcpTableRow r, object o)
方法时参数o的数据类型为数值类型,不能是非数值类型,也可以调用SetYcpTableRowData(YcpTableRow r, double o)
方法。
Q: 在开发协议插件过程中需要查询字符串类型测点的历史数据,该如何实现?
A: 使用GWDataCenter.DataCenter.GetStringInfoFromCurveAsync
方法可以读取字符串类型历史数据,该方法使用示例如下:
GWDataCenter.DataCenter.GetStringInfoFromCurveAsync(DateTime.Now.AddHours(-24), DateTime.Now.AddMinutes(-1), 1, 11135, 1, "CS");
其中前两个参数分别为查询历史数据的起始时间和结束时间,第3个参数为站点号(默认为1),第4个参数为设备号,第五个参数为测点号,最后一个参数为历史数据的类型分为数值遥测、数值遥信、字符串遥测、字符串遥信以及元组类型对应的参数值为"C"、"X"、"CS"、"XS"、"SEQ"。
Q: 使用自行开发的协议插件接入设备后,设备列表界面遥测点的值一直是*号,调试时断点不能进入GetYC()方法。
A: 造成这种情况的原因有以下两种:
在init方法中没有调用父类的
init()
方法,请检查init方法中是否有bae.init()语句。init方法中存在死循环。
请核对CEquip类中是否存在上述两种情况。
Q: 协议插件开发时init
方法不执行,调试时不能进入该方法。
A: 协议插件的类名必须为CEquip
,检查插件中的类名是否为CEquip
。
Q: 开发完成的扩展插件应如何使用?
A: 扩展插件的使用步骤如下:
配置扩展插件,如下图所示:
将扩展插件动态库文件(后缀为dll)复制到
\IoTCenter\dll
目录中。重启服务后,扩展插件被自动调用执行。
Q: 扩展插件开发中SetParm方法的作用是什么?
A: SetParm方法用于扩展插件需要通过定时任务定时完成某些操作时的场景。可以参考扩展插件开发-入门部分的内容。
Q: 后端插件开发中如何取消对特殊字符的验证?
A: 在IoTCenter中启用了sql注入拦截,若需忽略,可在请求方法上加上[SkipCustomFilter]
从而禁用sql注入。使用该特性需要引入publish
目录下的IoTCenterWebApi.Extension.dll
库。
Q: 后端插件开发过程中如何引入第三方的库?
A: 后端插件开发引入第三方库的操作步骤如下:
模板引擎使用6.1.0-alpha3及以上版本。安装代码如下
dotnet new -i IoTCenterCore.ProjectTemplates::6.1.0-alpha3 --nuget-source https://nuget.ganweicloud.com
安装模板后使用模板新建项目,在新建项目中将IoTCenterCore.EntityFrameworkCore包升级到6.0.1及以上版本,如下图所示:
将
publish
目录下的IoTCenterCore.EntityFrameworkCore.dll
文件使用6.0.1
版本替换将
publis
h目录下的IoTCenterCore.dll
、IoTCenterCore.Abstractions.dll
、IoTCenterCore.Abstractions.Application.dll
三个文件使用6.1.0-alpha3
版本替换。将所引用的第三方包的dll文件跟项目生成的dll文件和json文件一起复制到
\IoTCenterWeb\publish\plugins\
对应目录下,如下图所示:
Q: 前端插件开发过程中,编译时报错信息如下:
A: 可以在catch
后加上(error)
既可解决。示例代码如下:
catch(error)
{
}
← 交付指南附录