pinebuds/services/ble_profiles/tota/tota_ble.c

/***************************************************************************
 *
 * Copyright 2015-2019 BES.
 * All rights reserved. All unpublished rights reserved.
 *
 * No part of this work may be used or reproduced in any form or by any
 * means, or stored in a database or retrieval system, without prior written
 * permission of BES.
 *
 * Use of this work is governed by a license granted by BES.
 * This work contains confidential and proprietary information of
 * BES. which is protected by copyright, trade secret,
 * trademark and other intellectual property rights.
 *
 ****************************************************************************/

/*
 * INCLUDE FILES
 ****************************************************************************************
 */
#include "rwip_config.h"

#if (BLE_TOTA)
#include "attm.h"
#include "co_utils.h"
#include "gap.h"
#include "gapc_task.h"
#include "gattc_task.h"
#include "ke_mem.h"
#include "prf_utils.h"
#include "tota_ble.h"
#include "tota_task.h"

/*
 * TOTA CMD PROFILE ATTRIBUTES
 ****************************************************************************************
 */
#define tota_service_uuid_128_content                                          \
  {                                                                            \
    0x86, 0x86, 0x86, 0x86, 0x86, 0x86, 0x86, 0x86, 0x86, 0x86, 0x86, 0x86,    \
        0x86, 0x86, 0x86, 0x86                                                 \
  }
#define tota_val_char_val_uuid_128_content                                     \
  {                                                                            \
    0x97, 0x97, 0x97, 0x97, 0x97, 0x97, 0x97, 0x97, 0x97, 0x97, 0x97, 0x97,    \
        0x97, 0x97, 0x97, 0x97                                                 \
  }

#define ATT_DECL_PRIMARY_SERVICE_UUID                                          \
  { 0x00, 0x28 }
#define ATT_DECL_CHARACTERISTIC_UUID                                           \
  { 0x03, 0x28 }
#define ATT_DESC_CLIENT_CHAR_CFG_UUID                                          \
  { 0x02, 0x29 }

static const uint8_t TOTA_SERVICE_UUID_128[ATT_UUID_128_LEN] =
    tota_service_uuid_128_content;

/// Full OTA SERVER Database Description - Used to add attributes into the
/// database
const struct attm_desc_128 tota_att_db[TOTA_IDX_NB] = {
    // TOTA Service Declaration
    [TOTA_IDX_SVC] = {ATT_DECL_PRIMARY_SERVICE_UUID, PERM(RD, ENABLE), 0, 0},
    // TOTA Characteristic Declaration
    [TOTA_IDX_CHAR] = {ATT_DECL_CHARACTERISTIC_UUID, PERM(RD, ENABLE), 0, 0},
    // TOTA service
    [TOTA_IDX_VAL] = {tota_val_char_val_uuid_128_content,
                      PERM(WRITE_REQ, ENABLE) | PERM(NTF, ENABLE),
                      PERM(RI, ENABLE) | PERM_VAL(UUID_LEN, PERM_UUID_128),
                      TOTA_MAX_LEN},
    // TOTA Characteristic
    [TOTA_IDX_NTF_CFG] = {ATT_DESC_CLIENT_CHAR_CFG_UUID,
                          PERM(RD, ENABLE) | PERM(WRITE_REQ, ENABLE), 0, 0},

};

/**
 ****************************************************************************************
 * @brief Initialization of the TOTA module.
 * This function performs all the initializations of the Profile module.
 *  - Creation of database (if it's a service)
 *  - Allocation of profile required memory
 *  - Initialization of task descriptor to register application
 *      - Task State array
 *      - Number of tasks
 *      - Default task handler
 *
 * @param[out]    env        Collector or Service allocated environment data.
 * @param[in|out] start_hdl  Service start handle (0 - dynamically allocated),
 *only applies for services.
 * @param[in]     app_task   Application task number.
 * @param[in]     sec_lvl    Security level (AUTH, EKS and MI field of @see enum
 *attm_value_perm_mask)
 * @param[in]     param      Configuration parameters of profile collector or
 *service (32 bits aligned)
 *
 * @return status code to know if profile initialization succeed or not.
 ****************************************************************************************
 */
static uint8_t tota_init(struct prf_task_env *env, uint16_t *start_hdl,
                         uint16_t app_task, uint8_t sec_lvl, void *params) {
  uint8_t status;
  // Add Service Into Database
  status = attm_svc_create_db_128(
      start_hdl, TOTA_SERVICE_UUID_128, NULL, TOTA_IDX_NB, NULL, env->task,
      &tota_att_db[0],
      (sec_lvl & (PERM_MASK_SVC_DIS | PERM_MASK_SVC_AUTH | PERM_MASK_SVC_EKS)) |
          PERM(SVC_MI, DISABLE) | PERM_VAL(SVC_UUID_LEN, PERM_UUID_128));

  BLE_GATT_DBG("attm_svc_create_db_128 returns %d start handle is %d", status,
               *start_hdl);

  //-------------------- allocate memory required for the profile
  //---------------------
  if (status == ATT_ERR_NO_ERROR) {
    // Allocate TOTA required environment variable
    struct tota_env_tag *tota_env = (struct tota_env_tag *)ke_malloc(
        sizeof(struct tota_env_tag), KE_MEM_ATT_DB);

    // Initialize TOTA environment
    env->env = (prf_env_t *)tota_env;
    tota_env->shdl = *start_hdl;

    tota_env->prf_env.app_task =
        app_task | (PERM_GET(sec_lvl, SVC_MI) ? PERM(PRF_MI, ENABLE)
                                              : PERM(PRF_MI, DISABLE));
    // Mono Instantiated task
    tota_env->prf_env.prf_task =
        env->task | (PERM_GET(sec_lvl, SVC_MI) ? PERM(PRF_MI, ENABLE)
                                               : PERM(PRF_MI, DISABLE));

    // initialize environment variable
    env->id = TASK_ID_TOTA;
    tota_task_init(&(env->desc));

    /* Put HRS in Idle state */
    ke_state_set(env->task, TOTA_IDLE);
  }

  return (status);
}

/**
 ****************************************************************************************
 * @brief Destruction of the TOTA module - due to a reset for instance.
 * This function clean-up allocated memory (attribute database is destroyed by
 *another procedure)
 *
 * @param[in|out]    env        Collector or Service allocated environment data.
 ****************************************************************************************
 */
static void tota_destroy(struct prf_task_env *env) {
  struct tota_env_tag *tota_env = (struct tota_env_tag *)env->env;

  // free profile environment variables
  env->env = NULL;
  ke_free(tota_env);
}

/**
 ****************************************************************************************
 * @brief Handles Connection creation
 *
 * @param[in|out]    env        Collector or Service allocated environment data.
 * @param[in]        conidx     Connection index
 ****************************************************************************************
 */
static void tota_create(struct prf_task_env *env, uint8_t conidx) {
  struct tota_env_tag *tota_env = (struct tota_env_tag *)env->env;
  struct prf_svc tota_tota_svc = {tota_env->shdl, tota_env->shdl + TOTA_IDX_NB};
  prf_register_atthdl2gatt(env->env, conidx, &tota_tota_svc);
}

/**
 ****************************************************************************************
 * @brief Handles Disconnection
 *
 * @param[in|out]    env        Collector or Service allocated environment data.
 * @param[in]        conidx     Connection index
 * @param[in]        reason     Detach reason
 ****************************************************************************************
 */
static void tota_cleanup(struct prf_task_env *env, uint8_t conidx,
                         uint8_t reason) {
  /* Nothing to do */
}

/*
 * GLOBAL VARIABLE DEFINITIONS
 ****************************************************************************************
 */

/// TOTA Task interface required by profile manager
const struct prf_task_cbs tota_itf = {
    (prf_init_fnct)tota_init,
    tota_destroy,
    tota_create,
    tota_cleanup,
};

/*
 * EXPORTED FUNCTIONS DEFINITIONS
 ****************************************************************************************
 */

const struct prf_task_cbs *tota_prf_itf_get(void) { return &tota_itf; }

#endif /* BLE_TOTA */