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

ReceiveINTArray

	ReceiveINTArray
Receives an array of 16-bit INT/UINT values and returns the number of values received.
- UINT	Data
Array to store the incoming data
- BYTE	NumValues
Maximum number of values to try and receive
- BOOL	MSBfirst
0=Least significant byte first, 1=Most significant byte first
- BYTE	Timeout
Max amount of time in ms to wait between bytes
- BYTE	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 an array of bytes 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

SendINTArray

	SendINTArray
Sends an array of 16-bit integers to the Bluetooth serial connection
- UINT	Data
Data Array to send
- UINT	NumValues
Number of bytes to send
- BOOL	MSBFirst
0=Least significant byte first, 1=Most significant byte first
- 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

Component Source Code

Please click here to download the component source project: FC_Comp_Source_Bluetooth_ESP32_BLE_GATT_SPP_Server_1.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_Bluetooth_ESP32_BLE_GATT_SPP_Server_1.fcfx