BLEDevice.h

/*
 * BLEDevice.h
 *
 *  Created on: Mar 16, 2017
 *      Author: kolban
 */

#ifndef MAIN_BLEDevice_H_
#define MAIN_BLEDevice_H_
#include "soc/soc_caps.h"
#if SOC_BLE_SUPPORTED

#include "sdkconfig.h"
#if defined(CONFIG_BLUEDROID_ENABLED)
#include <esp_gap_ble_api.h>  // ESP32 BLE
#include <esp_gattc_api.h>    // ESP32 BLE
#include <map>                // Part of C++ STL
#include <string>
#include <esp_bt.h>

#include "BLEServer.h"
#include "BLEClient.h"
#include "BLEUtils.h"
#include "BLEScan.h"
#include "BLEAddress.h"

/**
 * @brief BLE functions.
 */
typedef void (*gap_event_handler)(esp_gap_ble_cb_event_t event, esp_ble_gap_cb_param_t *param);
typedef void (*gattc_event_handler)(esp_gattc_cb_event_t event, esp_gatt_if_t gattc_if, esp_ble_gattc_cb_param_t *param);
typedef void (*gatts_event_handler)(esp_gatts_cb_event_t event, esp_gatt_if_t gattc_if, esp_ble_gatts_cb_param_t *param);

class BLEDevice {
public:
  static BLEClient *createClient();                                                               // Create a new BLE client.
  static BLEServer *createServer();                                                               // Create a new BLE server.
  static BLEAddress getAddress();                                                                 // Retrieve our own local BD address.
  static BLEScan *getScan();                                                                      // Get the scan object
  static String getValue(BLEAddress bdAddress, BLEUUID serviceUUID, BLEUUID characteristicUUID);  // Get the value of a characteristic of a service on a server.
  static void init(String deviceName);                                                            // Initialize the local BLE environment.
  static void setPower(esp_power_level_t powerLevel, esp_ble_power_type_t powerType = ESP_BLE_PWR_TYPE_DEFAULT);  // Set our power level.
  static void setValue(
    BLEAddress bdAddress, BLEUUID serviceUUID, BLEUUID characteristicUUID, String value
  );                                                // Set the value of a characteristic on a service on a server.
  static String toString();                         // Return a string representation of our device.
  static void whiteListAdd(BLEAddress address);     // Add an entry to the BLE white list.
  static void whiteListRemove(BLEAddress address);  // Remove an entry from the BLE white list.
  static void setEncryptionLevel(esp_ble_sec_act_t level);
  static void setSecurityCallbacks(BLESecurityCallbacks *pCallbacks);
  static esp_err_t setMTU(uint16_t mtu);
  static uint16_t getMTU();
  static bool getInitialized();  // Returns the state of the device, is it initialized or not?
  /* move advertising to BLEDevice for saving ram and flash in beacons */
  static BLEAdvertising *getAdvertising();
  static void startAdvertising();
  static void stopAdvertising();
  static uint16_t m_appId;
  /* multi connect */
  static std::map<uint16_t, conn_status_t> getPeerDevices(bool client);
  static void addPeerDevice(void *peer, bool is_client, uint16_t conn_id);
  static void updatePeerDevice(void *peer, bool _client, uint16_t conn_id);
  static void removePeerDevice(uint16_t conn_id, bool client);
  static BLEClient *getClientByGattIf(uint16_t conn_id);
  static void setCustomGapHandler(gap_event_handler handler);
  static void setCustomGattcHandler(gattc_event_handler handler);
  static void setCustomGattsHandler(gatts_event_handler handler);
  static void deinit(bool release_memory = false);
  static uint16_t m_localMTU;
  static esp_ble_sec_act_t m_securityLevel;

private:
  static BLEServer *m_pServer;
  static BLEScan *m_pScan;
  static BLEClient *m_pClient;
  static BLESecurityCallbacks *m_securityCallbacks;
  static BLEAdvertising *m_bleAdvertising;
  static esp_gatt_if_t getGattcIF();
  static std::map<uint16_t, conn_status_t> m_connectedClientsMap;
  static portMUX_TYPE mux;

  static void gattClientEventHandler(esp_gattc_cb_event_t event, esp_gatt_if_t gattc_if, esp_ble_gattc_cb_param_t *param);

  static void gattServerEventHandler(esp_gatts_cb_event_t event, esp_gatt_if_t gatts_if, esp_ble_gatts_cb_param_t *param);

  static void gapEventHandler(esp_gap_ble_cb_event_t event, esp_ble_gap_cb_param_t *param);

public:
  /* custom gap and gatt handlers for flexibility */
  static gap_event_handler m_customGapHandler;
  static gattc_event_handler m_customGattcHandler;
  static gatts_event_handler m_customGattsHandler;

};  // class BLE

#endif /* CONFIG_BLUEDROID_ENABLED */
#endif /* SOC_BLE_SUPPORTED */
#endif /* MAIN_BLEDevice_H_ */