History

Francisco Gil 20118a0f71 ble: dey-example: update example to match with latest bluez version Now the bt_att_set_debug requires a new parameter to set the debug level. This is caused by the update of the bluez library. https://onedigi.atlassian.net/browse/DEL-8151 Signed-off-by: Francisco Gil <francisco.gilmartinez@digi.com>		2022-11-08 12:37:36 +01:00
..
Makefile	ble-gatt-server-example: add sample application to create a BLE GATT server	2019-07-11 10:58:12 +02:00
README.md	ble-gatt-server-example: add sample application to create a BLE GATT server	2019-07-11 10:58:12 +02:00
ble-gatt-server-app.c	ble: dey-example: update example to match with latest bluez version	2022-11-08 12:37:36 +01:00
ble-gatt-server-app.h	ble-gatt-server-example: add sample application to create a BLE GATT server	2019-07-11 10:58:12 +02:00
subprocess.c	ble-gatt-server-example: add sample application to create a BLE GATT server	2019-07-11 10:58:12 +02:00
subprocess.h	ble-gatt-server-example: add sample application to create a BLE GATT server	2019-07-11 10:58:12 +02:00

README.md

BLE GATT Server Example Application

Example application to create a BLE GATT server.

This application enables a BLE GATT server on the board. After that, the application starts listening for BLE connections to provide custom BLE GATT services and characteristics.

Running the application

Once the binary is in the target, you must configure the bluetooth interface with the following commands:

~# btmgmt -i hci0 le on
hci0 Set Low Energy complete, settings: powered connectable bondable ssp br/edr le advertising secure-conn
~# btmgmt -i hci0 connectable on
hci0 Set Connectable complete, settings: powered connectable bondable ssp br/edr le advertising secure-conn
~# btmgmt -i hci0 pairable on
hci0 Set Bondable complete, settings: powered connectable bondable ssp br/edr le advertising secure-conn
~# btmgmt -i hci0 advertising on
hci0 Set Advertising complete, settings: powered connectable bondable ssp br/edr le advertising secure-conn
~#

After you initialize the bluetooth interface, you can start the sample application:

~# ./ble-gatt-server-example -h
Usage:
        ble-gatt-server-app [options]
Options:
        -i, --index <id>                Specify adapter index, e.g. hci0
        -t, --threshold <temp>          The temperature threshold to send notification
        -m, --mtu <mtu>                 The ATT MTU to use
        -v, --verbose                   Enable extra logging
        -h, --help                      Display help
~#
~# ./ble-gatt-server-example --index hci0 --threshold 50
Running GATT server
Started listening on ATT channel. Waiting for connections
Connect from XX:XX:XX:XX:XX:XX

Compiling the application

This demo can be compiled using a Digi Embedded Yocto based toolchain. Make sure to source the corresponding toolchain of the platform you are using, for example, for ConnectCore 8X:

~$ . <DEY-toolchain-path>/environment-setup-aarch64-dey-linux
~$ make

For more information, see the Digi Embedded Yocto online documentation.

License

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appears in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.