view README @ 105:1e820ed0904e

Installed-binaries: list of binaries installed by this package I am establishing a new convention for all FreeCalypso tools, across different packages and source repositories: each FC tools package will have a file name Installed-binaries listing all user-invokable binaries that package installs in /opt/freecalypso/bin. These files are to serve as an aid to users and distro package maintainers who prefer to not add /opt/freecalypso/bin to their PATH. The alternative to adding this directory to PATH is to create a symlink for every installed binary in some standard location such as /usr/bin or /usr/local/bin, pointing to the actual binary in /opt/freecalypso/bin; having a list of all FC-installed binaries in a standardized format will allow this process to be automated.
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 29 Sep 2023 19:42:53 +0000
parents f2542deec11a
children
line wrap: on
line source

The present package is a set of tools for working with USB-serial interface
chips, specifically those FTDI and Silabs chips that are of relevance to
FreeCalypso.  The following tools are included:

* Utilities for examining the non-volatile baud rate configuration on CP2102
  adapters and for reprogramming their EEPROM, switching between "standard"
  230400/460800/921600 and GSM-specific 203125/406250/812500 baud rates;

* A utility for switching a FreeCalypso DUART28 adapter between C and S
  configurations, as well as checking the current configuration;

* General-purpose FT2232x and FT232R EEPROM programming tools.

The common theme across all of these tools is that they talk to a USB-interfaced
chip at the native USB level, bypassing the usual abstraction of ttyUSB, and
thus require libusb.  More specifically, our tools are built on libusb-0.x API,
consisting of <usb.h> include header and -lusb link library pull-in; on "modern"
systems these pieces will typically be provided by libusb-compat-0.1 package
wrapping around libusb-1.x, but in the spirit of Holy retrocomputing, really old
systems can be used with native libusb-0.1.