ARMmbed
/
mbed-os
mirror of https://github.com/ARMmbed/mbed-os.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Cellular: Updated doxygen for deprecated API's.

pull/6652/head
Teppo Järvelin 2018-04-17 12:30:16 +03:00
parent f73415e9f8
commit 3b1c8c0a94
4 changed files with 72 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
features/netsocket/CellularInterface.h
View File

@ -20,6 +20,8 @@
#include "netsocket/NetworkInterface.h" #include "netsocket/NetworkInterface.h"
/** CellularInterface class /** 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 * Common interface that is shared between ethernet hardware
* @addtogroup netsocket * @addtogroup netsocket
@ -33,6 +35,8 @@ public:
virtual ~CellularInterface() {}; virtual ~CellularInterface() {};
/** Set the cellular network APN and credentials /** 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 apn Optional name of the network to connect to
* @param username Optional username for the APN * @param username Optional username for the APN
@ -44,6 +48,8 @@ public:
const char *username = 0, const char *password = 0) = 0; const char *username = 0, const char *password = 0) = 0;
/** Start the interface /** 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 apn Optional name of the network to connect to
* @param username Optional username for your APN * @param username Optional username for your APN
@ -55,6 +61,8 @@ public:
const char *username = 0, const char *password = 0) = 0; const char *username = 0, const char *password = 0) = 0;
/** Start the interface /** 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 * Attempts to connect to a cellular network based on supplied credentials
* *
@ -64,6 +72,8 @@ public:
virtual nsapi_error_t connect() = 0; virtual nsapi_error_t connect() = 0;
/** Stop the interface /** 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 * @return 0 on success, negative error code on failure
*/ */

16
features/netsocket/cellular/generic_modem_driver/OnboardCellularInterface.h
View File

@ -24,6 +24,8 @@ typedef mbed::EasyCellularConnection OnboardCellularInterface;
#include "UARTCellularInterface.h" #include "UARTCellularInterface.h"
/** OnboardCellularInterface class /** 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 * This interface serves as the controller/driver for an
* onboard modem implementing onboard_modem_api.h. * onboard modem implementing onboard_modem_api.h.
@ -37,14 +39,22 @@ class OnboardCellularInterface : public UARTCellularInterface {
public: 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.") 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); 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.") MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/framework/API/CellularPower.h instead.")
virtual ~OnboardCellularInterface(); virtual ~OnboardCellularInterface();
protected: protected:
/** Sets the modem up for powering on /** 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. * 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. * Uses onboard_modem_api.h where the target provides the implementation of onboard_modem_api.
@ -53,6 +63,8 @@ protected:
virtual void modem_init(); virtual void modem_init();
/** Sets the modem in unplugged state /** 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 * 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. * and serial port. This puts the modem in lowest power state.
@ -62,6 +74,8 @@ protected:
virtual void modem_deinit(); virtual void modem_deinit();
/** Powers up the modem /** 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. * 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. * The driver may repeat this if the modem is not responsive to AT commands.
@ -71,6 +85,8 @@ protected:
virtual void modem_power_up(); virtual void modem_power_up();
/** Powers down the modem /** 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. * 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. * Uses onboard_modem_api.h where the target provides the implementation of onboard_modem_api.

34
features/netsocket/cellular/generic_modem_driver/PPPCellularInterface.h
View File

@ -91,6 +91,8 @@ typedef struct {
} device_info; } device_info;
/** PPPCellularInterface class /** 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 * This interface serves as the controller/driver for the Cellular
* modems (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE). * modems (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE).
@ -105,6 +107,8 @@ class PPPCellularInterface : public CellularBase {
public: public:
/** Constructor for a generic modem, using a single FileHandle for commands and PPP data. /** 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 * 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. * 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.") 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); 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.") MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.")
virtual ~PPPCellularInterface(); virtual ~PPPCellularInterface();
/** Set the Cellular network credentials /** 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. * Please check documentation of connect() for default behaviour of APN settings.
* *
@ -128,6 +138,8 @@ public:
const char *pwd = 0); const char *pwd = 0);
/** Set the pin code for SIM card /** 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 * @param sim_pin PIN for the SIM card
*/ */
@ -135,6 +147,8 @@ public:
virtual void set_sim_pin(const char *sim_pin); virtual void set_sim_pin(const char *sim_pin);
/** Start the interface /** 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. * Attempts to connect to a Cellular network.
* This driver is written mainly for data network connections as CellularInterface * This driver is written mainly for data network connections as CellularInterface
@ -154,6 +168,8 @@ public:
const char *uname = 0, const char *pwd = 0); const char *uname = 0, const char *pwd = 0);
/** Attempt to connect to the Cellular network /** 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 * Brings up the network interface. Connects to the Cellular Radio
* network and then brings up the underlying network stack to be used * network and then brings up the underlying network stack to be used
@ -187,6 +203,8 @@ public:
virtual nsapi_error_t disconnect(); virtual nsapi_error_t disconnect();
/** Adds or removes a SIM facility lock /** 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. * 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 * 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); void set_sim_pin_check(bool set);
/** Change the pin for the SIM card /** 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 * 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 * 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); void set_new_sim_pin(const char *new_pin);
/** Check if the connection is currently established or not /** 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 * @return true/false If the cellular module have successfully acquired a carrier and is
* connected to an external packet data network using PPP, isConnected() * connected to an external packet data network using PPP, isConnected()
@ -220,6 +242,8 @@ public:
virtual bool is_connected(); virtual bool is_connected();
/** Get the local IP address /** 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 * @return Null-terminated representation of the local IP address
* or null if no IP address has been received * or null if no IP address has been received
@ -228,6 +252,8 @@ public:
virtual const char *get_ip_address(); virtual const char *get_ip_address();
/** Get the local network mask /** 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 * @return Null-terminated representation of the local network mask
* or null if no network mask has been received * or null if no network mask has been received
@ -236,6 +262,8 @@ public:
virtual const char *get_netmask(); virtual const char *get_netmask();
/** Get the local gateways /** 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 * @return Null-terminated representation of the local gateway
* or null if no network mask has been received * or null if no network mask has been received
@ -252,6 +280,8 @@ public:
void modem_debug_on(bool on); void modem_debug_on(bool on);
/** Register callback for status reporting /** 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 * @param status_cb The callback for status changes
*/ */
@ -259,6 +289,8 @@ public:
virtual void attach(Callback<void(nsapi_event_t, intptr_t)> status_cb); virtual void attach(Callback<void(nsapi_event_t, intptr_t)> status_cb);
/** Get the connection status /** 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 * @return The connection status according to nsapi_connection_status_t
*/ */
@ -266,6 +298,8 @@ public:
virtual nsapi_connection_status_t get_connection_status() const; virtual nsapi_connection_status_t get_connection_status() const;
/** Set blocking status of connect() which by default should be blocking /** 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 * @param blocking true if connect is blocking
* @return 0 on success, negative error code on failure * @return 0 on success, negative error code on failure

12
features/netsocket/cellular/generic_modem_driver/UARTCellularInterface.h
View File

@ -22,6 +22,8 @@
#if NSAPI_PPP_AVAILABLE #if NSAPI_PPP_AVAILABLE
/** UARTCellularInterface class /** 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 * This interface serves as the controller/driver for Cellular
* modems attached via a UART (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE). * modems attached via a UART (tested with UBLOX_C027 and MTS_DRAGONFLY_F411RE).
@ -34,12 +36,20 @@ class UARTCellularInterface : public PPPCellularInterface {
public: 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.") 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, 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, PinName dtr = NC, PinName dsr = NC, int baud = MBED_CONF_PPP_CELL_IFACE_BAUD_RATE,
bool active_high = false, bool active_high = false,
bool debug = 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.") MBED_DEPRECATED_SINCE("mbed-os-5.9", "This API will be deprecated, use mbed-os/features/cellular/easy_cellular/EasyCellularConnection.h instead.")
virtual ~UARTCellularInterface(); virtual ~UARTCellularInterface();
@ -50,6 +60,8 @@ private:
protected: protected:
/** Enable or disable hang-up detection /** 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 * 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 * POLLHUP, e.g., if the DCD line is deasserted on a UART. During command mode, this