Bluetooth: Mesh: Align capitalization for BT mesh

Align the capitalization of the term "Bluetooth Mesh" to Bluetooth mesh"
in the documentation. This is done to to match the new updated naming
convention done in Bluetooth SIG. In the upcoming spec versions, it its
used "Bluetooth mesh" with the lower case convention.

Signed-off-by: Ingar Kulbrandstad <ingar.kulbrandstad@nordicsemi.no>
This commit is contained in:
Ingar Kulbrandstad 2021-06-08 09:32:13 +02:00 committed by Christopher Friedt
commit 3ec6411c7f
81 changed files with 154 additions and 245 deletions

View file

@ -7,7 +7,7 @@ Overview
******** ********
The nRF52840-MDK is a versatile, easy-to-use IoT hardware platform for The nRF52840-MDK is a versatile, easy-to-use IoT hardware platform for
Bluetooth 5, Bluetooth Mesh, Thread, IEEE 802.15.4, ANT and 2.4GHz proprietary Bluetooth 5, Bluetooth mesh, Thread, IEEE 802.15.4, ANT and 2.4GHz proprietary
applications using the nRF52840 SoC. applications using the nRF52840 SoC.
The development kit comes with a fully integrated debugger (also known as The development kit comes with a fully integrated debugger (also known as

View file

@ -248,7 +248,7 @@ Each role comes with its own build-time configuration option:
connection-oriented roles central implicitly enables observer role, and connection-oriented roles central implicitly enables observer role, and
peripheral implicitly enables broadcaster role. Usually the first step peripheral implicitly enables broadcaster role. Usually the first step
when creating an application is to decide which roles are needed and go when creating an application is to decide which roles are needed and go
from there. Bluetooth Mesh is a slightly special case, requiring at from there. Bluetooth mesh is a slightly special case, requiring at
least the observer and broadcaster roles, and possibly also the least the observer and broadcaster roles, and possibly also the
Peripheral role. This will be described in more detail in a later Peripheral role. This will be described in more detail in a later
section. section.
@ -376,7 +376,7 @@ default, mesh requires both observer and broadcaster role to be enabled.
If the optional GATT Proxy feature is desired, then peripheral role If the optional GATT Proxy feature is desired, then peripheral role
should also be enabled. should also be enabled.
The API reference for Mesh can be found in the The API reference for mesh can be found in the
:ref:`Mesh API reference section <bluetooth_mesh>`. :ref:`Mesh API reference section <bluetooth_mesh>`.
.. _bluetooth-persistent-storage: .. _bluetooth-persistent-storage:

View file

@ -69,7 +69,7 @@ Bluetooth stack.
* Non-volatile storage support for permanent storage of Bluetooth-specific * Non-volatile storage support for permanent storage of Bluetooth-specific
settings and data settings and data
* Bluetooth Mesh support * Bluetooth mesh support
* Relay, Friend Node, Low-Power Node (LPN) and GATT Proxy features * Relay, Friend Node, Low-Power Node (LPN) and GATT Proxy features
* Both Provisioning bearers supported (PB-ADV & PB-GATT) * Both Provisioning bearers supported (PB-ADV & PB-GATT)

View file

@ -120,8 +120,8 @@ Zephyr offers a large and ever growing number of features including:
**Bluetooth Low Energy 5.0 support** **Bluetooth Low Energy 5.0 support**
Bluetooth 5.0 compliant (ESR10) and Bluetooth Low Energy Controller support Bluetooth 5.0 compliant (ESR10) and Bluetooth Low Energy Controller support
(LE Link Layer). Includes BLE Mesh and a Bluetooth qualification-ready BLE (LE Link Layer). Includes Bluetooth mesh and a Bluetooth qualification-ready
controller. Bluetooth controller.
* Generic Access Profile (GAP) with all possible LE roles. * Generic Access Profile (GAP) with all possible LE roles.
* GATT (Generic Attribute Profile) * GATT (Generic Attribute Profile)

View file

@ -3,11 +3,11 @@
Bluetooth Mesh Profile Bluetooth Mesh Profile
###################### ######################
The Bluetooth Mesh Profile adds secure wireless multi-hop communication for The Bluetooth mesh profile adds secure wireless multi-hop communication for
Bluetooth Low Energy. This module implements the Bluetooth Low Energy. This module implements the
`Bluetooth Mesh Profile Specification v1.0.1 <https://www.bluetooth.com/specifications/mesh-specifications/>`_. `Bluetooth Mesh Profile Specification v1.0.1 <https://www.bluetooth.com/specifications/mesh-specifications/>`_.
Read more about Bluetooth Mesh on the Read more about Bluetooth mesh on the
`Bluetooth SIG Website <https://www.bluetooth.com/bluetooth-resources/?tags=mesh>`_. `Bluetooth SIG Website <https://www.bluetooth.com/bluetooth-resources/?tags=mesh>`_.
.. toctree:: .. toctree::

View file

@ -1,11 +1,11 @@
.. _bluetooth_mesh_access: .. _bluetooth_mesh_access:
Access Access layer
###### ############
The Bluetooth Mesh access layer is the application's interface to the mesh The access layer is the application's interface to the Bluetooth mesh network.
network. The access layer provides mechanisms for compartmentalizing the node The access layer provides mechanisms for compartmentalizing the node behavior
behavior into elements and models, which are implemented by the application. into elements and models, which are implemented by the application.
Mesh models Mesh models
*********** ***********
@ -29,7 +29,7 @@ behavior in the `Bluetooth Mesh Model Specification
not specified by the Bluetooth SIG are vendor models, and must be tied to a not specified by the Bluetooth SIG are vendor models, and must be tied to a
Company ID. Company ID.
Mesh Models have several parameters that can be configured either through Mesh models have several parameters that can be configured either through
initialization of the mesh stack or with the initialization of the mesh stack or with the
:ref:`bluetooth_mesh_models_cfg_srv`: :ref:`bluetooth_mesh_models_cfg_srv`:
@ -103,7 +103,7 @@ current state.
Extended models Extended models
=============== ===============
The Bluetooth Mesh specification allows the Mesh models to extend each other. The Bluetooth mesh specification allows the mesh models to extend each other.
When a model extends another, it inherits that model's functionality, and When a model extends another, it inherits that model's functionality, and
extension can be used to construct complex models out of simple ones, extension can be used to construct complex models out of simple ones,
leveraging the existing model functionality to avoid defining new opcodes. leveraging the existing model functionality to avoid defining new opcodes.

View file

@ -1,17 +1,16 @@
.. _bluetooth_mesh_cfg: .. _bluetooth_mesh_cfg:
Runtime configuration Runtime Configuration
##################### #####################
The Bluetooth Mesh runtime configuration API allows applications to change The runtime configuration API allows applications to change their runtime
their runtime configuration directly, without going through the Configuration configuration directly, without going through the Configuration models.
models.
Bluetooth Mesh nodes should generally be configured by a central network Bluetooth mesh nodes should generally be configured by a central network
configurator device with a :ref:`bluetooth_mesh_models_cfg_cli` model. Each configurator device with a :ref:`bluetooth_mesh_models_cfg_cli` model. Each
mesh node instantiates a :ref:`bluetooth_mesh_models_cfg_srv` model that the mesh node instantiates a :ref:`bluetooth_mesh_models_cfg_srv` model that the
Config Client can communicate with to change the node configuration. In some Configuration Client can communicate with to change the node configuration. In some
cases, the mesh node can't rely on the Config Client to detect or determine cases, the mesh node can't rely on the Configuration Client to detect or determine
local constraints, such as low battery power or changes in topology. For these local constraints, such as low battery power or changes in topology. For these
scenarios, this API can be used to change the configuration locally. scenarios, this API can be used to change the configuration locally.

View file

@ -3,7 +3,7 @@
Configuration Client Configuration Client
#################### ####################
Configuration Client model is a foundation model defined by the Bluetooth Mesh The Configuration Client model is a foundation model defined by the Bluetooth mesh
specification. It provides functionality for configuring most parameters of a specification. It provides functionality for configuring most parameters of a
mesh node, including encryption keys, model configuration and feature mesh node, including encryption keys, model configuration and feature
enabling. enabling.

View file

@ -3,7 +3,7 @@
Configuration Server Configuration Server
#################### ####################
Configuration Server model is a foundation model defined by the Bluetooth Mesh The Configuration Server model is a foundation model defined by the Bluetooth mesh
specification. The Configuration Server model controls most parameters of the specification. The Configuration Server model controls most parameters of the
mesh node. It does not have an API of its own, but relies on a mesh node. It does not have an API of its own, but relies on a
:ref:`bluetooth_mesh_models_cfg_cli` to control it. :ref:`bluetooth_mesh_models_cfg_cli` to control it.
@ -14,7 +14,7 @@ mesh node. It does not have an API of its own, but relies on a
should be set through Kconfig, and the Heartbeat feature should be should be set through Kconfig, and the Heartbeat feature should be
controlled through the :ref:`bluetooth_mesh_heartbeat` API. controlled through the :ref:`bluetooth_mesh_heartbeat` API.
The Configuration Server model is mandatory on all Bluetooth Mesh nodes, and The Configuration Server model is mandatory on all Bluetooth mesh nodes, and
should be instantiated in the first element. should be instantiated in the first element.
API reference API reference

View file

@ -1,10 +1,10 @@
.. _bluetooth_mesh_core: .. _bluetooth_mesh_core:
Core API Core
######## ####
The Bluetooth Mesh Core API provides functionality for managing the general The core provides functionality for managing the general Bluetooth mesh
Bluetooth Mesh state. state.
Low Power Node Low Power Node
************** **************

View file

@ -19,7 +19,7 @@ necessarily damaging to the device. Errors indicate conditions that are
outside of the node's design limits, and may have caused invalid behavior or outside of the node's design limits, and may have caused invalid behavior or
permanent damage to the device. permanent damage to the device.
Fault values ``0x01`` to ``0x7f`` are reserved for the Bluetooth Mesh Fault values ``0x01`` to ``0x7f`` are reserved for the Bluetooth mesh
specification, and the full list of specification defined faults are available specification, and the full list of specification defined faults are available
in :ref:`bluetooth_mesh_health_faults`. Fault values ``0x80`` to ``0xff`` are in :ref:`bluetooth_mesh_health_faults`. Fault values ``0x80`` to ``0xff`` are
vendor specific. The list of faults are always reported with a company ID to vendor specific. The list of faults are always reported with a company ID to
@ -52,9 +52,9 @@ API reference
.. _bluetooth_mesh_health_faults: .. _bluetooth_mesh_health_faults:
Bluetooth Mesh Health Faults Health faults
============================ =============
Fault values defined by the Bluetooth Mesh specification. Fault values defined by the Bluetooth mesh specification.
.. doxygengroup:: bt_mesh_health_faults .. doxygengroup:: bt_mesh_health_faults

View file

@ -3,8 +3,8 @@
Heartbeat Heartbeat
######### #########
The Bluetooth Mesh Heartbeat feature provides functionality for monitoring mesh The Heartbeat feature provides functionality for monitoring Bluetooth mesh nodes
nodes and determining the distance between nodes. and determining the distance between nodes.
The Heartbeat feature is configured through the :ref:`bluetooth_mesh_models_cfg_srv` model. The Heartbeat feature is configured through the :ref:`bluetooth_mesh_models_cfg_srv` model.

View file

@ -3,7 +3,7 @@
Foundation models Foundation models
################# #################
The Bluetooth Mesh specification defines four foundation models that can be The Bluetooth mesh specification defines four foundation models that can be
used by network administrators to configure and diagnose mesh nodes. used by network administrators to configure and diagnose mesh nodes.
.. toctree:: .. toctree::

View file

@ -1,10 +1,11 @@
.. _bluetooth_mesh_msg: .. _bluetooth_mesh_msg:
Message API Message
########### #######
The Bluetooth Mesh message API provides set of structures, macros and functions The Bluetooth mesh message provides set of structures, macros and functions used
used for preparing message buffers, managing message and acknowledged message contexts. for preparing message buffers, managing message and acknowledged message
contexts.
API reference API reference
************* *************

View file

@ -12,15 +12,15 @@ two devices operating in the following roles:
Provisioning process. Before the provisioning process starts, the Provisioning process. Before the provisioning process starts, the
provisionee is an *unprovisioned device*. provisionee is an *unprovisioned device*.
The Provisioning module in the Zephyr Bluetooth Mesh stack supports both the The Provisioning module in the Zephyr Bluetooth mesh stack supports both the
Advertising and GATT Provisioning bearers for the provisionee role, as well as Advertising and GATT Provisioning bearers for the provisionee role, as well as
the Advertising Provisioning bearer for the provisioner role. the Advertising Provisioning bearer for the provisioner role.
The Provisioning process The Provisioning process
************************ ************************
All Bluetooth Mesh nodes must be provisioned before they can participate in a All Bluetooth mesh nodes must be provisioned before they can participate in a
Bluetooth Mesh network. The Provisioning API provides all the functionality Bluetooth mesh network. The Provisioning API provides all the functionality
necessary for a device to become a provisioned mesh node. necessary for a device to become a provisioned mesh node.
Provisioning is a five-step process, involving the following steps: Provisioning is a five-step process, involving the following steps:
@ -173,7 +173,7 @@ Depending on the choice of public key exchange mechanism and authentication meth
the provisioning process can be secure or insecure. the provisioning process can be secure or insecure.
On May 24th 2021, ANSSI `disclosed <https://kb.cert.org/vuls/id/799380>`_ On May 24th 2021, ANSSI `disclosed <https://kb.cert.org/vuls/id/799380>`_
a set of vulnerabilities in the Bluetooth Mesh Provisioning protocol that showcased a set of vulnerabilities in the Bluetooth mesh provisioning protocol that showcased
how the low entropy provided by the Blink, Vibrate, Push, Twist and how the low entropy provided by the Blink, Vibrate, Push, Twist and
Input/Output numeric OOB methods could be exploited in impersonation and MITM Input/Output numeric OOB methods could be exploited in impersonation and MITM
attacks. In response, the Bluetooth SIG has reclassified these OOB methods as attacks. In response, the Bluetooth SIG has reclassified these OOB methods as

View file

@ -3,8 +3,8 @@
Proxy Proxy
##### #####
The Bluetooth Mesh Proxy feature allows legacy devices like phones to access The Proxy feature allows legacy devices like phones to access the Bluetooth
the Mesh network through GATT. The Proxy feature is only compiled in if the mesh network through GATT. The Proxy feature is only compiled in if the
:kconfig:`CONFIG_BT_MESH_GATT_PROXY` option is set. The Proxy feature state is :kconfig:`CONFIG_BT_MESH_GATT_PROXY` option is set. The Proxy feature state is
controlled by the :ref:`bluetooth_mesh_models_cfg_srv`, and the initial value controlled by the :ref:`bluetooth_mesh_models_cfg_srv`, and the initial value
can be set with :c:member:`bt_mesh_cfg_srv.gatt_proxy`. can be set with :c:member:`bt_mesh_cfg_srv.gatt_proxy`.

View file

@ -1,28 +1,28 @@
.. _bluetooth_mesh_shell: .. _bluetooth_mesh_shell:
Shell Bluetooth Mesh Shell
##### ####################
The Bluetooth Mesh Shell subsystem provides a set of Bluetooth Mesh commands for the :ref:`shell_api` module. The Bluetooth mesh shell subsystem provides a set of Bluetooth mesh shell commands for the :ref:`shell_api` module.
It allows for testing and exploring the Bluetooth Mesh API through an interactive interface, without having to write an application. It allows for testing and exploring the Bluetooth mesh API through an interactive interface, without having to write an application.
The Bluetooth Mesh Shell interface provides access to most Bluetooth Mesh features, including provisioning, configuration, and message sending. The Bluetooth mesh shell interface provides access to most Bluetooth mesh features, including provisioning, configuration, and message sending.
Prerequisites Prerequisites
************* *************
The Mesh Shell subsystem depends on the :ref:`bluetooth_mesh_models_cfg_cli` and :ref:`bluetooth_mesh_models_health_cli` models. The Bluetooth mesh shell subsystem depends on the :ref:`bluetooth_mesh_models_cfg_cli` and :ref:`bluetooth_mesh_models_health_cli` models.
Mesh Shell application Application
********************** ***********
The Mesh Shell subsystem is most easily used through the Mesh Shell application under ``tests/bluetooth/mesh_shell``. The Bluetooth mesh shell subsystem is most easily used through the Bluetooth mesh shell application under ``tests/bluetooth/mesh_shell``.
See :ref:`shell_api` for information on how to connect and interact with the shell application. See :ref:`shell_api` for information on how to connect and interact with the Bluetooth mesh shell application.
Basic usage Basic usage
*********** ***********
The Mesh Shell subsystem adds a single ``mesh`` command, which holds a set of sub-commands. Every time the device boots up, make sure to call ``mesh init`` before any of the other Mesh Shell commands can be called:: The Bluetooth mesh shell subsystem adds a single ``mesh`` command, which holds a set of sub-commands. Every time the device boots up, make sure to call ``mesh init`` before any of the other Bluetooth mesh shell commands can be called::
uart:~$ mesh init uart:~$ mesh init
@ -35,7 +35,7 @@ The simplest way to provision the device is through self-provisioning. To provis
uart:~$ mesh provision 0 0x0001 uart:~$ mesh provision 0 0x0001
Since all mesh shell nodes use the same values for the default network key, this can be done on multiple devices, as long as they're assigned non-overlapping unicast addresses. Alternatively, to provision the device into an existing network, the unprovisioned beacon can be enabled with ``mesh pb-adv on`` or ``mesh pb-gatt on``. The beacons can be picked up by an external provisioner, which can provision the node into its network. Since all mesh nodes use the same values for the default network key, this can be done on multiple devices, as long as they're assigned non-overlapping unicast addresses. Alternatively, to provision the device into an existing network, the unprovisioned beacon can be enabled with ``mesh pb-adv on`` or ``mesh pb-gatt on``. The beacons can be picked up by an external provisioner, which can provision the node into its network.
Once the mesh node is part of a network, its transmission parameters can be controlled by the general configuration commands: Once the mesh node is part of a network, its transmission parameters can be controlled by the general configuration commands:
@ -63,7 +63,7 @@ Next, since the device has no application keys by default, it's a good idea to a
Message sending Message sending
=============== ===============
With an application key added (see above), the mesh node's transition parameters are all valid, and the Mesh Shell can send raw mesh messages through the network. With an application key added (see above), the mesh node's transition parameters are all valid, and the Bluetooth mesh shell can send raw mesh messages through the network.
For example, to send a Generic OnOff Set message, call:: For example, to send a Generic OnOff Set message, call::
@ -81,12 +81,12 @@ With the destination address set to ``0xffff``, any other mesh nodes in the netw
.. note:: .. note::
To change the configuration of the device, the destination address must be set back to the local unicast address before issuing any configuration commands. To change the configuration of the device, the destination address must be set back to the local unicast address before issuing any configuration commands.
Sending raw mesh packets is a good way to test model message handler implementations during development, as it can be done without having to implement the sending model. By default, only the reception of the model messages can be tested this way, as the Mesh Shell only includes the foundation models. To receive a packet in the Mesh Shell node, you have to add a model with a valid opcode handler list to the composition data in ``subsys/bluetooth/mesh/shell.c``, and print the incoming message to the shell in the handler callback. Sending raw mesh packets is a good way to test model message handler implementations during development, as it can be done without having to implement the sending model. By default, only the reception of the model messages can be tested this way, as the Bluetooth mesh shell only includes the foundation models. To receive a packet in the mesh node, you have to add a model with a valid opcode handler list to the composition data in ``subsys/bluetooth/mesh/shell.c``, and print the incoming message to the shell in the handler callback.
Parameter formats Parameter formats
***************** *****************
The Mesh Shell commands are parsed with a variety of formats: The Bluetooth mesh shell commands are parsed with a variety of formats:
.. list-table:: Parameter formats .. list-table:: Parameter formats
:widths: 1 4 2 :widths: 1 4 2
@ -105,19 +105,19 @@ The Mesh Shell commands are parsed with a variety of formats:
- Boolean values are denoted in the API documentation as ``<val: on, off>``. - Boolean values are denoted in the API documentation as ``<val: on, off>``.
- ``on``, ``off``, ``enabled``, ``disabled``, ``1``, ``0`` - ``on``, ``off``, ``enabled``, ``disabled``, ``1``, ``0``
Mesh Shell commands Commands
******************* ********
The Mesh shell implements a large set of commands. Some of the commands accept parameters, which are mentioned in brackets after the command name. For example, ``mesh lpn <value: off, on>``. Mandatory parameters are marked with angle brackets (e.g. ``<NetKeyIndex>``), and optional parameters are marked with square brackets (e.g. ``[destination address]``). The Bluetooth mesh shell implements a large set of commands. Some of the commands accept parameters, which are mentioned in brackets after the command name. For example, ``mesh lpn <value: off, on>``. Mandatory parameters are marked with angle brackets (e.g. ``<NetKeyIndex>``), and optional parameters are marked with square brackets (e.g. ``[destination address]``).
The Mesh Shell commands are divided into the following groups: The Bluetooth mesh shell commands are divided into the following groups:
.. contents:: .. contents::
:depth: 1 :depth: 1
:local: :local:
.. note:: .. note::
Some commands depend on specific features being enabled in the compile time configuration of the application. Not all features are enabled by default. The list of available Mesh Shell commands can be shown in the shell by calling ``mesh`` without any arguments. Some commands depend on specific features being enabled in the compile time configuration of the application. Not all features are enabled by default. The list of available Bluetooth mesh shell commands can be shown in the shell by calling ``mesh`` without any arguments.
General configuration General configuration
===================== =====================
@ -166,7 +166,7 @@ General configuration
``mesh netidx [NetIdx]`` ``mesh netidx [NetIdx]``
------------------------ ------------------------
Get or set the message network index. The network index determines which network key is used to encrypt mesh packets that are sent with the shell, but has no effect on modules outside the shell's control. The network key must already be added to the device, either through provisioning or by a Config Client. Get or set the message network index. The network index determines which network key is used to encrypt mesh packets that are sent with the shell, but has no effect on modules outside the shell's control. The network key must already be added to the device, either through provisioning or by a Configuration Client.
* ``NetIdx``: If present, sets the new network index. If omitted, the current network index is printed. * ``NetIdx``: If present, sets the new network index. If omitted, the current network index is printed.
@ -174,7 +174,7 @@ General configuration
``mesh appidx [AppIdx]`` ``mesh appidx [AppIdx]``
------------------------ ------------------------
Get or set the message application index. The application index determines which application key is used to encrypt mesh packets that are sent with the shell, but has no effect on modules outside the shell's control. The application key must already be added to the device by a Config Client, and must be bound to the current network index. Get or set the message application index. The application index determines which application key is used to encrypt mesh packets that are sent with the shell, but has no effect on modules outside the shell's control. The application key must already be added to the device by a Configuration Client, and must be bound to the current network index.
* ``AppIdx``: If present, sets the new application index. If omitted, the current application index is printed. * ``AppIdx``: If present, sets the new application index. If omitted, the current application index is printed.
@ -298,9 +298,9 @@ Provisioning
Configuration Client model Configuration Client model
========================== ==========================
The Mesh Shell module instantiates a Configuration Client model for configuring itself and other nodes in the mesh network. The Bluetooth mesh shell module instantiates a Configuration Client model for configuring itself and other nodes in the mesh network.
The Configuration Client uses the general messages parameters set by ``mesh dst`` and ``mesh netidx`` to target specific nodes. When the Mesh Shell node is provisioned, the Configuration Client model targets itself by default. When another node has been provisioned by the Mesh Shell, the Configuration Client model targets the new node. The Configuration Client always sends messages using the Device key bound to the destination address, so it will only be able to configure itself and mesh nodes it provisioned. The Configuration Client uses the general messages parameters set by ``mesh dst`` and ``mesh netidx`` to target specific nodes. When the Bluetooth mesh shell node is provisioned, the Configuration Client model targets itself by default. When another node has been provisioned by the Bluetooth mesh shell, the Configuration Client model targets the new node. The Configuration Client always sends messages using the Device key bound to the destination address, so it will only be able to configure itself and mesh nodes it provisioned.
``mesh timeout [timeout in seconds]`` ``mesh timeout [timeout in seconds]``
------------------------------------- -------------------------------------
@ -583,9 +583,9 @@ The Configuration Client uses the general messages parameters set by ``mesh dst`
Health Client model Health Client model
=================== ===================
The Mesh Shell module instantiates a Health Client model for configuring itself and other nodes in the mesh network. The Bluetooth mesh shell module instantiates a Health Client model for configuring itself and other nodes in the mesh network.
The Health Client uses the general messages parameters set by ``mesh dst`` and ``mesh netidx`` to target specific nodes. When the Mesh Shell node is provisioned, the Health Client model targets itself by default. When another node has been provisioned by the Mesh Shell, the Health Client model targets the new node. The Health Client always sends messages using the Device key bound to the destination address, so it will only be able to configure itself and mesh nodes it provisioned. The Health Client uses the general messages parameters set by ``mesh dst`` and ``mesh netidx`` to target specific nodes. When the Bluetooth mesh shell node is provisioned, the Health Client model targets itself by default. When another node has been provisioned by the Bluetooth mesh shell, the Health Client model targets the new node. The Health Client always sends messages using the Device key bound to the destination address, so it will only be able to configure itself and mesh nodes it provisioned.
``mesh fault-get <Company ID>`` ``mesh fault-get <Company ID>``
------------------------------- -------------------------------
@ -695,7 +695,7 @@ Health Server model
Configuration database Configuration database
====================== ======================
The Configuration database is an optional Mesh subsystem that can be enabled through the :kconfig:`CONFIG_BT_MESH_CDB` configuration option. The Configuration database is only available on provisioner devices, and allows them to store all information about the mesh network. To avoid conflicts, there should only be one mesh node in the network with the Configuration database enabled. This node is the Configurator, and is responsible for adding new nodes to the network and configuring them. The Configuration database is an optional mesh subsystem that can be enabled through the :kconfig:`CONFIG_BT_MESH_CDB` configuration option. The Configuration database is only available on provisioner devices, and allows them to store all information about the mesh network. To avoid conflicts, there should only be one mesh node in the network with the Configuration database enabled. This node is the Configurator, and is responsible for adding new nodes to the network and configuring them.
``mesh cdb-create [NetKey]`` ``mesh cdb-create [NetKey]``
---------------------------- ----------------------------

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Profile APIs. * @brief Bluetooth mesh Profile APIs.
*/ */
/* /*

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Access Layer APIs. * @brief Access layer APIs.
*/ */
/* /*
@ -25,8 +25,8 @@
BT_MESH_ADDR_UNASSIGNED_ELT_) } BT_MESH_ADDR_UNASSIGNED_ELT_) }
/** /**
* @brief Bluetooth Mesh Access Layer * @brief Access layer
* @defgroup bt_mesh_access Bluetooth Mesh Access Layer * @defgroup bt_mesh_access Access layer
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Runtime Configuration APIs. * @brief Runtime configuration APIs.
*/ */
/* /*
@ -15,8 +15,8 @@
#include <sys/types.h> #include <sys/types.h>
/** /**
* @brief Bluetooth Mesh Runtime Configuration API * @brief Runtime Configuration
* @defgroup bt_mesh_cfg Bluetooth Mesh Runtime Configuration * @defgroup bt_mesh_cfg Runtime Configuration
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */
@ -25,7 +25,7 @@
extern "C" { extern "C" {
#endif #endif
/** Bluetooth Mesh Feature states */ /** Bluetooth mesh feature states */
enum bt_mesh_feat_state { enum bt_mesh_feat_state {
/** Feature is supported, but disabled. */ /** Feature is supported, but disabled. */
BT_MESH_FEATURE_DISABLED, BT_MESH_FEATURE_DISABLED,
@ -207,8 +207,8 @@ int bt_mesh_friend_set(enum bt_mesh_feat_state friendship);
enum bt_mesh_feat_state bt_mesh_friend_get(void); enum bt_mesh_feat_state bt_mesh_friend_get(void);
/** /**
* @brief Bluetooth Mesh Subnet Configuration * @brief Subnet Configuration
* @defgroup bt_mesh_cfg_subnet Bluetooth Mesh Subnet Configuration * @defgroup bt_mesh_cfg_subnet Subnet Configuration
* @{ * @{
*/ */
@ -369,8 +369,8 @@ ssize_t bt_mesh_subnets_get(uint16_t net_idxs[], size_t max, off_t skip);
*/ */
/** /**
* @brief Bluetooth Mesh Application Configuration * @brief Application Configuration
* @defgroup bt_mesh_cfg_app Bluetooth Mesh Application Configuration * @defgroup bt_mesh_cfg_app Application Configuration
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Configuration Client Model APIs. * @brief Configuration Client Model APIs.
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_CFG_CLI_H_ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_CFG_CLI_H_
/** /**
* @brief Bluetooth Mesh * @brief Configuration Client Model
* @defgroup bt_mesh_cfg_cli Bluetooth Mesh Configuration Client Model * @defgroup bt_mesh_cfg_cli Configuration Client Model
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Configuration Server Model APIs. * @brief Configuration Server Model APIs.
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_CFG_SRV_H_ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_CFG_SRV_H_
/** /**
* @brief Bluetooth Mesh * @brief Configuration Server Model
* @defgroup bt_mesh_cfg_srv Bluetooth Mesh Configuration Server Model * @defgroup bt_mesh_cfg_srv Configuration Server Model
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Health Client Model APIs. * @brief Health Client Model APIs.
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_HEALTH_CLI_H_ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_HEALTH_CLI_H_
/** /**
* @brief Bluetooth Mesh * @brief Health Client Model
* @defgroup bt_mesh_health_cli Bluetooth Mesh Health Client Model * @defgroup bt_mesh_health_cli Health Client Model
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */
@ -21,7 +21,7 @@
extern "C" { extern "C" {
#endif #endif
/** Mesh Health Client Model Context */ /** Health Client Model Context */
struct bt_mesh_health_cli { struct bt_mesh_health_cli {
/** Composition data model entry pointer. */ /** Composition data model entry pointer. */
struct bt_mesh_model *model; struct bt_mesh_model *model;

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Health faults * @brief Health faults
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_HEALTH_FAULTS_H__ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_HEALTH_FAULTS_H__
/** /**
* @brief List of specification defined Health Fault values. * @brief List of specification defined Health fault values.
* @defgroup bt_mesh_health_faults Bluetooth Mesh Health Faults * @defgroup bt_mesh_health_faults Health faults
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Health Server Model APIs. * @brief Health Server Model APIs.
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_HEALTH_SRV_H_ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_HEALTH_SRV_H_
/** /**
* @brief Bluetooth Mesh Health Server Model * @brief Health Server Model
* @defgroup bt_mesh_health_srv Bluetooth Mesh Health Server Model * @defgroup bt_mesh_health_srv Health Server Model
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Heartbeat API. * @brief Heartbeat APIs.
*/ */
/* /*
@ -13,8 +13,8 @@
#include <sys/slist.h> #include <sys/slist.h>
/** /**
* @brief Bluetooth Mesh * @brief Heartbeat
* @defgroup bt_mesh_heartbeat Bluetooth Mesh Heartbeat * @defgroup bt_mesh_heartbeat Heartbeat
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Profile APIs. * @brief Bluetooth mesh Profile APIs.
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_MAIN_H_ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_MAIN_H_
/** /**
* @brief Bluetooth Mesh Provisioning * @brief Provisioning
* @defgroup bt_mesh_prov Bluetooth Mesh Provisioning * @defgroup bt_mesh_prov Provisioning
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */
@ -440,8 +440,8 @@ bool bt_mesh_is_provisioned(void);
*/ */
/** /**
* @brief Bluetooth Mesh * @brief Bluetooth mesh
* @defgroup bt_mesh Bluetooth Mesh * @defgroup bt_mesh Bluetooth mesh
* @ingroup bluetooth * @ingroup bluetooth
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Message APIs. * @brief Message APIs.
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_MSG_H_ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_MSG_H_
/** /**
* @brief Bluetooth Mesh Message API * @brief Message
* @defgroup bt_mesh_msg Bluetooth Mesh Message API * @defgroup bt_mesh_msg Message
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Bluetooth Mesh Proxy APIs. * @brief Proxy APIs.
*/ */
/* /*
@ -11,8 +11,8 @@
#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_PROXY_H_ #define ZEPHYR_INCLUDE_BLUETOOTH_MESH_PROXY_H_
/** /**
* @brief Bluetooth Mesh Proxy * @brief Proxy
* @defgroup bt_mesh_proxy Bluetooth Mesh Proxy * @defgroup bt_mesh_proxy Proxy
* @ingroup bt_mesh * @ingroup bt_mesh
* @{ * @{
*/ */

View file

@ -6,8 +6,8 @@ Bluetooth: Mesh
Overview Overview
******** ********
This sample demonstrates Bluetooth Mesh functionality. It has several This sample demonstrates Bluetooth mesh functionality. It has several
standard Mesh models, and supports provisioning over both the standard mesh models, and supports provisioning over both the
Advertising and the GATT Provisioning Bearers (i.e. PB-ADV and PB-GATT). Advertising and the GATT Provisioning Bearers (i.e. PB-ADV and PB-GATT).
The application also needs a functioning serial console, since that's The application also needs a functioning serial console, since that's
used for the Out-of-Band provisioning procedure. used for the Out-of-Band provisioning procedure.

View file

@ -6,7 +6,7 @@ Bluetooth: Mesh Demo
Overview Overview
******** ********
This sample is a Bluetooth Mesh application intended for demonstration This sample is a Bluetooth mesh application intended for demonstration
purposes only. The application provisions and configures itself (i.e. no purposes only. The application provisions and configures itself (i.e. no
external provisioner needed) with hard-coded network and application key external provisioner needed) with hard-coded network and application key
values. The local unicast address can be set using a NODE_ADDR build values. The local unicast address can be set using a NODE_ADDR build
@ -14,7 +14,7 @@ variable (e.g. NODE_ADDR=0x0001 for unicast address 0x0001), or by
manually editing the value in the ``board.h`` file. manually editing the value in the ``board.h`` file.
Because of the hard-coded values, the application is not suitable for Because of the hard-coded values, the application is not suitable for
production use, but is quite convenient for quick demonstrations of Mesh production use, but is quite convenient for quick demonstrations of mesh
functionality. functionality.
The application has some features especially designed for the BBC The application has some features especially designed for the BBC

View file

@ -6,7 +6,7 @@ Bluetooth: Mesh Provisioner
Overview Overview
******** ********
This sample demonstrates how to use the Bluetooth Mesh APIs related to This sample demonstrates how to use the Bluetooth mesh APIs related to
provisioning and using the Configuration Database (CDB). It is intended to be provisioning and using the Configuration Database (CDB). It is intended to be
tested together with a device capable of being provisioned. For tested together with a device capable of being provisioned. For
example, one could use the sample in :zephyr_file:`samples/bluetooth/mesh` or example, one could use the sample in :zephyr_file:`samples/bluetooth/mesh` or

View file

@ -6,7 +6,7 @@ Mesh Badge
Overview Overview
******** ********
This sample app for the reel board showcases Bluetooth Mesh This sample app for the reel board showcases Bluetooth mesh
The app starts off as a regular Bluetooth GATT peripheral application. The app starts off as a regular Bluetooth GATT peripheral application.
Install the the "nRF Connect" app on your phone (available both for Install the the "nRF Connect" app on your phone (available both for
@ -34,7 +34,7 @@ Steps to set up
you're not happy with it you can try writing something else. you're not happy with it you can try writing something else.
#. When you're happy with the text, disconnect from the board (exit the app or #. When you're happy with the text, disconnect from the board (exit the app or
go back to the device scan page) go back to the device scan page)
#. Once disconnected the board switches over to Bluetooth Mesh mode, and you #. Once disconnected the board switches over to Bluetooth mesh mode, and you
can't connect to it anymore over GATT. can't connect to it anymore over GATT.
If you configure multiple boards like this they can communicate with If you configure multiple boards like this they can communicate with

View file

@ -223,7 +223,7 @@ config BT_HCI_MESH_EXT
bool "Mesh HCI Command support" bool "Mesh HCI Command support"
depends on BT_BROADCASTER && BT_OBSERVER && !BT_LL_SW_SPLIT depends on BT_BROADCASTER && BT_OBSERVER && !BT_LL_SW_SPLIT
help help
Enable support for the Bluetooth Mesh HCI Commands. Enable support for the Bluetooth mesh HCI Commands.
config BT_WAIT_NOP config BT_WAIT_NOP
bool "Wait for \"NOP\" Command Complete event during init" bool "Wait for \"NOP\" Command Complete event during init"

View file

@ -1,17 +1,17 @@
# Bluetooth Mesh configuration options # Bluetooth mesh configuration options
# Copyright (c) 2017 Intel Corporation # Copyright (c) 2017 Intel Corporation
# SPDX-License-Identifier: Apache-2.0 # SPDX-License-Identifier: Apache-2.0
menuconfig BT_MESH menuconfig BT_MESH
bool "Bluetooth Mesh support" bool "Bluetooth mesh support"
select TINYCRYPT select TINYCRYPT
select TINYCRYPT_AES select TINYCRYPT_AES
select TINYCRYPT_AES_CMAC select TINYCRYPT_AES_CMAC
select BT_HOST_CCM select BT_HOST_CCM
depends on BT_OBSERVER && BT_BROADCASTER depends on BT_OBSERVER && BT_BROADCASTER
help help
This option enables Bluetooth Mesh support. The specific This option enables Bluetooth mesh support. The specific
features that are available may depend on other features features that are available may depend on other features
that have been enabled in the stack, such as GATT support. that have been enabled in the stack, such as GATT support.
@ -682,19 +682,19 @@ config BT_MESH_HEALTH_CLI
Enable support for the health client model. Enable support for the health client model.
config BT_MESH_SHELL config BT_MESH_SHELL
bool "Enable Bluetooth Mesh shell" bool "Enable Bluetooth mesh shell"
select SHELL select SHELL
depends on BT_MESH_CFG_CLI depends on BT_MESH_CFG_CLI
depends on BT_MESH_HEALTH_CLI depends on BT_MESH_HEALTH_CLI
help help
Activate shell module that provides Bluetooth Mesh commands to Activate shell module that provides Bluetooth mesh commands to
the console. the console.
config BT_MESH_MODEL_EXTENSIONS config BT_MESH_MODEL_EXTENSIONS
bool "Support for Model extensions" bool "Support for Model extensions"
help help
Enable support for the model extension concept, allowing the Access Enable support for the model extension concept, allowing the Access
layer to know about Mesh model relationships. layer to know about mesh model relationships.
if BT_SETTINGS if BT_SETTINGS
@ -766,55 +766,55 @@ config BT_MESH_DEBUG_NET
bool "Network layer debug" bool "Network layer debug"
help help
Use this option to enable Network layer debug logs for the Use this option to enable Network layer debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_RPL config BT_MESH_DEBUG_RPL
bool "Replay protection list debug" bool "Replay protection list debug"
help help
Use this option to enable Replay protection list debug logs Use this option to enable Replay protection list debug logs
for the Bluetooth Mesh functionality. for the Bluetooth mesh functionality.
config BT_MESH_DEBUG_TRANS config BT_MESH_DEBUG_TRANS
bool "Transport layer debug" bool "Transport layer debug"
help help
Use this option to enable Transport layer debug logs for the Use this option to enable Transport layer debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_BEACON config BT_MESH_DEBUG_BEACON
bool "Beacon debug" bool "Beacon debug"
help help
Use this option to enable Beacon-related debug logs for the Use this option to enable Beacon-related debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_CRYPTO config BT_MESH_DEBUG_CRYPTO
bool "Crypto debug" bool "Crypto debug"
help help
Use this option to enable cryptographic debug logs for the Use this option to enable cryptographic debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_KEYS config BT_MESH_DEBUG_KEYS
bool "Key management debug" bool "Key management debug"
help help
Use this option to enable key management debug logs for the Use this option to enable key management debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_PROV config BT_MESH_DEBUG_PROV
bool "Provisioning debug" bool "Provisioning debug"
help help
Use this option to enable Provisioning debug logs for the Use this option to enable Provisioning debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_PROVISIONER config BT_MESH_DEBUG_PROVISIONER
bool "Provisioner debug" bool "Provisioner debug"
help help
Use this option to enable Provisioner debug logs for the Use this option to enable Provisioner debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_ACCESS config BT_MESH_DEBUG_ACCESS
bool "Access layer debug" bool "Access layer debug"
help help
Use this option to enable Access layer and device composition Use this option to enable Access layer and device composition
related debug logs for Bluetooth Mesh. related debug logs for Bluetooth mesh.
config BT_MESH_DEBUG_MODEL config BT_MESH_DEBUG_MODEL
bool "Foundation model debug" bool "Foundation model debug"
@ -826,19 +826,19 @@ config BT_MESH_DEBUG_ADV
bool "Advertising debug" bool "Advertising debug"
help help
Use this option to enable advertising debug logs for Use this option to enable advertising debug logs for
the Bluetooth Mesh functionality. the Bluetooth mesh functionality.
config BT_MESH_DEBUG_LOW_POWER config BT_MESH_DEBUG_LOW_POWER
bool "Low Power debug" bool "Low Power debug"
help help
Use this option to enable Low Power debug logs for the Use this option to enable Low Power debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_FRIEND config BT_MESH_DEBUG_FRIEND
bool "Friend debug" bool "Friend debug"
help help
Use this option to enable Friend debug logs for the Use this option to enable Friend debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
config BT_MESH_DEBUG_PROXY config BT_MESH_DEBUG_PROXY
bool "Proxy debug" bool "Proxy debug"
@ -862,7 +862,7 @@ config BT_MESH_DEBUG_CFG
bool "Configuration debug" bool "Configuration debug"
help help
Use this option to enable node configuration debug logs for the Use this option to enable node configuration debug logs for the
Bluetooth Mesh functionality. Bluetooth mesh functionality.
endif # BT_MESH_DEBUG endif # BT_MESH_DEBUG

View file

@ -1,4 +1,4 @@
Bluetooth Mesh implementation tasks Bluetooth mesh implementation tasks
=================================== ===================================
* Ability to act as provisioner * Ability to act as provisioner

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2018 Nordic Semiconductor ASA * Copyright (c) 2018 Nordic Semiconductor ASA
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2018 Nordic Semiconductor ASA * Copyright (c) 2018 Nordic Semiconductor ASA
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2018 Nordic Semiconductor ASA * Copyright (c) 2018 Nordic Semiconductor ASA
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2021 Lingao Meng * Copyright (c) 2021 Lingao Meng

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2021 Nordic Semiconductor ASA * Copyright (c) 2021 Nordic Semiconductor ASA
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Nordic Semiconductor ASA * Copyright (c) 2020 Nordic Semiconductor ASA

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Nordic Semiconductor ASA * Copyright (c) 2020 Nordic Semiconductor ASA

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Lingao Meng * Copyright (c) 2020 Lingao Meng

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Lingao Meng * Copyright (c) 2020 Lingao Meng

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2020 Nordic Semiconductor ASA * Copyright (c) 2020 Nordic Semiconductor ASA
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Lingao Meng * Copyright (c) 2020 Lingao Meng

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Lingao Meng * Copyright (c) 2020 Lingao Meng

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Lingao Meng * Copyright (c) 2020 Lingao Meng

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Lingao Meng * Copyright (c) 2020 Lingao Meng

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* Copyright (c) 2020 Lingao Meng * Copyright (c) 2020 Lingao Meng

View file

@ -1,8 +1,3 @@
/** @file
* @brief Bluetooth Mesh shell
*
*/
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *
@ -2806,5 +2801,5 @@ static int cmd_mesh(const struct shell *shell, size_t argc, char **argv)
return -EINVAL; return -EINVAL;
} }
SHELL_CMD_ARG_REGISTER(mesh, &mesh_cmds, "Bluetooth Mesh shell commands", SHELL_CMD_ARG_REGISTER(mesh, &mesh_cmds, "Bluetooth mesh shell commands",
cmd_mesh, 1, 1); cmd_mesh, 1, 1);

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* Bluetooth Mesh */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,16 +1,16 @@
Bluetooth Mesh BabbleSim tests Bluetooth mesh BabbleSim tests
############################## ##############################
This directory contains a set of high level system tests for the Bluetooth Mesh This directory contains a set of high level system tests for the Bluetooth mesh
subsystem. The tests run on the BabbleSim simulator, using the BabbleSim test subsystem. The tests run on the BabbleSim simulator, using the BabbleSim test
framework. framework.
Tests are organized into bash scripts under the test_scripts folder. Each Tests are organized into bash scripts under the test_scripts folder. Each
subfolder of test_scripts contains tests for a specific module in the Bluetooth subfolder of test_scripts contains tests for a specific module in the Bluetooth
Mesh subsystem, and each folder has a corresponding test_<subfolder>.c under the mesh subsystem, and each folder has a corresponding test_<subfolder>.c under the
src/ directory containing the necessary test harnesses to execute the tests. src/ directory containing the necessary test harnesses to execute the tests.
There's only a single test application for all the Bluetooth Mesh BabbleSim There's only a single test application for all the Bluetooth mesh BabbleSim
tests. The test application is built from this directory, and includes all test tests. The test application is built from this directory, and includes all test
harnesses in every build. The overlying bsim test framework selects the harness harnesses in every build. The overlying bsim test framework selects the harness
to use at runtime, using the test identifiers passed in the test scripts. to use at runtime, using the test identifiers passed in the test scripts.
@ -18,7 +18,7 @@ to use at runtime, using the test identifiers passed in the test scripts.
Running the tests Running the tests
***************** *****************
The Bluetooth Mesh tests have no extra requirements, and can be run using the The Bluetooth mesh tests have no extra requirements, and can be run using the
procedure described in the parent folder. procedure described in the parent folder.
To only run the mesh tests, set ``SEARCH_PATH`` to point to this folder before To only run the mesh tests, set ``SEARCH_PATH`` to point to this folder before
@ -57,13 +57,13 @@ Then separately, call
Framework Framework
********* *********
The Bluetooth Mesh BabbleSim tests mainly operate on the test framework for the The Bluetooth mesh BabbleSim tests mainly operate on the test framework for the
BabbleSim platform, but with some Mesh specific additions: BabbleSim platform, but with some mesh specific additions:
mesh_test.sh mesh_test.sh
============= =============
All test scripts in the Bluetooth Mesh BabbleSim test suite follow a common All test scripts in the Bluetooth mesh BabbleSim test suite follow a common
pattern for running a single test across N devices with different test pattern for running a single test across N devices with different test
harnesses. ``mesh_test.sh`` is sourced in each test script, and its ``RunTest`` harnesses. ``mesh_test.sh`` is sourced in each test script, and its ``RunTest``
function is called once in each script with the following parameters: function is called once in each script with the following parameters:
@ -113,6 +113,6 @@ has been called - otherwise, it will fail.
The Bluetooth stack must be initialized in the ``test_main_f`` function of The Bluetooth stack must be initialized in the ``test_main_f`` function of
the harness, as the previous callbacks are all executed in hardware threads. the harness, as the previous callbacks are all executed in hardware threads.
The Bluetooth Mesh tests include the entire Bluetooth host and controller The Bluetooth mesh tests include the entire Bluetooth host and controller
subsystems, so timing requirements should generally be kept fairly liberal to subsystems, so timing requirements should generally be kept fairly liberal to
avoid regressions on changes in the underlying layers. avoid regressions on changes in the underlying layers.

View file

@ -1,5 +1,5 @@
/** @file /** @file
* @brief Common functionality for Bluetooth Mesh BabbleSim tests. * @brief Common functionality for Bluetooth mesh BabbleSim tests.
*/ */
/* /*

View file

@ -1,7 +1,3 @@
/** @file
* @brief Interactive Bluetooth Mesh shell application
*/
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *

View file

@ -1,5 +1,3 @@
/* mesh.c - Bluetooth Mesh Tester */
/* /*
* Copyright (c) 2017 Intel Corporation * Copyright (c) 2017 Intel Corporation
* *