Arduino IRremote

A library enabling the sending & receiving of infrared signals.

Available as Arduino library "IRremote".

If you find this program useful, please give it a star.

🌎 Google Translate

Table of contents

• Supported IR Protocols
• Common issues when using IRremote
• Migrating legacy projects to the latest version
• New features and changes in version 4.6
• New features of version 4.x
• New features of version 3.x
• Converting your 2.x program to the 4.x version
• How to convert old MSB first 32 bit IR data codes to new LSB first 32 bit IR data codes
• Errors when using the 3.x versions for old tutorials
• Staying on 2.x
• Why .hpp instead of .cpp files
• Using the new *.hpp files
• Tutorials
• 3 ways to specify an IR code
• IRReceiver pinouts
• Receiving IR codes
• decodedIRData structure
• Callback functionality
• Ambiguous protocols
• RAM usage of different protocols
• Handling unknown Protocols
  • Disclaimer
  • Other libraries, which may cover these protocols
  • Protocol=PULSE_DISTANCE
  • Protocol=UNKNOWN
  • How to deal with protocols not supported by IRremote
• Multiple IR receivers
• Sending IR codes
• Sending UNKNOWN protocol
• Sending IRDB IR codes
  • List of public IR code databases
• Flipper Zero Codes
• Send pin
• Polarity of send pin
• Simulate an IR receiver module for sending
• Increase strength of sent output signal
• Multiple IR sender instances
• Tiny NEC receiver and sender
• The FAST protocol
• Feedback LED
• IRCommandDispatcher class
• FAQ and hints
• Receiving stops after analogWrite() or tone() or after running a motor
• Receiving sets overflow flag
• Problems with Neopixels, FastLed etc.
• Does not work/compile with another library
• Minimal CPU clock frequency
• Bang & Olufsen protocol
• Examples for this library
• WOKWI online examples
• IR control of a robot car
• Issues and discussions
• Compile options / macros for IRremote
• Macros for TinyIR
• Macros for IRCommandDispatcher
  • Changing include (*.h) files with Arduino IDE
  • Modifying compile options / macros with PlatformIO
  • Modifying compile options with Sloeber IDE
• Supported Boards
• Timer and pin usage
• Incompatibilities to other libraries and Arduino commands like tone() and analogWrite()
• Hardware-PWM signal generation for sending
• Why do we use 30% duty cycle for sending
• How we decode signals
• NEC encoding diagrams
• Quick comparison of 5 Arduino IR receiving libraries
• History
• Useful links
• Contributors
• License
• Copyright

Supported IR Protocols

NEC / Onkyo / Apple,     Denon / Sharp,     Panasonic / Kaseikyo,

JVC,     LG,     RC5,     RC6,     Samsung,     Sony,     Marantz

Universal Pulse Distance,     Universal Pulse Width,     Universal Pulse Distance Width

Hash,     Pronto

BoseWave,     Bang & Olufsen,     Lego,     FAST,     Whynter,     Marantz,     MagiQuest,     Velux,     OpenLASIR

Protocols can be switched off and on by defining macros before the line #include <IRremote.hpp> like here:

#define DECODE_NEC
//#define DECODE_DENON
#include <IRremote.hpp>

Common issues when using IRremote

Or "I build a gadget with 2 motors controlled by IR and the IR stops after the first motor command".

This is due to the fact, that the motor control by AnalogWrite() uses the same timer as IR receiving.

See this table for the list of timers and pins.

Migrating legacy projects to the latest version

This library has been refactored, breaking backward compatibility with the old version, on which many examples on the Internet are based.

If your code uses irrecv.decode(&results), it is written for Version 2.x. This library (Version 4.x) now uses a simpler IrReceiver.decode() syntax. See the Conversion guide below.

New features and