m_coms_ble.h

/*$$$LICENCE_NORDIC_STANDARD<2016>$$$*/

#ifndef __M_COMS_BLE_H__
#define __M_COMS_BLE_H__

#include <stdbool.h>
#include <stdint.h>

#include "app_scheduler.h"
#include "app_util.h"
#include "ble_types.h"
#include "ble_hids.h"
#include "ble_gap.h"
#include "ble_gatts.h"
#include "peer_manager.h"

struct ble_hid_db_s;

#define BOOT_KEYBOARD_LEN 8 
typedef enum
{
 M_COMS_BLE_EVT_CONNECTED, 
 M_COMS_BLE_EVT_DISCONNECTED, 
 M_COMS_BLE_EVT_DATA_RECEIVED, 
 M_COMS_BLE_EVT_READ_REQ, 
 M_COMS_BLE_EVT_CONN_UPDATE, 
 M_COMS_BLE_EVT_CONN_SECURED, 
 M_COMS_BLE_EVT_ADV, 
 M_COMS_BLE_EVT_ADV_BONDABLE, 
 M_COMS_BLE_EVT_ADV_TIMEOUT, 
 M_COMS_BLE_EVT_ADDR_CHANGED, 
 M_COMS_BLE_EVT_PASSKEY_REQ, 
 M_COMS_BLE_EVT_OOBKEY_REQ, 
 M_COMS_BLE_EVT_ALERT, 
 M_COMS_BLE_EVT_TX_COMPLETE, 
 M_COMS_BLE_EVT_MTU_CHANGED, 
 M_COMS_BLE_EVT_SHUTDOWN 
} m_coms_ble_evt_type_t;

typedef struct
{
 uint8_t interface_idx; 
 uint8_t report_type; 
 uint8_t report_idx; 
 uint8_t len; 
 uint8_t * data; 
} m_coms_ble_evt_data_recv_t;

typedef struct
{
 uint8_t interface_idx; 
 uint8_t report_idx; 
} m_coms_ble_evt_read_req_t;

typedef struct
{
 uint16_t min_conn_interval; 
 uint16_t max_conn_interval; 
 uint16_t slave_latency; 
 uint16_t supervision_timeout; 
} m_coms_ble_evt_conn_update_t;

typedef struct
{
 uint8_t level; 
 uint16_t conn_handle; 
} m_coms_ble_evt_alert_t;

typedef struct
{
 uint8_t count; 
} m_coms_ble_evt_tx_complete_t;

typedef struct
{
 uint8_t effective_mtu; 
} m_coms_ble_evt_mtu_changed_t;

typedef struct
{
 uint16_t conn_handle; 
 pm_peer_id_t peer_id; 
} m_coms_ble_evt_conn_data_t;

typedef struct
{
 pm_peer_id_t peer_id; 
} m_coms_ble_evt_adv_data_t;

typedef struct
{
 m_coms_ble_evt_type_t type;
 union
 {
 m_coms_ble_evt_data_recv_t data_received;
 m_coms_ble_evt_read_req_t read_req;
 m_coms_ble_evt_conn_update_t conn_update;
 m_coms_ble_evt_alert_t alert;
 m_coms_ble_evt_tx_complete_t tx_complete;
 m_coms_ble_evt_mtu_changed_t mtu_changed;
 m_coms_ble_evt_conn_data_t conn_data;
 m_coms_ble_evt_adv_data_t adv_data;
 } data;
} m_coms_ble_evt_t;

typedef enum
{
 ble_boot_pkt_keyboard = 0x01, 
 ble_boot_pkt_mouse = 0x02, 
 ble_boot_pkt_none = 0x80, 
} m_coms_ble_hid_boot_type_t;

typedef enum
{
 hid_report_type_input = BLE_HIDS_REP_TYPE_INPUT,
 hid_report_type_output = BLE_HIDS_REP_TYPE_OUTPUT,
 hid_report_type_feature = BLE_HIDS_REP_TYPE_FEATURE
} m_coms_hid_report_type_t;

typedef union
{
 struct
 {
 uint8_t keys[BOOT_KEYBOARD_LEN]; 
 } keyboard_data;
 struct
 {
 uint8_t buttons; 
 int8_t x_delta; 
 int8_t y_delta; 
 } mouse_data;
} m_coms_hid_boot_pkt_t;

typedef void (*m_coms_ble_boot_mode_callback)(m_coms_hid_boot_pkt_t * p_boot_pkt,
 m_coms_ble_hid_boot_type_t * p_pkt_type,
 const uint8_t * p_data,
 uint8_t p_len,
 uint8_t p_hid_interface,
 uint8_t p_report_idx);

typedef struct
{
 uint16_t interval; 
 uint16_t timeout; 
} m_coms_ble_adv_params_t;

typedef struct
{
 bool directed_adv; 
 bool change_address; 
 bool reconnect_all; 
 bool bond_reconnect_all; 
} m_coms_ble_bond_params_t;

typedef struct
{
 uint8_t io_capabilities; 
} m_coms_ble_sec_params_t;

typedef struct
{
 char * device_name; 
 char * manufacturer_name; 
 char * hw_revision; 
 char * fw_revision; 
 char * serial_number; 
 uint16_t pnp_vendor_id; 
 uint8_t pnp_vendor_id_src; 
 uint16_t pnp_product_id; 
 uint16_t pnp_product_version;
} m_coms_ble_device_info_t;

typedef struct
{
 m_coms_ble_device_info_t device_info; 
 m_coms_ble_adv_params_t adv_params; 
 m_coms_ble_bond_params_t bond_params; 
 m_coms_ble_sec_params_t sec_params; 
 uint16_t appearance; 
 ble_gap_conn_params_t conn_params; 
 uint16_t base_hid_version; 
 uint8_t hid_country_code; 
 uint8_t hids_flags; 
 app_sched_event_handler_t event_handler; 
 m_coms_ble_boot_mode_callback boot_mode_callback; 
} m_coms_ble_params_t;

ret_code_t m_coms_ble_init(const m_coms_ble_params_t * p_ble_params,
 const struct ble_hid_db_s * p_hid_db,
 bool delete_bonds);

ret_code_t m_coms_ble_oobkey_set(uint8_t * p_key);

ret_code_t m_coms_ble_bonding_start(void);

ret_code_t m_coms_ble_hid_report_send(uint8_t * p_data,
 uint8_t p_len,
 uint8_t p_hid_interface,
 uint8_t p_report_idx);

ret_code_t m_coms_ble_read_respond(uint8_t *p_data, uint8_t p_len);

ret_code_t m_coms_ble_battery_level_update(uint8_t p_batt_level);

ret_code_t m_coms_ble_disconnect(void);

ret_code_t m_coms_ble_shutdown(void);

bool m_coms_ble_bond_stored(void);

ret_code_t m_coms_ble_bond_clear(void);

ret_code_t m_coms_ble_advertise(bool bondable);

ret_code_t m_coms_ble_sl_disable(void);

ret_code_t m_coms_ble_sl_enable(void);

#endif /* __M_COMS_BLE_H__ */