From 3b1c8c0a943c6899c795deb2419317a75631ba47 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Teppo=20J=C3=A4rvelin?= Date: Tue, 17 Apr 2018 12:30:16 +0300 Subject: [PATCH 1/5] Cellular: Updated doxygen for deprecated API's. --- features/netsocket/CellularInterface.h | 10 ++++++ .../OnboardCellularInterface.h | 16 +++++++++ .../PPPCellularInterface.h | 34 +++++++++++++++++++ .../UARTCellularInterface.h | 12 +++++++ 4 files changed, 72 insertions(+) diff --git a/features/netsocket/CellularInterface.h b/features/netsocket/CellularInterface.h index 3905530f19..da368563ce 100644 --- a/features/netsocket/CellularInterface.h +++ b/features/netsocket/CellularInterface.h @@ -20,6 +20,8 @@ #include "netsocket/NetworkInterface.h" /** CellularInterface class + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * Common interface that is shared between ethernet hardware * @addtogroup netsocket @@ -33,6 +35,8 @@ public: virtual ~CellularInterface() {}; /** Set the cellular network APN and credentials + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * @param apn Optional name of the network to connect to * @param username Optional username for the APN @@ -44,6 +48,8 @@ public: const char *username = 0, const char *password = 0) = 0; /** Start the interface + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * @param apn Optional name of the network to connect to * @param username Optional username for your APN @@ -55,6 +61,8 @@ public: const char *username = 0, const char *password = 0) = 0; /** Start the interface + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * Attempts to connect to a cellular network based on supplied credentials * @@ -64,6 +72,8 @@ public: virtual nsapi_error_t connect() = 0; /** Stop the interface + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * @return 0 on success, negative error code on failure */ diff --git a/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h b/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h index 1bc30b4bc7..343844623e 100644 --- a/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h +++ b/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h @@ -24,6 +24,8 @@ typedef mbed::EasyCellularConnection OnboardCellularInterface; #include "UARTCellularInterface.h" /** OnboardCellularInterface class + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * This interface serves as the controller/driver for an * onboard modem implementing onboard_modem_api.h. @@ -37,14 +39,22 @@ class OnboardCellularInterface : public UARTCellularInterface { public: + /** Constructor + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/framework/API/CellularPower.h instead.") OnboardCellularInterface(bool debug = false); + /** Destructor + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/framework/API/CellularPower.h instead.") virtual ~OnboardCellularInterface(); protected: /** Sets the modem up for powering on + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_init() is equivalent to plugging in the device, for example, attaching power and serial port. * Uses onboard_modem_api.h where the target provides the implementation of onboard_modem_api. @@ -53,6 +63,8 @@ protected: virtual void modem_init(); /** Sets the modem in unplugged state + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_deinit() will be equivalent to pulling the plug off of the device, in other words, detaching power * and serial port. This puts the modem in lowest power state. @@ -62,6 +74,8 @@ protected: virtual void modem_deinit(); /** Powers up the modem + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_power_up() is equivalent to pressing the soft power button. * The driver may repeat this if the modem is not responsive to AT commands. @@ -71,6 +85,8 @@ protected: virtual void modem_power_up(); /** Powers down the modem + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_power_down() is equivalent to turning off the modem by button press. * Uses onboard_modem_api.h where the target provides the implementation of onboard_modem_api. diff --git a/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h b/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h index 4502f7b476..03984fa42b 100644 --- a/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h +++ b/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h @@ -91,6 +91,8 @@ typedef struct { } device_info; /** PPPCellularInterface class + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * This interface serves as the controller/driver for the Cellular * modems (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE). @@ -105,6 +107,8 @@ class PPPCellularInterface : public CellularBase { public: /** Constructor for a generic modem, using a single FileHandle for commands and PPP data. + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * The file handle pointer is not accessed within the constructor, only recorded for later * use - this permits a derived class to pass a pointer to a not-yet-constructed member object. @@ -112,10 +116,16 @@ public: MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.") PPPCellularInterface(FileHandle *fh, bool debug = false); + /** Destructor + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.") virtual ~PPPCellularInterface(); /** Set the Cellular network credentials + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Please check documentation of connect() for default behaviour of APN settings. * @@ -128,6 +138,8 @@ public: const char *pwd = 0); /** Set the pin code for SIM card + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @param sim_pin PIN for the SIM card */ @@ -135,6 +147,8 @@ public: virtual void set_sim_pin(const char *sim_pin); /** Start the interface + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Attempts to connect to a Cellular network. * This driver is written mainly for data network connections as CellularInterface @@ -154,6 +168,8 @@ public: const char *uname = 0, const char *pwd = 0); /** Attempt to connect to the Cellular network + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Brings up the network interface. Connects to the Cellular Radio * network and then brings up the underlying network stack to be used @@ -187,6 +203,8 @@ public: virtual nsapi_error_t disconnect(); /** Adds or removes a SIM facility lock + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Can be used to enable or disable SIM pin check at device startup. * This API sets up flags for the driver which would either enable or disable @@ -200,6 +218,8 @@ public: void set_sim_pin_check(bool set); /** Change the pin for the SIM card + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Provide the new pin for your SIM card with this API. Old pin code will be assumed to * be set using set_SIM_pin() API. This API have no immediate effect. While establishing @@ -211,6 +231,8 @@ public: void set_new_sim_pin(const char *new_pin); /** Check if the connection is currently established or not + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return true/false If the cellular module have successfully acquired a carrier and is * connected to an external packet data network using PPP, isConnected() @@ -220,6 +242,8 @@ public: virtual bool is_connected(); /** Get the local IP address + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return Null-terminated representation of the local IP address * or null if no IP address has been received @@ -228,6 +252,8 @@ public: virtual const char *get_ip_address(); /** Get the local network mask + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return Null-terminated representation of the local network mask * or null if no network mask has been received @@ -236,6 +262,8 @@ public: virtual const char *get_netmask(); /** Get the local gateways + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return Null-terminated representation of the local gateway * or null if no network mask has been received @@ -252,6 +280,8 @@ public: void modem_debug_on(bool on); /** Register callback for status reporting + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @param status_cb The callback for status changes */ @@ -259,6 +289,8 @@ public: virtual void attach(Callback status_cb); /** Get the connection status + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return The connection status according to nsapi_connection_status_t */ @@ -266,6 +298,8 @@ public: virtual nsapi_connection_status_t get_connection_status() const; /** Set blocking status of connect() which by default should be blocking + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @param blocking true if connect is blocking * @return 0 on success, negative error code on failure diff --git a/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h b/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h index 0d5e611be8..7a511b9f5e 100644 --- a/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h +++ b/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h @@ -22,6 +22,8 @@ #if NSAPI_PPP_AVAILABLE /** UARTCellularInterface class + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * This interface serves as the controller/driver for Cellular * modems attached via a UART (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE). @@ -34,12 +36,20 @@ class UARTCellularInterface : public PPPCellularInterface { public: + /** Constructor + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.") UARTCellularInterface(PinName tx, PinName rx, PinName dcd = NC, PinName rts = NC, PinName cts = NC, PinName ri = NC, PinName dtr = NC, PinName dsr = NC, int baud = MBED_CONF_PPP_CELL_IFACE_BAUD_RATE, bool active_high = false, bool debug = false); + /** Destructor + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.") virtual ~UARTCellularInterface(); @@ -50,6 +60,8 @@ private: protected: /** Enable or disable hang-up detection + * + * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * When in PPP data pump mode, it is helpful if the FileHandle will signal hang-up via * POLLHUP, e.g., if the DCD line is deasserted on a UART. During command mode, this From 5835d83efa8eac9b68136b0270d928b7ba24ec88 Mon Sep 17 00:00:00 2001 From: Amanda Butler Date: Tue, 17 Apr 2018 11:41:59 -0500 Subject: [PATCH 2/5] Copy edit CellularInterface.h Copy edit for grammar. --- features/netsocket/CellularInterface.h | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/features/netsocket/CellularInterface.h b/features/netsocket/CellularInterface.h index da368563ce..3bb4fed9de 100644 --- a/features/netsocket/CellularInterface.h +++ b/features/netsocket/CellularInterface.h @@ -21,7 +21,7 @@ /** CellularInterface class * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * Common interface that is shared between ethernet hardware * @addtogroup netsocket @@ -36,7 +36,7 @@ public: /** Set the cellular network APN and credentials * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * @param apn Optional name of the network to connect to * @param username Optional username for the APN @@ -49,7 +49,7 @@ public: /** Start the interface * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * @param apn Optional name of the network to connect to * @param username Optional username for your APN @@ -62,7 +62,7 @@ public: /** Start the interface * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * Attempts to connect to a cellular network based on supplied credentials * @@ -73,7 +73,7 @@ public: /** Stop the interface * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularNetwork.h instead. * * @return 0 on success, negative error code on failure */ From 0f8a2c75e78eae29e62fcb42cf897dfb3cbd16ea Mon Sep 17 00:00:00 2001 From: Amanda Butler Date: Tue, 17 Apr 2018 11:44:28 -0500 Subject: [PATCH 3/5] Copy edit OnboardCellularInterface.h Copy edit file for grammar. --- .../OnboardCellularInterface.h | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h b/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h index 343844623e..fb7c1f4cc1 100644 --- a/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h +++ b/features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h @@ -25,7 +25,7 @@ typedef mbed::EasyCellularConnection OnboardCellularInterface; /** OnboardCellularInterface class * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * This interface serves as the controller/driver for an * onboard modem implementing onboard_modem_api.h. @@ -40,13 +40,13 @@ class OnboardCellularInterface : public UARTCellularInterface { public: /** Constructor - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularPower.h instead. */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/framework/API/CellularPower.h instead.") OnboardCellularInterface(bool debug = false); /** Destructor - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularPower.h instead. */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/framework/API/CellularPower.h instead.") virtual ~OnboardCellularInterface(); @@ -54,7 +54,7 @@ public: protected: /** Sets the modem up for powering on * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_init() is equivalent to plugging in the device, for example, attaching power and serial port. * Uses onboard_modem_api.h where the target provides the implementation of onboard_modem_api. @@ -64,7 +64,7 @@ protected: /** Sets the modem in unplugged state * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_deinit() will be equivalent to pulling the plug off of the device, in other words, detaching power * and serial port. This puts the modem in lowest power state. @@ -75,7 +75,7 @@ protected: /** Powers up the modem * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_power_up() is equivalent to pressing the soft power button. * The driver may repeat this if the modem is not responsive to AT commands. @@ -86,7 +86,7 @@ protected: /** Powers down the modem * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/framework/API/CellularPower.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/framework/API/CellularPower.h instead. * * modem_power_down() is equivalent to turning off the modem by button press. * Uses onboard_modem_api.h where the target provides the implementation of onboard_modem_api. From 8389bbfc61821e1deb41e76fb6f2e99197ca7a9b Mon Sep 17 00:00:00 2001 From: Amanda Butler Date: Tue, 17 Apr 2018 11:49:20 -0500 Subject: [PATCH 4/5] Copy edit PPPCellularInterface.h Copy edit file for grammar. --- .../PPPCellularInterface.h | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h b/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h index 03984fa42b..dc8a262f66 100644 --- a/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h +++ b/features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h @@ -92,7 +92,7 @@ typedef struct { /** PPPCellularInterface class * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * This interface serves as the controller/driver for the Cellular * modems (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE). @@ -108,7 +108,7 @@ public: /** Constructor for a generic modem, using a single FileHandle for commands and PPP data. * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * The file handle pointer is not accessed within the constructor, only recorded for later * use - this permits a derived class to pass a pointer to a not-yet-constructed member object. @@ -118,14 +118,14 @@ public: /** Destructor * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.") virtual ~PPPCellularInterface(); /** Set the Cellular network credentials * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Please check documentation of connect() for default behaviour of APN settings. * @@ -139,7 +139,7 @@ public: /** Set the pin code for SIM card * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @param sim_pin PIN for the SIM card */ @@ -148,7 +148,7 @@ public: /** Start the interface * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Attempts to connect to a Cellular network. * This driver is written mainly for data network connections as CellularInterface @@ -169,7 +169,7 @@ public: /** Attempt to connect to the Cellular network * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Brings up the network interface. Connects to the Cellular Radio * network and then brings up the underlying network stack to be used @@ -204,7 +204,7 @@ public: /** Adds or removes a SIM facility lock * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Can be used to enable or disable SIM pin check at device startup. * This API sets up flags for the driver which would either enable or disable @@ -219,7 +219,7 @@ public: /** Change the pin for the SIM card * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * Provide the new pin for your SIM card with this API. Old pin code will be assumed to * be set using set_SIM_pin() API. This API have no immediate effect. While establishing @@ -232,7 +232,7 @@ public: /** Check if the connection is currently established or not * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return true/false If the cellular module have successfully acquired a carrier and is * connected to an external packet data network using PPP, isConnected() @@ -243,7 +243,7 @@ public: /** Get the local IP address * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return Null-terminated representation of the local IP address * or null if no IP address has been received @@ -253,7 +253,7 @@ public: /** Get the local network mask * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return Null-terminated representation of the local network mask * or null if no network mask has been received @@ -263,7 +263,7 @@ public: /** Get the local gateways * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return Null-terminated representation of the local gateway * or null if no network mask has been received @@ -281,7 +281,7 @@ public: /** Register callback for status reporting * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @param status_cb The callback for status changes */ @@ -290,7 +290,7 @@ public: /** Get the connection status * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @return The connection status according to nsapi_connection_status_t */ @@ -299,7 +299,7 @@ public: /** Set blocking status of connect() which by default should be blocking * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * @param blocking true if connect is blocking * @return 0 on success, negative error code on failure From a83745bcdd45e6f86185b77ea8714c89829f95cc Mon Sep 17 00:00:00 2001 From: Amanda Butler Date: Tue, 17 Apr 2018 11:51:24 -0500 Subject: [PATCH 5/5] Copy edit UARTCellularInterface.h Copy edit file for grammar. --- .../cellular/generic_modem_driver/UARTCellularInterface.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h b/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h index 7a511b9f5e..d5e72d5ea7 100644 --- a/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h +++ b/features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h @@ -23,7 +23,7 @@ /** UARTCellularInterface class * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * This interface serves as the controller/driver for Cellular * modems attached via a UART (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE). @@ -38,7 +38,7 @@ public: /** Constructor * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.") UARTCellularInterface(PinName tx, PinName rx, PinName dcd = NC, PinName rts = NC, PinName cts = NC, PinName ri = NC, @@ -48,7 +48,7 @@ public: /** Destructor * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. */ MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.") virtual ~UARTCellularInterface(); @@ -61,7 +61,7 @@ private: protected: /** Enable or disable hang-up detection * - * @deprecated This API will be deprecated mbed-os-5.9, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. + * @deprecated This API will be deprecated in mbed-os-5.9. Use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead. * * When in PPP data pump mode, it is helpful if the FileHandle will signal hang-up via * POLLHUP, e.g., if the DCD line is deasserted on a UART. During command mode, this