BLE_GAP_SetAdvEnable
C
uint16_t BLE_GAP_SetAdvEnable(bool enable, uint16_t duration);
Description
Starts or stop advertising.
Note
The duration parameter is only applicable when the advertising type is not set to Directed Advertising. Advertising will continue for the specified duration, until stopped by a command, until a connection is established, or until it times out due to high duty cycle Directed Advertising. This API is part of the legacy advertising feature and will be disallowed if any extended advertising feature API has been used. See Categories of advertising APIs and events for details on advertising APIs. The BLE_GAP_AdvInit function must be called prior to using this API. The BLE_GAP_SetAdvParams function should be called before this API to set the advertising parameters. The BLE_GAP_SetAdvData or BLE_GAP_SetScanRspData function should be called before this API to set the advertising or scan response data.
Events generated
BLE_GAP_EVT_CONNECTED is generated when a connection is established.
BLE_GAP_EVT_ADV_TIMEOUT is generated when advertising times out.
Parameters
Parameter | Description |
---|---|
[in] enable | Control flag to start or stop advertising. |
[in] duration | Duration for advertising in 10 ms units. Set to 0 for continuous advertising. |
* |
Return values
Return value | Description |
---|---|
MBA_RES_SUCCESS | Successfully starts or stops advertising. |
MBA_RES_OOM | Internal memory allocation failure occurred. |
MBA_RES_INVALID_PARA | The parameters provided are invalid. |
MBA_RES_COMMAND_DISALLOWED | Command disallowed when extended advertising feature is in use. |