Step2. 功能定义

更新时间：2018-02-07 09:50:05

概述

物联网将物理世界的万物接入网络并通过整合各类服务实现智能化，“物”（Things）作为整个网络中的基础节点和商业触手，既是环境信息的采集者，也是智能服务的提供者和承载者。因此，我们首先需要对物联网中的“物”能做什么，能提供什么样的服务进行描述，这就需要开发者从产品层面进行功能建模，定义物的“属性”（Property）、“服务”（Service）和“事件”（Event）。通过功能建模将各类设备统一抽象为云端的资源，并对外暴露相应的接口，以满足不同场景下不同系统的调用和快速集成。

如何理解物模型
物模型是对设备是什么，能做什么的描述，包括设备身份标识、连接状态、描述信息，以及设备的属性、服务、事件，后三者构成了设备的功能定义。飞凤平台通过定义一种物的描述语言来描述物模型，称之为 TSL（即 Thing Specification Language）。

物模型包括属性、服务和事件，构成了平台中设备的功能：

属性 Property	一般用于描述设备运行时的状态，如环境监测设备所读取的当前环境温度等。属性支持get和set，应用系统可发起对属性的读取和设置请求。
服务 Service	设备可被外部调用的能力或方法，包含输入参数和输出参数，相比于下发指令设置属性值，服务可通过一条指令实现更复杂的业务逻辑，如执行某项特定的任务；
事件 Event	设备运行时的事件，相比于属性状态，事件一般而言包含设备需要被外部感知和处理的通知信息，可包含多个输出参数，如某项任务完成的信息或者设备发生故障/告警时的温度等，事件可以被订阅和推送。

飞凤平台中已经按照不同的领域和行业分类，定义了标准品类的物模型，创建产品时系统已根据您选择的“所属分类”自动创建了该产品的标准功能，您可以直接使用并开始设备的固件开发工作，也可以根据实际需要添加自定义的功能。功能定义完成后，平台将自动生成 JSON 格式的 TSL，您可以结合 Alink 协议组装上报设备的数据。

标准功能

标准功能列表
在产品的详情页面，默认显示“功能定义”标签页，系统已经自动为您创建了该类型产品必选的标准功能，您可以点击“编辑”对标准功能的相关参数进行修改，或者点击“新增”查看该类设备的可选功能。

必选功能 VS 可选功能

必选功能是产品所属品类的最小功能集合，代表了该品类设备必不可少的功能，您可以根据需要进行相应的调整和编辑，例如一款环境监测盒子，具有“温度”、“湿度”等必备功能，必选功能不可删除；
可选功能是产品所属品类的推荐功能集合，即每个厂商对于相同类型的设备的功能存在差异，系统将为您自动推荐适合该品类设备的相关功能，例如部分环境监测盒子，具有“地理位置”的可选功能，您可以直接选择——编辑——完成创建，可选功能可以删除；

新增标准功能
点击标准功能列表上的“新增”按钮，弹窗将显示系统推荐的该产品的可选功能，您可以按照需要直接选择，点击“确定”后列表中将出现该可选功能。

选择其他类型的标准功能
如果您正在创建的是一款创新型产品，功能上可能是多种类型的组态，您可以点击“其他类型”，从标准功能库中搜索适合的功能直接选择添加。例如一款环境监测设备同时可监测植物的生长状态，您可以在“其他类型”中搜索“植物生长”，添加相应的功能。

编辑标准功能
标准功能已经为您提供了该功能的默认参数，您可以根据需要进行调整，在列表中选择要调整的标准功能，点击“编辑”按钮，在弹窗中编辑参数项。请注意，您无法修改标准功能的类型、标识符、数据类型和读写类型等默认字段。

自定义功能

如果标准功能无法满足您的需求，您也可以根据实际需要，添加自定义功能。点击列表上方的“新增”按钮，在弹窗中创建产品的自定义功能，支持分别创建属性、服务和事件。

添加自定义属性
自定义属性的数据类型包括：整型、浮点、枚举、布尔、字符串、时间型（UTC格式）、JSON对象（结构体）。

添加自定义服务
服务支持添加入参和出参，点击“新增输入参数”，在弹窗中添加服务的输入/输出参数，您可以选择将产品下的某个属性直接作为参数，也可以完全自定义一个新的参数。

请注意，单个服务最多可分别添加10个入参或10个出参。

添加自定义事件
事件分为三种类型：“信息”、“告警”和“故障”，“信息”是设备上报的一般性通知，如完成某项任务等，“告警”和“故障”是设备运行过程中主动上报的突发或异常情况，优先级更高。事件由设备主动上报，设备可以携带该事件的相关参数进行输出，如设备上报了一个“过热”的告警事件，并携带了设备的当前温度。