ots.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_SERVICES_OTS_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_SERVICES_OTS_H_
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <zephyr/types.h>
#include <sys/byteorder.h>
#include <sys/types.h>
#include <sys/util.h>
#include <bluetooth/conn.h>
#include <bluetooth/uuid.h>
 
#define BT_OTS_OBJ_ID_SIZE 6
 
#define BT_OTS_OBJ_ID_MIN 0x000000000100
 
#define BT_OTS_OBJ_ID_MAX 0xFFFFFFFFFFFF
 
#define OTS_OBJ_ID_DIR_LIST     0x000000000000
 
#define BT_OTS_OBJ_ID_MASK BIT64_MASK(48)
 
#define BT_OTS_OBJ_ID_STR_LEN 15
 
struct bt_ots_obj_type {
        union {
                /* Used to indicate UUID type */
                struct bt_uuid uuid;
 
                /* 16-bit UUID value */
                struct bt_uuid_16 uuid_16;
 
                /* 128-bit UUID value */
                struct bt_uuid_128 uuid_128;
        };
};
 
enum {
        BT_OTS_OBJ_PROP_DELETE    = 0,
 
        BT_OTS_OBJ_PROP_EXECUTE   = 1,
 
        BT_OTS_OBJ_PROP_READ      = 2,
 
        BT_OTS_OBJ_PROP_WRITE     = 3,
 
        BT_OTS_OBJ_PROP_APPEND    = 4,
 
        BT_OTS_OBJ_PROP_TRUNCATE  = 5,
 
        BT_OTS_OBJ_PROP_PATCH     = 6,
 
        BT_OTS_OBJ_PROP_MARKED    = 7,
};
 
#define BT_OTS_OBJ_SET_PROP_DELETE(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_DELETE, 1)
 
#define BT_OTS_OBJ_SET_PROP_EXECUTE(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_EXECUTE, 1)
 
#define BT_OTS_OBJ_SET_PROP_READ(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_READ, 1)
 
#define BT_OTS_OBJ_SET_PROP_WRITE(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_WRITE, 1)
 
#define BT_OTS_OBJ_SET_PROP_APPEND(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_APPEND, 1)
 
#define BT_OTS_OBJ_SET_PROP_TRUNCATE(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_TRUNCATE, 1)
 
#define BT_OTS_OBJ_SET_PROP_PATCH(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_PATCH, 1)
 
#define BT_OTS_OBJ_SET_PROP_MARKED(prop) \
        WRITE_BIT(prop, BT_OTS_OBJ_PROP_MARKED, 1)
 
#define BT_OTS_OBJ_GET_PROP_DELETE(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_DELETE))
 
#define BT_OTS_OBJ_GET_PROP_EXECUTE(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_EXECUTE))
 
#define BT_OTS_OBJ_GET_PROP_READ(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_READ))
 
#define BT_OTS_OBJ_GET_PROP_WRITE(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_WRITE))
 
#define BT_OTS_OBJ_GET_PROP_APPEND(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_APPEND))
 
#define BT_OTS_OBJ_GET_PROP_TRUNCATE(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_TRUNCATE))
 
#define BT_OTS_OBJ_GET_PROP_PATCH(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_PATCH))
 
#define BT_OTS_OBJ_GET_PROP_MARKED(prop) \
        ((prop) & BIT(BT_OTS_OBJ_PROP_MARKED))
 
struct bt_ots_obj_size {
        /* Current Size */
        uint32_t cur;
 
        /* Allocated Size */
        uint32_t alloc;
} __packed;
 
struct bt_ots_obj_metadata {
        /* Object Name */
        char                   *name;
 
        /* Object Type */
        struct bt_ots_obj_type type;
 
        /* Object Size */
        struct bt_ots_obj_size size;
 
        /* Object Properties */
        uint32_t               props;
};
 
enum {
        BT_OTS_OACP_FEAT_CREATE     = 0,
 
        BT_OTS_OACP_FEAT_DELETE     = 1,
 
        BT_OTS_OACP_FEAT_CHECKSUM   = 2,
 
        BT_OTS_OACP_FEAT_EXECUTE    = 3,
 
        BT_OTS_OACP_FEAT_READ       = 4,
 
        BT_OTS_OACP_FEAT_WRITE      = 5,
 
        BT_OTS_OACP_FEAT_APPEND     = 6,
 
        BT_OTS_OACP_FEAT_TRUNCATE   = 7,
 
        BT_OTS_OACP_FEAT_PATCH      = 8,
 
        BT_OTS_OACP_FEAT_ABORT      = 9,
};
 
#define BT_OTS_OACP_SET_FEAT_CREATE(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_CREATE, 1)
 
#define BT_OTS_OACP_SET_FEAT_DELETE(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_DELETE, 1)
 
#define BT_OTS_OACP_SET_FEAT_CHECKSUM(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_CHECKSUM, 1)
 
#define BT_OTS_OACP_SET_FEAT_EXECUTE(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_EXECUTE, 1)
 
#define BT_OTS_OACP_SET_FEAT_READ(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_READ, 1)
 
#define BT_OTS_OACP_SET_FEAT_WRITE(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_WRITE, 1)
 
#define BT_OTS_OACP_SET_FEAT_APPEND(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_APPEND, 1)
 
#define BT_OTS_OACP_SET_FEAT_TRUNCATE(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_TRUNCATE, 1)
 
#define BT_OTS_OACP_SET_FEAT_PATCH(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_PATCH, 1)
 
#define BT_OTS_OACP_SET_FEAT_ABORT(feat) \
        WRITE_BIT(feat, BT_OTS_OACP_FEAT_ABORT, 1)
 
#define BT_OTS_OACP_GET_FEAT_CREATE(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_CREATE))
 
#define BT_OTS_OACP_GET_FEAT_DELETE(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_DELETE))
 
#define BT_OTS_OACP_GET_FEAT_CHECKSUM(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_CHECKSUM))
 
#define BT_OTS_OACP_GET_FEAT_EXECUTE(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_EXECUTE))
 
#define BT_OTS_OACP_GET_FEAT_READ(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_READ))
 
#define BT_OTS_OACP_GET_FEAT_WRITE(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_WRITE))
 
#define BT_OTS_OACP_GET_FEAT_APPEND(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_APPEND))
 
#define BT_OTS_OACP_GET_FEAT_TRUNCATE(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_TRUNCATE))
 
#define BT_OTS_OACP_GET_FEAT_PATCH(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_PATCH))
 
#define BT_OTS_OACP_GET_FEAT_ABORT(feat) \
        ((feat) & BIT(BT_OTS_OACP_FEAT_ABORT))
 
enum {
        BT_OTS_OLCP_FEAT_GO_TO      = 0,
 
        BT_OTS_OLCP_FEAT_ORDER      = 1,
 
        BT_OTS_OLCP_FEAT_NUM_REQ    = 2,
 
        BT_OTS_OLCP_FEAT_CLEAR      = 3,
};
 
#define BT_OTS_OLCP_SET_FEAT_GO_TO(feat) \
        WRITE_BIT(feat, BT_OTS_OLCP_FEAT_GO_TO, 1)
 
#define BT_OTS_OLCP_SET_FEAT_ORDER(feat) \
        WRITE_BIT(feat, BT_OTS_OLCP_FEAT_ORDER, 1)
 
#define BT_OTS_OLCP_SET_FEAT_NUM_REQ(feat) \
        WRITE_BIT(feat, BT_OTS_OLCP_FEAT_NUM_REQ, 1)
 
#define BT_OTS_OLCP_SET_FEAT_CLEAR(feat) \
        WRITE_BIT(feat, BT_OTS_OLCP_FEAT_CLEAR, 1)
 
#define BT_OTS_OLCP_GET_FEAT_GO_TO(feat) \
        ((feat) & BIT(BT_OTS_OLCP_FEAT_GO_TO))
 
#define BT_OTS_OLCP_GET_FEAT_ORDER(feat) \
        ((feat) & BIT(BT_OTS_OLCP_FEAT_ORDER))
 
#define BT_OTS_OLCP_GET_FEAT_NUM_REQ(feat) \
        ((feat) & BIT(BT_OTS_OLCP_FEAT_NUM_REQ))
 
#define BT_OTS_OLCP_GET_FEAT_CLEAR(feat) \
        ((feat) & BIT(BT_OTS_OLCP_FEAT_CLEAR))
 
struct bt_ots_feat {
        /* OACP Features */
        uint32_t oacp;
 
        /* OLCP Features */
        uint32_t olcp;
} __packed;
 
struct bt_ots;
 
struct bt_ots_cb {
        int (*obj_created)(struct bt_ots *ots, struct bt_conn *conn,
                           uint64_t id,
                           const struct bt_ots_obj_metadata *init);
 
        void (*obj_deleted)(struct bt_ots *ots, struct bt_conn *conn,
                            uint64_t id);
 
        void (*obj_selected)(struct bt_ots *ots, struct bt_conn *conn,
                             uint64_t id);
 
        ssize_t (*obj_read)(struct bt_ots *ots, struct bt_conn *conn,
                           uint64_t id, void **data, size_t len,
                           off_t offset);
 
        ssize_t (*obj_write)(struct bt_ots *ots, struct bt_conn *conn, uint64_t id,
                             const void *data, size_t len, off_t offset,
                             size_t rem);
 
        void (*obj_name_written)(struct bt_ots *ots, struct bt_conn *conn,
                             uint64_t id, const char *name);
};
 
struct bt_ots_init {
        /* OTS features */
        struct bt_ots_feat features;
 
        /* Callbacks */
        struct bt_ots_cb *cb;
};
 
int bt_ots_obj_add(struct bt_ots *ots, struct bt_ots_obj_metadata *obj_init);
 
int bt_ots_obj_delete(struct bt_ots *ots, uint64_t id);
 
void *bt_ots_svc_decl_get(struct bt_ots *ots);
 
int bt_ots_init(struct bt_ots *ots, struct bt_ots_init *ots_init);
 
struct bt_ots *bt_ots_free_instance_get(void);
 
static inline int bt_ots_obj_id_to_str(uint64_t obj_id, char *str, size_t len)
{
        uint8_t id[6];
 
        sys_put_le48(obj_id, id);
 
        return snprintk(str, len, "0x%02X%02X%02X%02X%02X%02X",
                        id[5], id[4], id[3], id[2], id[1], id[0]);
}
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_SERVICES_OTS_H_ */