sol-bluetooth.h

Go to the documentation of this file.

/*
 * This file is part of the Soletta (TM) Project
 *
 * Copyright (C) 2016 Intel Corporation. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#ifdef __cplusplus
extern "C" {
#endif

#include <sol-network.h>

enum sol_bt_uuid_type {
    SOL_BT_UUID_TYPE_16 = 2,
    SOL_BT_UUID_TYPE_32 = 4,
    SOL_BT_UUID_TYPE_128 = 16,
};

typedef struct sol_bt_uuid {
    enum sol_bt_uuid_type type;
    union {
        uint16_t val16;
        uint32_t val32;
        uint8_t val128[16];
        uint8_t val[0];
    };
} sol_bt_uuid;

int sol_bt_uuid_from_str(struct sol_bt_uuid *uuid, const struct sol_str_slice str);

int sol_bt_uuid_to_str(const struct sol_bt_uuid *uuid, struct sol_buffer *buffer);

bool sol_bt_uuid_eq(const struct sol_bt_uuid *u1, const struct sol_bt_uuid *u2);

struct sol_bt_conn;
typedef struct sol_bt_conn sol_bt_conn;

struct sol_bt_conn *sol_bt_conn_ref(struct sol_bt_conn *conn);

void sol_bt_conn_unref(struct sol_bt_conn *conn);

const struct sol_network_link_addr *sol_bt_conn_get_addr(
    const struct sol_bt_conn *conn);

struct sol_bt_conn *sol_bt_connect(const struct sol_network_link_addr *addr,
    bool (*on_connect)(void *user_data, struct sol_bt_conn *conn),
    void (*on_disconnect)(void *user_data, struct sol_bt_conn *conn),
    void (*on_error)(void *user_data, int error),
    const void *user_data);

int sol_bt_disconnect(struct sol_bt_conn *conn);

struct sol_bt_session;
typedef struct sol_bt_session sol_bt_session;

struct sol_bt_session *sol_bt_enable(
    void (*on_enabled)(void *data, bool powered),
    const void *user_data);

int sol_bt_disable(struct sol_bt_session *session);

typedef struct sol_bt_device_info {
    struct sol_network_link_addr addr;
    struct sol_vector uuids;
    char *name;
    int16_t rssi;
    bool paired;
    bool connected;
    bool in_range;
} sol_bt_device_info;

enum sol_bt_transport {
    SOL_BT_TRANSPORT_LE = 1,
    SOL_BT_TRANSPORT_BREDR,
    SOL_BT_TRANSPORT_ALL = SOL_BT_TRANSPORT_LE | SOL_BT_TRANSPORT_BREDR,
};

const char *sol_bt_transport_to_str(enum sol_bt_transport transport);

enum sol_bt_transport sol_bt_transport_from_str(const char *str);

struct sol_bt_scan_pending;
typedef struct sol_bt_scan_pending sol_bt_scan_pending;

struct sol_bt_scan_pending *sol_bt_start_scan(
    enum sol_bt_transport transport,
    void (*on_found)(void *user_data, const struct sol_bt_device_info *device),
    const void *user_data);

int sol_bt_stop_scan(struct sol_bt_scan_pending *handle);

#ifdef __cplusplus
}
#endif