view README @ 107:bc3367755586 default tip

add INSTALL document
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 21 Nov 2023 22:11:09 +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.