【参考文档】乐联网使用详细手册

2013-07-07 11:30

 修订记录:

2017/5/18  看云地址:https://www.kancloud.cn/xjme/lewei-user-manual/357178

2014/1/10  删除摄像头;

2013/8/19  增加“触发器”的介绍,详见第7.6小节;

2013/5/9  增加“表达式管理新增传感器历史统计值条件”的介绍,详见第7.2小节;

2013/5/9  增加“邮件推送历史数据曲线图功能”的介绍,详见第7.2小节;

     本文整体介绍乐联网物联网应用平台的使用方法,让新注册的用户可以对乐联网有个全面的了解并可以迅速创建自己的物联网设备和应用。

 

1.1       乐联网简介
乐联网(http://open.lewei50.com),通过开放的API,可以让您轻松的将各类传感器、测量设备或工业仪器仪表接入该平台,并可以通过开发应用来监管和控制它们。我们的平台为您提供传感器云服务,让您无需繁琐的编程,便可以将自己的各类测量或控制设备实现网络功能,快速开启物联网应用。而工业仪器仪表的无缝接入和强大的数据存储、查询和分析能力可以帮助一些传统行业快速部署自己的物联网应用,实现传统企业向物联网企业转型。
乐联网的主要功能有个人门户功能,数据存储和分析(结合行业专家可延展为专家系统),工业仪表无缝接入和手机App功能。
1.2       我们的物联网架构
我们物联网架构分为三层,即“云端服务器 -> 设备 -> 传感器&控制器”的架构。“传感器&控制器”是指可以采集、测量数据或者可以被控制的设备或仪器;“设备”的作用是将设备的采集数据发送到云端服务器上或者将控制数据返回给设备,“设备”前端能够与测量设备进行通信(例如RS232接口,RS485接口),后端需要具备网络功能(例如GPRS,WI-FI和以太网功能);而“云端服务器”上部署了数据存储、分析等的数据库,最后用户通过客户端(电脑、手机)等可以以浏览器的形式访问数据库,就可以实现丰富多样的基于数据的应用。
 乐联网物联网架构图
以一个实例来说明,如图1所示,例如我们要采集分别在北京和上海的两处大棚的棚内温湿度数据并存储到服务器上供农业专家进行查询和分析从而对种植提出指导,那么我们首先在两地大棚内需要安装测量“传感器”,然后将“传感器”连接到网络转接模块上,即“设备”,该“设备”会将采集上来的数据转发到公网服务器,即“云端服务器”上进行存储。这样最终用户就可以打开网页查询和分析各项数据了。
如何在乐联网建立起你的设备是你在乐联网上实现各类物联网应用,与你的传感器&控制器进行交互的第一步。
你需要登录进入乐联网,如果没有账号,需要注册,在乐联网首页的右上角可以点击“注册”便可以注册账号了,需要输入你的常用邮箱,因为账号需要在你的邮箱里进行激活。使用注册的用户名、密码进行登录,进入到系统,会看到上边的管理菜单的“我的物联”菜单,在这里可以增加你的设备、传感器与控制器。
首先添加设备,通过点击“我的设备”选择编辑已有的默认设备或者选择"添加新设备",如下图,填写相关信息后,点击保存就可以了。
 添加设备
相关参数解释如下:
标识:设备的标识。系统自动分配,按01,02……这么向下自动排序。
类型:根据设备采取的不同硬件,设备被分为四种类型,Arduino, Art, lw-board和其他类型。说明如下:
Ø Arduino:电子爱好者熟知的一款电子原型平台硬件
Ø Art:RT-Thread公司开发的一款国内开源平台硬件
Ø Lw-board:乐为物联公司自己开发的网络功能模块硬件
其它:其它类型的网络功能硬件
名称:该设备的名称
是否可控:如果该网关下有可反向控制设备,则勾选“是”,然后需要输入API地址。
介绍:设备的简单文字介绍
是否公开:如果公开你的设备,则别的用户能在乐联网公开设备地图上看到你的设备信息(设备名称及设备介绍)。具体可参考本文第七节;
地理位置:在地图上选择你的设备所在的地理位置;
3.      如何添加传感器与控制器
添加设备之后,需要添加设备下面的传感器与控制器。点击“传感器与控制器”,可以添加的设备有两种类型:传感器与控制器。
3.1       添加传感器
点击左边的“传感器与控制器”,在“传感器列表”中点击右边的“新建”,如下图,在“添加传感器”页签中填写相关信息后,点击
"保存"就可以了。
 传感器列表
 
 
 添加传感器
相关参数解释如下:
标识:传感器的缩写,为字母和数字的组合,如“T1”;
类型:可以在下拉菜单选择不同的传感器类型,区别是不同类型的数值单位不一样,如温度是,浓度是%等等;
单位:与类型相关联,如果“类型”中选择“其他类型”,则需要这里手动输入单位;
设备:从下列菜单选择该传感器连接的设备;
名称:传感器名称;
数值转换:可以校准你的传感器,最终的保存数值=上传数值*系数+偏移,如果你的传感器没有系数和偏移值,则可以留空,主要应用于仪器仪表类传感器;
图片:可以上传你传感器的照片,公开后在乐联网公开设备地图中可以看到;
是否公开:是否公开你的传感器,只有当设备和设备连接的传感器同时公开,你才可以看到传感器的信息和数据;
正常值范围:设置数据的正常值范围;
超过范围告警:勾选,则测量数值不在正常值范围会自动短信告警,详见第五节;
发送间隔:当前传感器的最小保存时间,发送频率仅作为判断传感器在线的衡量标准,如果服务器在发送频率设置的时间内没有收到数据,则显示该传感器不在线;
介绍:传感器的备注信息;
发送超时报警:传感器超时(超过发送频率设置的时间)不发送数据有短信告警;
自动发微博:可以绑定新浪微博,自动推送微博,详见第八节;
3.2       添加控制器
点击“添加控制器”页签,如下图,填写相关信息后,点击保存就可以了。
 
 
 添加控制器
相关参数解释如下:
标识:控制器的缩写,为字母和数字的组合,如“C1”;
名称:控制器名称;
设备:选择控制器连接的设备;
类型:可以选择“开关型”和“数值型”,“开关型”以“0”和“1”的方式来控制设备的开关,而“数值型”则会根据不同的数值来调整设备的状态;
最小值:“数值型”控制时的最小数值;
最大值:“数值型”控制时的最大数值;
 
当您将数据发布到乐联网上以后,就可以开始您的物联网应用了,乐联网提供了如下的基本功能:
4.1       实时数据
您可以实时的查看您的传感器的当前数据显示,和反向控制您的控制器。
 实时监控
4.2       历史走势分析
乐联网将您的测量数据分类存储以供您随时查询和分析,您可以查询一段时间内的历史数据走势图,可以让您一目了然的了解数据变化趋势。
 数据历史走势
历史数据的查询还可以显示为以下界面,并支持将数据导出存为.csv格式的Excel文件。
 历史数据查询
4.3      传感器对比分析
可以对多个传感器的历史数据走势图进行对比分析,如下图所示:
 传感器对比分析
4.4       数据分布统计
您可以查看您的测量数据的分布区间情况,让您更好的分析您的数据。
 数据分布统计
4.5     数据报警分析
您可以设置您测量数据的的正常值范围,并可以在系统里输入监测人的手机号码。当您的测量数据不为正常值,系统会定时的给该手机号码发送短信提醒数值超限,请求监测人及时处理。
乐联网还提供数据报警分析,让您可以清晰的看到数据超出正常值范围的次数和所占的比例。
 数据报警分析
 
短信预警开启方法:     设置通知组  
 
      5.1 添加联系人
    登录后进入“短信预警管理”-> “我的通讯录” ->“新建”
 
 
  如下图所示,输入联系人的姓名、手机号等信息,点击保存

   
 

以同样的方法添加多个联系人,并保存 

 
 
       5.2  添加通知组 
        进入“短信预警管理”-> “通知组管理”,点击“添加通知组”
 
 

设置好通知组名,勾选需要通知的联系人,点击保存。

 
 
 
 短信通讯录设置
5.3,在管理菜单“我的物联”  ->  “传感器与控制器”里面编辑设备开启短信预警功能,在这里设置传感器的正常值范围,勾选“开启”启动短信预警,设置完成后点击“保存”。
 
 设置短信报警范围 
 

如图所示,正常值范围设为 20-30,超过范围报警选择之前设置好的温湿度监控小组,最小触发间隔应不小于10分钟。

第三步,已经设置成功了,当您的测量值超过正常值范围后您就会收到报警啦,如上图所示,温度T1的正常值范围设置为“20-30”,当光照低于20或高于30您就会收到预警短信了,如下图,温度为32℃,则收到了预警短信通知。
 
手机短信报警
5.4 微信预警请参考文章:http://www.lewei50.com/dev/doc/186
 
5.5 邮件预警与短信预警步骤基本相同,只是在设置通知组时勾选的内容不同:

如需使用短信报警就勾选手机号,需使用邮件报警就勾选邮件地址,如下图所示:
    进入短信预警管理”-> “通知组管理,点击添加通知组”,点击保存后,如果实时数据超过设定值,就会收到短信、邮件报警了。

6.1       基本账户信息设置
在“我的账户”可以查看、修改个人信息,可以添加你公司的Logo,电话,地址和介绍等等,这些也可以公开在乐联网的公开设备地图上,让别人了解你的信息,在这里要注意记住您的用户key,每个用户的userkey是唯一的,它将您的数据与别人的数据区别开来。
 个人基本信息设置
 
6.2       子账户设置
在你注册了乐联网的账号以后,你可以在你注册的账号下定义若干个子账户,并给这些子账户不同的授权,比如某子账户只有查询的操作权利而没有添加设备和修改个人信息的操作权利,这样你自己的账号就相当于一个管理员账号,并分配若干个子账号,让他们帮你维护你的设备而不用担心他们误删或误操作了你的设备。
子账户的设置在“我的账户” -> “子账户管理”,点击“添加子账户”页签,在这里输入要添加的信息,包括用户名、密码、姓名和介绍,然后在权限里面勾选可以给该子账户的操作权限,点击“保存”后则完成子账户的配置。配置完成后,使用子账户的用户可以使用“主账户:子账户”格式登录系统并自己修改密码。
如下图,给数据监控人员James只提供了“我的物联设备”下的“实时数据”查看以及“统计分析及报表”里的“历史数据查询”,那么你用这个子账户登录进去后的界面只能看到这两个菜单。
 
 子账户设置
图 18 子账户登录界面
6.3       个人门户功能
乐联网为每一个注册用户提供了一个展示您的创意和产品的门户,无论您是个人开发爱好者还是有物联网需求的企业用户,您都可以借助这个平台来实现您的物联网应用,在这里您不是一个人在玩物联网,而是可以和许许多多的物联网行业内的人士一起交流,一起分享。
 公开设备地图
当您在乐联网成功创建您的传感器并把测量数据发布上来以后,您就可以在乐联网上公开您的传感器和测量数据,这样别的注册用户就可以看到您的传感器信息和数据信息。因此,您可以在这个平台上展示和推广您的传感器,您的创意。可以说乐联网不仅仅是一个物联网的应用云平台,还是一个融合了社交、宣传等功能的互联网平台。
您的传感器公开后,可以在首页的传感器分布地图上被检索到,其他注册用户都可以检索到。
个人门户展示
您还可以在您的个人信息里面添加内容,给您的传感器补充图片和相关介绍,可以添加Logo,企业/个人图片及介绍,产品图片及介绍等等。其他注册用户还可以在您的传感器下面留下他们的评论。
其中设备及照片在添加设备或编辑设备的时候可以增添,传感器的信息和图片同样在添加传感器的时候可以增添。而用户名称、介绍及公司Logo等是在“我的账户”里面设置的个人信息。
7.1       说明
针对资深的用户和爱好者,乐联网会开放“智能物联”的管理菜单,而普通用户在左边的管理菜单下会看不到这个菜单,有兴趣的用户可以发邮件给 service@lewei50.com 或在乐联网QQ技术支持群(QQ群:59162154)进行申请。
7.2       微博、邮件推送功能
乐联网还提供“绑定新浪微博、邮件及短信”的功能,通过这个功能您可以将您的实时测量信息自动定时地推送到新浪微博上,或发送邮件到指定的邮箱,或发送短信到指定的手机号上,还可以根据测量值的不同来自定义推送不同的微博内容。以一个微博推送的例子来进行说明,邮件和短信推送方式和微博推送基本一致,只是在最后的“自动发送设置”里面可以选择微博、邮件或短信的方式,微博推送目前只支持绑定新浪微博。
案例介绍:
这个案例是每天在不同时间(上午8点,下午14点,晚上20点)用绑定微博账号定时播报空气小颗粒物(PM2.5)的测量值,并根据不同测量值,微博会发送不同的内容。微博内容示例如下:
【乐联网温馨提示】上午好,今天是2017-05-11,目前办公室空气中小颗粒物含量为58μg/m3,空气质量好!
其中“上午好”是根据时间来变化,如果是14点,则是下午好,20点为“晚上好”;“2017-05-11”是播报当天的日期;“58μg/m3”是实时的当前PM2.5测量值,“空气质量好!”是根据不同测量值范围会定义不同的微博发送内容。
设置步骤:
 绑定微博账号
首先,使用你的账号登录到乐联网,进入后点击“管理菜单”的“我的账户”,第一步要做的是绑定你的微博账号,点击“绑定微博账户”,点击右边窗口中的“绑定微博”绿色按钮,会弹出一个新页面,在这里输入你的新浪微博账号和密码,点击“登录”即可绑定。绑定成功后会切换到提示“微博绑定成功”的界面,则表示绑定成功。要注意的是,如果你已经在IE上已经打开了你的新浪微博,则系统会自动关联,不会出现登录界面,如果你想绑定另外一个账号,那么你需要退出你的新浪微博,并重启IE浏览器,然后才能绑定。
注意:为保障账号安全,一定要认准绑定微博的网页是以api.weibo.comURL地址
第二步,点击上方管理菜单“智能物联” -> “表达式管理”,在这里设置根据不同的系统变量或传感器测量值范围来定义不同的微博发送内容。
首先看根据系统变量“小时”的范围来让微博发送不同的内容“上午好”,“下午好”和“晚上好”,点击“添加表达式”,按照以下的内容进行填写,注意“类型”选择“系统变量”,系统变量包括“小时”、“日期”、“时间”,选择“小时”,“小数点位数”此处不涉及,然后选择输出文本(勾选“是”),然后根据我们之前的逻辑关系设置,设置好了点击“测试”,可以看到当前时间为10点,那么则返回文本为“上午好”(在上午好的8-12的范围内)。
注意:时间区间填写的逻辑是大于等于前面数值,小于后面数值,数值必须连续!如 8-12 这个时间区间不包括12点,所以下面一行必须从12开始 12-13。
 
 添加表达式——小时
然后同样的方法设置“日期”,“日期”只需要返回当天的日期的内容,所以比较简单,不需要选择“是否输出文本”,设置和测试结果如下:
添加表达式——日期
最后来设置根据不同的小颗粒物PM2.5测量值来输出不容的微博文本,这里“类型”选择“单一传感器”,在“参考值”里面选择网关“颗粒物检测”和传感器“小颗粒物”。这里的测量值取值到整数,所以不需要设置小数点位数,如果测量值有小数,你可以在这里填写,填写的格式为“.0”,“.00”等等。输出文本与测量值范围的逻辑如下,这里你可以自己定义。然后点击“测试”可以检查设置的结果是否正确。
根据不同的测量值范围来定义不同的微博内容
以上就设置完成,当然还有更复杂的逻辑关系设置,在“类型”里面除了“单一传感器”,还有“传感器组合”,里面的组合方式有“平均”,“求和”等,可以选择多个传感器,这里就不详细介绍了,大家可以自己去研究。
传感器组合方式设置
第三步,设置发送内容,点击“发送内容管理”,设置和测试如下图,其中两个方括号“[[ ]]”中内容表示返回括号中的系统变量值或者传感器测量值或更复杂的传感器测量值的逻辑运算结果,例如“[[日期]]”返回的就是当前日期;而两个大括号“{{}}”中的内容表示由括号里面的值的范围对应的应推送的微博文本内容。例如下图中{{颗粒物}},当前小颗粒物含量的测量值为5946,根据之前在表达式中设置的逻辑对应关系,此时返回的文本应该为“空气质量较差,请使用空气净化器!”。设置好后同样可以点击测试,看看设置的是否正确。
 微博发送内容设置
第四步,就是设置自动发送,这个比较简单,点击“自动发送设置”, 选择“添加自动发送设置”,在发送方式里选择“新浪微博”方式,发送内容里选择刚才已经设置好的表达式“空气质量播报”, 重复方式:可以选择“每天”、“每周”、“每月”,然后在发送时段里勾选8点14点和18点,表示每天的8点,14点和18点定时发送。在是否开启里勾选“是”,自动发送就被开启。
 自动发送设置
以上的设置就全部完成了,这样你就可以会看到你绑定的微博账号会按照你定义的时间自动推送根据测量值的不同而不同的微博内容了。
微博发送
邮件的推送方式与微博一致,只是在“添加自动发送装置”里面选择邮件的发送方式,选择后会填出一个“发送给”的空白栏,需要在这里填写发送到的邮箱地址。
 邮件、短信推送设置

              注意:由于短信的发送内容需使用模板,不可以自定义内容,因此目前已不支持短信的推送方式,请选择微博推送或者邮件推送!

 另外,在“表达式管理” -> “添加表达式”的“类型”选项增加了“传感器统计值”的选项, 如下图所示:

 表达式管理-历史统计值条件

在“类型”里可以选择“传感器统计值”,其中相关参数如下:

传感器:选择某一设备下的某一传感器作为统计值的统计对象;

日期范围:统计值的时间范围,可以为一月,一周,一天或自定义时间等;

时间范围:可以选择测量的时间段,如早8:00到下午18:00;

统计方式:可以选择“平均”、“求和”、“最大”、“最小”、“方差”等;

 

同样,基于该测量值可以输出自定义文本,例如上图所示,是最近一周的每天早8:00到下午18:00的统计值的平均值,如果低于20,则输出文本“湿度平均值偏低”,如果大于80低于100,则输出文本“湿度平均值偏高”。

设置完毕后,可以点击“测试”,显示相应的结果以供参考

 

     7.3 自动推送报表

乐联网自动推送邮件功能,增加了可以在邮件中推送历史曲线图的功能,目前只支持发送历史数据曲线图,后续会支持推送其他更为复杂的报表功能。

配置该功能的第一步是要先配置好自动发送的邮件内容,具体请参考7.2节的介绍

第二步,点击“自动发送设置” -> “添加自动发送设置”,然后点击下面的“自定义发送内容”。如下图所示:

 自定义发送内容

第三步,点击如下图中的“推送报表”

添加发送内容

然后选择“推送报表”,如下图所示,可以选择指定测量对象的指定时间内的历史曲线。

推送报表设置

设置完成后后乐联网就会在你指定的时间内给你发送邮件了,你也可以在“自动发送设置”里点击“立即发送”来立即发送一封测试邮件。

添加自动发送设置

可以到你的邮箱里查收邮件,并看到推送的邮件内容和历史曲线图:

邮件里的报表显示

 

7.4       微信互动
乐联网还支持你的设备与微信互动,详细步骤如下:
第一步,打开微信,在“添加朋友”中,选择“搜号码”来搜索lewei50或者在“查找微信公共帐号”来搜索“乐联网”。或者扫描下面的二维码来添加关注“乐联网”。
乐为物联微信二维码
第二步,关注“乐联网”后“查看消息”,会自动收到一个消息,提示点击一个链接来绑定乐联网账号。点击链接进去后,会有一个让你绑定账号的对话框,输入你登录乐联网的用户名和密码,点击“确认绑定”来完成账号绑定。手机会显示绑定成功,并可以在自定义页面查询设备的实时数据:
 
 
         
微信互动
第三步,绑定后便可以在微信自定义页面进行查询和控制。
以上为共用的微信查询和控制命令,你还可以自己定义你的微信命令,具体请见7.5节。
 
7.5       自定义微信命令
前文7.3节介绍了乐联网的利用微信进行与你的网关设备进行交互的功能,并介绍了几个常用的系统命令。乐联网还提供自定义微信命令的功能,让你定义你自己想用的微信控制或查询命令。
实现方法是在“智能物联”下点击“自定义微信命令”,点击“添加自定义命令”。
如图38所示,进行相关参数设置,参数说明如下:
标识:自定义的微信命令,注意命令唯一且不能与系统命令重复(b,u,uc,uo,l,c,o,h)等;
介绍:该命令执行的说明;
执行控制命令单元:如果自定义的是执行命令,此处勾选“是”,并在下拉框里面选择该命令控制的具体内容,这些内容是在7.4节介绍的在“执行单元管理”里已经添加的执行单元,如果之前没有添加,可以点击右边“管理执行单元”先进行添加;
执行查询内容:如果自定义的是查询命令,此处勾选“是”,并可以在下拉菜单里选择该命令查询的具体内容,这些内容是在7.2节介绍的在“发送内容管理”里已经添加的发送内容,如果之前没有添加,可以点击右边“自定义发送内容”先进行添加。
设置好以后,可以点击测试进行验证,则会看到控制的结果和控制返回消息或者是查询的相关消息。
 
添加自定义微信命令
 
7.6       定时执行计划
乐联网还给用户提供了自定义执行命令和定时执行这些命令的执行计划的设置,帮你实现定时的各类自定义控制,下面介绍一下如何实现这个功能的。
第一步,是要设置控制命令,点击“智能物联”下的“控制命令管理”,选择右边“添加执行命令”页签,进行执行命令的自定义。
添加执行命令
标题:该执行命令的名称;
设备:选择可控设备;
方法名:可以选择“更新控制器”即“Updatesensor”,也可以自定义方法;
参数:“更新控制器”或“自定义方法”时调用该命令时会调用该网关的API地址的传递函数,注意格式“f=方法名,p1=参数1,p2=参数2……”
至于方法名和参数与实现控制时的编程有关,详细可参考乐联网文档:【推荐教程1】W5100+arduino+乐联网平台 实现反向控制 http://www.lewei50.com/home/news/92
用同样的方法可以创建其它的控制命令,例如关闭灯。创建好可以点击测试,如果这是可控的硬件环境和软件编程都已经就绪,那么你点击测试后会看到相应的控制器的变化。并返回测试成功及控制器返回的消息。
第二步,是要设置执行单元,点击“智能物联”下的“执行单元管理”,“执行单元”的意思是指你想定时实现的控制的命令的集合,即一系列控制命令的组合。
 添加执行单元
名称:该执行单元的名称;
执行命令:选择第一步定义好的一个或多个执行命令的组合;
说明:该执行单元的说明。
设置好以后同样可以在“执行单元管理”页面看到“测试”选项,点击“测试”进行验证。
第三步就是设置执行计划了,点击“智能物联”下的“执行计划设置”,在这里可以设置定时执行计划。
添加执行计划
执行单元:选择第二步定义好的执行单元;
名称:该执行计划的名称;
定时设置:执行该计划的时间,只要在相应的时间前打勾就行了。
是否开启:勾选则表示开启,否则关闭。
创建完毕以后,同样可以在“执行计划管理”页面点击“立即执行”,看到立即执行该计划的效果。
以上便可以实现定时执行自定义控制计划的功能设置,配合不同的硬件搭配和各种创意,你可以实现各种有意思的定时控制,比如早晨7点你起床的时候自动打开家里的窗帘。

7.7     触发器
 
以上介绍了乐联网的基本功能和使用方法,可以让用户了解并使用该系统,实现你的各类物联网应用。
另外,如何实现传感器或测量设备数据上传到乐联网请参考文档:【推荐教程1】W5100+arduino+乐联网平台 实现反向控制 http://www.lewei50.com/home/news/92 和【推荐教程2】W5100+arduino+乐联网平台实现传感器数据上传 www.lewei50.com/home/news/94
 
如何实现反向控制可控设备请参考文档:
如果你需要更详细的技术交流或者疑问咨询,可以加入乐为物联技术支持群:59162154
或关注乐为物联新浪微博 @乐为物联
或关注乐联网微信:搜索公众账号 “乐联网”。或者扫描下面的二维码来添加关注“乐联网”。