composition.c File Reference

BLE Mesh Composition Initialization and Element Creation. More...

#include "meshx_common.h"
#include "meshx.h"
#include "interface/ble_mesh/server/meshx_ble_mesh_prov_srv.h"
#include "meshx_relay_server_element.h"
#include "meshx_relay_client_element.h"
#include "meshx_cwww_server_element.h"
#include "meshx_light_cwww_client_element.h"

Include dependency graph for composition.c:

Go to the source code of this file.

Typedefs
typedef meshx_err_t(*	root_model_getfn_t) (void *p_model)

Functions
MESHX_MODEL *	get_root_sig_models (void)
	Returns the root models for BLE Mesh elements.
MESHX_MODEL *	get_root_ven_models (void)
	Returns the root models for BLE Mesh elements.
size_t	get_root_sig_models_count (void)
	Returns the count of the root models.
size_t	get_root_ven_models_count (void)
	Returns the count of the vendor root models.
meshx_err_t	meshx_create_element_composition (dev_struct_t *p_dev, meshx_config_t const *config)
	Creates the BLE Mesh element composition.

Variables
element_comp_fn_t	element_comp_fn [MESHX_ELEMENT_TYPE_MAX]
static MESHX_MODEL *	meshx_sig_root_model_arr = NULL
static MESHX_MODEL *	meshx_ven_root_model_arr = NULL
static root_model_getfn_t	meshx_sig_root_model_getfn []
static root_model_getfn_t	meshx_ven_root_model_getfn [] = {}
static uint16_t	meshx_sig_root_model_arr_len = MESHX_ARRAY_SIZE(meshx_sig_root_model_getfn)
static uint16_t	meshx_ven_root_model_arr_len = MESHX_ARRAY_SIZE(meshx_ven_root_model_getfn)

Detailed Description

BLE Mesh Composition Initialization and Element Creation.

Copyright © 2024 - 2025 MeshX

This file contains functions and definitions for initializing BLE Mesh composition data and creating BLE Mesh elements for various configurations such as relay servers, relay clients, and CWWW (Cool White and Warm White) servers.

The file includes necessary headers and conditionally includes headers based on configuration macros. It defines macros for error handling and contains static variables for provisioning parameters and Light CTL state.

Definition in file composition.c.

Typedef Documentation

root_model_getfn_t

typedef meshx_err_t(* root_model_getfn_t) (void *p_model)

Definition at line 67 of file composition.c.

Function Documentation

get_root_sig_models()

MESHX_MODEL * get_root_sig_models

(

void

)

Returns the root models for BLE Mesh elements.

Returns

Pointer to the root models.

Definition at line 89 of file composition.c.

{
    meshx_err_t err;
    static MESHX_MODEL temp_model;
    if(meshx_sig_root_model_arr == NULL && meshx_sig_root_model_arr_len)
    {
        meshx_sig_root_model_arr = (MESHX_MODEL *) MESHX_MALLOC(sizeof(MESHX_MODEL) * meshx_sig_root_model_arr_len);
        if(meshx_sig_root_model_arr == NULL)
        {
            MESHX_LOGE(MODULE_ID_COMMON, "Failed to allocate memory for root models");
            return NULL;
        }
        memset(meshx_sig_root_model_arr, 0, sizeof(MESHX_MODEL) * meshx_sig_root_model_arr_len);
 
        for(uint16_t i = 0; i < meshx_sig_root_model_arr_len; i++)
        {
            if(meshx_sig_root_model_getfn[i] == NULL)
            {
                continue;
            }
            err = meshx_sig_root_model_getfn[i]((void**)&temp_model);
            if (err != MESHX_SUCCESS)
            {
                MESHX_LOGE(MODULE_ID_COMMON, "Failed to get root model (%p) (%d)", meshx_sig_root_model_getfn[i], err);
                return NULL;
            }
            memcpy(&meshx_sig_root_model_arr[i], &temp_model, sizeof(MESHX_MODEL));
        }
    }
    return meshx_sig_root_model_arr;
}

Here is the caller graph for this function:

get_root_sig_models_count()

size_t get_root_sig_models_count

(

void

)

Returns the count of the root models.

Returns

Size of the root models.

Definition at line 156 of file composition.c.

{
    return meshx_sig_root_model_arr_len;
}

Here is the caller graph for this function:

get_root_ven_models()

MESHX_MODEL * get_root_ven_models

(

void

)

Returns the root models for BLE Mesh elements.

Returns

Pointer to the root models.

Definition at line 126 of file composition.c.

{
    static MESHX_MODEL temp_model;
    if(meshx_ven_root_model_arr == NULL && meshx_ven_root_model_arr_len)
    {
        meshx_ven_root_model_arr = (MESHX_MODEL *) MESHX_MALLOC(sizeof(MESHX_MODEL) * meshx_ven_root_model_arr_len);
        if(meshx_ven_root_model_arr == NULL)
        {
            MESHX_LOGE(MODULE_ID_COMMON, "Failed to allocate memory for root models");
            return NULL;
        }
        memset(meshx_ven_root_model_arr, 0, sizeof(MESHX_MODEL) * meshx_ven_root_model_arr_len);
 
        for(uint16_t i = 0; i < meshx_ven_root_model_arr_len; i++)
        {
            if(meshx_ven_root_model_getfn[i] == NULL)
            {
                continue;
            }
            meshx_ven_root_model_getfn[i]((void**)&temp_model);
            memcpy(&meshx_ven_root_model_arr[i], &temp_model, sizeof(MESHX_MODEL));
        }
    }
    return meshx_ven_root_model_arr;
}

get_root_ven_models_count()

size_t get_root_ven_models_count

(

void

)

Returns the count of the vendor root models.

Returns

Size of the vendor root models.

Definition at line 166 of file composition.c.

{
    return meshx_ven_root_model_arr_len;
}

Here is the caller graph for this function:

meshx_create_element_composition()

meshx_err_t meshx_create_element_composition	(	dev_struct_t *	p_dev,
		meshx_config_t const *	config )

Creates the BLE Mesh element composition.

Initializes the BLE Mesh elements for different configurations like relay servers, relay clients, and CWWW (Cool White and Warm White) servers.

Parameters

[in]	p_dev	Pointer to the device structure containing element information.
[in]	config	Pointer to the meshx configuration.

Returns

MESHX_SUCCESS on success, or an error code on failure.

Definition at line 182 of file composition.c.

{
#if CONFIG_MAX_ELEMENT_COUNT > 0
    meshx_err_t err;
#if CONFIG_SECTION_ENABLE_ELEMENT_TABLE
    element_comp_table_t *element_comp_table;
#endif /* CONFIG_SECTION_ENABLE_ELEMENT_TABLE */
    if(!p_dev || !config || !config->element_comp_arr_len || !config->element_comp_arr)
        return MESHX_INVALID_ARG;
 
    err = meshx_init_config_server();
    MESHX_ERR_PRINT_RET("Failed to initialize config server", err);
    for(uint16_t element_id = 0; element_id < config->element_comp_arr_len; element_id++)
    {
#if !CONFIG_SECTION_ENABLE_ELEMENT_TABLE
        if(config->element_comp_arr[element_id].element_cnt != 0
        && element_comp_fn[config->element_comp_arr[element_id].type] != NULL)
        {
            err = element_comp_fn[config->element_comp_arr[element_id].type](p_dev, config->element_comp_arr[element_id].element_cnt);
            if(err)
            {
                MESHX_LOGE(MODULE_ID_COMMON, "Element composition failed: (%d)", err);
                return err;
            }
        }
#else
        element_comp_table = &MESHX_ELEMENT_COMP_TABLE_START;
        while(element_comp_table < &MESHX_ELEMENT_COMP_TABLE_STOP)
        {
            if(element_comp_table->idx == element_id && config->element_comp_arr[element_id].element_cnt != 0)
            {
                err = element_comp_table->element_comp_fn(p_dev, config->element_comp_arr[element_id].element_cnt);
                if(err)
                {
                    MESHX_LOGE(MODULE_ID_COMMON, "Element composition failed: (%d)", err);
                    return err;
                }
            }
            element_comp_table++;
        }
#endif /* CONFIG_SECTION_ENABLE_ELEMENT_TABLE */
    }
#endif /* CONFIG_MAX_ELEMENT_COUNT */
    return err;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

element_comp_fn

element_comp_fn_t element_comp_fn[MESHX_ELEMENT_TYPE_MAX]

Initial value:

= {
 
    [MESHX_ELEMENT_TYPE_RELAY_SERVER]       = &meshx_create_relay_elements,
 
 
    [MESHX_ELEMENT_TYPE_RELAY_CLIENT]       = &create_relay_client_elements,
 
 
    [MESHX_ELEMENT_TYPE_LIGHT_CWWW_SERVER]  = &meshx_create_cwww_elements,
 
 
    [MESHX_ELEMENT_TYPE_LIGHT_CWWW_CLIENT]  = &create_cwww_client_elements,
 
}

Definition at line 46 of file composition.c.

                                                             {
#if CONFIG_RELAY_SERVER_COUNT
    [MESHX_ELEMENT_TYPE_RELAY_SERVER]       = &meshx_create_relay_elements,
#endif /* CONFIG_RELAY_SERVER_COUNT */
#if CONFIG_RELAY_CLIENT_COUNT
    [MESHX_ELEMENT_TYPE_RELAY_CLIENT]       = &create_relay_client_elements,
#endif /* CONFIG_RELAY_CLIENT_COUNT */
#if CONFIG_LIGHT_CWWW_SRV_COUNT
    [MESHX_ELEMENT_TYPE_LIGHT_CWWW_SERVER]  = &meshx_create_cwww_elements,
#endif /* CONFIG_LIGHT_CWWW_CLIENT_COUNT */
#if CONFIG_LIGHT_CWWW_CLIENT_COUNT
    [MESHX_ELEMENT_TYPE_LIGHT_CWWW_CLIENT]  = &create_cwww_client_elements,
#endif /* CONFIG_LIGHT_CWWW_SRV_COUNT */
};

meshx_sig_root_model_arr

MESHX_MODEL* meshx_sig_root_model_arr = NULL

static

Root models for BLE Mesh elements.

Definition at line 64 of file composition.c.

meshx_sig_root_model_arr_len

uint16_t meshx_sig_root_model_arr_len = MESHX_ARRAY_SIZE(meshx_sig_root_model_getfn)

static

Definition at line 81 of file composition.c.

meshx_sig_root_model_getfn

root_model_getfn_t meshx_sig_root_model_getfn[]

static

Initial value:

= {
 
    meshx_get_config_srv_model,
 
 
    meshx_get_ctl_setup_srv_model,
 
}

Definition at line 70 of file composition.c.

                                                         {
#if CONFIG_ENABLE_CONFIG_SERVER
    meshx_get_config_srv_model,
#endif /* CONFIG_ENABLE_CONFIG_SERVER */
#if CONFIG_ENABLE_LIGHT_CTL_SERVER
    meshx_get_ctl_setup_srv_model,
#endif /* CONFIG_ENABLE_LIGHT_CTL_SERVER */
};

meshx_ven_root_model_arr

MESHX_MODEL* meshx_ven_root_model_arr = NULL

static

Definition at line 65 of file composition.c.

meshx_ven_root_model_arr_len

uint16_t meshx_ven_root_model_arr_len = MESHX_ARRAY_SIZE(meshx_ven_root_model_getfn)

static

Definition at line 82 of file composition.c.

meshx_ven_root_model_getfn

root_model_getfn_t meshx_ven_root_model_getfn[] = {}

static

Definition at line 79 of file composition.c.

{};