Configurable ZBOSS memory sizes

Detailed Description

With ZBOSS configurable memory feature SDK user can configure some internal ZBOSS memory sizes at application compile time.

Normally sizes of all ZBOSS internal data structures are fixed during ZBOSS library build, so user of the SDK is not able to change them.

To configure memory sizes, an application must include into one of its source files one of memory configuration pre-sets: zb_mem_config_max.h, zb_mem_config_med.h or zb_mem_config_min.h. It is also possible for application to create its own pre-set basing on values from some of zb_mem_config_xxx.h.

Example:

#define ZB_TRACE_FILE_ID 40244
#include "zboss_api.h"
#include "zb_led_button.h"
#include "zb_on_off_switch.h"
/* Insert that include before any code or declaration. */
#ifdef ZB_CONFIGURABLE_MEM
#include "zb_mem_config_max.h"
#endif
/* Next define clusters, attributes etc. */

If user does not configure memory sizes, default parameters defined in zb_vendor.h at ZBOSS library compile time will be used. There are separate default parameters sets for ZC/ZR and ZED libraries.

There are currently 4 settings in memory configuration defined in zb_mem_config_xxx.h:

• Device role: ZB_CONFIG_ROLE_ZC/ZB_CONFIG_ROLE_ZR/ZB_CONFIG_ROLE_ZED. ZB_CONFIG_ROLE_ZED is set automatically if ZBOSS library and application compiled with ZB_ED_ROLE define (RFD ZBOSS library). ZB_CONFIG_ROLE_ZC is the default for FFD ZBOSS library. Set device role to ZB_CONFIG_ROLE_ZR if device is for sure ZR.

• Total number of devices in the network: ZB_CONFIG_OVERALL_NETWORK_SIZE

• Total (routing and application) traffic going thru that device: ZB_CONFIG_HIGH_TRAFFIC/ZB_CONFIG_MODERATE_TRAFFIC/ZB_CONFIG_LIGHT_TRAFFIC

• Complexity of the links from the application running on device to external world: ZB_CONFIG_APPLICATION_COMPLEX/ZB_CONFIG_APPLICATION_MODERATE/ZB_CONFIG_APPLICATION_SIMPLE.

That 4 settings defines optimal storage parameters values. User still can fine-tune storage constants. To do so clone some zb_mem_config_xxx.h file and re-define constants after including of zb_mem_config_common.h. Note that manual setting of the storage parameters may destabilize ZBOSS and must be done with care only if SDK user exactly knows which parameter can be changed and in which diapason.

Macro Definition Documentation

◆ ZB_CONFIG_APPLICATION_COMPLEX

◆ ZB_CONFIG_APPLICATION_MODERATE

◆ ZB_CONFIG_APPLICATION_SIMPLE

◆ ZB_CONFIG_HIGH_TRAFFIC

◆ ZB_CONFIG_LIGHT_TRAFFIC

◆ ZB_CONFIG_MODERATE_TRAFFIC

◆ ZB_CONFIG_OVERALL_NETWORK_SIZE

◆ ZB_CONFIG_ROLE_ZC

◆ ZB_CONFIG_ROLE_ZED

◆ ZB_CONFIG_ROLE_ZR