BLESecurity Class
BLESecurity Class
Description
A class used for creating and managing BLE bonding security parameters.
Syntax
class BLESecurity
Members
| Public Constructors | |
| No public constructor is available as this class is intended to be a singleton class. You can get a pointer to this class using BLEDevice::configSecurity |
| Public Methods | |
| BLESecurity::setPairable | Enable pairing and bonding after BLE connection |
| BLESecurity::setAuthFlags | Set BLE bonding security requirements |
| BLESecurity::setIOCapability | Set input output capability of the device |
| BLESecurity::setSecReqEnable | Enable sending SMP security request when BLE connected |
| BLESecurity::setSecReqFlags | Set security request requirements |
| BLESecurity::setStaticPin | Configure device to use static pin input for BLE bonding |
| BLESecurity::setPasskeyDisplayCallback | Set a user callback function for passkey display during BLE bonding |
| BLESecurity::setPasskeyInputCallback | Set a user callback function for passkey input during BLE bonding |
| BLESecurity::setNumericComparisonCallback | Set a user callback function for numeric comparison during BLE bonding |
BLESecurity::setPairable
Description
Enable pairing and bonding after BLE connection.
Syntax
void setPairable(bool pairMode);
Parameters
pairMode: 1 to enable pairing and bonding, 0 to disable.
Returns
The function returns nothing.
Example Code
Example: BLEHIDMouse
Notes and Warnings
NA
BLESecurity::setAuthFlags
Description
Set BLE bonding security requirements.
Syntax
void setAuthFlags(uint16_t authFlags);
Parameters
authFlags: desired BLE bonding security requirements. Valid values:
– GAP_AUTHEN_BIT_NONE
– GAP_AUTHEN_BIT_BONDING_FLAG
– GAP_AUTHEN_BIT_MITM_FLAG
– GAP_AUTHEN_BIT_SC_FLAG
– GAP_AUTHEN_BIT_SC_ONLY_FLAG
– GAP_AUTHEN_BIT_FORCE_BONDING_FLAG
Returns
The function returns nothing.
Example Code
Example: BLEHIDMouse
Notes and Warnings
If no security requirements are set, the default is set to GAP_AUTHEN_BIT_NONE.
BLESecurity::setIOCapability
Description
Set BLE device input output capabilities.
Syntax
void setIOCap(uint8_t ioCap);
Parameters
ioCap: desired device input output capabilities. Valid values:
– GAP_IO_CAP_NO_INPUT_NO_OUTPUT
– GAP_IO_CAP_DISPLAY_ONLY
– GAP_IO_CAP_DISPLAY_YES_NO
– GAP_IO_CAP_KEYBOARD_ONLY
– GAP_IO_CAP_KEYBOARD_DISPLAY
Returns
The function returns nothing.
Example Code
NA
Notes and Warnings
The IO capabilities of the peripheral and central device will determine which bonding authentication method is used.
If no IO capability is set, the default is set to GAP_IO_CAP_NO_INPUT_NO_OUTPUT.
BLESecurity::setSecReqEnable
Description
Enable sending SMP security request when BLE connected.
Syntax
void setSecReqEnable(bool secReq);
Parameters
secReq: TRUE to enable, FALSE to disable.
Returns
The function returns nothing.
Example Code
NA
Notes and Warnings
NA
BLESecurity::setSecReqFlags
Description
Set security request requirements.
Syntax
void setSecReqFlags(uint16_t secReqFlags);
Parameters
secReqFlags: desired security requirements. Valid values:
– GAP_AUTHEN_BIT_NONE
– GAP_AUTHEN_BIT_BONDING_FLAG
– GAP_AUTHEN_BIT_MITM_FLAG
– GAP_AUTHEN_BIT_SC_FLAG
– GAP_AUTHEN_BIT_SC_ONLY_FLAG
– GAP_AUTHEN_BIT_FORCE_BONDING_FLAG
Returns
The function returns nothing.
Example Code
NA
Notes and Warnings
If no security requirements are set, the default is set to GAP_AUTHEN_BIT_NONE.
BLESecurity::setStaticPin
Description
Configure device to use static pin input for BLE bonding.
Syntax
void setStaticPin(uint32_t pin);
Parameters
pin: BLE bonding static pin. Valid values are 6 digit integers ranging from 000000 to 999999.
Returns
The function returns nothing.
Example Code
NA
Notes and Warnings
Using a static pin will enable BLE bonding and pairing, set the IO capability to GAP_IO_CAP_DISPLAY_ONLY and set the bonding security requirements flags to GAP_AUTHEN_BIT_BONDING_FLAG | GAP_AUTHEN_BIT_MITM_FLAG | GAP_AUTHEN_BIT_SC_FLAG.
BLESecurity::setPasskeyDisplayCallback
Description
Set a user callback function for passkey display during BLE bonding.
Syntax
void setPasskeyDisplayCallback(void (*fCallback) (uint8_t conn_id, uint32_t passkey));
Parameters
fCallback: A user callback function that returns void and takes two arguments
conn_id: connection ID of connecting device
passkey: bonding passkey to display to user to confirm connection
Returns
The function returns nothing.
Example Code
NA
Notes and Warnings
NA
BLESecurity::setPasskeyInputCallback
Description
Set a user callback function for passkey input during BLE bonding.
Syntax
void setPasskeyInputCallback(uint32_t (*fCallback) (uint8_t conn_id));
Parameters
fCallback: A user callback function that takes no arguments and returns the bonding passkey entered by the user
conn_id: connection ID of connecting device
Returns
The function returns nothing.
Example Code
NA
Notes and Warnings
NA
BLESecurity::setNumericComparisonCallback
Description
Set a user callback function for numeric comparison during BLE bonding.
Syntax
void setNumericComparisonCallback(bool (*fCallback) (uint8_t conn_id, uint32_t passkey));
Parameters
fCallback: A user callback function that takes two arguments and returns a Boolean to indicate user approval for the numeric comparison
conn_id: connection ID of connecting device
passkey: bonding passkey to display to user to confirm connection
Returns
The function returns nothing.
Example Code
NA
Notes and Warnings
NA
