mirror of
https://github.com/lowobservable/oec.git
synced 2026-02-27 17:13:57 +00:00
73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
# oec
|
|
|
|
IBM 3270 terminal controller - a replacement for the IBM 3174.
|
|
|
|
|
|
|
|
This project aims to create an open replacement for the IBM 3174 Establishment
|
|
Controller, specifically for users looking to connect an IBM 3270 type terminal
|
|
to the Hercules emulator. For background on this project, IBM 3270 type
|
|
terminals and controllers, see
|
|
_[Building an IBM 3270 terminal controller](https://ajk.me/building-an-ibm-3270-terminal-controller)_.
|
|
|
|
## Features
|
|
|
|
It is a work in progress and is far from providing all the features you might
|
|
expect from a later model 3174, but it does provide basic TN3270 and VT100
|
|
emulation.
|
|
|
|
- [x] TN3270
|
|
- [x] Basic TN3270
|
|
- [ ] TN3270E
|
|
- [ ] EAB (Extended Attribute Buffer)
|
|
- [ ] SSL/TLS
|
|
- [ ] Non-English character sets
|
|
- [x] VT100
|
|
- [ ] Connection menu
|
|
- [ ] MLT (Multiple Logical Terminals)
|
|
|
|
## Supported Terminals
|
|
|
|
Only CUT (Control Unit Terminal) type terminals are supported. I have tested oec with the following terminals:
|
|
|
|
* IBM 3278-2
|
|
* IBM 3483-V (InfoWindow II)
|
|
|
|
You may have to modify the key mapping to support your specific terminal configuration.
|
|
|
|
## Usage
|
|
|
|
You will need to build an [interface](https://github.com/lowobservable/coax) and connect it to your computer.
|
|
|
|
You will need Python 3.8 installed.
|
|
|
|
I'd recommend using a Python [virtual environment](https://docs.python.org/3/library/venv.html) to isolate oec from your system-wide packages:
|
|
|
|
```
|
|
python3.8 -m venv VIRTUALENV
|
|
source VIRTUALENV/bin/activate
|
|
```
|
|
|
|
Install dependencies using `pip`:
|
|
|
|
```
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
Assuming your interface is connected to `/dev/ttyACM0` and you want to connect to a TN3270 host named `mainframe`:
|
|
|
|
```
|
|
python -m oec /dev/ttyACM0 tn3270 mainframe
|
|
```
|
|
|
|
If you want to use the VT100 emulator and run `/bin/sh` as the host process:
|
|
|
|
```
|
|
python -m oec /dev/ttyACM0 vt100 /bin/sh -l
|
|
```
|
|
|
|
## See Also
|
|
|
|
* [coax](https://github.com/lowobservable/coax) - Tools for interfacing with IBM 3270 type terminals
|
|
* [pytn3270](https://github.com/lowobservable/pytn3270) - Python TN3270 library
|