This is a quick guide on how to use the thingy52-mesh-provisioning-demo with the nRFMesh mobile app on iOS and Android.
There is a video demonstration of the demo here: https://www.youtube.com/watch?v=XthbU9NP0Yg
The demo can be used with as many Thingy as needed but it also works with just one Thingy. The Thingy firmware equiped with both Generic OnOff client and Generic OnOff Server.
Users can use nRF Mesh app to do provisioning for each Thingy. Output OOB authentication can be used, You would need to count the number of LED blink you see on the Thingy when asked on the app.
Inside each Thingy there are 2 elements, the first element has the foundation models and the Generic OnOff server, the second element has Generic OnOff client.
Users can choose to configure the node to be a light bulb by setting up the Generic OnOff server on the first element (binding app key and choose subscription address, for example group address 0xC001). And/or can configure the node as light switch by configuring the Generic OnOff client (bind appkey and choose publication address, group 0xC001 for example)
One node can be light bulb or light switch or both at the same time.
User can use mobile app to interact directly with the Generic OnOff server on the Thingy. It's the only model the app support direct control for now. (Any model will work with the app, but only for configuration, not direct control)
User can clear provisioning information of a node (reset the node) by holding the main button (on top of the thingy) and switch off and on the Thingy. Thingy will start as a fresh device, showing red breathing LED.
- Breathing Red: Thingy is not provisioned and has not joined the network
- Breathing Green: Thingy is provisioned but has not been configured (TBD)
- Blink white once: Thingy has been configured and has either a subscription/publication address. (TBD)
- Blink several times: It's the OOB authentication, please type the number of blink to the app when asked.
- Turn on or off solid White: Thingy in normal operation, light is turn off or on.
The firmware based on the proxy_server and proxy_client example in Mesh SDK v3.2.x. It uses some LED driver from Thingy SDK to control the LED. Generic OnOff model is used so that it allows the mobile app to control the model from the app. Authentication:
-
Output OOB: uses NRF_MESH_PROV_OOB_OUTPUT_ACTION_BLINK for OOB authentication, the Thingy blinks from 1 to 5 times when provisioning
-
Static OOB: uses NRF_MESH_PROV_OOB_STATIC_TYPE_SUPPORTED for OOB authentication, the data is hardcoded on Thingy firmware, which is 0x888888888888888888888888 (32 digit 8) it can be modified in light_switch_example_common.h
- Nordic nRF5x-DK or Segger J-Link debugger
- 2x5 1.27mm SWD cable
- Nordic Thingy:52
- Nordic Thingy:52 SDK v2.1.0 with mod to work with SDK v15 logger module. It's provided as a .zip in this repo
- Nordic nRF5 SDK for Mesh v3.2.0
- Nordic nRF5 SDK v15.3
- Segger Embedded Studio
To run the demo, you can use the precompiled firmware, or use Segger Embedded Studio to compile the firmware.
To compile the demo firmware and run the demo, please follow the steps:
- Download and extract nRF5 Mesh SDK v3.2.0
- Extract ThingySDKv2.1_mod.zip inside "external" in Mesh SDK. Should keep the "ThingySDKv2.1" folder name.
- Download and extract nRF5 SDK v15.3
- In SDK v15.3: \components\boards folder remove/rename file pca20020.h. It conflicts with the same file in Thingy SDK.
- Clone this repo into \examples\ (so that thingy_provisioning_demo.emProject is 2 levels under "examples" folder. )
- Connect the Thingy to the Debug port out on the DK or the Segger Jlink debugger.
- Do an erase all to remove the Thingy original firmware and bootloader
- Open Segger Embedded Studio, and install the "nRF CPU Support Package". You can check it by click the main tool bar "Tools" -> "Package Manager", and search "nRF CPU Support Package".
- Make sure you followed the SES.md guide in \doc\getting_started in nRF MESH SDK v3.2.0 of adding
SDK_ROOTmacro into SES, the same as when you started with Mesh examples. - Compile one of the project provided in this repo and flash the firmware, the softdevice is flashed automatically.