trainingbook中文版-8.fae培训-模板和oem流程templatesand

Oem_Id:

Model_Id:

DSN:

OTA:Ayla给设备生产厂家的唯一

生产设备厂家某款产品的唯一嵌入Ayla程序的设备的唯一Over

the

Air

空中升级，

升级用户处理器和WIFI模组的固件Copyright

©

2015

Ayla

NetworksCopyright

©

2015

Ayla

Networks

模板介绍

制造流程-黑盒-白盒Copyright

©

2015

Ayla

Networks模板介绍模板？模板是设备虚拟化的数据结构。由多个属性组成，类似C语言的结构体

一组属性

一组触发器

一组排程

方式的设定

LAN模式的设定Copyright

©

2015

Ayla

Networks模板实例化和设备属性定义

模板实例化：模板的实例化发生在设备首次连接上Ayla云的时候。云端根据设备提供的Oem_Id、Model_Id和模板版本信息在数据库中搜索匹配的模板，并创建实例

如何定义设备属性：设备开发

要依据模板编写代码，设中定义的属性和模板属性一一对应

模板如何复用：开发

可以

模板产生新模板，加快开发。

具体做法在模板列表中选一个，当页面出现”Clone”按钮确认后输入模板信息可以实现快速

。

模板版本模板也是可以升级和修改的，所以就需要模板版本号Copyright

©

2015

Ayla

Networks新模板界面和说明1模板（Visibility）：

private：私有模板开发者个人可见，开发者可以将私有模板指定给自己的设备。

Public：模板可以被所有开发者可见.Oem：OEM模板，只有OEM账号下开发者的账户才能创建，用于批量实例化设备，正式产品需要做此类模板。2

模板名：英文大小写和数字（不建议中文），比较常用的是根据产品型号。3类型：缺省的也是最安全的Same_LAN：方式，要求

APP和设备在同一本地地局域网才能

。更换拥有者必须解除绑定。BuJon_Push：这个模式是安全的，但是需要一个按键，通过按键开启2分钟的定时窗口，APP和设备在本地局域网才能

。：这个模式不安全，要求指定AP来Ap_mode设备。Display：不要求APP和设备在同一个局域网，要求设备能显示PIN给终端用户，进行

。

Dsn：最不安全的

方式，通过APP输入DSN号码的方式

。更换拥有者必须先解除。Home

Kit：设备是否支持Home

Kit协议。模板类型：WIFI WIFI模块黑盒方案Gatway网关类（白盒解决方案）需要进一步选择Zigbee或Gerenic允许这类设备创建自己的子节点。创建子节点的模板，需要设置ClusterCopyright

©

2015

Ayla

NetworksClusterId与局域网相关内容：Enabled-------APP可以通过局域网直接控制设备。Keep

Alive----局域网内的APP和设备间保持通讯的心跳。如果APP不能保持这个心跳，设备将会中止会话。Auto

Sync-----自动同步设备变量信息当重新连接。LifeTime------局域网设备间通讯的密钥到期的期限。Copyright

©

2015

Ayla

Networks模板属性的增加模板属性的增加：在模板界面选择Property进入：在属性列表页面上部可以看到Show

all、Sho

ginated，import，export，add

，search几个菜单。Show

all/paginated

显示方式：显示全部或分页显示属性列表。Import导入属性：此功能要求根据提示的CSV格式组织属性表，就可以导入。

Export导出属性：此功能可以将属性表导出到CSV格式，保存到本地。add增加属性。增加需要下面信息：Property

Name：属性名英文大小写,连字符，下划线，不包括空格，第一字符必须字母不超过27个字符，必须跟设备端定义属性名相同。Display

Name：属性显示名称：可以使用比较友好的名称。Base

Type：包括Integer—整形变量32位4字节；String-‐字符串变量最大255字节；Boolean—布尔变量Direc3on这0/1；Decimal—小数类型变量；File—文件类型变量，格式自定，最大4G：数据方向To

Device:R/W

数据可以从双向修改或者更新；From

Device:R

云端只能从设备些属性。Scope：属性的可见范围Oem：属性只能被OEM用户可见；User：属性可让最终用户可见。Host

So]ware

Version：只有一个oem可见的属性，可以选中这个部分，代表host

的版本号。

一般情况下就是”version“Track

only

changed：datapoint

创建的规则，只有值发生变化才更新。如果没有选中，就只更新datapoint的时间，而不会创建新的datapoint。Time

Series：如果选中的话，就是让服务器，对设备没有连接期间修改的datapoint进行排序，按排序发送给设备当设备再次连接时。但是从设备发送到云，排序需要host代码自己处理。Ack

enable：如果属性类型是“to

device”而且这个选中，就意味着会云端如果跟新属性内容到设备成功，云端会接收到一个应答消息。Copyright

©

2015

Ayla

Networks属性创建成功后属性相关的其他属性：Triggers、Denied

Roles，Reten_on属性创建成功后，显示页面如下，可以看到多3个属性功能Copyright

©

2015

Ayla

NetworksTriggers：触发事件具体触发事件的方式是可以设置的。

Type：Always总是，copare_absolute绝对值，on_change改变时绝对值方式：Compare

Type：==,>,<,>=,<=方式。Value：用来比较的属性值。Denied

Roles：限制某个角色的权限。

Roles：从角色列表中选择。Opera_on：包括read、write

读权限和写权限。Reten_on:Policy:

days,count,never_Purge

三种方式days：count：datapointnever_Purge：

表示这个字段

失效。Value:Copyright

©

2015

Ayla

Networks模板的Schedule功能：通过提供的界面可以灵活配置

定时器在特定的时间触发事件，比如修改属性的值，等等Copyright

©

2015

Ayla

Networks定时器触发定时器触发的动作可以自己定义：Name：就是从已经定义的属性里面选择。Type：属性的类型，这里不能输入，系统自动根据Name变化。Ac_on

Executes:触发动作方式：在定时

间，开始时，结束时。Value：触发时修改属性的值为这里设置的值。Ac_ve：开关功能Copyright

©

2015

Ayla

Networks模板的No_cifica_on功能模板的No_cifica_on功能：主要是把设备 断线，等情况推送给设备的拥有者或者制造商。推送的时候可以通过制定的URL，这里设置好登陆名和 。比如第 服务器Type：云连接/IP改变/连接断开/连接恢复。Copyright

©

2015

Ayla

Networks模板的Roles功能15Copyright

©

2015

Ayla

Networks如何删除模板模板列表选中模板，就会出现删除按钮（下图参考）Copyright

©

2015

Ayla

Networks如何给模板增加属性（Property）新创建模板建立后里面没有属性，需要根据项目具体需求进行设计。点击模板界面的Property后，列出本模板的所有属性，可以添加新的属性。也可以导入，导出属性列表，导入需要遵守CSV格式。Copyright

©

2015

Ayla

Networks如何给模板增加属性（Property）新创建模板建立后里面没有属性，需要根据项目具体需求进行设计。点击模板界面的Property后，列出本模板的所有属性，可以添加新的属性。也可以导入，导出属性列表，导入需要遵守CSV格式。Copyright

©

2015

Ayla

Networks通过克隆方式创建的模板通过克隆方式创建的模板，根据需求修改属性列表。Name：

名称必须用用英文数字等，程序里面也要使用这个相同的名称。

DisplayName：可使用比较友好的名称

BaseType（目前包括整型/字符串/布尔/小数/文件）

Direc_on：发送到设备/从设备接收，控制命令一般就是to设备，状态上传就是from设备。

Scope：给当前属性指定使用范围，终端用户/OEM，比如空调开关当然要给终端用户使用，但是有些信息，可能只想让OEM知道。就可以在此设定。Hostswverison：如果本属性跟具体的终端设备

版本相关，就选中，否则就不选，注意只能有一个属性选择这个选项。Track

OnlyChanges：当属性变化时。只有属性变化才，创建新的datapoint，否则只更新datapoint时间Copyright

©

2015

Ayla

Networks查看设备的属性注意在查看设备的属性的时候：另外如果是File类型的数据,下面还有”Download”按钮。点击可以下载文件，如下图：Current

Value：这个在设计属性的时候没有，查看实例化具体设备属性的时候有,就是当前属性的当前值。Copyright

©

2015

Ayla

NetworksCopyright

©

2015

Ayla

Networks制造流程Copyright

©

2015

Ayla

Networks制造！！

涉及哪些内容？

客户需要哪些资料？

白盒与黑盒的区别。Copyright

©

2015

Ayla

Networks涉及哪些内容？

创建OEM账户

定义OEM型号

创建OEM模板

定义SW版本

设置OEM套件

配置模块

验证及测试模块客户需要哪些资料？（用于在白盒解决方案中生成配置文件）◦◦◦

OEM

ID

OEM密钥

OEM

OEM型号名称

OEM

黑盒采用windows系统运行

白盒采用linux系统运行如使用白盒解决方案，客户需要开发自己的linux文档