ble_gap_connect
int
ble_gap_connect(
uint8_t own_addr_type,
const ble_addr_t *peer_addr,
int32_t duration_ms,
const struct ble_gap_conn_params *conn_params,
ble_gap_event_fn *cb,
void *cb_arg
)
Description
Initiates a connect procedure.
Parameters
Parameter | Description |
---|
own_addr_type | The type of address the stack should use for itself during connection establishment. BLE_OWN_ADDR_PUBLIC BLE_OWN_ADDR_RANDOM BLE_OWN_ADDR_RPA_PUBLIC_DEFAULT BLE_OWN_ADDR_RPA_RANDOM_DEFAULT |
peer_addr | The address of the peer to connect to. If this parameter is NULL, the white list is used. |
duration_ms | The duration of the discovery procedure. On expiration, the procedure ends and a BLE_GAP_EVENT_DISC_COMPLETE event is reported. Units are milliseconds. |
conn_params | Additional arguments specifying the particulars of the connect procedure. Specify null for default values. |
cb | The callback to associate with this connect procedure. When the connect procedure completes, the result is reported through this callback. If the connect procedure succeeds, the connection inherits this callback as its event-reporting mechanism. |
cb_arg | The optional argument to pass to the callback function. |
Returned values
Value | Condition |
---|
0 | Success. |
BLE_HS_EALREADY | A connection attempt is already in progress. |
BLE_HS_EBUSY | Initiating a connection is not possible because scanning is in progress. |
BLE_HS_EDONE | The specified peer is already connected. |
Core return code | Unexpected error. |