Loading files…
A VT100 terminal emulator for Raspberry Pi Zero, forked and refactored from PiGFX by Filippo Bergamasco, now rebranded as PiVT100 and enhanced for use with a custom 60% VT100 replica case and adapter board.
Main motivation was that I wanted a terminal emulation for my VT100 replica. Emulation should start within seconds, so a bare metal implementation on a Pi Zero seems to be the way to go. I found the PiGFX implementation by Filippo Bergamasco and used that as a starting point for my modifications.
Below you see the original VT100 terminal (the color has turned to yellow over the years) and my 60% replica.
If you want a 100% VT100 terminal emulation please go for the VT100 simulation from Lars Brinkhoff (https://github.com/larsbrinkhoff/terminal-simulator)). He simulates the VT100 hardware with original ROMs on a Raspberry Pi.
My list of requirements was rather short:
The original PiGFX codebase by Filippo Bergamasco has been reduced to the pure VT100 terminal functionality, fully refactored and renamed as PiVT100. Major changes include:
pivt100.elf, config file is pivt100.txt, font tools and scripts updated to PiVT100 namingpivt100.txt file parsing with better error handlingThe following picture shows the setup dialog:
The custom PCB provides:
Below you see the schematic of the adapter board. The KiCad project is located in directory hardware.
The following picture shows the prototype of the adapter board still with linear voltage regulator. Final version will hold a switching buck regulator to reduce heat.
The cable on top of the picture going to the Pi Zero connects the D+/D- pins of the USB connector at the back to two testpoints on the Pi. This allows the usage of a standard USB keyboard to be connected to the Pi Zero without additional adapter. For more details please see https://maker-tutorials.com/raspberry-pi-zero-mit-usb-buchse-typ-a-erweitern-anloeten/.
As it's very hard to find a real RS232 null modem cable, the signal relay (blue) is used to switch the Rx and Tx lines to simulate a null modem cable, if required. The resistors between Pi Zero and relay are used to level shift the RxD signal (only signal that goes into the Pi) to voltage levels below 3.3V. The connectors on the back besides the USB-A are a Mini DIN6 connector (for a custom connection to an MBC2-Z80), an RS232 connector module and a 5.5mm power connector.
More information is given in directory hardware.
The 3D printable back plate features:
This back cover fits into the opening at the back of the VT100 case and has supports to connect the PCB (holes have to be drilled manually to allow for small adjustments). There is also a support to hold the SD card extension to allow changing the SD card at the back of the case. The other openings fit the connectors on the adapter board and allow mounting of a small ON/OFF switch.
The case was printed on a Bamboo Lab P1S printer using the STL-files provided by megardi. I discovered that the different parts which have to be glued together did not always fit very well. So be prepared to use a lot of filler and do a lot of sanding. It took some time but in the end the result was quite good. I used a special filler for plastics to prepare for the final painting. I discovered that the original color of the VT100 was "oyster white" and by comparing a RAL color table with a picture of the inside of a real VT100 I found that RAL 1013 fits very well.
Here are some pictures of the assembly process:
I used a simple 8'' display from Aliexpress with 1024x768 pixels. The display had no brightness regulation (neither per HDMI nor external). For the future I would recommend using a controller with brightness control, if possible through software.
In the pictures above I used the resolution 800x640 pixel. With 1024x768 the first 2 characters are covered by the screen bezel.
To connect the display to the Pi Zero I used a flexible adapter cable miniHDMI to miniHDMI (C1-C1). I also installed an SD Card extension cable for easy access to the SD card slot at the back of the case.
Display: https://de.aliexpress.com/item/1005004162403387.html?spm=a2g0o.order_list.order_list_main.64.759e5c5fCtHg3D&gatewayAdapt=glo2deu Cable: https://de.aliexpress.com/item/1005008622570470.html?spm=a2g0o.order_list.order_list_main.59.7f095c5f7ZEnkL&gatewayAdapt=glo2deu SD Card Extension: https://de.aliexpress.com/item/4001200431510.html?spm=a2g0o.order_list.order_list_main.87.759e5c5fCtHg3D&gatewayAdapt=glo2deu
bootcode.bin, start.elf, kernel.img and pivt100.txt to SD card rootpivt100.txt on SD card for persistent settingspivt100.txt)# Display Settings
displayWidth = 1024
displayHeight = 768
fontSelection = 2
foregroundColor = 10
backgroundColor = 0
# UART Settings
baudrate = 115200
switchRxTx = 0
# Keyboard Settings
keyboardLayout = us
useUsbKeyboard = 1
keyboardAutorepeat = 1
# Audio Settings
soundLevel = 50
keyClick = 1
# Build for Raspberry Pi Zero
make RPI=1
# Clean build
make clean
/hardware directory (KiCad format)/OpenScad/doc for detailed assembly instructionsThis project is a fork and full refactor of PiGFX by Filippo Bergamasco. All code, configuration, and documentation have been updated to use the PiVT100 name and structure. The original project provided the core VT100 terminal emulation and graphics capabilities.
VT100 replica in 60% size was designed by megardi (https://www.instructables.com/23-Scale-VT100-Terminal-Reproduction/).
Copyright (C) 2014-2020 Filippo Bergamasco (Original PiGFX) Copyright (C) 2025 Ralf Zühlsdorff (PiVT100 Edition)
Licensed under the MIT License - see LICENSE file for details.
Contributions welcome for:
No comments yet. Be the first to ask about this board.