UM1770 Datasheet, PDF (38/56 Pages) STMicroelectronics – BlueNRG profile application interface

Profile – application interface functions
UM1770
6.7
6.7.1
6.7.2
6.7.3
6.7.4
6.7.5
Phone alert profile
PAC_Init()
Description
Initializes the Phone Alert Status profile for client role and registers the Phone Alert Profile
with the main profile. It returns BLE_STATUS_SUCCESS if the procedure is successfully
started. The application is notified through the event EVT_PAC_INITIALIZED on successful
initialization.
Parameters
1. BLE_CALLBACK_FUNCTION_TYPE – callback function to be called by the profile to
notify the application of the events.
PAC_Add_Device_To_WhiteList()
Description
The application calls this function to add the devices to whitelist.
Parameters
1. bdAddr – the address of the peer device that must be added to the whitelist.
PAC_Advertize()
Description
The application calls this function to put the device into discoverable mode.
PAC_Configure_Ringer()
Description
The application calls this to write the ringer mode to the phone alert server. It returns
BLE_STATUS_SUCCESS if the parameters are valid and the procedure has been started
successfully, otherwise it returns error codes.
Parameters
1. ringerMode – the ringer mode to be set. The valid ringer modes are:
– SILENT_MODE (0x01)
– MUTE_ONCE (0x02)
– CANCEL_SILENT_MODE (0x03)
PAC_Read_AlertStatus()
Description
When this function is called by the application, the profile starts a GATT procedure to read
the characteristic value. The value read is returned via the event
EVT_PAC_ALERT_STATUS to the application through the callback.
38/56
DocID026385 Rev 2