Door Lock

Detailed Description

Door Lock device has 5 clusters (see spec 7.4.11):

• ZCL Identify cluster
  
• ZCL Basic cluster
  
• ZCL DoorLock cluster
  
• ZCL Scenes cluster
  
• ZCL Groups cluster

Door Lock device sample

Example

• Declaring clusters:

  /* Basic cluster attributes data */
  zb_uint8_t g_attr_basic_zcl_version = ZB_ZCL_BASIC_ZCL_VERSION_DEFAULT_VALUE;
  zb_uint8_t g_attr_basic_application_version = ZB_ZCL_BASIC_APPLICATION_VERSION_DEFAULT_VALUE;
  zb_uint8_t g_attr_basic_stack_version = ZB_ZCL_BASIC_STACK_VERSION_DEFAULT_VALUE;
  zb_uint8_t g_attr_basic_hw_version = ZB_ZCL_BASIC_HW_VERSION_DEFAULT_VALUE;
  zb_char_t g_attr_basic_manufacturer_name[] = ZB_ZCL_BASIC_MANUFACTURER_NAME_DEFAULT_VALUE;
  zb_char_t g_attr_basic_model_identifier[] = ZB_ZCL_BASIC_MODEL_IDENTIFIER_DEFAULT_VALUE;
  zb_char_t g_attr_basic_date_code[] = ZB_ZCL_BASIC_DATE_CODE_DEFAULT_VALUE;
  zb_uint8_t g_attr_basic_power_source = ZB_ZCL_BASIC_POWER_SOURCE_DEFAULT_VALUE;
  zb_char_t g_attr_basic_location_description[] = ZB_ZCL_BASIC_LOCATION_DESCRIPTION_DEFAULT_VALUE;
  zb_uint8_t g_attr_basic_physical_environment = ZB_ZCL_BASIC_PHYSICAL_ENVIRONMENT_DEFAULT_VALUE;
  zb_char_t g_attr_sw_build_id[] = ZB_ZCL_BASIC_SW_BUILD_ID_DEFAULT_VALUE;
  ZB_ZCL_DECLARE_BASIC_ATTRIB_LIST_EXT(basic_attr_list, &g_attr_basic_zcl_version, &g_attr_basic_application_version, &g_attr_basic_stack_version, &g_attr_basic_hw_version, &g_attr_basic_manufacturer_name, &g_attr_basic_model_identifier, &g_attr_basic_date_code, &g_attr_basic_power_source, &g_attr_basic_location_description, &g_attr_basic_physical_environment, &g_attr_sw_build_id);

  /* Identify cluster attributes data */
  zb_uint16_t g_attr_identify_identify_time = ZB_ZCL_IDENTIFY_IDENTIFY_TIME_DEFAULT_VALUE;
  /* Groups cluster attributes data */
  zb_uint8_t g_attr_groups_name_support = 0;
  /* Scenes cluster attributes data */
  zb_uint8_t g_attr_scenes_scene_count = ZB_ZCL_SCENES_SCENE_COUNT_DEFAULT_VALUE;
  zb_uint8_t g_attr_scenes_current_scene = ZB_ZCL_SCENES_CURRENT_SCENE_DEFAULT_VALUE;
  zb_uint16_t g_attr_scenes_current_group = ZB_ZCL_SCENES_CURRENT_GROUP_DEFAULT_VALUE;
  zb_uint8_t g_attr_scenes_scene_valid = ZB_ZCL_SCENES_SCENE_VALID_DEFAULT_VALUE;
  zb_uint8_t g_attr_scenes_name_support = 0;
  /* Door Lock cluster attributes data */
  zb_uint8_t g_attr_door_lock_lock_state = 0;
  zb_uint8_t g_attr_door_lock_lock_type = 0;
  zb_bool_t g_attr_door_lock_actuator_enabled = ZB_FALSE;
  ZB_ZCL_DECLARE_DOOR_LOCK_ATTRIB_LIST(door_lock_attr_list, &g_attr_door_lock_lock_state, &g_attr_door_lock_lock_type, &g_attr_door_lock_actuator_enabled);
  ZB_ZCL_DECLARE_IDENTIFY_ATTRIB_LIST(identify_attr_list, &g_attr_identify_identify_time);
  ZB_ZCL_DECLARE_GROUPS_ATTRIB_LIST(groups_attr_list, &g_attr_groups_name_support);
  ZB_ZCL_DECLARE_SCENES_ATTRIB_LIST(scenes_attr_list, &g_attr_scenes_scene_count, &g_attr_scenes_current_scene, &g_attr_scenes_current_group, &g_attr_scenes_scene_valid, &g_attr_scenes_name_support);
  /********************* Declare device **************************/
  ZB_HA_DECLARE_DOOR_LOCK_CLUSTER_LIST(door_lock_clusters, door_lock_attr_list, basic_attr_list, identify_attr_list, groups_attr_list, scenes_attr_list);
  ZB_HA_DECLARE_DOOR_LOCK_EP(door_lock_ep, ENDPOINT_C, door_lock_clusters);
  ZB_HA_DECLARE_DOOR_LOCK_CTX(device_ctx, door_lock_ep);

• Registering device list:

    /* Register device list */
    ZB_AF_REGISTER_DEVICE_CTX(&device_ctx);
    ZB_ZCL_REGISTER_DEVICE_CB(test_device_interface_cb);

• Example of command handler:

  void test_device_interface_cb(zb_uint8_t param)
  {
    zb_zcl_device_callback_param_t *device_cb_param =
      ZB_BUF_GET_PARAM(param, zb_zcl_device_callback_param_t);
    TRACE_MSG(TRACE_APP1, "> test_device_interface_cb param %hd id %hd", (FMT__H_H,
        param, device_cb_param->device_cb_id));
    device_cb_param->status = RET_OK;
    switch (device_cb_param->device_cb_id)
    {
      case ZB_ZCL_SET_ATTR_VALUE_CB_ID:
        if (device_cb_param->cb_param.set_attr_value_param.cluster_id == ZB_ZCL_CLUSTER_ID_ON_OFF &&
            device_cb_param->cb_param.set_attr_value_param.attr_id == ZB_ZCL_ATTR_ON_OFF_ON_OFF_ID)
        {
          if (device_cb_param->cb_param.set_attr_value_param.values.data8)
          {
            TRACE_MSG(TRACE_APP1, "set ON", (FMT__0));
  #ifdef ZB_USE_BUTTONS
            zb_osif_led_on(0);
  #endif
          }
          else
          {
            TRACE_MSG(TRACE_APP1, "set OFF", (FMT__0));
  #ifdef ZB_USE_BUTTONS
            zb_osif_led_off(0);
  #endif
          }
        }
        break;
      case ZB_ZCL_DOOR_LOCK_LOCK_DOOR_CB_ID:
      {
        zb_uint8_t lock_state = ZB_ZCL_ATTR_DOOR_LOCK_LOCK_STATE_LOCKED;
        TRACE_MSG(TRACE_APP1, "Lock the door", (FMT__0));
        ZVUNUSED(zb_zcl_set_attr_val(ENDPOINT_C,
                                     ZB_ZCL_CLUSTER_ID_DOOR_LOCK,
                                     ZB_ZCL_CLUSTER_SERVER_ROLE,
                                     ZB_ZCL_ATTR_DOOR_LOCK_LOCK_STATE_ID,
                                     &lock_state,
                                     ZB_FALSE));
      }
      break;
      case ZB_ZCL_DOOR_LOCK_UNLOCK_DOOR_CB_ID:
      {
        zb_uint8_t lock_state = ZB_ZCL_ATTR_DOOR_LOCK_LOCK_STATE_UNLOCKED;
        TRACE_MSG(TRACE_APP1, "Unlock the door", (FMT__0));
        ZVUNUSED(zb_zcl_set_attr_val(ENDPOINT_C,
                                     ZB_ZCL_CLUSTER_ID_DOOR_LOCK,
                                     ZB_ZCL_CLUSTER_SERVER_ROLE,
                                     ZB_ZCL_ATTR_DOOR_LOCK_LOCK_STATE_ID,
                                     &lock_state,
                                     ZB_FALSE));
      }
      break;
      default:
        device_cb_param->status = RET_OK;
        break;
    }
    TRACE_MSG(TRACE_APP1, "< test_device_interface_cb %hd", (FMT__H, device_cb_param->status));
  }

Macro Definition Documentation

◆ ZB_HA_DECLARE_DOOR_LOCK_CLUSTER_LIST

◆ ZB_HA_DECLARE_DOOR_LOCK_CTX

◆ ZB_HA_DECLARE_DOOR_LOCK_EP

ZB_ZCL_DECLARE_DOOR_LOCK_SIMPLE_DESC(ep_name, ep_id,                      \
          ZB_HA_DOOR_LOCK_IN_CLUSTER_NUM, ZB_HA_DOOR_LOCK_OUT_CLUSTER_NUM);     \
      ZBOSS_DEVICE_DECLARE_REPORTING_CTX(reporting_info## device_ctx_name,            \
                                         ZB_HA_DOOR_LOCK_REPORT_ATTR_COUNT);          \
      ZB_AF_DECLARE_ENDPOINT_DESC(ep_name, ep_id, ZB_AF_HA_PROFILE_ID,                         \
            0,                                                                        \
            NULL,                                                                     \
                              ZB_ZCL_ARRAY_SIZE(cluster_list, zb_zcl_cluster_desc_t), \
                              cluster_list,                                           \
                              (zb_af_simple_desc_1_1_t*)&simple_desc_##ep_name,       \
                              ZB_HA_DOOR_LOCK_REPORT_ATTR_COUNT,                      \
                              reporting_info## device_ctx_name,                       \
                              0, NULL)
ZB_AF_HA_PROFILE_ID
#define ZB_AF_HA_PROFILE_ID
Definition: zboss_api_af.h:286
zb_zcl_cluster_desc_s
ZCL cluster description. 
Definition: zb_zcl_common.h:146

◆ ZB_HA_DEVICE_VER_DOOR_LOCK