Introduction

This KBA is a step-by-step guide for building and using the Bluetooth/Zigbee Commissioning Test System described in UG267 and the first part of this KBA:

Bluetooth Commissioning Test System -- Switched Multiprotocol (SMP)Sample Applications (UG267) Part I

Building the components of the system

This KBA expects that you have built either Zigbee or BLE apps with Simplicity Studio before, so not all steps will be described in detail.
[Note: Only IAR EWARM is supported as the compiler for these projects. GCC is expected in the future.]

We recommend using the brd4161A or brd4162A for all parts of this project.

1) Gecko Bootloader
Build the Gecko bootloader v1.4.1 for your part. Use the default settings for the Internal Storage Bootloader (Multiple Images), Generate and Build the project.
Load this bootloader onto all 3 of your WSTK+Radio Card sets. You can use the Simplicity Commander CLI to do a device masserase and then flash the -combined.s37 version of the bootloader to be sure you are doing a "clean" installation.

2) BLE NCP
Pick the Bluetooth HomeKit SDK + Platform Application type in the new AppBuilder project window and then pick the Bluetooth SDK 2.7.0.0. Select the NCP target - Switched Multiprotocol Trust Center and Generate and Build for your part with the default settings. Load this onto one of the WSTKs.

3) BLE Host App
Run Make in the switched_multipr_trust_center directory from \developer\sdks\gecko_sdk_suite\v2.0\app\bluetooth_2.6\examples_ncp_host\switched_multipr_trust_center into your host development environment. Normally, you will have either copied your stack onto your linux host or referenced it in your cross-compiling environment.

Plug in the WSTK with the BLE NCP on it, and execute the host app on your host as follows:
(assuming your USB port is ACM1)
./switched_multipr_trust_center /dev/ttyACM0 115200

4) Zigbee NCP
Pick the AppBuilder Customizable network coprocessor (NCP) applications and select EmberZNet 6.1.0.0 GA Network Coprocessor (NCP) Applicaiton Framework 6.1.0.0. Then pick the NCP UART HW (Hardware Flow Control) for your part, Generate, Build and Flash it onto a WSTK.

5) Zigbee Host App
Pick the AppBuilder ZCL Application Framework V2, Ember ZNet 6.1.0.0 GA Host 6.1.0.0, and select the SwitchedMultiprotocolTrustCenter. For Part, pull down None(Compatible).
After Generating, copy the project folder into the equivalent location on the stack in your build environment and Make it.

Plug in the WSTK with the Zigbee NCP on it and execute the host app with the following:
./SwitchedMultiprotocolTrustCenterHost_linux_4161_1217 -p /dev/ttyACM1 -b 115200

6a) BLE Joining Device .s37

Coming soon
6b) BLE Joining Device .gbl.bin

Coming soon
7a) Zigbee Joining Device .s37

Coming soon
7b) Zigbee Joining Device .gbl.bin

Coming soon

7c) Zigbee Joining Device .ota

Coming soon
8) Mobile App (just download and install)

Coming Soon

9) Uploading OTA file to Mobile Phone

Coming soon

10) Using the Mobile App to Bind and Commission

Coming soon

11a) Uploading OTA file to Joiner from Phone (Optional, not working 100%)

Coming soon

11b) Storing Zigbee App in Joiner Memory Slot (Recommended)

Coming soon

12) Booting into ZIgbee App and Joining Trust Center

Coming soon

Introduction

This set of sample apps provided in the Gecko SDK Suite (from v1.0.1) is designed to demonstrate Mobile App-based commissioning of a Switched Multiprotocol Bluetooth Low Energy (BLE) / Zigbee joining device using a Trust Center with both BLE and Zigbee communications. It is described in section 8 of UG267.

[NOTE: As of Q3 2017, this suite of sample applications and documentation is currently broken. This KBA will detail the areas in the applications which have problems and will be updated when the bugs are corrected.]

This KBA is intended to describe the structure of the system, how the it should work, and give some step-by-step instructions for using it as a supplement to UG267.

The following are the components required for this system.

A Host computer, an Android mobile phone, and 3 Silabs WSTK Dev Boards with radio boards (brd4161A or brd4162A recommended so internal flash can be used for storage slots).

Host: A POSIX OS capable of running BLE and Zigbee host apps which use Interprocess Communications (IPC) to pass data between each other. This rules out running in Windows in most cases, because Windows does not support IPC and although cygwin may be able to do this with modifications, we have not pursued it. Our recommendation is to use MacOS or linux, whether an desktop linux OS, a virtual machine, or a Raspberry Pi, which is what is used in this example. You need to have the host set up to run GCC, which may require some additional components such as ncurses. Alternatively, you can cross-compile for your target.

Attached to the host are two WSTKs. One will run a Bluetooth NCP and the other will run a Zigbee NCP. The host apps for each of these will communicate with each other via IPC.

Mobile Phone App: Currently the mobile app runs on Android, while an iOS version is forthcoming.
There are two applications available, Gecko Commissioner, which is available in the Google Play Store and Gecko Commissioner QA, available at http://intrepid.io/ota/worcester-android/
[Note: the "worcester-android" version currently works better than the Play Store version so it is recommended. In the future, the Play Store version should be updated with improvements.]

Joining Device: This begins with a BLE app in the Application area of Flash, and it has two storage slots, one for the BLE app and one which is the target for the Zigbee app OTA download. This KBA will recommend loading the Zigbee .gbl directly.

[Note: due to a bug in storage, the OTA download is almost, but not quite working. You can see the Mobile App send the OTA, but it won't get stored.]
 

Bluetooth Commissioning Test System Concept
The Host can initially talk to the Joining Device and the Mobile App using Bluetooth. Once the commissioning information is shared between the BLE App and the Zigbee Trust Center also running on the Host, the Joining device will optionally be delivered the Zigbee app via Over-the-air download from the Mobile App (if OTA were working correctly), or already have the Zigbee app present in a storage slot. The Joining Device then copies the Zigbee app into Application space and reboots into it. The commissioning information is in place and the Zigbee App joins the Zigbee Trust Center.

There are two scenarios, a "Pull" system and a "Push" system.

The "Pull" Scenario

Commissing information (ie, the device's Install Code) is collected ("pulled") from the Joining Device's BLE app by the Mobile App and sent to the BLE app on the Host, which sends it via IPC to the Zigbee Trust Center on the Host.

The "Push" Scenario

The Mobile App gets the Network Key from the Trust Center via Bluetooth. (The Mobile App requests the key from the BLE host app, which queries the Zigbee Trust Center via IPC.) The Mobile App then transfers the Network Key to the BLE Joining Device, which stores the information to be used when rebooting into the Zigbee App.

[Note: due to a known bug, the Push scenario is not currently working.]

Building the SMP Bluetooth Commissioning Test System
As you can see, this is a large system with many moving parts. Here is what you will be building/using:
1) Gecko Bootloader. This will be an internal storage bootloader with 2 slots. If you use the same radio board for all 3 of the WSTKs, you can use the same bootloader, even for the NCPs which do not use the storage slots.
2) BLE NCP
3) BLE Host App
4) Zigbee NCP
5) Zigbee Host App
6a) BLE Joining Device .s37
6b) BLE Joining Device .gbl.bin
7a) Zigbee Joining Device .s37
7b) Zigbee Joining Device .gbl.bin
7c) Zigbee Joining Device .ota
8) Mobile App (just download and install)

Step-by-step instructions are available here
Bluetooth Commissioning Test System -- Switched Multiprotocol (SMP)Sample Applications (UG267) Part II