mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
2bba9d7700
1. Clean up client_common.c 2. Clean up esp_ble_mesh directory 3. Update Kconfig.in 4. Format esp_ble_mesh files
933 lines
39 KiB
Plaintext
933 lines
39 KiB
Plaintext
if BLE_MESH
|
||
|
||
config BLE_MESH_HCI_5_0
|
||
bool "Support sending 20ms non-connectable adv packets"
|
||
default y
|
||
help
|
||
It is a temporary solution and needs further modifications.
|
||
|
||
config BLE_MESH_USE_DUPLICATE_SCAN
|
||
bool "Support Duplicate Scan in BLE Mesh"
|
||
depends on BT_BLUEDROID_ENABLED
|
||
select BLE_SCAN_DUPLICATE
|
||
select BLE_MESH_SCAN_DUPLICATE_EN
|
||
default y
|
||
help
|
||
Enable this option to allow using specific duplicate scan filter
|
||
in BLE Mesh, and Scan Duplicate Type must be set by choosing the
|
||
option in the Bluetooth Controller section in menuconfig, which is
|
||
"Scan Duplicate By Device Address and Advertising Data".
|
||
|
||
config BLE_MESH_FAST_PROV
|
||
bool "Enable BLE Mesh Fast Provisioning"
|
||
select BLE_MESH_NODE
|
||
select BLE_MESH_PROVISIONER
|
||
select BLE_MESH_PB_ADV
|
||
default n
|
||
help
|
||
Enable this option to allow BLE Mesh fast provisioning solution to be used.
|
||
When there are multiple unprovisioned devices around, fast provisioning can
|
||
greatly reduce the time consumption of the whole provisioning process.
|
||
When this option is enabled, and after an unprovisioned device is provisioned
|
||
into a node successfully, it can be changed to a temporary Provisioner.
|
||
|
||
config BLE_MESH_NODE
|
||
bool "Support for BLE Mesh Node"
|
||
help
|
||
Enable the device to be provisioned into a node. This option should be
|
||
enabled when an unprovisioned device is going to be provisioned into a
|
||
node and communicate with other nodes in the BLE Mesh network.
|
||
|
||
config BLE_MESH_PROVISIONER
|
||
bool "Support for BLE Mesh Provisioner"
|
||
help
|
||
Enable the device to be a Provisioner. The option should be enabled when
|
||
a device is going to act as a Provisioner and provision unprovisioned
|
||
devices into the BLE Mesh network.
|
||
|
||
if BLE_MESH_PROVISIONER
|
||
|
||
config BLE_MESH_WAIT_FOR_PROV_MAX_DEV_NUM
|
||
int "Maximum number of unprovisioned devices that can be added to device queue"
|
||
default 20
|
||
range 1 100
|
||
help
|
||
This option specifies how many unprovisioned devices can be added to device
|
||
queue for provisioning. Users can use this option to define the size of the
|
||
queue in the bottom layer which is used to store unprovisioned device
|
||
information (e.g. Device UUID, address).
|
||
|
||
config BLE_MESH_MAX_STORED_NODES
|
||
int "Maximum number of nodes whose information can be stored"
|
||
default 20
|
||
range BLE_MESH_MAX_PROV_NODES 1000
|
||
help
|
||
This option specifies the maximum number of nodes whose information can be
|
||
stored by a Provisioner in its upper layer.
|
||
Users can change this value according to the number of nodes whose information
|
||
(e.g. Device UUID, unicast address, element number) are going to be stored by
|
||
a Provisioner. And the nodes include the provisioned ones and user-added ones.
|
||
|
||
config BLE_MESH_MAX_PROV_NODES
|
||
int "Maximum number of devices that can be provisioned by Provisioner"
|
||
default 20
|
||
range 1 1000
|
||
help
|
||
This option specifies how many devices can be provisioned by a Provisioner.
|
||
This value indicates the maximum number of unprovisioned devices which can be
|
||
provisioned by a Provisioner. For instance,if the value is 6, it means the
|
||
Provisioner can provision up to 6 unprovisioned devices.
|
||
Theoretically a Provisioner without the limitation of its memory can provision
|
||
up to 32766 unprovisioned devices, here we limit the maximum number to 100
|
||
just to limit the memory used by a Provisioner. The bigger the value is, the
|
||
more memory it will cost by a Provisioner to store the information of nodes.
|
||
|
||
if BLE_MESH_PB_ADV
|
||
config BLE_MESH_PBA_SAME_TIME
|
||
int "Maximum number of PB-ADV running at the same time by Provisioner"
|
||
default 2
|
||
range 1 10
|
||
help
|
||
This option specifies how many devices can be provisioned at the same time
|
||
using PB-ADV. For examples, if the value is 2, it means a Provisioner can
|
||
provision two unprovisioned devices with PB-ADV at the same time.
|
||
|
||
endif # BLE_MESH_PB_ADV
|
||
|
||
if BLE_MESH_PB_GATT
|
||
config BLE_MESH_PBG_SAME_TIME
|
||
int "Maximum number of PB-GATT running at the same time by Provisioner"
|
||
default 1
|
||
range 1 5
|
||
help
|
||
This option specifies how many devices can be provisioned at the same
|
||
time using PB-GATT. For example, if the value is 2, it means a Provisioner
|
||
can provision two unprovisioned devices with PB-GATT at the same time.
|
||
|
||
endif # BLE_MESH_PB_GATT
|
||
|
||
config BLE_MESH_PROVISIONER_SUBNET_COUNT
|
||
int "Maximum number of mesh subnets that can be created by Provisioner"
|
||
default 3
|
||
range 1 4096
|
||
help
|
||
This option specifies how many subnets per network a Provisioner can create.
|
||
Indeed, this value decides the number of network keys which can be added by a Provisioner.
|
||
|
||
config BLE_MESH_PROVISIONER_APP_KEY_COUNT
|
||
int "Maximum number of application keys that can be owned by Provisioner"
|
||
default 9
|
||
range 1 4096
|
||
help
|
||
This option specifies how many application keys the Provisioner can have.
|
||
Indeed, this value decides the number of the application keys which can be added by a Provisioner.
|
||
|
||
endif # BLE_MESH_PROVISIONER
|
||
|
||
# Virtual option enabled whenever Generic Provisioning layer is needed
|
||
config BLE_MESH_PROV
|
||
bool "BLE Mesh Provisioning support"
|
||
default y
|
||
help
|
||
Enable this option to support BLE Mesh Provisioning functionality. For
|
||
BLE Mesh, this option should be always enabled.
|
||
|
||
config BLE_MESH_PB_ADV
|
||
bool "Provisioning support using the advertising bearer (PB-ADV)"
|
||
select BLE_MESH_PROV
|
||
default y
|
||
help
|
||
Enable this option to allow the device to be provisioned over the
|
||
advertising bearer. This option should be enabled if PB-ADV is
|
||
going to be used during provisioning procedure.
|
||
|
||
config BLE_MESH_PB_GATT
|
||
bool "Provisioning support using GATT (PB-GATT)"
|
||
select BLE_MESH_PROXY
|
||
select BLE_MESH_PROV
|
||
help
|
||
Enable this option to allow the device to be provisioned over GATT.
|
||
This option should be enabled if PB-GATT is going to be used during
|
||
provisioning procedure.
|
||
|
||
# Virtual option enabled whenever any Proxy protocol is needed
|
||
config BLE_MESH_PROXY
|
||
bool "BLE Mesh Proxy protocol support"
|
||
default y
|
||
help
|
||
Enable this option to support BLE Mesh Proxy protocol used by PB-GATT
|
||
and other proxy pdu transmission.
|
||
|
||
config BLE_MESH_GATT_PROXY_SERVER
|
||
bool "BLE Mesh GATT Proxy Server"
|
||
select BLE_MESH_PROXY
|
||
depends on BLE_MESH_NODE
|
||
default y
|
||
help
|
||
This option enables support for Mesh GATT Proxy Service, i.e. the
|
||
ability to act as a proxy between a Mesh GATT Client and a Mesh network.
|
||
This option should be enabled if a node is going to be a Proxy Server.
|
||
|
||
config BLE_MESH_GATT_PROXY_CLIENT
|
||
bool "BLE Mesh GATT Proxy Client"
|
||
select BLE_MESH_PROXY
|
||
default n
|
||
help
|
||
This option enables support for Mesh GATT Proxy Client. The Proxy Client
|
||
can use the GATT bearer to send mesh messages to a node that supports the
|
||
advertising bearer.
|
||
|
||
config BLE_MESH_NODE_ID_TIMEOUT
|
||
int "Node Identity advertising timeout"
|
||
depends on BLE_MESH_GATT_PROXY_SERVER
|
||
range 1 60
|
||
default 60
|
||
help
|
||
This option determines for how long the local node advertises using
|
||
Node Identity. The given value is in seconds. The specification limits
|
||
this to 60 seconds and lists it as the recommended value as well.
|
||
So leaving the default value is the safest option.
|
||
When an unprovisioned device is provisioned successfully and becomes a
|
||
node, it will start to advertise using Node Identity during the time
|
||
set by this option. And after that, Network ID will be advertised.
|
||
|
||
if BLE_MESH_PROXY
|
||
|
||
config BLE_MESH_PROXY_FILTER_SIZE
|
||
int "Maximum number of filter entries per Proxy Client"
|
||
default 1
|
||
default 3 if BLE_MESH_GATT_PROXY_SERVER
|
||
range 1 32767
|
||
help
|
||
This option specifies how many Proxy Filter entries the local node supports.
|
||
The entries of Proxy filter (whitelist or blacklist) are used to store a
|
||
list of addresses which can be used to decide which messages will be forwarded
|
||
to the Proxy Client by the Proxy Server.
|
||
|
||
endif # BLE_MESH_PROXY
|
||
|
||
config BLE_MESH_NET_BUF_POOL_USAGE
|
||
bool "BLE Mesh net buffer pool usage tracking"
|
||
default y
|
||
help
|
||
Enable BLE Mesh net buffer pool tracking. This option is used to introduce another
|
||
variable in the bottom layer to record the usage of advertising buffers of BLE Mesh
|
||
devices. Recommend to enable this option as default.
|
||
|
||
config BLE_MESH_SETTINGS
|
||
bool "Store BLE Mesh Node configuration persistently"
|
||
default n
|
||
help
|
||
When selected, the BLE Mesh stack will take care of storing/restoring the
|
||
BLE Mesh configuration persistently in flash. Currently this only supports
|
||
storing BLE Mesh node configuration.
|
||
Currently enabling this option will only store BLE Mesh nodes' information
|
||
in the flash.
|
||
|
||
if BLE_MESH_SETTINGS
|
||
config BLE_MESH_STORE_TIMEOUT
|
||
int "Delay (in seconds) before storing anything persistently"
|
||
range 0 1000000
|
||
default 0
|
||
help
|
||
This value defines in seconds how soon any pending changes are actually
|
||
written into persistent storage (flash) after a change occurs.
|
||
The option allows nodes to delay a certain period of time to save proper
|
||
information to flash. The default value is 0, which means information
|
||
will be stored immediately once there are updates.
|
||
|
||
config BLE_MESH_SEQ_STORE_RATE
|
||
int "How often the sequence number gets updated in storage"
|
||
range 0 1000000
|
||
default 128
|
||
help
|
||
This value defines how often the local sequence number gets updated in
|
||
persistent storage (i.e. flash). e.g. a value of 100 means that the
|
||
sequence number will be stored to flash on every 100th increment.
|
||
If the node sends messages very frequently a higher value makes more
|
||
sense, whereas if the node sends infrequently a value as low as 0
|
||
(update storage for every increment) can make sense. When the stack
|
||
gets initialized it will add sequence number to the last stored one,
|
||
so that it starts off with a value that's guaranteed to be larger than
|
||
the last one used before power off.
|
||
|
||
config BLE_MESH_RPL_STORE_TIMEOUT
|
||
int "Minimum frequency that the RPL gets updated in storage"
|
||
range 0 1000000
|
||
default 5
|
||
help
|
||
This value defines in seconds how soon the RPL (Replay Protection List)
|
||
gets written to persistent storage after a change occurs. If the node
|
||
receives messages frequently, then a large value is recommended. If the
|
||
node receives messages rarely, then the value can be as low as 0 (which
|
||
means the RPL is written into the storage immediately).
|
||
Note that if the node operates in a security-sensitive case, and there is
|
||
a risk of sudden power-off, then a value of 0 is strongly recommended.
|
||
Otherwise, a power loss before RPL being written into the storage may
|
||
introduce message replay attacks and system security will be in a
|
||
vulnerable state.
|
||
|
||
endif # if BLE_MESH_SETTINGS
|
||
|
||
config BLE_MESH_SUBNET_COUNT
|
||
int "Maximum number of mesh subnets per network"
|
||
default 3
|
||
range 1 4096
|
||
help
|
||
This option specifies how many subnets a Mesh network can have at the same time.
|
||
Indeed, this value decides the number of the network keys which can be owned by a node.
|
||
|
||
config BLE_MESH_APP_KEY_COUNT
|
||
int "Maximum number of application keys per network"
|
||
default 3
|
||
range 1 4096
|
||
help
|
||
This option specifies how many application keys the device can store per network.
|
||
Indeed, this value decides the number of the application keys which can be owned by a node.
|
||
|
||
config BLE_MESH_MODEL_KEY_COUNT
|
||
int "Maximum number of application keys per model"
|
||
default 3
|
||
range 1 4096
|
||
help
|
||
This option specifies the maximum number of application keys to which each model
|
||
can be bound.
|
||
|
||
config BLE_MESH_MODEL_GROUP_COUNT
|
||
int "Maximum number of group address subscriptions per model"
|
||
default 3
|
||
range 1 4096
|
||
help
|
||
This option specifies the maximum number of addresses to which each model can
|
||
be subscribed.
|
||
|
||
config BLE_MESH_LABEL_COUNT
|
||
int "Maximum number of Label UUIDs used for Virtual Addresses"
|
||
default 3
|
||
range 0 4096
|
||
help
|
||
This option specifies how many Label UUIDs can be stored.
|
||
Indeed, this value decides the number of the Virtual Addresses can be supported by a node.
|
||
|
||
config BLE_MESH_CRPL
|
||
int "Maximum capacity of the replay protection list"
|
||
default 10
|
||
range 2 65535
|
||
help
|
||
This option specifies the maximum capacity of the replay protection list.
|
||
It is similar to Network message cache size, but has a different purpose.
|
||
The replay protection list is used to prevent a node from replay attack,
|
||
which will store the source address and sequence number of the received
|
||
mesh messages.
|
||
|
||
config BLE_MESH_MSG_CACHE_SIZE
|
||
int "Network message cache size"
|
||
default 10
|
||
range 2 65535
|
||
help
|
||
Number of messages that are cached for the network. This helps prevent
|
||
unnecessary decryption operations and unnecessary relays. This option
|
||
is similar to Replay protection list, but has a different purpose.
|
||
A node is not required to cache the entire Network PDU and may cache
|
||
only part of it for tracking, such as values for SRC/SEQ or others.
|
||
|
||
config BLE_MESH_ADV_BUF_COUNT
|
||
int "Number of advertising buffers"
|
||
default 60
|
||
range 6 256
|
||
help
|
||
Number of advertising buffers available. The transport layer reserves
|
||
ADV_BUF_COUNT - 3 buffers for outgoing segments. The maximum outgoing
|
||
SDU size is 12 times this value (out of which 4 or 8 bytes are used
|
||
for the Transport Layer MIC). For example, 5 segments means the maximum
|
||
SDU size is 60 bytes, which leaves 56 bytes for application layer data
|
||
using a 4-byte MIC, or 52 bytes using an 8-byte MIC.
|
||
|
||
config BLE_MESH_IVU_DIVIDER
|
||
int "Divider for IV Update state refresh timer"
|
||
default 4
|
||
range 2 96
|
||
help
|
||
When the IV Update state enters Normal operation or IV Update
|
||
in Progress, we need to keep track of how many hours has passed
|
||
in the state, since the specification requires us to remain in
|
||
the state at least for 96 hours (Update in Progress has an
|
||
additional upper limit of 144 hours).
|
||
|
||
In order to fulfill the above requirement, even if the node might
|
||
be powered off once in a while, we need to store persistently
|
||
how many hours the node has been in the state. This doesn't
|
||
necessarily need to happen every hour (thanks to the flexible
|
||
duration range). The exact cadence will depend a lot on the
|
||
ways that the node will be used and what kind of power source it
|
||
has.
|
||
|
||
Since there is no single optimal answer, this configuration
|
||
option allows specifying a divider, i.e. how many intervals
|
||
the 96 hour minimum gets split into. After each interval the
|
||
duration that the node has been in the current state gets
|
||
stored to flash. E.g. the default value of 4 means that the
|
||
state is saved every 24 hours (96 / 4).
|
||
|
||
config BLE_MESH_TX_SEG_MSG_COUNT
|
||
int "Maximum number of simultaneous outgoing segmented messages"
|
||
default 1
|
||
range 1 BLE_MESH_ADV_BUF_COUNT
|
||
help
|
||
Maximum number of simultaneous outgoing multi-segment and/or reliable messages.
|
||
The default value is 1, which means the device can only send one segmented
|
||
message at a time. And if another segmented message is going to be sent, it
|
||
should wait for the completion of the previous one.
|
||
If users are going to send multiple segmented messages at the same time, this
|
||
value should be configured properly.
|
||
|
||
config BLE_MESH_RX_SEG_MSG_COUNT
|
||
int "Maximum number of simultaneous incoming segmented messages"
|
||
default 1
|
||
range 1 255
|
||
help
|
||
Maximum number of simultaneous incoming multi-segment and/or reliable messages.
|
||
The default value is 1, which means the device can only receive one segmented
|
||
message at a time. And if another segmented message is going to be received,
|
||
it should wait for the completion of the previous one.
|
||
If users are going to receive multiple segmented messages at the same time, this
|
||
value should be configured properly.
|
||
|
||
config BLE_MESH_RX_SDU_MAX
|
||
int "Maximum incoming Upper Transport Access PDU length"
|
||
default 384
|
||
range 36 384
|
||
help
|
||
Maximum incoming Upper Transport Access PDU length. Leave this to the default
|
||
value, unless you really need to optimize memory usage.
|
||
|
||
config BLE_MESH_TX_SEG_MAX
|
||
int "Maximum number of segments in outgoing messages"
|
||
default 20
|
||
range 2 32
|
||
help
|
||
Maximum number of segments supported for outgoing messages.
|
||
This value should typically be fine-tuned based on what
|
||
models the local node supports, i.e. what's the largest
|
||
message payload that the node needs to be able to send.
|
||
This value affects memory and call stack consumption, which
|
||
is why the default is lower than the maximum that the
|
||
specification would allow (32 segments).
|
||
|
||
The maximum outgoing SDU size is 12 times this number (out of
|
||
which 4 or 8 bytes is used for the Transport Layer MIC). For
|
||
example, 5 segments means the maximum SDU size is 60 bytes,
|
||
which leaves 56 bytes for application layer data using a
|
||
4-byte MIC and 52 bytes using an 8-byte MIC.
|
||
|
||
Be sure to specify a sufficient number of advertising buffers
|
||
when setting this option to a higher value. There must be at
|
||
least three more advertising buffers (BLE_MESH_ADV_BUF_COUNT)
|
||
as there are outgoing segments.
|
||
|
||
config BLE_MESH_RELAY
|
||
bool "Relay support"
|
||
depends on BLE_MESH_NODE
|
||
default y
|
||
help
|
||
Support for acting as a Mesh Relay Node. Enabling this option will allow
|
||
a node to support the Relay feature, and the Relay feature can still
|
||
be enabled or disabled by proper configuration messages. Disabling this
|
||
option will let a node not support the Relay feature.
|
||
|
||
if BLE_MESH_RELAY
|
||
|
||
config BLE_MESH_RELAY_ADV_BUF
|
||
bool "Use separate advertising buffers for relay packets"
|
||
default n
|
||
help
|
||
When selected, self-send packets will be put in a high-priority
|
||
queue and relay packets will be put in a low-priority queue.
|
||
|
||
if BLE_MESH_RELAY_ADV_BUF
|
||
|
||
config BLE_MESH_RELAY_ADV_BUF_COUNT
|
||
int "Number of advertising buffers for relay packets"
|
||
default 60
|
||
range 6 256
|
||
help
|
||
Number of advertising buffers for relay packets available.
|
||
|
||
endif # BLE_MESH_RELAY_ADV_BUF
|
||
|
||
endif # BLE_MESH_RELAY
|
||
|
||
config BLE_MESH_LOW_POWER
|
||
bool "Support for Low Power features"
|
||
depends on BLE_MESH_NODE
|
||
help
|
||
Enable this option to operate as a Low Power Node. If low power consumption
|
||
is required by a node, this option should be enabled. And once the node
|
||
enters the mesh network, it will try to find a Friend node and establish a
|
||
friendship.
|
||
|
||
if BLE_MESH_LOW_POWER
|
||
|
||
config BLE_MESH_LPN_ESTABLISHMENT
|
||
bool "Perform Friendship establishment using low power"
|
||
default n
|
||
help
|
||
Perform the Friendship establishment using low power with the help of a
|
||
reduced scan duty cycle. The downside of this is that the node may miss
|
||
out on messages intended for it until it has successfully set up Friendship
|
||
with a Friend node.
|
||
When this option is enabled, the node will stop scanning for a period of
|
||
time after a Friend Request or Friend Poll is sent, so as to reduce more
|
||
power consumption.
|
||
|
||
config BLE_MESH_LPN_AUTO
|
||
bool "Automatically start looking for Friend nodes once provisioned"
|
||
default n
|
||
help
|
||
Once provisioned, automatically enable LPN functionality and start looking
|
||
for Friend nodes. If this option is disabled LPN mode needs to be manually
|
||
enabled by calling bt_mesh_lpn_set(true).
|
||
When an unprovisioned device is provisioned successfully and becomes a node,
|
||
enabling this option will trigger the node starts to send Friend Request at
|
||
a certain period until it finds a proper Friend node.
|
||
|
||
config BLE_MESH_LPN_AUTO_TIMEOUT
|
||
int "Time from last received message before going to LPN mode"
|
||
default 15
|
||
range 0 3600
|
||
depends on BLE_MESH_LPN_AUTO
|
||
help
|
||
Time in seconds from the last received message, that the node waits out
|
||
before starting to look for Friend nodes.
|
||
|
||
config BLE_MESH_LPN_RETRY_TIMEOUT
|
||
int "Retry timeout for Friend requests"
|
||
default 6
|
||
range 1 3600
|
||
help
|
||
Time in seconds between Friend Requests, if a previous Friend Request did
|
||
not yield any acceptable Friend Offers.
|
||
|
||
config BLE_MESH_LPN_RSSI_FACTOR
|
||
int "RSSIFactor, used in Friend Offer Delay calculation"
|
||
range 0 3
|
||
default 0
|
||
help
|
||
The contribution of the RSSI, measured by the Friend node, used in Friend
|
||
Offer Delay calculations. 0 = 1, 1 = 1.5, 2 = 2, 3 = 2.5.
|
||
RSSIFactor, one of the parameters carried by Friend Request sent by Low Power
|
||
node, which is used to calculate the Friend Offer Delay.
|
||
|
||
config BLE_MESH_LPN_RECV_WIN_FACTOR
|
||
int "ReceiveWindowFactor, used in Friend Offer Delay calculation"
|
||
range 0 3
|
||
default 0
|
||
help
|
||
The contribution of the supported Receive Window used in Friend Offer
|
||
Delay calculations. 0 = 1, 1 = 1.5, 2 = 2, 3 = 2.5.
|
||
ReceiveWindowFactor, one of the parameters carried by Friend Request sent by
|
||
Low Power node, which is used to calculate the Friend Offer Delay.
|
||
|
||
config BLE_MESH_LPN_MIN_QUEUE_SIZE
|
||
int "Minimum size of the acceptable friend queue (MinQueueSizeLog)"
|
||
range 1 7
|
||
default 1
|
||
help
|
||
The MinQueueSizeLog field is defined as log_2(N), where N is the minimum
|
||
number of maximum size Lower Transport PDUs that the Friend node can store
|
||
in its Friend Queue. As an example, MinQueueSizeLog value 1 gives N = 2,
|
||
and value 7 gives N = 128.
|
||
|
||
config BLE_MESH_LPN_RECV_DELAY
|
||
int "Receive delay requested by the local node"
|
||
range 10 255
|
||
default 100
|
||
help
|
||
The ReceiveDelay is the time between the Low Power node sending a
|
||
request and listening for a response. This delay allows the Friend
|
||
node time to prepare the response. The value is in units of milliseconds.
|
||
|
||
config BLE_MESH_LPN_POLL_TIMEOUT
|
||
int "The value of the PollTimeout timer"
|
||
range 10 244735
|
||
default 300
|
||
help
|
||
PollTimeout timer is used to measure time between two consecutive
|
||
requests sent by a Low Power node. If no requests are received
|
||
the Friend node before the PollTimeout timer expires, then the
|
||
friendship is considered terminated. The value is in units of 100
|
||
milliseconds, so e.g. a value of 300 means 30 seconds.
|
||
The smaller the value, the faster the Low Power node tries to get
|
||
messages from corresponding Friend node and vice versa.
|
||
|
||
config BLE_MESH_LPN_INIT_POLL_TIMEOUT
|
||
int "The starting value of the PollTimeout timer"
|
||
range 10 BLE_MESH_LPN_POLL_TIMEOUT
|
||
default BLE_MESH_LPN_POLL_TIMEOUT
|
||
help
|
||
The initial value of the PollTimeout timer when Friendship is to be
|
||
established for the first time. After this, the timeout gradually
|
||
grows toward the actual PollTimeout, doubling in value for each iteration.
|
||
The value is in units of 100 milliseconds, so e.g. a value of 300 means
|
||
30 seconds.
|
||
|
||
config BLE_MESH_LPN_SCAN_LATENCY
|
||
int "Latency for enabling scanning"
|
||
range 0 50
|
||
default 10
|
||
help
|
||
Latency (in milliseconds) is the time it takes to enable scanning. In
|
||
practice, it means how much time in advance of the Receive Window, the
|
||
request to enable scanning is made.
|
||
|
||
config BLE_MESH_LPN_GROUPS
|
||
int "Number of groups the LPN can subscribe to"
|
||
range 0 16384
|
||
default 8
|
||
help
|
||
Maximum number of groups to which the LPN can subscribe.
|
||
|
||
endif # BLE_MESH_LOW_POWER
|
||
|
||
config BLE_MESH_FRIEND
|
||
bool "Support for acting as a Friend Node"
|
||
depends on BLE_MESH_NODE
|
||
help
|
||
Enable this option to be able to act as a Friend Node.
|
||
|
||
if BLE_MESH_FRIEND
|
||
|
||
config BLE_MESH_FRIEND_RECV_WIN
|
||
int "Friend Receive Window"
|
||
range 1 255
|
||
default 255
|
||
help
|
||
Receive Window in milliseconds supported by the Friend node.
|
||
|
||
config BLE_MESH_FRIEND_QUEUE_SIZE
|
||
int "Minimum number of buffers supported per Friend Queue"
|
||
range 2 65536
|
||
default 16
|
||
help
|
||
Minimum number of buffers available to be stored for each local Friend Queue.
|
||
This option decides the size of each buffer which can be used by a Friend node
|
||
to store messages for each Low Power node.
|
||
|
||
config BLE_MESH_FRIEND_SUB_LIST_SIZE
|
||
int "Friend Subscription List Size"
|
||
range 0 1023
|
||
default 3
|
||
help
|
||
Size of the Subscription List that can be supported by a Friend node for a
|
||
Low Power node. And Low Power node can send Friend Subscription List Add or
|
||
Friend Subscription List Remove messages to the Friend node to add or remove
|
||
subscription addresses.
|
||
|
||
config BLE_MESH_FRIEND_LPN_COUNT
|
||
int "Number of supported LPN nodes"
|
||
range 1 1000
|
||
default 2
|
||
help
|
||
Number of Low Power Nodes with which a Friend can have Friendship simultaneously.
|
||
A Friend node can have friendship with multiple Low Power nodes at the same time,
|
||
while a Low Power node can only establish friendship with only one Friend node at
|
||
the same time.
|
||
|
||
config BLE_MESH_FRIEND_SEG_RX
|
||
int "Number of incomplete segment lists per LPN"
|
||
range 1 1000
|
||
default 1
|
||
help
|
||
Number of incomplete segment lists tracked for each Friends' LPN.
|
||
In other words, this determines from how many elements can segmented
|
||
messages destined for the Friend queue be received simultaneously.
|
||
|
||
endif # BLE_MESH_FRIEND
|
||
|
||
config BLE_MESH_NO_LOG
|
||
bool "Disable BLE Mesh debug logs (minimize bin size)"
|
||
depends on BLE_MESH
|
||
default n
|
||
help
|
||
Select this to save the BLE Mesh related rodata code size. Enabling this option
|
||
will disable the output of BLE Mesh debug log.
|
||
|
||
menu "BLE Mesh STACK DEBUG LOG LEVEL"
|
||
depends on BLE_MESH && !BLE_MESH_NO_LOG
|
||
|
||
choice BLE_MESH_STACK_TRACE_LEVEL
|
||
prompt "BLE_MESH_STACK"
|
||
default BLE_MESH_TRACE_LEVEL_WARNING
|
||
depends on BLE_MESH && !BLE_MESH_NO_LOG
|
||
help
|
||
Define BLE Mesh trace level for BLE Mesh stack.
|
||
|
||
config BLE_MESH_TRACE_LEVEL_NONE
|
||
bool "NONE"
|
||
config BLE_MESH_TRACE_LEVEL_ERROR
|
||
bool "ERROR"
|
||
config BLE_MESH_TRACE_LEVEL_WARNING
|
||
bool "WARNING"
|
||
config BLE_MESH_TRACE_LEVEL_INFO
|
||
bool "INFO"
|
||
config BLE_MESH_TRACE_LEVEL_DEBUG
|
||
bool "DEBUG"
|
||
config BLE_MESH_TRACE_LEVEL_VERBOSE
|
||
bool "VERBOSE"
|
||
endchoice
|
||
|
||
config BLE_MESH_STACK_TRACE_LEVEL
|
||
int
|
||
depends on BLE_MESH
|
||
default 0 if BLE_MESH_TRACE_LEVEL_NONE
|
||
default 1 if BLE_MESH_TRACE_LEVEL_ERROR
|
||
default 2 if BLE_MESH_TRACE_LEVEL_WARNING
|
||
default 3 if BLE_MESH_TRACE_LEVEL_INFO
|
||
default 4 if BLE_MESH_TRACE_LEVEL_DEBUG
|
||
default 5 if BLE_MESH_TRACE_LEVEL_VERBOSE
|
||
default 2
|
||
|
||
endmenu #BLE Mesh DEBUG LOG LEVEL
|
||
|
||
menu "BLE Mesh NET BUF DEBUG LOG LEVEL"
|
||
depends on BLE_MESH && !BLE_MESH_NO_LOG
|
||
|
||
choice BLE_MESH_NET_BUF_TRACE_LEVEL
|
||
prompt "BLE_MESH_NET_BUF"
|
||
default BLE_MESH_NET_BUF_TRACE_LEVEL_WARNING
|
||
depends on BLE_MESH && !BLE_MESH_NO_LOG
|
||
help
|
||
Define BLE Mesh trace level for BLE Mesh net buffer.
|
||
|
||
config BLE_MESH_NET_BUF_TRACE_LEVEL_NONE
|
||
bool "NONE"
|
||
config BLE_MESH_NET_BUF_TRACE_LEVEL_ERROR
|
||
bool "ERROR"
|
||
config BLE_MESH_NET_BUF_TRACE_LEVEL_WARNING
|
||
bool "WARNING"
|
||
config BLE_MESH_NET_BUF_TRACE_LEVEL_INFO
|
||
bool "INFO"
|
||
config BLE_MESH_NET_BUF_TRACE_LEVEL_DEBUG
|
||
bool "DEBUG"
|
||
config BLE_MESH_NET_BUF_TRACE_LEVEL_VERBOSE
|
||
bool "VERBOSE"
|
||
endchoice
|
||
|
||
config BLE_MESH_NET_BUF_TRACE_LEVEL
|
||
int
|
||
depends on BLE_MESH
|
||
default 0 if BLE_MESH_NET_BUF_TRACE_LEVEL_NONE
|
||
default 1 if BLE_MESH_NET_BUF_TRACE_LEVEL_ERROR
|
||
default 2 if BLE_MESH_NET_BUF_TRACE_LEVEL_WARNING
|
||
default 3 if BLE_MESH_NET_BUF_TRACE_LEVEL_INFO
|
||
default 4 if BLE_MESH_NET_BUF_TRACE_LEVEL_DEBUG
|
||
default 5 if BLE_MESH_NET_BUF_TRACE_LEVEL_VERBOSE
|
||
default 2
|
||
|
||
endmenu #BLE Mesh NET BUF DEBUG LOG LEVEL
|
||
|
||
config BLE_MESH_CLIENT_MSG_TIMEOUT
|
||
int "Timeout(ms) for client message response"
|
||
range 100 1200000
|
||
default 4000
|
||
help
|
||
Timeout value used by the node to get response of the acknowledged
|
||
message which is sent by the client model.
|
||
This value indicates the maximum time that a client model waits for
|
||
the response of the sent acknowledged messages. If a client model
|
||
uses 0 as the timeout value when sending acknowledged messages, then
|
||
the default value will be used which is four seconds.
|
||
|
||
menu "Support for BLE Mesh Client Models"
|
||
|
||
config BLE_MESH_CFG_CLI
|
||
bool "Configuration Client Model"
|
||
help
|
||
Enable support for Configuration client model.
|
||
|
||
config BLE_MESH_HEALTH_CLI
|
||
bool "Health Client Model"
|
||
help
|
||
Enable support for Health client model.
|
||
|
||
config BLE_MESH_GENERIC_ONOFF_CLI
|
||
bool "Generic OnOff Client Model"
|
||
help
|
||
Enable support for Generic OnOff client model.
|
||
|
||
config BLE_MESH_GENERIC_LEVEL_CLI
|
||
bool "Generic Level Client Model"
|
||
help
|
||
Enable support for Generic Level client model.
|
||
|
||
config BLE_MESH_GENERIC_DEF_TRANS_TIME_CLI
|
||
bool "Generic Default Transition Time Client Model"
|
||
help
|
||
Enable support for Generic Default Transition Time client model.
|
||
|
||
config BLE_MESH_GENERIC_POWER_ONOFF_CLI
|
||
bool "Generic Power Onoff Client Model"
|
||
help
|
||
Enable support for Generic Power Onoff client model.
|
||
|
||
config BLE_MESH_GENERIC_POWER_LEVEL_CLI
|
||
bool "Generic Power Level Client Model"
|
||
help
|
||
Enable support for Generic Power Level client model.
|
||
|
||
config BLE_MESH_GENERIC_BATTERY_CLI
|
||
bool "Generic Battery Client Model"
|
||
help
|
||
Enable support for Generic Battery client model.
|
||
|
||
config BLE_MESH_GENERIC_LOCATION_CLI
|
||
bool "Generic Location Client Model"
|
||
help
|
||
Enable support for Generic Location client model.
|
||
|
||
config BLE_MESH_GENERIC_PROPERTY_CLI
|
||
bool "Generic Property Client Model"
|
||
help
|
||
Enable support for Generic Property client model.
|
||
|
||
config BLE_MESH_SENSOR_CLI
|
||
bool "Sensor Client Model"
|
||
help
|
||
Enable support for Sensor client model.
|
||
|
||
config BLE_MESH_TIME_CLI
|
||
bool "Time Client Model"
|
||
help
|
||
Enable support for Time client model.
|
||
|
||
config BLE_MESH_SCENE_CLI
|
||
bool "Scene Client Model"
|
||
help
|
||
Enable support for Scene client model.
|
||
|
||
config BLE_MESH_SCHEDULER_CLI
|
||
bool "Scheduler Client Model"
|
||
help
|
||
Enable support for Scheduler client model.
|
||
|
||
config BLE_MESH_LIGHT_LIGHTNESS_CLI
|
||
bool "Light Lightness Client Model"
|
||
help
|
||
Enable support for Light Lightness client model.
|
||
|
||
config BLE_MESH_LIGHT_CTL_CLI
|
||
bool "Light CTL Client Model"
|
||
help
|
||
Enable support for Light CTL client model.
|
||
|
||
config BLE_MESH_LIGHT_HSL_CLI
|
||
bool "Light HSL Client Model"
|
||
help
|
||
Enable support for Light HSL client model.
|
||
|
||
config BLE_MESH_LIGHT_XYL_CLI
|
||
bool "Light XYL Client Model"
|
||
help
|
||
Enable support for Light XYL client model.
|
||
|
||
config BLE_MESH_LIGHT_LC_CLI
|
||
bool "Light LC Client Model"
|
||
help
|
||
Enable support for Light LC client model.
|
||
|
||
endmenu
|
||
|
||
config BLE_MESH_IV_UPDATE_TEST
|
||
bool "Test the IV Update Procedure"
|
||
default n
|
||
help
|
||
This option removes the 96 hour limit of the IV Update Procedure and
|
||
lets the state to be changed at any time.
|
||
If IV Update test mode is going to be used, this option should be enabled.
|
||
|
||
menu "BLE Mesh specific test option"
|
||
|
||
config BLE_MESH_SELF_TEST
|
||
bool "Perform BLE Mesh self-tests"
|
||
default n
|
||
help
|
||
This option adds extra self-tests which are run every time BLE Mesh
|
||
networking is initialized.
|
||
|
||
config BLE_MESH_SHELL
|
||
bool "Enable BLE Mesh shell"
|
||
default n
|
||
help
|
||
Activate shell module that provides BLE Mesh commands to the console.
|
||
|
||
config BLE_MESH_DEBUG
|
||
bool "Enable BLE Mesh debug logs"
|
||
default n
|
||
help
|
||
Enable debug logs for the BLE Mesh functionality.
|
||
|
||
if BLE_MESH_DEBUG
|
||
|
||
config BLE_MESH_DEBUG_NET
|
||
bool "Network layer debug"
|
||
help
|
||
Enable Network layer debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_TRANS
|
||
bool "Transport layer debug"
|
||
help
|
||
Enable Transport layer debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_BEACON
|
||
bool "Beacon debug"
|
||
help
|
||
Enable Beacon-related debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_CRYPTO
|
||
bool "Crypto debug"
|
||
help
|
||
Enable cryptographic debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_PROV
|
||
bool "Provisioning debug"
|
||
help
|
||
Enable Provisioning debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_ACCESS
|
||
bool "Access layer debug"
|
||
help
|
||
Enable Access layer debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_MODEL
|
||
bool "Foundation model debug"
|
||
help
|
||
Enable Foundation Models debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_ADV
|
||
bool "Advertising debug"
|
||
help
|
||
Enable advertising debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_LOW_POWER
|
||
bool "Low Power debug"
|
||
help
|
||
Enable Low Power debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_FRIEND
|
||
bool "Friend debug"
|
||
help
|
||
Enable Friend debug logs for the BLE Mesh functionality.
|
||
|
||
config BLE_MESH_DEBUG_PROXY
|
||
bool "Proxy debug"
|
||
depends on BLE_MESH_PROXY
|
||
help
|
||
Enable Proxy protocol debug logs for the BLE Mesh functionality.
|
||
|
||
endif # BLE_MESH_DEBUG
|
||
|
||
endmenu
|
||
|
||
endif # BLE_MESH
|
||
|