xref: /btstack/src/hci.h (revision 22909952ea76c45a8db20409374b80e7e0204e4c)

/*
 *  hci.h
 *
 *  Created by Matthias Ringwald on 4/29/09.
 *
 */

#pragma once

#include <stdint.h>
#include <stdlib.h>

#include "hci_transport.h"


// helper for BT little endian format
#define READ_BT_16( buffer, pos) (buffer[pos] | (buffer[pos+1] << 8))
#define READ_BT_24( buffer, pos) ( ((uint32_t) buffer[pos]) | (((uint32_t)buffer[pos+1]) << 8) | (((uint32_t)buffer[pos+2]) << 16))
#define READ_BT_32( buffer, pos) ( ((uint32_t) buffer[pos]) | (((uint32_t)buffer[pos+1]) << 8) | (((uint32_t)buffer[pos+2]) << 16) | (((uint32_t) buffer[pos+3])) << 24)

// #define STORE_BT_16( buffer, pos, value ) { buffer[pos] = (value) & 0xff; buffer[pos+1] = (value) >> 8; }

#define COMMAND_COMPLETE_EVENT(event,cmd) ( event[0] == 0x0e && READ_BT_16(event,3) == cmd.opcode)

// packet headers
#define HCI_CMD_DATA_PKT_HDR	  0x03
#define HCI_ACL_DATA_PKT_HDR	  0x04
#define HCI_SCO_DATA_PKT_HDR	  0x03
#define HCI_EVENT_PKT_HDR         0x02

/**
 * @brief Length of a bluetooth device address.
 */
#define BD_ADDR_LEN 6
typedef uint8_t bd_addr_t[BD_ADDR_LEN];

/**
 * @brief The link key type
 */
#define LINK_KEY_LEN 16
typedef uint8_t link_key_t[LINK_KEY_LEN];

/**
 * @brief hci connection handle type
 */
typedef uint16_t hci_con_handle_t;

typedef enum {
    HCI_POWER_OFF = 0,
    HCI_POWER_ON
} HCI_POWER_MODE;

typedef struct {
    uint16_t    opcode;
    const char *format;
} hci_cmd_t;

typedef struct hci_connection {
    struct hci_connection * next;
    bd_addr_t address;
    hci_con_handle_t con_handle;
} hci_connection_t;

typedef struct {

    hci_transport_t * hci_transport;
    uint8_t         * hci_cmd_buffer;
    hci_connection_t *connections;

    /* host to controller flow control */
    uint8_t  num_cmd_packets;
    uint8_t  num_acl_packets;

    /* callback to L2CAP layer */
    void (*event_packet_handler)(uint8_t *packet, int size);
    void (*acl_packet_handler)  (uint8_t *packet, int size);

} hci_stack_t;


// set up HCI
void hci_init(hci_transport_t *transport, void *config);

void hci_register_event_packet_handler(void (*handler)(uint8_t *packet, int size));

void hci_register_acl_packet_handler  (void (*handler)(uint8_t *packet, int size));

// power control
int hci_power_control(HCI_POWER_MODE mode);

// run the hci daemon loop
void hci_run();

//
void hexdump(uint8_t *data, int size);

// create and send hci command packet based on a template and a list of parameters
int hci_send_cmd(hci_cmd_t *cmd, ...);

// send ACL packet
int hci_send_acl_packet(uint8_t *packet, int size);



// helper
extern void bt_store_16(uint8_t *buffer, uint16_t pos, uint16_t value);

extern hci_cmd_t hci_inquiry;
extern hci_cmd_t hci_link_key_request_negative_reply;
extern hci_cmd_t hci_pin_code_request_reply;
extern hci_cmd_t hci_reset;
extern hci_cmd_t hci_create_connection;
extern hci_cmd_t hci_host_buffer_size;
extern hci_cmd_t hci_write_authentication_enable;
extern hci_cmd_t hci_write_page_timeout;

#define HCI_INQUIRY_LAP 0x9E8B33L  // 0x9E8B33: General/Unlimited Inquiry Access Code (GIAC)