Merge pull request #1000 from ARMmbed/AnotherButler-patch-5

Add serial terminal section to cli-collaborate.md

Author: Amanda Butler

docs/tools/CLI/cli-collaborate.md

@@ -101,6 +101,35 @@ $ mbed export -i uvision -m K64F
 
 Mbed CLI creates a `.uvprojx` file in the root project directory. You can open the project file with uVision.
 
+#### Serial terminal
+
+You can open a serial terminal to the serial port of a connected Mbed target (usually board) using the `mbed sterm` command. If no serial port is specified, Mbed CLI will attempt to detect the connected Mbed targets and their serial ports.
+
+There are various options to `mbed sterm`:
+
+- `--port <serial port>` to specify system serial port to connect to.
+- `--baudrate <numeric>` to select the communication baudrate, where the default value is 9600.
+- `--echo <on|off>` to switch local echo (default is `on`).
+- `--reset` to reset the connected target by sending Break before opening the serial terminal.
+
+You can also set default port, baudrate and echo mode using the `TERM_PORT`, `TERM_BAUDRATE` and `TERM_ECHO` Mbed CLI configuration options.
+
+The following shortcuts are available within the serial terminal:
+
+- Ctrl+b - Send Break (reset target)
+- Ctrl+c - Exit terminal
+- Ctrl+e - Toggle local echo
+- Ctrl+h - Help
+- Ctrl+t - Menu escape key
+
+More shortcuts can be viewed within the serial terminal's help menu (Ctrl+h).
+
+You can also add the `--sterm` option to `mbed compile -f` to compile a new program, flash the program/firmware image to the connected target and then open the serial terminal to its serial port:
+
+```
+$ mbed compile -t GCC_ARM -m K64F -f --sterm
+```
+
 ### Publishing changes
 
 #### Checking status