diff --git a/doc/services/shell/images/putty_rtt.png b/doc/services/shell/images/putty_rtt.png new file mode 100644 index 00000000000..c459ee4104b Binary files /dev/null and b/doc/services/shell/images/putty_rtt.png differ diff --git a/doc/services/shell/index.rst b/doc/services/shell/index.rst index 8327031e197..d1aa82dc7a3 100644 --- a/doc/services/shell/index.rst +++ b/doc/services/shell/index.rst @@ -122,6 +122,30 @@ To configure Segger RTT backend, add the following configurations to your build: Details on additional configuration settings are captured in: :zephyr_file:`samples/subsys/shell/shell_module/prj_minimal_rtt.conf`. +.. _shell_rtt_putty: + +Using PuTTY +----------- + +Use following procedure: + +* Open debug session and continue running the application. + + .. code-block:: none + + west attach + +* Open ``PuTTY``. Use telnet port 19021 and specific Terminal configuration. Set ``Local echo`` + to ``Force off`` and ``Local line editing`` to ``Force off`` (see image below). + + +.. image:: images/putty_rtt.png + :align: center + :alt: RTT PuTTY terminal configuration. + +* Now you should have a network connection to RTT that will let you enter input + to the shell. + Connecting to Segger RTT via TCP (on macOS, for example) -------------------------------------------------------- @@ -143,7 +167,9 @@ procedure: nc localhost 19021 * Now you should have a network connection to RTT that will let you enter input - to the shell. + to the shell. However, contrary to `PuTTY `_ some features like + ``Tab`` completion do not work. + Commands ********