This library enables you to send and receive infra-red signals on an ESP8266 using Arduino framework (https://github.com/esp8266/Arduino)
Version 2.2 of the library is now available. This is a significant internal change to existing versions.
You will need to change your pre-v2.0 code slightly to work with post-v2.0 versions of the library. You can read more about the changes on our wiki page. Please report an issue if you find any problems with the documentation or the library itself.
Before reporting an issue or asking for help, please try to follow our Troubleshooting Guide first.
Some common answers to common questions and problems can be found on our F.A.Q. wiki page.
This library was originally based on Ken Shirriff's work (https://github.com/shirriff/Arduino-IRremote/)
Mark Szabo has updated the IRsend class to work on ESP8266 and Sebastien Warin the receiving & decoding part (IRrecv class).
- Click "Download ZIP"
- Extract the downloaded zip file
- Rename the extracted folder to "IRremoteESP8266"
- Move this folder to your libraries directory (under windows: C:\Users\YOURNAME\Documents\Arduino\libraries)
- Restart your Arduino ide
- Check out the examples
cd ~/Arduino/libraries
git clone https://github.com/markszabo/IRremoteESP8266.git
cd ~/Arduino/libraries/IRremoteESP8266 && git pull
The Unit Tests under the test/ directory are for a Unix machine, not the micro-controller (ESP8266). This allows execution under Travis and on the developer's machine. We can do this from v2.0 of the library onwards, as everything now uses c98-style type definitions. e.g. uint16_t etc. Any Arduino/ESP8266 specific code needs to be disabled using something similar to the following lines:
#ifndef UNIT_TEST
<Arduino specific code ...>
#endif
This is not a perfect situation as we can not obviously emulate hardware specific features and differences. e.g. Interrupts, GPIOs, CPU instruction timing etc, etc.
If you want to run all the tests yourself, try the following:
$ cd test
$ make run
If you want to contribute to this project, consider:
- Report bugs and errors
- Ask for enhancements
- Create issues and pull requests
- Tell other people about this library
Available here