mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-09-18 12:31:56 +00:00
b210d53172
Calling bt_conn_set_auto_conn one can decide if auto connect shall be used. If so, everytime the connection is lost, passive scanning will be enabled to listen for connectable advertisements from remote device and re-establish the connection. Auto connect can be disabled if one decide to disconnect from this device using bt_disconnect or call bt_conn_set_auto_conn with auto_conn flag set to false. Change-Id: Ic9952e313cb8612ea6c72838be0755805daeffcf Signed-off-by: Mariusz Skamra <mariusz.skamra@tieto.com>
113 lines
3.7 KiB
C
113 lines
3.7 KiB
C
/** @file
|
|
* @brief Bluetooth connection handling
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 2015 Intel Corporation
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1) Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2) Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3) Neither the name of Intel Corporation nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
#ifndef __BT_CONN_H
|
|
#define __BT_CONN_H
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <bluetooth/hci.h>
|
|
|
|
/** Opaque type representing a connection to a remote device */
|
|
struct bt_conn;
|
|
|
|
/** @brief Increment a connection's reference count.
|
|
*
|
|
* Increment the reference count of a connection object.
|
|
*
|
|
* @param conn Connection object.
|
|
*
|
|
* @return Connection object with incremented reference count.
|
|
*/
|
|
struct bt_conn *bt_conn_get(struct bt_conn *conn);
|
|
|
|
/** @brief Decrement a connection's reference count.
|
|
*
|
|
* Decrement the reference count of a connection object.
|
|
*
|
|
* @param conn Connection object.
|
|
*/
|
|
void bt_conn_put(struct bt_conn *conn);
|
|
|
|
/** @brief Look up an existing connection by address.
|
|
*
|
|
* Look up an existing connection based on the remote address.
|
|
*
|
|
* @param peer Remote address.
|
|
*
|
|
* @return Connection object or NULL if not found. The caller gets a
|
|
* new reference to the connection object which must be released with
|
|
* bt_conn_put() once done using the object.
|
|
*/
|
|
struct bt_conn *bt_conn_lookup_addr_le(const bt_addr_le_t *peer);
|
|
|
|
/** @brief Get destination (peer) address of a connection.
|
|
*
|
|
* @param conn Connection object.
|
|
*
|
|
* @return Destination address.
|
|
*/
|
|
const bt_addr_le_t *bt_conn_get_dst(const struct bt_conn *conn);
|
|
|
|
/** Connection callback structure */
|
|
struct bt_conn_cb {
|
|
void (*connected)(struct bt_conn *conn);
|
|
void (*disconnected)(struct bt_conn *conn);
|
|
|
|
struct bt_conn_cb *_next;
|
|
};
|
|
|
|
/** @brief Register connection callbacks.
|
|
*
|
|
* Register callbacks to monitor the state of connections.
|
|
*
|
|
* @param cb Callback struct.
|
|
*/
|
|
void bt_conn_cb_register(struct bt_conn_cb *cb);
|
|
|
|
/** @brief Automatically connect to remote device if it's in range.
|
|
*
|
|
* This function enables/disables automatic connection initiation.
|
|
* Everytime the device looses the connection with peer, this connection
|
|
* will be re-established if connectable advertisement from peer is received.
|
|
*
|
|
* @param conn Existing connection object.
|
|
* @param auto_conn boolean value. If true, auto connect is enabled,
|
|
* if false, auto connect is disabled.
|
|
*
|
|
* @return none
|
|
*/
|
|
void bt_conn_set_auto_conn(struct bt_conn *conn, bool auto_conn);
|
|
|
|
#endif /* __BT_CONN_H */
|