# gtkterm

**Repository Path**: pingdan/gtkterm

## Basic Information

- **Project Name**: gtkterm
- **Description**: linux 下的串口调试工具
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2014-09-07
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

                GTKTerm : a GTK+ serial port terminal
                =====================================

                          Original Code by:
                          (c) Julien Schmitt
                 http://www.jls-info.com/julien/linux

                       Currently Maintained At:
                  https://fedorahosted.org/gtkterm/
                By Zach Davis zdavkeos -at- gmail.com

Version 0.99.7

Notice:
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.


Command line options
  --help or -h : this help screen
  --config <configuration> or -c : load configuration
  --port <device> or -p : serial port device (default /dev/ttyS0)
  --speed <speed> or -s : serial port speed (default 9600)
  --bits <bits> or -b : number of bits (default 8)
  --stopbits <stopbits> or -t : number of stopbits (default 1)
  --parity <odd | even> or -a : parity (default none)
  --flow <Xon | CTS> or -w : flow control (default none)
  --delay <ms> or -d : end of line delay in ms (default none)
  --char <char> or -r : wait for a special char at end of line (default none)
  --file <filename> or -f : default file to send (default none)
  --echo or -e : switch on local echo

Keyboard shortcuts 
  As Gtkterm is often used like a terminal emulator,
  the shortcut keys are assigned to <ctrl><shift>, rather than just
  <ctrl>.  This allows the user to send keystrokes of the form <ctrl>X
  and not have Gtkterm intercept them.

  <ctrl><shift>L -- Clear screen
  <ctrl><shift>R -- Send file
  <ctrl><shift>Q -- Quit 
  <ctrl><shift>S -- Configure port
  <ctrl><shift>V -- Paste
  <ctrl><shift>C -- Copy
  <ctrl>B	 -- Send break

NOTES on RS485:
     The RS485 flow control is a software user-space emulation and therefore
may not work for all configurations (won't respond quickly enough).  If this is
the case for your setup, you will need to either use a dedicated RS232 to 
RS485 converter, or look for a kernel level driver.  This is an inherent 
limitation to user space programs.


Building:
 GtkTerm has a few dependencies-
* Gtk+2.0 (version 2.6 or higher)
* vte (version 0.20 or higher)
* intltool (version 0.40.0 or higher)

 Once these dependencies are installed, most people should simply run:
  ./configure
  make

 And to install:
  make install

 If you wish to install Gtkterm someplace other than the default directory, use:
   ./configure --prefix=/install/directory
 Then build and install as usual.

 See INSTALL for more detailed build and install options.