Voir la source de Brancher des périphériques USB sur un ESP8266/fr

{{ {{tntn|Tuto Details}}
|SourceLanguage=none
|Language=fr
|IsTranslation=1
|Main_Picture=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_wiki.jpg
|Licences=Attribution (CC BY)
|Description=Saviez vous que vous pouvez brancher des périphériques USB sur un Arduino ou un ESP ?
Que ce soit un clavier, une souris, un manette de jeu ou un contrôleur MIDI, c'est possible !
|Area=Electronics, Music and Sound, Play and Hobbies
|Type=Technique
|Difficulty=Medium
|Duration=2
|Duration-type=hour(s)
|Cost=6
|Currency=EUR (€)
|Tags=arduino, esp8266, esp32, usb host, clavier, souris, manette, xbox, MIDI
}}
{{ {{tntn|Introduction}}
|Introduction=Je jouais avec '''Mozzi''', une '''bibliothèque de synthèse audio''' (https://sensorium.github.io/Mozzi/), quand je me suis rendu compte que si je voulais vraiment pouvoir exploiter tout le potentiel de cette bibliothèque, j'allais devoir faire un contrôleur.

Si seulement, je pouvais brancher un '''clavier''' ou un '''contrôleur midi''', ça serait carrément plus simplement ! Mais attends ?! C'est possible en fait!
}}
{{ {{tntn|TutoVideo}}
|VideoType=Youtube
|VideoURLYoutube=https://www.youtube.com/watch?v=CeLYOu-UGXA
}}
{{ {{tntn|Materials}}
|Step_Picture_00=Contrôler_des_neopixels_comme_un_DJ_Envoyer_un_message_sur_discord_wemos.png
|Step_Picture_01=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_mini_def.png
|Material=* Un microcontrôleur 3.3v (par ex: Wemos Mini)
* Un USB Host Mini
|Tools=Un petit tournevis plat / Un cutter fin
}}
{{ {{tntn|Separator}}}}
{{ {{tntn|Tuto Step}}
|Step_Title=Choisir l'USB Host
|Step_Content=Merci à CircuitatHome pour la création de l'USB Host
https://www.circuitsathome.com/usb-host-shield-hardware-manual/

Dans ce tutoriel nous allons utilisé un clone de l''''USB Host Mini'''.

La puce sur celle-ci est un MAX3421E qui ne fonctionne quand 3.3v

{{Idea|Si vous voulez utiliser un microcontrôleur en 5v (comme l'Arduino Uno / Nano) utiliser plutôt le Shield USB Host.}}


Malheureusement avant de pouvoir brancher notre USB Host, il va nous falloir '''régler plusieurs problèmes''' sinon '''cela ne marchera pas.'''
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_3V3_only.png
|Step_Picture_01=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_mini.jpg
|Step_Picture_02=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_shield.jpg
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Régler le problème d'alimentation
|Step_Content=Si vous avez acheté '''un clone de l'USB Host Mini''', il n'y a pas de '''jumper pour le VBUS'''.

Cela veut dire que les périphériques USB '''seront alimentés en 3.3v'''

Malheureusement, '''aucun de mes périphériques ne marche,''' car ils '''nécessitent tous du 5v.'''

Vous pouvez en apprendre plus sur ce lien (en japonais)

https://ht-deko.com/arduino/shield_usbhost_mini.html 

Il va falloir couper une trace sur le circuit pour régler ce problème.

J'ai utilisé un '''petit tournevis plat''', mais si vous avez un '''cutter fin c'est surement mieux.'''
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_mini_fix.jpg
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Brancher l'USB Host
|Step_Content=OK, j'espère que vous n'avez pas cassé votre carte! Maintenant il est temps de la brancher !

J'ai utilisé un Wemos Mini D1 avec mon USB Host Mini, voici comment le brancher.

{{Info|Je n'ai pas relié la broche INT, car celle-ci ne semble pas nécessaire au fonctionnement}}

*D3 -- SS
*D7 -- MISO
*D6 -- MOSI
*D5 -- SCK
*RST -- RST

<br />
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_esp.jpg
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Régler le problème avec la bibliothèque USB Host
|Step_Content=Vous avez peut-être remarqué que pour la broche SS (Chip Select / CS) j'ai utilisé la '''broche D3''' au lieu de la '''broche par défaut D8.'''

J'ai eu un problème avec l'USB Host qui mettait mon Wemos Mini en mode programmation et bloqué l'exécution du sketch.

https://github.com/felis/USB_Host_Shield_2.0/issues/457

Afin de '''changer la broche SS''', il va falloir changer une ligne dans la bibliothèque.

Télécharger '''USB Host Shield Library 2.0'''

Ouvrez le fichier '''UsbCore.h''' dans '''libraries/USB_Host_Shield_Library_2.0''' et changer cette ligne
 
<code>#elif defined(ESP8266)typedef MAX3421e<P15, P5> MAX3421E; // ESP8266 boards </code>

Avec cette ligne

 <code>#elif defined(ESP8266)typedef MAX3421e<P0, P5> MAX3421E; // ESP8266 boards</code>
{{Info|Pourquoi P0 au lieu de D3 ? c'est parce que le GPIO0 est le D3 sur le Wemos Mini.}}
https://escapequotes.net/esp8266-wemos-d1-mini-pins-and-diagram/
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_image_Ky517r0vQa.jpg
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Downgrader ESP8266
|Step_Content=On y est presque, si vous essayez de compiler un exemple dans la bibliothèque, '''il ne marchera pas!'''

{{Info|Ce problème a été réglé récemment, cette étape n'est nécessaire que si vous utilisez la version 1.3.2 de cette bibliothèque}}

Il y a une incompatibilité entre la bibliothèque et la version 2.5 d'ESP8266 sur le logiciel Arduino.

'''Il va falloir downgrader celle-ci à 2.4.2'''

https://github.com/felis/USB_Host_Shield_2.0/issues/449

Aller dans '''Outils''' / '''Type de carte''' / '''Gestionnaire de carte''' et changer la version à '''2.4.2'''

<br />
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_esp8266_lib.jpg
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Test l'USB Host
|Step_Content=Il y a beaucoup d'exemples dans l''''USB Host Shield Library 2.0.'''

Afin de tester si tout marche correctement, je vous conseille de commencer par '''USB_desc'''.

*'''Téléverser''' USB_desc
*Ouvrez le  '''Moniteur Série''' (115200)
*'''Brancher votre périphérique USB'''
*'''Redémarrer la carte''' (ESP8266)
{{Info|Il n'est pas possible de brancher "à chaud" le périphérique USB (du moins dans les exemples)
Vous devez redémarrer votre carte à chaque fois que vous débrancher et rebrancher un périphérique.}}

Vous devriez voir un long message décrivant votre périphérique.

<br />
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_ex.jpg
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Exemple : Manette XBOX360
|Step_Content=Si vous avez une manette de '''XBOX360 pour PC''', vous pouvez tester l'exemple : X'''BOX/XBOXUSB'''

*'''L2/R2''' vibre quand vous appuyez dessus.
*L2/R2 : 0/255
*Stick (Hat) X/Y : -32768 / 32768
*Les LED peuvent aussi être contrôlées ! (appuyer sur '''pad''' / '''back''' / '''start''' / '''xbox''' pour essayer)
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Exemple : Souris
|Step_Content=Je n'ai pas réussi à utiliser ma souris. L'exemple se trouve ici : '''HID/USBHIDBootMouse'''
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Exemple : Contrôleur Midi
|Step_Content=Ouvrez l'exemple '''USBH_MIDI/USBH_MIDI_dump'''

La plupart des périphériques MIDI n'utilisent qu'une petite partie du buffer ('''bufMidi''')

<code>00001679: 64: 09 90 2F 13 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00</code>

<code>0000174A: 64: 08 80 2F 7F 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00</code>

*bufMidi[0] : Note ON (9) / Note OFF (8)
*bufMidi[2] : Note
*bufMidi[3] : Velocity
}}
{{ {{tntn|Tuto Step}}
|Step_Title=Conclusion
|Step_Content=Utiliser des périphériques USB ouvre la porte à énormément de possibilités avec nos microcontrôleurs

Nous n'avons vu qu'une infime partie de ce qu'il est possible de faire.

*Vous pouvez utiliser un '''Hub USB''' pour contrôler plusieurs périphériques USB.
*Il y a plein de broches sur l'USB Host, c'est parce qu’elle sont utilisables comme des GPIO ! Il est possible de brancher des boutons / LED même un écran LCD dessus.
*Il est même possible d'utiliser des '''clés''' '''USB.'''
}}
{{ {{tntn|Notes}}
|Notes=
}}
{{ {{tntn|Tuto Status}}
|Complete=Published
}}