6.2 KiB
IRremoteESP8266 Library
Cette librairie vous permetra de recevoir et d'envoyer des signaux infrarouge sur le protocole ESP8266 ou sur le protocole ESP32 en utilisant le Arduino framework qui utilise la norme 940nm IR LEDs et le module basique de reception d'onde IR. Exemple : TSOP{17,22,24,36,38,44,48}* modules etc.
v2.7.11 disponible
Version 2.7.11 de la libraire est maintenant disponible. Vous pouvez voir le Release Notes pour tous les changements importants.
mise à jour depuis pre-v2.0
L'utilisation de la librairie à un peu changer depuis la version in v2.0. Si vous voulez l'utiliser vous devrez changer votre utilisation aussi. Vous pouvez vous renseigner sur les précondition d'utilisation ici : Upgrade to v2.0 page.
Mise à jour depuis pre-v2.5
La librairie à changer, elle n'utilise plus les constantes déclarées comme #define
mais comme :
const avec le nom approprié par le langage
C++ style guide.
Il se peut que d'ancien programme ne compile pas.
Le cas le plus utilisé de #define
s à été remplacé par aliased pour limiter
la compatibilité de revenir en arrière pour les vieux projet. En revenant en arrière seulement la
nouvelle kConstantName
style est supporté.
Dans le cas peu probable, votre code serait cassé, alors vous avez peut-être fait référence à
quelque chose que vous ne devriez probablement pas avoir.Vous devez être capable de determiner le nouveau nom
qui remplacera l'ancien. exemple : CONSTANT_NAME
par kConstantName
.
Si vous avez un problème examinez le code pour trouver le problème.
Protocoles supportés
Vous pouvez trouver le détails des protocoles et machines supportés here.
Dépannage
Avant de reporter un probème ou de demander de l'aide, essayez de suivre notre guide de dépannage first.
Questions fréquentes
Les questions les plus fréquentes sont ici, avec des réponses F.A.Q. wiki page.
Documentation API de la bibliothèque
Cette bibliothèque utilise Doxygen pour documenter automatiquement l'API de la bibliothèque. Vous pouvez le trouver ici.
Installation
Officiel releases avec l'Arduino IDE v1.8+ (Windows & Linux)
- Cliquez sur "Sketch" -> "Include Library" -> "Manage Libraries..." Menu items.
- Entrez
IRremoteESP8266
dans le "Filter your search..." barre de recherche en haut à droite. - Cliquez sur le IRremoteESP8266 pour avoir les résultats de la recherche.
- Selectionnez la version que vous voulez installer et cliquez sur "Install".
Library API Documentation
This library uses Doxygen to automatically document the library's API. You can find it here.
Installation manuelle pour Windows
- cliquez le boutton sur "Clone or Download" , et "Download ZIP" on the page.
- Extraire l'archive.
- renommez le fichier par "IRremoteESP8266".
- déplacer le fichier dans votre fichier de bibliothèques. (Pour windows :
C:\Users\VOTRE_NOM\Documents\Arduino\libraries\
) - Redemarrez arduino IDE.
- Regardez les exemples.
En utilisant GIT ( Linux )
cd ~/Arduino/libraries
git clone https://github.com/crankyoldgit/IRremoteESP8266.git
Pour se mettre à jour
cd ~/Arduino/libraries/IRremoteESP8266 && git pull
Contribution
Si vous voulez contribuer au projet, pour les erreurs:
- Reporting bug et erreurs
- Demander des améliorations
- Améliorer notre documentation
- Création d'issues et pull requests
- Parlez de cettre librairie à d'autres personnes
Contributeurs
disponible ici
Historique de la bibliothèque
Elle est basée sur le travail de Shirriff (https://github.com/shirriff/Arduino-IRremote/)
Mark Szabo à mis a jour la IRsend class pour qu'elle soit fonctionnelle sur ESP8266 et Sebastien Warin s'est occupé de la partie réception et décodage (IRrecv class).
Comme pour la version 2.0, la bibliothèque à été completement réécrite avec les ressources sur ESP8266.