sb-py/include/ble.h

/*
 * ble.h
 *
 * Copyright (c) 2023 Thomas Buck (thomas@xythobuz.de)
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * See <http://www.gnu.org/licenses/>.
 */

#ifndef __BLE_H__
#define __BLE_H__

#include "btstack.h"

#define BLE_MAX_NAME_LENGTH 32
#define BLE_MAX_DATA_LENGTH 26
#define BLE_MAX_SCAN_RESULTS 32
#define BLE_MAX_VALUE_LEN 64

enum ble_scan_mode {
    BLE_SCAN_OFF    = 0,
    BLE_SCAN_ON     = 1,
    BLE_SCAN_TOGGLE = 2,
};

struct ble_scan_result {
    bool set;
    uint32_t time;

    bd_addr_t addr;
    bd_addr_type_t type;
    int8_t rssi;
    char name[BLE_MAX_NAME_LENGTH + 1];
    uint8_t data[BLE_MAX_DATA_LENGTH];
    size_t data_len;
};

void ble_init(void);
bool ble_is_ready(void);

void ble_scan(enum ble_scan_mode mode);
int32_t ble_get_scan_results(struct ble_scan_result *buf, uint16_t len);

void ble_connect(bd_addr_t addr, bd_addr_type_t type);
bool ble_is_connected(void);
void ble_disconnect(void);

int8_t ble_discover(const uint8_t *service, const uint8_t *characteristic);

int32_t ble_read(const uint8_t *characteristic, uint8_t *buff, uint16_t buff_len);
int8_t ble_write(const uint8_t *service, const uint8_t *characteristic,
                 const uint8_t *buff, uint16_t buff_len);

int8_t ble_notification_disable(const uint8_t *service, const uint8_t *characteristic);
int8_t ble_notification_enable(const uint8_t *service, const uint8_t *characteristic);
bool ble_notification_ready(void);
uint16_t ble_notification_get(uint8_t *buff, uint16_t buff_len, uint8_t *characteristic);

#endif // __BLE_H__