BLE Agent

BLE Agent is used to control and validate Bluetooth Low Energy (BLE) operations, including advertising, scanning, pairing, connecting to BLE devices, and exchanging data, to verify BLE-based communication and functionality.

BLE Agent Blocks

1. BLE Power

Turns BLE functionality ON or OFF on the device.

Properties

Inputs

Parameter Name	Description
State (On/Off)	Select “On” to enable or “Off” to disable BLE power.

BLE Power - input parameter.

Outputs

Output Code	Description
0	BLE power state updated
1	Unable to update BLE power
-1	Invalid BLE power request

BLE Power - output parameter.

Output Possibilities Configuration

2. BLE Scan

Scans for nearby BLE devices and returns discovered devices.

Properties

Inputs

Parameter Name	Description
State (On/Off)	Select “On” to enable or “Off” to disable BLE power.

BLE Scan - input parameter.

Outputs

Output Code	Description
0	BLE scan completed
1	BLE scan failed
-1	Invalid BLE scan request

BLE Scan - output parameter.

Output Possibilities Configuration

3. BLE Connect

Establishes a connection with the specified BLE device.

Properties

Inputs

BLE Connect - input parameter.

Outputs

Output Code	Description
0	Connected to BLE device.
1	Unable to connect BLE device.
-1	Invalid BLE device details.
2	Connection timeout occurred.

BLE Connect - output parameter.

Output Possibilities Configuration

4. BLE Disconnect

Disconnects the currently connected BLE device.

Properties

Inputs

Parameter Name	Description
MAC Address	MAC address of the connected BLE device

BLE Disconnect - input parameter.

Outputs

Output Code	Description
0	Disconnected from BLE device
1	Unable to disconnect BLE device
-1	Invalid BLE disconnect request

BLE Disconnect - output parameter.

Output Possibilities Configuration

5. BLE Get RSSI

Retrieves the RSSI (Received Signal Strength Indicator) value from a connected BLE device.

Properties

Inputs

Parameter Name	Description
MAC Address	MAC address of the connected BLE device

BLE Get RSSI - input parameter.

Outputs

Output Code	Description
0	BLE RSSI value retrieved
1	Unable to get BLE RSSI value
-1	Invalid RSSI request

BLE Get RSSI - output parameter.

Output Possibilities Configuration

6. BLE Info

Retrieves information about the specified BLE device.

Properties

Inputs

Parameter Name	Description
MAC Address	MAC address of the BLE device

BLE Info - input parameter.

Outputs

Output Code	Description
0	BLE device information fetched
1	Unable to fetch BLE info
-1	Invalid BLE info request

BLE Info - output parameter.

Output Possibilities Configuration

7. BLE Write

Writes data to the specified BLE characteristic.

Properties

Inputs

Parameter Name	Description
MAC Address	MAC address of the BLE device
Service UUID	UUID of the target BLE service
Value	Data payload to write

BLE Write - input parameter.

Outputs

Output Code	Description
0	BLE written
1	BLE write failed
-1	Invalid BLE write request

BLE Write - output parameter.

Output Possibilities Configuration

8. BLE Read

Reads data from the specified BLE characteristic.

Properties

Inputs

Parameter Name	Description
MAC Address	MAC address of the BLE device
Service UUID	UUID of the target BLE service

BLE Read - input parameter.

Outputs

Output Code	Description
0	BLE read
1	BLE read failed
-1	Invalid BLE read request

BLE Read - output parameter.

Output Possibilities Configuration

9. BLE Send Command

Sends a BLE command to the connected BLE device.

Properties

Inputs

Parameter Name	Description
MAC Address	MAC address of the BLE device
Hex Byte	Data payload to write

BLE Send Command - input parameter.

Outputs

Output Code	Description
0	BLE command sent successfully
1	BLE command failed
-1	Invalid BLE command request

BLE Send Command - output parameter.

Output Possibilities Configuration

10. BLE Unpair

Removes pairing information for the specified BLE device.

Properties

Inputs

Parameter Name	Description
MAC Address	MAC address of the BLE device to unpair

BLE Unpair - input parameter.

Outputs

Output Code	Description
0	BLE device unpaired
1	BLE unpair failed
-1	Invalid BLE unpair request

BLE Unpair - output parameter.

Output Possibilities Configuration