Component: Bluetooth BLE (ESP32 SPP Server) (Wireless)

Author	Matrix TSL
Version	1.0
Category	Wireless

Bluetooth BLE (ESP32 SPP Server) component

Bluetooth BLE server component designed to run on a ESP32 providing GATT SPP functionality. BT BLE functionality must be switched on via the sdkconfig file.

Detailed description

This component requires the Bluetooth and Bluedroid libraries from the ESP32 IPE.

If you get this error when compiling: esp_bt.h: No such file or directory

Then you may not have Bluetooth enabled.

To fix this navigate to C:\FC_ESP\mtx<chiptype>_sdkconfig\

Then run menuconfig.bat to open the configuration editor.

Goto Component Config -> Bluetooth

Check the item Bluetooth.

Then go into Bluedroid Options and ensure the Enable BLE 4.2 features near the bottom is ticked.

Save and exit and then re-compile 🙂

Examples

No additional examples

Macro reference

CheckConnectionStatus

	CheckConnectionStatus
Checks to see if the Bluetooth device is connected. Returns 1 if connected.
- BOOL	Return

Initialise

	Initialise
Starts up the Bluetooth communications SPP service.
- VOID	Return

ReceiveArray

	ReceiveArray
Attempts to receive an array of bytes from the bluetooth serial port. Returns the number of bytes received.
- BYTE	Data
Buffer to place received data into
- UINT	MaxBytes
Max number of bytes to try and read within the time
- UINT	Timeout
Number of ms to wait for incoming data
- UINT	Return

ReceiveByte

	ReceiveByte
Attempts to receive a byte from the bluetooth serial port. 0-255 = a valid received value 256 = a timeout has occured
- UINT	Timeout
Number of ms to wait for incoming data
- UINT	Return

ReceiveCount

	ReceiveCount
Collects the number of bytes currently stored in the receive buffer.
- UINT	Return

ReceiveString

	ReceiveString
Attempts to receive a string of characters from the Bluetooth SPP. Terminates on timeout, on receiving the MaxBytes or on receiving a '\n' character
- UINT	MaxBytes
Max number of bytes to try and read within the time
- UINT	Timeout
Number of ms to wait for incoming data
- STRING	Return

SendArray

	SendArray
Sends a byte to the Bluetooth serial connection
- BYTE	Data
Data Array to send
- UINT	NumBytes
Number of bytes to send
- VOID	Return

SendByte

	SendByte
Sends a byte to the Bluetooth serial connection
- BYTE	Data

- VOID	Return

SendString

	SendString
Sends a string to the Bluetooth serial connection
- STRING	Data
Data Array to send
- VOID	Return

Uninitialise

	Uninitialise
Shots down the Bluetooth communications SPP service.
- VOID	Return

Property reference

	Properties
	Device Name
Sets the Bluetooth device friendly name. Max 19 characters.
	Receive Buffer
Configures the size of the receive buffer in bytes to store incoming data until we are ready to receive it.
	Service UUID
16-bit value that identifies the custom “Simple SPP” service so scanners know the device supports that feature.
	Characteristic UUID
16-bit value that describes the single characteristic that carries the serial-like data flow (reads, writes, notifications).
	Data Receive Interrupt

	Verbose Debug
When enabled debug messages will be placed onto UART CH1 which is generally connected to via a Serial to USB IC to pipe messages back to the host PC.
	Simulation
	COM Port
Selects which port to communicate with, only lists ports which are currently available.
	Refresh COM Ports
When set to yes the COM port list is rescanned for newly connected or available ports. Note that refreshing the ports list may take a few seconds depending on the number of connected ports.
	Baud
Baud rate passed to the COM port to control the rate of data.
	Console Data