Cellular: Added set/get for baud rate

Author: Mirela Chirica

UNITTESTS/features/cellular/framework/AT/athandler/unittest.cmake

@@ -25,6 +25,8 @@ set(unittest-test-sources
   stubs/EventQueue_stub.cpp
   stubs/FileHandle_stub.cpp
   stubs/us_ticker_stub.cpp
+  stubs/UARTSerial_stub.cpp
+  stubs/SerialBase_stub.cpp
   stubs/mbed_assert_stub.c
   stubs/mbed_poll_stub.cpp
   stubs/Timer_stub.cpp

UNITTESTS/stubs/ATHandler_stub.cpp

@@ -418,3 +418,7 @@ void ATHandler::set_send_delay(uint16_t send_delay)
 {
 }
 
+void ATHandler::set_baud(int baud_rate)
+{
+}
+

UNITTESTS/stubs/AT_CellularDevice_stub.cpp

@@ -261,3 +261,18 @@ nsapi_error_t AT_CellularDevice::clear()
 {
     return NSAPI_ERROR_OK;
 }
+
+nsapi_error_t AT_CellularDevice::set_baud_rate(int baud_rate)
+{
+    return NSAPI_ERROR_OK;
+}
+
+nsapi_error_t AT_CellularDevice::set_baud_rate_impl(int baud_rate)
+{
+    return NSAPI_ERROR_OK;
+}
+
+nsapi_error_t AT_CellularDevice::get_baud_rate(int &baud_rate)
+{
+    return NSAPI_ERROR_OK;
+}

UNITTESTS/target_h/myCellularDevice.h

@@ -176,6 +176,15 @@ class myCellularDevice : public CellularDevice {
     {
         return NSAPI_ERROR_OK;
     }
+    nsapi_error_t set_baud_rate(int baud_rate)
+    {
+        return NSAPI_ERROR_OK;
+    }
+
+    nsapi_error_t get_baud_rate(int &baud_rate)
+    {
+        return NSAPI_ERROR_OK;
+    }
 
     void verify_timeout_array(const uint16_t timeout[], int array_len)
     {

features/cellular/framework/API/CellularDevice.h

@@ -443,6 +443,20 @@ class CellularDevice {
      */
     virtual nsapi_error_t release_at_handler(ATHandler *at_handler) = 0;
 
+    /** Sets cellular modem to given baud rate
+     *
+     *  @param baud_rate
+     *  @return NSAPI_ERROR_OK on success, NSAPI_ERROR_DEVICE_ERROR on failure
+     */
+    virtual nsapi_error_t set_baud_rate(int baud_rate) = 0;
+
+    /** Gets the current baud rate of the cellular modem
+     *
+     *  @param baud_rate
+     *  @return NSAPI_ERROR_OK on success, NSAPI_ERROR_DEVICE_ERROR on failure
+     */
+    virtual nsapi_error_t get_baud_rate(int &baud_rate) = 0;
+
 protected:
     friend class AT_CellularNetwork;
     friend class AT_CellularContext;

features/cellular/framework/AT/ATHandler.cpp

@@ -1612,3 +1612,9 @@ void ATHandler::write_hex_string(char *str, size_t size)
         write(hexbuf, 2);
     }
 }
+
+void ATHandler::set_baud(int baud_rate)
+{
+    static_cast<UARTSerial *>(_fileHandle)->set_baud(baud_rate);
+}
+

features/cellular/framework/AT/ATHandler.h

@@ -27,6 +27,8 @@
 
 #include <cstdarg>
 
+#include "UARTSerial.h"
+
 /**
  * If application calls associated FileHandle only from single thread context
   * then locking between AT command and response is not needed. However,
@@ -219,6 +221,12 @@ class ATHandler {
      */
     void set_send_delay(uint16_t send_delay);
 
+    /** Sets filehandle to given baud rate
+     *
+     *  @param baud_rate
+     */
+    void set_baud(int baud_rate);
+
 protected:
     void event();
 #if defined AT_HANDLER_MUTEX && defined MBED_CONF_RTOS_PRESENT

features/cellular/framework/AT/AT_CellularDevice.cpp

@@ -635,3 +635,42 @@ nsapi_error_t AT_CellularDevice::clear()
 
     return err;
 }
+
+nsapi_error_t AT_CellularDevice::set_baud_rate(int baud_rate)
+{
+    int current_baud_rate = -1;
+
+    nsapi_error_t error = get_baud_rate(current_baud_rate);
+
+    if (error != NSAPI_ERROR_OK || current_baud_rate == baud_rate) {
+        return error;
+    }
+
+    error = set_baud_rate_impl(baud_rate);
+    if (error) {
+        return error;
+    }
+
+    _at->set_baud(baud_rate);
+
+    // Give some time before starting using the UART with the new baud rate
+    rtos::ThisThread::sleep_for(3000);
+
+    error = get_baud_rate(current_baud_rate);
+
+    if (current_baud_rate != baud_rate) {
+        tr_warning("Baudrate was not changed to desired value: %d", baud_rate);
+    }
+
+    return error;
+}
+
+nsapi_error_t AT_CellularDevice::set_baud_rate_impl(int baud_rate)
+{
+    return _at->at_cmd_discard("+IPR", "=", "%d", baud_rate);
+}
+
+nsapi_error_t AT_CellularDevice::get_baud_rate(int &baud_rate)
+{
+    return _at->at_cmd_int("+IPR", "?", baud_rate);
+}

features/cellular/framework/AT/AT_CellularDevice.h

@@ -135,6 +135,10 @@ class AT_CellularDevice : public CellularDevice {
 
     virtual CellularContext *get_context_list() const;
 
+    virtual nsapi_error_t set_baud_rate(int baud_rate);
+
+    virtual nsapi_error_t get_baud_rate(int &baud_rate);
+
     AT_CellularNetwork *_network;
     AT_CellularSMS *_sms;
     AT_CellularInformation *_information;
@@ -153,6 +157,7 @@ class AT_CellularDevice : public CellularDevice {
     // Sets up parameters for AT handler, for now only the send delay and URCs.
     // This kind of routine is needed for initialisation routines that are virtual and therefore cannot be called from constructor.
     void setup_at_handler();
+    virtual nsapi_error_t set_baud_rate_impl(int baud_rate);
 
 private:
     void urc_nw_deact();

features/cellular/framework/targets/QUECTEL/BC95/QUECTEL_BC95.cpp

@@ -95,6 +95,16 @@ nsapi_error_t QUECTEL_BC95::init()
     return _at->unlock_return_error();
 }
 
+nsapi_error_t QUECTEL_BC95::set_baud_rate_impl(int baud_rate)
+{
+    return _at->at_cmd_discard("+NATSPEED", "=", "%d%d%d%d%d%d%d", baud_rate, 30, 0, 3, 1, 0, 1);
+}
+
+nsapi_error_t QUECTEL_BC95::get_baud_rate(int &baud_rate)
+{
+    return _at->at_cmd_int("+NATSPEED", "?", baud_rate);
+}
+
 #if MBED_CONF_QUECTEL_BC95_PROVIDE_DEFAULT
 #include "UARTSerial.h"
 CellularDevice *CellularDevice::get_default_instance()

features/cellular/framework/targets/QUECTEL/BC95/QUECTEL_BC95.h

@@ -42,6 +42,8 @@ class QUECTEL_BC95 : public AT_CellularDevice {
     virtual AT_CellularNetwork *open_network_impl(ATHandler &at);
     virtual AT_CellularContext *create_context_impl(ATHandler &at, const char *apn, bool cp_req = false, bool nonip_req = false);
     virtual AT_CellularInformation *open_information_impl(ATHandler &at);
+    virtual nsapi_error_t set_baud_rate_impl(int baud_rate);
+    virtual nsapi_error_t get_baud_rate(int &baud_rate);
     virtual nsapi_error_t init();
 
 public: // NetworkInterface