Aller au contenu principal

Audio Teensy — Vue d'ensemble

La plus grande famille de modules de NodeBlue est la bibliothèque Audio — plus de 70 modules qui encapsulent la Teensy Audio Library, l'exceptionnel framework audio temps réel de Paul Stoffregen pour les cartes Teensy 3.x / 4.x. Avec elle, vous pouvez construire des pédales d'effets, des synthétiseurs polyphoniques, des mélangeurs multicanaux, des analyseurs audio et de véritables processeurs DSP entièrement sur une carte alimentée par USB.

Cette page est une vue d'ensemble — ce que contient la famille, ce que fait chaque sous-groupe, par où commencer. Chaque module mériterait sa propre étude approfondie que ce lot ne peut contenir ; l'objectif ici est de dresser une vue d'ensemble claire.

Prérequis matériels​

La Teensy Audio Library ne fonctionne que sur les cartes Teensy — concrètement Teensy 3.2 / 3.5 / 3.6 (anciennes, toujours prises en charge) et Teensy 4.0 / 4.1 (actuelles). L'entrée/sortie audio passe généralement par l'un des shields / modules codec pris en charge :

Codec / matérielNotes
SGTL5000 (Teensy Audio Shield)Le plus courant — petit module qui se connecte à une Teensy 3.x ou 4.x. Entrée / sortie ligne stéréo, ampli casque.
CS42448Codec multicanal 8 entrées / 6 sorties (ou 6 entrées / 8 sorties) — utilisé pour le travail en son surround.
WM8731, AK4558, CS4272Autres codecs de qualité studio pris en charge par la bibliothèque.

Les cartes qui n'en disposent pas (Arduino, SAMD21, nRF52) ne peuvent pas faire tourner la bibliothèque audio Teensy — choisissez une Teensy et une carte codec.

Les sept familles​

Les modules audio se regroupent en sept familles logiques. Le nom de la catégorie dans la palette commence par le nom de la famille, ce qui les rend faciles à repérer :

FamillePréfixe de catégorieExemplesCe qu'elle fait
InputAudioInput-*I²S, USB, ADC, analogiqueAudio arrivant dans la carte depuis un microphone, une entrée ligne, un hôte USB, un ADC, etc.
OutputAudioOutput-*I²S, USB, DAC, PWMAudio sortant vers le codec, l'hôte USB, le DAC interne, le PWM.
SynthAudioSynth-*Waveform, Sine, NoiseWhite, KarplusStrong, WavetableSources génératrices de son (oscillateurs, bruit, cordes pincées, synthés à base d'échantillons).
EffectAudioEffect-*Reverb, Chorus, Flange, Delay, Bitcrusher, Envelope, Fade, GranularTraitement de l'audio — modulation, effets temporels, dynamique, distorsion.
MixerAudioMixer-*Mélangeur 4 canauxCombiner plusieurs flux audio en un seul, avec un gain par entrée.
AnalyzeAudioAnalyze-*RMS, Peak, FFT256, FFT1024, NoteFrequency, ToneDetectInspecter un signal — niveau crête, RMS, spectre, note dominante, présence d'une tonalité spécifique.
ControlAudioControl-*SGTL5000, CS42448, WM8731Configurer la puce codec elle-même (volume, sélection d'entrée, gain ligne).
Play / RecordAudioPlay-*, AudioRecord-*Lecture depuis carte SD, enregistrement brutStreaming depuis / vers le stockage (carte SD, mémoire).

Flux du signal​

Un projet audio NodeBlue possède toujours au moins un module Input ou Synth (quelque chose qui produit des échantillons) et au moins un module Output (un endroit où les envoyer). Tout ce qui se trouve entre les deux est un façonnage facultatif — mélangeurs, effets, analyseurs.

Un exemple minimal :

AudioSynthWaveformSine (oscillateur à 440 Hz) → AudioOutputI2S (routage vers le codec) → casque.

Un exemple façon pédale de guitare :

AudioInputI2S (micro / entrée ligne depuis le codec) → AudioEffectBitcrusher → AudioEffectFreeverbStereo → AudioOutputI2S.

Les patches que vous construisez avec ces modules ont exactement la même forme que le GUI Patcher distribué par Teensy — mêmes blocs, mêmes fils, même DAC sous le capot — sauf qu'ils cohabitent avec le reste de votre projet NodeBlue (logique de contrôle, MIDI, NRF24, tableau de bord) sur un seul canevas, et non dans deux outils parallèles.

Configuration du codec​

Le codec est une puce distincte du chemin audio ; il lui faut son propre bloc de configuration. Déposez le module AudioControl correspondant (par exemple AudioControlSGTL5000 pour le Teensy Audio Shield) et réglez :

ParamètreEffet
Source d'entréeLINE_IN ou MIC.
Gain micro / niveau ligneGain d'entrée analogique (certains codecs ont un PGA par entrée).
Volume casqueNiveau de sortie casque.
Volume ligneNiveau de sortie ligne.

Vous n'avez besoin que d'un seul module de contrôle par codec — chaque module AudioInput / AudioOutput qui dialogue avec ce codec utilise ses réglages courants.

Quelques patches pratiques à recopier​

  • AudioTest — sinus de base → contrôle de bon fonctionnement de la sortie.
  • Test_2ch_PassThru — entrée stéréo directement vers la sortie stéréo (test d'étage de gain / de câble).
  • Test_6ch_PassThru — idem mais en multicanal (codec CS42448).
  • USB_DC_Filter_Out — entrée audio USB → filtre coupe-continu → sortie.
  • AudioNodeBlue — un projet combiné NodeBlue + Audio plus riche.

Pour aller plus loin​

La Teensy Audio Library dispose d'une excellente documentation officielle à l'adresse pjrc.com/teensy/td_libs_Audio.html, comprenant une référence par module. Les modules de NodeBlue encapsulent cette bibliothèque directement, si bien que le comportement sous-jacent et les notes de réglage qui y figurent s'appliquent mot pour mot aux versions NodeBlue — seule la présentation visuelle change.


À partir d'ici, les tutoriels se ramifient vers les familles de périphériques orientés utilisateur : Périphériques HID (claviers, gamepads, joysticks), Moteurs et pilotes de moteur, et Volants de simulation. L'intégration SimHub et le moteur FFB — également des sujets vastes et approfondis — feront l'objet de tutoriels dédiés à venir.