View source for Rock/Serial debug tools Setting

__TOC__

This page describe how to set up and debug the radxa rock board via serial console.

===Windows===
Here we use putty as an example to show us how to set the  serial debug tools.

Double click the Putty.exe, you will see the interface like:

[[File:serial_debug_0.png]]

Select the Serial, Fill the Serial line with the right serial port,and the Speed with 115200 

[[File:serial_debug_2.png]]

You can get the serial port here:

[[File:serial_debug_1.png]]

Finish setting , Click Open the putty will work

[[File:serial_debug_3.png]]

===Linux===

For connecting UART/Serial console on Linux, the [https://code.google.com/p/picocom/ picocom] utility is very handy to use in a Terminal session. You can also use [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY] for this purpose.

==== picocom ====

If you are using Ubuntu, you need to add the current user into group ''dialout'', then close your session and relogin to make changes effective immediately:

  sudo adduser $USER dialout
  gnome-session-quit

Install picocom:

  sudo apt-get install picocom

Open connection to serial line, using 115200 bauds:

  picocom /dev/ttyUSB0 -b 115200 -e w

Note: Escape character is set to 'w', you have to press Ctrl-w Ctrl-x to quit.

==== PuTTY ====
Here we still use PuTTY as an example.
when start PuTTY firstly  you will see this interface:

[[File:serial_debug_linux_0.png]]

Select the Serial, Fill the Serial line with the right serial port,and the Speed with 115200 

[[File:serial_debug_linux_1.png]]

How to get the serial port .First cat /proc/tty/drivers, to make sure is there driver support(radxa board is connected with pc via USB so the device name should be usbserial)

[[File:serial_debug_linux_2.png]]

Here we find the line  

 usbserial            /dev/ttyUSB   188 0-253 serial  

which  tell us the driver is ok, then cd /dev/   to confirm whether is there device named ttyUSB* . you can unplug and then plug the usb to get the right device.

[[File:serial_debug_linux_3.png]]

Finish setting, Click Open the putty will work!

[[File:serial_debug_linux_4.png]]


Note:

1、Under Ubuntu If you  got the following error – “'''Unable to open connection to: Unable to open serial port'''“.  To fix it, add the current user to the “dialout” user group , logout and login to  take effect, detail:

  [http://jesin.tk/fix-serial-port-permission-denied-errors-linux/  http://jesin.tk/fix-serial-port-permission-denied-errors-linux/ ]

=== Mac OS X ===

# You need to buy a [https://www.adafruit.com/products/954 USB to TTL Serial Cable] and install the [http://www.prolific.com.tw/US/ShowProduct.aspx?p_id=229&pcid=41 PL2303 Mac OS X Driver] from Prolific Technology. <br/> You will have to reboot after installing the drivers.
# Connect Black line on GND, White line on TX and Green line on RX.
# Use [http://brew.sh Homebrew] package manager to install picocom, then use picocom to dialog with Debug UART/Serial Console.
    brew install picocom
    picocom /dev/tty.usbserial -b 115200 -e w

Note: Type Ctrl-w Ctrl-x to exit session.