Functions
	IRsend::IRsend ()

	IRsend::IRsend (uint_fast8_t aSendPin)

void	IRsend::begin (uint_fast8_t aSendPin)
	Initializes the send pin and enable LED feedback with board specific FEEDBACK_LED_ON() and FEEDBACK_LED_OFF() functions. More...

void	IRsend::setSendPin (uint_fast8_t aSendPin)

void	IRsend::begin (uint_fast8_t aSendPin, bool aEnableLEDFeedback, uint_fast8_t aFeedbackLEDPin)
	Initializes the send and feedback pin. More...

size_t	IRsend::write (IRData *aIRSendData, int_fast8_t aNumberOfRepeats=NO_REPEATS)
	Interprets and sends a IRData structure. More...

size_t	IRsend::write (decode_type_t aProtocol, uint16_t aAddress, uint16_t aCommand, int_fast8_t aNumberOfRepeats=NO_REPEATS)
	Simple version of write without support for MAGIQUEST and numberOfBits for SONY protocol. More...

void	IRsend::sendRaw (const uint16_t aBufferWithMicroseconds[], uint_fast16_t aLengthOfBuffer, uint_fast8_t aIRFrequencyKilohertz)
	Function using an 16 byte microsecond timing array for every purpose. More...

void	IRsend::sendRaw (const uint8_t aBufferWithTicks[], uint_fast16_t aLengthOfBuffer, uint_fast8_t aIRFrequencyKilohertz)
	Function using an 8 byte tick timing array to save program memory Raw data starts with a Mark. More...

void	IRsend::sendRaw_P (const uint16_t aBufferWithMicroseconds[], uint_fast16_t aLengthOfBuffer, uint_fast8_t aIRFrequencyKilohertz)
	Function using an 16 byte microsecond timing array in FLASH for every purpose. More...

void	IRsend::sendRaw_P (const uint8_t aBufferWithTicks[], uint_fast16_t aLengthOfBuffer, uint_fast8_t aIRFrequencyKilohertz)
	New function using an 8 byte tick (50 us) timing array in FLASH to save program memory Raw data starts with a Mark. More...

void	IRsend::sendPulseDistanceWidthFromArray (uint_fast8_t aFrequencyKHz, uint16_t aHeaderMarkMicros, uint16_t aHeaderSpaceMicros, uint16_t aOneMarkMicros, uint16_t aOneSpaceMicros, uint16_t aZeroMarkMicros, uint16_t aZeroSpaceMicros, IRRawDataType *aDecodedRawDataArray, uint16_t aNumberOfBits, bool aMSBFirst, bool aSendStopBit, uint16_t aRepeatPeriodMillis, int_fast8_t aNumberOfRepeats) __attribute__((deprecated("Since version 4.1.0 parameter aSendStopBit is not longer required.")))
	Sends PulseDistance data from array For LSB First the LSB of array[0] is sent first then all bits until MSB of array[0]. More...

void	IRsend::sendPulseDistanceWidthFromArray (uint_fast8_t aFrequencyKHz, DistanceWidthTimingInfoStruct aDistanceWidthTimingInfo, IRRawDataType aDecodedRawDataArray, uint16_t aNumberOfBits, uint8_t aFlags, uint16_t aRepeatPeriodMillis, int_fast8_t aNumberOfRepeats)

void	IRsend::sendPulseDistanceWidthFromArray (uint_fast8_t aFrequencyKHz, uint16_t aHeaderMarkMicros, uint16_t aHeaderSpaceMicros, uint16_t aOneMarkMicros, uint16_t aOneSpaceMicros, uint16_t aZeroMarkMicros, uint16_t aZeroSpaceMicros, IRRawDataType *aDecodedRawDataArray, uint16_t aNumberOfBits, uint8_t aFlags, uint16_t aRepeatPeriodMillis, int_fast8_t aNumberOfRepeats)

void	IRsend::sendPulseDistanceWidthFromArray (PulseDistanceWidthProtocolConstants aProtocolConstants, IRRawDataType aDecodedRawDataArray, uint16_t aNumberOfBits, int_fast8_t aNumberOfRepeats)
	Sends PulseDistance data from array using PulseDistanceWidthProtocolConstants For LSB First the LSB of array[0] is sent first then all bits until MSB of array[0]. More...

void	IRsend::sendPulseDistanceWidth (PulseDistanceWidthProtocolConstants *aProtocolConstants, IRRawDataType aData, uint_fast8_t aNumberOfBits, int_fast8_t aNumberOfRepeats)
	Sends PulseDistance frames and repeats and enables receiver again. More...

void	IRsend::sendPulseDistanceWidth (uint_fast8_t aFrequencyKHz, uint16_t aHeaderMarkMicros, uint16_t aHeaderSpaceMicros, uint16_t aOneMarkMicros, uint16_t aOneSpaceMicros, uint16_t aZeroMarkMicros, uint16_t aZeroSpaceMicros, IRRawDataType aData, uint_fast8_t aNumberOfBits, bool aMSBFirst, bool aSendStopBit, uint16_t aRepeatPeriodMillis, int_fast8_t aNumberOfRepeats, void(*aSpecialSendRepeatFunction)()=NULL) __attribute__((deprecated("Since version 4.1.0 parameter aSendStopBit is not longer required.")))
	Sends PulseDistance frames and repeats. More...

void	IRsend::sendPulseDistanceWidth (uint_fast8_t aFrequencyKHz, uint16_t aHeaderMarkMicros, uint16_t aHeaderSpaceMicros, uint16_t aOneMarkMicros, uint16_t aOneSpaceMicros, uint16_t aZeroMarkMicros, uint16_t aZeroSpaceMicros, IRRawDataType aData, uint_fast8_t aNumberOfBits, uint8_t aFlags, uint16_t aRepeatPeriodMillis, int_fast8_t aNumberOfRepeats, void(*aSpecialSendRepeatFunction)()=NULL)

void	IRsend::sendPulseDistanceWidthData (PulseDistanceWidthProtocolConstants *aProtocolConstants, IRRawDataType aData, uint_fast8_t aNumberOfBits)
	Sends PulseDistance data The output always ends with a space Each additional call costs 16 bytes program memory. More...

void	IRsend::sendPulseDistanceWidthData (uint16_t aOneMarkMicros, uint16_t aOneSpaceMicros, uint16_t aZeroMarkMicros, uint16_t aZeroSpaceMicros, IRRawDataType aData, uint_fast8_t aNumberOfBits, bool aMSBFirst, bool aSendStopBit) __attribute__((deprecated("Since version 4.1.0 last parameter aSendStopBit is not longer required.")))
	Sends PulseDistance data The output always ends with a space. More...

void	IRsend::sendPulseDistanceWidthData (uint16_t aOneMarkMicros, uint16_t aOneSpaceMicros, uint16_t aZeroMarkMicros, uint16_t aZeroSpaceMicros, IRRawDataType aData, uint_fast8_t aNumberOfBits, uint8_t aFlags)

void	IRsend::sendBiphaseData (uint16_t aBiphaseTimeUnit, uint32_t aData, uint_fast8_t aNumberOfBits)
	Sends Biphase data MSB first Always send start bit, do not send the trailing space of the start bit 0 -> mark+space 1 -> space+mark The output always ends with a space can only send 31 bit data, since we put the start bit as 32th bit on front. More...

void	IRsend::mark (uint16_t aMarkMicros)
	Sends an IR mark for the specified number of microseconds. More...

void	IRsend::IRLedOff ()
	Just switch the IR sending LED off to send an IR space A space is "no output", so the PWM output is disabled. More...

static void	IRsend::space (uint16_t aSpaceMicros)
	Sends an IR space for the specified number of microseconds. More...

static void	IRsend::customDelayMicroseconds (unsigned long aMicroseconds)
	Custom delay function that circumvents Arduino's delayMicroseconds 16 bit limit and is (mostly) not extended by the duration of interrupt codes like the millis() interrupt. More...

void	IRsend::enableIROut (uint_fast8_t aFrequencyKHz)
	Enables IR output. More...

uint16_t	IRsend::getPulseCorrectionNanos ()

Variables
IRsend	IrSender

Detailed Description

Function Documentation

◆ IRsend() [1/2]

IRsend::IRsend ( )

Definition at line 67 of file IRSend.hpp.

◆ IRsend() [2/2]

IRsend::IRsend ( uint_fast8_t aSendPin )

Definition at line 110 of file IRSend.hpp.

◆ begin() [1/2]

void IRsend::begin ( uint_fast8_t aSendPin )

Initializes the send pin and enable LED feedback with board specific FEEDBACK_LED_ON() and FEEDBACK_LED_OFF() functions.

Parameters

aSendPin The Arduino pin number, where a IR sender diode is connected.

Definition at line 121 of file IRSend.hpp.

◆ begin() [2/2]

void IRsend::begin	(	uint_fast8_t	aSendPin,
		bool	aEnableLEDFeedback,
		uint_fast8_t	aFeedbackLEDPin
	)

Initializes the send and feedback pin.

Parameters

aSendPin	The Arduino pin number, where a IR sender diode is connected.
aEnableLEDFeedback	If true the feedback LED is activated while receiving or sending a PWM signal /a mark
aFeedbackLEDPin	If 0 / USE_DEFAULT_FEEDBACK_LED_PIN, then take board specific FEEDBACK_LED_ON() and FEEDBACK_LED_OFF() functions

Definition at line 138 of file IRSend.hpp.

◆ customDelayMicroseconds()

void IRsend::customDelayMicroseconds ( unsigned long aMicroseconds )

static

Custom delay function that circumvents Arduino's delayMicroseconds 16 bit limit and is (mostly) not extended by the duration of interrupt codes like the millis() interrupt.

Definition at line 1173 of file IRSend.hpp.

◆ enableIROut()

void IRsend::enableIROut ( uint_fast8_t aFrequencyKHz )

Enables IR output.

The kHz value controls the modulation frequency in kilohertz. IF PWM should be generated by a timer, it uses the platform specific timerConfigForSend() function, otherwise it computes the delays used by the mark() function. If IR_SEND_PIN is defined, maximum PWM frequency for an AVR @16 MHz is 170 kHz (180 kHz if NO_LED_FEEDBACK_CODE is defined)

Definition at line 1205 of file IRSend.hpp.

◆ getPulseCorrectionNanos()

uint16_t IRsend::getPulseCorrectionNanos ( )

Definition at line 1258 of file IRSend.hpp.

◆ IRLedOff()

void IRsend::IRLedOff ( )

Just switch the IR sending LED off to send an IR space A space is "no output", so the PWM output is disabled.

This function may affect the state of feedback LED.

Definition at line 1132 of file IRSend.hpp.

◆ mark()

void IRsend::mark ( uint16_t aMarkMicros )

Sends an IR mark for the specified number of microseconds.

The mark output is modulated at the PWM frequency if USE_NO_SEND_PWM is not defined. The output is guaranteed to be OFF / inactive after after the call of the function. This function may affect the state of feedback LED. Period time is 26 us for 38.46 kHz, 27 us for 37.04 kHz, 25 us for 40 kHz. On time is 8 us for 30% duty cycle

The mark() function relies on the correct implementation of: delayMicroseconds() for pulse time, and micros() for pause time. The delayMicroseconds() of pulse time is guarded on AVR CPU's with noInterrupts() / interrupts(). At the start of pause time, interrupts are enabled once, the rest of the pause is also guarded on AVR CPU's with noInterrupts() / interrupts(). The maximum length of an interrupt during sending should not exceed 26 us - 8 us = 18 us, otherwise timing is disturbed. This disturbance is no problem, if the exceedance is small and does not happen too often.

Definition at line 969 of file IRSend.hpp.

◆ sendBiphaseData()

void IRsend::sendBiphaseData	(	uint16_t	aBiphaseTimeUnit,
		uint32_t	aData,
		uint_fast8_t	aNumberOfBits
	)

Sends Biphase data MSB first Always send start bit, do not send the trailing space of the start bit 0 -> mark+space 1 -> space+mark The output always ends with a space can only send 31 bit data, since we put the start bit as 32th bit on front.

Definition at line 909 of file IRSend.hpp.

◆ sendPulseDistanceWidth() [1/3]

void IRsend::sendPulseDistanceWidth	(	PulseDistanceWidthProtocolConstants *	aProtocolConstants,
		IRRawDataType	aData,
		uint_fast8_t	aNumberOfBits,
		int_fast8_t	aNumberOfRepeats
	)

Sends PulseDistance frames and repeats and enables receiver again.

Parameters

aProtocolConstants	The constants to use for sending this protocol.
aData	uint32 or uint64 holding the bits to be sent.
aNumberOfBits	Number of bits from aData to be actually sent.
aNumberOfRepeats	If < 0 and a aProtocolConstants->SpecialSendRepeatFunction() is specified then it is called without leading and trailing space.

Definition at line 702 of file IRSend.hpp.

◆ sendPulseDistanceWidth() [2/3]

void IRsend::sendPulseDistanceWidth	(	uint_fast8_t	aFrequencyKHz,
		uint16_t	aHeaderMarkMicros,
		uint16_t	aHeaderSpaceMicros,
		uint16_t	aOneMarkMicros,
		uint16_t	aOneSpaceMicros,
		uint16_t	aZeroMarkMicros,
		uint16_t	aZeroSpaceMicros,
		IRRawDataType	aData,
		uint_fast8_t	aNumberOfBits,
		bool	aMSBFirst,
		bool	aSendStopBit,
		uint16_t	aRepeatPeriodMillis,
		int_fast8_t	aNumberOfRepeats,
		void(*)()	aSpecialSendRepeatFunction = `NULL`
	)

Sends PulseDistance frames and repeats.

Parameters

aFrequencyKHz,aHeaderMarkMicros,aHeaderSpaceMicros,aOneMarkMicros,aOneSpaceMicros,aZeroMarkMicros,aZeroSpaceMicros,aFlags,aRepeatPeriodMillis	Values to use for sending this protocol, also contained in the PulseDistanceWidthProtocolConstants of this protocol.
aData	uint32 or uint64 holding the bits to be sent.
aNumberOfBits	Number of bits from aData to be actually sent.
aNumberOfRepeats	If < 0 and a aProtocolConstants->SpecialSendRepeatFunction() is specified then it is called without leading and trailing space.
aSpecialSendRepeatFunction	If NULL, the first frame is repeated completely, otherwise this function is used for sending the repeat frame.

Definition at line 768 of file IRSend.hpp.

◆ sendPulseDistanceWidth() [3/3]

void IRsend::sendPulseDistanceWidth	(	uint_fast8_t	aFrequencyKHz,
		uint16_t	aHeaderMarkMicros,
		uint16_t	aHeaderSpaceMicros,
		uint16_t	aOneMarkMicros,
		uint16_t	aOneSpaceMicros,
		uint16_t	aZeroMarkMicros,
		uint16_t	aZeroSpaceMicros,
		IRRawDataType	aData,
		uint_fast8_t	aNumberOfBits,
		uint8_t	aFlags,
		uint16_t	aRepeatPeriodMillis,
		int_fast8_t	aNumberOfRepeats,
		void(*)()	aSpecialSendRepeatFunction = `NULL`
	)

Definition at line 781 of file IRSend.hpp.

◆ sendPulseDistanceWidthData() [1/3]

void IRsend::sendPulseDistanceWidthData	(	PulseDistanceWidthProtocolConstants *	aProtocolConstants,
		IRRawDataType	aData,
		uint_fast8_t	aNumberOfBits
	)

Sends PulseDistance data The output always ends with a space Each additional call costs 16 bytes program memory.

Definition at line 832 of file IRSend.hpp.

◆ sendPulseDistanceWidthData() [2/3]

void IRsend::sendPulseDistanceWidthData	(	uint16_t	aOneMarkMicros,
		uint16_t	aOneSpaceMicros,
		uint16_t	aZeroMarkMicros,
		uint16_t	aZeroSpaceMicros,
		IRRawDataType	aData,
		uint_fast8_t	aNumberOfBits,
		bool	aMSBFirst,
		bool	aSendStopBit
	)

Sends PulseDistance data The output always ends with a space.

Definition at line 844 of file IRSend.hpp.

◆ sendPulseDistanceWidthData() [3/3]

void IRsend::sendPulseDistanceWidthData	(	uint16_t	aOneMarkMicros,
		uint16_t	aOneSpaceMicros,
		uint16_t	aZeroMarkMicros,
		uint16_t	aZeroSpaceMicros,
		IRRawDataType	aData,
		uint_fast8_t	aNumberOfBits,
		uint8_t	aFlags
	)

Definition at line 853 of file IRSend.hpp.

◆ sendPulseDistanceWidthFromArray() [1/4]

void IRsend::sendPulseDistanceWidthFromArray	(	PulseDistanceWidthProtocolConstants *	aProtocolConstants,
		IRRawDataType *	aDecodedRawDataArray,
		uint16_t	aNumberOfBits,
		int_fast8_t	aNumberOfRepeats
	)

Sends PulseDistance data from array using PulseDistanceWidthProtocolConstants For LSB First the LSB of array[0] is sent first then all bits until MSB of array[0].

Next is LSB of array[1] and so on. The output always ends with a space Stop bit is always sent

Definition at line 620 of file IRSend.hpp.

◆ sendPulseDistanceWidthFromArray() [2/4]

void IRsend::sendPulseDistanceWidthFromArray	(	uint_fast8_t	aFrequencyKHz,
		DistanceWidthTimingInfoStruct *	aDistanceWidthTimingInfo,
		IRRawDataType *	aDecodedRawDataArray,
		uint16_t	aNumberOfBits,
		uint8_t	aFlags,
		uint16_t	aRepeatPeriodMillis,
		int_fast8_t	aNumberOfRepeats
	)

Definition at line 539 of file IRSend.hpp.

◆ sendPulseDistanceWidthFromArray() [3/4]

void IRsend::sendPulseDistanceWidthFromArray	(	uint_fast8_t	aFrequencyKHz,
		uint16_t	aHeaderMarkMicros,
		uint16_t	aHeaderSpaceMicros,
		uint16_t	aOneMarkMicros,
		uint16_t	aOneSpaceMicros,
		uint16_t	aZeroMarkMicros,
		uint16_t	aZeroSpaceMicros,
		IRRawDataType *	aDecodedRawDataArray,
		uint16_t	aNumberOfBits,
		bool	aMSBFirst,
		bool	aSendStopBit,
		uint16_t	aRepeatPeriodMillis,
		int_fast8_t	aNumberOfRepeats
	)

Sends PulseDistance data from array For LSB First the LSB of array[0] is sent first then all bits until MSB of array[0].

Next is LSB of array[1] and so on. The output always ends with a space Stop bit is always sent

Definition at line 525 of file IRSend.hpp.

◆ sendPulseDistanceWidthFromArray() [4/4]

void IRsend::sendPulseDistanceWidthFromArray	(	uint_fast8_t	aFrequencyKHz,
		uint16_t	aHeaderMarkMicros,
		uint16_t	aHeaderSpaceMicros,
		uint16_t	aOneMarkMicros,
		uint16_t	aOneSpaceMicros,
		uint16_t	aZeroMarkMicros,
		uint16_t	aZeroSpaceMicros,
		IRRawDataType *	aDecodedRawDataArray,
		uint16_t	aNumberOfBits,
		uint8_t	aFlags,
		uint16_t	aRepeatPeriodMillis,
		int_fast8_t	aNumberOfRepeats
	)

Definition at line 549 of file IRSend.hpp.

◆ sendRaw() [1/2]

void IRsend::sendRaw	(	const uint16_t	aBufferWithMicroseconds[],
		uint_fast16_t	aLengthOfBuffer,
		uint_fast8_t	aIRFrequencyKilohertz
	)

Function using an 16 byte microsecond timing array for every purpose.

Raw data starts with a Mark. No leading space as in received timing data!

Definition at line 414 of file IRSend.hpp.

◆ sendRaw() [2/2]

void IRsend::sendRaw	(	const uint8_t	aBufferWithTicks[],
		uint_fast16_t	aLengthOfBuffer,
		uint_fast8_t	aIRFrequencyKilohertz
	)

Function using an 8 byte tick timing array to save program memory Raw data starts with a Mark.

No leading space as in received timing data!

Definition at line 435 of file IRSend.hpp.

◆ sendRaw_P() [1/2]

void IRsend::sendRaw_P	(	const uint16_t	aBufferWithMicroseconds[],
		uint_fast16_t	aLengthOfBuffer,
		uint_fast8_t	aIRFrequencyKilohertz
	)

Function using an 16 byte microsecond timing array in FLASH for every purpose.

Raw data starts with a Mark. No leading space as in received timing data!

Definition at line 454 of file IRSend.hpp.

◆ sendRaw_P() [2/2]

void IRsend::sendRaw_P	(	const uint8_t	aBufferWithTicks[],
		uint_fast16_t	aLengthOfBuffer,
		uint_fast8_t	aIRFrequencyKilohertz
	)

New function using an 8 byte tick (50 us) timing array in FLASH to save program memory Raw data starts with a Mark.

No leading space as in received timing data!

Definition at line 489 of file IRSend.hpp.

◆ setSendPin()

void IRsend::setSendPin ( uint_fast8_t aSendPin )

Definition at line 128 of file IRSend.hpp.

◆ space()

void IRsend::space ( uint16_t aSpaceMicros )

static

Sends an IR space for the specified number of microseconds.

A space is "no output", so just wait.

Definition at line 1165 of file IRSend.hpp.

◆ write() [1/2]

size_t IRsend::write	(	decode_type_t	aProtocol,
		uint16_t	aAddress,
		uint16_t	aCommand,
		int_fast8_t	aNumberOfRepeats = `NO_REPEATS`
	)

Simple version of write without support for MAGIQUEST and numberOfBits for SONY protocol.

Parameters

aNumberOfRepeats If aNumberOfRepeats < 0 then only a special repeat frame without leading and trailing space will be sent by calling NECProtocolConstants.SpecialSendRepeatFunction().

Definition at line 298 of file IRSend.hpp.

◆ write() [2/2]

size_t IRsend::write	(	IRData *	aIRSendData,
		int_fast8_t	aNumberOfRepeats = `NO_REPEATS`
	)

Interprets and sends a IRData structure.

Parameters

aIRSendData	The values of protocol, address, command and repeat flag are taken for sending.
aNumberOfRepeats	Number of repeats to send after the initial data if data is no repeat.

Returns: 1 if data sent, 0 if no data sent (i.e. for BANG_OLUFSEN, which is currently not supported here) Interprets and sends a IRData structure.

Parameters

aIRSendData	The values of protocol, address, command and repeat flag are taken for sending.
aNumberOfRepeats	Number of repeats to send after the initial data if data is no repeat.

Returns: 1 if data sent, 0 if no data sent (i.e. for BANG_OLUFSEN, which is currently not supported here)

Definition at line 170 of file IRSend.hpp.

Variable Documentation

◆ IrSender

IRsend IrSender

Definition at line 65 of file IRSend.hpp.

Functions

Variables

Detailed Description

Function Documentation

◆ IRsend() [1/2]

◆ IRsend() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ customDelayMicroseconds()

◆ enableIROut()

◆ getPulseCorrectionNanos()

◆ IRLedOff()

◆ mark()

◆ sendBiphaseData()

◆ sendPulseDistanceWidth() [1/3]

◆ sendPulseDistanceWidth() [2/3]

◆ sendPulseDistanceWidth() [3/3]

◆ sendPulseDistanceWidthData() [1/3]

◆ sendPulseDistanceWidthData() [2/3]

◆ sendPulseDistanceWidthData() [3/3]

◆ sendPulseDistanceWidthFromArray() [1/4]

◆ sendPulseDistanceWidthFromArray() [2/4]

◆ sendPulseDistanceWidthFromArray() [3/4]

◆ sendPulseDistanceWidthFromArray() [4/4]

◆ sendRaw() [1/2]

◆ sendRaw() [2/2]

◆ sendRaw_P() [1/2]

◆ sendRaw_P() [2/2]

◆ setSendPin()

◆ space()

◆ write() [1/2]

◆ write() [2/2]

Variable Documentation

◆ IrSender