ad.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2018-2019 Freie Universität Berlin
 * SPDX-License-Identifier: LGPL-2.1-only
 */
 
#pragma once
 
#include <stdint.h>
#include <stddef.h>
#include <string.h>
 
#include "net/ble.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define BLUETIL_AD_INIT(b,p,s)          { .buf = b, .pos = p, .size = s }
 
#define BLUETIL_AD_FLAGS_DEFAULT        (BLE_GAP_DISCOVERABLE | \
                                         BLE_GAP_FLAG_BREDR_NOTSUP)
 
enum {
    BLUETIL_AD_OK       =  0,   
    BLUETIL_AD_NOTFOUND = -1,   
    BLUETIL_AD_NOMEM    = -2,   
};
 
typedef struct {
    uint8_t *data;              
    size_t len;                 
} bluetil_ad_data_t;
 
typedef struct {
    uint8_t *buf;               
    size_t pos;                 
    size_t size;                
} bluetil_ad_t;
 
void bluetil_ad_init(bluetil_ad_t *ad, void *buf, size_t pos, size_t size);
 
int bluetil_ad_find(const bluetil_ad_t *ad,
                    uint8_t type, bluetil_ad_data_t *data);
 
int bluetil_ad_find_and_cmp(const bluetil_ad_t *ad, uint8_t type,
                            const void *val, size_t val_len);
 
int bluetil_ad_find_str(const bluetil_ad_t *ad, uint8_t type,
                        char *str, size_t str_len);
 
int bluetil_ad_add(bluetil_ad_t *ad, uint8_t type,
                   const void *data, size_t data_len);
 
static inline int bluetil_ad_add_flags(bluetil_ad_t *ad, uint8_t flags)
{
    return bluetil_ad_add(ad, BLE_GAP_AD_FLAGS, &flags, 1);
}
 
static inline int bluetil_ad_add_name(bluetil_ad_t *ad, const char *name)
{
    return bluetil_ad_add(ad, BLE_GAP_AD_NAME, name, strlen(name));
}
 
static inline int bluetil_ad_init_with_flags(bluetil_ad_t *ad,
                                             void *buf, size_t buf_len,
                                             uint8_t flags)
{
    bluetil_ad_init(ad, buf, 0, buf_len);
    return bluetil_ad_add_flags(ad, flags);
}
 
/* add more convenience functions on demand... */
 
#ifdef __cplusplus
}
#endif