License#
Copyright 2018 Silicon Laboratories Inc. www.silabs.com
SPDX-License-Identifier: Zlib
The licensor of this software is Silicon Laboratories Inc.
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
This notice may not be removed or altered from any source distribution.
/***************************************************************************/
/*
* Application developers should \b not modify any portion
* of this file. Doing so may cause mysterious bugs. Allocations should be
* adjusted only by defining the appropriate macros in the application's
* CONFIGURATION_HEADER.
*/
#ifndef __EMBER_CONFIGURATION_DEFAULTS_H__
#define __EMBER_CONFIGURATION_DEFAULTS_H__
#if defined(SL_COMPONENT_CATALOG_PRESENT)
#include "sl_component_catalog.h"
#endif
#if defined(SL_CATALOG_CONNECT_STACK_COMMON_PRESENT)
#include "stack-common-config.h"
#endif
#if defined(SL_CATALOG_CONNECT_FREQUENCY_HOPPING_PRESENT)
#include "frequency-hopping-config.h"
#endif
#if defined(SL_CATALOG_CONNECT_PARENT_SUPPORT_PRESENT)
#include "parent-support-config.h"
#endif
#if defined(SL_CATALOG_CONNECT_MAC_QUEUE_PRESENT)
#include "mac-queue-config.h"
#endif
// TODO: include here other stack components configuration headers
#ifndef EMBER_HEAP_SIZE
#define EMBER_HEAP_SIZE 2000
#endif
#ifndef EMBER_CHILD_TABLE_SIZE
#define EMBER_CHILD_TABLE_SIZE 0
#endif
#define EMBER_CHILD_TABLE_TOKEN_SIZE EMBER_CHILD_TABLE_SIZE
#ifndef EMBER_CHILD_TIMEOUT_SEC
#define EMBER_CHILD_TIMEOUT_SEC 3600
#endif
#ifdef EMBER_CHILD_TABLE_MAX_TIMEOUT_S
#if (EMBER_CHILD_TIMEOUT_SEC > EMBER_CHILD_TABLE_MAX_TIMEOUT_S)
#error "Invalid child table timeout value"
#endif
#endif
#ifndef EMBER_INDIRECT_QUEUE_SIZE
#define EMBER_INDIRECT_QUEUE_SIZE 0
#endif
#ifndef EMBER_MAC_OUTGOING_QUEUE_SIZE
#define EMBER_MAC_OUTGOING_QUEUE_SIZE 0
#endif
#ifndef EMBER_INDIRECT_TRANSMISSION_TIMEOUT_MS
#define EMBER_INDIRECT_TRANSMISSION_TIMEOUT_MS 8000
#endif
#ifndef EMBER_NWK_RANGE_EXTENDER_UPDATE_PERIOD_SEC
#define EMBER_NWK_RANGE_EXTENDER_UPDATE_PERIOD_SEC 60
#endif
#ifndef EMBER_MAC_ACK_TIMEOUT_MS
#define EMBER_MAC_ACK_TIMEOUT_MS 25
#endif // EMBER_MAC_ACK_TIMEOUT_MS
#ifndef EMBER_RADIO_CCA_THRESHOLD
#define EMBER_RADIO_CCA_THRESHOLD -65
#endif // EMBER_RADIO_CCA_THRESHOLD
#ifndef EMBER_FREQUENCY_HOPPING_SEED
#define EMBER_FREQUENCY_HOPPING_SEED 0
#endif // EMBER_FREQUENCY_HOPPING_SEED
#ifndef EMBER_FREQUENCY_HOPPING_START_CHANNEL
#define EMBER_FREQUENCY_HOPPING_START_CHANNEL 0
#endif // EMBER_FREQUENCY_HOPPING_START_CHANNEL
#ifndef EMBER_FREQUENCY_HOPPING_END_CHANNEL
#define EMBER_FREQUENCY_HOPPING_END_CHANNEL 24
#endif // EMBER_FREQUENCY_HOPPING_END_CHANNEL
#ifndef EMBER_FREQUENCY_HOPPING_CHANNEL_DURATION_MS
#define EMBER_FREQUENCY_HOPPING_CHANNEL_DURATION_MS 400
#endif // EMBER_FREQUENCY_HOPPING_CHANNEL_DURATION_MS
#ifndef EMBER_FREQUENCY_HOPPING_CHANNEL_GUARD_DURATION_MS
#define EMBER_FREQUENCY_HOPPING_CHANNEL_GUARD_DURATION_MS 20
#endif // EMBER_FREQUENCY_HOPPING_CHANNEL_GUARD_DURATION_MS
#ifndef EMBER_FREQUENCY_HOPPING_SERVER_FREQ_INFO_BROADCAST_PERIOD_S
#define EMBER_FREQUENCY_HOPPING_SERVER_FREQ_INFO_BROADCAST_PERIOD_S 15
#endif // EMBER_FREQUENCY_HOPPING_SERVER_FREQ_INFO_BROADCAST_PERIOD_S
#ifndef EMBER_FREQUENCY_HOPPING_SLEEPY_CLIENT_RESYNC_PERIOD_S
#define EMBER_FREQUENCY_HOPPING_SLEEPY_CLIENT_RESYNC_PERIOD_S 60
#endif // EMBER_FREQUENCY_HOPPING_SLEEPY_CLIENT_RESYNC_PERIOD_S
#ifndef EMBER_FREQUENCY_HOPPING_ALWAYS_ON_CLIENT_SYNC_TIMEOUT_S
#define EMBER_FREQUENCY_HOPPING_ALWAYS_ON_CLIENT_SYNC_TIMEOUT_S (100)
#endif // EMBER_FREQUENCY_HOPPING_ALWAYS_ON_CLIENT_SYNC_TIMEOUT_S
#ifndef EMBER_FREQUENCY_HOPPING_SERVER_ADVERTISING_ITERATION_COUNT
#define EMBER_FREQUENCY_HOPPING_SERVER_ADVERTISING_ITERATION_COUNT (3)
#endif // EMBER_FREQUENCY_HOPPING_SERVER_ADVERTISING_ITERATION_COUNT
#ifndef EMBER_COORDINATOR_FIRST_SHORT_ID_TO_BE_ASSIGNED
#define EMBER_COORDINATOR_FIRST_SHORT_ID_TO_BE_ASSIGNED 1
#endif // EMBER_COORDINATOR_FIRST_SHORT_ID_TO_BE_ASSIGNED
#ifndef EMBER_SECURITY_SHORT_TO_LONG_MAPPING_TABLE_SIZE
#define EMBER_SECURITY_SHORT_TO_LONG_MAPPING_TABLE_SIZE 10
#endif // EMBER_SECURITY_SHORT_TO_LONG_MAPPING_TABLE_SIZE
#ifndef EMBER_DEFAULT_TX_POWER_DECI_DBM
#define EMBER_DEFAULT_TX_POWER_DECI_DBM 0
#endif // EMBER_DEFAULT_TX_POWER_DECI_DBM
#endif //__EMBER_CONFIGURATION_DEFAULTS_H__
Macros#
The size in bytes of the Ember heap. See Memory Buffer for more details.
The maximum number of children supported by the device. Can be configured from 0 to 64. 11B of token space is allocated for each child in the table.
Every child should exchange regularly some sort of traffic with the parent. Eventually, if traffic is not exchanged for a prolonged period of time, the parent may remove the child from the child table. In particular the parent shall remove the oldest stale child whenever the child table is full and there is the need of making room for a new child. Range extenders periodically exchange network-level commands with the coordinator. End devices and sleepy end devices can use emberPollForData() as keep alive mechanism, or use the Poll Plugin plugin. The maximum allowed timeout value is EMBER_CHILD_TABLE_MAX_TIMEOUT_S. Setting the timeout value to EMBER_CHILD_TABLE_AGING_DISABLED disables aging of the child table.
Indirect queue is used on a parent to store a message intended for a sleepy end device, this configures the size of that queue. Configure it to 0 if parent support plugin is not used.
MAC Outgoing paclet queue is to store messages until the radio is available to send it (In most cases, the radio is unavailable because it's already transmitting). The configures the size of that queue.
The maximum amount of time (in milliseconds) that the MAC will hold a message for indirect transmission to a child. The maximum value is 30 seconds (30000 milliseconds).
The period in seconds a range extender sends an update command to the coordinator containing the list of its children.
The ACK timeout in milliseconds. This parameter should be fine-tuned to reduce energy consumption for sleepy devices and depends on the data rate of the PHY configuration used. The maximum allowed value is 65.
The CCA threshold used at the MAC layer for CSMA/CA, in dBm.
The frequency hopping channel sequence generation seed. Can be configured between 0 and 65535. See the Frequency Hopping chapter of UG235.03 for more details.
The lowest channel on the frequency hopping list. See the Frequency Hopping chapter of UG235.03 for more details.
The highest channel on the frequency hopping list. See the Frequency Hopping chapter of UG235.03 for more details.
The time in milliseconds to stay on each channel for frequency hopping. See the Frequency Hopping chapter of UG235.03 for more details.
The time in milliseconds to guard each channel while frequency hopping. No MAC activity is allowed when entering or exiting the slot. See the Frequency Hopping chapter of UG235.03 for more details.
The duration in seconds after which the server should broadcast its frequency hopping information to allow clients to realign. See the Frequency Hopping chapter of UG235.03 for more details.
The duration in seconds after which a sleepy client should resync with the server if the last resync happened more than this duration ago. See the Frequency Hopping chapter of UG235.03 for more details.
The maximum duration in seconds a non sleepy client would keep hopping without receiving frequency hopping information from the server, after which the synchronization with the server is deemed lost. A special value of EMBER_FREQUENCY_HOPPING_ALWAYS_ON_CLIENT_SYNC_DISABLE_TIMEOUT disables this timeout.
When a node is started a frequency hopping server, it will first advertise on all channels to resynchronize all existing clients in case the server was started as result of a reboot. This parameter defines the number of iterations over the entire hopping sequence.
An EMBER_STAR_COORDINATOR assigns short IDs to other nodes in the star network sequentially starting from this short ID. This option provides a simple effective way to reserve an pool of short addresses for commissioning.
The size of the short-to-long address mapping table. See emberMacAddShortToLongAddressMapping for more details.
The default TX power that the radio should use. If no TX power has been specified by emberSetRadioPower, the stack will use this value.
Macro Definition Documentation#
EMBER_HEAP_SIZE#
#define EMBER_HEAP_SIZEValue:
2000
The size in bytes of the Ember heap. See Memory Buffer for more details.
Warnings
This should be configured from the Parent Support plugin options.
90
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_CHILD_TABLE_SIZE#
#define EMBER_CHILD_TABLE_SIZEValue:
0
The maximum number of children supported by the device. Can be configured from 0 to 64. 11B of token space is allocated for each child in the table.
Note
It's recommended to set it to 64 for EMBER_STAR_COORDINATOR, 32 for EMBER_STAR_RANGE_EXTENDER and 0 for anything else.
Warnings
This should be configured from the Parent Support plugin options.
102
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_CHILD_TABLE_TOKEN_SIZE#
#define EMBER_CHILD_TABLE_TOKEN_SIZEValue:
EMBER_CHILD_TABLE_SIZE
105
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_CHILD_TIMEOUT_SEC#
#define EMBER_CHILD_TIMEOUT_SECValue:
3600
Every child should exchange regularly some sort of traffic with the parent. Eventually, if traffic is not exchanged for a prolonged period of time, the parent may remove the child from the child table. In particular the parent shall remove the oldest stale child whenever the child table is full and there is the need of making room for a new child. Range extenders periodically exchange network-level commands with the coordinator. End devices and sleepy end devices can use emberPollForData() as keep alive mechanism, or use the Poll Plugin plugin. The maximum allowed timeout value is EMBER_CHILD_TABLE_MAX_TIMEOUT_S. Setting the timeout value to EMBER_CHILD_TABLE_AGING_DISABLED disables aging of the child table.
Warnings
This should be configured from the Parent Support plugin options.
123
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_INDIRECT_QUEUE_SIZE#
#define EMBER_INDIRECT_QUEUE_SIZEValue:
0
Indirect queue is used on a parent to store a message intended for a sleepy end device, this configures the size of that queue. Configure it to 0 if parent support plugin is not used.
Warnings
This should be configured from the Parent Support plugin options.
139
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_MAC_OUTGOING_QUEUE_SIZE#
#define EMBER_MAC_OUTGOING_QUEUE_SIZEValue:
0
MAC Outgoing paclet queue is to store messages until the radio is available to send it (In most cases, the radio is unavailable because it's already transmitting). The configures the size of that queue.
Warnings
This should be configured from the MAC Packet Queue plugin options.
149
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_INDIRECT_TRANSMISSION_TIMEOUT_MS#
#define EMBER_INDIRECT_TRANSMISSION_TIMEOUT_MSValue:
8000
The maximum amount of time (in milliseconds) that the MAC will hold a message for indirect transmission to a child. The maximum value is 30 seconds (30000 milliseconds).
Warnings
This should be configured from the Parent Support plugin options.
159
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_NWK_RANGE_EXTENDER_UPDATE_PERIOD_SEC#
#define EMBER_NWK_RANGE_EXTENDER_UPDATE_PERIOD_SECValue:
60
The period in seconds a range extender sends an update command to the coordinator containing the list of its children.
This option is only used on EMBER_STAR_RANGE_EXTENDER device.
168
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_MAC_ACK_TIMEOUT_MS#
#define EMBER_MAC_ACK_TIMEOUT_MSValue:
25
The ACK timeout in milliseconds. This parameter should be fine-tuned to reduce energy consumption for sleepy devices and depends on the data rate of the PHY configuration used. The maximum allowed value is 65.
177
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_RADIO_CCA_THRESHOLD#
#define EMBER_RADIO_CCA_THRESHOLDValue:
-65
The CCA threshold used at the MAC layer for CSMA/CA, in dBm.
Warnings
This should be configured from the Connect Stack plugin options.
185
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_SEED#
#define EMBER_FREQUENCY_HOPPING_SEEDValue:
0
The frequency hopping channel sequence generation seed. Can be configured between 0 and 65535. See the Frequency Hopping chapter of UG235.03 for more details.
194
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_START_CHANNEL#
#define EMBER_FREQUENCY_HOPPING_START_CHANNELValue:
0
The lowest channel on the frequency hopping list. See the Frequency Hopping chapter of UG235.03 for more details.
202
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_END_CHANNEL#
#define EMBER_FREQUENCY_HOPPING_END_CHANNELValue:
24
The highest channel on the frequency hopping list. See the Frequency Hopping chapter of UG235.03 for more details.
210
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_CHANNEL_DURATION_MS#
#define EMBER_FREQUENCY_HOPPING_CHANNEL_DURATION_MSValue:
400
The time in milliseconds to stay on each channel for frequency hopping. See the Frequency Hopping chapter of UG235.03 for more details.
218
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_CHANNEL_GUARD_DURATION_MS#
#define EMBER_FREQUENCY_HOPPING_CHANNEL_GUARD_DURATION_MSValue:
20
The time in milliseconds to guard each channel while frequency hopping. No MAC activity is allowed when entering or exiting the slot. See the Frequency Hopping chapter of UG235.03 for more details.
227
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_SERVER_FREQ_INFO_BROADCAST_PERIOD_S#
#define EMBER_FREQUENCY_HOPPING_SERVER_FREQ_INFO_BROADCAST_PERIOD_SValue:
15
The duration in seconds after which the server should broadcast its frequency hopping information to allow clients to realign. See the Frequency Hopping chapter of UG235.03 for more details.
236
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_SLEEPY_CLIENT_RESYNC_PERIOD_S#
#define EMBER_FREQUENCY_HOPPING_SLEEPY_CLIENT_RESYNC_PERIOD_SValue:
60
The duration in seconds after which a sleepy client should resync with the server if the last resync happened more than this duration ago. See the Frequency Hopping chapter of UG235.03 for more details.
245
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_ALWAYS_ON_CLIENT_SYNC_TIMEOUT_S#
#define EMBER_FREQUENCY_HOPPING_ALWAYS_ON_CLIENT_SYNC_TIMEOUT_SValue:
(100)
The maximum duration in seconds a non sleepy client would keep hopping without receiving frequency hopping information from the server, after which the synchronization with the server is deemed lost. A special value of EMBER_FREQUENCY_HOPPING_ALWAYS_ON_CLIENT_SYNC_DISABLE_TIMEOUT disables this timeout.
256
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_FREQUENCY_HOPPING_SERVER_ADVERTISING_ITERATION_COUNT#
#define EMBER_FREQUENCY_HOPPING_SERVER_ADVERTISING_ITERATION_COUNTValue:
(3)
When a node is started a frequency hopping server, it will first advertise on all channels to resynchronize all existing clients in case the server was started as result of a reboot. This parameter defines the number of iterations over the entire hopping sequence.
266
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_COORDINATOR_FIRST_SHORT_ID_TO_BE_ASSIGNED#
#define EMBER_COORDINATOR_FIRST_SHORT_ID_TO_BE_ASSIGNEDValue:
1
An EMBER_STAR_COORDINATOR assigns short IDs to other nodes in the star network sequentially starting from this short ID. This option provides a simple effective way to reserve an pool of short addresses for commissioning.
276
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_SECURITY_SHORT_TO_LONG_MAPPING_TABLE_SIZE#
#define EMBER_SECURITY_SHORT_TO_LONG_MAPPING_TABLE_SIZEValue:
10
The size of the short-to-long address mapping table. See emberMacAddShortToLongAddressMapping for more details.
This table is only used for EMBER_MAC_MODE_DEVICE and EMBER_MAC_MODE_SLEEPY_DEVICE, but the memory will be allocated on all device types.
287
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h
EMBER_DEFAULT_TX_POWER_DECI_DBM#
#define EMBER_DEFAULT_TX_POWER_DECI_DBMValue:
0
The default TX power that the radio should use. If no TX power has been specified by emberSetRadioPower, the stack will use this value.
295
of file /mnt/raid/workspaces/ws.2dqDELv9z/overlay/gsdk/protocol/flex/stack/config/ember-configuration-defaults.h