.. _ttl-converter-connection:

TTL Converter Terminal Connection
==================================

This section shows you how to connect your Development Kit with a host computer to login to a terminal.

Wiring
--------

If you are using the USB-to-TTL cable shipped with our modules, the Black wire always goes to **GND** or Number **1** Pin. The other side of course is plugged into your host computer.

.. image:: ./images/debug-connector.png
   :alt: Debug Connector Example
   :scale: 60%


Accessing
-----------

Linux
~~~~~~

.. note:: This section was tested on Ubuntu 16.04.

1. Install minicom:

.. prompt::
   :prompts: $

   sudo apt install minicom

2. Power on the board.
3. Use the TTL to USB Serial Converter cable to connect your computer with the board.
4. Get the right *ttyUSB* instance:

.. prompt::
   :prompts: $

   ls /dev/ttyUSB*

.. code-block:: text

   /dev/ttyUSB0

5. Connect minicom to the /dev/ttyUSB0 device:

.. prompt::
   :prompts: $

   minicom -D /dev/ttyUSB0 -t linux

The necessary communication parameters are decribed in :ref:`terminal-settings`

.. tip:: You should consider using minicom with logfiles. They can be enabled with the **-C** option. An example would be: ``minicom -D /dev/ttyUSB0 -t linux -C ${HOME}/log/minicom/minicom_usb0_$(date +%Y-%m-%d).log``.

.. note:: By default you can quit minicom :kbd:`CTRL` + :kbd:`A` and then :kbd:`Q`.

.. note:: If minicom does not show any target output following connection, reset the board/MCU.

Windows
~~~~~~~~~

You will need a host computer with a terminal program, e.g. *PuTTY*.

The following example is for a **Windows 10** host system.

1. Power on the board.
2. Use the TTL to USB Serial Converter cable to connect your computer with the board.
3. Check the *Device Manager* to see as which *COM* the USB connected.
4. For example, it would come up as *COM9*, configure PuTTY as follows:

.. image:: ./images/putty.png
   :alt: PuTTY configuration
   :scale: 60%

5. Hit "Open" and you should get terminal access to your board. Sometimes you have to hit the [Enter] key before you get an output.

.. hint::

   If your computer is not recognizing the TTL to USB Serial Converter cable you might try installing this driver: http://www.ftdichip.com/Drivers/CDM/CDM21228_Setup.zip