mirror of https://github.com/arendst/Tasmota.git
62 lines
3.3 KiB
Markdown
62 lines
3.3 KiB
Markdown
# IRremoteESP8266 Library
|
|
|
|
This library enables you to **send _and_ receive** infra-red signals on an [ESP8266](https://github.com/esp8266/Arduino) or an
|
|
[ESP32](https://github.com/espressif/arduino-esp32) using the [Arduino framework](https://www.arduino.cc/) using common 940nm IR LEDs and common IR receiver modules. e.g. TSOP{17,22,24,36,38,44,48}* demodulators etc.
|
|
|
|
## Supported Protocols
|
|
You can find the details of which protocols & devices are supported
|
|
[here](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/SupportedProtocols.md).
|
|
|
|
## Troubleshooting
|
|
Before reporting an issue or asking for help, please try to follow our [Troubleshooting Guide](https://github.com/crankyoldgit/IRremoteESP8266/wiki/Troubleshooting-Guide) first.
|
|
|
|
## Frequently Asked Questions
|
|
Some common answers to common questions and problems are on our [F.A.Q. wiki page](https://github.com/crankyoldgit/IRremoteESP8266/wiki/Frequently-Asked-Questions).
|
|
|
|
## Library API Documentation
|
|
This library uses [Doxygen](https://www.doxygen.nl/index.html) to [automatically document](https://crankyoldgit.github.io/IRremoteESP8266/doxygen/html/) the [library's](https://crankyoldgit.github.io/IRremoteESP8266/doxygen/html/) [API](https://en.wikipedia.org/wiki/Application_programming_interface).
|
|
You can find it [here](https://crankyoldgit.github.io/IRremoteESP8266/doxygen/html/).
|
|
|
|
## Installation
|
|
##### Official releases via the Arduino IDE v1.8+ (Windows & Linux)
|
|
1. Click the _"Sketch"_ -> _"Include Library"_ -> _"Manage Libraries..."_ Menu items.
|
|
1. Enter `IRremoteESP8266` into the _"Filter your search..."_ top right search box.
|
|
1. Click on the IRremoteESP8266 result of the search.
|
|
1. Select the version you wish to install and click _"Install"_.
|
|
|
|
##### Manual Installation for Windows
|
|
1. Click on _"Clone or Download"_ button, then _"[Download ZIP](https://github.com/crankyoldgit/IRremoteESP8266/archive->master.zip)"_ on the page.
|
|
1. Extract the contents of the downloaded zip file.
|
|
1. Rename the extracted folder to _"IRremoteESP8266"_.
|
|
1. Move this folder to your libraries directory. (under windows: `C:\Users\YOURNAME\Documents\Arduino\libraries\`)
|
|
1. Restart your Arduino IDE.
|
|
1. Check out the examples.
|
|
|
|
##### Using Git to install the library ( Linux )
|
|
```
|
|
cd ~/Arduino/libraries
|
|
git clone https://github.com/crankyoldgit/IRremoteESP8266.git
|
|
```
|
|
###### To update to the latest version of the library
|
|
```
|
|
cd ~/Arduino/libraries/IRremoteESP8266 && git pull
|
|
```
|
|
|
|
## Contributing
|
|
If you want to [contribute](.github/CONTRIBUTING.md#how-can-i-contribute) to this project, consider:
|
|
- [Reporting](.github/CONTRIBUTING.md#reporting-bugs) bugs and errors
|
|
- Ask for enhancements
|
|
- Improve our documentation
|
|
- [Creating issues](.github/CONTRIBUTING.md#reporting-bugs) and [pull requests](.github/CONTRIBUTING.md#pull-requests)
|
|
- Tell other people about this library
|
|
|
|
## Contributors
|
|
Available [here](.github/Contributors.md)
|
|
|
|
## Library History
|
|
This library was originally based on Ken Shirriff's work (https://github.com/shirriff/Arduino-IRremote/)
|
|
|
|
[Mark Szabo](https://github.com/crankyoldgit/IRremoteESP8266) has updated the IRsend class to work on ESP8266 and [Sebastien Warin](https://github.com/sebastienwarin/IRremoteESP8266) the receiving & decoding part (IRrecv class).
|
|
|
|
As of v2.0, the library was almost entirely re-written with the ESP8266's resources in mind.
|