Kai Ren / client

Publishing for Bluetooth Asia 2018 developer session: mesh session. This repo is for GenericOnOff client side firmware.

EULA

PLEASE READ MESH_DEMO_TUTORIAL_EULA.TXT BEFORE START DEVELOPMENT.

Overview

This sample demonstrates Bluetooth Mesh functionality on micro:bit. It doesn't need provisioning because all the credential material (DevKey, NetKey, AppKey, Key Index, IVI and Unicast address) is pre-configured. This sample work as a GenericOnOff client:

  • Pressing Button A on micro:bit will send GenericOnOffSet access message with on or off state alternatively and specific group address;
  • Pressing Button B on micro:bit will switch the group address from 0xC000 to 0xC003 and back to 0xC000 again like round robin;

Requirements

micro:bit board

Building and Running

0. Download source code, it's zip file, the link is on this page, Download repository.

1. Following below link to set the development environment up on your Windows computer. http://docs.zephyrproject.org/getting_started/installation_win.html . Please make sure git checkout this commit, commit: 88dfd399f480b1593a8e13f5a68d512921a55502 , the detail is here, https://github.com/zephyrproject-rtos/zephyr/commit/88dfd399f480b1593a8e13f5a68d512921a55502

2. copy zip file into ./zephyr/sample/ in the Zephyr tree.

3. unzip the file by "Extract Here".

3. access into the extracted folder and rename prj_bbc_microbit.txt to prj_bbc_microbit.conf

4. if adopting Windows Command Prompt, use it to access into the unzip folder and type following commands on the console:

mkdir build & cd build

cmake -GNinja -DBOARD=bbc_microbit ..

ninja

if adopting MSYS2, use it to access into the unzip folder and type following commands on the console:

mkdir build & cd build

cmake -GNinja -DBOARD=bbc_microbit ..

ninja

5. connect micro:bit with your computer by USB cable, the board will be enumerated as a massive storage device;

6. drag the hex file (which is in ./zephyr/sample/[unzip folder]/build/zephyr/zephyr.hex) into Microbit massive storage device to flash the firmware;

7. micro:bit is ready to work as a GenericOnOff client.

Changes

RevisionDateWhoCommit message
16:64e0ae95d4f1 2018-05-28 krenbluetoothsig 1. update for code publish testing. default tip
15:ebdbdd25ac60 2018-05-28 krenbluetoothsig 1. update teh prj_bbc_microbit.txt
14:0c48375896d2 2018-05-28 krenbluetoothsig 1. CHG: push new README.
13:4531de96150b 2018-05-28 krenbluetoothsig This is for test.
12:2cebd2171a01 2018-05-28 krenbluetoothsig 1. NEW: add full source code.
11:4d9f3f506c13 2018-05-28 krenbluetoothsig 1. CHG: clear source code for mbed testing.
10:f83347affca6 2018-05-27 krenbluetoothsig client; 1. CHG: add some comments for client firmware.
9:ba6d8314dbb0 2018-05-27 krenbluetoothsig 1. NEW: add CONFIG_DISPLAY=y in order to make compiler pass the build.
8:4ed917660ce8 2018-05-27 krenbluetoothsig 1. NEW: add CONFIG_DISPLAY=y in prj_bbc_microbit.conf. ;
7:6512e150f5f6 2018-05-16 krenbluetoothsig 1. Final version before Bluetooth Asia, it supports persistent storage.
6:8ee39d23b0f3 2018-05-07 krenbluetoothsig 1. NEW: add MESH_DEMO_TUTORIAL_EULA.txt
5:ac22dae133d2 2018-05-02 krenbluetoothsig client; 1. sync the homepage on Mbed repo.
4:72457391f1b9 2018-05-02 krenbluetoothsig client; 1. CHG: README is ready. ; 2. still wait for EULA.
3:608b3e14dd31 2018-05-02 krenbluetoothsig add something in README
2:d62a2f9a0874 2018-05-02 krenbluetoothsig client; 1. NEW: add prj_bbc_microbit.txt, developer need to rename it as prj_bbc_microbit.conf;
1:fb4893064dd4 2018-05-02 krenbluetoothsig client; 1. NEW: add Zephy "get started" link.
0:876e59f87d50 2018-05-01 krenbluetoothsig import the client project.