From ArmadeusWiki
Jump to: navigation, search

GTKTerm is a graphical serial line terminal emulator that allows you to take control of your board through the Serial line. With it you can have access to the U-Boot/Linux console of your APF without needing to connect a keyboard/screen to the board. (For more informations on remote console)


On *Ubuntu / Debian

 $ sudo apt-get install gtkterm

or use your graphical package manager.

On Fedora

# rpm -q ???


  • Launch it and it will create a default configuration file:
 $ gtkterm
  • In the "Configuration" menu select "Ports" and set the parameters to:
Port: /dev/ttyS0       Speed:115200    Parity: None
Bits: 8                     Stop bit: 1           Flow control: None
  • Press OK then in the same menu save the configuration as "armadeus". Next time you will launch GTKTerm don't forget to reload this configuration.
  • In this example, we assume that your serial port is /dev/ttyS0 (first serial port). Change this to the appropriate value if necessary. For example if you use an USB <-> Serial converter then serial port would surely be named like that: /dev/ttyUSB0 or /dev/ttyACM0
  • If your USB <-> Serial converter doesn't seem to work, run the dmesg command. You should read this thread if you see some disconnection data like this :
[ 2445.568000] usb 1-1.4: new full speed USB device using uhci_hcd and address 22
[ 2446.964000] ftdi_sio ttyUSB0: FTDI USB Serial Device converter now disconnected from ttyUSB0
[ 2446.964000] ftdi_sio 1-1.4:1.0: device disconnected
  • Check that you have read/write rights on /dev/ttyS0 (ie your serial port): your user ID (here julien) should be part of the serial port access group (here dialout):
$ ls -al /dev/ttyS0
crw-rw---- 1 root dialout 4, 64 2009-05-15 14:56 /dev/ttyS0
$ id
uid=1000(julien) gid=1000(julien) groupes=4(adm),20(dialout),...