zephyr/samples/bluetooth/st_ble_sensor
Torsten Rasmussen 407b49b35c cmake: use find_package to locate Zephyr
Using find_package to locate Zephyr.

Old behavior was to use $ENV{ZEPHYR_BASE} for inclusion of boiler plate
code.

Whenever an automatic run of CMake happend by the build system / IDE
then it was required that ZEPHYR_BASE was defined.
Using ZEPHYR_BASE only to locate the Zephyr package allows CMake to
cache the base variable and thus allowing subsequent invocation even
if ZEPHYR_BASE is not set in the environment.

It also removes the risk of strange build results if a user switchs
between different Zephyr based project folders and forgetting to reset
ZEPHYR_BASE before running ninja / make.

Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2020-03-27 16:23:46 +01:00
..
src Samples: Bluetooth: st_ble_demo: Update to new GPIO API 2020-02-05 12:00:36 +01:00
CMakeLists.txt cmake: use find_package to locate Zephyr 2020-03-27 16:23:46 +01:00
README.rst Samples: Bluetooth: st_ble_demo: Update to new GPIO API 2020-02-05 12:00:36 +01:00
prj.conf
sample.yaml

README.rst

.. _bluetooth-st_ble_sensor:

Bluetooth: ST BLE Sensor Demo
#############################

Overview
********

This application demonstrates BLE peripheral by exposing vendor-specific
GATT services. Currently only button notification and LED service are
implemented. Other BLE sensor services can easily be added.
See `BlueST protocol`_ document for details of how to add a new service.

Requirements
************

* `ST BLE Sensor Android app <ST BLE Sensor app>`_
* A board with BLE support

Building and Running
********************

This sample can be found under :zephyr_file:`samples/bluetooth/st_ble_sensor` in the
Zephyr tree.

Open ST BLE Sensor app and click on "CONNECT TO A DEVICE" button to scan BLE devices.
To connect click on the device shown in the Device List.
After connected, tap LED image on Android to test LED service.
Push SW0 button on embedded device to test button service.

See :ref:`bluetooth samples section <bluetooth-samples>` for details.

.. _ST BLE Sensor app:
    https://play.google.com/store/apps/details?id=com.st.bluems

.. _ST Nucleo WB55RG:
    https://www.st.com/en/microcontrollers-microprocessors/stm32wb55rg.html

.. _STM32CubeProgrammer:
    https://www.st.com/en/development-tools/stm32cubeprog.html

.. _BlueST protocol:
    https://www.st.com/resource/en/user_manual/dm00550659.pdf

.. _STM32WB github:
    https://github.com/STMicroelectronics/STM32CubeWB/tree/master/Projects/STM32WB_Copro_Wireless_Binaries