Function esp_idf_sys::esp_ble_gap_set_security_param
source ยท pub unsafe extern "C" fn esp_ble_gap_set_security_param(
param_type: esp_ble_sm_param_t,
value: *mut c_void,
len: u8,
) -> esp_err_t
Expand description
@brief Set a GAP security parameter value. Overrides the default value.
Secure connection is highly recommended to avoid some major
vulnerabilities like 'Impersonation in the Pin Pairing Protocol'
(CVE-2020-26555) and 'Authentication of the LE Legacy Pairing
Protocol'.
To accept only `secure connection mode`, it is necessary do as following:
1. Set bit `ESP_LE_AUTH_REQ_SC_ONLY` (`param_type` is
`ESP_BLE_SM_AUTHEN_REQ_MODE`), bit `ESP_LE_AUTH_BOND` and bit
`ESP_LE_AUTH_REQ_MITM` is optional as required.
2. Set to `ESP_BLE_ONLY_ACCEPT_SPECIFIED_AUTH_ENABLE` (`param_type` is
`ESP_BLE_SM_ONLY_ACCEPT_SPECIFIED_SEC_AUTH`).
@param[in] param_type : the type of the param which to be set @param[in] value : the param value @param[in] len : the length of the param value
@return - ESP_OK : success - other : failed