Skip to content

Repository files navigation

AirMouse

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

AirMouse con stato Bluetooth, puntatore e scia Orologio digitale a tutto schermo Telecomando a dieci tasti

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.

A cosa serve

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.

Funzioni

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.

Hardware

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.

Primo utilizzo

  1. Compila e carica il firmware. All’avvio tieni il dispositivo fermo per circa un secondo.
  2. Parte l’orologio. Premi Power breve: AirMouse diventa visibile via Bluetooth per 60 secondi.
  3. Associalo dal computer. A connessione completata compaiono AirMouse e la grafica verticale.
  4. 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.
  5. 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.

Pulsanti in AirMouse

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.

Bluetooth, schermo e batteria

  • 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.

Codice e documentazione

  • 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.

About

M5StickC Plus: Bluetooth air mouse and presenter, wrist clock, stopwatch, timer, alarm and learning IR remote.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages