nimble/include/nimble/ble.h - mynewt-nimble - Git at Google

 /*
  * Licensed to the Apache Software Foundation (ASF) under one
  * or more contributor license agreements.  See the NOTICE file
  * distributed with this work for additional information
  * regarding copyright ownership.  The ASF licenses this file
  * to you 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.
  */

 #ifndef H_BLE_
 #define H_BLE_

 #include <inttypes.h>
 #include <string.h>
 #include "syscfg/syscfg.h"
 #include "os/os.h"

 #ifdef __cplusplus
 extern "C" {
 #endif

 /* The number of advertising instances */
 #define BLE_ADV_INSTANCES    (MYNEWT_VAL(BLE_MULTI_ADV_INSTANCES) + 1)

 /* BLE encryption block definitions */
 #define BLE_ENC_BLOCK_SIZE       (16)

 /* 4 byte header + 251 byte payload. */
 #define BLE_ACL_MAX_PKT_SIZE     255

 struct ble_encryption_block
 {
     uint8_t     key[BLE_ENC_BLOCK_SIZE];
     uint8_t     plain_text[BLE_ENC_BLOCK_SIZE];
     uint8_t     cipher_text[BLE_ENC_BLOCK_SIZE];
 };

 /*
  * BLE MBUF structure:
  *
  * The BLE mbuf structure is as follows. Note that this structure applies to
  * the packet header mbuf (not mbufs that are part of a "packet chain"):
  *      struct os_mbuf          (16)
  *      struct os_mbuf_pkthdr   (8)
  *      struct ble_mbuf_hdr     (8)
  *      Data buffer             (payload size, in bytes)
  *
  * The BLE mbuf header contains the following:
  *  flags: bitfield with the following values
  *      0x01:   Set if there was a match on the whitelist
  *      0x02:   Set if a connect request was transmitted upon receiving pdu
  *      0x04:   Set the first time we transmit the PDU (used to detect retry).
  *  channel: The logical BLE channel PHY channel # (0 - 39)
  *  crcok: flag denoting CRC check passed (1) or failed (0).
  *  rssi: RSSI, in dBm.
  */
 struct ble_mbuf_hdr_rxinfo
 {
     uint16_t flags;
     uint8_t channel;
     uint8_t handle;
     int8_t  rssi;
     /* XXX: we could just use single phy_mode field */
     int8_t  phy;
     uint8_t phy_mode;
 #if MYNEWT_VAL(BLE_LL_CFG_FEAT_LL_PRIVACY)
     int8_t  rpa_index;
 #endif
 #if MYNEWT_VAL(BLE_LL_CFG_FEAT_LL_EXT_ADV)
     void *user_data;
 #endif
 };

 /*
  * Flag definitions for rxinfo
  *
  * Note: it's ok to have symbols with the same values as long as they cannot be
  *       set for the same PDU (e.g. one use by scanner, other one used by
  *       connection)
  */
 #define BLE_MBUF_HDR_F_CONN_CREDIT      (0x8000)
 #define BLE_MBUF_HDR_F_IGNORED          (0x8000)
 #define BLE_MBUF_HDR_F_SCAN_REQ_TXD     (0x4000)
 #define BLE_MBUF_HDR_F_INITA_RESOLVED   (0x2000)
 #define BLE_MBUF_HDR_F_TARGETA_RESOLVED (0x2000)
 #define BLE_MBUF_HDR_F_EXT_ADV_SEC      (0x1000)
 #define BLE_MBUF_HDR_F_EXT_ADV          (0x0800)
 #define BLE_MBUF_HDR_F_RESOLVED         (0x0400)
 #define BLE_MBUF_HDR_F_AUX_PTR_WAIT     (0x0200)
 #define BLE_MBUF_HDR_F_AUX_INVALID      (0x0100)
 #define BLE_MBUF_HDR_F_CRC_OK           (0x0080)
 #define BLE_MBUF_HDR_F_DEVMATCH         (0x0040)
 #define BLE_MBUF_HDR_F_MIC_FAILURE      (0x0020)
 #define BLE_MBUF_HDR_F_SCAN_RSP_TXD     (0x0010)
 #define BLE_MBUF_HDR_F_SCAN_RSP_RXD     (0x0008)
 #define BLE_MBUF_HDR_F_RXSTATE_MASK     (0x0007)

 /* Transmit info. NOTE: no flags defined */
 struct ble_mbuf_hdr_txinfo
 {
     uint8_t flags;
     uint8_t hdr_byte;
     uint16_t offset;
     uint16_t pyld_len;
 };

 struct ble_mbuf_hdr
 {
     union {
         struct ble_mbuf_hdr_rxinfo rxinfo;
         struct ble_mbuf_hdr_txinfo txinfo;
     };
     uint32_t beg_cputime;
     uint32_t rem_usecs;
 };

 #define BLE_MBUF_HDR_IGNORED(hdr) \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_IGNORED))

 #define BLE_MBUF_HDR_SCAN_REQ_TXD(hdr) \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_SCAN_REQ_TXD))

 #define BLE_MBUF_HDR_EXT_ADV_SEC(hdr) \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_EXT_ADV_SEC))

 #define BLE_MBUF_HDR_EXT_ADV(hdr) \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_EXT_ADV))

 #define BLE_MBUF_HDR_DEVMATCH(hdr) \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_DEVMATCH))

 #define BLE_MBUF_HDR_SCAN_RSP_RXD(hdr) \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_SCAN_RSP_RXD))

 #define BLE_MBUF_HDR_AUX_INVALID(hdr) \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_AUX_INVALID))

 #define BLE_MBUF_HDR_WAIT_AUX(hdr)      \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_AUX_PTR_WAIT))

 #define BLE_MBUF_HDR_CRC_OK(hdr)        \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_CRC_OK))

 #define BLE_MBUF_HDR_MIC_FAILURE(hdr)   \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_MIC_FAILURE))

 #define BLE_MBUF_HDR_RESOLVED(hdr)      \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_RESOLVED))

 #define BLE_MBUF_HDR_INITA_RESOLVED(hdr)      \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_INITA_RESOLVED))

 #define BLE_MBUF_HDR_TARGETA_RESOLVED(hdr)      \
     (!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_TARGETA_RESOLVED))

 #define BLE_MBUF_HDR_RX_STATE(hdr)      \
     ((uint8_t)((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_RXSTATE_MASK))

 #define BLE_MBUF_HDR_PTR(om)            \
     (struct ble_mbuf_hdr *)((uint8_t *)om + sizeof(struct os_mbuf) + \
                             sizeof(struct os_mbuf_pkthdr))

 /* BLE mbuf overhead per packet header mbuf */
 #define BLE_MBUF_PKTHDR_OVERHEAD        \
     (sizeof(struct os_mbuf_pkthdr) + sizeof(struct ble_mbuf_hdr))

 #define BLE_MBUF_MEMBLOCK_OVERHEAD      \
     (sizeof(struct os_mbuf) + BLE_MBUF_PKTHDR_OVERHEAD)

 /* Length of host user header.  Only contains the peer's connection handle. */
 #define BLE_MBUF_HS_HDR_LEN     (2)

 #define BLE_DEV_ADDR_LEN        (6)
 extern uint8_t g_dev_addr[BLE_DEV_ADDR_LEN];
 extern uint8_t g_random_addr[BLE_DEV_ADDR_LEN];

 /* BLE Error Codes (Core v4.2 Vol 2 part D) */
 enum ble_error_codes
 {
     /* An "error" code of 0x0 means success */
     BLE_ERR_SUCCESS             = 0x00,
     BLE_ERR_UNKNOWN_HCI_CMD     = 0x01,
     BLE_ERR_UNK_CONN_ID         = 0x02,
     BLE_ERR_HW_FAIL             = 0x03,
     BLE_ERR_PAGE_TMO            = 0x04,
     BLE_ERR_AUTH_FAIL           = 0x05,
     BLE_ERR_PINKEY_MISSING      = 0x06,
     BLE_ERR_MEM_CAPACITY        = 0x07,
     BLE_ERR_CONN_SPVN_TMO       = 0x08,
     BLE_ERR_CONN_LIMIT          = 0x09,
     BLE_ERR_SYNCH_CONN_LIMIT    = 0x0a,
     BLE_ERR_ACL_CONN_EXISTS     = 0x0b,
     BLE_ERR_CMD_DISALLOWED      = 0x0c,
     BLE_ERR_CONN_REJ_RESOURCES  = 0x0d,
     BLE_ERR_CONN_REJ_SECURITY   = 0x0e,
     BLE_ERR_CONN_REJ_BD_ADDR    = 0x0f,
     BLE_ERR_CONN_ACCEPT_TMO     = 0x10,
     BLE_ERR_UNSUPPORTED         = 0x11,
     BLE_ERR_INV_HCI_CMD_PARMS   = 0x12,
     BLE_ERR_REM_USER_CONN_TERM  = 0x13,
     BLE_ERR_RD_CONN_TERM_RESRCS = 0x14,
     BLE_ERR_RD_CONN_TERM_PWROFF = 0x15,
     BLE_ERR_CONN_TERM_LOCAL     = 0x16,
     BLE_ERR_REPEATED_ATTEMPTS   = 0x17,
     BLE_ERR_NO_PAIRING          = 0x18,
     BLE_ERR_UNK_LMP             = 0x19,
     BLE_ERR_UNSUPP_REM_FEATURE  = 0x1a,
     BLE_ERR_SCO_OFFSET          = 0x1b,
     BLE_ERR_SCO_ITVL            = 0x1c,
     BLE_ERR_SCO_AIR_MODE        = 0x1d,
     BLE_ERR_INV_LMP_LL_PARM     = 0x1e,
     BLE_ERR_UNSPECIFIED         = 0x1f,
     BLE_ERR_UNSUPP_LMP_LL_PARM  = 0x20,
     BLE_ERR_NO_ROLE_CHANGE      = 0x21,
     BLE_ERR_LMP_LL_RSP_TMO      = 0x22,
     BLE_ERR_LMP_COLLISION       = 0x23,
     BLE_ERR_LMP_PDU             = 0x24,
     BLE_ERR_ENCRYPTION_MODE     = 0x25,
     BLE_ERR_LINK_KEY_CHANGE     = 0x26,
     BLE_ERR_UNSUPP_QOS          = 0x27,
     BLE_ERR_INSTANT_PASSED      = 0x28,
     BLE_ERR_UNIT_KEY_PAIRING    = 0x29,
     BLE_ERR_DIFF_TRANS_COLL     = 0x2a,
     /* BLE_ERR_RESERVED         = 0x2b */
     BLE_ERR_QOS_PARM            = 0x2c,
     BLE_ERR_QOS_REJECTED        = 0x2d,
     BLE_ERR_CHAN_CLASS          = 0x2e,
     BLE_ERR_INSUFFICIENT_SEC    = 0x2f,
     BLE_ERR_PARM_OUT_OF_RANGE   = 0x30,
     /* BLE_ERR_RESERVED         = 0x31 */
     BLE_ERR_PENDING_ROLE_SW     = 0x32,
     /* BLE_ERR_RESERVED         = 0x33 */
     BLE_ERR_RESERVED_SLOT       = 0x34,
     BLE_ERR_ROLE_SW_FAIL        = 0x35,
     BLE_ERR_INQ_RSP_TOO_BIG     = 0x36,
     BLE_ERR_SEC_SIMPLE_PAIR     = 0x37,
     BLE_ERR_HOST_BUSY_PAIR      = 0x38,
     BLE_ERR_CONN_REJ_CHANNEL    = 0x39,
     BLE_ERR_CTLR_BUSY           = 0x3a,
     BLE_ERR_CONN_PARMS          = 0x3b,
     BLE_ERR_DIR_ADV_TMO         = 0x3c,
     BLE_ERR_CONN_TERM_MIC       = 0x3d,
     BLE_ERR_CONN_ESTABLISHMENT  = 0x3e,
     BLE_ERR_MAC_CONN_FAIL       = 0x3f,
     BLE_ERR_COARSE_CLK_ADJ      = 0x40,
     BLE_ERR_TYPE0_SUBMAP_NDEF   = 0x41,
     BLE_ERR_UNK_ADV_INDENT      = 0x42,
     BLE_ERR_LIMIT_REACHED       = 0x43,
     BLE_ERR_OPERATION_CANCELLED = 0x44,
     BLE_ERR_PACKET_TOO_LONG     = 0x45,
     BLE_ERR_MAX                 = 0xff
 };

 /* HW error codes */
 #define BLE_HW_ERR_DO_NOT_USE           (0) /* XXX: reserve this one for now */
 #define BLE_HW_ERR_HCI_SYNC_LOSS        (1)

 /* Own Bluetooth Device address type */
 #define BLE_OWN_ADDR_PUBLIC                  (0x00)
 #define BLE_OWN_ADDR_RANDOM                  (0x01)
 #define BLE_OWN_ADDR_RPA_PUBLIC_DEFAULT      (0x02)
 #define BLE_OWN_ADDR_RPA_RANDOM_DEFAULT      (0x03)

 /* Bluetooth Device address type */
 #define BLE_ADDR_PUBLIC      (0x00)
 #define BLE_ADDR_RANDOM      (0x01)
 #define BLE_ADDR_PUBLIC_ID   (0x02)
 #define BLE_ADDR_RANDOM_ID   (0x03)

 #define BLE_ADDR_ANY (&(ble_addr_t) { 0, {0, 0, 0, 0, 0, 0} })

 #define BLE_ADDR_IS_RPA(addr)     (((addr)->type == BLE_ADDR_RANDOM) && \
                                    ((addr)->val[5] & 0xc0) == 0x40)
 #define BLE_ADDR_IS_NRPA(addr)    (((addr)->type == BLE_ADDR_RANDOM) && \
                                    ((addr)->val[5] & 0xc0) == 0x00)
 #define BLE_ADDR_IS_STATIC(addr)  (((addr)->type == BLE_ADDR_RANDOM) && \
                                    ((addr)->val[5] & 0xc0) == 0xc0)

 typedef struct {
     uint8_t type;
     uint8_t val[6];
 } ble_addr_t;


 static inline int ble_addr_cmp(const ble_addr_t *a, const ble_addr_t *b)
 {
     int type_diff;

     type_diff = a->type - b->type;
     if (type_diff != 0) {
         return type_diff;
     }

     return memcmp(a->val, b->val, sizeof(a->val));
 }

 #ifdef __cplusplus
 }
 #endif

 #endif /* H_BLE_ */
	/*
	* Licensed to the Apache Software Foundation (ASF) under one
	* or more contributor license agreements. See the NOTICE file
	* distributed with this work for additional information
	* regarding copyright ownership. The ASF licenses this file
	* to you 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.
	*/

	#ifndef H_BLE_
	#define H_BLE_

	#include <inttypes.h>
	#include <string.h>
	#include "syscfg/syscfg.h"
	#include "os/os.h"

	#ifdef __cplusplus
	extern "C" {
	#endif

	/* The number of advertising instances */
	#define BLE_ADV_INSTANCES (MYNEWT_VAL(BLE_MULTI_ADV_INSTANCES) + 1)

	/* BLE encryption block definitions */
	#define BLE_ENC_BLOCK_SIZE (16)

	/* 4 byte header + 251 byte payload. */
	#define BLE_ACL_MAX_PKT_SIZE 255

	struct ble_encryption_block
	{
	uint8_t key[BLE_ENC_BLOCK_SIZE];
	uint8_t plain_text[BLE_ENC_BLOCK_SIZE];
	uint8_t cipher_text[BLE_ENC_BLOCK_SIZE];
	};

	/*
	* BLE MBUF structure:
	*
	* The BLE mbuf structure is as follows. Note that this structure applies to
	* the packet header mbuf (not mbufs that are part of a "packet chain"):
	* struct os_mbuf (16)
	* struct os_mbuf_pkthdr (8)
	* struct ble_mbuf_hdr (8)
	* Data buffer (payload size, in bytes)
	*
	* The BLE mbuf header contains the following:
	* flags: bitfield with the following values
	* 0x01: Set if there was a match on the whitelist
	* 0x02: Set if a connect request was transmitted upon receiving pdu
	* 0x04: Set the first time we transmit the PDU (used to detect retry).
	* channel: The logical BLE channel PHY channel # (0 - 39)
	* crcok: flag denoting CRC check passed (1) or failed (0).
	* rssi: RSSI, in dBm.
	*/
	struct ble_mbuf_hdr_rxinfo
	{
	uint16_t flags;
	uint8_t channel;
	uint8_t handle;
	int8_t rssi;
	/* XXX: we could just use single phy_mode field */
	int8_t phy;
	uint8_t phy_mode;
	#if MYNEWT_VAL(BLE_LL_CFG_FEAT_LL_PRIVACY)
	int8_t rpa_index;
	#endif
	#if MYNEWT_VAL(BLE_LL_CFG_FEAT_LL_EXT_ADV)
	void *user_data;
	#endif
	};

	/*
	* Flag definitions for rxinfo
	*
	* Note: it's ok to have symbols with the same values as long as they cannot be
	* set for the same PDU (e.g. one use by scanner, other one used by
	* connection)
	*/
	#define BLE_MBUF_HDR_F_CONN_CREDIT (0x8000)
	#define BLE_MBUF_HDR_F_IGNORED (0x8000)
	#define BLE_MBUF_HDR_F_SCAN_REQ_TXD (0x4000)
	#define BLE_MBUF_HDR_F_INITA_RESOLVED (0x2000)
	#define BLE_MBUF_HDR_F_TARGETA_RESOLVED (0x2000)
	#define BLE_MBUF_HDR_F_EXT_ADV_SEC (0x1000)
	#define BLE_MBUF_HDR_F_EXT_ADV (0x0800)
	#define BLE_MBUF_HDR_F_RESOLVED (0x0400)
	#define BLE_MBUF_HDR_F_AUX_PTR_WAIT (0x0200)
	#define BLE_MBUF_HDR_F_AUX_INVALID (0x0100)
	#define BLE_MBUF_HDR_F_CRC_OK (0x0080)
	#define BLE_MBUF_HDR_F_DEVMATCH (0x0040)
	#define BLE_MBUF_HDR_F_MIC_FAILURE (0x0020)
	#define BLE_MBUF_HDR_F_SCAN_RSP_TXD (0x0010)
	#define BLE_MBUF_HDR_F_SCAN_RSP_RXD (0x0008)
	#define BLE_MBUF_HDR_F_RXSTATE_MASK (0x0007)

	/* Transmit info. NOTE: no flags defined */
	struct ble_mbuf_hdr_txinfo
	{
	uint8_t flags;
	uint8_t hdr_byte;
	uint16_t offset;
	uint16_t pyld_len;
	};

	struct ble_mbuf_hdr
	{
	union {
	struct ble_mbuf_hdr_rxinfo rxinfo;
	struct ble_mbuf_hdr_txinfo txinfo;
	};
	uint32_t beg_cputime;
	uint32_t rem_usecs;
	};

	#define BLE_MBUF_HDR_IGNORED(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_IGNORED))

	#define BLE_MBUF_HDR_SCAN_REQ_TXD(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_SCAN_REQ_TXD))

	#define BLE_MBUF_HDR_EXT_ADV_SEC(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_EXT_ADV_SEC))

	#define BLE_MBUF_HDR_EXT_ADV(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_EXT_ADV))

	#define BLE_MBUF_HDR_DEVMATCH(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_DEVMATCH))

	#define BLE_MBUF_HDR_SCAN_RSP_RXD(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_SCAN_RSP_RXD))

	#define BLE_MBUF_HDR_AUX_INVALID(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_AUX_INVALID))

	#define BLE_MBUF_HDR_WAIT_AUX(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_AUX_PTR_WAIT))

	#define BLE_MBUF_HDR_CRC_OK(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_CRC_OK))

	#define BLE_MBUF_HDR_MIC_FAILURE(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_MIC_FAILURE))

	#define BLE_MBUF_HDR_RESOLVED(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_RESOLVED))

	#define BLE_MBUF_HDR_INITA_RESOLVED(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_INITA_RESOLVED))

	#define BLE_MBUF_HDR_TARGETA_RESOLVED(hdr) \
	(!!((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_TARGETA_RESOLVED))

	#define BLE_MBUF_HDR_RX_STATE(hdr) \
	((uint8_t)((hdr)->rxinfo.flags & BLE_MBUF_HDR_F_RXSTATE_MASK))

	#define BLE_MBUF_HDR_PTR(om) \
	(struct ble_mbuf_hdr )((uint8_t )om + sizeof(struct os_mbuf) + \
	sizeof(struct os_mbuf_pkthdr))

	/* BLE mbuf overhead per packet header mbuf */
	#define BLE_MBUF_PKTHDR_OVERHEAD \
	(sizeof(struct os_mbuf_pkthdr) + sizeof(struct ble_mbuf_hdr))

	#define BLE_MBUF_MEMBLOCK_OVERHEAD \
	(sizeof(struct os_mbuf) + BLE_MBUF_PKTHDR_OVERHEAD)

	/* Length of host user header. Only contains the peer's connection handle. */
	#define BLE_MBUF_HS_HDR_LEN (2)

	#define BLE_DEV_ADDR_LEN (6)
	extern uint8_t g_dev_addr[BLE_DEV_ADDR_LEN];
	extern uint8_t g_random_addr[BLE_DEV_ADDR_LEN];

	/* BLE Error Codes (Core v4.2 Vol 2 part D) */
	enum ble_error_codes
	{
	/* An "error" code of 0x0 means success */
	BLE_ERR_SUCCESS = 0x00,
	BLE_ERR_UNKNOWN_HCI_CMD = 0x01,
	BLE_ERR_UNK_CONN_ID = 0x02,
	BLE_ERR_HW_FAIL = 0x03,
	BLE_ERR_PAGE_TMO = 0x04,
	BLE_ERR_AUTH_FAIL = 0x05,
	BLE_ERR_PINKEY_MISSING = 0x06,
	BLE_ERR_MEM_CAPACITY = 0x07,
	BLE_ERR_CONN_SPVN_TMO = 0x08,
	BLE_ERR_CONN_LIMIT = 0x09,
	BLE_ERR_SYNCH_CONN_LIMIT = 0x0a,
	BLE_ERR_ACL_CONN_EXISTS = 0x0b,
	BLE_ERR_CMD_DISALLOWED = 0x0c,
	BLE_ERR_CONN_REJ_RESOURCES = 0x0d,
	BLE_ERR_CONN_REJ_SECURITY = 0x0e,
	BLE_ERR_CONN_REJ_BD_ADDR = 0x0f,
	BLE_ERR_CONN_ACCEPT_TMO = 0x10,
	BLE_ERR_UNSUPPORTED = 0x11,
	BLE_ERR_INV_HCI_CMD_PARMS = 0x12,
	BLE_ERR_REM_USER_CONN_TERM = 0x13,
	BLE_ERR_RD_CONN_TERM_RESRCS = 0x14,
	BLE_ERR_RD_CONN_TERM_PWROFF = 0x15,
	BLE_ERR_CONN_TERM_LOCAL = 0x16,
	BLE_ERR_REPEATED_ATTEMPTS = 0x17,
	BLE_ERR_NO_PAIRING = 0x18,
	BLE_ERR_UNK_LMP = 0x19,
	BLE_ERR_UNSUPP_REM_FEATURE = 0x1a,
	BLE_ERR_SCO_OFFSET = 0x1b,
	BLE_ERR_SCO_ITVL = 0x1c,
	BLE_ERR_SCO_AIR_MODE = 0x1d,
	BLE_ERR_INV_LMP_LL_PARM = 0x1e,
	BLE_ERR_UNSPECIFIED = 0x1f,
	BLE_ERR_UNSUPP_LMP_LL_PARM = 0x20,
	BLE_ERR_NO_ROLE_CHANGE = 0x21,
	BLE_ERR_LMP_LL_RSP_TMO = 0x22,
	BLE_ERR_LMP_COLLISION = 0x23,
	BLE_ERR_LMP_PDU = 0x24,
	BLE_ERR_ENCRYPTION_MODE = 0x25,
	BLE_ERR_LINK_KEY_CHANGE = 0x26,
	BLE_ERR_UNSUPP_QOS = 0x27,
	BLE_ERR_INSTANT_PASSED = 0x28,
	BLE_ERR_UNIT_KEY_PAIRING = 0x29,
	BLE_ERR_DIFF_TRANS_COLL = 0x2a,
	/* BLE_ERR_RESERVED = 0x2b */
	BLE_ERR_QOS_PARM = 0x2c,
	BLE_ERR_QOS_REJECTED = 0x2d,
	BLE_ERR_CHAN_CLASS = 0x2e,
	BLE_ERR_INSUFFICIENT_SEC = 0x2f,
	BLE_ERR_PARM_OUT_OF_RANGE = 0x30,
	/* BLE_ERR_RESERVED = 0x31 */
	BLE_ERR_PENDING_ROLE_SW = 0x32,
	/* BLE_ERR_RESERVED = 0x33 */
	BLE_ERR_RESERVED_SLOT = 0x34,
	BLE_ERR_ROLE_SW_FAIL = 0x35,
	BLE_ERR_INQ_RSP_TOO_BIG = 0x36,
	BLE_ERR_SEC_SIMPLE_PAIR = 0x37,
	BLE_ERR_HOST_BUSY_PAIR = 0x38,
	BLE_ERR_CONN_REJ_CHANNEL = 0x39,
	BLE_ERR_CTLR_BUSY = 0x3a,
	BLE_ERR_CONN_PARMS = 0x3b,
	BLE_ERR_DIR_ADV_TMO = 0x3c,
	BLE_ERR_CONN_TERM_MIC = 0x3d,
	BLE_ERR_CONN_ESTABLISHMENT = 0x3e,
	BLE_ERR_MAC_CONN_FAIL = 0x3f,
	BLE_ERR_COARSE_CLK_ADJ = 0x40,
	BLE_ERR_TYPE0_SUBMAP_NDEF = 0x41,
	BLE_ERR_UNK_ADV_INDENT = 0x42,
	BLE_ERR_LIMIT_REACHED = 0x43,
	BLE_ERR_OPERATION_CANCELLED = 0x44,
	BLE_ERR_PACKET_TOO_LONG = 0x45,
	BLE_ERR_MAX = 0xff
	};

	/* HW error codes */
	#define BLE_HW_ERR_DO_NOT_USE (0) /* XXX: reserve this one for now */
	#define BLE_HW_ERR_HCI_SYNC_LOSS (1)

	/* Own Bluetooth Device address type */
	#define BLE_OWN_ADDR_PUBLIC (0x00)
	#define BLE_OWN_ADDR_RANDOM (0x01)
	#define BLE_OWN_ADDR_RPA_PUBLIC_DEFAULT (0x02)
	#define BLE_OWN_ADDR_RPA_RANDOM_DEFAULT (0x03)

	/* Bluetooth Device address type */
	#define BLE_ADDR_PUBLIC (0x00)
	#define BLE_ADDR_RANDOM (0x01)
	#define BLE_ADDR_PUBLIC_ID (0x02)
	#define BLE_ADDR_RANDOM_ID (0x03)

	#define BLE_ADDR_ANY (&(ble_addr_t) { 0, {0, 0, 0, 0, 0, 0} })

	#define BLE_ADDR_IS_RPA(addr) (((addr)->type == BLE_ADDR_RANDOM) && \
	((addr)->val[5] & 0xc0) == 0x40)
	#define BLE_ADDR_IS_NRPA(addr) (((addr)->type == BLE_ADDR_RANDOM) && \
	((addr)->val[5] & 0xc0) == 0x00)
	#define BLE_ADDR_IS_STATIC(addr) (((addr)->type == BLE_ADDR_RANDOM) && \
	((addr)->val[5] & 0xc0) == 0xc0)

	typedef struct {
	uint8_t type;
	uint8_t val[6];
	} ble_addr_t;


	static inline int ble_addr_cmp(const ble_addr_t a, const ble_addr_t b)
	{
	int type_diff;

	type_diff = a->type - b->type;
	if (type_diff != 0) {
	return type_diff;
	}

	return memcmp(a->val, b->val, sizeof(a->val));
	}

	#ifdef __cplusplus
	}
	#endif

	#endif /* H_BLE_ */