Page 1 of 1

【Zigbee】自定义DP接入文档

Posted: 2023年 Feb 17日 14:33
by 马小勤

自定义DP接入规范

1.DP基本概念

DP(Data Point)是描述一个设备对象功能点的抽象方式。DP 操作代表通过预定的功能特性来改变设备的状态,例如使用 开关 DP 来改变一个设备的开启和关闭。涂鸦定义了100以内为涂鸦公版DP,101-255为开发者自定义DP。

1.1 DP基本类型

DP常见类型有布尔型、数值型、枚举型、字符型、bitmap、透传(RAW)型。

1.2 自定义DP目的

自定义DP为终端设备在接入涂鸦云端时,可以通过创建自定义DP进行个性化功能开发。

2. 接入标准化流程

2.1 添加私有透传cluster 0xEF00

Code: Select all

#define PRIVATE_ATTR_LIST \
    {0x0000, ATTR_INT8U_ATTRIBUTE_TYPE, 1, (ATTR_MASK_TOKEN_FAST|ATTR_MASK_SINGLETON), 0, (UINT8_T*)0x00 }, /* current positiong lift percentage*/\
    {0xFFFD, ATTR_INT16U_ATTRIBUTE_TYPE, 2, (ATTR_MASK_READABLE), 0, (UINT8_T *)0x0002},

const TAL_ATTR_T g_private_attr_list[] = {
    PRIVATE_ATTR_LIST};

#define DEF_CLUSTER_PRIVATE_CLUSTER_ID(a) \
    { CLUSTER_PRIVATE_TUYA_CLUSTER_ID, (TAL_ATTR_T *)&((a)[0]), GET_ARRAY_LEN((a)) },

CONST TAL_CLUSTER_T app_server_cluster_list[] = {
    DEF_CLUSTER_PRIVATE_CLUSTER_ID(g_private_attr_list)

2.2 修改json文件能力值

在 apps/xxx_demo/appconfig.json 中修改"manufacture_name":"TZ3210"

Image

2.3 DP透传业务需要面板进行配合

需要注意的是,涂鸦面板中的功能与DP一一对应。开发者会定义一些私有DP,但是功能与涂鸦公版DP相同的功能,但是使用公版面板下发功能时,面板下发的为公版的DP。
注:开发时可以使用调试面板进行开发

2.4 透传接收与发送

涂鸦定义了模组与网关交互的命令
网关下发DP至模组:0x04;
模组应答网关下发DP: 0x05;
模组主动上报DP至网关: 0x06;

2.4.1 接收入口

Code: Select all

TAL_MSG_RET_E tal_zcl_specific_msg_recv_callback(TAL_ZCL_MSG_T *msg)
switch(msg->cluster)
    case 0xEF00{
        switch(msg->command){
            case 0x04 :{
                    air_data_response(msg->dst_ep,  
                    msg->len, &(msg->playload[0]), 0x05, QOS_1)
            }
        }

    }
    ...

设备应答回复

Code: Select all

air_data_response(uint8_t ep, uint8_t len uint8_t *data, uint8_t command_id TAL_SEND_QOS_E qos ){
    tal_system_memset(&send_data, 0, SIZEOF(TAL_ZG_SEND_DATA_T));

    send_data.qos = qos;
    send_data.delay_time = 0;
    send_data.zcl_id = 0x68;

    send_data.direction = ZG_ZCL_DATA_SERVER_TO_CLIENT;
    send_data.frame_type = ZG_ZCL_FRAME_TYPE_SPEC_TO_CLUSTER;
    send_data.command_id = command_id;/*respose cmd 0x05 */
    send_data.addr.mode = SEND_MODE_DEV;
    send_data.addr.type.dev.cluster_id = 0xEF00;
    send_data.addr.type.dev.src_ep = ep;
    send_data.data.private.len = len;
    memcpy((send_data.data.private.data), data, len);

    tal_zg_clear_send_data(ZG_CLEAR_ALL_ZCL_ID, &send_data.zcl_id);
    tal_zg_send_data(&send_data, NULL, 2000);
}

2.4.2 设备主动上报

Code: Select all

tal_system_memset(&send_data, 0, SIZEOF(TAL_ZG_SEND_DATA_T));

send_data.qos = QOS_1;
send_data.delay_time = 0;
send_data.zcl_id = 0x68;

send_data.direction = ZG_ZCL_DATA_SERVER_TO_CLIENT;
send_data.frame_type = ZG_ZCL_FRAME_TYPE_SPEC_TO_CLUSTER;
send_data.command_id = 0x06;/*report cmd*/

send_data.addr.mode = SEND_MODE_DEV;
send_data.addr.type.dev.dst_addr = TUYA_GATEWAY_ADDRESS;
send_data.addr.type.dev.dst_ep = 0x01;
send_data.addr.type.dev.src_ep = TUYA_PRIMARY_ENDPOINT;
send_data.addr.type.dev.cluster_id = CLUSTER_PRIVATE_TUYA_CLUSTER_ID;
send_data.data.private.len = 7;
send_data.data.private.data[2] = 101; /* DP id*/
send_data.data.private.data[3] = ATTR_ENUM8_ATTRIBUTE_TYPE; /*DP type*/
send_data.data.private.data[4] = 0x00;
send_data.data.private.data[5] = 0x01;/*DP len*/
send_data.data.private.data[6] = day_up_down_change_flag; /*DP data*/

tal_zg_clear_send_data(ZG_CLEAR_ALL_ZCL_ID, &send_data.zcl_id);
tal_zg_send_data(&send_data, NULL, 2000);

private 数据格式参考下图
Image


Re: 自定义dp接入文档

Posted: 2023年 Mar 14日 11:04
by 叶苹果
Dingtalk_20230314105950.jpg

我调用了上报函数后,使用回调函数发现发送失败了,失败的原因是:ransmission failed due to network failure。

Dingtalk_20230314110302.jpg

但我换了个路由器配网也是一样,我们的网络环境是OK的,抓包器也抓不到包,这个网络失败可能是什么原因呢?


Re: 自定义dp接入文档

Posted: 2023年 Mar 14日 11:39
by zeso

你好,请确认一下:
1.注册endpoint(tal_zg_endpoint_register)时,是否已经注册CLUSTER_PRIVATE_TUYA_CLUSTER_ID这个属性;
2.设备是否已经成功入网,建议TAL_ZG_NWK_JOIN_OK状态回调中调用软件定时器延时一段时间再上报;
3.如果是自定义DP上报,按你的组帧报文,网关无法解析(command id,DP格式等不符合协议),网关不会同步到后台,请参考https://www.tuyaos.com/viewtopic.php?t=915 中的解答和附件例程代码。