Added a baud argument for (Raw)Serial objects

This commit adds a `baud` argument for Serial and RawSerial objects:

- there is a new `Serial` constructor with a mandatory baud rate
  argument. The old constructor also got a `baud` argument with a
  default value (to keep backward compatibility).
- the `RawSerial` constructor also got a `baud` argument with a default
  value.

There's also a new configuration parameter (`default-serial-baud-rate`)
that can be used to specify the default value of the above `baud`
arguments.

Author: Bogdan Marinescu

hal/api/RawSerial.h

@@ -50,15 +50,16 @@ namespace mbed {
 class RawSerial: public SerialBase {
 
 public:
-    /** Create a RawSerial port, connected to the specified transmit and receive pins
+    /** Create a RawSerial port, connected to the specified transmit and receive pins, with the specified baud.
      *
      *  @param tx Transmit pin
      *  @param rx Receive pin
+     *  @param baud The baud rate of the serial port (optional, defaults to MBED_CONF_CORE_DEFAULT_SERIAL_BAUD_RATE)
      *
      *  @note
      *    Either tx or rx may be specified as NC if unused
      */
-    RawSerial(PinName tx, PinName rx);
+    RawSerial(PinName tx, PinName rx, int baud = MBED_CONF_CORE_DEFAULT_SERIAL_BAUD_RATE);
 
     /** Write a char to the serial port
      *

hal/api/Serial.h

@@ -59,11 +59,25 @@ class Serial : public SerialBase, public Stream {
      *
      *  @param tx Transmit pin
      *  @param rx Receive pin
+     *  @param name The name of the stream associated with this serial port (optional)
+     *  @param baud The baud rate of the serial port (optional, defaults to MBED_CONF_CORE_DEFAULT_SERIAL_BAUD_RATE)
      *
      *  @note
      *    Either tx or rx may be specified as NC if unused
      */
-    Serial(PinName tx, PinName rx, const char *name=NULL);
+    Serial(PinName tx, PinName rx, const char *name=NULL, int baud = MBED_CONF_CORE_DEFAULT_SERIAL_BAUD_RATE);
+
+
+    /** Create a Serial port, connected to the specified transmit and receive pins, with the specified baud
+     *
+     *  @param tx Transmit pin
+     *  @param rx Receive pin
+     *  @param baud The baud rate of the serial port
+     *
+     *  @note
+     *    Either tx or rx may be specified as NC if unused
+     */
+    Serial(PinName tx, PinName rx, int baud);
 
 protected:
     virtual int _getc();

hal/api/SerialBase.h

@@ -215,7 +215,7 @@ class SerialBase {
 #endif
 
 protected:
-    SerialBase(PinName tx, PinName rx);
+    SerialBase(PinName tx, PinName rx, int baud);
     virtual ~SerialBase() {
     }
 

hal/common/RawSerial.cpp

@@ -23,7 +23,7 @@
 
 namespace mbed {
 
-RawSerial::RawSerial(PinName tx, PinName rx) : SerialBase(tx, rx) {
+RawSerial::RawSerial(PinName tx, PinName rx, int baud) : SerialBase(tx, rx, baud) {
     // No lock needed in the constructor
 }
 

hal/common/Serial.cpp

@@ -20,7 +20,10 @@
 
 namespace mbed {
 
-Serial::Serial(PinName tx, PinName rx, const char *name) : SerialBase(tx, rx), Stream(name) {
+Serial::Serial(PinName tx, PinName rx, const char *name, int baud) : SerialBase(tx, rx, baud), Stream(name) {
+}
+
+Serial::Serial(PinName tx, PinName rx, int baud): SerialBase(tx, rx, baud), Stream(NULL) {
 }
 
 int Serial::_getc() {

hal/common/SerialBase.cpp

@@ -21,15 +21,16 @@
 
 namespace mbed {
 
-SerialBase::SerialBase(PinName tx, PinName rx) :
+SerialBase::SerialBase(PinName tx, PinName rx, int baud) :
 #if DEVICE_SERIAL_ASYNCH
                                                  _thunk_irq(this), _tx_usage(DMA_USAGE_NEVER),
                                                  _rx_usage(DMA_USAGE_NEVER),
 #endif
-                                                _serial(), _baud(9600) {
+                                                _serial(), _baud(baud) {
     // No lock needed in the constructor
 
     serial_init(&_serial, tx, rx);
+    serial_baud(&_serial, _baud);
     serial_irq_handler(&_serial, SerialBase::_irq_handler, (uint32_t)this);
 }
 

mbed_lib.json

@@ -9,6 +9,11 @@
         "stdio-baud-rate": {
             "help": "Baud rate for stdio",
             "value": 9600
+        },
+
+        "default-serial-baud-rate": {
+            "help": "Default baud rate for a Serial or RawSerial instance (if not specified in the constructor)",
+            "value": 9600
         }
     }
 }