Un piccolo telecomando per il computer. Un orologio quando lo riponi.
Firmware per M5StickC Plus originale: mouse Bluetooth controllato dall’inclinazione, presenter, orologio da polso, cronometro, timer, sveglia e telecomando IR LG/Samsung. Nome Bluetooth: AirMouse. Versione: 1.8.4.
Pagina del progetto · Manuale · Compilazione · Verifiche
Catture reali del display, non fotografie del dispositivo. Alcune provengono da versioni precedenti: nella 1.8.4 la legenda Power include «2s clock». Provenienza immagini.
Controllare il puntatore e le presentazioni senza appoggiare un mouse su una superficie; leggere l’ora e gestire piccoli conteggi dal polso; comandare la TV dallo stesso dispositivo. Il controllo del puntatore ha priorità rispetto alla grafica.
| Modalità | Cosa fa |
|---|---|
| AirMouse / presenter | Puntamento continuo a inclinazione, accelerazione progressiva, click sinistro/doppio/destro, PageDown/PageUp invertibili e scia colorata |
| Orologio | Ore, minuti e secondi, sfondo tech animato, batteria, gesto del polso, rotazione 180°, ora manuale o sincronizzata via USB |
| Cronometro | Minuti, secondi e decimi; avvio, pausa, ripresa e azzeramento |
| Timer | Da 00:01 a 99:59, decimi negli ultimi 9 secondi, tre coppie di beep allo zero |
| Sveglia | Singola, giornaliera, lun–ven, lun–sab oppure disabilitata; beep progressivi per massimo un minuto, fermabili con qualsiasi tasto |
| Telecomando IR | Scelta LG/Samsung, griglia a dieci tasti, codici preimpostati e apprendimento con ricevitore esterno su GPIO26 |
Timer e cronometro continuano cambiando pagina e durante il deep sleep. Timer e sveglia possono risvegliare il dispositivo. Durante AirMouse connesso gli avvisi sonori restano in attesa fino al ritorno all’orologio. Il profilo Samsung comprende comandi volume/power/mute per una soundbar Philips HTL3140B/12: è modificabile tramite apprendimento.
M5Stack M5StickC Plus / StickC-Plus, SKU K016-P, modello originale:
| Componente | Specifica |
|---|---|
| Processore | ESP32-PICO-D4, dual core fino a 240 MHz |
| Memoria | Flash 4 MB, SRAM 520 KB |
| Display | TFT 1,14″, 135 × 240 pixel |
| Movimento | MPU6886, accelerometro e giroscopio a 6 assi |
| Alimentazione / ora | AXP192 e RTC BM8563 |
| Batteria | Integrata da 120 mAh |
| Comandi e feedback | M5 frontale, laterale B, Power; LED, buzzer passivo, emettitore IR |
| Collegamento | USB-C per caricamento, alimentazione e ora; BLE HID per mouse/tastiera |
Specifiche e pinout ufficiali M5Stack. Il Plus2 richiede adattamenti: alimentazione e risveglio sono diversi. Il ricevitore IR serve solo per apprendere nuovi codici; per quelli integrati basta l’emettitore della scheda.
- Compila e carica il firmware. All’avvio tieni il dispositivo fermo per circa un secondo.
- Parte l’orologio. Premi Power breve: AirMouse diventa visibile via Bluetooth per 60 secondi.
- Associalo dal computer. A connessione completata compaiono AirMouse e la grafica verticale.
- Tienilo orizzontale, display verso l’alto e USB verso lo schermo: questa è la posizione neutra. Inclina la punta per su/giù e il polso lateralmente per sinistra/destra. Finché resta inclinato, il puntatore continua; inclinazioni maggiori danno più velocità e accelerazione.
- Tieni Power per 2 secondi, rilasciandolo al beep, per spegnere Bluetooth e tornare all’orologio.
In orologio, con display acceso, M5 cicla orologio → cronometro → timer → sveglia → TELECOMANDO. B gestisce la funzione corrente; tenuto 2 secondi ruota le pagine watch. Nel telecomando Power breve esce dalla sub-app.
| Tasto | Breve | Doppio | Tenuto |
|---|---|---|---|
| M5 frontale | PageDown | PageUp | 1 s: inverte i due comandi, con beep |
| Laterale B | Click sinistro | Doppio click sinistro | 1 s: click destro |
| Power | Mouse ON/OFF | — | 2 s: chiude Bluetooth e torna all’orologio |
Mouse OFF sospende solo il puntamento: click e presentazione restano disponibili. M5 + B per 5 secondi cancella le associazioni. La pressione Power oltre 4 secondi mantiene lo spegnimento hardware.
- Cinque associazioni ricordate; gestione delle associazioni non più valide e pairing riapribile.
- Nessuna riconnessione automatica dalle pagine watch: Power riapre la visibilità.
- In Bluetooth, schermo spento dopo 10 secondi senza movimento, con riaccensione al movimento; mouse e pulsanti continuano a funzionare.
- Nelle pagine watch e nel telecomando, gesto del polso o pulsante mostrano lo schermo per 10 secondi.
- Deep sleep dopo 2 minuti senza pulsanti, indipendentemente dal movimento; M5 risveglia e ripristina la modalità precedente. Tre lampeggi a 5 secondi dalla sospensione; un lampeggio ogni 15 secondi mentre connesso.
- CPU 240 MHz durante Bluetooth, 80 MHz nelle pagine watch. Telecomando aperto a 240 MHz. Wi-Fi non usato, Bluetooth completamente spento nelle modalità watch/IR. Autonomia non ancora misurata.
Profilo standard BLE HID destinato a macOS, Windows e Linux. Le prove effettive di connessione, riconnessione e ricezione dei report sono state eseguite su macOS; Windows e Linux restano da collaudare. Non occorre un’app per il mouse. L’ora da USB richiede lo script incluso.
firmware/AirMouse/: firmware completo 1.8.4.libraries/: BLE con correzioni locali e IRremote 4.7.1, con licenze originali.tools/: compilazione, test, sincronizzazione ora e screenshot seriali.tests/: test C++ eseguibili sul computer.docs/: sito statico e catture del display.
Il codice firmware coincide con la versione 1.8.4 utilizzata sul dispositivo; gli strumenti pubblici accettano i percorsi e la porta del proprio computer. Crediti e licenze delle dipendenze in THIRD_PARTY.md.


