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]

available

disconnect 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_found

Discovered 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_buffer	a list of peers that the device will connect to one of them
[in]	index	index 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_params

parameters 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

)

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.

Parameters

[in]

discover_status

discovery status of each handle

References at_ble_characteristic_discover_all(), at_ble_disconnect(), AT_BLE_FAILURE, AT_BLE_INVALID_PARAM, AT_BLE_INVALID_STATE, AT_BLE_SUCCESS, AT_BLE_TERMINATED_BY_USER, ble_check_iscentral(), gatt_txps_char_handler::char_discovery, gatt_lls_char_handler::char_discovery, gatt_ias_char_handler::char_discovery, gatt_txps_char_handler::char_handle, gatt_lls_char_handler::char_handle, at_ble_cmd_complete_event_t::conn_handle, DBG_LOG, DBG_LOG_DEV, DISCOVER_SUCCESS, gatt_txps_char_handler::end_handle, gatt_lls_char_handler::end_handle, gatt_ias_char_handler::end_handle, LLS_ALERT_LEVEL, lls_alert_level_write(), at_ble_cmd_complete_event_t::operation, gatt_txps_char_handler::start_handle, gatt_lls_char_handler::start_handle, gatt_ias_char_handler::start_handle, at_ble_cmd_complete_event_t::status, and txps_power_read().

at_ble_status_t pxp_monitor_encryption_change_handler

(

void *

params

)

References AT_BLE_FAILURE, AT_BLE_SUCCESS, ble_check_iscentral(), ble_check_ispheripheral(), ble_device_current_state, CENTRAL_SCANNING_STATE, at_ble_encryption_status_changed_t::handle, hw_timer_stop_func_cb, PERIPHERAL_ADVERTISING_STATE, pxp_connect_request_flag, PXP_DEV_CONNECTED, PXP_DEV_UNCONNECTED, pxp_monitor_service_discover(), pxp_monitor_start_scan(), and at_ble_encryption_status_changed_t::status.

void pxp_monitor_init

(

void *

param

)

References BLE_GAP_EVENT_TYPE, BLE_GATT_CLIENT_EVENT_TYPE, ble_mgr_events_callback_handler(), gatt_txps_char_handler::char_data, gatt_lls_char_handler::char_data, gatt_ias_char_handler::char_data, DBG_LOG, ias_char_data, lls_char_data, PXP_HIGH_ALERT_RANGE, PXP_LOW_ALERT_RANGE, REGISTER_CALL_BACK, tx_power_char_data, and UNUSED.

Referenced by main().

at_ble_status_t pxp_monitor_pair_done_handler

(

void *

params

)

References AT_BLE_FAILURE, AT_BLE_SUCCESS, ble_check_iscentral(), ble_check_ispheripheral(), ble_device_current_state, CENTRAL_SCANNING_STATE, at_ble_pair_done_t::handle, hw_timer_stop_func_cb, PERIPHERAL_ADVERTISING_STATE, pxp_connect_request_flag, PXP_DEV_CONNECTED, PXP_DEV_UNCONNECTED, pxp_monitor_service_discover(), pxp_monitor_start_scan(), and at_ble_pair_done_t::status.

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_buffer	where all received advertising packet are stored
[in]	scanned_dev_count	elements 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]

connection

handle.

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().

at_ble_status_t pxp_monitor_service_found_handler

(

void *

params

)

Discover the Proximity services.

Search will go from start_handle to end_handle, whenever a service is found and compare with proximity services and stores the respective handlers PXP_MONITOR_CONNECTED_STATE_HANDLER event i.

Parameters

[in]

at_ble_primary_service_found_t

Primary service parameter

References AT_BLE_FAILURE, AT_BLE_INVALID_PARAM, AT_BLE_SUCCESS, AT_BLE_UUID_16, ble_check_iscentral(), gatt_txps_char_handler::char_discovery, gatt_lls_char_handler::char_discovery, gatt_ias_char_handler::char_discovery, at_ble_primary_service_found_t::conn_handle, DBG_LOG, DBG_LOG_PTS, DISCOVER_SUCCESS, gatt_txps_char_handler::end_handle, gatt_lls_char_handler::end_handle, gatt_ias_char_handler::end_handle, at_ble_primary_service_found_t::end_handle, IMMEDIATE_ALERT_SERVICE_UUID, LINK_LOSS_SERVICE_UUID, at_ble_primary_service_found_t::service_uuid, gatt_txps_char_handler::start_handle, gatt_lls_char_handler::start_handle, gatt_ias_char_handler::start_handle, at_ble_primary_service_found_t::start_handle, TX_POWER_SERVICE_UUID, at_ble_uuid_t::type, and at_ble_uuid_t::uuid.

at_ble_status_t pxp_monitor_start_scan

(

void

)

References AT_BLE_FAILURE, at_ble_scan_stop(), AT_BLE_SUCCESS, ble_event_task(), DBG_LOG, gap_dev_connect(), gap_dev_scan(), getchar_timeout(), hw_timer_start_func_cb, hw_timer_stop_func_cb, NULL, PERIPHERAL_ADVERTISING_STATE, peripheral_state_callback, PXP_CONNECT_REQ_INTERVAL, pxp_connect_request_flag, PXP_DEV_CONNECTING, and SYSTEM_RunTasks().

Referenced by pxp_disconnect_event_handler(), 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]

Callback

for 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]

Callback

for 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

)

References peripheral_state_callback.

void SYSTEM_RunTasks

(

void

)

System tasks execution entry point.

volatile ble_device_ll_state_t ble_device_current_state

Referenced by ble_connected_state_handler(), ble_scan_report_handler(), gap_dev_scan(), pxp_disconnect_event_handler(), pxp_monitor_encryption_change_handler(), and pxp_monitor_pair_done_handler().

hw_timer_start_func_cb_t hw_timer_start_func_cb = NULL

Referenced by pxp_monitor_characteristic_read_response(), pxp_monitor_connect_request(), pxp_monitor_start_scan(), and register_hw_timer_start_func_cb().

hw_timer_stop_func_cb_t hw_timer_stop_func_cb = NULL

Referenced by pxp_monitor_encryption_change_handler(), pxp_monitor_pair_done_handler(), pxp_monitor_start_scan(), and register_hw_timer_stop_func_cb().

uint8_t ias_char_data[MAX_IAS_CHAR_SIZE]

Referenced by pxp_monitor_init().

gatt_ias_char_handler_t ias_handle

Initial value:

=
{0, 0, 0, AT_BLE_INVALID_PARAM, AT_BLE_INVALID_PARAM, NULL}

uint8_t lls_char_data[MAX_LLS_CHAR_SIZE]

Referenced by pxp_monitor_init().

gatt_lls_char_handler_t lls_handle

Initial value:

=
{0, 0, 0, AT_BLE_INVALID_PARAM, NULL}

peripheral_state_cb_t peripheral_state_callback = NULL

Referenced by pxp_monitor_start_scan(), and register_peripheral_state_cb().

volatile uint8_t pxp_connect_request_flag = PXP_DEV_UNCONNECTED

Referenced by pxp_disconnect_event_handler(), pxp_monitor_app_timer_event(), pxp_monitor_connect_request(), pxp_monitor_connected_state_handler(), pxp_monitor_encryption_change_handler(), pxp_monitor_pair_done_handler(), and pxp_monitor_start_scan().

const ble_gap_event_cb_t pxp_gap_handle

static

Initial value:

= {
    .scan_report = pxp_monitor_scan_data_handler,
    .connected = pxp_monitor_connected_state_handler,
    .disconnected = pxp_disconnect_event_handler,
    .pair_done = pxp_monitor_pair_done_handler,
    .encryption_status_changed = pxp_monitor_encryption_change_handler,
}

const ble_gatt_client_event_cb_t pxp_gatt_client_handle

static

Initial value:

= {
    .primary_service_found = pxp_monitor_service_found_handler,
    .characteristic_found = pxp_monitor_characteristic_found_handler,
    .discovery_complete = pxp_monitor_discovery_complete_handler,
    .characteristic_read_by_uuid_response = pxp_monitor_characteristic_read_response
}

at_ble_addr_t pxp_reporter_address

uint8_t pxp_supp_scan_index[MAX_SCAN_DEVICE]

Referenced by pxp_monitor_scan_data_handler().

uint8_t scan_index = 0

Referenced by ble_scan_report_app_event(), and pxp_monitor_scan_data_handler().

at_ble_scan_info_t scan_info[MAX_SCAN_DEVICE]

volatile uint8_t scan_response_count

Referenced by ble_scan_duplication_check(), ble_scan_info_handler(), ble_scan_report_app_event(), gap_dev_scan(), and pxp_monitor_scan_data_handler().

uint8_t tx_power_char_data[MAX_TX_POWER_CHAR_SIZE]

Referenced by pxp_monitor_init().

gatt_txps_char_handler_t txps_handle

Initial value:

=
{0, 0, 0, AT_BLE_INVALID_PARAM, NULL}