Microchip® Advanced Software Framework

pxp_monitor.c File Reference

Proximity Monitor Profile.

Copyright (c) 2017-2019 Microchip Technology Inc. and its subsidiaries.

#include <asf.h>
#include "platform.h"
#include "pxp_monitor.h"
#include "tx_power.h"
#include "link_loss.h"
#include "immediate_alert.h"

Functions

at_ble_status_t pxp_disconnect_event_handler (void *params)
 peer device connection terminated More...
 
at_ble_status_t pxp_monitor_characteristic_found_handler (void *params)
 Handles all Discovered characteristics of a given handler in a connected device. More...
 
at_ble_status_t pxp_monitor_characteristic_read_response (void *params)
 Handles the read response from the peer/connected device. More...
 
at_ble_status_t pxp_monitor_connect_request (at_ble_scan_info_t *scan_buffer, uint8_t index)
 Connect to a peer device. More...
 
at_ble_status_t pxp_monitor_connected_state_handler (void *params)
 Connected event state handle after connection request to peer device. More...
 
at_ble_status_t pxp_monitor_discovery_complete_handler (void *params)
 Discover all Characteristics supported for Proximity Service of a connected device and handles discovery complete Search will go from start_handle to end_handle, whenever a characteristic is found After search and discovery completes will initialize the alert level and read the tx power value as defined AT_BLE_CHARACTERISTIC_FOUND event is sent and AT_BLE_DISCOVERY_COMPLETE is sent at end of discover operation. More...
 
at_ble_status_t pxp_monitor_encryption_change_handler (void *params)
 
void pxp_monitor_init (void *param)
 
at_ble_status_t pxp_monitor_pair_done_handler (void *params)
 
at_ble_status_t pxp_monitor_scan_data_handler (void *params)
 Search for a given AD type in a buffer, received from advertising packets starts search from the buffer, need to provide required search params. More...
 
at_ble_status_t pxp_monitor_service_discover (at_ble_handle_t handle)
 Discover all services. More...
 
at_ble_status_t pxp_monitor_service_found_handler (void *params)
 Discover the Proximity services. More...
 
at_ble_status_t pxp_monitor_start_scan (void)
 
void register_hw_timer_start_func_cb (hw_timer_start_func_cb_t timer_start_fn)
 Registers callback for hardware timer start. More...
 
void register_hw_timer_stop_func_cb (hw_timer_stop_func_cb_t timer_stop_fn)
 Registers callback for hardware timer stop. More...
 
void register_peripheral_state_cb (peripheral_state_cb_t peripheral_state_cb)
 
void SYSTEM_RunTasks (void)
 System tasks execution entry point. More...
 

Variables

volatile ble_device_ll_state_t ble_device_current_state
 
hw_timer_start_func_cb_t hw_timer_start_func_cb = NULL
 
hw_timer_stop_func_cb_t hw_timer_stop_func_cb = NULL
 
uint8_t ias_char_data [MAX_IAS_CHAR_SIZE]
 
gatt_ias_char_handler_t ias_handle
 
uint8_t lls_char_data [MAX_LLS_CHAR_SIZE]
 
gatt_lls_char_handler_t lls_handle
 
peripheral_state_cb_t peripheral_state_callback = NULL
 
volatile uint8_t pxp_connect_request_flag = PXP_DEV_UNCONNECTED
 
static const ble_gap_event_cb_t pxp_gap_handle
 
static const
ble_gatt_client_event_cb_t 
pxp_gatt_client_handle
 
at_ble_addr_t pxp_reporter_address
 
uint8_t pxp_supp_scan_index [MAX_SCAN_DEVICE]
 
uint8_t scan_index = 0
 
at_ble_scan_info_t scan_info [MAX_SCAN_DEVICE]
 
volatile uint8_t scan_response_count
 
uint8_t tx_power_char_data [MAX_TX_POWER_CHAR_SIZE]
 
gatt_txps_char_handler_t txps_handle
 

at_ble_status_t pxp_disconnect_event_handler ( void *  params)

peer device connection terminated

handler for disconnect notification try to send connect request for previously connect device.

Parameters
[in]availabledisconnect handler of peer and reason for disconnection
Returns
AT_BLE_SUCCESS Reconnect request sent to previously connected device
AT_BLE_FAILURE Reconnection fails.

References AT_BLE_FAILURE, ble_check_disconnected_iscentral(), ble_device_current_state, CENTRAL_SCANNING_STATE, at_ble_disconnected_t::handle, PERIPHERAL_ADVERTISING_STATE, pxp_connect_request_flag, PXP_DEV_UNCONNECTED, and pxp_monitor_start_scan().

at_ble_status_t pxp_monitor_characteristic_found_handler ( void *  params)

Handles all Discovered characteristics of a given handler in a connected device.

Compare the characteristics UUID with proximity services whenever a characteristics is found if compare stores the characteristics handler of respective service

Parameters
[in]characteristic_foundDiscovered characteristics params of a connected device

References ALERT_LEVEL_CHAR_UUID, AT_BLE_FAILURE, AT_BLE_SUCCESS, ble_check_iscentral(), gatt_txps_char_handler::char_handle, gatt_lls_char_handler::char_handle, gatt_ias_char_handler::char_handle, at_ble_characteristic_found_t::char_handle, at_ble_characteristic_found_t::char_uuid, at_ble_characteristic_found_t::conn_handle, DBG_LOG_PTS, gatt_lls_char_handler::end_handle, at_ble_characteristic_found_t::properties, gatt_lls_char_handler::start_handle, TX_POWER_LEVEL_CHAR_UUID, at_ble_uuid_t::uuid, and at_ble_characteristic_found_t::value_handle.

at_ble_status_t pxp_monitor_characteristic_read_response ( void *  params)

Handles the read response from the peer/connected device.

if any read request send, response back event is handle. compare the read response characteristics with available service. and data is handle to the respective service.

References AT_BLE_FAILURE, AT_BLE_SUCCESS, ble_check_iscentral(), at_ble_characteristic_read_response_t::conn_handle, DBG_LOG_DEV, hw_timer_start_func_cb, lls_alert_read_response(), PXP_RSSI_UPDATE_INTERVAL, and txps_power_read_response().

at_ble_status_t pxp_monitor_connect_request ( at_ble_scan_info_t scan_buffer,
uint8_t  index 
)

Connect to a peer device.

Connecting to a peer device, implicitly starting the necessary scan operation then connecting if a device in the peers list is found.

Parameters
[in]scan_buffera list of peers that the device will connect to one of them
[in]indexindex of elements in peers, to initiate the connection
Returns
AT_BLE_SUCCESS operation programmed successfully
AT_BLE_INVALID_PARAM incorrect parameter.
AT_BLE_FAILURE Generic error.

References AT_BLE_FAILURE, AT_BLE_SUCCESS, DBG_LOG, gap_dev_connect(), hw_timer_start_func_cb, PXP_CONNECT_REQ_INTERVAL, pxp_connect_request_flag, and PXP_DEV_CONNECTING.

Referenced by pxp_monitor_scan_data_handler().

at_ble_status_t pxp_monitor_connected_state_handler ( void *  params)

Connected event state handle after connection request to peer device.

After connecting to the peer device start the GATT primary discovery

Parameters
[in]conn_paramsparameters of the established connection
Returns
AT_BLE_SUCCESS operation successfully.
AT_BLE_INVALID_PARAM if GATT discovery parameter are incorrect parameter.
AT_BLE_FAILURE Generic error.

References ble_check_iscentral(), at_ble_connected_t::conn_status, at_ble_connected_t::handle, pxp_connect_request_flag, and PXP_DEV_CONNECTED.

at_ble_status_t pxp_monitor_discovery_complete_handler ( void *  params)
at_ble_status_t pxp_monitor_scan_data_handler ( void *  params)

Search for a given AD type in a buffer, received from advertising packets starts search from the buffer, need to provide required search params.

Search for a given AD type in a buffer, received from advertising packets.

Parameters
[in]scan_bufferwhere all received advertising packet are stored
[in]scanned_dev_countelements in scan_buffer
Returns
AT_BLE_SUCCESS operation programmed successfully
AT_BLE_INVALID_PARAM incorrect parameter.
AT_BLE_FAILURE Generic error.

References AD_TYPE_COMPLETE_LIST_UUID, at_ble_addr_t::addr, ALL_UNUSED, AT_BLE_ADV_TYPE_DIRECTED, AT_BLE_ADV_TYPE_UNDIRECTED, AT_BLE_FAILURE, at_ble_scan_stop(), AT_BLE_SUCCESS, AT_BLE_UUID_16, DBG_LOG, DBG_LOG_CONT, at_ble_scan_info_t::dev_addr, gap_dev_scan(), LINK_LOSS_SERVICE_UUID, MAX_SCAN_DEVICE, PXP_ASCII_TO_DECIMAL_VALUE, pxp_monitor_connect_request(), pxp_supp_scan_index, scan_index, scan_info_parse(), scan_response_count, at_ble_uuid_t::type, and at_ble_uuid_t::uuid.

at_ble_status_t pxp_monitor_service_discover ( at_ble_handle_t  handle)

Discover all services.

Parameters
[in]connectionhandle.
Returns
AT_BLE_SUCCESS operation programmed successfully.
AT_BLE_INVALID_PARAM incorrect parameter.
AT_BLE_FAILURE Generic error.

References at_ble_primary_service_discover_all(), AT_BLE_SUCCESS, DBG_LOG, DBG_LOG_DEV, GATT_DISCOVERY_ENDING_HANDLE, and GATT_DISCOVERY_STARTING_HANDLE.

Referenced by pxp_monitor_app_button_event(), pxp_monitor_encryption_change_handler(), and pxp_monitor_pair_done_handler().

void register_hw_timer_start_func_cb ( hw_timer_start_func_cb_t  timer_start_fn)

Registers callback for hardware timer start.

Parameters
[in]Callbackfor hardware timer start function.
Returns
none.

References hw_timer_start_func_cb.

Referenced by main().

void register_hw_timer_stop_func_cb ( hw_timer_stop_func_cb_t  timer_stop_fn)

Registers callback for hardware timer stop.

Parameters
[in]Callbackfor hardware timer stop function.
Returns
none.

References hw_timer_stop_func_cb.

Referenced by main().

void register_peripheral_state_cb ( peripheral_state_cb_t  peripheral_state_cb)
void SYSTEM_RunTasks ( void  )

System tasks execution entry point.

uint8_t ias_char_data[MAX_IAS_CHAR_SIZE]

Referenced by pxp_monitor_init().

Initial value:
=
Invalid input argument to function.
Definition: at_ble_errno.h:364
#define NULL
Definition: nm_bsp.h:64
uint8_t lls_char_data[MAX_LLS_CHAR_SIZE]

Referenced by pxp_monitor_init().

Initial value:
=
Invalid input argument to function.
Definition: at_ble_errno.h:364
#define NULL
Definition: nm_bsp.h:64
peripheral_state_cb_t peripheral_state_callback = NULL
const ble_gap_event_cb_t pxp_gap_handle
static
Initial value:
= {
.encryption_status_changed = pxp_monitor_encryption_change_handler,
}
at_ble_status_t pxp_monitor_pair_done_handler(void *params)
Definition: pxp_monitor.c:376
at_ble_status_t pxp_monitor_scan_data_handler(void *params)
Search for a given AD type in a buffer, received from advertising packets starts search from the buff...
Definition: pxp_monitor.c:174
at_ble_status_t pxp_disconnect_event_handler(void *params)
peer device connection terminated
Definition: pxp_monitor.c:336
at_ble_status_t pxp_monitor_connected_state_handler(void *params)
Connected event state handle after connection request to peer device.
Definition: pxp_monitor.c:447
at_ble_status_t pxp_monitor_encryption_change_handler(void *params)
Definition: pxp_monitor.c:407
const ble_gatt_client_event_cb_t pxp_gatt_client_handle
static
Initial value:
= {
.primary_service_found = pxp_monitor_service_found_handler,
.characteristic_read_by_uuid_response = pxp_monitor_characteristic_read_response
}
at_ble_status_t pxp_monitor_characteristic_found_handler(void *params)
Handles all Discovered characteristics of a given handler in a connected device.
Definition: pxp_monitor.c:708
at_ble_status_t pxp_monitor_characteristic_read_response(void *params)
Handles the read response from the peer/connected device.
Definition: pxp_monitor.c:675
at_ble_status_t pxp_monitor_discovery_complete_handler(void *params)
Discover all Characteristics supported for Proximity Service of a connected device and handles discov...
Definition: pxp_monitor.c:556
at_ble_status_t pxp_monitor_service_found_handler(void *params)
Discover the Proximity services.
Definition: pxp_monitor.c:471
at_ble_addr_t pxp_reporter_address
uint8_t pxp_supp_scan_index[MAX_SCAN_DEVICE]
uint8_t scan_index = 0
uint8_t tx_power_char_data[MAX_TX_POWER_CHAR_SIZE]

Referenced by pxp_monitor_init().

Initial value:
=
Invalid input argument to function.
Definition: at_ble_errno.h:364
#define NULL
Definition: nm_bsp.h:64