ble_gap.h

/*
 * Copyright (c) Nordic Semiconductor ASA
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification,
 * are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice, this
 *    list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form, except as embedded into a Nordic
 *    Semiconductor ASA integrated circuit in a product or a software update for
 *    such product, must reproduce the above copyright notice, this list of
 *    conditions and the following disclaimer in the documentation and/or other
 *    materials provided with the distribution.
 *
 * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
 *    contributors may be used to endorse or promote products derived from this
 *    software without specific prior written permission.
 *
 * 4. This software, with or without modification, must only be used with a
 *    Nordic Semiconductor ASA integrated circuit.
 *
 * 5. Any software provided in binary form under this license must not be reverse
 *    engineered, decompiled, modified and/or disassembled.
 *
 * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
 * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
#ifndef BLE_GAP_H__
#define BLE_GAP_H__
 
#include <stdint.h>
#include "nrf_svc.h"
#include "nrf_error.h"
#include "ble_hci.h"
#include "ble_ranges.h"
#include "ble_types.h"
#include "ble_err.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum BLE_GAP_SVCS
{
  SD_BLE_GAP_ADDR_SET                   = BLE_GAP_SVC_BASE,       
  SD_BLE_GAP_ADDR_GET                   = BLE_GAP_SVC_BASE + 1,   
  SD_BLE_GAP_ADV_ADDR_GET               = BLE_GAP_SVC_BASE + 2,   
  SD_BLE_GAP_WHITELIST_SET              = BLE_GAP_SVC_BASE + 3,   
  SD_BLE_GAP_DEVICE_IDENTITIES_SET      = BLE_GAP_SVC_BASE + 4,   
  SD_BLE_GAP_PRIVACY_SET                = BLE_GAP_SVC_BASE + 5,   
  SD_BLE_GAP_PRIVACY_GET                = BLE_GAP_SVC_BASE + 6,   
  SD_BLE_GAP_ADV_SET_CONFIGURE          = BLE_GAP_SVC_BASE + 7,   
  SD_BLE_GAP_ADV_START                  = BLE_GAP_SVC_BASE + 8,   
  SD_BLE_GAP_ADV_STOP                   = BLE_GAP_SVC_BASE + 9,   
  SD_BLE_GAP_CONN_PARAM_UPDATE          = BLE_GAP_SVC_BASE + 10,  
  SD_BLE_GAP_DISCONNECT                 = BLE_GAP_SVC_BASE + 11,  
  SD_BLE_GAP_TX_POWER_SET               = BLE_GAP_SVC_BASE + 12,  
  SD_BLE_GAP_APPEARANCE_SET             = BLE_GAP_SVC_BASE + 13,  
  SD_BLE_GAP_APPEARANCE_GET             = BLE_GAP_SVC_BASE + 14,  
  SD_BLE_GAP_PPCP_SET                   = BLE_GAP_SVC_BASE + 15,  
  SD_BLE_GAP_PPCP_GET                   = BLE_GAP_SVC_BASE + 16,  
  SD_BLE_GAP_DEVICE_NAME_SET            = BLE_GAP_SVC_BASE + 17,  
  SD_BLE_GAP_DEVICE_NAME_GET            = BLE_GAP_SVC_BASE + 18,  
  SD_BLE_GAP_AUTHENTICATE               = BLE_GAP_SVC_BASE + 19,  
  SD_BLE_GAP_SEC_PARAMS_REPLY           = BLE_GAP_SVC_BASE + 20,  
  SD_BLE_GAP_AUTH_KEY_REPLY             = BLE_GAP_SVC_BASE + 21,  
  SD_BLE_GAP_LESC_DHKEY_REPLY           = BLE_GAP_SVC_BASE + 22,  
  SD_BLE_GAP_KEYPRESS_NOTIFY            = BLE_GAP_SVC_BASE + 23,  
  SD_BLE_GAP_LESC_OOB_DATA_GET          = BLE_GAP_SVC_BASE + 24,  
  SD_BLE_GAP_LESC_OOB_DATA_SET          = BLE_GAP_SVC_BASE + 25,  
  SD_BLE_GAP_SEC_INFO_REPLY             = BLE_GAP_SVC_BASE + 27,  
  SD_BLE_GAP_CONN_SEC_GET               = BLE_GAP_SVC_BASE + 28,  
  SD_BLE_GAP_PHY_UPDATE                 = BLE_GAP_SVC_BASE + 33,  
  SD_BLE_GAP_DATA_LENGTH_UPDATE         = BLE_GAP_SVC_BASE + 34,  
  SD_BLE_GAP_NEXT_CONN_EVT_COUNTER_GET  = BLE_GAP_SVC_BASE + 36,  
  SD_BLE_GAP_RSSI_GET                   = BLE_GAP_SVC_BASE + 38,  
  SD_BLE_GAP_RSSI_START                 = BLE_GAP_SVC_BASE + 39,  
  SD_BLE_GAP_RSSI_STOP                  = BLE_GAP_SVC_BASE + 40,  
};
 
enum BLE_GAP_EVTS
{
  BLE_GAP_EVT_CONNECTED                   = BLE_GAP_EVT_BASE,       
  BLE_GAP_EVT_DISCONNECTED                = BLE_GAP_EVT_BASE + 1,   
  BLE_GAP_EVT_CONN_PARAM_UPDATE           = BLE_GAP_EVT_BASE + 2,   
  BLE_GAP_EVT_SEC_PARAMS_REQUEST          = BLE_GAP_EVT_BASE + 3,   
  BLE_GAP_EVT_SEC_INFO_REQUEST            = BLE_GAP_EVT_BASE + 4,   
  BLE_GAP_EVT_PASSKEY_DISPLAY             = BLE_GAP_EVT_BASE + 5,   
  BLE_GAP_EVT_KEY_PRESSED                 = BLE_GAP_EVT_BASE + 6,   
  BLE_GAP_EVT_AUTH_KEY_REQUEST            = BLE_GAP_EVT_BASE + 7,   
  BLE_GAP_EVT_LESC_DHKEY_REQUEST          = BLE_GAP_EVT_BASE + 8,   
  BLE_GAP_EVT_AUTH_STATUS                 = BLE_GAP_EVT_BASE + 9,   
  BLE_GAP_EVT_CONN_SEC_UPDATE             = BLE_GAP_EVT_BASE + 10,  
  BLE_GAP_EVT_TIMEOUT                     = BLE_GAP_EVT_BASE + 11,  
  BLE_GAP_EVT_RSSI_CHANGED                = BLE_GAP_EVT_BASE + 12,  
  BLE_GAP_EVT_SCAN_REQ_REPORT             = BLE_GAP_EVT_BASE + 16,  
  BLE_GAP_EVT_PHY_UPDATE_REQUEST          = BLE_GAP_EVT_BASE + 17,  
  BLE_GAP_EVT_PHY_UPDATE                  = BLE_GAP_EVT_BASE + 18,  
  BLE_GAP_EVT_DATA_LENGTH_UPDATE_REQUEST  = BLE_GAP_EVT_BASE + 19,  
  BLE_GAP_EVT_DATA_LENGTH_UPDATE          = BLE_GAP_EVT_BASE + 20,  
  BLE_GAP_EVT_ADV_SET_TERMINATED          = BLE_GAP_EVT_BASE + 22,  
};
 
enum BLE_GAP_OPTS
{
  BLE_GAP_OPT_CH_MAP                  = BLE_GAP_OPT_BASE,       
  BLE_GAP_OPT_PASSKEY                 = BLE_GAP_OPT_BASE + 2,   
  BLE_GAP_OPT_AUTH_PAYLOAD_TIMEOUT    = BLE_GAP_OPT_BASE + 4,   
  BLE_GAP_OPT_SLAVE_LATENCY_DISABLE   = BLE_GAP_OPT_BASE + 5,   
};
 
enum BLE_GAP_CFGS
{
  BLE_GAP_CFG_ROLE_COUNT       = BLE_GAP_CFG_BASE,     
  BLE_GAP_CFG_DEVICE_NAME      = BLE_GAP_CFG_BASE + 1, 
  BLE_GAP_CFG_PPCP_INCL_CONFIG = BLE_GAP_CFG_BASE + 2, 
  BLE_GAP_CFG_CAR_INCL_CONFIG  = BLE_GAP_CFG_BASE + 3, 
};
 
enum BLE_GAP_TX_POWER_ROLES
{
  BLE_GAP_TX_POWER_ROLE_ADV       = 1,           
  BLE_GAP_TX_POWER_ROLE_CONN      = 3,           
};
 
 
#define BLE_ERROR_GAP_UUID_LIST_MISMATCH            (NRF_GAP_ERR_BASE + 0x000)  
#define BLE_ERROR_GAP_DISCOVERABLE_WITH_WHITELIST   (NRF_GAP_ERR_BASE + 0x001)  
#define BLE_ERROR_GAP_INVALID_BLE_ADDR              (NRF_GAP_ERR_BASE + 0x002)  
#define BLE_ERROR_GAP_WHITELIST_IN_USE              (NRF_GAP_ERR_BASE + 0x003)  
#define BLE_ERROR_GAP_DEVICE_IDENTITIES_IN_USE      (NRF_GAP_ERR_BASE + 0x004)  
#define BLE_ERROR_GAP_DEVICE_IDENTITIES_DUPLICATE   (NRF_GAP_ERR_BASE + 0x005)  
#define BLE_ERROR_GAP_ZERO_IRK_NOT_ALLOWED          (NRF_GAP_ERR_BASE + 0x006)  
#define BLE_GAP_ROLE_INVALID     0x0            
#define BLE_GAP_ROLE_PERIPH      0x1            
#define BLE_GAP_TIMEOUT_SRC_CONN                       0x02 
#define BLE_GAP_TIMEOUT_SRC_AUTH_PAYLOAD               0x03 
#define BLE_GAP_ADDR_TYPE_PUBLIC                        0x00 
#define BLE_GAP_ADDR_TYPE_RANDOM_STATIC                 0x01 
#define BLE_GAP_ADDR_TYPE_RANDOM_PRIVATE_RESOLVABLE     0x02 
#define BLE_GAP_ADDR_TYPE_RANDOM_PRIVATE_NON_RESOLVABLE 0x03 
#define BLE_GAP_DEFAULT_PRIVATE_ADDR_CYCLE_INTERVAL_S (900) /* 15 minutes. */
#define BLE_GAP_MAX_PRIVATE_ADDR_CYCLE_INTERVAL_S     (41400) /* 11 hours 30 minutes. */
 
 
#define BLE_GAP_ADDR_LEN (6)
 
#define BLE_GAP_PRIVACY_MODE_OFF                       0x00 
#define BLE_GAP_PRIVACY_MODE_DEVICE_PRIVACY            0x01 
#define BLE_GAP_PRIVACY_MODE_NETWORK_PRIVACY           0x02 
#define BLE_GAP_POWER_LEVEL_INVALID     127
 
#define BLE_GAP_ADV_SET_HANDLE_NOT_SET (0xFF)
 
#define BLE_GAP_ADV_SET_COUNT_DEFAULT   (1)
 
#define BLE_GAP_ADV_SET_COUNT_MAX       (1)
 
#define BLE_GAP_ADV_SET_DATA_SIZE_MAX                    (31)   
#define BLE_GAP_ADV_REPORT_SET_ID_NOT_AVAILABLE                    0xFF
 
#define BLE_GAP_EVT_ADV_SET_TERMINATED_REASON_TIMEOUT              0x01  
#define BLE_GAP_EVT_ADV_SET_TERMINATED_REASON_LIMIT_REACHED        0x02  
#define BLE_GAP_AD_TYPE_FLAGS                               0x01 
#define BLE_GAP_AD_TYPE_16BIT_SERVICE_UUID_MORE_AVAILABLE   0x02 
#define BLE_GAP_AD_TYPE_16BIT_SERVICE_UUID_COMPLETE         0x03 
#define BLE_GAP_AD_TYPE_32BIT_SERVICE_UUID_MORE_AVAILABLE   0x04 
#define BLE_GAP_AD_TYPE_32BIT_SERVICE_UUID_COMPLETE         0x05 
#define BLE_GAP_AD_TYPE_128BIT_SERVICE_UUID_MORE_AVAILABLE  0x06 
#define BLE_GAP_AD_TYPE_128BIT_SERVICE_UUID_COMPLETE        0x07 
#define BLE_GAP_AD_TYPE_SHORT_LOCAL_NAME                    0x08 
#define BLE_GAP_AD_TYPE_COMPLETE_LOCAL_NAME                 0x09 
#define BLE_GAP_AD_TYPE_TX_POWER_LEVEL                      0x0A 
#define BLE_GAP_AD_TYPE_CLASS_OF_DEVICE                     0x0D 
#define BLE_GAP_AD_TYPE_SIMPLE_PAIRING_HASH_C               0x0E 
#define BLE_GAP_AD_TYPE_SIMPLE_PAIRING_RANDOMIZER_R         0x0F 
#define BLE_GAP_AD_TYPE_SECURITY_MANAGER_TK_VALUE           0x10 
#define BLE_GAP_AD_TYPE_SECURITY_MANAGER_OOB_FLAGS          0x11 
#define BLE_GAP_AD_TYPE_SLAVE_CONNECTION_INTERVAL_RANGE     0x12 
#define BLE_GAP_AD_TYPE_SOLICITED_SERVICE_UUIDS_16BIT       0x14 
#define BLE_GAP_AD_TYPE_SOLICITED_SERVICE_UUIDS_128BIT      0x15 
#define BLE_GAP_AD_TYPE_SERVICE_DATA                        0x16 
#define BLE_GAP_AD_TYPE_PUBLIC_TARGET_ADDRESS               0x17 
#define BLE_GAP_AD_TYPE_RANDOM_TARGET_ADDRESS               0x18 
#define BLE_GAP_AD_TYPE_APPEARANCE                          0x19 
#define BLE_GAP_AD_TYPE_ADVERTISING_INTERVAL                0x1A 
#define BLE_GAP_AD_TYPE_LE_BLUETOOTH_DEVICE_ADDRESS         0x1B 
#define BLE_GAP_AD_TYPE_LE_ROLE                             0x1C 
#define BLE_GAP_AD_TYPE_SIMPLE_PAIRING_HASH_C256            0x1D 
#define BLE_GAP_AD_TYPE_SIMPLE_PAIRING_RANDOMIZER_R256      0x1E 
#define BLE_GAP_AD_TYPE_SERVICE_DATA_32BIT_UUID             0x20 
#define BLE_GAP_AD_TYPE_SERVICE_DATA_128BIT_UUID            0x21 
#define BLE_GAP_AD_TYPE_LESC_CONFIRMATION_VALUE             0x22 
#define BLE_GAP_AD_TYPE_LESC_RANDOM_VALUE                   0x23 
#define BLE_GAP_AD_TYPE_URI                                 0x24 
#define BLE_GAP_AD_TYPE_3D_INFORMATION_DATA                 0x3D 
#define BLE_GAP_AD_TYPE_MANUFACTURER_SPECIFIC_DATA          0xFF 
#define BLE_GAP_ADV_FLAG_LE_LIMITED_DISC_MODE         (0x01)   
#define BLE_GAP_ADV_FLAG_LE_GENERAL_DISC_MODE         (0x02)   
#define BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED         (0x04)   
#define BLE_GAP_ADV_FLAG_LE_BR_EDR_CONTROLLER         (0x08)   
#define BLE_GAP_ADV_FLAG_LE_BR_EDR_HOST               (0x10)   
#define BLE_GAP_ADV_FLAGS_LE_ONLY_LIMITED_DISC_MODE   (BLE_GAP_ADV_FLAG_LE_LIMITED_DISC_MODE | BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED)   
#define BLE_GAP_ADV_FLAGS_LE_ONLY_GENERAL_DISC_MODE   (BLE_GAP_ADV_FLAG_LE_GENERAL_DISC_MODE | BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED)   
#define BLE_GAP_ADV_INTERVAL_MIN        0x000020 
#define BLE_GAP_ADV_INTERVAL_MAX        0xFFFFFF 
#define BLE_GAP_ADV_TYPE_CONNECTABLE_SCANNABLE_UNDIRECTED                   0x01   
#define BLE_GAP_ADV_TYPE_CONNECTABLE_NONSCANNABLE_DIRECTED_HIGH_DUTY_CYCLE  0x02   
#define BLE_GAP_ADV_TYPE_CONNECTABLE_NONSCANNABLE_DIRECTED                  0x03   
#define BLE_GAP_ADV_TYPE_NONCONNECTABLE_SCANNABLE_UNDIRECTED                0x04   
#define BLE_GAP_ADV_TYPE_NONCONNECTABLE_NONSCANNABLE_UNDIRECTED             0x05   
#define BLE_GAP_ADV_FP_ANY                0x00   
#define BLE_GAP_ADV_FP_FILTER_SCANREQ     0x01   
#define BLE_GAP_ADV_FP_FILTER_CONNREQ     0x02   
#define BLE_GAP_ADV_FP_FILTER_BOTH        0x03   
#define BLE_GAP_ADV_TIMEOUT_HIGH_DUTY_MAX     (128)   
#define BLE_GAP_ADV_TIMEOUT_LIMITED_MAX       (18000) 
#define BLE_GAP_ADV_TIMEOUT_GENERAL_UNLIMITED (0)     
#define BLE_GAP_IO_CAPS_DISPLAY_ONLY      0x00   
#define BLE_GAP_IO_CAPS_DISPLAY_YESNO     0x01   
#define BLE_GAP_IO_CAPS_KEYBOARD_ONLY     0x02   
#define BLE_GAP_IO_CAPS_NONE              0x03   
#define BLE_GAP_IO_CAPS_KEYBOARD_DISPLAY  0x04   
#define BLE_GAP_AUTH_KEY_TYPE_NONE        0x00   
#define BLE_GAP_AUTH_KEY_TYPE_PASSKEY     0x01   
#define BLE_GAP_AUTH_KEY_TYPE_OOB         0x02   
#define BLE_GAP_KP_NOT_TYPE_PASSKEY_START       0x00   
#define BLE_GAP_KP_NOT_TYPE_PASSKEY_DIGIT_IN    0x01   
#define BLE_GAP_KP_NOT_TYPE_PASSKEY_DIGIT_OUT   0x02   
#define BLE_GAP_KP_NOT_TYPE_PASSKEY_CLEAR       0x03   
#define BLE_GAP_KP_NOT_TYPE_PASSKEY_END         0x04   
#define BLE_GAP_SEC_STATUS_SUCCESS                0x00  
#define BLE_GAP_SEC_STATUS_PASSKEY_ENTRY_FAILED   0x01  
#define BLE_GAP_SEC_STATUS_OOB_NOT_AVAILABLE      0x02  
#define BLE_GAP_SEC_STATUS_AUTH_REQ               0x03  
#define BLE_GAP_SEC_STATUS_CONFIRM_VALUE          0x04  
#define BLE_GAP_SEC_STATUS_PAIRING_NOT_SUPP       0x05  
#define BLE_GAP_SEC_STATUS_ENC_KEY_SIZE           0x06  
#define BLE_GAP_SEC_STATUS_SMP_CMD_UNSUPPORTED    0x07  
#define BLE_GAP_SEC_STATUS_UNSPECIFIED            0x08  
#define BLE_GAP_SEC_STATUS_REPEATED_ATTEMPTS      0x09  
#define BLE_GAP_SEC_STATUS_INVALID_PARAMS         0x0A  
#define BLE_GAP_SEC_STATUS_DHKEY_FAILURE          0x0B  
#define BLE_GAP_SEC_STATUS_NUM_COMP_FAILURE       0x0C  
#define BLE_GAP_SEC_STATUS_BR_EDR_IN_PROG         0x0D  
#define BLE_GAP_SEC_STATUS_X_TRANS_KEY_DISALLOWED 0x0E  
#define BLE_GAP_SEC_STATUS_KEY_REJECTED           0x0F  
#define BLE_GAP_SEC_STATUS_BUSY                   0x10  
#define BLE_GAP_SEC_STATUS_TIMEOUT                0x81  
#define BLE_GAP_SEC_STATUS_PDU_INVALID            0x82  
#define BLE_GAP_SEC_STATUS_SOURCE_LOCAL           0x00  
#define BLE_GAP_SEC_STATUS_SOURCE_REMOTE          0x01  
#define BLE_GAP_CONN_INTVL_MS_TO_UNITS(CI_MS)       ((uint16_t)((CI_MS) / 1.25))  
#define BLE_GAP_CP_MIN_CONN_INTVL_NONE           0xFFFF  
#define BLE_GAP_CP_MIN_CONN_INTVL_MIN            0x0006  
#define BLE_GAP_CP_MIN_CONN_INTVL_MAX            0x0C80  
#define BLE_GAP_CP_MAX_CONN_INTVL_NONE           0xFFFF  
#define BLE_GAP_CP_MAX_CONN_INTVL_MIN            0x0006  
#define BLE_GAP_CP_MAX_CONN_INTVL_MAX            0x0C80  
#define BLE_GAP_CP_SLAVE_LATENCY_MAX             0x01F3  
#define BLE_GAP_CP_CONN_SUP_TIMEOUT_NONE         0xFFFF  
#define BLE_GAP_CP_CONN_SUP_TIMEOUT_MIN          0x000A  
#define BLE_GAP_CP_CONN_SUP_TIMEOUT_MAX          0x0C80  
#define BLE_GAP_DEVNAME_DEFAULT                  "nRF5x" 
#define BLE_GAP_DEVNAME_DEFAULT_LEN              31      
#define BLE_GAP_DEVNAME_MAX_LEN                  248     
#define BLE_GAP_RSSI_UNAVAILABLE 127
 
#define BLE_GAP_RSSI_THRESHOLD_INVALID 0xFF
 
#define BLE_GAP_PHY_AUTO                         0x00    
#define BLE_GAP_PHY_1MBPS                        0x01    
#define BLE_GAP_PHY_2MBPS                        0x02    
#define BLE_GAP_PHY_CODED                        0x04    
#define BLE_GAP_PHY_NOT_SET                      0xFF    
#define BLE_GAP_PHYS_SUPPORTED  (BLE_GAP_PHY_1MBPS | BLE_GAP_PHY_2MBPS) 
#define BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS(ptr)          do {(ptr)->sm = 0; (ptr)->lv = 0;} while(0)
#define BLE_GAP_CONN_SEC_MODE_SET_OPEN(ptr)               do {(ptr)->sm = 1; (ptr)->lv = 1;} while(0)
#define BLE_GAP_CONN_SEC_MODE_SET_ENC_NO_MITM(ptr)        do {(ptr)->sm = 1; (ptr)->lv = 2;} while(0)
#define BLE_GAP_CONN_SEC_MODE_SET_ENC_WITH_MITM(ptr)      do {(ptr)->sm = 1; (ptr)->lv = 3;} while(0)
#define BLE_GAP_CONN_SEC_MODE_SET_LESC_ENC_WITH_MITM(ptr) do {(ptr)->sm = 1; (ptr)->lv = 4;} while(0)
#define BLE_GAP_SEC_RAND_LEN 8
 
 
#define BLE_GAP_SEC_KEY_LEN 16
 
 
#define BLE_GAP_LESC_P256_PK_LEN 64
 
 
#define BLE_GAP_LESC_DHKEY_LEN   32
 
 
#define BLE_GAP_PASSKEY_LEN 6
 
 
#define BLE_GAP_WHITELIST_ADDR_MAX_COUNT (8)
 
 
#define BLE_GAP_DEVICE_IDENTITIES_MAX_COUNT (8)
 
 
#define BLE_GAP_CONN_COUNT_DEFAULT (1)
 
 
#define BLE_GAP_EVENT_LENGTH_MIN            (2)  
#define BLE_GAP_EVENT_LENGTH_1MBPS_PHY_MIN  (2)  
#define BLE_GAP_EVENT_LENGTH_2MBPS_PHY_MIN  (1)  
#define BLE_GAP_EVENT_LENGTH_DEFAULT        (3)  
#define BLE_GAP_ROLE_COUNT_PERIPH_DEFAULT      (1)   
#define BLE_GAP_ROLE_COUNT_COMBINED_MAX        (20)  
#define BLE_GAP_DATA_LENGTH_AUTO 0
 
#define BLE_GAP_AUTH_PAYLOAD_TIMEOUT_MAX (48000) 
#define BLE_GAP_AUTH_PAYLOAD_TIMEOUT_MIN (1)     
#define BLE_GAP_SEC_MODE 0x00 
#define BLE_GAP_CHAR_INCL_CONFIG_INCLUDE               (0) 
#define BLE_GAP_CHAR_INCL_CONFIG_EXCLUDE_WITH_SPACE    (1) 
#define BLE_GAP_CHAR_INCL_CONFIG_EXCLUDE_WITHOUT_SPACE (2) 
#define BLE_GAP_PPCP_INCL_CONFIG_DEFAULT     (BLE_GAP_CHAR_INCL_CONFIG_INCLUDE)            
#define BLE_GAP_CAR_INCL_CONFIG_DEFAULT      (BLE_GAP_CHAR_INCL_CONFIG_INCLUDE)            
#define BLE_GAP_SLAVE_LATENCY_ENABLE         (0) 
#define BLE_GAP_SLAVE_LATENCY_DISABLE        (1) 
#define BLE_GAP_SLAVE_LATENCY_WAIT_FOR_ACK   (2) 
typedef struct
{
  uint8_t type;                 
  uint8_t anonymous        : 1; 
  uint8_t include_tx_power : 1; 
} ble_gap_adv_properties_t;
 
 
typedef struct
{
  uint8_t addr_id_peer : 1;       
  uint8_t addr_type    : 7;       
  uint8_t addr[BLE_GAP_ADDR_LEN]; 
} ble_gap_addr_t;
 
 
typedef struct
{
  uint16_t min_conn_interval;         
  uint16_t max_conn_interval;         
  uint16_t slave_latency;             
  uint16_t conn_sup_timeout;          
} ble_gap_conn_params_t;
 
typedef struct
{
  uint8_t sm : 4;                     
  uint8_t lv : 4;                     
} ble_gap_conn_sec_mode_t;
 
 
typedef struct
{
  ble_gap_conn_sec_mode_t sec_mode;           
  uint8_t                 encr_key_size;      
} ble_gap_conn_sec_t;
 
typedef struct
{
  uint8_t irk[BLE_GAP_SEC_KEY_LEN];   
} ble_gap_irk_t;
 
 
typedef uint8_t ble_gap_ch_mask_t[5];
 
 
typedef struct
{
  ble_gap_adv_properties_t properties;              
  ble_gap_addr_t const    *p_peer_addr;             
  uint32_t                 interval;                
  uint16_t                 duration;                
  uint8_t                  max_adv_evts;            
  ble_gap_ch_mask_t        channel_mask;            
  uint8_t                  filter_policy;           
  uint8_t                  primary_phy;             
  uint8_t                  secondary_phy;           
  uint8_t                  set_id:4;                
  uint8_t                  scan_req_notification:1; 
} ble_gap_adv_params_t;
 
typedef struct
{
  ble_data_t       adv_data;                     
  ble_data_t       scan_rsp_data;                
} ble_gap_adv_data_t;
 
typedef struct
{
  uint8_t        privacy_mode;         
  uint8_t        private_addr_type;    
  uint16_t       private_addr_cycle_s; 
  ble_gap_irk_t *p_device_irk;         
} ble_gap_privacy_params_t;
 
 
typedef struct
{
  uint8_t tx_phys;     
  uint8_t rx_phys;     
} ble_gap_phys_t;
 
typedef struct
{
  uint8_t enc     : 1;                        
  uint8_t id      : 1;                        
} ble_gap_sec_kdist_t;
 
 
typedef struct
{
  uint8_t               bond      : 1;             
  uint8_t               mitm      : 1;             
  uint8_t               lesc      : 1;             
  uint8_t               keypress  : 1;             
  uint8_t               io_caps   : 3;             
  uint8_t               oob       : 1;             
  uint8_t               min_key_size;              
  uint8_t               max_key_size;              
  ble_gap_sec_kdist_t   kdist_own;                 
  ble_gap_sec_kdist_t   kdist_peer;                
} ble_gap_sec_params_t;
 
 
typedef struct
{
  uint8_t   ltk[BLE_GAP_SEC_KEY_LEN];   
  uint8_t   lesc : 1;                   
  uint8_t   auth : 1;                   
  uint8_t   ltk_len : 6;                
} ble_gap_enc_info_t;
 
 
typedef struct
{
  uint16_t  ediv;                       
  uint8_t   rand[BLE_GAP_SEC_RAND_LEN]; 
} ble_gap_master_id_t;
 
 
typedef struct
{
  uint8_t   pk[BLE_GAP_LESC_P256_PK_LEN];        
} ble_gap_lesc_p256_pk_t;
 
 
typedef struct
{
  uint8_t   key[BLE_GAP_LESC_DHKEY_LEN];        
} ble_gap_lesc_dhkey_t;
 
 
typedef struct
{
  ble_gap_addr_t  addr;                          
  uint8_t         r[BLE_GAP_SEC_KEY_LEN];        
  uint8_t         c[BLE_GAP_SEC_KEY_LEN];        
} ble_gap_lesc_oob_data_t;
 
 
typedef struct
{
  ble_gap_addr_t        peer_addr;              
  uint8_t               role;                   
  ble_gap_conn_params_t conn_params;            
  uint8_t               adv_handle;             
} ble_gap_evt_connected_t;
 
 
typedef struct
{
  uint8_t reason;                               
} ble_gap_evt_disconnected_t;
 
 
typedef struct
{
  ble_gap_conn_params_t conn_params;            
} ble_gap_evt_conn_param_update_t;
 
typedef struct
{
  ble_gap_phys_t peer_preferred_phys;            
} ble_gap_evt_phy_update_request_t;
 
typedef struct
{
  uint8_t status;                               
  uint8_t tx_phy;                               
  uint8_t rx_phy;                               
} ble_gap_evt_phy_update_t;
 
typedef struct
{
  ble_gap_sec_params_t peer_params;             
} ble_gap_evt_sec_params_request_t;
 
 
typedef struct
{
  ble_gap_addr_t      peer_addr;                     
  ble_gap_master_id_t master_id;                     
  uint8_t             enc_info  : 1;                 
  uint8_t             id_info   : 1;                 
} ble_gap_evt_sec_info_request_t;
 
typedef struct
{
  uint8_t passkey[BLE_GAP_PASSKEY_LEN];         
  uint8_t match_request : 1;                    
} ble_gap_evt_passkey_display_t;
 
typedef struct
{
  uint8_t kp_not;         
} ble_gap_evt_key_pressed_t;
 
 
typedef struct
{
  uint8_t key_type;                             
} ble_gap_evt_auth_key_request_t;
 
typedef struct
{
  ble_gap_lesc_p256_pk_t *p_pk_peer;  
  uint8_t oobd_req       :1;          
} ble_gap_evt_lesc_dhkey_request_t;
 
 
typedef struct
{
  uint8_t lv1 : 1;                              
  uint8_t lv2 : 1;                              
  uint8_t lv3 : 1;                              
  uint8_t lv4 : 1;                              
} ble_gap_sec_levels_t;
 
 
typedef struct
{
  ble_gap_enc_info_t    enc_info;             
  ble_gap_master_id_t   master_id;            
} ble_gap_enc_key_t;
 
 
typedef struct
{
  ble_gap_irk_t         id_info;              
  ble_gap_addr_t        id_addr_info;         
} ble_gap_id_key_t;
 
 
typedef struct
{
  ble_gap_enc_key_t      *p_enc_key;           
  ble_gap_id_key_t       *p_id_key;            
  ble_gap_lesc_p256_pk_t *p_pk;                
} ble_gap_sec_keys_t;
 
 
typedef struct
{
  ble_gap_sec_keys_t            keys_own;     
  ble_gap_sec_keys_t            keys_peer;    
} ble_gap_sec_keyset_t;
 
 
typedef struct
{
  uint16_t max_tx_octets;   
  uint16_t max_rx_octets;   
  uint16_t max_tx_time_us;  
  uint16_t max_rx_time_us;  
} ble_gap_data_length_params_t;
 
 
typedef struct
{
  uint16_t tx_payload_limited_octets; 
  uint16_t rx_payload_limited_octets; 
  uint16_t tx_rx_time_limited_us;     
} ble_gap_data_length_limitation_t;
 
 
typedef struct
{
  uint8_t               auth_status;            
  uint8_t               error_src : 2;          
  uint8_t               bonded : 1;             
  uint8_t               lesc : 1;               
  ble_gap_sec_levels_t  sm1_levels;             
  ble_gap_sec_kdist_t   kdist_own;              
  ble_gap_sec_kdist_t   kdist_peer;             
} ble_gap_evt_auth_status_t;
 
 
typedef struct
{
  ble_gap_conn_sec_t conn_sec;                  
} ble_gap_evt_conn_sec_update_t;
 
 
typedef struct
{
  uint8_t src;                                  
} ble_gap_evt_timeout_t;
 
 
typedef struct
{
  int8_t  rssi;                                 
  uint8_t ch_index;                             
} ble_gap_evt_rssi_changed_t;
 
typedef struct
{
  uint8_t             reason;                         
  uint8_t             adv_handle;                     
  uint8_t             num_completed_adv_events;       
} ble_gap_evt_adv_set_terminated_t;
 
typedef struct
{
  uint8_t                 adv_handle;        
  int8_t                  rssi;              
  ble_gap_addr_t          peer_addr;         
} ble_gap_evt_scan_req_report_t;
 
typedef struct
{
  ble_gap_data_length_params_t peer_params; 
} ble_gap_evt_data_length_update_request_t;
 
typedef struct
{
  ble_gap_data_length_params_t effective_params;  
} ble_gap_evt_data_length_update_t;
 
 
typedef struct
{
  uint16_t conn_handle;                                     
  union                                                     
  {
    ble_gap_evt_connected_t                   connected;                    
    ble_gap_evt_disconnected_t                disconnected;                 
    ble_gap_evt_conn_param_update_t           conn_param_update;            
    ble_gap_evt_sec_params_request_t          sec_params_request;           
    ble_gap_evt_sec_info_request_t            sec_info_request;             
    ble_gap_evt_passkey_display_t             passkey_display;              
    ble_gap_evt_key_pressed_t                 key_pressed;                  
    ble_gap_evt_auth_key_request_t            auth_key_request;             
    ble_gap_evt_lesc_dhkey_request_t          lesc_dhkey_request;           
    ble_gap_evt_auth_status_t                 auth_status;                  
    ble_gap_evt_conn_sec_update_t             conn_sec_update;              
    ble_gap_evt_timeout_t                     timeout;                      
    ble_gap_evt_rssi_changed_t                rssi_changed;                 
    ble_gap_evt_adv_set_terminated_t          adv_set_terminated;           
    ble_gap_evt_scan_req_report_t             scan_req_report;              
    ble_gap_evt_phy_update_request_t          phy_update_request;           
    ble_gap_evt_phy_update_t                  phy_update;                   
    ble_gap_evt_data_length_update_request_t  data_length_update_request;   
    ble_gap_evt_data_length_update_t          data_length_update;           
  } params;                                                                 
} ble_gap_evt_t;
 
 
typedef struct
{
  uint8_t  conn_count;       
  uint16_t event_length;     
} ble_gap_conn_cfg_t;
 
 
typedef struct
{
  uint8_t adv_set_count;      
  uint8_t periph_role_count;  
} ble_gap_cfg_role_count_t;
 
 
typedef struct
{
  ble_gap_conn_sec_mode_t  write_perm;   
  uint8_t                  vloc:2;       
  uint8_t                 *p_value;      
  uint16_t                 current_len;  
  uint16_t                 max_len;      
} ble_gap_cfg_device_name_t;
 
 
typedef struct
{
  uint8_t include_cfg;     
} ble_gap_cfg_ppcp_incl_cfg_t;
 
 
typedef struct
{
  uint8_t include_cfg;     
} ble_gap_cfg_car_incl_cfg_t;
 
typedef union
{
  ble_gap_cfg_role_count_t      role_count_cfg;   
  ble_gap_cfg_device_name_t     device_name_cfg;  
  ble_gap_cfg_ppcp_incl_cfg_t   ppcp_include_cfg; 
  ble_gap_cfg_car_incl_cfg_t    car_include_cfg;  
} ble_gap_cfg_t;
 
 
typedef struct
{
  uint16_t conn_handle;                   
  uint8_t ch_map[5];                      
} ble_gap_opt_ch_map_t;
 
 
typedef struct
{
  uint16_t   conn_handle;    
  uint8_t    disable;        
} ble_gap_opt_slave_latency_disable_t;
 
 
typedef struct
{
  uint8_t const * p_passkey;                    
} ble_gap_opt_passkey_t;
 
 
typedef struct
{
  uint16_t   conn_handle;                       
  uint16_t   auth_payload_timeout;              
} ble_gap_opt_auth_payload_timeout_t;
 
typedef union
{
  ble_gap_opt_ch_map_t                  ch_map;                    
  ble_gap_opt_passkey_t                 passkey;                   
  ble_gap_opt_auth_payload_timeout_t    auth_payload_timeout;      
  ble_gap_opt_slave_latency_disable_t   slave_latency_disable;     
} ble_gap_opt_t;
 
SVCALL(SD_BLE_GAP_ADDR_SET, uint32_t, sd_ble_gap_addr_set(ble_gap_addr_t const *p_addr));
 
 
SVCALL(SD_BLE_GAP_ADDR_GET, uint32_t, sd_ble_gap_addr_get(ble_gap_addr_t *p_addr));
 
 
SVCALL(SD_BLE_GAP_ADV_ADDR_GET, uint32_t, sd_ble_gap_adv_addr_get(uint8_t adv_handle, ble_gap_addr_t *p_addr));
 
 
SVCALL(SD_BLE_GAP_WHITELIST_SET, uint32_t, sd_ble_gap_whitelist_set(ble_gap_addr_t const * const * pp_wl_addrs, uint8_t len));
 
 
SVCALL(SD_BLE_GAP_DEVICE_IDENTITIES_SET, uint32_t, sd_ble_gap_device_identities_set(ble_gap_id_key_t const * const * pp_id_keys, ble_gap_irk_t const * const * pp_local_irks, uint8_t len));
 
 
SVCALL(SD_BLE_GAP_PRIVACY_SET, uint32_t, sd_ble_gap_privacy_set(ble_gap_privacy_params_t const *p_privacy_params));
 
 
SVCALL(SD_BLE_GAP_PRIVACY_GET, uint32_t, sd_ble_gap_privacy_get(ble_gap_privacy_params_t *p_privacy_params));
 
 
SVCALL(SD_BLE_GAP_ADV_SET_CONFIGURE, uint32_t, sd_ble_gap_adv_set_configure(uint8_t *p_adv_handle, ble_gap_adv_data_t const *p_adv_data, ble_gap_adv_params_t const *p_adv_params));
 
 
SVCALL(SD_BLE_GAP_ADV_START, uint32_t, sd_ble_gap_adv_start(uint8_t adv_handle, uint8_t conn_cfg_tag));
 
 
SVCALL(SD_BLE_GAP_ADV_STOP, uint32_t, sd_ble_gap_adv_stop(uint8_t adv_handle));
 
 
SVCALL(SD_BLE_GAP_CONN_PARAM_UPDATE, uint32_t, sd_ble_gap_conn_param_update(uint16_t conn_handle, ble_gap_conn_params_t const *p_conn_params));
 
 
SVCALL(SD_BLE_GAP_DISCONNECT, uint32_t, sd_ble_gap_disconnect(uint16_t conn_handle, uint8_t hci_status_code));
 
 
SVCALL(SD_BLE_GAP_TX_POWER_SET, uint32_t, sd_ble_gap_tx_power_set(uint8_t role, uint16_t handle, int8_t tx_power));
 
 
SVCALL(SD_BLE_GAP_APPEARANCE_SET, uint32_t, sd_ble_gap_appearance_set(uint16_t appearance));
 
 
SVCALL(SD_BLE_GAP_APPEARANCE_GET, uint32_t, sd_ble_gap_appearance_get(uint16_t *p_appearance));
 
 
SVCALL(SD_BLE_GAP_PPCP_SET, uint32_t, sd_ble_gap_ppcp_set(ble_gap_conn_params_t const *p_conn_params));
 
 
SVCALL(SD_BLE_GAP_PPCP_GET, uint32_t, sd_ble_gap_ppcp_get(ble_gap_conn_params_t *p_conn_params));
 
 
SVCALL(SD_BLE_GAP_DEVICE_NAME_SET, uint32_t, sd_ble_gap_device_name_set(ble_gap_conn_sec_mode_t const *p_write_perm, uint8_t const *p_dev_name, uint16_t len));
 
 
SVCALL(SD_BLE_GAP_DEVICE_NAME_GET, uint32_t, sd_ble_gap_device_name_get(uint8_t *p_dev_name, uint16_t *p_len));
 
 
SVCALL(SD_BLE_GAP_AUTHENTICATE, uint32_t, sd_ble_gap_authenticate(uint16_t conn_handle, ble_gap_sec_params_t const *p_sec_params));
 
 
SVCALL(SD_BLE_GAP_SEC_PARAMS_REPLY, uint32_t, sd_ble_gap_sec_params_reply(uint16_t conn_handle, uint8_t sec_status, ble_gap_sec_params_t const *p_sec_params, ble_gap_sec_keyset_t const *p_sec_keyset));
 
 
SVCALL(SD_BLE_GAP_AUTH_KEY_REPLY, uint32_t, sd_ble_gap_auth_key_reply(uint16_t conn_handle, uint8_t key_type, uint8_t const *p_key));
 
 
SVCALL(SD_BLE_GAP_LESC_DHKEY_REPLY, uint32_t, sd_ble_gap_lesc_dhkey_reply(uint16_t conn_handle, uint8_t sec_status, ble_gap_lesc_dhkey_t const *p_dhkey));
 
 
SVCALL(SD_BLE_GAP_KEYPRESS_NOTIFY, uint32_t, sd_ble_gap_keypress_notify(uint16_t conn_handle, uint8_t kp_not));
 
 
SVCALL(SD_BLE_GAP_LESC_OOB_DATA_GET, uint32_t, sd_ble_gap_lesc_oob_data_get(uint16_t conn_handle, ble_gap_lesc_p256_pk_t const *p_pk_own, ble_gap_lesc_oob_data_t *p_oobd_own));
 
 
SVCALL(SD_BLE_GAP_LESC_OOB_DATA_SET, uint32_t, sd_ble_gap_lesc_oob_data_set(uint16_t conn_handle, ble_gap_lesc_oob_data_t const *p_oobd_own, ble_gap_lesc_oob_data_t const *p_oobd_peer));
 
 
SVCALL(SD_BLE_GAP_SEC_INFO_REPLY, uint32_t, sd_ble_gap_sec_info_reply(uint16_t conn_handle, ble_gap_enc_info_t const *p_enc_info));
 
 
SVCALL(SD_BLE_GAP_CONN_SEC_GET, uint32_t, sd_ble_gap_conn_sec_get(uint16_t conn_handle, ble_gap_conn_sec_t *p_conn_sec));
 
 
SVCALL(SD_BLE_GAP_PHY_UPDATE, uint32_t, sd_ble_gap_phy_update(uint16_t conn_handle, ble_gap_phys_t const *p_gap_phys));
 
 
SVCALL(SD_BLE_GAP_DATA_LENGTH_UPDATE, uint32_t, sd_ble_gap_data_length_update(uint16_t conn_handle, ble_gap_data_length_params_t const *p_dl_params, ble_gap_data_length_limitation_t *p_dl_limitation));
 
 
SVCALL(SD_BLE_GAP_NEXT_CONN_EVT_COUNTER_GET, uint32_t, sd_ble_gap_next_conn_evt_counter_get(uint16_t conn_handle, uint16_t * p_counter));
 
 
SVCALL(SD_BLE_GAP_RSSI_START, uint32_t, sd_ble_gap_rssi_start(uint16_t conn_handle, uint8_t threshold_dbm, uint8_t skip_count));
 
 
SVCALL(SD_BLE_GAP_RSSI_STOP, uint32_t, sd_ble_gap_rssi_stop(uint16_t conn_handle));
 
 
SVCALL(SD_BLE_GAP_RSSI_GET, uint32_t, sd_ble_gap_rssi_get(uint16_t conn_handle, int8_t *p_rssi, uint8_t *p_ch_index));
 
 
#ifdef __cplusplus
}
#endif
#endif // BLE_GAP_H__