低功耗门铃方案配置说明

更新时间:2022-06-24 03:45:52下载pdf

涂鸦低功耗门铃方案是在涂鸦智能 IPC 功能基础上,增加了低功耗门铃特性:门铃接听、门铃开锁、门铃控制铃铛、接听界面开锁及告警消息推送。

创建产品

涂鸦 IoT 开发平台上,选择 创建产品 > 安防监控 > 可视门铃 > 自定义方案,完善产品信息后产品创建完成, 平台会自动生成 PID 信息。

创建产品的详细步骤,请参考 选品类创建产品

低功耗门铃方案配置说明

功能添加说明

此为涂鸦 IPC 方案提供的标准功能,开发者可根据产品的实际功能选择。功能开启后对应的图标将在 App 操作页面和设备设置页面展示。

低功耗门铃方案配置说明

电源管理

DP 定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
DP 145
电量
Battery wireless_electricity 只上报 数值型
DP 146
供电方式
Power Supply Mode wireless_powermode 只上报 枚举型 设备主动上报当前供电状态,供电状态发生变化时上报。0 为电池供电状态,1 为插电供电状态(或电池充电状态)。
DP 147
低电量报警
Low Battery Alarm wireless_lowpower 可下发可上报 数值型 若电量百分比低于该阈值,则触发报警。需要在 App 端设置,设备本身无须关心该 DP 点。
DP 149
设备状态
Device State wireless_awake 可下发可上报 布尔型 设备主动上报当前低功耗是否处于唤醒状态。类型为布尔型,true 为唤醒状态,false 为休眠状态。
说明:设备休眠前上报 false,则设备唤醒后上报一次 true

DP 点说明

  • 设备通过 DP 145 上报电池电量。
  • 设备通过 DP 146 上报设备供电方式是电池供电还是在充电状态。
  • App 设置中通过 DP 147 设置设备低电量报警的阈值,设备消息推送设置中添加低电量告警,触发方式为 DP 145 上报的电量小于 DP 147 的值且 DP 146 设备供电方式为电池供电时,触发云端推动低电量告警给用户。
  • 设备通过 DP 149 上报设备是唤醒还是休眠状态,此 DP 点上报的状态非常重要。

App 操作页面如下所示:

低功耗门铃方案配置说明

移动侦测

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
DP 115
检测到移动
movement_detect_pic 只上报(ro) 透传型(Raw) 该功能实现请参考 SDK
----------------------------
{“dp_id”,“bucket;object;key”}/{“dp_id”,“bucket;object;”} bucket:根文件夹。object:文件路径。key:加密。
DP 152
PIR 开关及灵敏度
pir_switch 可下发可上报(rw) 枚举型(Enum) 枚举值:0、1、2、3

低功耗门铃平时处于休眠状态,无法通过视频检测移动,需通过 PIR 检测是否有人。当 PIR 被触发时,设备被唤醒并抓拍图片,通过 SDK 接口上报,需在设备消息推送设置中添加移动侦测事件,用户便能及时收到移动侦测告警推送。支持在消息中心查看此事件。

门铃呼叫

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
DP 154
门铃抓拍图片
doorbell_pic 只上报(ro) 透传型(Raw) 用户按下门铃,抓拍图片并上传 /

当有人按门铃时,设备抓图并通过 SDK 接口上报图片,并在设备消息推送设置中添加门铃呼叫事件,用户便能够及时收到按门铃呼叫推送,且支持在消息中心查看此事件。具体信息,参考 门铃对接说明

开锁功能

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
DP 148
锁-开关
accessory_lock 可下发可上报(rw) 布尔型(Bool) / 在 PID 中添加此 DP 点即可展示

低功耗门铃方案配置说明

门铃开锁

参考 多锁开关对接文档,设备对接后在门铃呼叫页面上滑即可调出开锁图标。

低功耗门铃方案配置说明

门铃铃铛

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
DP 155
铃铛配对
doorbell_ring_exist 可下发可上报(rw) 枚举型(Enum) 枚举值:0、1
  • 0:没有铃铛
  • 1:铃铛配对成功。
开始配对时,App 下发 1,设备收到后返回配对结果。
解绑时,App 下发 0,设备收到后回复解绑结果。
DP156
铃声
chime_ring_tune 可下发可上报(rw) 枚举型(Enum) 枚举值:1、2、3、4 /
DP157
铃声音量
chime_ring_volume 可下发可上报(rw) 数值型(Value)
  • 数值范围:0-100
  • 间距:1
  • 倍数:0
设置铃铛的音量,0-100
DP165
铃铛模式选择
chime_settings 可下发可上报(rw) 枚举型(Enum) 枚举值:0、1、2、3、4 /

选择开启 DP ID 155、156、157 和 165 后,App 设置界面会出现门铃铃铛的类型选择和控制界面。
无线铃铛支持声音和铃声选择,机械铃铛、数字铃铛不支持铃声和音量控制,也可移除 DP ID 156 和 157。

低功耗门铃方案配置说明

面板配置

设备面板 中选择 IPC 通用面板 (App 最低版本 v3.17.0)

低功耗门铃方案配置说明

硬件开发

涂鸦低功耗门铃方案使用涂鸦 IPC SDK 方式对接,流程如下:

  1. 根据硬件平台交叉编译工具名称,确认是否已有 SDK。如有,请前往 SDK 仓库 下载。如无,联系涂鸦项目经理提供。
  2. 按照 IPC SDK 开发手册 进行对接。

设备消息推送设置

设备消息推送是产品的告知提醒,您可以自定义产品的告警条件,实时监控产品状态。运行产品时,如果某项功能的值超出常规状态,或者您需要通知用户某些实时信息时,即可第一时间将消息触达用户,保障产品正常运行。

涂鸦 IoT 开发平台操作页面如下图所示:

低功耗门铃方案配置说明

开发者账号须为企业版或旗舰版,才支持配置设备消息推送。

提供参考 PID 的消息推送配置,开发者也可根据自己的实际需求进行配置并匹配固件。消息推送配置完成后,需联系涂鸦项目经理进行审核后才可开启。详细操作,请参考 推送设备消息

移动侦测告警(DP 115)

低功耗门铃方案配置说明

门铃呼叫(DP 154)

低功耗门铃方案配置说明

低电量告警(DP 145、146、147)

低功耗门铃方案配置说明

DP 145 上报的电量小于 DP 147 的值,且 DP 146 设备供电方式为电池供电时,会触发云端推送低电量告警给用户。

快速创建产品

低功耗门铃方案 OEM PID,点击可快速在您的涂鸦 IoT 开发平台账号下,复制示例 PID 的配置。