Loading...
Searching...
No Matches
nimble_netif_conn.h
Go to the documentation of this file.
1/*
2 * Copyright (C) 2018-2019 Freie Universität Berlin
3 *
4 * This file is subject to the terms and conditions of the GNU Lesser
5 * General Public License v2.1. See the file LICENSE in the top level
6 * directory for more details.
7 */
8
9#pragma once
10
23
24#include <stdint.h>
25#include <stdbool.h>
26
27#include "nimble_netif.h"
28
29#ifdef __cplusplus
30extern "C" {
31#endif
32
36#define NIMBLE_NETIF_CONN_INVALID (-1)
37
41typedef struct {
42 struct ble_l2cap_chan *coc;
43 uint16_t gaphandle;
44 uint16_t itvl;
45 uint16_t state;
46 uint8_t addr[BLE_ADDR_LEN];
49
61 int handle, void *arg);
62
69
79
87
95
104int nimble_netif_conn_get_by_addr(const uint8_t *addr);
105
115
126void nimble_netif_conn_foreach(uint16_t filter,
127 nimble_netif_conn_iter_t cb, void *arg);
128
141int nimble_netif_conn_get_next(int handle, uint16_t filter);
142
151
152unsigned nimble_netif_conn_count(uint16_t filter);
153
162int nimble_netif_conn_start_connection(const uint8_t *addr);
163
173
177void nimble_netif_conn_free(int handle, uint8_t *addr);
178
187uint16_t nimble_netif_conn_get_itvl_ms(int handle);
188
201bool nimble_netif_conn_itvl_used(uint16_t itvl, int skip_handle);
202
217uint16_t nimble_netif_conn_gen_itvl(uint16_t min, uint16_t max);
218
228static inline
233
245
255static inline int nimble_netif_conn_connected(const uint8_t *addr)
256{
258}
259
268static inline int nimble_netif_conn_is_open(const nimble_netif_conn_t *conn)
269{
270 return (conn->coc != NULL);
271}
272
280static inline int nimble_netif_conn_is_adv(void)
281{
283}
284
285#ifdef __cplusplus
286}
287#endif
288
#define BLE_ADDR_LEN
link layer address length
Definition ble.h:42
void nimble_netif_conn_foreach(uint16_t filter, nimble_netif_conn_iter_t cb, void *arg)
Iterate over all connection contexts that match the filter condition.
int nimble_netif_conn_start_adv(void)
Reserve a unused context for the purpose of accepting a new connection.
#define NIMBLE_NETIF_CONN_INVALID
Value for marking a handle invalid.
bool nimble_netif_conn_itvl_used(uint16_t itvl, int skip_handle)
Check if the given connection interval is used, taking the minimal spacing as defined by NIMBLE_NETIF...
static int nimble_netif_conn_is_adv(void)
Convenience function to check if any context is currently in the advertising state (NIMBLE_NETIF_ADV)
uint16_t nimble_netif_conn_get_itvl_ms(int handle)
Get the used connection interval for the given connection handle.
int nimble_netif_conn_get_adv(void)
Get the handle to the context that is currently advertising.
int nimble_netif_conn_get_connecting(void)
Get the handle to the context that is busy connecting.
void nimble_netif_conn_free(int handle, uint8_t *addr)
Free the connection context with the given handle.
int nimble_netif_conn_get_by_addr(const uint8_t *addr)
Find the connection to the peer with the given BLE address.
int nimble_netif_conn_start_connection(const uint8_t *addr)
Allocate an unused context for starting a connection.
unsigned nimble_netif_conn_count(uint16_t filter)
Count the number of connections contexts for which the given filter applies.
static nimble_netif_conn_t * nimble_netif_conn_from_gaphandle(uint16_t gh)
Find the connection context with a given GAP handle and return a pointer to it.
nimble_netif_conn_t * nimble_netif_conn_get(int handle)
Get the connection context corresponding to the given handle.
static int nimble_netif_conn_connecting(void)
Convenience function to check if any context is currently in the connecting state (NIMBLE_NETIF_CONNE...
uint16_t nimble_netif_conn_gen_itvl(uint16_t min, uint16_t max)
Generate a pseudorandom connection interval from the given range.
static int nimble_netif_conn_connected(const uint8_t *addr)
Convenience function to check if we are currently connected to a peer with the given address.
int nimble_netif_conn_get_next(int handle, uint16_t filter)
Find the next context that matches the filter condition.
int nimble_netif_conn_get_by_gaphandle(uint16_t gaphandle)
Find the connection using the given NimBLE GAP handle.
static int nimble_netif_conn_is_open(const nimble_netif_conn_t *conn)
Test if the given connection is (still) open.
int(* nimble_netif_conn_iter_t)(nimble_netif_conn_t *conn, int handle, void *arg)
Iterator function signature used by nimble_netif_conn_foreach()
void nimble_netif_conn_init(void)
Initialize the connection state manager.
GNRC netif implementation for NimBLE.
Memory layout for holding the relevant connection information.
uint16_t state
the current state of the context
struct ble_l2cap_chan * coc
l2cap context as exposed by NimBLE
uint16_t itvl
currently used connection interval
uint8_t addr[BLE_ADDR_LEN]
BLE address of connected peer (in network byte order)
uint16_t gaphandle
GAP handle exposed by NimBLE.