dgtl_msg.h

Go to the documentation of this file.

 
#ifndef DGTL_MSG_H_
#define DGTL_MSG_H_
 
#include <stdbool.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef __PACKED_UNION {
        const uint8_t pkt_type;
        uint8_t data[0];
} dgtl_msg_t;
 
dgtl_msg_t *dgtl_msg_alloc(uint8_t pkt_type, size_t length);
 
void dgtl_msg_free(dgtl_msg_t *msg);
 
void *dgtl_msg_get_param_ptr(dgtl_msg_t *msg, size_t *length);
 
/*
 * \brief Prepare DGTL message as HCI command packet
 *
 * This function can be used to fill HCI command packet header for a previously allocated DGTL
 * message. The message has to have packet type set to HCI command.
 *
 * When called with \p msg set to \p NULL, this function will allocated new message of proper size.
 *
 * \param [in] msg        existing DGTL message
 * \param [in] opcode     HCI command opcode
 * \param [in] param_len  length of parameters buffer
 * \param [in] param      command parameters
 *
 * \return DGTL message
 *
 */
dgtl_msg_t *dgtl_msg_prepare_hci_cmd(dgtl_msg_t *msg, uint16_t opcode, uint8_t param_len, void *param);
 
/*
 * \brief Prepare DGTL message as HCI event packet
 *
 * This function can be used to fill HCI event packet header for a previously allocated DGTL
 * message. The message has to have packet type set to HCI event.
 *
 * When called with \p msg set to \p NULL, this function will allocated new message of proper size.
 *
 * \param [in] msg        existing DGTL message
 * \param [in] code       HCI event code
 * \param [in] param_len  length of parameters buffer
 * \param [in] param      command parameters
 *
 * \return DGTL message
 *
 */
dgtl_msg_t *dgtl_msg_prepare_hci_evt(dgtl_msg_t *msg, uint8_t code, uint8_t param_len, void *param);
 
void *dgtl_msg_to_raw_ptr(dgtl_msg_t *msg);
 
dgtl_msg_t *dgtl_msg_from_raw_ptr(void *ptr, uint8_t pkt_type);
 
#ifdef __cplusplus
}
#endif
 
#endif /* DGTL_MSG_H_ */