README file for serial-com version 0.0.9

Copyright(c) 2006-2009, Jochen Arndt <j.arndt@sis-germany.com>

This program is distributed under the terms of the GNU General Public License.
See COPYING for additional information.


Brief Description

    serial-com is a simple program to communicate with serial devices.
    The program accepts three kinds of command input:
    - from stdin:
      This is the default if no command file and no commands are
      specified. Input is processed line by line until EOF (Ctrl-D) or
      an empty line. Think of this mode as a simple terminal program.
    - from command line arguments:
      Send each additional command line argument to the serial device
      end exit. Commands containing white space characters should be
      quoted. Command line commands are not processed if an input file
      is specified.
    - from file:
      Sends the content of a text file line by line to the serial device.
      Lines are send as read from file with some exceptions:
      - Empty lines are ignored.
      - Leading white space characters are ignored.
      - Lines starting with the '#' character are ignored.
        This applies also to lines with only white space characters in
        front of the '#' character.


Tested Environments

    SuSE Linux 9.1, Kernel 2.6.4


Requirements



Installation

    make
    make install, or
    make install-strip

Installed Files

    serial-com (installed to /usr/local/bin/serial-com)
    The program.

    serial-com.1 (installed to /usr/local/man/man8)
    Man page.
	
    serial-com.conf (installed to /usr/local/etc/serial-com.conf)
    Example configuration file. See file itself for usage.


Change Log

2009-05-13 0.0.9
    serial-com.c: Replaced printf(rx_buffer) by printf("%s", rx_buffer)
                  to avoid parameter expansion if strings contain % character
2007-02-15 0.0.8
    serial.c: reset_serial(): Set irq to 0
2007-02-05 0.0.7
    serial-com.c: Expected answer comparison is now case in-sensitive
    serial-com.c: Added -i / --interactive option
    serial-com.c: Interactive mode is no longer default
    serial-com.c: Added -r / --reset option and RESET command
    serial-com.c: Added 'false' boolean parameter
    serial-com.c: Added string parameters for level options and commands
    serial.c: open_port(): Optional reset
    parse.c: Added strcasestr() function
2007-02-02 0.0.6
    serial-com.c: Changed behaviour of serial configuration commands:
     Non-specified options will use actual settings rather than defaults.
    serial-com.c: Renamed option -l, --databits to -d, --databits (--debug still present)
    serial-com.c: Added -l, --showconfig option
    serial-com.c: Modified print_config() to be used for -l and -w options
    serial-com.c: Changed flow control options:
     Added options -c/C, --[no]crtscts
     Changed option -x, --xonxoff to -X, --xonxoff,
     Added option -x, --noxonxoff
    serial-com.c: Added 'none', 'even', and 'odd' parameters for PARITY
     config command and -p, --parity option
    serial-com.c: Added --holdconfig option and HOLDCONFIG config command
    serial-com.c: Added SYSLOG config command
    serial.c: Added reset_serial() function
2007-01-25 0.0.5
    serial-com.c: Toggle DTR if still active
2007-01-10 0.0.4
    Changed code to use actual serial config as preset
    Added FILE, SEND, and SENDNL config commands
    Moved functions to new source files message.c, parse.c, serial.c
2006-12-20 0.0.3
    Added flushing in open_port() and close_port()
    Changed local_echo bits: Splitted ECHO_RX into _CMD and _ANSWER
    Added NULL command to send nothing but wait for answer
    Device prefix '/dev/' and '/dev/ttyS' may be now omitted
2006-12-12 0.0.2
    Minor fixes
2006-11-02 0.0.1
    First version