5.2.1.3 BLE Sensor App with RGB LED (without Touch)

WBZ351 Curiosity Board

Hardware Required

Hardware Modification

A simple hardware modification is needed to run this demo. WBZ351 Curiosity boards has on-board RGB LED on PB0, PB3, PB5 pins. But, these pins are multiplexed with CVD Touch functionality. Hence the connection to R and B LED's are disconnected by default on the board. Mount 0 ohm resistor or make the solder connection on R92 and R95 resistor position as shown below.

Note: If these resistors are mounted, PB0 and PB5 pins can not be used for CVD Touch input.

Software

To install Tera Term tool, refer to the Tera Term web page in Reference Documentation from Related Links.

Smrtphone App

Programming the Precompiled Hex file or Application Example

Using MPLAB® X IPE:

1. Import and program the precompiled hex file: <Discover Path>\wireless_apps_pic32cxbz3_wbz35\apps\ble\advanced_applications\ble_sensor_touch\precompiled_hex\ble_sensor_rgb.X.production.signed.hex.

2. For detailed steps, refer to Programming a Device in MPLAB® IPE in Reference Documentation from Related Links.
   Note: Ensure to choose the correct Device and Tool information.

Using MPLAB® X IDE:

1. Perform the following the steps mentioned in Running a Precompiled Example. For more information, refer to Running a Precompiled Application Example from Related Links.

2. Open and program the application example ble_sensor_touch.x located in <Discover Path>\wireless_apps_pic32cxbz3_wbz35\apps\ble\advanced_applications\ble_sensor_touch\firmware.

3. Comment out the ENABLE_TOUCH compile time switch in app.h to disable Touch functionality.
4. Program the application.
5. For more details on how to find the Discover path, refer to Download Application Example from Discover in Running a Precompiled Application Example from Related Links.

Demo Description

1. The WBZ351 module will be a BLE peripheral device and will advertise on startup. The user can initiate the connection through mobile application. The advertisement payload holds the temperature information and the RGB On/Off status, for more information refer to Protocol Exchange from Related Links.

2. Uses “BLE Sensor” sub app from the Microchip Bluetooth Data (MBD) mobile app for BLE demonstration.

   • Application is supported by iOS and Andrioid OS

   • Available in respective app stores/play stores

3. When Connected(ING) to the application the BLUE color “User LED” will turn on

   • Blinks the “User LED” with 500 ms blink interval when the device sending advertisement packets

   • Once connected, the “User LED” turns on solid

4. From the Smartphone App the following actions can be performed

   • The RGB LED can be switched On/Off from MBD mobile app

   • When LED is switched On, the RGB color can be changed from mobile app color wheel

     • The RGB color value is received as HSV (Hue, Saturation, Value) from mobile app through TRPS. For more information, refer to the Transparent Profile and Service (TRP/TRS) in Protocol Exchange from Related Links.

     • The HSV value is converted to RGB equivalent value in the device. The corresponding PWM duty cycle for R,G,B will be calculated and the PWM pulse is provided on R,G,B LEDs.

5. From the WBZ351 module the following actions can be performed

   • The RGB LED can be switched on/off by pressing the On board “User Button”

     • When the “User Button” is pressed and released the RGB LED is switched ON with default color GREEN or the last stored color.

     • When the “User Button” is pressed and released again, then the RGB LED will be toggled from the previous state.

   • Read the temperature sensor every 1 sec once and send the temperature value to mobile app when the temperature changes about 1^oC

Demo

1. Install the Microchip Bluetooth Data (MBD) Smartphone App

   1. iOS/Android users can search for “Microchip Bluetooth Data” App in App Store and install

   2. Enable Bluetooth on the Smartphone

2. Launch the MBD Smartphone App

3. Supply power to WBZ351 Curiosity Board

   1. Connect a USB cable to the kit or a 4.2V Li-ion/Li-Po Battery. For more information refer to the Power Supply section of the WBZ351 Curiosity Board User's Guide.

   2. The user-programmable blue LED starts blinking on the Curiosity Board when the board is in advertisement mode.

4. UART Console Behavior

   1. The application activity is shown as “Console Log” through on board UART-USB converter
   2. Open Terminal (Example: Tera Term) to look for these logs - UART baud settings: 115200 8-N-1 without flow control

   

5. Monitor RGB LED state and Temperature

   1. WBZ351 Curiosity Board starts in advertisement mode to advertise its presence on a smartphone and to allow access to RGB LED on/off state and temperature sensor data.

   2. Navigate through the Smartphone App as shown in the following figure to access the advertisement information.

      

6. Control RGB LED state on/off as well as intensity and color

   1. Click the device that shows up after initiating a scan to establish a connection with WBZ351 module.

   2. The user programmable blue LED becomes solid once connection is established between the smartphone and WBZ351 module

   3. Controls the RGB LED state on/off.

   4. Controls the color of RGB LED when the LED is “on”.

   5. Controls the intensity of RGB LED when the LED is “on”.

   6. Additional information

      

7. To disconnect the MBD Application running on your smart phone, you can do one of the following:

   1. Press the reset button on WBZ351 Curiosity Board

   2. Initiating a “Scan” on Smartphone App

Upon successful disconnection, the WBZ351 module starts in Advertisement Mode.

Protocol Exchange

Application Flow Diagram