1.1.2.1.1.4.3 BLE_GAP_ConfigureBuildInService
C
uint16_t BLE_GAP_ConfigureBuildInService(BLE_GAP_ServiceOption_T *p_serviceOptions);
Description
Configure the build-in Generic Access services. Optional characteristics and characteristic value can be configured in mandatory "Generic Access Service".
Note
The function is suggested to be called when initialization. Also, it can't be called in connected state. The configured option (enable/disable) should not be changed if the function is called. Otherwise, service change situation need to be considered in the multiple configuring build-in services case.
Events generated
BLE_GAP_EVT_DEVICE_NAME_CHANGED Generated when device name characteristic is configured as writable and is written by remote connected peer.
Parameters
Parameter | Description |
---|---|
[in] p_serviceOptions | Pointer to the BLE_GAP_ServiceOption_T structure buffer. |
Return values
Return value | Description |
---|---|
MBA_RES_SUCCESS | Successfully configure the build-in Services. |
MBA_RES_OOM | Internal memory allocation failure. |