Skip to content

Yobeco/MAEL_Scan_Pi

Repository files navigation

MAEL

MAEL Scan Pi

An application belonging to the MAEL project
Copyright (c) 2024 Yonnel Bรฉcognรฉe

License: Libre Non Commerciale

Python

SQLite

Contributions Welcome Beginner friendly

Status: Active

๐Ÿ‡ซ๐Ÿ‡ท Franรงais | ๐Ÿ‡ช๐Ÿ‡ธ Espaรฑol | ๐Ÿ‡ฌ๐Ÿ‡ง English


A- Description ๐Ÿ‘๏ธ

MAEL Scan Pi is an embedded application on Raspberry Pi that allows students to scan QR codes created by their teacher with MAEL Gen and listen to their content ๐Ÿ”ˆ without using a mobile phone.
Its interface is designed to be used by a child from age 4 ๐Ÿ‘ถ.

The purpose of the phone-free version is to:

  • avoid giving a phone to the hands (especially for younger students) ๐Ÿ“ต
  • create a nice object representing the beginning of an important learning process (Pedagogical contract).

MAEL Scan Pi allows students without any โ€œspeakerโ€ at home to listen to the language being studied within a pedagogical context prepared by their teacher ๐Ÿ’ฏ. It thus allows the teacher to boost language teaching ๐Ÿ“ˆ.

Potentially 55 languages can be implemented! ๐Ÿ˜ฒ

๐Ÿ‡ซ๐Ÿ‡ท ๐Ÿ‡ฌ๐Ÿ‡ง ๐Ÿ‡ช๐Ÿ‡ธ ๐Ÿ‡ต๐Ÿ‡น ๐Ÿ‡ง๐Ÿ‡ท ๐Ÿ‡ฎ๐Ÿ‡น ๐Ÿ‡ฉ๐Ÿ‡ช ๐Ÿ‡ท๐Ÿ‡บ ๐Ÿ‡ฏ๐Ÿ‡ต ๐Ÿ‡จ๐Ÿ‡ณ ๐Ÿ‡ฐ๐Ÿ‡ท ...


B- Features ๐Ÿ“‹

See the MAEL Scan project


C- How to use MAEL Scan? ๐Ÿ˜Š

Usage should mimic the phone version as closely as possible.
See the MAEL Scan project


D- Operating principle โš™๏ธ

(To aid code comprehension)


The operating principle will be the same as the MAEL Scan phone project.

However, MAEL Scan Pi has specific hardware properties:

"MAEL Scan Pi" V1

Function Chosen solution
Motherboard Raspberry Pi 4 8GB
Operating system Pi OS Debian V13 (trixie)
Text-to-speech Piper TTS
Audio playback aplay (Linux Bash)
UPS (battery management) MakerFocus Raspberry Pi 4 Battery Pack UPS
Audio amplifier LM386
QR code scanner Camera module V2.1
QR code recognition OpenCV
Display WaveShare 2.7inch E-Ink Display HAT
Case Recycled old modem case

Strengths:

  • Prototype to explore difficulties ๐Ÿซฃ

Weaknesses:

  • Bulky ๐Ÿ“ฆ
  • Case not ergonomic
  • QR codes hard to scan (must take a photo, send it to OpenCV which struggles to read the QR code...) ๐Ÿซค
  • Strong interference in the speaker (LM386 sensitive, without preamp)

โŸถ Dismantled to create version 2


"MAEL Scan Pi" V2

Function Current solution Price
Motherboard Raspberry Pi 4 8GB $104
Operating system Pi OS Debian 13 (trixie)
Text-to-speech Piper TTS
Audio playback aplay (Linux Bash)
UPS (battery management) MakerFocus Raspberry Pi 4 Battery Pack UPS $33
Audio amplifier PAM8403 Mini Module $1
QR code scanner Useful Sensors Tiny Code Reader $11
QR code lighting 2 LEDs
Display with 4 buttons WaveShare 2.7inch E-Ink Display HAT $23
Case Recycled old modem case
Total: +- $172

Strengths:

  • Functional: QR codes easily scanned ๐Ÿ™‚
  • Embedded text-to-speech (no internet connection required)
  • Good battery life ๐Ÿ”‹
  • Better sound quality ๐ŸŽต ๐Ÿ‘

Weaknesses:

  • Bulky
  • Case not very ergonomic
  • QR code limited to 254 bytes, i.e. 40 ASCII characters (less with accents or foreign characters...). This is a hardware limitation ๐Ÿ“ of the Tiny sensor. Insufficient!
  • Occasional flaws in the Piper TTS voice ๐Ÿ˜ (Creating our own voice model? It is possible)

โŸถ Functional, but the code is still messy


"MAEL Scan Pi" V3

Under construction

Function Planned solution Price
Motherboard Raspberry Pi Zero 2W 512 MB (+ Zram) $22
Operating system Pi OS Debian Lite V13 (trixie)
Text-to-speech GTTS (or text-to-speech service hosted on MAEL Phrase)
Audio playback MOC (Music On Console) + SOX
UPS (battery management) Uninterruptible Power Supply UPS HAT for Raspberry Pi Zero $24
Audio amplifier Audio Tech (B) Speaker Tech for Raspberry Pi Zero Poor sound quality ๐Ÿ˜ $4
Audio amplifier mic+ (DAC + amp / speaker + jack output) $35
QR code scanner GM861S-LED $10
QR code lighting Integrated into the GM861S module
Display 2.13inch E-Paper HAT (B), 250x122, Red/Black/White, SPI interface $15
6 "Touch" buttons MPR121 V12 โ€“ Capacitive Touch Sensor $2
3D-printed case PET from bottles ?
Total: +- $104

As there is no (yet) 3.52inch e-Paper Display (B), e-Ink Display, 360x240, Red/Black/White that is touch-enabled to display buttons directly on the screen, I opted for "touch sensor" type sensors placed inside the case.
I therefore chose a smaller (and cheaper) screen, but with 3 colors โšซโšช๐Ÿ”ด. Perfect for the MAEL logo ๐Ÿ˜„.
I ran a test: a large QR code (150px) can contain approximately 120 characters. This 5cm x 2.5cm screen would display this text at 11px, which is still acceptable. (Tests will be needed with a font size calculated based on the number of characters to display...)

Model3D_1

Model3D_2

Strengths:

  • Smaller and lighter โ„๏ธ
  • Planned 3D-printed case
  • 3-color screen!
  • 6 touch buttons (capacitive, directly inside the case)
  • Jack audio output! ๐ŸŽง
  • Added feature: ability to scan a QR code generated by a phone ๐Ÿ“ฑ to share an internet Wi-Fi connection.

Weaknesses:

  • Will require a connection for text-to-speech.

โŸถ I already have part of the hardware ๐Ÿ› ๏ธ.
However, it is sometimes expensive ๐Ÿ’ธ and slow ๐Ÿ“† to get hardware shipped to Nicaragua ๐Ÿ‡ณ๐Ÿ‡ฎ (where I live).

๐Ÿ‘๏ธ See the progress of the MAEL Scan Pi V3 configuration

  1. OS configuration
  2. CLI utilities
  3. Module installation...

๐Ÿฆพ Need a PCB design specialist ๐Ÿ›Ÿ

The internal connections require a small custom-made connector (PCB).


E- Features to be developed ๐Ÿš€

Same as for MAEL Scan, but to be developed in Python on Raspberry Pi.

๐Ÿ‘ Offer your help to develop MAEL Scan Pi

Maybe a FabLab ๐Ÿ”ฉ could participate? ๐Ÿ˜


F- Take part in the MAEL project ๐Ÿ‘

๐Ÿ›Ÿ To get information about how MAEL Scan Pi works ๐Ÿ‘, write to me here:

๐Ÿ“ฌ mael@lvh.edu.ni

๐ŸŒŸ Contributors

A big thank you to everyone who will contribute to this project!

Avatar Name GitHub Role
Bรฉcognรฉe Yonnel @Yobeco Maintainer
Padawan @Nail-yk Documentation translation
... ... ... Developer
... ... ... Maker

G- Installation โคต๏ธ

The source code of the V2 prototype is still too messy for me to dare publish it in the repository. ๐Ÿ˜ž
In fact, I am moving directly to version 3...

About

Version without phone: based on a Raspberry Pi.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages