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