From 1d4c7f170b1bbb62c63f6511830331605a7e415f Mon Sep 17 00:00:00 2001
From: Rahix <rahix@rahix.de>
Date: Sun, 14 Jul 2019 21:22:45 +0200
Subject: [PATCH] doc: Mention serial console

Signed-off-by: Rahix <rahix@rahix.de>
---
 Documentation/how-to-flash.rst       | 11 ++++++++---
 Documentation/pycardium/overview.rst | 14 ++++++++++++++
 2 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/Documentation/how-to-flash.rst b/Documentation/how-to-flash.rst
index 6a67277b..42e5b6fd 100644
--- a/Documentation/how-to-flash.rst
+++ b/Documentation/how-to-flash.rst
@@ -51,10 +51,15 @@ that and after connecting to card10, you can flash your binary using the
 using your new firmware.
 
 
-.. info::
+.. note::
+
    If OpenOCD was able to connect, but GDB gives you an
-   ``Error erasing flash with vFlashErase packet`` error, issue a ``reset``
-   command, quickly followed by a ``load`` command.
+
+   .. code-block:: text
+
+      Error erasing flash with vFlashErase packet
+
+   error, issue a ``reset`` command, quickly followed by a ``load`` command.
 
    Reason: The Epicardium puts parts of the CPU to sleep and the debugging
    interface is part of that. After a reset the bootloader starts up
diff --git a/Documentation/pycardium/overview.rst b/Documentation/pycardium/overview.rst
index 62e4c25f..28f3f27b 100644
--- a/Documentation/pycardium/overview.rst
+++ b/Documentation/pycardium/overview.rst
@@ -24,6 +24,20 @@ hacking!
    from .py files on the filesystem. You have to test new modules using the
    serial console.
 
+Serial Console
+--------------
+If you have a debugger, you can just use the debuggers serial console.
+Otherwise, card10 will open a serial usb-device on its usb-port. On most Linux
+systems this device will be called ``/dev/ttyACM0`` or ``/dev/ttyACM1``.
+
+Choose a terminal-emulator of your liking and open the above mentioned device.
+Baud-rate is 115200.  Some options are:
+
+* **screen**: ``screen /dev/ttyACM0 115200``
+* **picocom**: ``picocom -b 115200 /dev/ttyACM0``
+
+After connecting, reboot card10 and you should see the MicroPython REPL pop up.
+
 .. todo::
 
    Getting Started Guide for people interested in writing Python code.
-- 
GitLab