115 lines
3.8 KiB
C
115 lines
3.8 KiB
C
/**
|
|
* NOTICE
|
|
*
|
|
* Copyright 2020 Tile Inc. All Rights Reserved.
|
|
* All code or other information included in the accompanying files ("Tile Source Material")
|
|
* is PROPRIETARY information of Tile Inc. ("Tile") and access and use of the Tile Source Material
|
|
* is subject to these terms. The Tile Source Material may only be used for demonstration purposes,
|
|
* and may not be otherwise distributed or made available to others, including for commercial purposes.
|
|
* Without limiting the foregoing , you understand and agree that no production use
|
|
* of the Tile Source Material is allowed without a Tile ID properly obtained under a separate
|
|
* agreement with Tile.
|
|
* You also understand and agree that Tile may terminate the limited rights granted under these terms
|
|
* at any time in its discretion.
|
|
* All Tile Source Material is provided AS-IS without warranty of any kind.
|
|
* Tile does not warrant that the Tile Source Material will be error-free or fit for your purposes.
|
|
* Tile will not be liable for any damages resulting from your use of or inability to use
|
|
* the Tile Source Material.
|
|
*
|
|
* Support: firmware_support@tile.com
|
|
*/
|
|
|
|
/** @file tile_gap_driver.h
|
|
** @brief Tile GAP Driver interface. Provides TileLib Control over GAP functions, like connection,
|
|
** disconnection and connection parameters.
|
|
*/
|
|
|
|
#ifndef TILE_GAP_DRIVER_H_
|
|
#define TILE_GAP_DRIVER_H_
|
|
|
|
#include <stdint.h>
|
|
|
|
#define TILE_SERVICE_DATA_VERSION_0 0
|
|
#define TILE_SERVICE_DATA_VERSION_2 2
|
|
|
|
|
|
|
|
/**
|
|
* Connection parameters.
|
|
*/
|
|
struct tile_conn_params
|
|
{
|
|
uint16_t conn_interval;
|
|
uint16_t slave_latency;
|
|
uint16_t conn_sup_timeout;
|
|
};
|
|
|
|
|
|
struct tile_gap_driver
|
|
{
|
|
/**
|
|
* Time in 10ms increments before Tile disconnects if no client has
|
|
* authenticated. A value of 0 indicates that this feature is disabled.
|
|
* The value may be updated at any time, but will not clear a timer which
|
|
* is already running. The value is used after a connection is established.
|
|
*/
|
|
uint16_t authentication_timer_delay;
|
|
|
|
/**
|
|
* Memory space for current connection parameters.
|
|
*/
|
|
struct tile_conn_params conn_params;
|
|
|
|
/**
|
|
* Diagnostic info: counts the number of disconnections triggered by Auth Timer.
|
|
*/
|
|
uint16_t* auth_disconnect_count;
|
|
|
|
/**
|
|
* Disconnect from the currently connected device.
|
|
*
|
|
* @return See @ref TILE_ERROR_CODES.
|
|
*/
|
|
int (*gap_disconnect)(void);
|
|
};
|
|
|
|
|
|
/**
|
|
* Register the GAP driver with Tile Library.
|
|
*/
|
|
int tile_gap_register(struct tile_gap_driver *driver);
|
|
|
|
|
|
/**
|
|
* Call when a connection has been established.
|
|
*/
|
|
int tile_gap_connected(struct tile_conn_params *conn_params);
|
|
|
|
/**
|
|
* Call when a connection has been terminated.
|
|
*/
|
|
int tile_gap_disconnected(void);
|
|
|
|
/**
|
|
* Call when the connection parameters have been updated. This function will
|
|
* update the values contained in the driver structure.
|
|
*/
|
|
int tile_gap_params_updated(struct tile_conn_params *conn_params);
|
|
|
|
/***************************************************************************************
|
|
* @brief Get the advertising parameters to use from TileLib.
|
|
*
|
|
* @param[out] adv_interval pointer to write the Advertising Interval.
|
|
* @param[out] tile_service_uuid pointer to write the Service UUID to put in the list of 16-bit UUIDs and Service Data.
|
|
* @param[out] tile_service_data_length pointer to write the Service Data length.
|
|
* @param[out] tile_service_data pointer to write the Service Data. The required minimum available buffer size is TILE_SERVICE_DATA_MAX_LENGTH.
|
|
* @param[out] manuf pointer to indicate whether munufacturing data is available.
|
|
*
|
|
* @return See @ref TILE_ERROR_CODES.
|
|
*
|
|
****************************************************************************************
|
|
*/
|
|
int tile_gap_get_adv_params(uint16_t* adv_interval, uint16_t* tile_service_uuid, uint8_t* tile_service_data_length, uint8_t* tile_service_data, uint8_t* manuf);
|
|
|
|
#endif
|