ble.h

/*
 * Copyright (c) 2012 - 2017, 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_H__
#define BLE_H__

#include "ble_ranges.h"
#include "ble_types.h"
#include "ble_gap.h"
#include "ble_l2cap.h"
#include "ble_gatt.h"
#include "ble_gattc.h"
#include "ble_gatts.h"

#ifdef __cplusplus
extern "C" {
#endif

enum BLE_COMMON_SVCS
{
  SD_BLE_ENABLE = BLE_SVC_BASE,         
  SD_BLE_EVT_GET,                       
  SD_BLE_UUID_VS_ADD,                   
  SD_BLE_UUID_DECODE,                   
  SD_BLE_UUID_ENCODE,                   
  SD_BLE_VERSION_GET,                   
  SD_BLE_USER_MEM_REPLY,                
  SD_BLE_OPT_SET,                       
  SD_BLE_OPT_GET,                       
  SD_BLE_CFG_SET,                       
};

enum BLE_COMMON_EVTS
{
  BLE_EVT_USER_MEM_REQUEST = BLE_EVT_BASE,   
  BLE_EVT_USER_MEM_RELEASE,                  
};

enum BLE_CONN_CFGS
{
    BLE_CONN_CFG_GAP = BLE_CONN_CFG_BASE,  
    BLE_CONN_CFG_GATTC,                    
    BLE_CONN_CFG_GATTS,                    
    BLE_CONN_CFG_GATT,                     
    BLE_CONN_CFG_L2CAP,                    
};

enum BLE_COMMON_CFGS
{
  BLE_COMMON_CFG_VS_UUID = BLE_CFG_BASE, 
};

enum BLE_COMMON_OPTS
{
  BLE_COMMON_OPT_PA_LNA = BLE_OPT_BASE,      
  BLE_COMMON_OPT_CONN_EVT_EXT,               
};

#define BLE_EVT_PTR_ALIGNMENT    4

#define BLE_MAX(a, b) ((a) < (b) ? (b) : (a))

#define BLE_EVT_LEN_MAX(ATT_MTU) (BLE_MAX( \
  sizeof(ble_evt_t), \
  BLE_MAX( \
    offsetof(ble_evt_t, evt.gattc_evt.params.rel_disc_rsp.includes) + ((ATT_MTU) - 2) / 6 * sizeof(ble_gattc_include_t), \
    offsetof(ble_evt_t, evt.gattc_evt.params.attr_info_disc_rsp.info.attr_info16) + ((ATT_MTU) - 2) / 4 * sizeof(ble_gattc_attr_info16_t) \
  ) \
))

#define BLE_USER_MEM_TYPE_INVALID               0x00  
#define BLE_USER_MEM_TYPE_GATTS_QUEUED_WRITES   0x01  
#define BLE_UUID_VS_COUNT_DEFAULT 10  
#define BLE_UUID_VS_COUNT_MAX     254 
#define BLE_CONN_CFG_TAG_DEFAULT  0    
typedef struct
{
  uint8_t          *p_mem;      
  uint16_t          len;        
} ble_user_mem_block_t;

typedef struct
{
  uint8_t                     type;     
} ble_evt_user_mem_request_t;

typedef struct
{
  uint8_t                     type;       
  ble_user_mem_block_t        mem_block;  
} ble_evt_user_mem_release_t;

typedef struct
{
  uint16_t conn_handle;                                 
  union
  {
    ble_evt_user_mem_request_t      user_mem_request;    
    ble_evt_user_mem_release_t      user_mem_release;    
  } params;                                              
} ble_common_evt_t;

typedef struct
{
  uint16_t evt_id;                
  uint16_t evt_len;               
} ble_evt_hdr_t;

typedef struct
{
  ble_evt_hdr_t header;           
  union
  {
    ble_common_evt_t  common_evt; 
    ble_gap_evt_t     gap_evt;    
    ble_gattc_evt_t   gattc_evt;  
    ble_gatts_evt_t   gatts_evt;  
    ble_l2cap_evt_t   l2cap_evt;  
  } evt;                          
} ble_evt_t;


typedef struct
{
  uint8_t   version_number;    
  uint16_t  company_id;        
  uint16_t  subversion_number; 
} ble_version_t;

typedef struct
{
     uint8_t enable :1;      
     uint8_t active_high :1; 
     uint8_t gpio_pin :6;    
} ble_pa_lna_cfg_t;

typedef struct
{
   ble_pa_lna_cfg_t pa_cfg;   
   ble_pa_lna_cfg_t lna_cfg;  
   uint8_t ppi_ch_id_set;     
   uint8_t ppi_ch_id_clr;     
   uint8_t gpiote_ch_id;      
} ble_common_opt_pa_lna_t;

typedef struct
{
   uint8_t enable : 1; 
} ble_common_opt_conn_evt_ext_t;

typedef union
{
  ble_common_opt_pa_lna_t       pa_lna;        
  ble_common_opt_conn_evt_ext_t conn_evt_ext;  
} ble_common_opt_t;

typedef union
{
  ble_common_opt_t  common_opt;         
  ble_gap_opt_t     gap_opt;            
} ble_opt_t;

typedef struct
{
  uint8_t              conn_cfg_tag;        
  union {
    ble_gap_conn_cfg_t   gap_conn_cfg;      
    ble_gattc_conn_cfg_t gattc_conn_cfg;    
    ble_gatts_conn_cfg_t gatts_conn_cfg;    
    ble_gatt_conn_cfg_t  gatt_conn_cfg;     
    ble_l2cap_conn_cfg_t l2cap_conn_cfg;    
  } params;                                 
} ble_conn_cfg_t;

typedef struct
{
  uint8_t vs_uuid_count; 
} ble_common_cfg_vs_uuid_t;

typedef union
{
  ble_common_cfg_vs_uuid_t  vs_uuid_cfg;  
} ble_common_cfg_t;

typedef union
{
  ble_conn_cfg_t    conn_cfg;   
  ble_common_cfg_t  common_cfg; 
  ble_gap_cfg_t     gap_cfg;    
  ble_gatts_cfg_t   gatts_cfg;  
} ble_cfg_t;

SVCALL(SD_BLE_ENABLE, uint32_t, sd_ble_enable(uint32_t * p_app_ram_base));

SVCALL(SD_BLE_CFG_SET, uint32_t, sd_ble_cfg_set(uint32_t cfg_id, ble_cfg_t const * p_cfg, uint32_t app_ram_base));

SVCALL(SD_BLE_EVT_GET, uint32_t, sd_ble_evt_get(uint8_t *p_dest, uint16_t *p_len));


SVCALL(SD_BLE_UUID_VS_ADD, uint32_t, sd_ble_uuid_vs_add(ble_uuid128_t const *p_vs_uuid, uint8_t *p_uuid_type));


SVCALL(SD_BLE_UUID_DECODE, uint32_t, sd_ble_uuid_decode(uint8_t uuid_le_len, uint8_t const *p_uuid_le, ble_uuid_t *p_uuid));


SVCALL(SD_BLE_UUID_ENCODE, uint32_t, sd_ble_uuid_encode(ble_uuid_t const *p_uuid, uint8_t *p_uuid_le_len, uint8_t *p_uuid_le));


SVCALL(SD_BLE_VERSION_GET, uint32_t, sd_ble_version_get(ble_version_t *p_version));


SVCALL(SD_BLE_USER_MEM_REPLY, uint32_t, sd_ble_user_mem_reply(uint16_t conn_handle, ble_user_mem_block_t const *p_block));

SVCALL(SD_BLE_OPT_SET, uint32_t, sd_ble_opt_set(uint32_t opt_id, ble_opt_t const *p_opt));


SVCALL(SD_BLE_OPT_GET, uint32_t, sd_ble_opt_get(uint32_t opt_id, ble_opt_t *p_opt));

#ifdef __cplusplus
}
#endif
#endif /* BLE_H__ */