Giter Club home page Giter Club logo

minitel-raspi's Introduction

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: [email protected]

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!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.