低功耗门铃方案配置说明

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

创建产品

在涂鸦开发者平台上，选择 创建产品 > 安防监控 > 可视门铃 > 自定义方案，完善产品信息后产品创建完成， 平台会自动生成 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 开发手册 进行对接。

设备消息推送设置

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

涂鸦开发者平台操作页面如下图所示：

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

移动侦测告警（DP 115）：

门铃呼叫（DP 154）：

低电量告警（DP 145、146、147）：

快速创建产品

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