Merge pull request #12730 from LDong-Arm/gap_deprecation_cleanup

BLE Gap deprecation cleanup/rework

features/FEATURE_BLE/ble/BLE.h

@@ -465,12 +465,6 @@ class BLE {
  bool event_signaled;
 };
 
-/**
- * @deprecated This type alias is retained for the sake of compatibility with
- * older code. This will be dropped at some point.
- */
-typedef BLE BLEDevice;
-
 /**
  * @namespace ble Entry namespace for all %BLE API definitions.
  */

features/FEATURE_BLE/ble/BLEInstanceBase.h

@@ -240,17 +240,6 @@ class BLEInstanceBase
  virtual const SecurityManager &getSecurityManager(void) const = 0;
 #endif // BLE_FEATURE_SECURITY
 
- /**
- * Process pending events present in the vendor subsystem; then, put the MCU
- * to sleep until an external source wakes it up.
- *
- * @attention This function is deprecated in the BLE class. It will be
- * removed from this interface once it is removed from BLE.
- *
- * @see BLE::waitForEvent() BLE::processEvents()
- */
- virtual void waitForEvent(void) = 0;
-
 private:
  // this class is not a value type.
  // prohibit copy construction and copy assignement

features/FEATURE_BLE/ble/BLETypes.h

@@ -831,6 +831,70 @@ struct coded_symbol_per_bit_t :SafeEnum<coded_symbol_per_bit_t, uint8_t> {
  SafeEnum<coded_symbol_per_bit_t, uint8_t>(value) { }
 };
 
+
+/**
+ * Representation of a whitelist of addresses.
+ */
+struct whitelist_t {
+ /**
+ * BLE address representation.
+ *
+ * It contains an address-type (peer_address_type_t) and the address value
+ * (address_t).
+ */
+ struct entry_t {
+ /**
+ * Construct an entry_t object with the supplied type and address.
+ *
+ * @param[in] typeIn The peer address type.
+ * @param[in] addressIn The peer address.
+ *
+ * @post type is equal to typeIn and address is equal to the content
+ * present in addressIn.
+ */
+ entry_t(peer_address_type_t typeIn, const address_t &addressIn) :
+ type(typeIn),
+ address(addressIn)
+ { }
+
+ /**
+ * Empty constructor.
+ *
+ * @note The address constructed with the empty constructor is not
+ * valid.
+ *
+ * @post type is equal to PUBLIC and the address value is equal to
+ * 00:00:00:00:00:00
+ */
+ entry_t(void) : type(), address() { }
+
+ /**
+ * Type of the peer address.
+ */
+ peer_address_type_t type;
+
+ /**
+ * Value of the peer address.
+ */
+ address_t address;
+ };
+
+ /**
+ * Pointer to the array of the addresses composing the whitelist.
+ */
+ entry_t *addresses;
+
+ /**
+ * Number addresses in this whitelist.
+ */
+ uint8_t size;
+
+ /**
+ * Capacity of the array holding the addresses.
+ */
+ uint8_t capacity;
+};
+
 } // namespace ble
 
 /**