mirror of
https://github.com/rricharz/Tek4010.git
synced 2026-04-13 15:34:44 +00:00
new and easier to use README.md
This commit is contained in:
René Richarz
151
README.md
Normal file → Executable file
151
README.md
Normal file → Executable file
@@ -1,55 +1,124 @@
|
||||
# Tek4010 Emulator
|
||||
|
||||
# Tektronix 4010 and 4014 Storage Tube Terminal Emulator
|
||||
|
||||
terminal emulator for the Raspberry Pi, Linux, macOS (Macintosh) and Windows.
|
||||
Tek4010 is an emulator for Tektronix 4010/4014 graphics
|
||||
terminals. It reproduces the behavior of the original
|
||||
storage tube display, including realistic drawing speed
|
||||
and the true fading of the drawing spot over time.
|
||||
|
||||
All instructions can be found in [Manual.pdf](https://github.com/rricharz/Tek4010/blob/master/Manual.pdf)
|
||||
in the main Tek4010 directory. The installation is described there. For macOS, start with the preparation instructions in
|
||||
[macintosh.txt](https://github.com/rricharz/Tek4010/blob/master/macintosh.txt) in this repository. For Windows, start with
|
||||
the preparation instructions in [windows.txt](https://github.com/rricharz/Tek4010/blob/master/windows.txt) in this repository.
|
||||
This makes it possible to experience historical plot
|
||||
files and legacy Unix systems as they originally behaved.
|
||||
|
||||
|
||||
---
|
||||
|
||||
Below is a screen shot of the spacelab from the ICEMDDN CAD package made on a CDC Cyber 175 mainframe
|
||||
emulator.
|
||||
## Installation
|
||||
|
||||
|
||||
Choose your platform:
|
||||
|
||||
tek4010 can also display historical data for the
|
||||
[MIT Project MAC](https://en.wikipedia.org/wiki/MIT_Computer_Science_and_Artificial_Intelligence_Laboratory#Project_MAC)
|
||||
's ARDS (Advanced Remote Display Station):
|
||||
- Raspberry Pi / Linux → raspberrypi.txt
|
||||
- macOS → macos.txt
|
||||
- Windows (WSL) → windows.txt
|
||||
|
||||
|
||||
These files contain a short and simple installation guide.
|
||||
|
||||
tek4010 makes an effort to emulate the [storage tube display](https://en.wikipedia.org/wiki/Storage_tube)
|
||||
of the Tektronix 4010, including the fading bright drawing spot. If the look and feel is not important, you can
|
||||
use ["xterm"](https://en.wikipedia.org/wiki/Xterm) instead. "xterm" does not support all
|
||||
graphics modes of the 4014.
|
||||
More detailed instructions are available in:
|
||||
|
||||
It can be used to log into a historical Unix system such as
|
||||
[2.11 BSD](https://en.wikipedia.org/wiki/Berkeley_Software_Distribution) on the
|
||||
[PiDP-11](http://obsolescence.wixsite.com/obsolescence/pidp-11)
|
||||
or a real historical system. It can also be used to display historical plot data.
|
||||
- docs/raspberrypi.md
|
||||
- docs/macos.md
|
||||
- docs/windows-wsl.md
|
||||
|
||||
The following picture shows a scale model of the Tektronix 4010 crafted by
|
||||
Dave Ault using tek4010.
|
||||
---
|
||||
|
||||
|
||||
## Quick test
|
||||
|
||||
The storage tube emulator and the Tektronix 4010/4014 decoder were witten by Rene Richarz. The ARDS
|
||||
decoder was written by Lars Brinkhoff. He also provided some interesting historical documents and
|
||||
the ARDS plot files. Teunis van Beelen has written the helper program “rs232-console” to connect
|
||||
to a host using a serial link. Dave Ault tested the serial link to his PDP-11/73. The historical
|
||||
plot data for the Tektronix 4014 was obtained from Jos Dreesen. The special plot mode pictures
|
||||
with variable brightness were obtained from Monty McGraw. He also helped to debug the special
|
||||
plot point mode. The historical plot data of the spacelab from the ICEMDDN CAD package on a CDC
|
||||
Cyber 175 mainframe emulator was obtained from Nick Glazzard. He also helped to improve the GIN
|
||||
mode substantially. The CP/M GSXBASIC plot files are from Udo Munk. Thanks to Ian Schofield for
|
||||
his critical comments and a code snippet for drawing dashed and dotted lines, and to Oscar Vermeulen
|
||||
and Mark Matlock for their support. The manuals were obtained from bitsavers.org. Thanks also to all
|
||||
others who contributed important ideas, helped with the debugging and preserved the historical data.
|
||||
This program is the result of a community effort.
|
||||
After installation, run:
|
||||
|
||||
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.
|
||||
tek4010 -noexit cat test.plt
|
||||
|
||||
You should see a graphical display.
|
||||
|
||||
---
|
||||
|
||||
## Examples
|
||||
|
||||
Examples and demo files are included in the repository:
|
||||
|
||||
- demos/demo.sh
|
||||
- pltfiles/
|
||||
- ardsfiles/
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- This project is distributed as source.
|
||||
- Installation is intentionally simple and transparent.
|
||||
- If something does not work on a future system,
|
||||
it can be adapted locally.
|
||||
|
||||
---
|
||||
|
||||
## Background
|
||||
|
||||
This emulator is designed to support historical
|
||||
Unix environments and related hardware projects
|
||||
such as PiDP-11 systems.
|
||||
|
||||
This makes it possible to experience historical plot
|
||||
files and legacy Unix systems as they originally behaved.
|
||||
|
||||
---
|
||||
|
||||
## Installation
|
||||
|
||||
Choose your platform:
|
||||
|
||||
- Raspberry Pi / Linux → raspberrypi.txt
|
||||
- macOS → macos.txt
|
||||
- Windows (WSL) → windows.txt
|
||||
|
||||
These files contain a short and simple installation guide.
|
||||
|
||||
More detailed instructions are available in:
|
||||
|
||||
- docs/raspberrypi.md
|
||||
- docs/macos.md
|
||||
- docs/windows-wsl.md
|
||||
|
||||
---
|
||||
|
||||
## Quick test
|
||||
|
||||
After installation, run:
|
||||
|
||||
tek4010 -noexit cat test.plt
|
||||
|
||||
You should see a graphical display.
|
||||
|
||||
---
|
||||
|
||||
## Examples
|
||||
|
||||
Examples and demo files are included in the repository:
|
||||
|
||||
- demos/demo.sh
|
||||
- pltfiles/
|
||||
- ardsfiles/
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- This project is distributed as source.
|
||||
- Installation is intentionally simple and transparent.
|
||||
- If something does not work on a future system,
|
||||
it can be adapted locally.
|
||||
|
||||
---
|
||||
|
||||
## Background
|
||||
|
||||
This emulator is designed to support historical
|
||||
Unix environments and related hardware projects
|
||||
such as PiDP-11 systems.
|
||||
BIN
docs/images/screendump.png
Normal file
BIN
docs/images/screendump.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 354 KiB |
85
docs/raspberrypi.md
Executable file
85
docs/raspberrypi.md
Executable file
@@ -0,0 +1,85 @@
|
||||
# Tek4010 on Raspberry Pi
|
||||
|
||||
This page describes installation on Raspberry Pi OS.
|
||||
The same steps usually work on other Linux systems.
|
||||
|
||||
---
|
||||
|
||||
## Quick installation
|
||||
|
||||
Open a terminal and install required packages:
|
||||
|
||||
sudo apt-get update
|
||||
sudo apt-get install git libgtk-3-dev make gcc pkg-config
|
||||
|
||||
Download the source code:
|
||||
|
||||
git clone https://github.com/rricharz/Tek4010
|
||||
cd Tek4010
|
||||
|
||||
Build and install:
|
||||
|
||||
make clean
|
||||
make
|
||||
make install
|
||||
|
||||
If this is your first installation, you may reboot:
|
||||
|
||||
sudo reboot
|
||||
|
||||
---
|
||||
|
||||
## First test
|
||||
|
||||
Go to the directory containing test.plt and run:
|
||||
|
||||
tek4010 -noexit cat test.plt
|
||||
|
||||
You should see a graphical display.
|
||||
|
||||
The display speed can be adjusted if needed.
|
||||
|
||||
---
|
||||
|
||||
## Examples
|
||||
|
||||
Additional examples are available in the repository:
|
||||
|
||||
- demos/demo.sh
|
||||
- pltfiles/
|
||||
- ardsfiles/
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
Keeping the window open:
|
||||
|
||||
The option -noexit keeps the window open after the command has finished.
|
||||
|
||||
Remote systems:
|
||||
|
||||
When connecting to historical Unix systems, you may need rsh or telnet:
|
||||
|
||||
sudo apt-get install rsh-client
|
||||
|
||||
or
|
||||
|
||||
sudo apt-get install telnet
|
||||
|
||||
---
|
||||
|
||||
## For experienced users
|
||||
|
||||
- The program is built using make
|
||||
- make install installs the binary in a user-local location
|
||||
- Ensure that this location is included in your PATH
|
||||
|
||||
Manual build steps:
|
||||
|
||||
make clean
|
||||
make
|
||||
make install
|
||||
|
||||
If the system changes in the future, adapt package installation
|
||||
and build commands as required.
|
||||
35
raspberrypi.txt
Normal file
35
raspberrypi.txt
Normal file
@@ -0,0 +1,35 @@
|
||||
Tek4010 on Raspberry Pi / Linux
|
||||
===============================
|
||||
|
||||
This is a quick installation guide for Raspberry Pi OS.
|
||||
It also works on most Linux systems (e.g. Ubuntu).
|
||||
|
||||
Quick start:
|
||||
|
||||
1. Open a terminal and type:
|
||||
|
||||
sudo apt-get update
|
||||
sudo apt-get install git libgtk-3-dev make gcc pkg-config
|
||||
|
||||
2. Download the source:
|
||||
|
||||
git clone https://github.com/rricharz/Tek4010
|
||||
cd Tek4010
|
||||
|
||||
3. Build and install:
|
||||
|
||||
make clean
|
||||
make
|
||||
make install
|
||||
|
||||
4. Test:
|
||||
|
||||
tek4010 -noexit cat test.plt
|
||||
|
||||
You should see a graphical display.
|
||||
|
||||
The display speed can be adjusted if needed.
|
||||
|
||||
For full instructions, demos, and additional options, see:
|
||||
|
||||
docs/raspberrypi.md
|
||||
1
test.plt
vendored
Normal file
1
test.plt
vendored
Normal file
@@ -0,0 +1 @@
|
||||
6d:Ld M3o*P{:U5w+Z!u O }(Z#s7Y6d9B` ]3p+J~9]4w+H!t \a)Q$q7[6d\5|!N3p,A9Fx*W!s!Jg*H%m7[6c6X5x!_3q,V8O2{*H!r!Xm*^&h7Y6c5V5t"P3r-I}7X1)[!r"Gu+S'a7V6b4X5q#A3r-Zz7B1e)N!r"V~,F'y7Q6a3[5n#S3s.Iv6L0l)D!s#E"g,X(p7K6`3A5k$D3s.Vp5W/u(Z!t#U"q-I)f7D52Jh$U3s/Aj5B.~(R!u$D"|-Y)z6]5~1Tf%E3r/Jc4N.i(K!w$T#g.H*n6T5}1@c%U3r/S2{3[-u(E!z%C#r.U+`6K5{0Na&E3q/Y2s3H-b(@!|%R#~/A+q6B5z/]4~&U3o/_2j2V,p'\"`&A$j/L,b5X5y/N4|'D3m0C2a2E+'Y"c&P$w/W,q5N5w/A4y'R3k0G1w1T+o'W"h&_%c0@-`5D5v.U4w(@3h0I1m1D+a'V"lM%p0H-n4Y5t.J4u(M3e0J1cU*s'U"q\%}0O-{4O5s.A4r(Z3b0K0yG*f'V"w(I&i0V.g4E5q-Y4p)F2~0K0n/Y)z'W"|(W&v0[.s3Z5o-Q4n)Q2z0J0c/L)o'X#b)D'c1@.~3P5n-K4k)\2v0H/y/@)e'Z#i)P'o1D/h3G5l-E4h*F2q0F/n.U({']#p)]'|1G/r2]5j-A4f*P2l0D/d.J(s(@#w*H(h1J/{2S5h,]4c*Y2g0A.y.@(k(D#~*T(t1L0d2J5f,Y4`+A2b/^.o-V(d(H$e*^)`1N0l2A
|
||||
Reference in New Issue
Block a user