Aller au contenu principal

Bodac — plusieurs boutons sur une seule broche analogique

Le module Bodac vous permet de connecter jusqu'à 5 boutons en utilisant une seule broche d'entrée analogique. Contrairement à une matrice de boutons classique (sans diodes) ou aux échelles de résistances « traditionnelles », Bodac prend en charge les appuis simultanés : n'importe quelle combinaison de boutons peut être enfoncée en même temps.

Principe de fonctionnement​

Bodac utilise une échelle de résistances avec des résistances de précision (tolérance 1 %). Chaque bouton possède une résistance câblée en parallèle. Lorsque des boutons sont enfoncés, ils modifient la résistance totale du circuit, ce qui décale la tension lue sur la broche analogique. En utilisant des valeurs de résistances soigneusement choisies qui sont des puissances de deux (50, 100, 200, 400, 800 ohms), chaque appui produit une lecture analogique unique, même lorsque plusieurs boutons sont enfoncés simultanément.

Le module lit la tension analogique, applique un algorithme d'anti-rebond et décode quels boutons sont actuellement enfoncés.

Câblage Bodac avec 5 boutons

Une résistance de tirage (pull-up) entre l'entrée et le Vcc est nécessaire, mais elle est déjà présente sur la plupart des cartes ElectroSeed. Les broches Bodac apparaissent en kaki dans le schéma de câblage (par opposition au vert pour les entrées analogiques normales).

Matériel​

Vous pouvez acheter le pack de résistances de précision sur la boutique ElectroSeed. Un câble optionnel intègre la résistance commune au niveau du connecteur, réduisant le câblage à seulement 2 fils par bouton.

Propriétés du module​

PropriétéDescription
BrocheLa broche d'entrée analogique à utiliser
Nb BoutonsNombre de boutons (2 à 5)
RésolutionRésolution de l'ADC en bits
MoyenneNombre d'échantillons à moyenner pour réduire le bruit
ARefTension de référence analogique
Anti RebondTemps d'anti-rebond en millisecondes (0–255)
K0–K4Valeurs de calibration pour le seuil de chaque bouton (définies automatiquement lors de la calibration)

Entrées et sorties​

Entrées :

  • Entrée — Entrée analogique (connectée automatiquement à la broche)
  • Cal — Bouton poussoir pour démarrer/arrêter la calibration

Sorties :

  • Button 1 à Button N — Une sortie par bouton (état haut lorsqu'il est enfoncé). Elles se connectent automatiquement aux modules BitPacker.
  • Msg — Messages de calibration (connectez un module USBSerial pour afficher les instructions de calibration)

Exemple : contrôleur HID à 5 boutons​

Ouvrez l'exemple intégré : Exemples > 02-Digital > BodacHid

Flux de l'exemple HID Bodac

Cet exemple montre une configuration Bodac complète avec 5 boutons connectés à un contrôleur de jeu USB HID :

  1. Bodac lit la broche analogique et décode l'état des 5 boutons
  2. Chaque sortie de bouton est câblée vers une entrée d'un BitPacker
  3. BitPacker empaquette les bits des boutons en octets et les envoie à un Serializer
  4. Serializer met en forme les données pour le module HID
  5. HID envoie l'état des boutons à l'ordinateur en tant que contrôleur de jeu USB

Le module USBSerial est connecté à la sortie Msg du Bodac afin d'afficher les messages de calibration dans la console série.

astuce

Vous pouvez utiliser Auto Connect pour câbler rapidement le Bodac à un BitPacker. Sélectionnez les deux modules et appuyez sur A — les sorties des boutons se connecteront automatiquement aux entrées du BitPacker.

Calibration​

Le module Bodac est fourni avec des valeurs de calibration par défaut basées sur le pack de résistances standard. Si votre câblage ou vos résistances diffèrent, vous pouvez recalibrer :

  1. Connectez la sortie Msg à un module USBSerial
  2. Téléversez le firmware sur votre carte
  3. Ouvrez la console série (Ctrl M)
  4. Cliquez sur le bouton Cal du module Bodac (dans Node Blue, pas un bouton physique)
  5. Suivez les instructions à l'écran dans la console série — il vous sera demandé d'appuyer sur chaque bouton individuellement
  6. Les valeurs de calibration (K0–K4) sont enregistrées automatiquement

La calibration ajuste les valeurs de seuil afin que le module puisse distinguer de façon fiable toutes les combinaisons de boutons, même avec les tolérances des composants.

info

Vous pouvez également activer l'option Débogage (admin uniquement) pour voir les lectures analogiques brutes dans la console série, ce qui aide à diagnostiquer les problèmes de câblage.

Astuces​

  • Le nombre de boutons dépend de la résolution de l'ADC — une résolution plus élevée permet de distinguer de façon fiable davantage de boutons. Une résolution de 12 bits prend confortablement en charge jusqu'à 5 boutons.
  • Le moyennage (4 échantillons ou plus) réduit le bruit et améliore la fiabilité, en particulier avec des fils plus longs.
  • Un anti-rebond de 10 ms fonctionne bien pour la plupart des boutons mécaniques. Augmentez-le si vous constatez des déclenchements intempestifs.
  • Les valeurs des résistances suivent un motif en puissances de deux (50, 100, 200, 400, 800 ohms), ce qui garantit que chaque combinaison de boutons produit une lecture analogique unique.