meshx_ble_mesh_cmn.h File Reference

Common BLE Mesh interface definitions and utility functions. More...

#include "stdlib.h"
#include "string.h"
#include "meshx_err.h"
#include "meshx_ble_mesh_cmn_def.h"
#include "interface/meshx_platform.h"

Include dependency graph for meshx_ble_mesh_cmn.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	meshx_model
	Structure as Interface for meshx models. More...
struct	meshx_ctx
	Structure to hold context information for BLE Mesh operations. More...
struct	meshx_prov_params
	Structure to hold provisioning parameters. More...

Typedefs
typedef struct meshx_model	meshx_model_t
typedef struct meshx_ctx	meshx_ctx_t
	Structure to hold context information for BLE Mesh operations.
typedef struct meshx_prov_params	meshx_prov_params_t
	Structure to hold provisioning parameters.

Functions
meshx_err_t	meshx_is_group_subscribed (meshx_model_t *p_model, uint16_t addr)
	Checks if a model is subscribed to a specific group address.
meshx_err_t	meshx_plat_create_model_pub (meshx_ptr_t *p_pub, uint16_t nmax)
	Creates and initializes model and publication structures.
meshx_err_t	meshx_plat_del_model_pub (meshx_ptr_t *p_pub)
	Deletes the model and publication objects.
meshx_err_t	meshx_plat_client_create (meshx_ptr_t p_model, meshx_ptr_t *p_pub, meshx_ptr_t *p_cli)
	Creates and initializes a generic client model for BLE Mesh.
meshx_err_t	meshx_get_model_id (meshx_ptr_t p_model, uint16_t *model_id)
	Retrieve the model ID of a generic server model.
meshx_err_t	meshx_create_plat_composition (meshx_ptr_t *p_comp)
	Creates a platform-specific BLE Mesh composition object.
meshx_err_t	meshx_plat_add_element_to_composition (uint16_t index, meshx_ptr_t p_element_list, meshx_ptr_t p_sig_models, meshx_ptr_t p_ven_models, uint8_t sig_cnt, uint8_t ven_cnt)
	Adds an element to the BLE Mesh composition.
meshx_err_t	meshx_plat_composition_init (meshx_ptr_t p_composition, meshx_ptr_t p_elements, uint16_t cid, uint16_t pid, uint16_t element_idx)
	Initializes a platform-specific BLE Mesh composition.
meshx_err_t	meshx_platform_bt_init (meshx_uuid_addr_t uuid)
	Initializes the Bluetooth subsystem of the MeshX platform.
meshx_err_t	meshx_plat_ble_mesh_init (const meshx_prov_params_t *prov_cfg, meshx_ptr_t comp)
	Initializes the BLE Mesh stack with the given provisioning parameters.
meshx_err_t	meshx_get_base_element_id (uint16_t *base_el_id)
	Retrieves the base element ID for the BLE Mesh platform.

Detailed Description

Common BLE Mesh interface definitions and utility functions.

Copyright (c) 2024 - 2025 MeshX

This header file contains the definitions and function declarations for managing BLE Mesh models, contexts, and compositions. It provides utilities for checking model subscriptions, creating and deleting model structures, retrieving model IDs, and managing BLE Mesh compositions.

The functions defined here facilitate the initialization, manipulation, and cleanup of BLE Mesh components, ensuring efficient memory management and error handling.

Author

Pranjal Chanda

Definition in file meshx_ble_mesh_cmn.h.

Typedef Documentation

meshx_ctx_t

typedef struct meshx_ctx meshx_ctx_t

Structure to hold context information for BLE Mesh operations.

meshx_model_t

typedef struct meshx_model meshx_model_t

meshx_prov_params_t

typedef struct meshx_prov_params meshx_prov_params_t

Structure to hold provisioning parameters.

Function Documentation

meshx_create_plat_composition()

meshx_err_t meshx_create_plat_composition

(

meshx_ptr_t *

p_comp

)

Creates a platform-specific BLE Mesh composition object.

This function allocates memory for a MESHX_COMPOSITION object and assigns its pointer to the provided pointer argument. It checks for invalid arguments and memory allocation failures, returning appropriate error codes.

Parameters

[out]

p_comp

Pointer to the location where the composition object pointer will be stored.

Returns

MESHX_SUCCESS on successful creation, MESHX_INVALID_ARG if the provided pointer is NULL, or MESHX_NO_MEM if memory allocation fails.

Definition at line 99 of file esp_platform_ble_mesh.c.

{
    if(!p_comp)
        return MESHX_INVALID_ARG;
 
    *p_comp = (MESHX_COMPOSITION *) MESHX_MALLOC (sizeof(MESHX_COMPOSITION));
    if(!*p_comp)
        return MESHX_NO_MEM;
 
    return MESHX_SUCCESS;
}

Here is the caller graph for this function:

meshx_get_base_element_id()

meshx_err_t meshx_get_base_element_id

(

uint16_t *

base_el_id

)

Retrieves the base element ID for the BLE Mesh platform.

This function fetches the base element ID, which is used as a reference point for other elements in the BLE Mesh composition.

Parameters

[out]

base_el_id

Pointer to a variable where the base element ID will be stored.

Returns

meshx_err_t Returns MESHX_SUCCESS on success, or an appropriate error code on failure.

Definition at line 153 of file esp_platform_ble_mesh.c.

{
    if (!base_el_id)
    {
        return MESHX_INVALID_ARG;
    }
 
    *base_el_id = esp_ble_mesh_get_primary_element_address();
 
    return MESHX_SUCCESS;
}

Here is the caller graph for this function:

meshx_get_model_id()

meshx_err_t meshx_get_model_id	(	meshx_ptr_t	p_model,
		uint16_t *	model_id )

Retrieve the model ID of a generic server model.

This function obtains the model ID associated with a specified generic server model.

Parameters

[in]	p_model	Pointer to the model whose ID is to be retrieved.
[out]	model_id	Pointer to a variable where the retrieved model ID will be stored.

Returns

MESHX_SUCCESS on success, or an appropriate error code on failure.

Definition at line 88 of file esp_platform_ble_mesh.c.

{
    if(!p_model)
        return MESHX_INVALID_ARG;
 
    MESHX_MODEL * model = (MESHX_MODEL *)p_model;
    *model_id = model->model_id;
 
    return MESHX_SUCCESS;
}

Here is the caller graph for this function:

meshx_is_group_subscribed()

meshx_err_t meshx_is_group_subscribed	(	meshx_model_t *	p_model,
		uint16_t	addr )

Checks if a model is subscribed to a specific group address.

This function determines whether the specified BLE Mesh model is subscribed to a given group address by utilizing the internal function esp_ble_mesh_is_model_subscribed_to_group.

Parameters

[in]	p_model	Pointer to the BLE Mesh model structure.
[in]	addr	The group address to check for subscription.

Returns

MESHX_SUCCESS if the model is subscribed to the group address, otherwise MESHX_FAIL.

Definition at line 23 of file esp_platform_ble_mesh.c.

{
    const uint16_t * res = esp_ble_mesh_is_model_subscribed_to_group(p_model->p_model, addr);
    if(res != NULL)
        return MESHX_SUCCESS;
 
    return MESHX_FAIL;
}

Here is the caller graph for this function:

meshx_plat_add_element_to_composition()

meshx_err_t meshx_plat_add_element_to_composition	(	uint16_t	index,
		meshx_ptr_t	p_element_list,
		meshx_ptr_t	p_sig_models,
		meshx_ptr_t	p_ven_models,
		uint8_t	sig_cnt,
		uint8_t	ven_cnt )

Adds an element to the BLE Mesh composition.

This function adds a new element to the BLE Mesh composition at the specified index. It assigns the provided SIG and vendor models to the element and sets their respective counts.

Parameters

[in]	index	Index at which the element is to be added.
[in,out]	p_element_list	Pointer to the list of elements.
[in]	p_sig_models	Pointer to the SIG models to be assigned to the element.
[in]	p_ven_models	Pointer to the vendor models to be assigned to the element.
[in]	sig_cnt	Number of SIG models.
[in]	ven_cnt	Number of vendor models.

Returns

MESHX_SUCCESS on success, or MESHX_INVALID_ARG if the element list pointer is NULL.

Definition at line 111 of file esp_platform_ble_mesh.c.

  {
    if (!p_element_list) {
        return MESHX_INVALID_ARG;
    }
 
    MESHX_ELEMENT* element = (MESHX_ELEMENT*)(p_element_list) + index;
    element->sig_models = p_sig_models;
    element->vnd_models = p_ven_models;
 
    memcpy((meshx_ptr_t)&(element->sig_model_count), &sig_cnt, sizeof(uint8_t));
    memcpy((meshx_ptr_t)&(element->vnd_model_count), &ven_cnt, sizeof(uint8_t));
 
    return MESHX_SUCCESS;
}

Here is the caller graph for this function:

meshx_plat_ble_mesh_init()

meshx_err_t meshx_plat_ble_mesh_init	(	const meshx_prov_params_t *	prov_cfg,
		meshx_ptr_t	comp )

Initializes the BLE Mesh stack with the given provisioning parameters.

This function sets up the BLE Mesh stack and initializes it with the provided provisioning parameters.

Parameters

[in]	prov_cfg	Pointer to the provisioning parameters structure.
[in]	comp	Pointer to the composition data.

Returns

meshx_err_t Returns MESHX_OK on success, or an appropriate error code.

Definition at line 193 of file esp_platform_ble_mesh.c.

{
    if(comp == NULL || prov_cfg == NULL)
        return MESHX_INVALID_ARG;
 
    meshx_err_t err = MESHX_SUCCESS;
 
    /* Initialize BLE Mesh Provisioner */
    MESHX_PROV *p_prov = NULL;
 
    p_prov = (MESHX_PROV *)meshx_plat_get_prov();
    if(p_prov == NULL)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Failed to get provisioning instance");
        return MESHX_ERR_PLAT;
    }
    err = esp_ble_mesh_init(p_prov, comp);
    if(err)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Failed to initialize mesh stack");
        return err;
    }
    err = esp_ble_mesh_set_unprovisioned_device_name((char*)prov_cfg->node_name);
    if(err)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Failed to set device name");
        return err;
    }
    err = esp_ble_mesh_node_prov_enable((esp_ble_mesh_prov_bearer_t)(ESP_BLE_MESH_PROV_ADV | ESP_BLE_MESH_PROV_GATT));
    if(err)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Failed to enable mesh node");
        return err;
    }
    MESHX_LOGD(MODULE_ID_MODEL_SERVER, "BLE Mesh Node initialized");
    return MESHX_SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

meshx_plat_client_create()

meshx_err_t meshx_plat_client_create	(	meshx_ptr_t	p_model,
		meshx_ptr_t *	p_pub,
		meshx_ptr_t *	p_cli )

Creates and initializes a generic client model for BLE Mesh.

This function sets up the necessary structures and resources for a generic client model in the BLE Mesh stack. It initializes the model, publication context, and the on/off client instance.

Parameters

[in]	p_model	Pointer to the model structure to be initialized.
[out]	p_pub	Pointer to a location where the address of the publication context will be stored.
[out]	p_cli	Pointer to a location where the address of the on/off client instance will be stored.

Returns

meshx_err_t Returns an error code indicating the result of the operation. Typically, MESHX_OK on success or an appropriate error code on failure.

Definition at line 56 of file esp_platform_ble_mesh.c.

{
    if (!p_model || !p_pub || !p_cli)
    {
        return MESHX_INVALID_ARG; // Invalid arguments
    }
    meshx_err_t err = MESHX_SUCCESS;
 
    // Create the publication context for the model
    err = meshx_plat_create_model_pub(p_pub, 1);
    if (err)
    {
        return meshx_plat_del_model_pub(p_pub); // Clean up on error
    }
 
    // Allocate memory for the generic client model
    *p_cli = (MESHX_CLI *)MESHX_CALOC(1, sizeof(MESHX_CLI));
    if (!*p_cli)
    {
        return MESHX_NO_MEM; // Memory allocation failed
    }
 
    // Initialize the generic client model
    ((MESHX_MODEL *)p_model)->user_data = *p_cli;
 
    meshx_ptr_t*temp = (meshx_ptr_t*)&((MESHX_MODEL *)p_model)->pub;
 
    *temp = *p_pub;
 
    return MESHX_SUCCESS; // Successfully created the model and publication context
}

Here is the call graph for this function:

Here is the caller graph for this function:

meshx_plat_composition_init()

meshx_err_t meshx_plat_composition_init	(	meshx_ptr_t	p_composition,
		meshx_ptr_t	p_elements,
		uint16_t	cid,
		uint16_t	pid,
		uint16_t	element_idx )

Initializes a platform-specific BLE Mesh composition.

This function sets up a BLE Mesh composition object with the specified company ID, product ID, and element index. It assigns the provided elements to the composition.

Parameters

[out]	p_composition	Pointer to the composition object to be initialized.
[in]	p_elements	Pointer to the elements to be included in the composition.
[in]	cid	Company ID for the composition.
[in]	pid	Product ID for the composition.
[in]	element_idx	Index of the element within the composition.

Returns

MESHX_SUCCESS on successful initialization, or an appropriate error code on failure.

Definition at line 133 of file esp_platform_ble_mesh.c.

{
    if(!p_composition)
        return MESHX_INVALID_ARG;
 
    MESHX_COMPOSITION * composition = (MESHX_COMPOSITION *) p_composition;
    composition->cid = cid;
    composition->pid = pid;
    composition->element_count = element_idx;
    composition->elements = p_elements;
 
    return MESHX_SUCCESS;
}

Here is the caller graph for this function:

meshx_plat_create_model_pub()

meshx_err_t meshx_plat_create_model_pub	(	meshx_ptr_t *	p_pub,
		uint16_t	nmax )

Creates and initializes model and publication structures.

This function allocates memory for model and publication structures based on the specified maximum number of elements. It initializes the provided pointers to point to the newly allocated memory.

Parameters

[out]	p_pub	Pointer to the publication structure to be created.
[in]	nmax	Maximum number of elements for the model and publication.

Returns

MESHX_SUCCESS on successful allocation and initialization, MESHX_INVALID_ARG if any input pointer is NULL, MESHX_NO_MEM if memory allocation fails.

Definition at line 31 of file esp_platform_ble_mesh.c.

{
    if(!p_pub)
        return MESHX_INVALID_ARG;
 
    *p_pub   = (MESHX_MODEL_PUB *) MESHX_CALOC(nmax, sizeof(MESHX_MODEL_PUB));
    if(!*p_pub)
        return MESHX_NO_MEM;
 
    return MESHX_SUCCESS;
}

Here is the caller graph for this function:

meshx_plat_del_model_pub()

meshx_err_t meshx_plat_del_model_pub

(

meshx_ptr_t *

p_pub

)

Deletes the model and publication objects.

This function frees the memory allocated for the model and publication objects pointed to by the provided pointers and sets them to NULL.

Parameters

[in,out]

p_pub

Pointer to the publication object to be deleted.

Returns

MESHX_SUCCESS on successful deletion, MESHX_INVALID_ARG if either pointer is NULL.

Definition at line 43 of file esp_platform_ble_mesh.c.

{
    if (!p_pub)
        return MESHX_INVALID_ARG;
 
    if (*p_pub) {
        MESHX_FREE(*p_pub);
        *p_pub = NULL;
    }
 
    return MESHX_SUCCESS;
}

Here is the caller graph for this function:

meshx_platform_bt_init()

meshx_err_t meshx_platform_bt_init

(

meshx_uuid_addr_t

uuid

)

Initializes the Bluetooth subsystem of the MeshX platform.

This function sets up the Bluetooth-related components necessary for MeshX operation, such as BLE Mesh provisioning and communication.

Parameters

[in]

uuid

Pointer to the UUID address to be used for the Bluetooth initialization.

Returns

meshx_err_t Returns MESHX_OK on success, or an appropriate error code.

Definition at line 165 of file esp_platform_ble_mesh.c.

{
    esp_err_t err = ESP_OK;
    /* Initialize Bluetooth */
    err = bluetooth_init();
    if(err)
    {
        return MESHX_ERR_PLAT;
    }
 
    if(uuid == NULL)
    {
        MESHX_LOGE(MODULE_ID_COMMON, "Invalid configuration for Bluetooth initialization");
        return MESHX_INVALID_ARG;
    }
    /* Set the device UUID */
    if(memcmp(uuid, MESHX_UUID_EMPTY, sizeof(meshx_uuid_addr_t)) == 0)
    {
        const uint8_t *mac_addr = esp_bt_dev_get_address();
        if (mac_addr == NULL) {
            MESHX_LOGE(MODULE_ID_COMMON, "Failed to get device address");
            return MESHX_ERR_PLAT;
        }
        memcpy(uuid + 2, mac_addr, MESHX_BD_ADDR_LEN);
    }
    return MESHX_SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function: