meshx_prov_srv.h File Reference

Header file for provisioning related definitions and functions. More...

#include "interface/meshx_platform.h"
#include "interface/ble_mesh/server/meshx_ble_mesh_prov_srv.h"

Go to the source code of this file.

Functions
meshx_err_t	meshx_init_prov (dev_struct_t *p_dev, const meshx_prov_params_t *prov_cfg)
	Initialize provisioning parameters.
meshx_err_t	meshx_prov_srv_reg_el_client_cb (prov_srv_cb_t cb)
	Register a callback function for provisioning events.
meshx_err_t	meshx_prov_srv_reg_el_server_cb (prov_srv_cb_t cb)
	Register a callback function for provisioning events.

Detailed Description

Header file for provisioning related definitions and functions.

Copyright © 2024 - 2025 MeshX

This file contains the definitions and function declarations for provisioning in the BLE mesh node application.

Author

Pranjal Chanda

Function Documentation

meshx_init_prov()

meshx_err_t meshx_init_prov	(	dev_struct_t *	p_dev,
		const meshx_prov_params_t *	prov_cfg )

Initialize provisioning parameters.

This function initializes the provisioning parameters by copying the UUID from the provided server configuration and registering the provisioning callback.

Parameters

[in]	p_dev	Pointer to the device structure.
[in]	prov_cfg	Pointer to the provisioning parameters structure containing the UUID.

Returns

• MESHX_SUCCESS: Success
• MESHX_FAIL: Failed to register provisioning callback

{
    if (!prov_cfg || memcmp(prov_cfg->uuid, MESHX_UUID_EMPTY, sizeof(meshx_uuid_addr_t)) == 0)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Invalid server configuration");
        return MESHX_INVALID_ARG;
    }
 
    meshx_err_t err = meshx_prov_srv_reg_from_ble_cb();
    if (err != MESHX_SUCCESS)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Failed to register provisioning callback");
        return err;
    }
 
    err = meshx_prov_srv_meshx_reg_cb();
    if (err != MESHX_SUCCESS)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Failed to register provisioning callback");
        return err;
    }
 
    err = meshx_init_freshboot_timer(p_dev, prov_cfg->freshboot_timeout_ms);
    if (err != MESHX_SUCCESS)
    {
        MESHX_LOGE(MODULE_ID_MODEL_SERVER, "Failed to initialize boot timer");
        return err;
    }
 
    return meshx_plat_init_prov(prov_cfg->uuid);
}

meshx_prov_srv_reg_el_client_cb()

meshx_err_t meshx_prov_srv_reg_el_client_cb

(

prov_srv_cb_t

cb

)

Register a callback function for provisioning events.

This function registers a callback function that will be called when certain provisioning events occur.

Parameters

[in]

cb

The callback function to register.

Returns

• MESHX_SUCCESS: Success
• MESHX_FAIL: Failed to register the callback

{
    return control_task_msg_subscribe(
        CONTROL_TASK_MSG_CODE_PROVISION,
        MESHX_PROV_SRV_CLIENT_EVENT_BMAP,
        (control_task_msg_handle_t)cb
    );
}

meshx_prov_srv_reg_el_server_cb()

meshx_err_t meshx_prov_srv_reg_el_server_cb

(

prov_srv_cb_t

cb

)

Register a callback function for provisioning events.

This function registers a callback function that will be called when certain provisioning events occur.

Parameters

[in]

cb

The callback function to register.

Returns

• MESHX_SUCCESS: Success
• MESHX_FAIL: Failed to register the callback

{
    return control_task_msg_subscribe(
        CONTROL_TASK_MSG_CODE_PROVISION,
        MESHX_PROV_SRV_SERVER_EVENT_BMAP,
        (control_task_msg_handle_t)cb
    );
}