RA Flexible Software Package Documentation  Release v5.3.0

 
BLE Mesh Network Config Server (rm_mesh_config_srv)

Functions

fsp_err_t RM_MESH_CONFIG_SRV_Open (rm_ble_mesh_model_server_ctrl_t *const p_ctrl, rm_ble_mesh_model_server_cfg_t const *const p_cfg)
 
fsp_err_t RM_MESH_CONFIG_SRV_Close (rm_ble_mesh_model_server_ctrl_t *const p_ctrl)
 
fsp_err_t RM_MESH_CONFIG_SRV_StateUpdate (rm_ble_mesh_model_server_ctrl_t *const p_ctrl, rm_ble_mesh_access_server_state_t const *const p_state)
 

Detailed Description

Overview

Target Devices

The BLE Mesh Network Config Server module supports the following devices.

Configuration

Build Time Configurations for rm_mesh_config_srv

The following build time configurations are defined in fsp_cfg/rm_mesh_config_srv_cfg.h:

ConfigurationOptionsDefaultDescription

Configurations for Networking > BLE Mesh Network modules > BLE Mesh Config Server (rm_mesh_config_srv)

This module can be added to the Stacks tab via New Stack > Networking > BLE Mesh Network modules > BLE Mesh Config Server (rm_mesh_config_srv).

ConfigurationOptionsDefaultDescription
Interrupts
CallbackName Must Be a Valid C SymbolNULL Callback provided when mesh config client ISR occurs
Callback Provided When an Timeout ISR OccursName Must Be a Valid C SymbolNULL Callback provided when mesh generic admin property server timeout ISR occurs
NameName Must Be a Valid C Symbolg_rm_mesh_config_srv0 Module name.

Data Structures

struct  rm_mesh_config_srv_instance_ctrl_t
 

Data Structure Documentation

◆ rm_mesh_config_srv_instance_ctrl_t

struct rm_mesh_config_srv_instance_ctrl_t

BLE mesh config instance control block. DO NOT INITIALIZE. Initialization occurs when RM_MESH_CONFIG_SRV_Open() is called.

Function Documentation

◆ RM_MESH_CONFIG_SRV_Open()

fsp_err_t RM_MESH_CONFIG_SRV_Open ( rm_ble_mesh_model_server_ctrl_t *const  p_ctrl,
rm_ble_mesh_model_server_cfg_t const *const  p_cfg 
)

API to initialize configuration server model. This is to initialize configuration server model and to register with Access layer.

Implements rm_ble_mesh_model_server_api_t::open.

Example:

/* Open the module. */
err = RM_MESH_CONFIG_SRV_Open(&g_mesh_config_srv0_ctrl, &g_mesh_config_srv0_cfg);
Return values
FSP_SUCCESSModel opened successfully.
FSP_ERR_ASSERTIONPointer to control block or configuration structure is NULL.
FSP_ERR_ALREADY_OPENModel is already open.
FSP_ERR_NOT_FOUNDThe number of models has exceeded the limit.
FSP_ERR_ABORTEDModel initialization is failed.

◆ RM_MESH_CONFIG_SRV_Close()

fsp_err_t RM_MESH_CONFIG_SRV_Close ( rm_ble_mesh_model_server_ctrl_t *const  p_ctrl)

API to terminate configuration server model. This is to terminate configuration server model and to register with Access layer.

Implements rm_ble_mesh_model_server_api_t::close.

Example:

/* Close the module. */
err = RM_MESH_CONFIG_SRV_Close(&g_mesh_config_srv0_ctrl);
Return values
FSP_SUCCESSModel successfully closed.
FSP_ERR_ASSERTIONThe parameter p_ctrl is NULL.
FSP_ERR_NOT_OPENModel is not open.

◆ RM_MESH_CONFIG_SRV_StateUpdate()

fsp_err_t RM_MESH_CONFIG_SRV_StateUpdate ( rm_ble_mesh_model_server_ctrl_t *const  p_ctrl,
rm_ble_mesh_access_server_state_t const *const  p_state 
)

API to send reply or to update state change. This is to send reply for a request or to inform change in state.

Implements rm_ble_mesh_model_server_api_t::stateUpdate.

Example:

/* Update server status. */
err = RM_MESH_CONFIG_SRV_StateUpdate(&g_mesh_config_srv0_ctrl, &state);
Return values
FSP_ERR_UNSUPPORTEDThis function is unsupported.