boards/sodaq-*: update doc about flash and stdio

boards/sodaq-autonomo/doc.txt

@@ -93,16 +93,25 @@ Besides the SAMD21 the board has the following features:
 
 ## Flashing the device
 
-1. Put the board in bootloader mode by double tapping the reset button.<br/>
+Use `BOARD=sodaq-autonomo` with the `make` command.<br/>
-   When the board is in bootloader mode, the user led (green) oscillates
+Example with `hello-world` application:
-   smoothly.
-
-2. Use `BOARD=sodaq-autonomo` with the `make` command.<br/>
-   Example with `hello-world` application:
 ```
      make BOARD=sodaq-autonomo -C examples/hello-world flash
 ```
 
+@note     If the application crashes, automatic reflashing via USB, as explained
+          above won't be possible. In this case, the board must be set in
+          bootloader mode by double tapping the reset button before running the
+          flash command.
+
+## Accessing STDIO via UART
+
+STDIO of RIOT is directly available over the USB port.
+
+The `TERM_DELAY` environment variable can be used to add a delay (in second)
+before opening the serial terminal. The default value is 2s which should be
+enough in most of the situation.
+
 ## Supported Toolchains
 
 To build software for the autonomo board we strongly recommend the usage of

boards/sodaq-explorer/doc.txt

@@ -10,20 +10,22 @@ General information about this board can be found on the
 
 ### Flash the board
 
-1. Put the board in bootloader mode by double tapping the reset button.<br/>
+Use `BOARD=sodaq-explorer` with the `make` command.<br/>
-   When the board is in bootloader mode, the user led (blue) oscillates
+Example with `hello-world` application:
-   smoothly.
-
-
-2. Use `BOARD=sodaq-explorer` with the `make` command.<br/>
-   Example with `hello-world` application:
 ```
      make BOARD=sodaq-explorer -C examples/hello-world flash
 ```
 
+@note     If the application crashes, automatic reflashing via USB, as explained
+          above won't be possible. In this case, the board must be set in
+          bootloader mode by double tapping the reset button before running the
+          flash command.
+
 ### Accessing STDIO via UART
 
-To access the STDIO of RIOT, a FTDI to USB converter needs to be plugged to
+STDIO of RIOT is directly available over the USB port.
-the RX/TX pins on the board.
 
+The `TERM_DELAY` environment variable can be used to add a delay (in second)
+before opening the serial terminal. The default value is 2s which should be
+enough in most of the situation.
  */

boards/sodaq-one/doc.txt

@@ -10,20 +10,22 @@
  *
  * ### Flash the board
  *
- * 1. Put the board in bootloader mode by double tapping the reset button.<br/>
+ * Use `BOARD=sodaq-one` with the `make` command.<br/>
- *    When the board is in bootloader mode, the user led (blue) oscillates
+ * Example with `hello-world` application:
- *    smoothly.
- *
- *
- * 2. Use `BOARD=sodaq-one` with the `make` command.<br/>
- *    Example with `hello-world` application:
  * ```
  *      make BOARD=sodaq-one -C examples/hello-world flash
  * ```
  *
+ * @note     If the application crashes, automatic reflashing via USB, as explained
+ *           above won't be possible. In this case, the board must be set in
+ *           bootloader mode by double tapping the reset button before running the
+ *           flash command.
+ *
  * ### Accessing STDIO via UART
  *
- * To access the STDIO of RIOT, a FTDI to USB converter needs to be plugged to
+ * STDIO of RIOT is directly available over the USB port.
- * the RX/TX pins on the board.
  *
+ * The `TERM_DELAY` environment variable can be used to add a delay (in second)
+ * before opening the serial terminal. The default value is 2s which should be
+ * enough in most of the situation.
  */

boards/sodaq-sara-aff/doc.txt

@@ -12,20 +12,22 @@
  *
  * ### Flash the board
  *
- * 1. Put the board in bootloader mode by double tapping the reset button.<br/>
+ * Use `BOARD=sodaq-sara-aff` with the `make` command.<br/>
- *    When the board is in bootloader mode, the user led (blue) oscillates
+ * Example with `hello-world` application:
- *    smoothly.
- *
- *
- * 2. Use `BOARD=sodaq-sara-aff` with the `make` command.<br/>
- *    Example with `hello-world` application:
  * ```
  *      make BOARD=sodaq-sara-aff -C examples/hello-world flash
  * ```
  *
+ * @note     If the application crashes, automatic reflashing via USB, as explained
+ *           above won't be possible. In this case, the board must be set in
+ *           bootloader mode by double tapping the reset button before running the
+ *           flash command.
+ *
  * ### Accessing STDIO via UART
  *
- * To access the STDIO of RIOT, a FTDI to USB converter needs to be plugged to
+ * STDIO of RIOT is directly available over the USB port.
- * the RX/TX pins on the board.
  *
+ * The `TERM_DELAY` environment variable can be used to add a delay (in second)
+ * before opening the serial terminal. The default value is 2s which should be
+ * enough in most of the situation.
  */