Skip to content

Pixelbo/Minitel-raspi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Minitel-Raspi

Chapters
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. HELP!

About-the-project

Minitel-Raspi is a project that reunites the famous french Minitel and the famous Raspberry Pi.

This project did not modify the Minitel, I used the external serial port for printing into the screen.

Originaly begun in 2020 this project is driven by a kid, so go easy on me, I can't use github proprely.

Beside the fact that I've put a Raspi into Minitel, I've also created a small gui project that control for now the Logitec Music Server. Maybe I'll do someday a thing about another API.

Getting Started

Prerequisites

  • For this project we obviously need a Minitel, I use the Minitel 1B; other Minitel works probably fine but I havn't tested yet.

  • We need also a Raspberry Pi; I use the model 2B. It's better to have a wi-fi connection for this because it's impossible to work directly with the Minitel (slow frame-rate).

  • For the conversion from the Raspi to the Minitel, you will need a FTDI USB to serial UART converter, it need to be at 3.3V; If you don't have this, I suggest you to take a look at the HELP! chapter.

-Finally the communication will not be wireless, so you will need a wire; the minitel has a back DIN socket serial port (for more information see HELP!)

Automatic Installation

Ok so you have everything and you want of course a terminal on your Minitel!

Lucky for you, I've made an automatic setup that will do everything for you!

Just download the setup.sh in the releases and execute it in sudo mode; Go to Finishing Installation for finishing the installation! !!!!NEVER execute it twice, it will break everything; if there was an error during installation, report to te Manual Installation!!!

The installation process will do various things that is explained just below.

Installation diagram

Manual Installation

So you want to do it manually, ok no problem;

  1. First of all we need to create the user Minitel:
useradd -m -p 'Minitel' -G sudo 'Minitel'
cd '/home/Minitel
  1. Then we need to clone this repo:
git clone 'https://github.com/Pixelbo/Minitel-raspi'
cd 'Minitel-raspi'
  1. The PyMinitel Library is essential to this project:
git clone 'https://github.com/paullouisageneau/PyMinitel'
cd 'PyMinitel'
python3 setup.py install
cd ..
rm -r PyMinitel
  1. Finally we install pyserial and do various QoL things:
pip3 install pyserial
echo 'export LANG=fr_FR.iso88591'>> /home/Minitel/.bashrc
echo '/home/Minitel/Minitel-raspi/Project/Main.py'>> /home/Minitel/.bashrc #comment this line if u don't want the project at startup
sudo tic "/home/Minitel/Minitel-raspi/Minitel_related/term.ti"

Finishing Installation

Finishing Installation

Ok you're not entirely set for now, you need to maybe change the baudrate depending on your Minitel version.

For changing the baudrate, you need to edit two files:

init.py, At line 8, there is the baudrate var; default is 4800 baud.

and tty.py, At line 25, there is the baudrate var; default is 4800 baud.

Here is the table for the baudrates:

Minitel Version Badurate
1 1200
1B 4800
2 9600

Usage

Ok everything about the Minitel is in the folder Minitel_relted:

If you want to Startup the proces for the Minitel; execute Startup.sh If you want to Shutdown the proces for the Minitel; execute Shutdown.sh

If you want that it does it automaticly, you will need more wiring:

TODO

Roadmap

  • Minitel <=> communication
  • Proper key input with the special keyboard
  • Proper Setup.sh
  • Project:
  • Whiptail with python
  • Main Menu
  • LMS control
  • adding translation
  • testing
  • another API

Contributing

You're free to contribute ! Just do some issues and some pull requests; You can also fork this repo !

Beware of the licenses that you'll use!

License

it's the license, respect it

License for this project is under CC BY-NC-SA 3.0

Author: Boris Hilkens

Other licenses:

Whiptails-Python:

Under BSD License: See LICENSE_WHIPTAILS
Github

PyLMS

Github

PySerial

See LICENSE_PYSERIAL
Github

PyMinitel

See LICENSE_PYMINITEL
Github

Chapelier Fou.org

See LICENSE_CHAP Website

Contact

E-mail: pixelbo21@gmail.com

HELP!

Ok you need help;

there are the options:

-Permission denied:

sudo chmod -R 777 Minitel-raspi

If this don't work, see if your drive have the exec flag

  • Not working: The tab "issues" at GitHub is very useful!