Brancher des périphériques USB sur un ESP8266 : Différence entre versions
Ligne 1 : Ligne 1 :
 
{{ {{tntn|Tuto Details}}
 
{{ {{tntn|Tuto Details}}
 +
|SourceLanguage=none
 +
|Language=fr
 +
|IsTranslation=0
 
|Main_Picture=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_wiki.jpg
 
|Main_Picture=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_wiki.jpg
 
|Licences=Attribution (CC BY)
 
|Licences=Attribution (CC BY)
Ligne 12 : Ligne 15 :
 
|Currency=EUR (€)
 
|Currency=EUR (€)
 
|Tags=arduino, esp8266, esp32, usb host, clavier, souris, manette, xbox, MIDI
 
|Tags=arduino, esp8266, esp32, usb host, clavier, souris, manette, xbox, MIDI
−
|SourceLanguage=none
 
−
|Language=fr
 
−
|IsTranslation=0
 
 
}}
 
}}
 
{{ {{tntn|Introduction}}
 
{{ {{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.
 
|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!
+
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}}
 
{{ {{tntn|TutoVideo}}
Ligne 42 : Ligne 42 :
 
La puce sur celle-ci est un MAX3421E qui ne fonctionne quand 3.3v
 
La puce sur celle-ci est un MAX3421E qui ne fonctionne quand 3.3v
  
−
Si vous voulez utiliser un '''microcontrôleur en 5v''' (comme l'Arduino Uno / Nano) '''utiliser le Shield USB Host plutôt.'''
+
{{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.'''
 
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_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}}
 
{{ {{tntn|Tuto Step}}
 
|Step_Title=Régler le problème d'alimentation
 
|Step_Title=Régler le problème d'alimentation
−
|Step_Content=Si vous avez acheter '''un clone de l'USB Host Mini''', il n'y a pas de '''jumper pour le VBUS'''.
+
|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'''
 
Cela veut dire que les périphériques USB '''seront alimentés en 3.3v'''
  
−
Malheureusement '''aucun de mes périphériques ne marchent''' car ils '''nécessitent tous du 5v'''
+
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)
 
Vous pouvez en apprendre plus sur ce lien (en japonais)
Ligne 59 : Ligne 62 :
 
https://ht-deko.com/arduino/shield_usbhost_mini.html  
 
https://ht-deko.com/arduino/shield_usbhost_mini.html  
  
−
Il va falloir couper une trâce sur le circuit pour règler ce problème.
+
Il va falloir couper une trace sur le circuit pour régler ce problème.
  
−
J'ai utiliser un '''petit tournevis plat''', mais si vous avez un '''cutter fin c'est surement mieux.'''
+
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}}
 
{{ {{tntn|Tuto Step}}
Ligne 69 : Ligne 73 :
 
J'ai utilisé un Wemos Mini D1 avec mon USB Host Mini, voici comment le brancher.
 
J'ai utilisé un Wemos Mini D1 avec mon USB Host Mini, voici comment le brancher.
  
−
{{Info|Je n'ai pas relier la broche INT, car celle-ci ne semble pas nécessaire au fonctionnement}}<br />
+
{{Info|Je n'ai pas relié la broche INT, car celle-ci ne semble pas nécessaire au fonctionnement}}
  
 
*D3 -- SS
 
*D3 -- SS
Ligne 78 : Ligne 82 :
  
 
<br />
 
<br />
 +
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_esp.jpg
 
}}
 
}}
 
{{ {{tntn|Tuto Step}}
 
{{ {{tntn|Tuto Step}}
 
|Step_Title=Régler le problème avec la bibliothèque USB Host
 
|Step_Title=Régler le problème avec la bibliothèque USB Host
−
|Step_Content=Vous avez peut être remarquer que pour la broche SS (Chip Select / CS) j'ai utilisé la '''broche D3''' au lieu de la '''broche par défaut D8.'''
+
|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 bloquer l'exécution du sketch.
+
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
 
https://github.com/felis/USB_Host_Shield_2.0/issues/457
Ligne 98 : Ligne 103 :
  
 
  <code>#elif defined(ESP8266)typedef MAX3421e<P0, P5> MAX3421E; // ESP8266 boards</code>
 
  <code>#elif defined(ESP8266)typedef MAX3421e<P0, P5> MAX3421E; // ESP8266 boards</code>
−
{{Info|Pourquoi P0 au lieu de D3 ?, c'est parceque le GPIO0 est le D3 sur le Wemos Mini.}}
+
{{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/
 
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}}
 
{{ {{tntn|Tuto Step}}
 
|Step_Title=Downgrader ESP8266
 
|Step_Title=Downgrader ESP8266
−
|Step_Content=On y est presque, si vous essayer de compiler un exemple dans la bibliothèque, '''il ne marchera pas!'''
+
|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 utiliser la version 1.3.2 de cette bibliothèque}}
+
{{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}}
  
 
La raison pour laquelle la compilation ne marche pas et à cause d'une incompatibilité entre la bibliothèque et la version 2.5 d'ESP8266 sur le logiciel Arduino.
 
La raison pour laquelle la compilation ne marche pas et à cause d'une incompatibilité entre la bibliothèque et la version 2.5 d'ESP8266 sur le logiciel Arduino.
Ligne 116 : Ligne 122 :
  
 
<br />
 
<br />
 +
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_esp8266_lib.jpg
 
}}
 
}}
 
{{ {{tntn|Tuto Step}}
 
{{ {{tntn|Tuto Step}}
Ligne 133 : Ligne 140 :
  
 
<br />
 
<br />
 +
|Step_Picture_00=Brancher_des_périphériques_USB_sur_un_ESP8266_usbhost_ex.jpg
 
}}
 
}}
 
{{ {{tntn|Tuto Step}}
 
{{ {{tntn|Tuto Step}}
Ligne 138 : Ligne 146 :
 
|Step_Content=Si vous avez une manette de '''XBOX360 pour PC''', vous pouvez tester l'exemple : X'''BOX/XBOXUSB'''
 
|Step_Content=Si vous avez une manette de '''XBOX360 pour PC''', vous pouvez tester l'exemple : X'''BOX/XBOXUSB'''
  
−
*'''L2/R2''' vibre quand vous appuyer dessus.
+
*'''L2/R2''' vibre quand vous appuyez dessus.
 
*L2/R2 : 0/255
 
*L2/R2 : 0/255
 
*Stick (Hat) X/Y : -32768 / 32768
 
*Stick (Hat) X/Y : -32768 / 32768
−
*Les LEDs peuvent aussi être contrôlés ! (appuyer sur '''pad''' / '''back''' / '''start''' / '''xbox''' pour essayer)
+
*Les LED peuvent aussi être contrôlées ! (appuyer sur '''pad''' / '''back''' / '''start''' / '''xbox''' pour essayer)
 
}}
 
}}
 
{{ {{tntn|Tuto Step}}
 
{{ {{tntn|Tuto Step}}
Ligne 151 : Ligne 159 :
 
|Step_Content=Ouvrez l'exemple '''USBH_MIDI/USBH_MIDI_dump'''
 
|Step_Content=Ouvrez l'exemple '''USBH_MIDI/USBH_MIDI_dump'''
  
−
La plupart des périphériques MIDI n'utilise qu'une petit partie du buffer ('''bufMidi''')
+
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>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>
Ligne 163 : Ligne 171 :
 
{{ {{tntn|Tuto Step}}
 
{{ {{tntn|Tuto Step}}
 
|Step_Title=Conclusion
 
|Step_Title=Conclusion
−
|Step_Content=Utiliser des périphériques USB ouvre la porte à énormement de possibilités avec nos microcontroleur
+
|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.
 
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.
 
*Vous pouvez utiliser un '''Hub USB''' pour contrôler plusieurs périphériques USB.
−
*Ils y a pleins de broches sur l'USB Host, c'est parcequ'elle sont utilisables comme des GPIO ! Ils est possible de brancher des boutons / leds même un écran LCD dessus.
+
*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.'''
 
*Il est même possible d'utiliser des '''clés''' '''USB.'''
 
}}
 
}}

Version du 21 avril 2019 à 13:45

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 !

Auteur avatarRémi Sarrailh (µsini) | Dernière modification 9/11/2020 par Madnerd

Brancher des périphériques USB sur un ESP8266 usbhost wiki.jpg
Difficulté
Moyen
Durée
2 heure(s)
Catégories
Électronique, Musique & Sons, Jeux & Loisirs
Coût
6 EUR (€)
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 !
Difficulté
Moyen
Durée
2 heure(s)
Catégories
Électronique, Musique & Sons, Jeux & Loisirs
Coût
6 EUR (€)
Autres langues :
français
Licence : Attribution (CC BY)

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!

Video d'introduction

Matériaux

  • Un microcontrôleur 3.3v (par ex: Wemos Mini)
  • Un USB Host Mini

Outils

Un petit tournevis plat / Un cutter fin

Étape 1 - Choisir l'USB Host

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

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.

Brancher des périphériques USB sur un ESP8266 3V3 only.png
Brancher des périphériques USB sur un ESP8266 usbhost mini.jpg
Brancher des périphériques USB sur un ESP8266 usbhost shield.jpg


Étape 2 - Régler le problème d'alimentation

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.

Brancher des périphériques USB sur un ESP8266 usbhost mini fix.jpg




Étape 3 - Brancher l'USB Host

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.

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


Brancher des périphériques USB sur un ESP8266 usbhost esp.jpg




Étape 4 - Régler le problème avec la bibliothèque USB Host

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

#elif defined(ESP8266)typedef MAX3421e<P15, P5> MAX3421E; // ESP8266 boards

Avec cette ligne 

#elif defined(ESP8266)typedef MAX3421e<P0, P5> MAX3421E; // ESP8266 boards
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/

Brancher des périphériques USB sur un ESP8266 image Ky517r0vQa.jpg




Étape 5 - Downgrader ESP8266

On y est presque, si vous essayez de compiler un exemple dans la bibliothèque, il ne marchera pas!

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

La raison pour laquelle la compilation ne marche pas et à cause d'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


Brancher des périphériques USB sur un ESP8266 esp8266 lib.jpg




Étape 6 - Test l'USB Host

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)
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.


Brancher des périphériques USB sur un ESP8266 usbhost ex.jpg




Étape 7 - Exemple : Manette XBOX360

Si vous avez une manette de XBOX360 pour PC, vous pouvez tester l'exemple : XBOX/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)

Étape 8 - Exemple : Souris

Je n'ai pas réussi à utiliser ma souris. L'exemple se trouve ici : HID/USBHIDBootMouse

Étape 9 - Exemple : Contrôleur Midi

Ouvrez l'exemple USBH_MIDI/USBH_MIDI_dump

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

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

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

  • bufMidi[0] : Note ON (9) / Note OFF (8)
  • bufMidi[2] : Note
  • bufMidi[3] : Velocity

Étape 10 - Conclusion

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.

Commentaires

Draft

Récupérée de « https://wikifab.org/w/index.php?title=Brancher_des_périphériques_USB_sur_un_ESP8266&oldid=62910 »
© 2017 - 2024 Dokit, SAS.