RA Flexible Software Package Documentation  Release v5.2.0

 
BLE Mesh Network Generic Manufacturer Property Server (rm_mesh_generic_mfr_prop_srv)

Functions

fsp_err_t RM_MESH_GENERIC_MFR_PROP_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_GENERIC_MFR_PROP_SRV_Close (rm_ble_mesh_model_server_ctrl_t *const p_ctrl)
 
fsp_err_t RM_MESH_GENERIC_MFR_PROP_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 Generic Manufacturer Property Server module supports the following devices.

Configuration

Build Time Configurations for rm_mesh_generic_mfr_prop_srv

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

ConfigurationOptionsDefaultDescription

Configurations for Networking > BLE Mesh Network modules > BLE Mesh Model Generic Manufacturer Property Server (rm_mesh_generic_mfr_prop_srv)

This module can be added to the Stacks tab via New Stack > Networking > BLE Mesh Network modules > BLE Mesh Model Generic Manufacturer Property Server (rm_mesh_generic_mfr_prop_srv).

ConfigurationOptionsDefaultDescription
Interrupts
Callback Provided When Timeout OccursName Must Be a Valid C SymbolNULL Callback provided when mesh generic manufacturer property server ISR occurs
Callback Provided When an Timeout ISR OccursName Must be a Valid C SymbolNULL Callback provided when mesh generic manufacturer property server timeout ISR occurs
NameName Must Be a Valid C Symbolg_rm_mesh_generic_mfr_prop_srv0 Module name.

Data Structures

struct  rm_mesh_generic_mfr_prop_srv_info_t
 
struct  rm_mesh_generic_mfr_prop_srv_instance_ctrl_t
 

Data Structure Documentation

◆ rm_mesh_generic_mfr_prop_srv_info_t

struct rm_mesh_generic_mfr_prop_srv_info_t

Generic Manufacturer Property is a state representing a device property of an element that is programmed by a manufacturer and can be read

Data Fields
uint16_t property_id

Manufacturer Property ID field is a 2-octet Assigned Number value that references a device property

uint8_t user_access

Manufacturer User Access field is an enumeration indicating whether or not the device property can be read as a Generic User Property

uint8_t * property_value

Manufacturer Property Value field is a conditional field

uint16_t property_value_len

◆ rm_mesh_generic_mfr_prop_srv_instance_ctrl_t

struct rm_mesh_generic_mfr_prop_srv_instance_ctrl_t

BLE mesh generic mfr prop instance control block. DO NOT INITIALIZE. Initialization occurs when RM_MESH_GENERIC_MFR_PROP_SRV_Open() is called.

Function Documentation

◆ RM_MESH_GENERIC_MFR_PROP_SRV_Open()

fsp_err_t RM_MESH_GENERIC_MFR_PROP_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 Generic_Manufacturer_Property Server model. This is to initialize Generic_Manufacturer_Property Server model and to register with Access layer.

Implements rm_ble_mesh_model_server_api_t::open.

Example:

/* Open the module. */
err = RM_MESH_GENERIC_MFR_PROP_SRV_Open(&g_mesh_generic_mfr_prop_srv0_ctrl, &g_mesh_generic_mfr_prop_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_GENERIC_MFR_PROP_SRV_Close()

fsp_err_t RM_MESH_GENERIC_MFR_PROP_SRV_Close ( rm_ble_mesh_model_server_ctrl_t *const  p_ctrl)

API to terminate Generic_Manufacturer_Property Server model. This is to terminate Generic_Manufacturer_Property Server model and to register with Access layer.

Implements rm_ble_mesh_model_server_api_t::close.

Example:

/* Close the module. */
err = RM_MESH_GENERIC_MFR_PROP_SRV_Close(&g_mesh_generic_mfr_prop_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_GENERIC_MFR_PROP_SRV_StateUpdate()

fsp_err_t RM_MESH_GENERIC_MFR_PROP_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_GENERIC_MFR_PROP_SRV_StateUpdate(&g_mesh_generic_mfr_prop_srv0_ctrl, &state);
Return values
FSP_SUCCESSUpdated server status successfully.
FSP_ERR_ASSERTIONThe parameter p_ctrl is NULL.
FSP_ERR_INVALID_POINTERThe parameter p_state is NULL.
FSP_ERR_NOT_OPENModel is not open.
FSP_ERR_INVALID_ARGUMENTInput parameter is invalid.
FSP_ERR_APPROXIMATIONLower layer is invalid state.
FSP_ERR_NOT_FOUNDInput parameter is not found.
FSP_ERR_INVALID_ADDRESSInvalid source address.
FSP_ERR_OUT_OF_MEMORYMemory allocation is failed.
FSP_ERR_OVERFLOWTX queue is full.
FSP_ERR_UNDERFLOWTX queue is empty.
FSP_ERR_ABORTEDOperation is failed.