Skip to content

Pixelbo/Minitel-raspi

Repository files navigation

Minitel-Raspi

Dat minitel

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.

But the having a terminal on the Minitel isn't useful.

So I've created a small gui with whiptail that control various api

First API: It uses the Telnet protocol that is enabled in the LMS settings, you can see he docs here Second API: It uses simple request and JSON parsing to retrieve lunch recipe and then generate a qrcode for your mobile!

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, or do I?

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). Python and pip3 installed.

  • 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 -r requirements.txt
echo 'export LANG=fr_FR.iso88591'>> /home/Minitel/.bashrc
echo 'cd /home/Minitel/Minitel-raspi/Project/'>> /home/Minitel/.bashrc #comment this line if u don't want the project at startup
echo './Main.py' >> /home/Minitel/.bashrc
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

See Project tab on github

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

See License

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!