版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
认识物模型物联网云平台开发实践(第2版)目录CONTENTS01物模型简介02新建物模型03设备模拟器04应用模拟器
第一部分
物模型简介PART0101认识物模型传统物联网业务开发流程
物模型开发流程传统的物联网业务开发包括终端设备研发、设备与云端联调、基于设备和云端进行应用开发三个步骤,三个业务开发步骤是串行的,且每一步都需要一定的资源投入和开发周期,从而导致物联网业务开发周期冗长,资源投入大。用物模型来结构化、统一化、标准化地粘合数据碎片,减少业务复制成本,打破服务壁垒。物模型是将终端设备实体进行数字化描述,在云端实现设备虚拟化。可以通过设备产生的真实数据进行物联网应用开发;也可以基于云端虚拟设备直接进行开发,终端设备的研发也可以同步进行,这样使得原本的串行研发流程变为并行的研发流程,缩短研发周期,节省人力和资源成本。认识物模型上图为设备抽象模型,用物指代连入平台的设备,模型包含物的状态、档案信息和功能定义三层。第一层用状态信息表示设备是否在线、是否激活;第二层用物的档案描述设备身份信息,这部分信息为静态信息;第三层为物的功能定义,包含属性、服务和事件三部分,设备运行状态为属性,设备被远程调用而执行的动作和指令表示服务,事件则表示设备主动上报的信息、告警、故障等。以设备智能风扇为例,属性包括转速、环境温度、开关等;服务包括设定工作时长等;事件包括告警、信息和故障等。
风扇的“开关”属性构成了“开关功能”,“设定工作时长”行为构成了“定时功能”。OneNET物模型将“开关功能”和“定时功能”封装成“定时开关组件”,用户通过调用该组件实现风扇的定时开启和定时关闭。采用了与ICA物模型类似的三级架构,包含设备、组件和功能,其中功能又包含属性、服务和事件。组件:用于描述设备能力,包含公共组件和行业组件,每个组件可以由多个功能组成;属性是指设备支持的可读或可设置的参数功能,一般用于描述设备运行时的状态,用户也可通过设置的请求方式来更改设备的运行状态;服务是指终端设备被外部调用的能力,可设置输入参数和输出参数。服务可实现复杂的业务逻辑,例如执行某项特定的任务。服务支持同步或异步返回结果;事件是指设备运行时可以被触发的上行消息,如设备运行的记录信息,设备异常时发出的告警、故障信息等。事件可包含多个输出参数。认识物模型-3PART0202
第二部分
新建物模型【实验目的】
(1)掌握基于OneJson数据协议的MQTT产品、设备创建流程。
(2)掌握物模型的创建流程。
(3)掌握整个流程中各类信息的解读。
【实验设备】
(1)一台PC,可连接Internet。
【实验要求】
在OneNET平台注册MQTT产品,数据协议采用OneJson,在该产品下注册设备,设置物模型。
新建物模型--实验步骤一、新建MQTT产品
(1)登录OneNET平台,进入开发者中心,单击左侧“产品开发”。
(2)单击“创建产品”按钮,并填写相关信息。接入协议选择MQTT,数据协议选择OneJson。(3)记录新建产品的产品ID。新建物模型--实验步骤二、新建MQTT设备
(1)在该产品下,添加MQTT设备,设备名称不能重复。
(2)选择“设备列表”标签,在该设备右侧,出现数据流格式可以进行的操作选项:设备详情、属性、事件记录、服务记录、文件管理、设备调试和SIM卡查询。
单击“设备详情”,记录设备名称、设备密钥和产品ID。新建物模型--实验步骤三、功能定义
OneJson数据协议是物模型对应的数据协议,在使用过程中,需要先定义物模型,再进行功能定义(1)选择“产品开发”标签,在出现的界面中单击“设置物模型”。
新建物模型--实验步骤三、功能定义
(2)在出现的界面中,单击添加自定义功能点。(3)添加“温度”和“湿度”两个功能类型为属性类型的功能点并保存。定义功能点时,需要选择功能类型、填写功能名称、标识符、数据类型、取值范围、读写类型等参数。其中,标识符不能包含中文字符。这两个功能点可以用来记录运行过程中产生的数据,读写类型可以设置为读写。新建物模型--实验步骤三、功能定义
(4)功能类型不仅包含属性类型,还包含服务类型。添加功能类型为服务类型的功能点,名称为“风扇控制”,调用方式包括同步和异步,也可以设置输入参数和输出参数。此处,标识符为功能点唯一标识符,单个产品下唯一,也是后续调用服务时对应的identifier参数。新建物模型--实验步骤三、功能定义
(5)除了属性类型和服务类型,功能类型还包含事件类型。添加功能类型为事件类型的功能点“高温预警”并保存。定义功能点时,需要选择功能类型、填写功能名称、标识符、事件类型、输出参数等信息。其中,标识符不能包含中文字符。事件类型包含信息、告警、故障三大类。点击添加参数,可以看到添加输出参数页面。需要填写参数名称、标识符、数据类型等信息,不同的数据类型,对应的参数值设定不同。以数据类型int32为例,设置取值范围、步长和单位。新建物模型--实验步骤PART0303
第三部分
设备模拟器设备模拟器--实验步骤【实验目的】
(1)掌握基于物模型的MQTT虚拟设备调试的方法。
(2)掌握整个流程中各类信息的解读。
【实验设备】
(1)一台PC,可连接Internet。
【实验要求】
物模型将终端设备实体进行数字化描述,在云端实现设备虚拟化,可以基于云端虚拟设备直接进行开发。在实验一创建的产品和设备下,进行虚拟设备调试,实现设备属性上报、属性期望值获取和事件上报。一、虚拟设备登录
(1)进入OneNET开发者中心,单击“设备接入管理”——“设备管理”,单击实验一创建的设备所对应的“详情”按键。
设备模拟器--实验步骤一、虚拟设备登录
(2)在图示的页面中,单击“设备调试”。(3)在“设备模拟器”页面中,单击“启动调试”。设备模拟器--实验步骤一、虚拟设备登录
左侧为已定义的属性功能点,右侧为调试日志,数据格式为JSON。启动调试后,平台启动虚拟设备,并将虚拟设备与平台建立连接,右侧为设备登录的具体信息,具体包括以下几部分内容:
title:登录,表示操作内容为设备登录;
timestamp:表示登录时间;
message:表示登录设备信息和鉴权信息,具体包括clientid(设备名称)、username(产品id)、password(token)。在OneNET平台“设备详情”页面中,会显示设备状态为“在线”。
设备模拟器--实验步骤二、属性上报
属性上报表示将设备实时运行的参数等信息上传至云平台,基于物模型,可以在无实物的状态下,使用虚拟设备进行模拟,并在设备调试页面中进行属性上报,具体步骤如下。
(1)在“设备调试”——“设备模拟器”——“属性上报”页面,勾选已经配置的功能点,以“湿度”功能为例,允许数值类型为float,数值范围为0-100。填写上报的湿度值60,单击“属性上报”。
设备模拟器--实验步骤二、属性上报
(2)右侧调试日志中显示如图所示的属性上报和平台响应两部分内容,格式为JSON格式。设备模拟器--实验步骤二、属性上报
属性上报的信息包含以下几部分:
title:属性上报,表示操作内容为设备属性的上报;
timestamp:表示属性上报时间;
message:表示属性上报信息,具体又包括topic(属性上报的主题)、data(属性具体信息:id、version、params)。id为用户自定义消息id号;version为物模型版本号;params为请求参数,包含属性上报时间和属性值。设备模拟器--实验步骤二、属性上报
平台响应的信息包含以下几部分:
title:收到平台响应;timestamp:表示接收到平台响应的时间;message:表示平台响应具体信息,包括topic(平台响应的主题)、data(响应具体信息:id、code、msg)。id为用户自定义消息id号,与属性上报的id一致,表示云平台收到该条属性上报的消息;code为响应代码,200为属性上报成功;msg给出具体响应结果,success表示属性上报成功;如果上报失败会有具体的错误代码和错误信息。设备模拟器--实验步骤(3)在“产品开发”——“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,可以查看Topic权限和用途等信息。从图中可以看到直连设备上报属性的topic与步骤(2)中topic一致。
二、属性上报
其中,与直连设备属性上报相关的topic,如表所示。其中{pid}用产品ID替换,{device-name}用设备名称替换。设备模拟器--实验步骤(4)单击“属性”标签,可以查看此时该设备湿度属性下已经新增了属性值60,时间与属性上报时间一致。
设备模拟器--实验步骤(5)属性上报支持单个属性值的上报和多个属性值的同时上报。在“设备调试”——“属性上报”页面,勾选已经配置的多个功能点,按照要求填写参数,单击“属性上报”。右侧调试日志中显示如图所示的多个属性值上报和平台响应两部分内容。与单个属性值上报相比,主要差异在于params参数值的设置,其余参数规则相似。单击“属性”标签,可以查看此时该设备湿度和温度属性下已经新增了属性值,时间与属性上报时间一致。
设备模拟器--实验步骤三、属性期望值获取
在平台设置属性期望值信息后,平台更新属性期望值。当设备在线后,可以主动获取属性期望值。
(1)在“设备调试”——“设备模拟器”——“属性期望值获取”页面,勾选已经配置的功能点,单击“属性期望值获取”。
设备模拟器--实验步骤(2)右侧调试日志中显示如图所示的属性期望获取和平台响应两部分内容,格式为JSON格式。
属性期望获取的信息包含以下几部分:title:属性期望获取;
timestamp:表示发送属性期望获取的消息时间;
message:表示属性上报信息,具体又包括topic(属性期望获取的主题)、data(具体信息:id、version、params)。图中,id为用户自定义消息id号;version为物模型版本号;params为请求参数,包含标识符为Hum和temp的两个属性。三、属性期望值获取
设备模拟器--实验步骤平台响应的信息包含以下几部分:title:收到平台响应;timestamp:表示接收到平台响应的时间;message:表示平台响应具体信息,包括topic(平台响应的主题)、data(响应具体信息:msg、code、data、id)。图中,msg给出具体响应结果,success表示属性期望值获取成功;code为响应代码,200为属性上报成功;data为返回的期望值信息,若未在云端设置过该属性的期望值,或期望值属性被清空,返回对象中不包含该属性的标识符;id为用户自定义消息id号,与属性上报的id一致,表示云平台收到该条属性上报的消息。Hum属性期望值为50,temp属性期望值为25。三、属性期望值获取
设备模拟器--实验步骤(3)在“产品开发”——“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,可以查看Topic权限和用途等信息。从图3-30中可以看到直连设备上报属性的topic与步骤(2)中topic一致。
三、属性期望值获取
其中,与直连设备期望值相关的topic,如表所示。设备模拟器--实验步骤在物模型中,事件是设备运行时可以被触发的上行消息,与属性在功能定位上不同。使用设备模拟器也可以进行事件上报的模拟操作,具体步骤如下。(1)在“设备调试”——“设备模拟器”——“事件上报”页面,选择已建立的事件“高温预警”,并在出现的输出参数中按照定义规则填写参数信息。四、事件上报设备模拟器--实验步骤(2)右侧调试日志中显示如图所示的事件上报和平台响应两部分内容,格式为JSON格式。事件上报的信息包含以下几部分:title:事件上报;timestamp:表示事件上报时间;
message:表示事件上报信息,具体又包括topic(事件上报的主题)、data(事件具体信息:id、version、params)。图中,id为用户自定义消息id号;version为物模型版本号;params为请求参数,包含事件标识符、参数值。四、事件上报设备模拟器--实验步骤平台响应的信息包含以下几部分:title:收到平台响应;timestamp:表示接收到平台响应的时间;message:表示平台响应具体信息,包括topic(平台响应的主题)、data(响应具体信息:id、code、msg)。图3-32中,id为用户自定义消息id号,与事件上报的id一致,表示云平台收到该事件上报的消息;code为响应代码,200为事件上报成功;msg给出具体响应结果,success表示事件上报成功;如果上报失败会有具体的错误代码和错误信息。
四、事件上报设备模拟器--实验步骤(3)在“产品开发”——“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,可以查看Topic权限和用途等信息。从图中可以看到直连设备上报属性的topic与步骤(2)中topic一致。
四、事件上报其中,与直连设备事件上报相关的topic,如表所示。
其中{pid}用产品ID替换,{device-name}用设备名称替换。
设备模拟器--实验步骤(4)单击“事件记录”标签,可以查看此时该设备下已经新增了一条功能名称为高温预警的事件记录,类型为告警,输出参数为Temperature值为80。四、事件上报设备模拟器--实验步骤PART0404
第四部分
应用模拟器应用模拟器--实验步骤【实验目的】
(1)掌握基于物模型的MQTT应用模拟器的方法。
(2)掌握整个流程中各类信息的解读。
【实验设备】
(1)一台PC,可连接Internet。
【实验要求】
基于物模型的行业开发,不仅可以模拟设备接入,也可以进行应用模拟。在实验一创建的产品和设备下,进行虚拟设备调试,采用应用模拟器实现属性设置、属性获取、属性期望值设置和服务调用。
一、虚拟设备登录
(1)进入OneNET开发者中心,单击“设备接入管理”——“设备管理”,单击实验一创建的设备所对应的“详情”按键。
(2)单击“设备调试”,在调试页面中单击“启动调试”,实现虚拟设备登录。
二、属性设置
与属性上报不同,属性设置是从应用模拟器向设备发送设置指令,具体操作如下。
(1)进入OneNET开发者中心,单击“设备接入管理”——“设备管理”,单击实验一创建的设备所对应的“详情”按键。
(2)单击“设备调试”,在调试页面中单击“启动调试”,实现虚拟设备登录。
(3)在如图所示的“应用模拟器”——“属性设置”页面中,勾选两个功能点,并填写属性值,单击属性设置。
应用模拟器--实验步骤一、虚拟设备登录
二、属性设置
应用模拟器--实验步骤(4)右侧调试日志中显示如图所示的属性设置和平台响应两部分内容,格式为JSON格式。
属性设置的信息包含以下几部分:
title:属性设置;
message:表示属性设置信息,具体又包括product_id(产品id)、device_name(设备名称)、imei(国际移动设备识别码)、params(请求参数)。Hum属性设置为48,temp属性设置为18。
timestamp:表示属性设置时间;
应用模拟器--实验步骤响应结果的信息包含以下几部分:
title:响应结果,表示收到设备响应;
message:表示平台响应具体信息,包括code(执行该操作后的反馈码)、data(执行操作后返回的业务数据)、request_id(请求id)、msg(执行操作后,返回的信息)。图中,data包含code、data和msg分别表示设备端给出的响应结果。表示属性设置成功。
timestamp:表示接收到响应的时间;
应用模拟器--实验步骤(5)查询“物模型topic”,与设置直连设备属性相关的topic,如表所示。应用模拟器--实验步骤(6)单击“操作记录”标签,可以查看此时该设备下已经新增了一条“写”操作。
单击“详情”,可以在图中看到操作的具体详情,包括属性设置的输入参数和设备端给出的反馈。(7)属性获取三、属性期望值设置
(1)在如图所示的在“应用模拟器”——“属性期望值设置”页面中,勾选两个功能点,并填写属性期望值,单击属性期望值设置。
应用模拟器--实验步骤三、属性期望值设置
属性期望值设置的信息包含以下几部分:
title:属性期望值设置;
message:表示属性期望值设置信息,具体又包括product_id(产品id)、device_name(设备名称)、imei(国际移动设备识别码)、params(请求参数)。Hum属性期望值设置为70,temp属性期望值设置为50。
timestamp:表示属性期望值设置时间;应用模拟器--实验步骤应用模拟器--实验步骤三、属性期望值设置
响应结果的信息包含以下几部分:
title:响应结果,表示收到设备响应;
message:表示平台响应具体信息,包括code(执行该操作后的反馈码)、data(执行操作后返回的业务数据)、request_id(请求id)、msg(执行操作后,返回的信息)。data包含code、data和msg分别表示设备端给出的响应结果。下图表示属性期望值设置成功。
timestamp:表示接收到响应的时间;应用模拟器--实验步骤三、属性期望值设置
(3)在“设备模拟器”——“属性期望值获取”页面中,勾选功能点,单击“属性期望值获取”,可以查询到设置的属性期望值信息。四、服务调用
(1)在如图所示的“应用模拟器”——“服务调用”页面中,选择实验一新建的服务,并填写输入参数,单击“服务调用”。
应用模拟器--实验步骤物联网平台支持同步调用和异步调用,同步调用超时时间10s,异步调用需在24小时内回复。四、服务调用
应用模拟器--实验步骤(2)右侧调试日志中显示如图所示的服务调用和平台响应两部分内容,格式为JSON格式。
服务调用的信息包含以下几部分:
title:服务调用;
message:表示服务调用信息,具体又包括product_id(产品id)、device_name(设备名称)、identifier(标识码)、params(请求参数)、imei(国际移动设备识别码)。图中,对设备的输入参数为SW设为1。
timestamp:表示服务调用时间;四、服务调用
应用模拟器--实验步骤响应结果的信息包含以下几部分:
title:响应结果,表示收到设备响应;
message:表示平台响应具体信息,包括code(执行该操作后的反馈码)、data(执行操作后返回的业务数据)、msg(执行操作后,返回的信息)、request_id(请求id)。图表示成功调用服务;
timestamp:表示接收到响应的时间;(3)查询“物模型topic”,与平台调用直连设备服务相关的topic,如表所示。
应用模拟器--实验步骤(4)单击“服务记录”标签,可以查看此时该设备下已经新增了一条“风扇控制”的服务记录。应用模拟器--实验步骤单击“详情”,可以在图中看到服务记录的具体详情。
物联网云平台开发实践(第2版)谢谢您的观看!Thankyou!基于模拟器的MQTT协议调试物联网云平台开发实践(第2版)目录CONTENTS01属性上报02属性设置03事件上报04服务调用
第一部分
属性上报PART0101实验介绍【实验目的】(1)掌握MQTT协议属性上报的流程和作用。(2)掌握整个流程中各类信息的解读。【实验设备】(1)一台PC,可连接Internet。(2)MQTT.fx软件。【实验要求】在任务一实验一创建的数据格式为OneJson的设备下,设置物模型,自定义名称为温度和湿度的两个属性功能点,采用MQTT.fx软件实现设备属性上报。采用OneJson格式实现远程设备的信息监测,主要通过属性上报来实现。属性是指设备支持的可读或可设置的参数功能,一般用于描述设备运行时的状态,用户也可通过设置的请求方式来更改设备的运行状态。在远程监测这类实际应用中,可以通过属性上报来实现。实验步骤一、建立连接(1)打开MQTT.fx客户端,进入客户端配置页面。(2)设置参数如下:接入地址:。端口:8883。ClientID:填写设备名称。Username:填写产品ID。Password:填写计算得到的token。SSL/TLS选项卡:在该选项卡内进行加密设置。勾选EnableSSL/TLS,Protocol选择TLSv1.2,选择CAcertificatefile选项,导入证书。(3)设置完毕,单击OK按钮。(4)在MQTT.fx客户端首页中,选择localmosquitto,单击Connect按钮进行连接。在连接后,确认设备的在线状态。(5)在OneNET平台“设备管理”页面中,会显示设备在线状态。实验步骤二、查询物模型topic在“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,可以查看Topic权限和用途等信息。其中,与直连设备属性上报相关的topic。topic用途订阅发布$sys/{pid}/{device-name}/thing/property/post直连设备上报属性
√$sys/{pid}/{device-name}/thing/property/post/reply直连设备上报属性响应√其中{pid}用产品ID替换,{device-name}用设备名称替换。实验步骤三、订阅主题如图3-47所示,在成功连接后,打开MQTT.fx端首页,单击上面的Subscribe按钮,订阅如下主题:$sys/{pid}/{device-name}/thing/property/post/reply当直连设备上报属性后,MQTT.fx软件可以收到对应的响应消息。实验步骤四、属性上报在MQTT.fx客户端首页单击Publish按钮,输入$sys/{pid}/{device-name}/thing/property/post,输入OneJson请求数据,并单击输入框后面的Publish按钮。实验步骤五、结果查询打开OneNET平台,单击“设备管理”,进入“属性”页面,可以看到功能名称为“温度”的属性新增了数据25,功能名称为“湿度”的属性值为46。PART0202
第二部分
属性设置【实验目的】
(1)掌握MQTT协议属性设置的流程和作用。
(2)掌握整个流程中各类信息的解读。
【实验设备】
(1)一台PC,可连接Internet。
(2)MQTT.fx软件。
【实验要求】
采用OneJson格式实现设备的远程控制,可以通过设置该设备的属性并下发来实现,例如,仓储环境根据不同的存储物品要求,远程设置环境温度阈值,终端设备根据目标温度阈值和当前实际温度,控制风扇等设备工作,使环境温度达到目标值。在实验一创建的数据格式为OneJson的设备下,进行设备调试设置属性参数,并采用MQTT.fx软件接收云平台下发的属性设置命令。属性设置属性上报一、建立连接
(1)打开MQTT.fx客户端,进入客户端配置页面。
(2)设置参数如下:
接入地址:。
端口:8883。
ClientID:填写设备名称。
Username:填写产品ID。
Password:填写计算得到的token。
SSL/TLS选项卡:在该选项卡内进行加密设置。勾选EnableSSL/TLS,Protocol选择TLSv1.2,选择CAcertificatefile选项,导入证书。
(3)设置完毕,单击OK按钮。
(4)在MQTT.fx客户端首页中,选择localmosquitto,单击Connect按钮进行连接。在连接后,确认设备的在线状态。
(5)在OneNET平台“设备管理”页面中,会显示设备在线状态。
属性设置二、查询物模型topic在“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,其中,与直连设备属性设置相关的topic。属性设置三、订阅主题在成功连接后,打开MQTT.fx端首页,单击上面的Subscribe按钮,订阅如下主题:$sys/{pid}/{device-name}/thing/property/set当云平台下发修改直连设备属性的消息后,MQTT.fx软件可以收到对应的响应消息。属性设置四、下发属性设置命令
在“应用模拟器”——“属性设置”页面中,勾选功能点“湿度”,并填写属性值,单击属性设置。
在MQTT.fx软件中,可以看到已经接收到云平台发送的消息。参数为{“temp”:30},表示属性名称为temp,具体属性值设置为30。属性设置五、发布“属性设置响应”
当收到来自云平台的属性设置命令后,在MQTT.fx客户端首页单击Publish按钮,输入$sys/{pid}/{device-name}/thing/property/set_reply,输入OneJson请求数据,并单击输入框后面的Publish按钮。
{"id":"2","code":200,
"msg":“success”}PART0303
第三部分
事件上报【实验目的】
(1)掌握MQTT协议事件上报的流程和作用。
(2)掌握整个流程中各类信息的解读。
【实验设备】
(1)一台PC,可连接Internet。
(2)MQTT.fx软件。
【实验要求】
物模型基本功能有一类是事件,这类功能是指当设备运行过程中,触发设定条件后,产生上行消息。如设备运行过程中,温度超过预设值,认为设备异常,此时发出的告警、故障信息等就是事件。事件可包含多个输出参数。
在实验一创建的数据格式为OneJson的设备下,查找自定义名称为“高温预警”的事件功能点,采用MQTT.fx软件实现设备事件上报。事件上报一、建立连接
(1)打开MQTT.fx客户端,进入客户端配置页面。
(2)设置参数如下:
接入地址:。
端口:8883。
ClientID:填写设备名称。
Username:填写产品ID。
Password:填写计算得到的token。
SSL/TLS选项卡:在该选项卡内进行加密设置。勾选EnableSSL/TLS,Protocol选择TLSv1.2,选择CAcertificatefile选项,导入证书。
(3)设置完毕,单击OK按钮。
(4)在MQTT.fx客户端首页中,选择localmosquitto,单击Connect按钮进行连接。在连接后,确认设备的在线状态。
(5)在OneNET平台“设备管理”页面中,会显示设备在线状态。
事件上报事件上报二、查询物模型topic在“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,查看Topic权限和用途等信息。其中,与直连设备上报事件相关的topic。事件上报三、订阅主题在成功连接后,打开MQTT.fx端首页,单击上面的Subscribe按钮,订阅如下主题:
$sys/{pid}/{device-name}/thing/event/post/reply当直连设备上报事件后,MQTT.fx软件可以收到对应的响应消息。事件上报四、事件上报在MQTT.fx客户端首页单击Publish按钮,输入$sys/{pid}/{device-name}/thing/event/post,输入OneJson请求数据,并单击输入框后面的Publish按钮。
事件上报具体请求参数说明如表所示。事件上报五、结果查询
打开OneNET平台,单击“设备管理”,进入“事件记录”页面,可以看到功能名称为“高温预警”功能点新增了一条告警事件,输出参数为{“Temperature”:82}。
打开MQTT.fx端首页,单击上面的Subscribe按钮,可以看到事件上传的响应结果PART0404
第四部分
服务调用【实验目的】
(1)掌握MQTT协议服务调用的流程和作用。
(2)掌握整个流程中各类信息的解读。
【实验设备】
(1)一台PC,可连接Internet。
(2)MQTT.fx软件。
【实验要求】
物模型基本功能有一类是服务,这类功能是指终端设备被外部调用的能力,可设置输入参数和输出参数。在实验一创建的数据格式为OneJson的设备下,查找功能名称为“风扇控制”的服务功能点,采用MQTT.fx软件实现服务调用。服务调用/doc/v5/fuse/detail/903一、建立连接
(1)打开MQTT.fx客户端,进入客户端配置页面。
(2)设置参数如下:
接入地址:。
端口:8883。
ClientID:填写设备名称。
Username:填写产品ID。
Password:填写计算得到的token。
SSL/TLS选项卡:在该选项卡内进行加密设置。勾选EnableSSL/TLS,Protocol选择TLSv1.2,选择CAcertificatefile选项,导入证书。
(3)设置完毕,单击OK按钮。
(4)在MQTT.fx客户端首页中,选择localmosquitto,单击Connect按钮进行连接。在连接后,确认设备的在线状态。
(5)在OneNET平台“设备管理”页面中,会显示设备在线状态。
服务调用服务调用二、查询物模型topic在“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,查看Topic权限和用途等信息。其中,与平台调用直连设备服务相关的topic。
其中{pid}用产品ID替换,{device-name}用设备名称替换,{identifier}用功能点唯一标识符替换。
服务调用二、查询物模型topic其中{pid}用产品ID替换,{device-name}用设备名称替换,{identifier}用功能点唯一标识符替换。
服务调用三、订阅主题
在成功连接后,打开MQTT.fx端首页,单击上面的Subscribe按钮,订阅如下主题:
$sys/{pid}/{device-name}/thing/service/{identifier}/invoke当平台调用直连设备的服务后,MQTT.fx软件可以收到对应的响应消息。
四、服务调用
在“应用模拟器”——“服务调用”页面中,选择任务一新建的服务,并填写输入参数,此处调用“风扇控制”,发送开关指令1,单击“服务调用”。服务调用五、结果查询
在MQTT.fx软件中,可以查看到如图所示的结果,表明软件模拟的终端设备已经接收到了云平台下发的服务指令,开关参数SW,参数的具体值为1。
服务调用OneNET平台,单击“服务记录”标签,可以查看此时该设备下已经新增了一条“风扇控制”的服务记录。如果没有设备订阅该主题,“服务记录”内可以查看到示的错误信息,错误代码为1022,表示订阅不存在。
六、发送反馈在MQTT.fx软件中,输入如下主题,单击Publish按钮:
$sys/{pid}/{device-name}/thing/service/{identifier}/invoke_reply其中{pid}用产品ID替换,{device-name}用设备名称替换,{identifier}用功能点唯一标识符替换,在OneNET平台可以看到对应的调试结果。服务调用物联网云平台开发实践(第2版)谢谢您的观看!Thankyou!基于python的MQTT协议物联网云平台开发实践(第2版)01属性上报目录CONTENTS02属性设置03事件上报04服务调用属性上报(Upload-para)PART0101【实验目的】
(1)掌握使用MQTT协议基于物模型进行属性上报的Python移植方法。
(2)掌握Python的常用命令及代码解读。
【实验设备】
(1)一台PC,可连接Internet。
(2)Python软件、Pycharm编程环境。
【实验要求】
在任务一实验一创建的数据格式为OneJson的设备下,基于物模型中温度和湿度两个属性功能点,采用Python编程实现设备属性上报。
属性上报属性上报二、属性上报
1.选择topic属性上报需要找到对应的系统topic,在模拟器进行调试的过程中,已经查阅过相关topic,发布数据采用如下topic:
$sys/{pid}/{device-name}/thing/property/post
2.构建上报的属性数据流
属性上报的采用JSON数据流格式,以上报属性值num至功能点temp、上报属性值num1至功能点Hum
为例,构建如下数据流:一、建立连接
按照上述步骤,建立客户端与服务器的连接,并通过回调函数打印连接结果。{"id":"124","version":"1.0","params":{"temp":{"value":25.5},"Hum":{"value":60}}}属性上报3.属性上报
调用如下函数,实现属性上报:publish(topic,payload,qos,retain)该函数包含4个参数,需要重点设置前3项参数。
topic:表示发布信息的主题。
payload:表示要发布的具体信息。
qos:表示服务质量,分别为0、1、2三种级别。
示例代码如下:
client.publish(pub_topic,json.dumps(body),qos=0)属性上报import…
#定义token计算函数
deftoken(product_id,access_key,auth_info=None)…
#定义回调函数
defon_connect(client,userdata,flags,reason_code,properties):
print(f"Connected!Result:{mqtt.connack_string(reason_code)}(Code:{reason_code})")
if__name__=='__main__':
host='6'
port=8883
access_key=‘xxxxx'#devicekey
auth_info=‘xxxxxxxx'#client_id
product_id=‘xxxxxxxx'#username
#计算token
api_token=token(product_id,access_key,auth_info)
print(api_token)
#client=mqtt.Client(client_id=auth_info,protocol=mqtt.MQTTv311)
client=mqtt.Client(
client_id=auth_info,
protocol=mqtt.MQTTv311,
callback_api_version=mqtt.CallbackAPIVersion.VERSION2
)
client.on_connect=on_connect
client.tls_set(ca_certs='serverCert.pem',cert_reqs=CERT_REQUIRED)
client.tls_insecure_set(True)
client.username_pw_set(username=product_id,password=api_token)
client.connect(host=host,port=port,keepalive=30)
client.loop_start()whileTrue:
num=22
num1=56
body={
"id":"124",
"version":"1.0",
"params":{
"temperature":{
"value":num
},
"humidity":{
"value":num1
}
}
}
pub_topic='$sys/%s/%s/thing/property/post'%(product_id,auth_info)
print(pub_topic)
print('fp:temperature->%s'%num)
print('fp:humidity->%s'%num1)
client.publish(pub_topic,json.dumps(body),qos=0)
time.sleep(5)onejson—属性上报import…
#定义token计算函数
deftoken(product_id,access_key,auth_info=None):
…
defon_connect(client,userdata,flags,reason_code,properties):
print(mqtt.connack_string(reason_code)+'rc:%s'%reason_code)
if__name__=='__main__':
host='6'
port=8883
access_key=‘xxxx'#devicekey
auth_info=‘xxxx'#设备名称
product_id=‘xxxx'#产品id
#计算token
api_token=token(product_id,access_key,auth_info)
print(api_token)
client=mqtt.Client(
client_id=auth_info,
protocol=mqtt.MQTTv311,
callback_api_version=mqtt.CallbackAPIVersion.VERSION2
)
client.on_connect=on_connect
client.on_message=on_message
client.tls_set(ca_certs='serverCert.pem',cert_reqs=CERT_REQUIRED)
client.tls_insecure_set(True)
client.username_pw_set(username=product_id,password=api_token)
client.connect(host=host,port=port,keepalive=30)
client.loop_start()whileTrue:
time.sleep(1)
num=20
body={
"id":123,
"dp":{
"temperature":[{
"v":num,
}]
}
}
pub_topic='$sys/%s/%s/dp/post/json'%(product_id,auth_info)
print(pub_topic)
print('dp:temperature->%s'%num)
client.publish(pub_topic,json.dumps(body),qos=0)
time.sleep(30)
body={
"id":"124",
"version":"1.0",
"params":{
"temperature":{
"value":num
},
"humidity":{
"value":num1
}
}
}数据流--发布信息pub_topic='$sys/%s/%s/thing/property/post'%(product_id,auth_info)第一条信息表示token,第二条信息表示发布数据的系统topic,第三、四条信息表示功能点标识符和属性值,第五条信息表示连接成功。进入OneNET平台,在“设备接入管理”页面中,选择设备管理,并单击该设备对应的“属性”,即可看到上报的属性。
属性上报res=products/O1wlcBxQXO/devices/HT&sign=bv5pA9xhmwmz9kUgpnKyFpgIsBY%3D&et=1712736146&method=sha1&version=2018-10-31$sys/O1wlcBxQXO/HT/thing/property/postfp:temp->22fp:Hum->56ConnectionAccepted.rc:0属性设置get_setget_settingPART0202【实验目的】
(1)掌握使用MQTT协议基于物模型接收云平台属性设置的Python移植方法。
(2)掌握Python的常用命令及代码解读。
【实验设备】
(1)一台PC,可连接Internet。
(2)Python软件、Pycharm编程环境。
【实验要求】
在任务一实验一创建的数据格式为OneJson的设备下,采用Python编程接收云平台对物模型中“温度”功能点的属性设置指令,并打印“TemperatureSetting:”和接收到的设置值;当收到的“湿度”功能点的属性设置指令,打印“HumiditySetting:”和接收到的设置值;当收到其他信息,打印“Error”。
属性设置一、建立连接
按照上述步骤,建立客户端与服务器的连接,并通过回调函数打印连接结果。
二、查询物模型topic在“设备开发”页面,单击“Topic管理”,再单击“物模型topic”,其中,与直连设备属性设置相关的topic。
三、订阅主题
1.选择topic为了能在底层程序端接收云平台属性设置的指令,可订阅如下topic:
$sys/{pid}/{device-name}/thing/property/set
上述topic表示接收系统“属性设置”指令。
2.订阅topic
调用如下函数,实现订阅主题:
subscribe(topic,qos)该函数包含两个参数,如下所述。
topic:表示订阅的主题。
qos:表示服务质量,分别为0、1、2三种级别。
示例代码如下:
client.subscribe('$sys/%s/%s/thing/property/set'%(product_id,auth_info),qos=0)属性设置四、定义消息回调函数
在收到客户端订阅主题的消息后,通常会调用on_message()函数来打印接收到的反馈信息。
client.on_message=on_message
在调用前,会对该函数的具体执行内容进行定义,部分代码如下:defon_message(client,userdata,msg):print('ON_MESSAGE:'+msg.topic+"",msg.payload)
上述代码表示接收到订阅主题推送的消息后,打印消息的主题和内容。属性设置get_setif__name__=='__main__':
host='6'
port=8883
access_key='xxxxxx'#devicekey
auth_info=‘xxxxx'#client_id
product_id='xxxxx'#username
#计算token
api_token=token(product_id,access_key,auth_info)
print(api_token)
#client=mqtt.Client(client_id=auth_info,protocol=mqtt.MQTTv311)
client=mqtt.Client(
client_id=auth_info,
protocol=mqtt.MQTTv311,
callback_api_version=mqtt.CallbackAPIVersion.VERSION2
)
client.on_connect=on_connect
client.on_message=on_message
client.tls_set(ca_certs='serverCert.pem',cert_reqs=CERT_REQUIRED)
client.tls_insecure_set(True)
client.username_pw_set(username=product_id,password=api_token)
client.connect(host=host,port=port,keepalive=30)
client.loop_start()
whileTrue:
time.sleep(1)import…
#定义token计算函数
deftoken(product_id,access_key,auth_info=None)…#定义回调函数
defon_connect(client,userdata,flags,reason_code,properties):…defon_message(client,userdata,msg):
print('ON_MESSAGE:'+msg.topic+"",msg.payload)
if'$sys/%s/%s/thing/property/set'%(product_id,auth_info)inmsg.topic:
msg1=str(msg.payload)
msg2=json.loads(msg1[2:-1])
params=msg2.get("params")
key=list(params.keys())
value=params.get(key[0])
ifkey[0]=="temperature":
print("temperatureSetting:",value)
elifkey[0]=="humidity":
print("humiditySetting:",value)
else:
print("Error")
time.sleep(5)
运行上述代码,从OneNET云平台应用模拟器中选取功能点“温度”,属性设置值设为30,单击属性设置,得到如下运行结果:
第一条信息表示token,第二条信息表示连接成功,第三条信息表示收到的平台下发的内容,具体包括topic和具体平台下发的内容,表示属性名称为temp、具体的属性设置值为30,第四条表示属性设置响应的topic,第五条是属性设置的响应消息,第六条表示根据接收到的属性设置值,软件端按照功能要求执行的操作具体内容,此处可以根据打开灯、打开风扇等具体功能要求进行个性化定义。
属性设置get_setting运行结果res=products/O1wlcBxQXO/devices/HT&sign=MD2adLGB102WbLLY11fO%2BKkeXw0%3D&et=1713002009&method=sha1&version=2018-10-31ConnectionAccepted.rc:0ON_MESSAGE:$sys/O1wlcBxQXO/HT/thing/property/setb'{"id":"1","version":"1.0","params":{"temp":30}}'TemperatureSetting:30从OneNET云平台应用模拟器中选取功能点“湿度”,属性设置值设为25,单击属性设置,得到如下运行结果:
第一条信息表示收到的平台下发的内容,具体包括topic和具体平台下发的内容,表示属性名称为Hum、具体的属性设置值为25,第二条表示属性设置响应的topic,第三条表示属性设置的响应消息,第四条表示根据接收到的属性设置值,软件端按照功能要求执行的操作具体内容,此处可以根据打开灯、打开风扇等具体功能要求进行个性化定义。属性设置get_setting运行结果ON_MESSAGE:$sys/O1wlcBxQXO/HT/thing/property/setb'{"id":"2","version":"1.0","params":{"Hum":25}}'HumiditySetting:25事件上报upload_thPART0303【实验目的】
(1)掌握使用MQTT协议基于物模型进行事件上报的Python移植方法。
(2)掌握Python的常用命令及代码解读。
【实验设备】
(1)一台PC,可连接Internet。
(2)Python软件、Pycharm编程环境。
【实验要求】
在任务一实验一创建的数据格式为OneJson的设备下,进行高温事件的上报。
事件上报一、建立连接
按照上述步骤,建立客户端与服务器的连接,并通过回调函数打印连接结果。
事件上报二、事件上报
1.选择topic
事件上报需要找到对应的系统topic,在模拟器进行调试的过程中,已经查阅过相关topic,发布数据采用如下topic:
$sys/{pid}/{device-name}/thing/event/post2.构建上报的事件数据流
事件上报的采用JSON数据流格式,以上报高温事件为例,按照上传事件至功能点“heat”,参数“Temperature”的值为90,构建如下数据流:
事件上报3.事件上报
调用如下函数,实现属性上报:
4.订阅反馈
订阅上报事件响应主题,当云平台收到上报的事件后,向客户端发送反馈,客户端订阅相关主题后,可以收到反馈信息。示例代码如下:
client.subscribe('$sys/%s/%s/thing/event/post/reply'%(product_id,auth_info),qos=0)publish(topic,payload,qos,retain)import…
#定义token计算函数
deftoken(product_id,access_key,auth_info=None)…
#定义回调函数
defon_connect(client,userdata,flags,rc):
#打印连接状态
print(mqtt.connack_string(rc)+'rc:%s'%rc)
ifrc==0:
client.subscribe('$sys/%s/%s/thing/event/post/reply'%(product_id,auth_info),qos=0)
defon_message(client,userdata,msg):
print('ON_MESSAGE:'+msg.topic+"",msg.payload)
if__name__=='__main__':
host='6'
port=8883
access_key='RFFOamJDYTY2eEYwWWRyejY5R1ZFTU5YQWVwY01jUDI='#devicekey
auth_info='HT'#client_id
product_id='O1wlcBxQXO'#username
#计算token
api_token=token(product_id,access_key,auth_info)
print(api_token)
client=mqtt.Client(client_id=auth_info,protocol=mqtt.MQTTv311)
client.on_connect=on_connect
client.on_message=on_message
client.tls_set(ca_certs='serverCert.pem',cert_reqs=CERT_REQUIRED)
client.tls_insecure_set(True)
client.username_pw_set(username=product_id,password=api_token)
client.connect(host=host,port=port,keepalive=30)
client.loop_start()
whileTrue:
body={
"id":"123",
"params":{
"heat":{
"value":{
“temperature":90
}
}
}
}
pub_topic='$sys/%s/%s/thing/event/post'%(product_id,auth_info)
print(pub_topic)
print('Heat:alarm')
client.publish(pub_topic,json.dumps(body),qos=0)
time.sleep(50)运行上述代码,得到如下运行结果:第一条信息表示token,第二条信息表示上报事件的系统topic,
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 伤口愈合不良护理
- 江西省鹰潭市2026-2027学年高三六校第一次联考高考物理试卷(含答案解析)
- 安徽省马鞍山市2026-2027学年高三六校第一次联考高考物理试卷(含答案解析)
- 十五五规划前瞻:智慧储能云平台作为新型基础设施的战略地位
- 中东市场机遇:智能出行装备在高温极端环境下的产品适配与拓展
- 抢占心智空白 SaaS企业赛道 2026年中国SaaS企业服务创业计划融资计划
- 养老行业落地:智能止鼾仪嵌入居家养老体系的成本效益深度测算
- 浙江省衢州市五校联考2026-2027学年高二上学期11月期中考试生物试卷
- DKBA04500040-C钣金冲压件质量要求
- 2026年金属废料回收处理技术报告
- 2026年餐饮管理专业知识结构评估试题及答案
- 2026年医疗卫生公基考试题库(附答案)
- 2026初中数学教师课标考试模拟试卷附参考答案三套
- 非法营运案例课件
- 2026年土建主管考试题库及答案
- 理性上网辨别网络谣言 大学生网络文明课件
- 2026-2027学年教科版四年级上册科学第一单元《空气》单元素养测评卷含答案
- 2026全国版图知识竞赛(小学组)历年参考题库含答案详解
- 2025年政府采购框架协议题库(含答案)
- 教育学原理 第二版 课件 第10章 教育科学研究
- 不明原因肺炎病例监测、排查和管理方案2025年修订版
评论
0/150
提交评论