112
SWRU271H – October 2010 – Revised April 2019
Copyright © 2010–2019, Texas Instruments Incorporated
GAPRole Peripheral Role API
Appendix B
SWRU271H – October 2010 – Revised April 2019
GAPRole Peripheral Role API
B.1
Commands
bStatus_t GAPRole_SetParameter(uint16 param, uint8 len, void *pValue)
Set a GAP Role parameter.
Parameters
param – Profile parameter ID (see
len – length of data to write
pValue – pointer to value to set parameter. This pointer depends on the parameter ID
and will be cast to the appropriate data type.
Returns
SUCCESS
INVALIDPARAMETER: param was not valid.
bleInvalidRange: len is not valid for the given param.
blePending: previous param update has not been completed
bleIncorrectMode: cannot start connectable advertising because nonconnectable
advertising is enabled
bStatus_t GAPRole_GetParameter(uint16 param, void *pValue)
Set a GAP Role parameter.
Parameters
param – Profile parameter ID (
pValue – pointer to location to get parameter. This is dependent on the parameter ID
and will be cast to the appropriate data type.
Returns
SUCCESS
INVALIDPARAMETER: param was not valid
bStatus_t GAPRole_StartDevice(gapRolesCBs_t *pAppCallbacks)
Initializes the device as a peripheral and configures the application callback
function.
Parameters
pAppCallbacks – pointer to application callbacks (
Returns
SUCCESS
bleAlreadyInRequestedMode: device was already initialized
bStatus_t GAPRole_TerminateConnection(void)
Terminates an existing connection.
Returns
SUCCESS: connection termination process has started.
bleIncorrectMode: there is no active connection.
LL_STATUS_ERROR_CTRL_PROC_ALREADY_ACTIVE: disconnect is in progress.