This blog introduces a vendor specific mesh model used for self configuration of Bluetooth mesh nodes. It is demonstrated with the help of two mesh demo code examples  - Dimmer_self_config and Embedded_provisioner.

Generally, we provision and configure mesh devices with the help of an external configuration client (Eg. Provisioners such as mobile apps, MeshClient, etc.). But in some scenarios where the mesh network does not allow (or need not allow) access for cell phones or any external devices, we can use the self-configuration vendor specific model for fast configuration. For example, a dimmer switch can be sold with one or several light bulbs. User should be able to power up the devices and start using them.

Here, Dimmer_self_config is a simple dimmer application with self-configure feature. It works in concert with Embedded_provisioner app - a dimmable light​​​ application which also serves as an embedded provisioner and/or self-configured device. In this blog, we will be looking at the implementation of Self-Configure feature of Dimmer_self_config in detail. If you are not familiar with simple dimmer and light_dimmable apps, please see the Mesh AppNote -AN227069​.

In this use case, the Embedded_provisioner app is expected to create a mesh network, scan for un-provisioned devices and provision Dimmer_self_config app without the help of any external provisioner devices. After provisioning, the Embedded Provisioner sends the Application Key and a vendor specific command to start the self-configuration of Dimmer_self_config app based on the hardcoded rules. The rules for self-configuration is hardcoded in the shared embedded_provisioner.h. After the successful configuration of Dimmer_self_config, LED on the Embedded_provisioner can be controlled using the push button on the Dimmer_self_config app. (Note: Enable both EMBEDDED_PROVISION and SELF_CONFIG flags in Embedded_provisioner app for this use case).

Below figure summarizes the overall mesh network structure.

Now, let us see some key steps required to implement the self-configure feature.

Step1: The rules for self-configuration is hardcoded in the shared embedded_provisioner.h. This header file mainly provides the definition of vendor specific model, configuration parameters/rules, required structures , etc.

The Cypress vendor specific Self-Config model is defined as follow.

The configuration parameters/rules (eg. Group address used for publication/subscription) are also defined in embedded_provisioner.h

Step2: Define configuration data of necessary models.

Along with necessary models for simple dimmer app, we define three additional models as well for Dimmer_self_config to aid self-configuration feature.

1. WICED_BT_MESH_MODEL_CONFIG_CLIENT – The model is used to represent an element that can control and monitor the configuration of a node.
2. WICED_BT_MESH_MODEL_DEFAULT_TRANSITION_TIME_CLIENT – The model may operate on states defined by the Generic Default Transition Time Server model
3. MESH_VENDOR_SELF_CONFIG_MODEL - Vendor Specific (VS) mesh model for used for Self-Configuration of the device.

Step3: Model Initializations.

Apart from the level client initialization, which is used for dimmer app functionality, we initialize the configuration client and default transition time client models as well with appropriate message callback handler passed as parameter to receive and process messages for respective the models.

mesh_default_transition_time_client_message_handler is implemented in mesh_default_transition_time_client.c.

Step4: Implementation of Vendor Server message handler to process vendor specific mesh messages.

As indicated earlier, the Embedded_provisioner needs to instruct the Dimmer_self_config app to start the self-configuration - based on the hardcoded rules - by sending appropriate vendor specific command. So, the Dimmer_self_config should have a vendor server message handler to process these vendor messages/commands and take appropriate actions.

mesh_vendor_server_message_handler() checks the model_id, opcode, subcode, etc. and ask the local device to do the self-configuration by calling self_configure() function.

Step5: Self-Configuration logic implementation.

self_configure(uint16_t node_addr) function implements the basic logic for self-configuration of the device by binding Application Key to all models, configure models for subscriptions, publications and setting default transition time.

The main sub functions called inside self_configure() for the configurations are: -

• configure_model_app_bind (uint16_t node_addr, wiced_bt_mesh_core_config_model_t* p_model, uint8_t element_idx, uint16_t app_key_idx)
• configure_model_sub (uint16_t node_addr, wiced_bt_mesh_core_config_model_t* p_model, uint8_t element_idx, uint16_t group_addr)
• configure_model_pub (uint16_t node_addr, wiced_bt_mesh_core_config_model_t* p_model, uint8_t element_idx, uint16_t app_key_idx, uint16_t pub_addr, uint32_t pub_period, uint8_t pub_ttl, uint8_t pub_rxmit_count, uint16_t pub_rxmit_interval, uint8_t pub_credentials)
• configure_default_transition_time (uint16_t node_addr, wiced_bt_mesh_core_config_model_t* p_model, uint16_t app_key_idx, uint32_t deftt)

Note: The Self Config logic can be combined with the normal configuration. For example, after performing hardcoded actions, the Provisioner can still use standard Config Relay Set method to turn the relay feature on or off.

Links:

mtb-example-btsdk-mesh-demo-dimmer-self-config

mtb-example-btsdk-mesh-demo-embedded-provisioner

Check the readme of each apps for testing instructions.

Bluetooth SDK

The Bluetooth SDK is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20735B1, CYW20835B1, CYW20819, CYW20820, CYW89820, and the CYW43012 Wi-Fi/BT combo (for embedded Bluetooth development only). ModusToolbox 2.2 with the Bluetooth SDK 2.8 provides a complete development environment to allow you to quickly create Bluetooth enabled IoT solutions like audio devices, beacons and trackers, hid devices, smart watches, medical devices, and home automation platforms.

The Bluetooth SDK includes:

• Bluetooth firmware
• Platform and board support packages
• Utilities including BTSpy trace, Manufacturing Bluetooth test tool, Client Control, and Mesh Client control
• Peer apps for OTA and Mesh
• A rich set of WICED™ connectivity APIs that allow for simplified programming of BT/BLE connectivity
• Various sample applications that serve as examples of how to utilize the BT/BLE APIs
• More complex code examples  that utilize various APIs and middleware to create a more complete solution

Notes for Installing Bluetooth SDK 2.8 with ModusToolbox 2.2:

• Note:  If a previous version of BT SDK2.x was installed and needs to be preserved, you will need to create a new workspace project in order to pull in Bluetooth SDK 2.8 and avoid overwriting previous versions.
• Within the IDE, click the “New Application” link in the Quick Panel
  • Alternatively, you can select File -> New -> ModusToolbox IDE Application
• This will launch the Project Creator.  In Project Creator, click on "WICED Bluetooth BSPs"
• Next, select the evaluation board you are using with Bluetooth SDK
• Now you will select a template application.
• Click Create.
• Click Close.

This release is an update to Bluetooth SDK 2.7.  Bluetooth SDK 2.8 is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20735B1, CYW20835B1, CYW20819, CYW20820, CYW89820 and the CYW43012 Wi-Fi/BT Combo (for embedded Bluetooth development only). ModusToolbox™ with the Bluetooth SDK software library provides a complete development environment to allow you to quickly create Bluetooth-enabled IoT solutions like smart watches, medical devices, or home automation platforms. This document describes the features and known limitations for Bluetooth SDK 2.8.

ModusToolbox® with the Bluetooth SDK provides a complete development environment that allows you to quickly create an IoT solution utilizing world-class Bluetooth/Bluetooth Low Energy (BLE) connectivity technologies.  This document provides the details of various features, modes, and limitations associated with the supported hardware development platforms.

ModusToolbox® with the Bluetooth SDK provides a complete development environment that allows you to quickly create an IoT solution utilizing world-class Bluetooth/Bluetooth Low Energy (BLE) connectivity technologies.  This document provides the details of various features, modes, and limitations associated with the supported hardware development platforms.

This release is an update to Bluetooth SDK 2.6.  Bluetooth SDK 2.7 is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20735B1, CYW20835B1, CYW20819, CYW20820, CYW89820 and the CYW43012 Wi-Fi/BT Combo (for embedded Bluetooth development only). ModusToolbox™ with the Bluetooth SDK software library provides a complete development environment to allow you to quickly create Bluetooth-enabled IoT solutions like smart watches, medical devices, or home automation platforms. This document describes the features and known limitations for Bluetooth SDK 2.7.

ModusToolbox™ with the Bluetooth SDK provides a complete development environment to allow one to quickly create an IoT solution utilizing Cypress’ world-class Bluetooth/BLE connectivity technologies.  This document also provides the details of many supported features and modes, and limitations associated with supported hardware development platforms.

This release is an update to the Bluetooth SDK 2.5.  The Bluetooth SDK 2.6 is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20735B1, CYW20819, CYW20820, CYW89820 and the CYW43012 Wi-Fi/BT Combo (for embedded Bluetooth development only). ModusToolbox™ with the Bluetooth SDK software library provides a complete development environment to allow you to quickly create Bluetooth enabled IoT solutions like smart watches, medical devices, or home automation platforms. This document describes the features and known limitations for the Bluetooth SDK 2.6

ModusToolbox™ with the Bluetooth SDK provides a complete development environment to allow one to quickly create an IoT solution utilizing Cypress’ world-class Bluetooth/BLE connectivity technologies. This document also provides the details of many supported features and modes, and limitations associated with supported hardware development platforms.

This release is an update to the BT SDK 2.4.  The BT SDK 2.5 is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20735B1, CYW20819, CYW20820, CYW89820 and the CYW43012 Wi-Fi/BT Combo (for embedded BT development only). ModusToolbox™ with the Bluetooth SDK software library provides a complete development environment to allow you to quickly create Bluetooth enabled IoT solutions like smart watches, medical devices, or home automation platforms. This document describes the features and known limitations for the BT SDK 2.5.