goep.h

Go to the documentation of this file.

/* goep.h - Bluetooth Generic Object Exchange Profile handling */
 
/*
 * Copyright 2024-2026 NXP
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_GOEP_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_GOEP_H_

 
#include <zephyr/kernel.h>
#include <string.h>
#include <errno.h>
#include <stdbool.h>
 
#include <zephyr/bluetooth/bluetooth.h>
#include <zephyr/bluetooth/conn.h>
#include <zephyr/bluetooth/l2cap.h>
#include <zephyr/bluetooth/classic/rfcomm.h>
#include <zephyr/bluetooth/classic/obex.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct bt_goep;

struct bt_goep_transport_ops {
        void (*connected)(struct bt_conn *conn, struct bt_goep *goep);

        void (*disconnected)(struct bt_goep *goep);
};

struct bt_goep_transport_v1 {
        struct bt_rfcomm_dlc dlc;

        struct bt_goep *goep;
};

struct bt_goep_transport_v2 {
        struct bt_l2cap_br_chan chan;

        struct bt_goep *goep;
};

struct bt_goep_transport {
        struct bt_goep_transport_v1 v1;
        struct bt_goep_transport_v2 v2;
};

enum __packed bt_goep_transport_state {
        BT_GOEP_TRANSPORT_DISCONNECTED,
        BT_GOEP_TRANSPORT_CONNECTING,
        BT_GOEP_TRANSPORT_CONNECTED,
        BT_GOEP_TRANSPORT_DISCONNECTING,
};

struct bt_goep {
        struct bt_goep_transport_v1 *v1;

        struct bt_goep_transport_v2 *v2;

        struct bt_conn *_acl;

        atomic_t _state;

        const struct bt_goep_transport_ops *transport_ops;

        struct bt_obex obex;
};

#define BT_GOEP_INIT_V1(_goep, _v1) \
        do { \
                BUILD_ASSERT(SAME_TYPE(*(_goep), struct bt_goep) && \
                             SAME_TYPE(*(_v1), struct bt_goep_transport_v1), \
                             "pointer type mismatch in BT_GOEP_INIT_V1"); \
                (_v1)->goep = (_goep); \
                (_goep)->v1 = (_v1); \
                (_goep)->v2 = NULL; \
        } while (0)

#define BT_GOEP_INIT_V2(_goep, _v2) \
        do { \
                BUILD_ASSERT(SAME_TYPE(*(_goep), struct bt_goep) && \
                             SAME_TYPE(*(_v2), struct bt_goep_transport_v2), \
                             "pointer type mismatch in BT_GOEP_INIT_V2"); \
                (_v2)->goep = (_goep); \
                (_goep)->v2 = (_v2); \
                (_goep)->v1 = NULL; \
        } while (0)


struct bt_goep_transport_rfcomm_server {
        struct bt_rfcomm_server rfcomm;

        int (*accept)(struct bt_conn *conn, struct bt_goep_transport_rfcomm_server *server,
                      struct bt_goep **goep);
 
        sys_snode_t node;
};

int bt_goep_transport_rfcomm_server_register(struct bt_goep_transport_rfcomm_server *server);

int bt_goep_transport_rfcomm_connect(struct bt_conn *conn, struct bt_goep *goep, uint8_t channel);

int bt_goep_transport_rfcomm_disconnect(struct bt_goep *goep);



struct bt_goep_transport_l2cap_server {
        struct bt_l2cap_server l2cap;

        int (*accept)(struct bt_conn *conn, struct bt_goep_transport_l2cap_server *server,
                      struct bt_goep **goep);
 
        sys_snode_t node;
};

int bt_goep_transport_l2cap_server_register(struct bt_goep_transport_l2cap_server *server);

int bt_goep_transport_l2cap_connect(struct bt_conn *conn, struct bt_goep *goep, uint16_t psm);

int bt_goep_transport_l2cap_disconnect(struct bt_goep *goep);


struct net_buf *bt_goep_create_pdu(struct bt_goep *goep, struct net_buf_pool *pool);
 
#ifdef __cplusplus
}
#endif

 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_GOEP_H_ */