Skip to content

README.fr.md

Latest commit

 

History

History
175 lines (136 loc) · 7.64 KB

README.fr.md

File metadata and controls

175 lines (136 loc) · 7.64 KB
Raw

Cardputer Keyboard & Mouse

English | 简体中文 | 繁體中文 | Italiano | Français | Português

banner

Transformez un M5Stack Cardputer Adv en clavier + souris de poche pour n'importe quel ordinateur, téléphone ou tablette — via Bluetooth LE ou USB-C.

  • ⌨️ Clavier — les 56 touches envoient des codes HID standard (fonctionne même dans le BIOS en USB)
  • 🖱️ Souris par inclinaison — inclinez l'appareil pour déplacer le curseur, grâce à l'accéléromètre intégré (curseur aux touches fléchées en secours)
  • 📶 3 emplacements Bluetooth — restez appairé avec jusqu'à 3 appareils et passez de l'un à l'autre
  • ⚙️ Menu de réglages intégré — réglages enregistrés sur la carte TF
  • Compatible Windows / macOS / Linux / Android / iPadOS / iOS

work1 work2

Démarrage rapide

  1. Flashez le firmware — voir Flash.
  2. Bluetooth (par défaut) : appairez Cardputer-Keyboard-Mouse depuis les réglages Bluetooth de votre appareil. Aucun code PIN requis.
  3. Vous préférez l'USB ? Maintenez BtnA ~0,7 s pour ouvrir le menu, choisissez Transport → USB (l'appareil redémarre), puis branchez un câble USB-C data.
  4. Tapez ! Appuyez sur Fn+Espace pour changer de mode de saisie : Clavier → Souris → Clavier+Souris.

La barre d'état en haut affiche : l'état de connexion (OK / ADV), le mode de saisie ([KEY] / [MOUSE] / [K+M]), CAPS, la sensibilité d'inclinaison S1–S5 et la batterie.

Modes de saisie

Mode Clavier Curseur
Clavier toutes les touches tapent désactivé
Souris les touches deviennent des commandes souris inclinaison — maintenez une touche pour bouger (embrayage)
Clavier+Souris (par défaut) toutes les touches tapent inclinaison toujours active, en pause pendant la frappe

Touches du mode Souris

Disposées comme des flèches sur ; , . / :

Touche Action
, / Entrée / BtnA bouton gauche
/ bouton droit
m bouton du milieu
; / . molette haut / bas
toute autre touche (maintenue) embrayage — le curseur ne bouge que tant qu'elle est maintenue

Extras du mode Clavier+Souris

Touche Action
BtnA appui court clic gauche
Opt + , / / / m bouton gauche / droit / du milieu
Opt + ; / . molette haut / bas
Opt tap rapide un appui de la touche GUI/Win/Cmd

Tant qu'elle est maintenue, Opt sert de préfixe souris local et n'est pas envoyée à l'hôte. Pour les combinaisons avec la touche GUI (p. ex. Win+C), utilisez le mode Clavier, où Opt est un modificateur GUI normal.

Curseur aux touches fléchées

Utilisé lorsque vous choisissez Cursor source = arrows dans le menu, ou automatiquement si le capteur de mouvement est défaillant. Mode Souris uniquement :

Touche Action
; , . / haut / gauche / bas / droite (accélère tant qu'elle est maintenue)
j / k bouton gauche / droit
u / n molette haut / bas
Entrée / BtnA bouton gauche

Couche Fn

Modificateurs : Ctrl, Shift (Aa), Alt, Opt = GUI/Win/Cmd. Fn est locale et n'est jamais envoyée à l'hôte.

Touche Couche Fn Touche Couche Fn
` Échap u PgUp
1 … 9, 0 F1 … F9, F10 i Insert
- / = F11 / F12 p PrintScreen
Retour arrière Suppr a CapsLock
e Fin d PgDn
h Début ; ↑
, / . / / ← / ↓ / → Espace changer de mode de saisie

Toutes les autres touches tapent le symbole imprimé (disposition US ; la disposition de l'hôte s'applique).

Menu de réglages

Maintenez BtnA ~0,7 s pour ouvrir/fermer (la saisie vers l'hôte est suspendue tant que le menu est ouvert). Naviguez avec ; haut, . bas, Entrée pour valider, ` / Retour arrière pour revenir.

Élément Effet
Transport BLE / USB (enregistre et redémarre)
BLE host slot 1 / 2 / 3 — chaque emplacement a sa propre identité Bluetooth
Clear pairing supprime les appairages des 3 emplacements — supprimez aussi l'appareil côté hôtes
Sensitivity vitesse du curseur par inclinaison, 1–5
Clutch mode défaut / maintenir pour bouger / maintenir pour figer / toujours actif
Cursor source inclinaison / touches fléchées
Recalibrate tilt maintenez immobile votre position neutre préférée pendant ~1 s
Brightness luminosité de l'écran, 20-100 % par pas de 20 % (80 % par défaut)
Device name fait défiler des préréglages (texte libre : éditez le fichier de réglages)
About version + backend de réglages

Les réglages sont stockés dans /kbmouse/settings.txt sur la carte TF (format key=value, modifiable à la main sans risque), avec repli sur la flash interne en l'absence de carte.

Flash

Images précompilées

make release

compile les deux images de distribution dans release/ :

Fichier Comment flasher
Cardputer-Keyboard-Mouse-full.bin à écrire à l'offset 0x0 avec esptool / M5Burner
Cardputer-Keyboard-Mouse-app.bin à copier sur la carte TF et à installer depuis M5Launcher 
esptool.py --chip esp32s3 write_flash 0x0 release/Cardputer-Keyboard-Mouse-full.bin

Compilation depuis les sources (PlatformIO)

pio run -e cardputer-adv            # build
pio run -e cardputer-adv -t upload  # flash over USB
pio test -e native                  # unit tests (no hardware needed)

Si le port USB n'apparaît pas (premier flash / firmware corrompu), passez en mode téléchargement : éteignez → maintenez G0/BtnA → branchez l'USB → relâchez.

Notes M5Launcher : les réglages résident sur la carte TF et survivent donc aux changements de firmware ; les appairages BLE peuvent être perdus lors d'un changement — réappairez ensuite. Ce firmware ne touche jamais G5 et n'efface jamais la NVS entière.

Astuces et dépannage

  • L'écran s'éteint après 20 s d'inactivité pour économiser la batterie — une touche, un clic ou une inclinaison le rallume aussitôt. La saisie continue de fonctionner écran éteint.
  • Gardez l'appareil immobile ~1 s au démarrage — il capture la position neutre (l'écran affiche CALIBRATING). À chaque activation du mouvement du curseur, la position de cet instant devient le nouveau centre : le curseur ne dérive jamais tout seul.
  • Pointeur souris sur iPhone/iPad : activez Réglages → Accessibilité → Toucher → AssistiveTouch. Le clavier fonctionne d'emblée.
  • Le Bluetooth ne fonctionne plus après un réappairage ? Supprimez l'appareil de la liste Bluetooth de l'hôte, utilisez Clear pairing dans le menu, puis appairez de nouveau.
  • Capteur de mouvement non détecté ? Le firmware bascule automatiquement sur le curseur aux touches fléchées et l'indique à l'écran.
  • Sens d'inclinaison inversé sur votre matériel ? Ajustez rollSign / pitchSign dans src/core/mouse_engine.h.
  • Le re-flash fonctionne toujours : le port USB reste une console série dans les deux transports — aucune manipulation du bouton de boot nécessaire. En transport USB, l'appareil est un composite CDC + HID keyboard + HID mouse et tape dans le BIOS/UEFI.