Changes since tio v3.8 (2024-11-30):

• Fix parsing of timestamp options

• codeql: Upgrade to upload-artifact@v4

• Update plaintext man page

• Add character mapping examples

• Fix pattern matching memory corruption

Samuel Holland:

• Don't add null characters to the expect buffer

  They prevent regexec() from seeing the remainder of the buffer.

V:

• Disable stdout buffering globally

  This makes it possible to pipe output to other programs cleanly.

Lubov66:

• docs: edited the license date

Jakob Haufe:

• Manpage: Fix backslash encoding

  Literal backslash needs to be written as \e.

Changes since tio v3.7 (2024-08-31):

• Rename git version to simply version

• Clean up lua API

  Rename modem_send() to send()
  Rename send to write()

• Zero initialize buffer in read_string()

• Use version from git

• Fix memory leak in base62_encode()

• Fix name declaration conflict with socket send()

• Add clang-format spec

Keith Hill:

• Add system timestamps to lua read() and new lua read_line() per global options
• Add missing timestamp-format epoch
• Update send_ to use fsync and tcdrain like normal tty_sync does
• Rework read_line to save partial line at timeout
• Simplified read_line to reduce cyclomatic complexity
• renamed example files read.lua and read_line.lua
• moved #define READ_LINE_SIZE to top of file
• renamed g_linebuf to linebuf, and moved it into read_line as a static variable

Changes since tio v3.6 (2024-07-19):

• Remove unnecessary sync in line input mode

  This caused a problem for some highly timing sensitive modem read-eval-print
  loops because the input line and line termination characters (cr/nl) would be
  shifted out on the UART with too big delay inbetween because of two
  syncs.

• Fix socket send call on platforms without MSG_NOSIGNAL

  To fix build issue encountered on MacOS Catalina but may apply to other
  platforms.

Steve Marple:

• Add "epoch" timestamp option

  Add an option that prints the timestamp as the number of seconds since
  the Unix epoch.

Tomka Gergely:

• The log-directory options is not read from the configuration file.

=== tio v3.6 (2024-07-19) ===

Changes since tio v3.5 (2024-06-29):

• Add configuration file include directive

  To include the contents of another configuration file simply do e.g.:

  [include raspberrypi.conf]

  Also, included file can include other files which can include other
  files etc.

  This feature is useful for managing many configuration files and sharing
  configuration files with others.

• Mention how to list key commands in help output

• Fix hex output mode when using normal input mode

  In this combination of modes the input character was not forwarded to
  the tty device. This fix makes sure it is forwarded.

• Fix uptime on MacOS

  On MacOS the birth time is apparently not available so we use
  modification time instead.

• Improve warning upon failing connect

  Add device path to warning when connect fails.

• Fix crashy search_reset() on macOS

• Clean up shadow variable

• Clean up readline code

• Improve listing of long device names

• Fix listing of serial devices on macOS

Heinrich Schuchardt:

• Print correct 'Done' timestamp for X- and Y-modem transfers

  Call tio_printf() after completing xymodem_send().

Robert Lipe:

• Recompute listing_device_name_length_max for MacOS case, too.

Changes since tio v3.4:

• Clarify input and output direction of map flags

• Rename mapping flag MSB2LSB to IMSB2LSB

  This is the correct naming since we are changing the input bit order on
  input from the serial device.

• Add OIGNCR mapping flag

  Ignores CR on output to serial device.

• Fix line input mode ignoring characters ABCD

• Fix tainted print

Jakob Haufe:

• Fix typos

Changes since tio v3.3:

• Update configuration output

• Clean up script run interaction text

• Fix unbounded writes

• Add history and editing feature to line input mode

  Use up and down arrow keys to navigate history.

  Use left and right arrow keys to move cursor back and forth.

  We try mimic the behaviour of GNU readline which we can not use because
  we also need to react to key commands.

• Reuse socket address

  To avoid having to wait for socket timeout when restarting server.

• Fix line input mode

  Fix so that ABCD are no longer ignored.

• Make sure ICRNL, IGNCR, INLCR take effect

• Include correct header for poll()

• Add group write permission to xymodem received file

• Fix missing open() flags in xymodem_receive()

Vyacheslav Patkov:

• Show current mappings in the configuration printout

• Use "ctrl-t m" to change mappings interactively

• Prompt for Lua script or shell command in interactive session

Eliot Alan Foss:

• Added support to receive XMODEM-CRC files from the connected serial port.

Changes since tio v3.2:

• Force destructive backspace when using local echo

  Only takes effect in normal output mode.

• Fix local-echo in configuration file

• Clean up includes

• Force socket write operation to ignore any signals

• Man page cleanup

Changes since tio v3.1:

• Do not print error when using --list with broken config file

• Clean up completion script

• Add option '--exec ' for running shell command

  Runs shell command with I/O redirected to device.

• Make sure all error output is directed to stderr

• Fix shadow variables

• Update man page

• Fix build on older GNU/Linux systems without statx

• Fix line ending in --list output

• Print location of configuratin file in --list output

• Fix alignment of profile listing

Changes since tio v3.0:

• Improve --list feature on non-linux platform

• List available profiles in --list output

• Always message when saving log file

• Add support for using TID as device in config file

• Fix use of invalid flag with regexec()

• Fix potential buffer overflow in match_and_replace()

• Fix profile autocompletion

• Remove inih dependency from CI builds

• Replace use of stat() with fstat()

  For better security.

• Fix hexN output mode

• Update pattern matching example

• Fix submenu response when invalid key hit

• Replace inih with glib key file parser

  After including the use of glib we might as well replace inih
  with the glib key file parser.

  All configuraiton file parsing has been reworked and also the options
  parsing has been cleaned up, resulting in better and stricter
  configuration file and option value checks.

  Compared to old, configuration files now requires any default
  configurations to be put in a group/section named [default].

  Configuration file keywords such as "enable", "disable", "on",
  "off", "yes", "no", "0", "1" have been retired. Now only "true" and
  "false" apply to boolean configuration options. This is done to simplify
  things and avoid any confusion.

  The pattern option feature has been reworked so now the user can now
  access the full match string and any matching subexpression using the
  %mN syntax.

  For example:

  [usb devices]
  pattern = usb([0-9]*)
  device = /dev/ttyUSB%m1

  Then when using tio:
  $ tio usb12

  %m0 = 'usb12' // Full match string
  %m1 = 12 // First match subexpression

  Which results in device = /dev/ttyUSB12

• Remove CircleCI

  Replaced with github workflow CI.

• Add github workflow for Ubuntu build

• Enable extended pattern matching

  So that the exclude options can also work as include using special
  pattern syntax.

  For example, to only include /dev/ttyUSB* devices simply do:

  $ tio --exclude-devices=!(/dev/ttyUSB*) --list

  See the man page of fnmatch() for all available extended pattern
  options.

• Update lua read() description

Rui Chen:

• fix: add build patch for FNM_EXTMATCH

• feat: add macos workflow

• fix: add macos build patch for fs_get_creation_time

Changes since tio v2.8:

• Simplify lua line manipulation API

  Collapses lua high(), low(), toggle(), config_high(), config_low(),
  config_apply() into one simple function:

  set{<line>=<state>, ...}

  Line can be any of DTR, RTS, CTS, DSR, CD, RI.

  State is high, low, or toggle.

  Example:
  script = set{DTR=high, RTS=low}; msleep(100); set{DTR=low, RTS=high}; msleep(100); set{RTS=low}

  Notice the use of {} instad of () when calling the set function. This is
  required to pass parameters by name in lua.

• Disable DEC Special Graphics at exit if vt100

  If a vt100 terminal receives the Shift In character '\016' it will
  enable the 7 bit DEC Special Graphics character set used for line drawing.

  For most users this can happen due to line noise from the tty device and
  will likely mess up your terminal even after tio exits.

  To better handle this we want to make sure that tio disables this mode
  by sending the Shift Out character '\017' at exit.

  This mechanism will only activate if environment variable TERM assumes
  value "vt100".

• Add hexN output mode

  Adds support for hexN mode where N is a number in the range 1 to 4096
  which defines how many hex values will be printed before a line break.

  In short, it defines the width of the hex output.

  In this mode, if timestamps are enabled they will be added to each hex
  line.

• Rename sub-config to profile

  Because better naming.

• Use lua io.write() instead of print()

  io.write() gives better output control as print() is hardcoded to always
  print a newline.

• Add new ways to manage serial devices

  • Rename --list-devices to --list

  • Rename --no-autoconnect to --no-reconnect

  • Switch -l and -L options

    • -l now lists available serial devices

    • -L enables log to file

  • Add option --auto-connect

    • Supported strategies:

      • "new" - Waits to connect first new appearing serial device

      • "latest" - Connects to latest registered serial device

      • "direct" - Connect directly to specified serial device (default)

  • Add options to exclude serial devices from auto connect strategy by
    pattern

    • Supported exclude options:

      • --exclude-devices

        Example: '--exclude-devices "/dev/ttyUSB2,/dev/ttyS?"'

      • --exclude-drivers

        Example: '--exclude-drivers "cdc_acm"'

      • --exclude-tids

        Example: '--exclude-tids "yW07,bCC2"'

      • Patterns support '*' and '?'

  • Connect to same port/device combination via unique topology ID (TID)

    • Topology ID is a 4 digit base62 encoded hash of a device topology
      string coming from the Linux kernel. This means that whenever you
      plug in the same e.g. USB serial port device to the same USB hub
      port connected via the exact same hub topology all the way to your
      computer, you will get the same unique TID.

    • Useful for stable reconnections when serial device has no serial
      device by ID

    • For now, only tested on Linux.

  • Reworked and improved listing of serial devices to show serial devices:

    • By device

      • Including TID, uptime, driver, and description.

      • Sorted by uptime (newest device listed last)

    • By unique topology ID

    • By ID

    • By path

  • Add script interface 'list = tty_search()' for searching for serial
    devices.

• Clean up timestamp enum definition

• Add missing options to show configuration

• Update description of mute option

• Add lua read_string() function

• Don't forget to log output in lua expect()

• Generalize automatic login example for Linux

• Fix log output in hex output mode

• Add timeout based timestamps in hex output mode

  This change reintroduces timestamping in hex output mode but based on
  timeout instead of new lines which made no sense. This means that
  timestamps will only be printed when timeout time has elapsed with no
  output activity from serial device.

  Adds option --timestamp-timeout for setting the timeout value in
  milliseconds.

  Defaults to 200 ms.

• Improve switched messages

• Extend lua expect() to also return matched string

• Add automatic login script example

• Organize examples directory

• Introduce basic line input mode

• Cleanup global variable name shadowing

Davis C:

• Updated login example with new expect logic

• Reset buffer size at start of expect

• Return 1 when expect matches