Merge pull request ARMmbed#30 from pan-/sm-privacy

BLE: Add Gap privacy interfaces.

features/FEATURE_BLE/ble/BLEProtocol.h

@@ -59,18 +59,51 @@ namespace BLEProtocol {
  */
  PUBLIC = 0,
 
+ /**
+ * Random address.
+ *
+ * Use Gap::getRandomAddressType to retrieve the type of the random
+ * address.
+ */
+ RANDOM,
+
+ /**
+ * A Public address used as a device identity address.
+ */
+ PUBLIC_IDENTITY,
+
+ /**
+ * A Random static address used as a device identity address.
+ */
+ RANDOM_STATIC_IDENTITY,
+
  /**
  * Random static device address.
+ *
+ * @deprecated This enumeration value is not relevant anymore.
+ * Advertising reporting and the connection procedure should rely
+ * on RANDOM instead. Use Gap::getRandomAddressType to retrieve the
+ * type of the random address.
  */
  RANDOM_STATIC,
 
  /**
  * Private resolvable device address.
+ *
+ * @deprecated This enumeration value is not relevant anymore.
+ * Advertising reporting and the connection procedure should rely
+ * on RANDOM instead. Use Gap::getRandomAddressType to retrieve the
+ * type of the random address.
  */
  RANDOM_PRIVATE_RESOLVABLE,
 
  /**
  * Private non-resolvable device address.
+ *
+ * @deprecated This enumeration value is not relevant anymore.
+ * Advertising reporting and the connection procedure should rely
+ * on RANDOM instead. Use Gap::getRandomAddressType to retrieve the
+ * type of the random address.
  */
  RANDOM_PRIVATE_NON_RESOLVABLE
  };

features/FEATURE_BLE/ble/BLETypes.h

@@ -442,6 +442,24 @@ struct address_t : public byte_array_t<6> {
  }
 };
 
+/**
+ * Type that describes a random device address type.
+ */
+struct random_address_type_t : SafeEnum<random_address_type_t, uint8_t> {
+ /** struct scoped enum wrapped by the class */
+ enum type {
+ STATIC, /**< Random static device address. */
+ NON_RESOLVABLE_PRIVATE, /**< Random non resolvable private address. */
+ RESOLVABLE_PRIVATE /**< Random resolvable private address. */
+ };
+
+ /**
+ * Construct a new instance of random_address_type_t.
+ */
+ random_address_type_t(type value) :
+ SafeEnum<random_address_type_t, uint8_t>(value) { }
+};
+
 } // namespace ble
 
 /**