Lines Matching full:connection
2 * @brief Bluetooth connection handling
14 * @brief Connection management
15 * @defgroup bt_conn Connection management
34 /** Opaque type representing a connection to a remote device */
37 /** Connection parameters for LE connections */
45 /** @brief Initialize connection parameters
47 * @param int_min Minimum Connection Interval (N * 1.25 ms)
48 * @param int_max Maximum Connection Interval (N * 1.25 ms)
49 * @param lat Connection Latency
60 /** Helper to declare connection parameters inline
62 * @param int_min Minimum Connection Interval (N * 1.25 ms)
63 * @param int_max Maximum Connection Interval (N * 1.25 ms)
64 * @param lat Connection Latency
72 /** Default LE connection parameters:
73 * Connection Interval: 30-50 ms
81 /** Connection PHY information for LE connections */
83 uint8_t tx_phy; /** Connection transmit PHY */
84 uint8_t rx_phy; /** Connection receive PHY */
87 /** Connection PHY options */
101 uint16_t options; /**< Connection PHY options. */
148 /** Connection data length information for LE connections */
160 /** Connection data length parameters for LE connections */
199 /** Connection subrating parameters for LE connections */
205 /** Maximum Peripheral latency in units of subrated connection intervals. */
207 /** Minimum number of underlying connection events to remain active
212 /** Connection Supervision timeout (N * 10 ms).
221 /** Connection subrate factor. */
223 /** Number of underlying connection events to remain active after
230 /** Updated subrating connection parameters for LE connections */
237 /** Connection subrate factor. */
239 /** Number of underlying connection events to remain active after
244 /** Peripheral latency in units of subrated connection intervals. */
246 /** Connection Supervision timeout (N * 10 ms). */
250 /** Connection Type */
252 /** LE Connection Type */
254 /** BR/EDR Connection Type */
256 /** SCO Connection Type */
258 /** ISO Connection Type */
260 /** All Connection Type */
589 /** Starting ACL connection event counter.
666 /** @brief Increment a connection's reference count.
668 * Increment the reference count of a connection object.
672 * @param conn Connection object.
674 * @return Connection object with incremented reference count, or NULL if the
679 /** @brief Decrement a connection's reference count.
681 * Decrement the reference count of a connection object.
683 * @param conn Connection object.
699 * @param type Connection Type
700 * @param func Function to call for each connection.
707 /** @brief Look up an existing connection by address.
709 * Look up an existing connection based on the remote address.
711 * The caller gets a new reference to the connection object which must be
717 * @return Connection object or NULL if not found.
721 /** @brief Get destination (peer) address of a connection.
723 * @param conn Connection object.
729 /** @brief Get array index of a connection
734 * @param conn Connection object.
736 * @return Index of the connection object.
741 /** LE Connection Info Structure */
749 /** Local device address used during connection setup. */
751 /** Remote device address used during connection setup. */
753 uint16_t interval; /**< Connection interval */
754 uint16_t latency; /**< Connection peripheral latency */
755 uint16_t timeout; /**< Connection supervision timeout */
762 /* Connection maximum single fragment parameters */
767 /* Connection subrating parameters */
772 /** @brief Convert connection interval to milliseconds
781 /** @brief Convert connection interval to microseconds
787 /** BR/EDR Connection Info Structure */
844 /** Connection Info Structure */
846 /** Connection Type. */
848 /** Connection Role. */
850 /** Which local identity the connection was created with */
852 /** Connection Type specific Info.*/
854 /** LE Connection specific Info. */
856 /** BR/EDR Connection specific Info. */
859 /** Connection state. */
865 /** LE Connection Remote Info Structure */
872 /** BR/EDR Connection Remote Info structure */
882 /** @brief Connection Remote Info Structure
888 /** Connection Type */
901 /** LE connection remote info */
904 /** BR/EDR connection remote info */
1016 /** Minimum time in number of connection events to be observed once the
1035 /** @brief Get connection info
1037 * @param conn Connection object.
1038 * @param info Connection info object.
1044 /** @brief Get connection info for the remote device.
1046 * @param conn Connection object.
1047 * @param remote_info Connection remote info object.
1052 * @note The remote information is exchanged directly after the connection has
1062 /** @brief Get connection transmit power level.
1064 * @param conn Connection object.
1073 /** @brief Get local enhanced connection transmit power level.
1075 * @param conn Connection object.
1086 * @param conn Connection object.
1097 * @param conn Connection object.
1114 * @param conn Connection object.
1129 * @param conn Connection Object.
1136 /** @brief Set Default Connection Subrating Parameters.
1140 * This command does not affect any existing connection.
1141 * Parameters set for specific connection will always have precedence.
1154 * Request a change to the subrating parameters of a connection.
1158 * @param conn Connection object.
1166 /** @brief Update the connection parameters.
1168 * If the local device is in the peripheral role then updating the connection
1172 * @param conn Connection object.
1173 * @param param Updated connection parameters.
1180 /** @brief Update the connection transmit data length parameters.
1182 * @param conn Connection object.
1190 /** @brief Update the connection PHY parameters.
1192 * Update the preferred transmit and receive PHYs of the connection.
1195 * @param conn Connection object.
1196 * @param param Updated connection parameters.
1203 /** @brief Disconnect from a remote device or cancel pending connection.
1205 * Disconnect an active connection with the specified reason code or cancel
1206 * pending outgoing connection.
1220 * @param conn Connection to disconnect.
1248 /** Bit-field of create connection options. */
1256 * for scanning and connection establishment to be equal to
1266 * for scanning and connection establishment to be equal to
1283 /** @brief Connection initiation timeout (N * 10 MS)
1293 /** @brief Initialize create connection parameters
1295 * @param _options Create connection options.
1296 * @param _interval Create connection scan interval (N * 0.625 ms).
1297 * @param _window Create connection scan window (N * 0.625 ms).
1309 /** Helper to declare create connection parameters inline
1311 * @param _options Create connection options.
1312 * @param _interval Create connection scan interval (N * 0.625 ms).
1313 * @param _window Create connection scan window (N * 0.625 ms).
1320 /** Default LE create connection parameters.
1328 /** Default LE create connection using filter accept list parameters.
1337 /** @brief Initiate an LE connection to a remote device.
1341 * The caller gets a new reference to the connection object which must be
1346 * This uses the General Connection Establishment procedure.
1349 * a new LE connection if @kconfig{CONFIG_BT_SCAN_AND_INITIATE_IN_PARALLEL}
1353 * @param[in] create_param Create connection parameters.
1354 * @param[in] conn_param Initial connection parameters.
1355 * @param[out] conn Valid connection object on success.
1373 /** The subevent where the connection will be initiated. */
1377 /** @brief Create a connection to a synced device
1379 * Initiate a connection to a synced device from a Periodic Advertising
1382 * The caller gets a new reference to the connection object which must be
1387 * This uses the Periodic Advertising Connection Procedure.
1390 * @param[in] synced_param Create connection parameters.
1391 * @param[in] conn_param Initial connection parameters.
1392 * @param[out] conn Valid connection object on success.
1402 * This uses the Auto Connection Establishment procedure.
1403 * The procedure will continue until a single connection is established or the
1407 * new connection has been established.
1409 * @param create_param Create connection parameters
1410 * @param conn_param Initial connection parameters.
1413 * @return -ENOMEM No free connection object available.
1426 * This function enables/disables automatic connection initiation.
1427 * Every time the device loses the connection with peer, this connection
1441 /** @brief Set security level for a connection.
1443 * This function enable security (encryption) for a connection. If the device
1445 * will be enabled. If the connection is already encrypted with sufficiently
1472 * @param conn Connection object.
1479 /** @brief Get security level for a connection.
1481 * @return Connection security level
1490 * @param conn Existing connection object.
1587 /* Number of CS subevents anchored off the same ACL connection event (0x01 to 0x20) */
1590 /* Time between consecutive CS subevents anchored off the same ACL connection event in
1595 /* Number of ACL connection events between consecutive CS event anchor points */
1598 /* Number of ACL connection events between consecutive CS procedure anchor points */
1608 /** @brief Connection callback structure.
1610 * This structure is used for tracking the state of a connection.
1614 * tracking the connection state. If a callback is not of interest for
1619 /** @brief A new connection has been established.
1621 * This callback notifies the application of a new connection.
1623 * connection establishment failed.
1625 * @note If the connection was established from an advertising set then
1630 * @param conn New connection object.
1634 * - @ref BT_HCI_ERR_UNKNOWN_CONN_ID Creating the connection started by
1645 /** @brief A connection has been disconnected.
1647 * This callback notifies the application that a connection
1651 * the connection object. If the application in this callback tries to
1652 * start either a connectable advertiser or create a new connection
1653 * this might fail because there are no free connection objects
1656 * advertise or create a new connection using @ref k_work_submit or
1659 * @param conn Connection object.
1664 /** @brief A connection object has been returned to the pool.
1667 * allocate a connection object. No guarantee, first come, first serve.
1678 /** @brief LE connection parameter update request.
1681 * is requesting to update the connection parameters. The
1697 * @param conn Connection object.
1698 * @param param Proposed connection parameters.
1705 /** @brief The parameters for an LE connection have been updated.
1707 * This callback notifies the application that the connection
1708 * parameters for an LE connection have been updated.
1710 * @param conn Connection object.
1711 * @param interval Connection interval.
1712 * @param latency Connection latency.
1713 * @param timeout Connection supervision timeout.
1723 * @param conn Connection object.
1732 /** @brief The security level of a connection has changed.
1735 * connection has changed.
1737 * The security level of the connection can either have been increased
1740 * a previous connection has been applied. If the security level
1742 * refreshed for the connection.
1744 * @param conn Connection object.
1745 * @param level New security level of the connection.
1758 * @param conn Connection object.
1759 * @param remote_info Connection information of remote device.
1766 /** @brief The PHY of the connection has changed.
1769 * connection has changed.
1771 * @param conn Connection object.
1772 * @param info Connection LE PHY information.
1779 /** @brief The data length parameters of the connection has changed.
1784 * @param conn Connection object.
1785 * @param info Connection data length information.
1795 * @param conn The connection object.
1811 * @param conn Connection object.
1825 * @param conn Connection object.
1836 * of the connection may have changed.
1837 * The connection subrating parameters will be unchanged
1840 * @param conn Connection object.
1853 * @param conn Connection object.
1864 * @param conn Connection object.
1875 * @param conn Connection object.
1885 * @param conn Connection object.
1893 * available for the given connection object.
1895 * @param conn Connection objects.
1906 * @param conn Connection object.
1915 * @param conn Connection object.
1927 /** @brief Register connection callbacks.
1939 * @brief Unregister connection callbacks.
1952 * @brief Register a callback structure for connection events.
2001 /** @brief Set/clear the bonding flag for a given connection.
2004 * SMP Pairing Request/Response data for a given connection.
2006 * The bonding flag for a given connection cannot be set/cleared if
2008 * This function can be called only once per connection.
2010 * If the bonding flag is not set/cleared for a given connection,
2016 * @param conn Connection object.
2043 * @param conn Connection object
2061 * @param conn Connection object
2077 * @note The OOB data will only be available as long as the connection object
2080 * @param conn Connection object
2204 * @param conn Connection where pairing is initiated.
2226 * @param conn Connection where pairing is currently active.
2250 * @param conn The related connection.
2273 * @param conn Connection where pairing is currently active.
2295 * @param conn Connection where pairing is currently active.
2313 * @param conn Connection where pairing is currently active.
2329 * @param conn Connection where pairing is currently active.
2349 * @param conn Connection where pairing is currently active.
2357 * connection where pairing is being performed. Once called the
2369 * @param conn Connection where pairing is currently active.
2383 * @param conn Connection object.
2391 * @param conn Connection object.
2422 /** @brief Overlay authentication callbacks used for a given connection.
2427 * The authentication callbacks for a given connection cannot be overlaid if
2429 * can be called only once per connection.
2431 * @param conn Connection object.
2464 * @param conn Connection object.
2492 * @param conn Connection object.
2503 * @param conn Connection object.
2514 * @param conn Connection object.
2525 * @param conn Connection object.
2532 /** Connection parameters for BR/EDR connections */
2537 /** @brief Initialize BR/EDR connection parameters
2546 /** Helper to declare BR/EDR connection parameters inline
2555 /** Default BR/EDR connection parameters:
2561 /** @brief Initiate an BR/EDR connection to a remote device.
2565 * The caller gets a new reference to the connection object which must be
2569 * @param param Initial connection parameters.
2571 * @return Valid connection object on success or NULL otherwise.