/** **************************************************************************************** * @addtogroup TIPS * @{ **************************************************************************************** */ /* * INCLUDE FILES **************************************************************************************** */ #include "rwip_config.h" #if (BLE_TIP_SERVER) #include "attm.h" #include "tips.h" #include "tips_task.h" #include "prf_utils.h" #include "ke_mem.h" /* * CTS, NDCS, RTUS ATTRIBUTES **************************************************************************************** */ /// Full CTS Database Description - Used to add attributes into the database const struct attm_desc cts_att_db[CTS_IDX_NB] = { // Current Time Service Declaration [CTS_IDX_SVC] = {ATT_DECL_PRIMARY_SERVICE, PERM(RD, ENABLE), 0, 0}, // Current Time Characteristic Declaration [CTS_IDX_CURRENT_TIME_CHAR] = {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), 0, 0}, // Current Time Characteristic Value [CTS_IDX_CURRENT_TIME_VAL] = {ATT_CHAR_CT_TIME, PERM(RD, ENABLE) | PERM(NTF, ENABLE), PERM(RI, ENABLE), CTS_CURRENT_TIME_VAL_LEN}, // Current Time Characteristic - Client Char. Configuration Descriptor [CTS_IDX_CURRENT_TIME_CFG] = {ATT_DESC_CLIENT_CHAR_CFG, PERM(RD, ENABLE) | PERM(WRITE_REQ, ENABLE), 0, 0}, // Local Time Information Characteristic Declaration [CTS_IDX_LOCAL_TIME_INFO_CHAR] = {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), 0, 0}, // Local Time Information Characteristic Value [CTS_IDX_LOCAL_TIME_INFO_VAL] = {ATT_CHAR_LOCAL_TIME_INFO, PERM(RD, ENABLE), PERM(RI, ENABLE), sizeof(struct tip_loc_time_info)}, // Reference Time Information Characteristic Declaration [CTS_IDX_REF_TIME_INFO_CHAR] = {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), 0, 0}, // Reference Time Info Characteristic Value [CTS_IDX_REF_TIME_INFO_VAL] = {ATT_CHAR_REFERENCE_TIME_INFO, PERM(RD, ENABLE), PERM(RI, ENABLE), sizeof(struct tip_ref_time_info)}, }; /// Full NDCS Database Description - Used to add attributes into the database const struct attm_desc ndcs_att_db[NDCS_IDX_NB] = { // Next DST Change Service Declaration [NDCS_IDX_SVC] = {ATT_DECL_PRIMARY_SERVICE, PERM(RD, ENABLE), 0, 0}, // Time with DST Characteristic Declaration [NDCS_IDX_TIME_DST_CHAR] = {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), 0, 0}, // Time With DST Characteristic Value [NDCS_IDX_TIME_DST_VAL] = {ATT_CHAR_TIME_WITH_DST, PERM(RD, ENABLE), PERM(RI, ENABLE), NDCS_TIME_DST_VAL_LEN}, }; /// Full RTUS Database Description - Used to add attributes into the database const struct attm_desc rtus_att_db[RTUS_IDX_NB] = { // Reference Time Information Service Declaration [RTUS_IDX_SVC] = {ATT_DECL_PRIMARY_SERVICE, PERM(RD, ENABLE), 0, 0}, // Time Update Control Point Characteristic Declaration [RTUS_IDX_TIME_UPD_CTNL_PT_CHAR] = {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), 0, 0}, // Time Update Control Point Characteristic Value [RTUS_IDX_TIME_UPD_CTNL_PT_VAL] = {ATT_CHAR_TIME_UPDATE_CNTL_POINT, PERM(WRITE_COMMAND, ENABLE), PERM(RI, ENABLE), sizeof(tip_time_upd_contr_pt)}, // Time Update State Characteristic Declaration [RTUS_IDX_TIME_UPD_STATE_CHAR] = {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), 0, 0}, // Time Update State Characteristic Value [RTUS_IDX_TIME_UPD_STATE_VAL] = {ATT_CHAR_TIME_UPDATE_STATE, PERM(RD, ENABLE), PERM(RI, ENABLE), sizeof(struct tip_time_upd_state)}, }; /** **************************************************************************************** * @brief Initialization of the TIPS 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 tips_init(struct prf_task_env* env, uint16_t* start_hdl, uint16_t app_task, uint8_t sec_lvl, struct tips_db_cfg* params) { // Service content flag uint32_t cfg_flag= TIPS_CTS_CURRENT_TIME_MASK; // DB Creation Status uint8_t status = ATT_ERR_NO_ERROR; // Total number of attributes uint8_t tot_nb_att = CTS_IDX_NB; // Allocate TIPS required environment variable struct tips_env_tag* tips_env = (struct tips_env_tag* ) ke_malloc(sizeof(struct tips_env_tag), KE_MEM_ATT_DB); env->env = (prf_env_t*) tips_env; //------------------ create the attribute database for the profile ------------------- // Check supported attributes if (params->features & TIPS_NDCS_SUP) { tot_nb_att += NDCS_IDX_NB; } if (params->features & TIPS_NDCS_SUP) { tot_nb_att += RTUS_IDX_NB; } // Check that attribute list can be allocated. status = attm_reserve_handle_range(start_hdl, tot_nb_att); if (status == ATT_ERR_NO_ERROR) { //Set Configuration Flag Value if (params->features & TIPS_CTS_LOC_TIME_INFO_SUP) { cfg_flag |= TIPS_CTS_LOC_TIME_INFO_MASK; } if (params->features & TIPS_CTS_REF_TIME_INFO_SUP) { cfg_flag |= TIPS_CTS_REF_TIME_INFO_MASK; } /*---------------------------------------------------* * Current Time Service Creation *---------------------------------------------------*/ status = attm_svc_create_db(start_hdl, ATT_SVC_CURRENT_TIME, (uint8_t *)&cfg_flag, CTS_IDX_NB, &tips_env->cts_att_tbl[0], env->task, &cts_att_db[0], (sec_lvl & (PERM_MASK_SVC_DIS | PERM_MASK_SVC_AUTH | PERM_MASK_SVC_EKS)) | PERM(SVC_MI, ENABLE)); // Update index tips_env->cts_shdl = *start_hdl; *start_hdl += CTS_IDX_NB; //All attributes are mandatory for NDCS and RTUS cfg_flag = 0xFF; if ((status == ATT_ERR_NO_ERROR) && ((params->features & TIPS_NDCS_SUP))) { /*---------------------------------------------------* * Next DST Change Service Creation *---------------------------------------------------*/ status = attm_svc_create_db(start_hdl, ATT_SVC_NEXT_DST_CHANGE, (uint8_t *)&cfg_flag, NDCS_IDX_NB, &tips_env->ndcs_att_tbl[0], env->task, &ndcs_att_db[0], (sec_lvl & (PERM_MASK_SVC_DIS | PERM_MASK_SVC_AUTH | PERM_MASK_SVC_EKS)) | PERM(SVC_MI, ENABLE)); // Update index tips_env->ndcs_shdl = *start_hdl; *start_hdl += NDCS_IDX_NB; } /*---------------------------------------------------* * Reference Time Update Service Creation *---------------------------------------------------*/ if ((status == ATT_ERR_NO_ERROR) && ((params->features & TIPS_RTUS_SUP))) { status = attm_svc_create_db(start_hdl, ATT_SVC_REF_TIME_UPDATE, (uint8_t *)&cfg_flag, RTUS_IDX_NB, &tips_env->rtus_att_tbl[0], env->task, &rtus_att_db[0], (sec_lvl & (PERM_MASK_SVC_DIS | PERM_MASK_SVC_AUTH | PERM_MASK_SVC_EKS)) | PERM(SVC_MI, ENABLE)); // Update index tips_env->rtus_shdl = *start_hdl; *start_hdl += RTUS_IDX_NB; } // Initialize TIPS environment tips_env->features = params->features; tips_env->prf_env.app_task = app_task | (PERM_GET(sec_lvl, SVC_MI) ? PERM(PRF_MI, ENABLE) : PERM(PRF_MI, DISABLE)); // Multi Instantiated task tips_env->prf_env.prf_task = env->task | PERM(PRF_MI, ENABLE); // initialize environment variable env->id = TASK_ID_TIPS; tips_task_init(&(env->desc)); for(uint8_t idx = 0; idx < BLE_CONNECTION_MAX ; idx++) { tips_env->env[idx] = NULL; } /* Put TIS in disabled state */ ke_state_set(env->task, TIPS_IDLE); } return (status); } /** **************************************************************************************** * @brief Destruction of the TIPS 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 tips_destroy(struct prf_task_env* env) { uint8_t idx; struct tips_env_tag* tips_env = (struct tips_env_tag*) env->env; // cleanup environment variable for each task instances for(idx = 0; idx < BLE_CONNECTION_MAX ; idx++) { if(tips_env->env[idx] != NULL) { ke_free(tips_env->env[idx]); } } // free profile environment variables env->env = NULL; ke_free(tips_env); } /** **************************************************************************************** * @brief Handles Connection creation * * @param[in|out] env Collector or Service allocated environment data. * @param[in] conidx Connection index **************************************************************************************** */ static void tips_create(struct prf_task_env* env, uint8_t conidx) { struct tips_env_tag* tips_env = (struct tips_env_tag*) env->env; tips_env->env[conidx] = (struct tips_cnx_env*) ke_malloc(sizeof(struct tips_cnx_env), KE_MEM_ATT_DB); memset(tips_env->env[conidx], 0, sizeof(struct tips_cnx_env)); /* Put TIS in idle state */ ke_state_set(KE_BUILD_ID(env->task, conidx), TIPS_IDLE); } /** **************************************************************************************** * @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 tips_cleanup(struct prf_task_env* env, uint8_t conidx, uint8_t reason) { struct tips_env_tag* tips_env = (struct tips_env_tag*) env->env; // clean-up environment variable allocated for task instance if(tips_env->env[conidx] != NULL) { ke_free(tips_env->env[conidx]); tips_env->env[conidx] = NULL; } } /* * GLOBAL VARIABLE DEFINITIONS **************************************************************************************** */ /// TIPS Task interface required by profile manager const struct prf_task_cbs tips_itf = { (prf_init_fnct) tips_init, tips_destroy, tips_create, tips_cleanup, }; /* * EXPORTED FUNCTIONS DEFINITIONS **************************************************************************************** */ const struct prf_task_cbs* tips_prf_itf_get(void) { return &tips_itf; } uint8_t tips_pack_curr_time_value(uint8_t *p_pckd_time, const struct tip_curr_time* p_curr_time_val) { // Date-Time prf_pack_date_time(p_pckd_time, &(p_curr_time_val->date_time)); //Day of Week *(p_pckd_time + 7) = p_curr_time_val->day_of_week; //Fraction 256 *(p_pckd_time + 8) = p_curr_time_val->fraction_256; //Adjust Reason *(p_pckd_time + 9) = p_curr_time_val->adjust_reason; return 10; } uint8_t tips_pack_time_dst_value(uint8_t *p_pckd_time_dst, const struct tip_time_with_dst* p_time_dst_val) { // Date-Time prf_pack_date_time(p_pckd_time_dst, &(p_time_dst_val->date_time)); // DST Offset *(p_pckd_time_dst + 7) = p_time_dst_val->dst_offset; return 8; } #endif //BLE_TIP_SERVER /// @} TIPS