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ériel | Notes |
|---|---|
| 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. |
| CS42448 | Codec multicanal 8 entrées / 6 sorties (ou 6 entrées / 8 sorties) — utilisé pour le travail en son surround. |
| WM8731, AK4558, CS4272 | Autres 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 :
| Famille | Préfixe de catégorie | Exemples | Ce qu'elle fait |
|---|---|---|---|
| Input | AudioInput-* | I²S, USB, ADC, analogique | Audio arrivant dans la carte depuis un microphone, une entrée ligne, un hôte USB, un ADC, etc. |
| Output | AudioOutput-* | I²S, USB, DAC, PWM | Audio sortant vers le codec, l'hôte USB, le DAC interne, le PWM. |
| Synth | AudioSynth-* | Waveform, Sine, NoiseWhite, KarplusStrong, Wavetable | Sources génératrices de son (oscillateurs, bruit, cordes pincées, synthés à base d'échantillons). |
| Effect | AudioEffect-* | Reverb, Chorus, Flange, Delay, Bitcrusher, Envelope, Fade, Granular | Traitement de l'audio — modulation, effets temporels, dynamique, distorsion. |
| Mixer | AudioMixer-* | Mélangeur 4 canaux | Combiner plusieurs flux audio en un seul, avec un gain par entrée. |
| Analyze | AudioAnalyze-* | RMS, Peak, FFT256, FFT1024, NoteFrequency, ToneDetect | Inspecter un signal — niveau crête, RMS, spectre, note dominante, présence d'une tonalité spécifique. |
| Control | AudioControl-* | SGTL5000, CS42448, WM8731 | Configurer la puce codec elle-même (volume, sélection d'entrée, gain ligne). |
| Play / Record | AudioPlay-*, AudioRecord-* | Lecture depuis carte SD, enregistrement brut | Streaming 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ètre | Effet |
|---|---|
| Source d'entrée | LINE_IN ou MIC. |
| Gain micro / niveau ligne | Gain d'entrée analogique (certains codecs ont un PGA par entrée). |
| Volume casque | Niveau de sortie casque. |
| Volume ligne | Niveau 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.