|Using Bluetooth Serial Port Profile|
Bluetooth is widely used when it is necessary to provide a wireless access to the devices located in short distances. In this application note we will show how to organize a wireless control channel to the STM32F7 SOM running Linux using a USB Bluetooth adapter. In practical embedded applications such a wireless channel may be used to implement a command/response protocol to control your STM32F7 based device via Bluetooth from the host machine (computer, notebook, smart-phone, etc.).
The hardware platform used in this application note is the Emcraft STM32F7 SOM Starter Kit with a USB Bluetooth adapter plugged into the USB OTG connector on the SOM-BSB-EXT development baseboard. The adapter used by Emcraft to perform the tests documented below was based on the LM506 chip. The generic Linux kernel device driver for the USB transport HCI layer (CONFIG_BT_HCIBTUSB) is used in this configuration so other USB Bluetooth adapters should work as described below too.
The goal is to have the STM32F7 act as a device with the Serial Port Profile (SPP) in the Bluetooth network. The STM32F7 will emulate the serial port over the Bluetooth transport and therefore the host will see the STM32F7 as an ordinary serial RS-232 port.
The Bluetooth Serial Port Profile interface is implemented with the BT_RFCOMM_TTY kernel driver. The sdptool and rfcomm utilities, ported from the bluez-utils package to the Linux STM32F7 SOM BSP, are used for configuration. The sdptool utility is used to create the "Serial Port" profile, exported over Bluetooth. The rfcomm utility is started in the "listen" mode and, on the "Serial Port" profile activation, rfcomm emulates a virtual COM port on the /dev/rfcommX device file, looking from the STM32F7 side.
The functionality described below is available from the rootfs.uImage project installed by Emcraft to every shipping STM32F7 SOM Starter Kit.
We will use the following terminology below:
Power-on the STM32F7 Starter Kit and wait for the Linux to boot on the Target. Run the Bluetooth daemons in the background:
Plug-in the Bluetooth adapter to the USB OTG interface of the STM32F7 Starter Kit. Observe the messages like these in the Target console:
usb 1-1: new full-speed USB device number 3 using dwc2
Get the <Target address> Bluetooth address of the adapter you have just plugged-in:
/ # cat /sys/class/bluetooth/hci0/address
Add the Serial Port profile to the list of Bluetooth profiles. In the example below the Bluetooth channel number to access this profile is 1:
/ # sdptool add --channel=1 SP
Start the background listening for raw connections on the channel 1:
/ # rfcomm --raw listen /dev/rfcomm0 1 &
On the Host, open a raw Bluetooth connection to the Target (<Target Address> Bluetooth Device, channel 1):
[yur@ubuntu rootfs]$ sudo rfcomm --raw connect 0 5c:f3:70:70:fa:d5 1
In the Target console observe an indication of the connection from the Host:
Connection from C4:D9:87:8C:B2:24 to /dev/rfcomm0
Send a text string (command) to the Target over the Bluetooth serial port from the Host:
[yur@ubuntu rootfs]$ echo "Hello from Host over the BT Serial" | sudo tee /dev/rfcomm0
On the Target receive the text string (command) just sent from Host:
/ # cat /dev/rfcomm0
Send a text string (response) from the Target to Host over the Bluetooth serial port:
/ # echo "Hello from Target over the BT Serial" > /dev/rfcomm0
Receive the text string (response) just sent from the Target over the Bluetooth serial port:
[yur@ubuntu rootfs]$ sudo cat /dev/rfcomm0
Disconnect the Host from the Bluetooth serial line by pressing Ctrl-C in the rfcomm --raw connect ... terminal window:
Observe the rfcomm termination on the Target side:
Please note that the rfcomm --raw listen ... command must be re-run on the Target to reopen the Bluetooth serial link again.