Merge pull request #10635 from LDong-Arm/deprecated_ble_services

BLE: deprecate UARTService and suppress compiler warnings

Author: 0xc0170

features/FEATURE_BLE/ble/services/UARTService.h

@@ -26,9 +26,12 @@
 
 #include "ble/UUID.h"
 #include "ble/BLE.h"
+#include "ble/pal/Deprecated.h"
 
 #if BLE_FEATURE_GATT_SERVER
 
+BLE_DEPRECATED_API_USE_BEGIN()
+
 extern const uint8_t  UARTServiceBaseUUID[UUID::LENGTH_OF_LONG_UUID];
 extern const uint16_t UARTServiceShortUUID;
 extern const uint16_t UARTServiceTXCharacteristicShortUUID;
@@ -41,9 +44,15 @@ extern const uint8_t  UARTServiceTXCharacteristicUUID[UUID::LENGTH_OF_LONG_UUID]
 extern const uint8_t  UARTServiceRXCharacteristicUUID[UUID::LENGTH_OF_LONG_UUID];
 
 /**
-* @class UARTService.
-* @brief BLE Service to enable UART over BLE.
-*/
+ * @class UARTService.
+ * @brief BLE Service to enable UART over BLE.
+ *
+ * @deprecated This service is deprecated, and no replacement is currently available.
+ */
+MBED_DEPRECATED_SINCE(
+    "mbed-os-5.13",
+    "This service is deprecated, and no replacement is currently available."
+)
 class UARTService {
 public:
     /** Maximum length of data (in bytes) that the UART service module can transmit to the peer. */
@@ -217,6 +226,8 @@ class UARTService {
                                            *   application. */
 };
 
+BLE_DEPRECATED_API_USE_END()
+
 #endif // BLE_FEATURE_GATT_SERVER
 
 #endif /* #ifndef __BLE_UART_SERVICE_H__*/

features/FEATURE_BLE/ble/services/URIBeaconConfigService.h

@@ -18,6 +18,7 @@
 #define SERVICES_URIBEACONCONFIGSERVICE_H_
 
 #include "ble/BLE.h"
+#include "ble/pal/Deprecated.h"
 
 #ifdef YOTTA_CFG_MBED_OS
 #include "mbed-drivers/mbed.h"
@@ -28,6 +29,8 @@
 #if BLE_FEATURE_GATT_SERVER
 #if BLE_ROLE_BROADCASTER
 
+BLE_DEPRECATED_API_USE_BEGIN()
+
 extern const uint8_t UUID_URI_BEACON_SERVICE[UUID::LENGTH_OF_LONG_UUID];
 extern const uint8_t UUID_LOCK_STATE_CHAR[UUID::LENGTH_OF_LONG_UUID];
 extern const uint8_t UUID_LOCK_CHAR[UUID::LENGTH_OF_LONG_UUID];
@@ -483,6 +486,8 @@ class URIBeaconConfigService {
     }
 };
 
+BLE_DEPRECATED_API_USE_END()
+
 #endif // BLE_ROLE_BROADCASTER
 #endif // BLE_FEATURE_GATT_SERVER
 

features/FEATURE_BLE/ble/services/iBeacon.h

@@ -18,9 +18,12 @@
 
 #include "cmsis_compiler.h"
 #include "ble/BLE.h"
+#include "ble/pal/Deprecated.h"
 
 #if BLE_FEATURE_GATT_SERVER
 
+BLE_DEPRECATED_API_USE_BEGIN()
+
 /**
  * iBeacon Service.
  *
@@ -253,6 +256,8 @@ class iBeacon {
  */
 typedef iBeacon iBeaconService;
 
+BLE_DEPRECATED_API_USE_END()
+
 #endif // BLE_FEATURE_GATT_SERVER
 
 #endif //MBED_BLE_IBEACON_H__