Copyright and Licensing

README.md is part of the MPX Capture project.

This project is released as free software by permission of Tatonduk Outfitters Limited.

SPDX-FileCopyrightText: 2024 Christopher Howard christopher@librehacker.com

SPDX-FileCopyrightText: 2024 Tatonduk Outfitters Limited

SPDX-License-Identifier: GPL-3.0-or-later

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 https://www.gnu.org/licenses/.

Description

This project provides some Elisp functions which I used to capture file listings from an MPX terminal, provided through a 7E1 serial connection to an emulated SEL system, which is part of some legacy equipment I maintained for work. The files can be listed, i.e., displayed on the terminal, and saved that way. But doing this efficiently requires some intelligent interaction with the terminal because the output is paged, i.e., you have to send a CR after every screen full of data. There are functions also for capturing multiple files in this way, as well functions to make logging files (i.e., printing out what files exist) easier.

I can't imagine anyone else will need to use this code for its intended purpose. It is, however, a real world example of how Emacs could be used to script interactions with a serial terminal (or other terminal). Therefore, I wanted to make the code available under a free software license, so it could later be studied or adapted by myself or by others.

The code was developed and used on Emacs 29.4 (mingw 64-bit).