Différences entre versions de « ADAFRUIT-AUDIO-FX-port-série »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
(Page créée avec « {{ADAFRUIT-AUDIO-FX-NAV}} {{traduction}} == Utiliser le port série == {{bloc-etroit|text=If for some reason you don't want to use the trigger mode, say you need some mo... »)
 
 
(23 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{ADAFRUIT-AUDIO-FX-NAV}}
 
{{ADAFRUIT-AUDIO-FX-NAV}}
−
 
−
{{traduction}}
 
  
 
== Utiliser le port série ==
 
== Utiliser le port série ==
−
{{bloc-etroit|text=If for some reason you don't want to use the trigger mode, say you need some more complex audio playing, you can use serial audio control. This allows any microcontroller with 9600 baud TTL UART to send commands to the module.
+
{{bloc-etroit|text=Si pour une raison quelconque vous ne voulez pas utiliser le mode de déclenchement, parce que vous avez besoin d'un système de lecture audio plus complexe, alors vous pouvez utiliser le mode série. Le mode série permet de contrôler la carte son par l'intermédiaire du port série. Le mode série permet de à un microcontrôleur équipé d'un UART TTL 9600 d'envoyer des commandes sur le module.
  
−
'''All Adafruit Soundboards can be used in either UART mode or GPIO (button) mode''' - but ''not'' at the same time!
+
'''Les carte audio d'Adafruit peuvent être utilisées en mode UART ou en mode GPIO (avec des boutons d'activation)''' - mais ''pas'' les deux en même temps!
  
−
We'll demonstrate with an Arduino, but you can use any microcontroller with a little adaptation}}
+
Nous allons utiliser un Arduino comme exemple mais vous pouvez adapter les informations suivantes (et la bibliothèque) à n'importe quel autre microcontroleur.}}
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-01.jpg}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-01.jpg}}
  
 
== Bibliothèque Arduino ==
 
== Bibliothèque Arduino ==
−
If you have an Arduino, you can wire it as seen above to control the sound board via our simple menu example
+
Si vous avez un Arduino, vous pouvez réaliser les branchements comme sur l'image ci-dessus. Cela permet de contrôler la carte son à l'aide du simple programme d'exemple proposé par Adafruit.
−
* UG to Ground,
 
−
* TX to #5,
 
−
* RX to #6, 
 
−
* RST to #4
 
  
−
To begin controling the motor chip, you will need to [https://github.com/adafruit/Adafruit_Soundboard_library download the Adafruit_Soundboard Library from our github repository]. You can do that by visiting the github repo and manually downloading or, easier, just click this button to download the zip.
+
Voici les raccordements:
 +
* UG sur la masse/GND (pour activer le mode série),
 +
* TX sur Arduino #5,
 +
* RX sur Arduino #6,
 +
* RST sur Arduino #4
 +
 
 +
Vous aurez besoin de [https://github.com/adafruit/Adafruit_Soundboard_library télécharger la bibliothèque Adafruit_Soundboard depuis le dépôt GitHub] pour prendre le contrôle de la puce de la carte son. Vous pouvez télécharger la bibliothèque en visitant le dépôt GitHub d'Adafruit et télécharger (''Download'') manuellement l'archive -OU- plus simplement cliquer sur le bouton de téléchargement ci-dessous.
  
 
{{download-box|Téléchargez la bibliothèque Soundboard d'Adafruit|https://github.com/adafruit/Adafruit_Soundboard_library/archive/master.zip}}
 
{{download-box|Téléchargez la bibliothèque Soundboard d'Adafruit|https://github.com/adafruit/Adafruit_Soundboard_library/archive/master.zip}}
  
−
Rename the uncompressed folder {{fname|Adafruit_Soundboard}} and check that the {{fname|Adafruit_Soundboard}} folder contains {{fname|Adafruit_Soundboard.cpp}} and {{fname|Adafruit_Soundboard.h}}
+
Décompressez le contenu de l'archive ZIP puis renommé le répertoire décompressé comme {{fname|Adafruit_Soundboard}}. Verifiez que le répertoire {{fname|Adafruit_Soundboard}} contienne bien le fichier {{fname|Adafruit_Soundboard.cpp}} et {{fname|Adafruit_Soundboard.h}}
 +
 
 +
Placez le répertoire {{fname|Adafruit_Soundboard}} dans votre répertoire {{fname|répertoire_des_croquis_arduino/libraries/}}.
 +
Vous pourriez avoir besoin de créer le sous répertoire {{fname|libraries}} si ce dernier n'existe pas encore. Redémarrez votre Editeur Arduino.
  
−
Place the {{fname|Adafruit_Soundboard}} library folder your {{fname|arduinosketchfolder/libraries/}} folder.
+
En cas de besoin, vous pouvez consulter notre tutoriel "[[Installation_d%27un_librairie_Arduino|Installer des bibliothèques Arduino]]
−
You may need to create the libraries subfolder if its your first library. Restart the IDE.
 
  
 
== Charger le croquis de démo ==
 
== Charger le croquis de démo ==
−
Now you can open up '''File->Examples->Adafruit_Soundboard->menu''' and upload to your Arduino wired up to the breakout
+
Vous pouvez maintenant ouvrir l'exemple avec le point de menu '''Fichiers->Exemples->Adafruit_Soundboard->menu''' et téléverser le programme sur votre Arduino UNO raccordé sur la carte son.
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-10.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-10.png}}
  
−
Then open up the serial console at 115200 baud to interact!
+
Ouvrez ensuite une console série à 115200 baud pour interagir avec le programme!
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-11.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-11.png}}
  
−
== Utilisation générale ==
+
== Utilisation du programme ==
−
For connections we recommend at a minimum
+
Pour les connexions, nous recommandons au minimum les connexions suivantes
 +
 
 +
* Connecter '''UG''' sur '''GND''' (la masse, permet de démarrer la carte son en mode Uart)
 +
* Connecter '''RX''' sur la broche ''sortie de donnée'' (TX) de votre microcontroleur
 +
* Connecter '''TX''' sur la broche ''entrée de donnée'' (RX) de votre microcontroleur
 +
* Connecter '''RST''' sur une autre broche de votre microcontrôleur. La carte son sera réinitialisée lorsque le signal passera au niveau bas (LOW). Cela permet d'avoir une carte son dans un état connu.
  
−
* Connect '''UG''' to '''GND''' (to start the sound board in Uart mode)
+
Si vous désirez être averti lorsque la carte reproduit un fichier audio alors la broche '''ACT''' est le signal qu'il vous faut. La broche '''ACT''' pass au niveau bas lorsque la carte audio lit un fichier audio - cette sortie contrôle également l'état de la LED rouge ACT (qui s'allume lorsqu'un fichier audio est joué).
−
* Connect '''RX''' to the data-output pin from the microcontroller into the sound board
 
−
* Connect '''TX''' to the data-output pin to the microcontroller from the sound board
 
−
* Connect '''RST''' to another microcontroller pin, when toggled low, it will reset the sound board into a known state
 
  
−
If you want to know when sound is being played, the '''ACT''' pin is au '''LOW''' when audio is playing - this output also controls the red ACT LED
+
Vous pouvez utiliser une logique 3.3V ou 5V sur la broche '''RX''', elle est équipée d'un ''level shifter'' (convertisseur de niveau logique). La broche TX est une sortie à 3.3v ce qui permet à un microcontrôleur 3.3v ou 5v de lire le signal en toute sécurité.
  
−
You can use 3.3V or 5V logic on the '''RX''' pin, it has a level shifter. TX is output at 3.3V which can be read from a 3.3V or 5V logic. For the '''RST''' pin, it's 3.3V and has a pullup. To reset the board, set the microcontroller pin to low, then an output, then back to an input like so:
+
Pour la broche '''RST''', cette broche est ramenée à un signal de 3.3V à l'aide d'une résistance pull-up. Passez le signal au niveau bas (LOW) pour réinitialiser la carte, ENSUITE, reconfigurez votre broche en entrée pour désactiver le niveau logique bas et laisser le signal flottant (qui sera en fait ramener à 3.3V par la résistance pull-up de la carte son):
  
 
  <nowiki>  digitalWrite(reset_pin, LOW);
 
  <nowiki>  digitalWrite(reset_pin, LOW);
Ligne 53 : Ligne 57 :
 
   delay(10);
 
   delay(10);
 
   pinMode(reset_pin, INPUT);
 
   pinMode(reset_pin, INPUT);
−
   delay(1000); // give a bit of time to 'boot up'</nowiki>
+
   delay(1000); // donner assez de temps à la carte son pour qu'elle démarre.</nowiki>
  
−
After reset, the sound board will print out a bunch of info
+
Après la réinitialisation (''Reset''), la carte son affichera une série d'information.
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-20.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-20.png}}
  
−
First line tells you when this firmware was written (10/21/14) and the name of the board - the name is the same for all the SFX boards right now, but you may have a different firmware date
+
La première ligne indique quand le firmware à été écrit (10/21/14) ainsi que le nom de la carte - le nom est identique pour toutes les cartes SFX (mais vous pourriez avoir des firmware de différente fate)
  
−
The second line will read '''FAT''' and then a 8 digit hexadecimal number, which will tell you the size of the partition that all the files are on in 512 byte sectors. E.g. here 0x7FC0 = 32,704. 32704 * 512 bytes = 16,744,448 (16 MB)
+
La seconde ligne indique '''FAT''' puis un chiffre en hexadécimal qui indique la taille de partition sur laquelle sont stockés tous les fichiers (en secteur de 512 octets). Dans le cas présent nous avons 0x7FC0 = 32704. Soit 32704 * 512 octets = 16,744,448 (16 MB)
  
−
Third line will read '''Files''' and then a 5 digit decimal # of files that are on the Soundboard. here, we see it has 16 files available.
+
Sur la troisième ligne, vous pouvez lire '''Files''' puis un nombre décimal sur 5 digits. Ce nombre indique le nombre de fichier sur la carte. Dans le cas présent, la carte contient 16 fichiers.
  
 
== Commandes ==
 
== Commandes ==
−
 
+
Les commandes sont divisées en deux ensembles.
−
There are a few commands, in two 'sets' - one set is commands that can be run in IDLE mode, and the other is commands that can be run in PLAY mode.
+
* Un ensemble de commande peut être exécuté en mode IDLE (pendant que la carte ne fait rien)
 +
* Un autre ensemble de commande peut être exécuté pendant la lecture de piste audio (en mode PLAY).
  
 
== Commandes en mode IDLE ==
 
== Commandes en mode IDLE ==
−
These are commands you can use when audio is not being played!
+
Ces commandes peuvent être utilisées pendant que la carte ne lit pas de fichier audio!
  
 
=== Liste des fichiers ===
 
=== Liste des fichiers ===
  
−
* L - Send "L\n" (L plus new line) to list files
+
* L - envoi {{fname|L\n}} (L plus un retour à la ligne/''new line'') pour lister les fichiers
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-30.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-30.png}}
  
−
files will be listed in following format:
+
Les fichiers sont listés au format suivant:
  
−
  FILENAMEEXTfilesizeinbytes
+
  FILENAMEEXTtaille_fichier
  
−
Where "FILENAMEEXT" is the full 8.3 file name of each file, with no dot, if you have a file with shorter than 8 characters, it will be padded with spaces.  
+
où "FILENAMEEXT" est le nom complet du fichier au format 8.3 (8 caractères pour le nom de fichier, 3 caractères pour l'extension du fichier). Le nom de fichier n'inclus pas le point. Si le nom du fichier contient moins de 8 caractères alors celui-ci sera complété avec des espaces (''padded'' est le terme informatique anglophone correspondant).  
  
−
The filesize is in bytes, and is padded with zeros as well
+
La ''taille_fichier'' s'exprime en octet (byte) et est également ''paddé'' avec des zéros.
  
 
=== Modifier le volume ===
 
=== Modifier le volume ===
−
You can adjust volume from 0 (silent) to 204 (loudest) in 2-increments. To increase the volume, send +\n (plus symbol plus new line). to decrease volume send -\n (minus symbol plus new line) and it will reply with the new volume (5 ascii characters, two of which are going to be zeros and then three digits of volume, plus a new line)
+
Vous pouvez ajuster le volume sonore depuis 0 (silence) à 204 (volume max) par incrément de 2. Pour accroitre le volume, envoyez {{fname|+\n}} (symbole plus suivit d'un retour à la ligne.  
 +
 
 +
Pour décroitre le volume, envoyez {{fname|-\n}} (symbole moins suivit d'un retour à la ligne).
 +
 
 +
La carte son répondra avec le nouveau volume (5 caractères ascii, deux qui seront des zeros puis 3 digits de volumes, plus un caractère de retour clavier)
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-40.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-40.png}}
  
 
=== Jouer une piste par numéro ===
 
=== Jouer une piste par numéro ===
 +
Chaque piste dispose d'un numéro correspondant au moment ou le fichier à été copié sur la mémoire flash. La première piste porte le numéro 0, la numérotation suit l'ordre des fichiers tels qu'il sont affichés par la commande 'L' (liste des fichiers).
  
−
Each track has a number with respect to when it was copied onto the SD card, starting with track #0, these are in the order that the tracks are printed out when you send 'L' for list tracks.
+
Le plus rapide pour jouer un fichier est de d'envoyer la commande {{fname|#NN\n}} (symbole #, puis le numéro de la piste, et le caractère ''retour clavier'' pour finir). Par exemple, pour jouer la première piste (soit la piste 0), il faut envoyer la commande {{fname|#0\n}} et pour jouer la 11ieme piste il faut envoyer la commande {{fname|#10\n}}
−
 
 
−
The fastest way to play a track is by the track number, send '''#NN\n''' (# symbol, then the number of the track, and end with a new line). E.g. to play the first track (track #0) send #0\n and for the 11th track, send '''#10\n'''
 
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-50.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-50.png}}
  
−
If the file wasnt found, it will reply with '''NoFile\n'''
+
Si le fichier n'a pas été trouvé, la carte son répondra '''NoFile\n'''
  
−
If the file is found, the sound board will reply with '''playNNNNNFILENAMEEXT\n'''
+
Si le fichier est trouvé, la carte son répondra '''playNNNNNFILENAMEEXT\n'''
  
−
where NNNNN is the track number, and FILENAMEEXT is the 11-character file name (8.3 without the dot)
+
Où:
 +
* NNNNN est ne numéro de piste,  
 +
* FILENAMEEXT le nom de fichier en 11 caractères (sans point, 8 caractères pour le fichier, 3 pour l'extension)
  
−
When the file is done, it will print '''done\n''' to let you know
+
Lorsque le fichier est joué, la carte son affiche '''done\n''' pour vous indiquer que l'opération est terminée
  
 
=== Jouer une piste par nom ===
 
=== Jouer une piste par nom ===
−
Maybe you want to just play the track by a name, not number. No problem! You can do that with the '''P''' command
+
Peut être aurez vous envie de jouer une piste à partir de son nom (et non de son numéro). Pas de problème, vous pouvez utiliser la commande '''P'''
  
−
Send '''PFILENAMEEXT\n''' - 'P' plus the 11-character file name (8.3 without the dot) then a new line. If the filename is shorter than 8 characters, fill the characters
+
Envoyez la commande {{fname|PFILENAMEEXT\n}} - lettre 'P' plus les 11 caractères du nom de fichier (8.3 sans le point de séparation) suivit du caractère 'retour à la ligne'. Si le nom de fichier fait moins de 8 caractères, remplissez le nom de fichier avec des blancs.
  
−
For example, to play '''T00NEXT5.WAV''' send '''PT00NEXT5WAV\n''' and to play '''T09.OGG''' send '''PT09    OGG\n'''
+
Par exemple:
 +
* Pour lire le fichier '''T00NEXT5.WAV''', il faut envoyer la commande {{fname|PT00NEXT5WAV\n}}
 +
* Pour lire le fichier '''T09.OGG''', il faut envoyer la commande {{fname|'''PT09    OGG\n'''}} (''notez les espaces dans le nom de fichier).
  
−
If the file wasnt found, it will reply with '''NoFile\n''' otherwise it will reply as above, with '''playNNNNNFILENAMEEXT\n'''
+
Si le fichier n'est pas trouvé, la carte son répond '''NoFile\n''' sinon elle répondra comme précédemment avec '''playNNNNNFILENAMEEXT\n'''
  
 
== Commandes en mode lecture ==
 
== Commandes en mode lecture ==
−
OK now that you are playing audio, you can do stuff during play, these are not available in IDLE mode
+
Maintenant que nous savons jouer des fichiers audio, vous pouvez également réaliser des actions pendant la lecture des fichiers.
 +
 
 +
Les actions ci-dessous ne sont disponible que durant la lecture d'un fichier audio.
  
 
=== Pause et reprise ===
 
=== Pause et reprise ===
−
You can pause at any time by sending the = character, no new line required. To restart playback, send the > character
+
Vous pouvez mettre la lecture en pause à n'importe quel moment en envoyant le caractère {{fname|1==}}, la caractère ''retour clavier'' n'est pas nécessaire. Pour redémarrer la lecture, il faut envoyer le caractère {{fname|>}}
  
−
These character will be echo'd back to you on the UART so you know they were received!
+
Ces caractères seront renvoyés par l'UART, c'est une façon de savoir qu'il a bien été recu!
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-60.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-60.png}}
  
 
=== Arrêter la lecture ===
 
=== Arrêter la lecture ===
−
You can also stop instantly by sending a '''q''' (for 'quit') and the audio will stop and return back to IDLE mode
+
Vous pouvez également arrêter instantanément la piste audio en envoyant la commande {{fname|q}} (pour 'quit'). Le fichier audio est stoppé et la carte audio revient en mode IDLE.
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-70.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-70.png}}
  
 
=== Position de la lecture ===
 
=== Position de la lecture ===
−
You can query how much time has been spent playing the current track by sending an t character
+
Vous pouvez interroger la carte pour savoir combien de temps est déjà écoulé dans la lecture de la piste. Envoyez le caractère {{fname|t}}
  
−
You will get a response which is 5 digits a : and then another 5 digits. The first 5 digits are seconds currently elapsed, the second half is supposed to be the codec's report of total play time but so far we've always just gotten 0's so we suggest just using the first set of digits (current playback in seconds)
+
Vous obtiendrez une réponse en 5 digits, une {{fname|:}} et 5 autres digits.  
  
−
Please note this is a blocking operation. Doing it too much can cause your audio to stutter!
+
Les 5 premiers 5 digits représente le nombre de secondes écoulées, la seconde partie est le temps total de lecture rapporté par le codec (cette valeur à toujours été à 0, nous vous recommandons de vous penchez sur la première partie)
 +
 
 +
Notez que cette opération est bloquante, l'utiliser trop souvent pourrait causer des ''parasites'' dans le rendu audio!
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-80.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-80.png}}
  
 
== Taille de fichier et autre ==
 
== Taille de fichier et autre ==
−
Finally, you can query the size of the file and how far along you are in it, which is sort of like how much you've got left to play but of course, for compressed OGGs may vary a bit. Still, might be handy!
+
Pour finir, vous pouvez demander la taille d'un fichier et savoir a quelle position vous vous trouvez dans ce dernier (durant la lecture).
 +
 
 +
C'est un peu comme connaître le temps écoulé, cela peut varier pour les fichiers OGG compressés. Mais cela reste toujours très pratique!
  
−
You can get the file size and remaining bytes by sending an 's'
+
Vous pouvez obtenir la taille du fichier et le nombre d'octets restant en envoyant le caractère 's'
  
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-90.png}}
 
{{ADFImage|ADAFRUIT-AUDIO-FX-port-série-90.png}}
  
−
The sizes are reported in decimal bytes, 10 digits long seperated by a /
+
La taille est rapportée en décimal (le nombre d'octets), taille exprimée avec 10 digits séparé par un '/'
  
−
The first number is remaining bytes and the second number is total size.
+
Le premier numéro est le nombre d'octets restant et le second est le nombre total d'octets.
  
−
Please note this is a blocking operation. Doing it too much/fast can cause your audio to stutter!
+
Attention: il s'agit d'une opération bloquante. L'utiliser trop souvent peut causer des effets audio indésirables (parasites)!
  
 
{{ADAFRUIT-AUDIO-FX-TRAILER}}
 
{{ADAFRUIT-AUDIO-FX-TRAILER}}

Version actuelle datée du 1 janvier 2016 à 08:53


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

Utiliser le port série

Si pour une raison quelconque vous ne voulez pas utiliser le mode de déclenchement, parce que vous avez besoin d'un système de lecture audio plus complexe, alors vous pouvez utiliser le mode série. Le mode série permet de contrôler la carte son par l'intermédiaire du port série. Le mode série permet de à un microcontrôleur équipé d'un UART TTL 9600 d'envoyer des commandes sur le module.

Les carte audio d'Adafruit peuvent être utilisées en mode UART ou en mode GPIO (avec des boutons d'activation) - mais pas les deux en même temps!

Nous allons utiliser un Arduino comme exemple mais vous pouvez adapter les informations suivantes (et la bibliothèque) à n'importe quel autre microcontroleur.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Bibliothèque Arduino

Si vous avez un Arduino, vous pouvez réaliser les branchements comme sur l'image ci-dessus. Cela permet de contrôler la carte son à l'aide du simple programme d'exemple proposé par Adafruit.

Voici les raccordements:

  • UG sur la masse/GND (pour activer le mode série),
  • TX sur Arduino #5,
  • RX sur Arduino #6,
  • RST sur Arduino #4

Vous aurez besoin de télécharger la bibliothèque Adafruit_Soundboard depuis le dépôt GitHub pour prendre le contrôle de la puce de la carte son. Vous pouvez télécharger la bibliothèque en visitant le dépôt GitHub d'Adafruit et télécharger (Download) manuellement l'archive -OU- plus simplement cliquer sur le bouton de téléchargement ci-dessous.

Download-icon.pngTéléchargez la bibliothèque Soundboard d'Adafruit

Décompressez le contenu de l'archive ZIP puis renommé le répertoire décompressé comme Adafruit_Soundboard. Verifiez que le répertoire Adafruit_Soundboard contienne bien le fichier Adafruit_Soundboard.cpp et Adafruit_Soundboard.h

Placez le répertoire Adafruit_Soundboard dans votre répertoire répertoire_des_croquis_arduino/libraries/. Vous pourriez avoir besoin de créer le sous répertoire libraries si ce dernier n'existe pas encore. Redémarrez votre Editeur Arduino.

En cas de besoin, vous pouvez consulter notre tutoriel "Installer des bibliothèques Arduino

Charger le croquis de démo

Vous pouvez maintenant ouvrir l'exemple avec le point de menu Fichiers->Exemples->Adafruit_Soundboard->menu et téléverser le programme sur votre Arduino UNO raccordé sur la carte son.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Ouvrez ensuite une console série à 115200 baud pour interagir avec le programme!

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Utilisation du programme

Pour les connexions, nous recommandons au minimum les connexions suivantes

  • Connecter UG sur GND (la masse, permet de démarrer la carte son en mode Uart)
  • Connecter RX sur la broche sortie de donnée (TX) de votre microcontroleur
  • Connecter TX sur la broche entrée de donnée (RX) de votre microcontroleur
  • Connecter RST sur une autre broche de votre microcontrôleur. La carte son sera réinitialisée lorsque le signal passera au niveau bas (LOW). Cela permet d'avoir une carte son dans un état connu.

Si vous désirez être averti lorsque la carte reproduit un fichier audio alors la broche ACT est le signal qu'il vous faut. La broche ACT pass au niveau bas lorsque la carte audio lit un fichier audio - cette sortie contrôle également l'état de la LED rouge ACT (qui s'allume lorsqu'un fichier audio est joué).

Vous pouvez utiliser une logique 3.3V ou 5V sur la broche RX, elle est équipée d'un level shifter (convertisseur de niveau logique). La broche TX est une sortie à 3.3v ce qui permet à un microcontrôleur 3.3v ou 5v de lire le signal en toute sécurité.

Pour la broche RST, cette broche est ramenée à un signal de 3.3V à l'aide d'une résistance pull-up. Passez le signal au niveau bas (LOW) pour réinitialiser la carte, ENSUITE, reconfigurez votre broche en entrée pour désactiver le niveau logique bas et laisser le signal flottant (qui sera en fait ramener à 3.3V par la résistance pull-up de la carte son): 

  digitalWrite(reset_pin, LOW);
  pinMode(reset_pin, OUTPUT);
  delay(10);
  pinMode(reset_pin, INPUT);
  delay(1000); // donner assez de temps à la carte son pour qu'elle démarre.

Après la réinitialisation (Reset), la carte son affichera une série d'information.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

La première ligne indique quand le firmware à été écrit (10/21/14) ainsi que le nom de la carte - le nom est identique pour toutes les cartes SFX (mais vous pourriez avoir des firmware de différente fate)

La seconde ligne indique FAT puis un chiffre en hexadécimal qui indique la taille de partition sur laquelle sont stockés tous les fichiers (en secteur de 512 octets). Dans le cas présent nous avons 0x7FC0 = 32704. Soit 32704 * 512 octets = 16,744,448 (16 MB)

Sur la troisième ligne, vous pouvez lire Files puis un nombre décimal sur 5 digits. Ce nombre indique le nombre de fichier sur la carte. Dans le cas présent, la carte contient 16 fichiers.

Commandes

Les commandes sont divisées en deux ensembles.

  • Un ensemble de commande peut être exécuté en mode IDLE (pendant que la carte ne fait rien)
  • Un autre ensemble de commande peut être exécuté pendant la lecture de piste audio (en mode PLAY).

Commandes en mode IDLE

Ces commandes peuvent être utilisées pendant que la carte ne lit pas de fichier audio!

Liste des fichiers

  • L - envoi L\n (L plus un retour à la ligne/new line) pour lister les fichiers

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Les fichiers sont listés au format suivant: 

FILENAMEEXTtaille_fichier

où "FILENAMEEXT" est le nom complet du fichier au format 8.3 (8 caractères pour le nom de fichier, 3 caractères pour l'extension du fichier). Le nom de fichier n'inclus pas le point. Si le nom du fichier contient moins de 8 caractères alors celui-ci sera complété avec des espaces (padded est le terme informatique anglophone correspondant).

La taille_fichier s'exprime en octet (byte) et est également paddé avec des zéros.

Modifier le volume

Vous pouvez ajuster le volume sonore depuis 0 (silence) à 204 (volume max) par incrément de 2. Pour accroitre le volume, envoyez +\n (symbole plus suivit d'un retour à la ligne.

Pour décroitre le volume, envoyez -\n (symbole moins suivit d'un retour à la ligne).

La carte son répondra avec le nouveau volume (5 caractères ascii, deux qui seront des zeros puis 3 digits de volumes, plus un caractère de retour clavier)

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Jouer une piste par numéro

Chaque piste dispose d'un numéro correspondant au moment ou le fichier à été copié sur la mémoire flash. La première piste porte le numéro 0, la numérotation suit l'ordre des fichiers tels qu'il sont affichés par la commande 'L' (liste des fichiers).

Le plus rapide pour jouer un fichier est de d'envoyer la commande #NN\n (symbole #, puis le numéro de la piste, et le caractère retour clavier pour finir). Par exemple, pour jouer la première piste (soit la piste 0), il faut envoyer la commande #0\n et pour jouer la 11ieme piste il faut envoyer la commande #10\n

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Si le fichier n'a pas été trouvé, la carte son répondra NoFile\n

Si le fichier est trouvé, la carte son répondra playNNNNNFILENAMEEXT\n

Où:

  • NNNNN est ne numéro de piste,
  • FILENAMEEXT le nom de fichier en 11 caractères (sans point, 8 caractères pour le fichier, 3 pour l'extension)

Lorsque le fichier est joué, la carte son affiche done\n pour vous indiquer que l'opération est terminée

Jouer une piste par nom

Peut être aurez vous envie de jouer une piste à partir de son nom (et non de son numéro). Pas de problème, vous pouvez utiliser la commande P

Envoyez la commande PFILENAMEEXT\n - lettre 'P' plus les 11 caractères du nom de fichier (8.3 sans le point de séparation) suivit du caractère 'retour à la ligne'. Si le nom de fichier fait moins de 8 caractères, remplissez le nom de fichier avec des blancs.

Par exemple:

  • Pour lire le fichier T00NEXT5.WAV, il faut envoyer la commande PT00NEXT5WAV\n
  • Pour lire le fichier T09.OGG, il faut envoyer la commande PT09 OGG\n (notez les espaces dans le nom de fichier).

Si le fichier n'est pas trouvé, la carte son répond NoFile\n sinon elle répondra comme précédemment avec playNNNNNFILENAMEEXT\n

Commandes en mode lecture

Maintenant que nous savons jouer des fichiers audio, vous pouvez également réaliser des actions pendant la lecture des fichiers.

Les actions ci-dessous ne sont disponible que durant la lecture d'un fichier audio.

Pause et reprise

Vous pouvez mettre la lecture en pause à n'importe quel moment en envoyant le caractère =, la caractère retour clavier n'est pas nécessaire. Pour redémarrer la lecture, il faut envoyer le caractère >

Ces caractères seront renvoyés par l'UART, c'est une façon de savoir qu'il a bien été recu!

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Arrêter la lecture

Vous pouvez également arrêter instantanément la piste audio en envoyant la commande q (pour 'quit'). Le fichier audio est stoppé et la carte audio revient en mode IDLE.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Position de la lecture

Vous pouvez interroger la carte pour savoir combien de temps est déjà écoulé dans la lecture de la piste. Envoyez le caractère t

Vous obtiendrez une réponse en 5 digits, une : et 5 autres digits.

Les 5 premiers 5 digits représente le nombre de secondes écoulées, la seconde partie est le temps total de lecture rapporté par le codec (cette valeur à toujours été à 0, nous vous recommandons de vous penchez sur la première partie)

Notez que cette opération est bloquante, l'utiliser trop souvent pourrait causer des parasites dans le rendu audio!

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Taille de fichier et autre

Pour finir, vous pouvez demander la taille d'un fichier et savoir a quelle position vous vous trouvez dans ce dernier (durant la lecture).

C'est un peu comme connaître le temps écoulé, cela peut varier pour les fichiers OGG compressés. Mais cela reste toujours très pratique!

Vous pouvez obtenir la taille du fichier et le nombre d'octets restant en envoyant le caractère 's'

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

La taille est rapportée en décimal (le nombre d'octets), taille exprimée avec 10 digits séparé par un '/'

Le premier numéro est le nombre d'octets restant et le second est le nombre total d'octets.

Attention: il s'agit d'une opération bloquante. L'utiliser trop souvent peut causer des effets audio indésirables (parasites)!

Source: Adafruit Audio FX Sound board Crédit: AdaFruit Industries

Créé par Ladyada pour AdaFruit Industries.
Traduit par Meurisse D. pour MCHobby.

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.

Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com

Récupérée de « https://wiki.mchobby.be/index.php?title=ADAFRUIT-AUDIO-FX-port-série&oldid=17225 »