Implements several changes to the transport layer segmented tx to improve group message performance: - Moves retransmit counter to tx context instead of per packet. As every unacked packet is sent every retransmit, the retransmit counters would be the same in each segment. This makes it easier to control progress. - Delays the scheduling of the retransmit until the completion of the last segment by adding a seg_pending counter. This is essentially the same as the old behavior, except that the old behavior might retrigger the sending before all segments are finished if the advertising is slow. - Allows the group transmits to stop as soon as all retransmits have been exhausted, instead of timing out waiting for acks that won't come. This allows group tx to finish without error. - Fixes a bug where a failed TX would block IV update. - Cancels any pending transmissions of acked segments. - Reduces log level for several common group tx scenarios that aren't erronous.
113 lines
3.1 KiB
C
113 lines
3.1 KiB
C
/* Bluetooth Mesh */
|
|
|
|
/*
|
|
* Copyright (c) 2017 Intel Corporation
|
|
* Additional Copyright (c) 2018 Espressif Systems (Shanghai) PTE LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#ifndef _ADV_H_
|
|
#define _ADV_H_
|
|
|
|
#include "mesh_access.h"
|
|
#include "mesh_bearer_adapt.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Maximum advertising data payload for a single data type */
|
|
#define BLE_MESH_ADV_DATA_SIZE 29
|
|
|
|
/* The user data is a pointer (4 bytes) to struct bt_mesh_adv */
|
|
#define BLE_MESH_ADV_USER_DATA_SIZE 4
|
|
|
|
#define BLE_MESH_ADV(buf) (*(struct bt_mesh_adv **)net_buf_user_data(buf))
|
|
|
|
typedef struct bt_mesh_msg {
|
|
bool relay; /* Flag indicates if the packet is a relayed one */
|
|
void *arg; /* Pointer to the struct net_buf */
|
|
u16_t src; /* Source address for relay packets */
|
|
u16_t dst; /* Destination address for relay packets */
|
|
u32_t timestamp; /* Timestamp recorded when the relay packet is posted to queue */
|
|
} bt_mesh_msg_t;
|
|
|
|
enum bt_mesh_adv_type {
|
|
BLE_MESH_ADV_PROV,
|
|
BLE_MESH_ADV_DATA,
|
|
BLE_MESH_ADV_BEACON,
|
|
BLE_MESH_ADV_URI,
|
|
BLE_MESH_ADV_BLE,
|
|
};
|
|
|
|
typedef void (*bt_mesh_adv_func_t)(struct net_buf *buf, u16_t duration,
|
|
int err, void *user_data);
|
|
|
|
struct bt_mesh_adv {
|
|
const struct bt_mesh_send_cb *cb;
|
|
void *cb_data;
|
|
|
|
u8_t type:3,
|
|
busy:1;
|
|
u8_t xmit;
|
|
};
|
|
|
|
typedef struct bt_mesh_adv *(*bt_mesh_adv_alloc_t)(int id);
|
|
|
|
/* xmit_count: Number of retransmissions, i.e. 0 == 1 transmission */
|
|
struct net_buf *bt_mesh_adv_create(enum bt_mesh_adv_type type, u8_t xmit,
|
|
s32_t timeout);
|
|
|
|
typedef enum {
|
|
BLE_MESH_BUF_REF_EQUAL,
|
|
BLE_MESH_BUF_REF_SMALL,
|
|
BLE_MESH_BUF_REF_MAX,
|
|
} bt_mesh_buf_ref_flag_t;
|
|
|
|
void bt_mesh_adv_buf_ref_debug(const char *func, struct net_buf *buf,
|
|
u8_t ref_cmp, bt_mesh_buf_ref_flag_t flag);
|
|
|
|
struct net_buf *bt_mesh_adv_create_from_pool(struct net_buf_pool *pool,
|
|
bt_mesh_adv_alloc_t get_id,
|
|
enum bt_mesh_adv_type type,
|
|
u8_t xmit, s32_t timeout);
|
|
|
|
void bt_mesh_unref_buf_from_pool(struct net_buf_pool *pool);
|
|
|
|
void bt_mesh_adv_send(struct net_buf *buf, const struct bt_mesh_send_cb *cb,
|
|
void *cb_data);
|
|
|
|
const bt_mesh_addr_t *bt_mesh_pba_get_addr(void);
|
|
|
|
struct net_buf *bt_mesh_relay_adv_create(enum bt_mesh_adv_type type, u8_t xmit,
|
|
s32_t timeout);
|
|
|
|
void bt_mesh_relay_adv_send(struct net_buf *buf, const struct bt_mesh_send_cb *cb,
|
|
void *cb_data, u16_t src, u16_t dst);
|
|
|
|
u16_t bt_mesh_get_stored_relay_count(void);
|
|
|
|
void bt_mesh_adv_update(void);
|
|
|
|
void bt_mesh_adv_init(void);
|
|
void bt_mesh_adv_deinit(void);
|
|
|
|
int bt_mesh_scan_enable(void);
|
|
|
|
int bt_mesh_scan_disable(void);
|
|
|
|
int bt_mesh_scan_with_wl_enable(void);
|
|
|
|
#if CONFIG_BLE_MESH_SUPPORT_BLE_ADV
|
|
int bt_mesh_start_ble_advertising(const struct bt_mesh_ble_adv_param *param,
|
|
const struct bt_mesh_ble_adv_data *data, u8_t *index);
|
|
|
|
int bt_mesh_stop_ble_advertising(u8_t index);
|
|
#endif /* CONFIG_BLE_MESH_SUPPORT_BLE_ADV */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _ADV_H_ */
|