taigrr/arduinolibs
1
0
Fork 0
mirror of https://github.com/taigrr/arduinolibs synced 2025-01-18 04:33:12 -08:00
Code Issues Projects Releases Wiki Activity

Infrared receiver class

Browse Source
This commit is contained in:
Rhys Weatherley 2012-06-07 14:02:43 +10:00
parent 7d124dfb85
commit 178d8a0e4b
9 changed files with 1026 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/Doxyfile
View File

@ -610,7 +610,7 @@ WARN_LOGFILE =
# directories like "/usr/src/myproject". Separate the files or directories # directories like "/usr/src/myproject". Separate the files or directories
# with spaces. # with spaces.
INPUT = ../libraries/LCD ../libraries/BlinkLED ../libraries/I2C ../libraries/RTC ../libraries/Melody ../libraries/PowerSave ../libraries/DMD . INPUT = ../libraries/LCD ../libraries/BlinkLED ../libraries/I2C ../libraries/RTC ../libraries/Melody ../libraries/PowerSave ../libraries/DMD ../libraries/IR .
# This tag can be used to specify the character encoding of the source files # This tag can be used to specify the character encoding of the source files
# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@ -688,7 +688,7 @@ EXAMPLE_RECURSIVE = NO
# directories that contain image that are included in the documentation (see # directories that contain image that are included in the documentation (see
# the \image command). # the \image command).
IMAGE_PATH = ../libraries/BlinkLED/examples/Cylon ../libraries/BlinkLED/examples/Cylon4 ../libraries/BlinkLED/examples/StarTrek ../libraries/BlinkLED/examples/Charlieplex ../libraries/LCD/examples/HelloWorld ../libraries/LCD/examples/Form ../libraries/RTC/examples/AlarmClock ../libraries/DMD IMAGE_PATH = ../libraries/BlinkLED/examples/Cylon ../libraries/BlinkLED/examples/Cylon4 ../libraries/BlinkLED/examples/StarTrek ../libraries/BlinkLED/examples/Charlieplex ../libraries/LCD/examples/HelloWorld ../libraries/LCD/examples/Form ../libraries/RTC/examples/AlarmClock ../libraries/DMD ../libraries/IR
# The INPUT_FILTER tag can be used to specify a program that doxygen should # The INPUT_FILTER tag can be used to specify a program that doxygen should
# invoke to filter for each input file. Doxygen will invoke the filter program # invoke to filter for each input file. Doxygen will invoke the filter program

38
doc/ir-dumpir.dox Normal file
View File

@ -0,0 +1,38 @@
/*
* Copyright (C) 2012 Southern Storm Software, Pty Ltd.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
/**
\file ir-dumpir.dox
\page ir_dumpir Dumping Infrared Remote Control Codes
This example uses the IRreceiver class to dump commands that are received
from an infrared remote control that is compatible with the
<a href="http://en.wikipedia.org/wiki/RC-5">Philips RC-5 protocol</a>.
Commands are dumped to the serial port. The example needs a 3-pin
infrared receiver connected to D2, GND, and 5V:
\image html irchip.jpg
The full source code for the example follows:
\include IR/examples/DumpIR/DumpIR.pde
*/

6
doc/mainpage.dox
View File

@ -85,6 +85,12 @@ The default implementation simulates the time and date based on the value of
\li \ref alarm_clock "Alarm Clock" example that uses the DS1307 or DS3232 \li \ref alarm_clock "Alarm Clock" example that uses the DS1307 or DS3232
realtime clock and the LCD library to implement an alarm clock. realtime clock and the LCD library to implement an alarm clock.
\section main_IR Infrared Control Library
\li IRreceiver class that receives incoming RC-5 commands from an
infrared remote control.
\li \ref ir_dumpir "DumpIR" example that dumps all incoming RC-5 commands.
\section main_other Other \section main_other Other
\li Melody plays a melody on a digital output pin using <tt>tone()</tt>. \li Melody plays a melody on a digital output pin using <tt>tone()</tt>.

373
libraries/IR/IRreceiver.cpp Normal file
View File

@ -0,0 +1,373 @@
/*
* Copyright (C) 2012 Southern Storm Software, Pty Ltd.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#include "IRreceiver.h"
#if defined(ARDUINO) && ARDUINO >= 100
#include <Arduino.h>
#else
#include <WProgram.h>
#endif
/**
* \class IRreceiver IRreceiver.h <IRreceiver.h>
* \brief Manages the reception of RC-5 commands from an infrared remote control.
*
* IRreceiver recognizes commands in the <a href="http://en.wikipedia.org/wiki/RC-5">Philips RC-5 protocol</a>.
* This is a fairly common infrared protocol, supported by most universal
* remote controls. Program the universal remote to simulate a Philips
* TV, VCR, CD player, etc.
*
* This class uses interrupts to process incoming bits from a standard 3-pin
* infrared receiver:
*
* \image html irchip.jpg
*
* Typically, pin 1 of the receiver should be connected to the Arduino
* interrupt pin (e.g. D2), pin 2 should be connected to GND, and pin 3
* should be connected to 5V. Consult the datasheet for your receiver to
* be sure though; some receivers may have different pin assignments.
*
* The receiver is initialized by constructing an instance of the
* IRreceiver class:
*
* \code
* IRreceiver ir;
* \endcode
*
* By default, interrupt 0 on pin D2 is used. To change to another interrupt,
* pass its number to the constructor:
*
* \code
* IRreceiver ir(1); // Interrupt 1 on pin D3
* \endcode
*
* Currently this class can only handle a single instance of IRreceiver being
* active in the application. It isn't possible to have separate IRreceiver
* instances on different pins. Usually this won't be a problem because
* the same receiver can process inputs from multiple remotes.
*
* The application retrieves incoming infrared commands by calling the
* command() function. The return value indicates the type of command:
*
* \code
* void loop() {
* switch (ir.command()) {
* case RC5_0: case RC5_1: case RC5_2: case RC5_3: case RC5_4:
* case RC5_5: case RC5_6: case RC5_7: case RC5_8: case RC5_9:
* // Process a digit
* ...
* break;
*
* case RC5_ERASE:
* // Backspace/erase last digit.
* ...
* break;
*
* case RC5_STANDBY:
* // Power on/off button.
* ...
* break;
* }
* }
* \endcode
*
* If the command is an auto-repeat of a previous button press, then the
* \ref AUTO_REPEAT flag will be set in the value returned from command().
* The application can choose to ignore all auto-repeats, process all
* auto-repeats, or choose which button to auto-repeat based on its code:
*
* \code
* void loop() {
* switch (ir.command()) {
* case RC5_INC_VOLUME:
* case IRreceiver::AUTO_REPEAT | RC5_INC_VOLUME:
* // Volume increase button pressed or held.
* ...
* break;
*
* case RC5_DEC_VOLUME:
* case IRreceiver::AUTO_REPEAT | RC5_DEC_VOLUME:
* // Volume decrease button pressed or held.
* ...
* break;
*
* case RC5_MUTE:
* // Mute button (ignore auto-repeat).
* ...
* break;
* }
* }
* \endcode
*
* By default, command codes will be generated for every type of RC-5 remote
* control, be it a TV, VCR, CD player, or something else. The application
* can distinguish between the remote controls using system(); noting that
* command() must be called before system() for the system value to be valid.
* For example, the following code could be used in a two-player video game
* where the first player's remote is configured as a TV and the second
* player's remote is configured as a VCR:
*
* \code
* void loop() {
* int cmd = ir.command();
* int sys = ir.system();
* if (sys == RC5_SYS_TV)
* player1(cmd);
* else if (sys == RC5_SYS_VCR)
* player2(cmd);
*
* ...
* }
* \endcode
*
* If the application only cares about a single system and wishes to ignore
* all other systems, it can configure a system filter at startup:
*
* \code
* IRreceiver ir;
*
* void setup() {
* ir.setSystemFilter(RC5_SYS_VCR);
* }
* \endcode
*
* The complete list of RC-5 system numbers and command codes is given in
* the RC5.h header file.
*
* \sa \ref ir_dumpir "DumpIR Example"
*/
static IRreceiver *receiver = 0;
void _IR_receive_interrupt(void)
{
receiver->handleInterrupt();
}
/**
* \var IRreceiver::AUTO_REPEAT
* \brief Flag that is added to the output of command() when the command
* is an auto-repeated button press rather than the original button press.
*/
/**
* \brief Constructs a new infrared remote control receiver that is attached
* to \a interruptNumber.
*/
IRreceiver::IRreceiver(int interruptNumber)
: _system(0)
, _systemFilter(-1)
, started(false)
, halfChange(false)
, lastChange(0)
, bits(0)
, bitCount(0)
, buffer(0)
, lastBuffer(0)
{
switch (interruptNumber) {
case 0: default: pin = 2; break;
case 1: pin = 3; break;
case 2: pin = 21; break; // Arduino Mega only
case 3: pin = 20; break; // Arduino Mega only
case 4: pin = 19; break; // Arduino Mega only
case 5: pin = 18; break; // Arduino Mega only
}
receiver = this;
attachInterrupt(interruptNumber, _IR_receive_interrupt, CHANGE);
}
/**
* \brief Returns the next command from the remote control.
*
* Returns -1 if there is no new command, or the number between 0 and 127
* corresponding to the command. If the command is an auto-repeat button
* press rather than an original button press, then the \ref AUTO_REPEAT
* flag will be set.
*
* The companion function system() will return the system number for the
* command indicating whether the command is for a TV, VCR, CD player, etc.
* By default, all systems are reported; use setSystemFilter() to filter
* out commands from all but a specific system.
*
* The next call to command() will return -1 or the code for the next
* button press.
*
* The header file <tt>RC5.h</tt> contains a list of command codes for
* common remote controls.
*
* \sa system(), setSystemFilter()
*/
int IRreceiver::command()
{
unsigned buf;
// Read the last-delivered sequence from the buffer and clear it.
cli();
buf = buffer;
buffer = 0;
sei();
// Bail out if no sequence or it is not for us.
if (!buf) {
_system = -1;
return -1;
}
if (_systemFilter != -1) {
if (((buf >> 6) & 0x1F) != _systemFilter) {
_system = -1;
return -1;
}
}
// Extract the command.
int cmd = buf & 0x3F;
if ((buf & 0x1000) == 0)
cmd += 64;
// Is this a new command or an auto-repeat of the previous command?
// Bit 11 will toggle whenever a new button press is started.
if (lastBuffer == buf)
cmd += AUTO_REPEAT;
else
lastBuffer = buf;
_system = (buf >> 6) & 0x1F;
return cmd;
}
/**
* \fn int IRreceiver::system() const
* \brief Returns the system number of the previous command(), indicating
* whether the command was for a TV, VCR, CD player, etc.
*
* The return value from this function is valid only after a call to
* command(). The next call to command() will clear the system value,
* possibly to -1 if there is no new command.
*
* The header file <tt>RC5.h</tt> contains a list of system numbers for
* common remote controls.
*
* \sa command(), setSystemFilter()
*/
/**
* \fn int IRreceiver::systemFilter() const
* \brief Returns the system to filter commands against, or -1 if no
* filter is set.
*
* If this value is -1, then all received systems are returned via command()
* and system() irrespective of whether they are for a TV, VCR, CD player,
* or some other type of system. If this value is set to anything other
* than -1, then only commands for that system are returned via command().
*
* \sa setSystemFilter(), system(), command()
*/
/**
* \fn void IRreceiver::setSystemFilter(int system)
* \brief Sets the \a system to filter commands against, or -1 to turn
* off the system filter.
*
* If \a system is -1, then all received systems are returned via command()
* and system() irrespective of whether they are for a TV, VCR, CD player,
* or some other type of system. If \a system is set to anything other
* than -1, then only commands for that system are returned via command().
* For example:
*
* \code
* IRreceiver ir;
* ir.setSystemFilter(RC5_SYS_VCR);
* \endcode
*
* \sa systemFilter(), system(), command()
*/
// Number of microseconds that the signal is HIGH or LOW for
// indicating a bit. A 1 bit is transmitted as LOW for 889us
// followed by HIGH for 889us. A 0 bit is HIGH, then LOW.
#define IR_BIT_TIME 889
// Number of microseconds to detect a long gap in the coding
// corresponding to 2 time units HIGH or LOW. We actually check
// for at least 1.5 time units to allow for slight variations
// in timing on different remote controls.
#define IR_LONG_BIT_TIME (889 * 6 / 4)
// Maximum timeout for a single bit. If we don't see a rising edge
// within this time, then we have lost sync and need to restart.
#define IR_MAX_TIME (IR_BIT_TIME * 4)
// Protocol details from http://en.wikipedia.org/wiki/RC-5
void IRreceiver::handleInterrupt()
{
bool value = digitalRead(pin);
unsigned long currentTime = micros();
if (!value) {
// Rising edge (input is active-LOW)
if (started && (currentTime - lastChange) > IR_MAX_TIME) {
// Too long since the last received bit, so restart the process.
started = false;
}
if (started) {
// We recognize bits on the falling edges, so merely
// adjust the "changed at last half-cycle" flag.
if ((currentTime - lastChange) > IR_LONG_BIT_TIME) {
// Long time since last falling edge indicates that the
// next bit will definitely be a 1.
halfChange = true;
} else {
halfChange = !halfChange;
}
lastChange = currentTime;
} else {
// Encountered the start bit - start receiving up to 14 bits.
lastChange = currentTime;
started = true;
halfChange = true;
bits = 0;
bitCount = 14;
}
} else if (started) {
// Falling edge
if ((currentTime - lastChange) > IR_LONG_BIT_TIME) {
// Long time since last rise indicates 1 followed by 0.
bits = (bits << 2) | 0x02;
--bitCount;
halfChange = true;
} else if (halfChange) {
// Rise was halfway through, so falling edge indicates a 1.
bits = (bits << 1) | 0x01;
halfChange = false;
} else {
// Rise was at the start, so falling edge indicates a 0.
bits <<= 1;
halfChange = true;
}
lastChange = currentTime;
--bitCount;
if (bitCount <= 0) {
// All 14 bits have been received, so deliver the value.
started = false;
buffer = bits;
}
}
}

59
libraries/IR/IRreceiver.h Normal file
View File

@ -0,0 +1,59 @@
/*
* Copyright (C) 2012 Southern Storm Software, Pty Ltd.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#ifndef IRreceiver_h
#define IRreceiver_h
#include <inttypes.h>
#include "RC5.h"
class IRreceiver
{
public:
explicit IRreceiver(int interruptNumber = 0);
static const int AUTO_REPEAT = 128;
int command();
int system() const { return _system; }
int systemFilter() const { return _systemFilter; }
void setSystemFilter(int system) { _systemFilter = system; }
private:
int _system;
int _systemFilter;
uint8_t pin;
bool started;
bool halfChange; // Value last changed half-way through bit cycle time.
unsigned long lastChange;
unsigned bits;
int8_t bitCount;
volatile unsigned buffer;
unsigned lastBuffer;
void handleInterrupt();
friend void _IR_receive_interrupt(void);
};
#endif

344
libraries/IR/RC5.h Normal file
View File

@ -0,0 +1,344 @@
/*
* Copyright (C) 2012 Southern Storm Software, Pty Ltd.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#ifndef RC5_h
#define RC5_h
// http://en.wikipedia.org/wiki/RC-5#System_Number_Allocations
#define RC5_SYS_TV 0 // TV receiver 1
#define RC5_SYS_TV2 1 // TV receiver 2
#define RC5_SYS_TXT 2 // Teletext
#define RC5_SYS_TV_EXT 3 // Extension to TV 1 & 2
#define RC5_SYS_LV 4 // Laservision player
#define RC5_SYS_VCR 5 // VCR 1
#define RC5_SYS_VCR2 6 // VCR 2
#define RC5_SYS_SAT 8 // Satellite receiver 1
#define RC5_SYS_VCR_EXT 9 // Extension to VCR 1 & 2
#define RC5_SYS_SAT2 10 // Satellite receiver 2
#define RC5_SYS_CD_VIDEO 12 // CD video player
#define RC5_SYS_CD_PHOTO 14 // CD photo player
#define RC5_SYS_PREAMP 16 // Audio preamplifier 1
#define RC5_SYS_RADIO 17 // Radio tuner
#define RC5_SYS_REC 18 // Casette recorder 1
#define RC5_SYS_PREAMP2 19 // Audio preamplifier 2
#define RC5_SYS_CD 20 // CD player
#define RC5_SYS_COMBI 21 // Audio stack or record player
#define RC5_SYS_AUDIO_SAT 22 // Audio satellite
#define RC5_SYS_REC2 23 // Casette recorder 2
#define RC5_SYS_CD_R 26 // CD recorder
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 2, Common commands:
#define RC5_0 0 // Digit 0
#define RC5_1 1 // Digit 1
#define RC5_2 2 // Digit 2
#define RC5_3 3 // Digit 3
#define RC5_4 4 // Digit 4
#define RC5_5 5 // Digit 5
#define RC5_6 6 // Digit 6
#define RC5_7 7 // Digit 7
#define RC5_8 8 // Digit 8
#define RC5_9 9 // Digit 9
#define RC5_INC_VOLUME 16 // Increase sound volume
#define RC5_DEC_VOLUME 17 // Decrease sound volume
#define RC5_INC_BRIGHTNESS 18 // Increase display brightness
#define RC5_DEC_BRIGHTNESS 19 // Decrease display brightness
#define RC5_INC_BASS 22 // Increase bass response
#define RC5_DEC_BASS 23 // Decrease bass response
#define RC5_INC_TREBLE 24 // Increase treble response
#define RC5_DEC_TREBLE 25 // Decrease treble response
#define RC5_BALANCE_LEFT 26 // Shift sound balance to left
#define RC5_BALANCE_RIGHT 27 // Shift sound balance to right
#define RC5_TRANSMIT_MODE 63 // Select remote transmit mode
#define RC5_DIM 71 // Dim local display
#define RC5_INC_LINEAR 77 // Increase linear control
#define RC5_DEC_LINEAR 78 // Decrease linear control
#define RC5_UP 80 // Move cursor up
#define RC5_DOWN 81 // Move cursor down
#define RC5_MENU_ON 82 // Switch display/screen menu on
#define RC5_MENU_OFF 83 // Switch display/screen menu off
#define RC5_AV_STATUS 84 // Display A/V system status
#define RC5_LEFT 85 // Move cursor left
#define RC5_RIGHT 86 // Move cursor right
#define RC5_OK 87 // Acknowledge function at cursor
#define RC5_SUBMODE 118 // Select sub-mode
#define RC5_OPTIONS 119 // Select options sub-mode
#define RC5_CONNECT_EURO 123 // Connect items via Euroconnector
#define RC5_DISCONNECT_EURO 124 // Disconnect items via Euroconnector
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 3, Common video system commands:
#define RC5_INC_SATURATION 20 // Increase color saturation
#define RC5_DEC_SATURATION 21 // Decrease color saturation
#define RC5_PIP 88 // Picture-in-picture on/off
#define RC5_PIP_SHIFT 89 // Picture-in-picture shift
#define RC5_PIP_SWAP 90 // Picture-in-picture swap
#define RC5_PIP_STROBE 91 // Strobe main picture on/off
#define RC5_PIP_MULTI_STROBE 92 // Multi-strobe
#define RC5_PIP_FREEZE_MAIN 93 // Main picture frame frozen
#define RC5_PIP_MULTI_SCAN 94 // 3/9 multi-scan
#define RC5_PIP_SOURCE 95 // Select picture-in-picture source
#define RC5_PIP_MOSAIC 96 // Mosaic/multi-PIP
#define RC5_PIP_NOISE 97 // Digital noise reduction of picture
#define RC5_PIP_STORE 98 // Store main picture
#define RC5_PIP_PHOTO_FINISH 99 // PIP strobe; display photo-finish
#define RC5_PIP_RECALL 100 // Recall main stored picture
#define RC5_PIP_FREEZE 101 // Freeze PIP
#define RC5_PIP_UP 102 // Step up PIP options/source
#define RC5_PIP_DOWN 103 // Step down PIP options/source
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 4a, TV and VCR commands:
#define RC5_123 10 // 1/2/3 digit entry
#define RC5_11 11 // Channel/program/frequency 11
#define RC5_STANDBY 12 // Standby
#define RC5_MUTE 13 // Master mute/de-mute
#define RC5_PREFERENCES 14 // Personal preference settings
#define RC5_DISPLAY_INFO 15 // Display user info on screen
#define RC5_INC_CONTRAST 28 // Increase picture contrast
#define RC5_DEC_CONTRAST 29 // Decrease picture contrast
#define RC5_SEARCH_UP 30 // Search up
#define RC5_DEC_TINT 31 // Decrease tint/hue
#define RC5_CHANNEL_UP 32 // Channel/program up
#define RC5_CHANNEL_DOWN 33 // Channel/program down
#define RC5_CHANNEL_LAST 34 // Last viewed channel/program
#define RC5_STEREO_SELECT 35 // Select stereo channel/language
#define RC5_STEREO_SPATIAL 36 // Spatial stereo
#define RC5_STEREO_TOGGLE 37 // Toggle stereo/mono
#define RC5_SLEEP_TIMER 38 // Sleep timer
#define RC5_INC_TINT 39 // Increase tint/hue
#define RC5_SWITCH_RF 40 // Switch RF inputs
#define RC5_STORE 41 // Store/vote
#define RC5_TIME 42 // Display time
#define RC5_INC_SCAN 43 // Scan forward/increment
#define RC5_DEC_SCAN 44 // Scan backward/decrement
#define RC5_SECONDARY_MENU 46 // Secondary menu
#define RC5_CLOCK 47 // Show clock
#define RC5_PAUSE 48 // Pause
#define RC5_ERASE 49 // Erase/correct entry
#define RC5_REWIND 50 // Rewind
#define RC5_GOTO 51 // Go to
#define RC5_WIND 52 // Wind (fast forward)
#define RC5_PLAY 53 // Play
#define RC5_STOP 54 // Stop
#define RC5_RECORD 55 // Record
#define RC5_EXTERNAL1 56 // External 1
#define RC5_EXTERNAL2 57 // External 2
#define RC5_VIEW_DATA 59 // View data, advance
#define RC5_12 60 // Channel 12 (or TXT/TV toggle)
#define RC5_SYSTEM_STANDBY 61 // System standby
#define RC5_CRISP 62 // Picture crispener (coutour boost)
#define RC5_AUDIO_RESPONSE 70 // Audio response for speech/music
#define RC5_SOUND_FUNCTIONS 79 // Select sound functions in sequence
#define RC5_PIP_SIZE 104 // Alter PIP size step-by-step
#define RC5_VISION_FUNCTIONS 105 // Select vision functions in sequence
#define RC5_COLOR_KEY 106 // Colored or other special key
#define RC5_RED 107 // Red button
#define RC5_GREEN 108 // Green button
#define RC5_YELLOW 109 // Yellow button
#define RC5_CYAN 110 // Cyan button
#define RC5_INDEX 111 // Index page/white function
#define RC5_NEXT_OPTION 112 // Next option
#define RC5_PREVIOUS_OPTION 113 // Previous option
#define RC5_STORE_OPEN_CLOSE 122 // Store open/close
#define RC5_PARENTAL_ACCESS 123 // Parental access via PIN code
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 4b, TV1 and TV2 extension
#define RC5_DEFAULT_VIDEO 10 // Default video settings (TV1)
#define RC5_DEFAULT_AUDIO 11 // Default audio settings (TV1)
#define RC5_PAYTV_CHANNEL_UP 28 // Pay TV channel up (TV1)
#define RC5_PAYTV_CHANNEL_DOWN 29 // Pay TV channel down (TV1)
#define RC5_RADIO_CHANNEL_UP 30 // Radio channel up (TV1)
#define RC5_RADIO_CHANNEL_DOWN 31 // Radio channel down (TV1)
#define RC5_TILT_FORWARD 32 // Tilt cabinet forward (TV1)
#define RC5_TILT_BACKWARD 33 // Tilt cabinet backward (TV1)
#define RC5_EXTERNAL3 56 // External 3 (TV1)
#define RC5_EXTERNAL4 56 // External 4 (TV1)
#define RC5_PICTURE_FORMAT 62 // 4:3 vs 16:9 (TV1)
#define RC5_CHANNEL_10 67 // Channel 10
#define RC5_CHANNEL_11 68 // Channel 11
#define RC5_CHANNEL_12 69 // Channel 12
#define RC5_DEFAULT_VIDEO2 72 // Default video settings (TV2)
#define RC5_DEFAULT_AUDIO2 73 // Default audio settings (TV2)
#define RC5_PAYTV_CHANNEL_UP2 88 // Pay TV channel up (TV2)
#define RC5_PAYTV_CHANNEL_DOWN2 89 // Pay TV channel down (TV2)
#define RC5_RADIO_CHANNEL_UP2 90 // Radio channel up (TV2)
#define RC5_RADIO_CHANNEL_DOWN2 91 // Radio channel down (TV2)
#define RC5_TILT_FORWARD2 104 // Tilt cabinet forward (TV2)
#define RC5_TILT_BACKWARD2 105 // Tilt cabinet backward (TV2)
#define RC5_EXTERNAL3_2 120 // External 3 (TV2)
#define RC5_EXTERNAL4_2 121 // External 4 (TV2)
#define RC5_CHANNEL_MENU 122 // Channel setting menu
#define RC5_PICTURE_FORMAT2 126 // 4:3 vs 16:9 (TV2)
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 5, Teletext commands
#define RC5_NEXT_PAGE 10 // Next page
#define RC5_PREVIOUS_PAGE 11 // Previous page
// RC5_STANDBY 12 // Standby
#define RC5_ENTER_PAGE_NUMBER 28 // Enter page number in memory
#define RC5_SEQ_DISPLAY 29 // Sequential display of pages
#define RC5_SEQ_DELETE 30 // Sequential display/deletion of pages
#define RC5_EXCHANGE 32 // Exchange (Antiope function)
#define RC5_MAIN_INDEX 33 // Main index
#define RC5_ROW_ZERO 34 // Row zero (Antiope function)
#define RC5_PRINT 38 // Print displayed page
#define RC5_MIX 39 // Mix Antiope/TV pictures
#define RC5_HOLD_PAGE 41 // Page hold
// RC5_TIME 42 // Display time
#define RC5_LARGE 43 // Large top/bottom/normal
#define RC5_REVEAL 44 // Reveal/conceal
#define RC5_TV_TXT 45 // TV/TXT
#define RC5_TV_TXT_SUBTITLE 46 // TV + TXT/subtitle
// RC5_ERASE 49 // Erase/correct entry
#define RC5_NEWS_FLASH 62 // News flash (Antiope function)
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 6, LaserVision commands
#define RC5_PICTURE_NUMBER 10 // Display picture number/time
#define RC5_CHAPTER_NUMBER 11 // Display chapter number
// RC5_STANDBY 12 // Standby
// RC5_MUTE 13 // Master mute/de-mute
// RC5_DISPLAY_INFO 15 // Display user info on screen
#define RC5_SHUFFLE 28 // Total shuffle play/repeat once
#define RC5_REPEAT 29 // Repeat continuously
#define RC5_SELECT_NEXT 30 // Select next option
#define RC5_FAST_REVERSE 31 // Fast run reverse
#define RC5_ENTRY 32 // Entry (prepare to program)
#define RC5_AUTO_STOP 33 // Auto-stop at pre-programmed point
#define RC5_SLOW_REVERSE 34 // Slow run reverse
#define RC5_STEREO_CHANNEL1 35 // Select stereo sound channel 1/language 1
#define RC5_STEREO_CHANNEL2 36 // Select stereo sound channel 2/language 2
#define RC5_DEC_STILL 37 // Still increment reverse
#define RC5_INC_SPEED 38 // Increase speed
#define RC5_DEC_SPEED 39 // Decrease speed
#define RC5_SLOW_FORWARD 40 // Slow run forward
#define RC5_INC_STILL 41 // Still increment forward
#define RC5_FAST_FORWARD 42 // Fast run forward
#define RC5_SEARCH_USER_CHOICE 43 // Automatic search for user choice
#define RC5_SEARCH_REVERSE 44 // Search in reverse
#define RC5_TRAY 45 // Open/close tray
#define RC5_SEARCH_FORWARD 46 // Search forward
#define RC5_PLAY_REVERSE 47 // Play reverse/play opposite sound track
// RC5_PAUSE 48 // Pause
// RC5_ERASE 49 // Erase/correct entry
// RC5_PLAY 53 // Play
// RC5_STOP 54 // Stop
#define RC5_CLEAR_MEMORY 58 // Clear memory all
#define RC5_FREEZE_SEGMENT 59 // Freeze segment(s) indicated by picture numbers.
#define RC5_TV_TXT_ALT 60 // TV/TXT toggle; RF switch (USA only)
#define RC5_CX 62 // CX 1, 2, 3; toggle for CX noise reduction
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 11, Preamplifier commands
#define RC5_GEQ_L 10 // Graphic equalizer left
#define RC5_GEQ_R 11 // Graphic equalizer right
// RC5_STANDBY 12 // Standby
// RC5_MUTE 13 // Master mute/de-mute
// RC5_PREFERENCES 14 // Personal preference settings
// RC5_DISPLAY_INFO 15 // Display user info on screen
#define RC5_GEQ_L_AND_R 28 // Graphic equalizer left and right
#define RC5_SPEAKER_SELECT 29 // Speaker select
#define RC5_SCRATCH_FILTER 30 // Scratch filter on/off
#define RC5_RUMBLE_FILTER 31 // Rumble filter on/off
#define RC5_INC_STEP 32 // Step function +
#define RC5_DEC_STEP 33 // Step function -
#define RC5_SIGNAL_PATH 34 // Signal path options
#define RC5_SPEAKER_A 35 // Speaker A on/off
#define RC5_SURROUND_OPTIONS 37 // Surround sound options
// RC5_SLEEP_TIMER 38 // Sleep timer
#define RC5_SPEAKER_B 39 // Speaker B on/off
#define RC5_SPEAKER_C 40 // Speaker C on/off
#define RC5_TIMER_PROGRAM 41 // Timer program mode
// RC5_TIME 42 // Display time
#define RC5_INC_TIMER 43 // Timer +
#define RC5_DEC_TIMER 44 // Timer -
#define RC5_TIMER_MEMORY 45 // Open timer memory
#define RC5_ACOUSTIC_CONTROL 46 // Open acoustic control setting memory
#define RC5_ACOUSTIC_SELECT 47 // Select acoustic settings in memory
// RC5_ERASE 49 // Erase/correct entry
// RC5_CLEAR_MEMORY 58 // Clear memory all
#define RC5_DYNAMIC_EXPAND 60 // Dynamic range expand
#define RC5_DYNAMIC_COMPRESS 62 // Dynamic range compress
#define RC5_SURROUND_SOUND 64 // Surround sound on/off
#define RC5_BALANCE_FRONT 65 // Balance front
#define RC5_BALANCE_REAR 66 // Balance rear
#define RC5_LINEAR_SOUND 79 // Scroll linear sound functions
#define RC5_RANDOM_NOISE 88 // Random noise generator on/off
#define RC5_TIMER 89 // Timer on/off
#define RC5_NEWS_TIMER 90 // News timer on/off
#define RC5_INC_CENTER_VOLUME 102 // Increase center channel volume
#define RC5_DEC_CENTER_VOLUME 103 // Decrease center channel volume
#define RC5_INC_DELAY_SURROUND 104 // Increase delay front to surround
#define RC5_DEC_DELAY_SURROUND 105 // Decrease delay front to surround
#define RC5_LINEAR_PHASE 106 // Linear phase
#define RC5_TAPE_MONITOR 122 // Tape monitor
// http://en.wikipedia.org/wiki/RC-5#Command_Tables
// Table 14, Compact disc player commands
#define RC5_LOCAL_CURSOR 10 // Scroll local display cursor
#define RC5_LOCAL_FUNCTION 11 // Scroll local display function
// RC5_STANDBY 12 // Standby
// RC5_MUTE 13 // Master mute/de-mute
// RC5_DISPLAY_INFO 15 // Display user info on screen
// RC5_SHUFFLE 28 // Total shuffle play/repeat once
// RC5_REPEAT 29 // Repeat continuously
#define RC5_INC_SELECT 30 // Select increment
#define RC5_DEC_SELECT 31 // Select decrement
#define RC5_NEXT 32 // Next
#define RC5_PREVIOUS 33 // Previous
#define RC5_INDEX_NEXT 34 // Index next
#define RC5_INDEX_PREVIOUS 35 // Index previous
#define RC5_PLAY_PROGRAM 36 // Play/program
#define RC5_NOMINAL_SPEED 37 // Speed nominal
// RC5_INC_SPEED 38 // Increase speed
// RC5_DEC_SPEED 39 // Decrease speed
// RC5_STORE 41 // Store/vote
// RC5_INC_SCAN 43 // Scan forward/increment
// RC5_TRAY 45 // Open/close tray
#define RC5_CARTRIDGE 47 // Fast/select disc from catridge
// RC5_PAUSE 48 // Pause
// RC5_ERASE 49 // Erase/correct entry
// RC5_REWIND 50 // Rewind
// RC5_GOTO 51 // Go to
// RC5_WIND 52 // Wind (fast forward)
// RC5_PLAY 53 // Play
// RC5_STOP 54 // Stop
// RC5_CLEAR_MEMORY 58 // Clear memory all
#define RC5_REPEAT_AB 59 // Repeat program marked A/B
// RC5_DYNAMIC_EXPAND 60 // Dynamic range expand
// RC5_DYNAMIC_COMPRESS 62 // Dynamic range compress
#define RC5_DSP 91 // Digital signal processing on/off
#define RC5_DSP_MUSIC 92 // Music mode (DSP)
#define RC5_DSP_ACOUSTICS 93 // Select room acoustics (DSP)
#define RC5_DSP_JAZZ 94 // Jazz/s-hall effect (DSP)
#define RC5_DSP_POP 95 // Pop/s-hall effect (DSP)
#define RC5_DSP_CLASSIC 96 // Classic/church music for music/room mode (DSP)
#define RC5_DSP_EASY 97 // Easy/club music for music/room mode (DSP)
#define RC5_DSP_DISCO 98 // Disco/stadium music for music/room mode (DSP)
#define RC5_SECOND_FAVORITE 107 // Second favorite track selection
#define RC5_FAVORITE 108 // Favorite track selection
#define RC5_TITLE_INTO_MEMORY 109 // Title into memory
#define RC5_FADE 120 // Fade in/out audio
#endif

196
libraries/IR/examples/DumpIR/DumpIR.pde Normal file
View File

@ -0,0 +1,196 @@
/* This example is placed into the public domain */
#include <IRreceiver.h>
IRreceiver ir;
static const char *systems[32] = {
"TV",
"TV2",
"TXT",
"TV_EXT",
"LV",
"VCR",
"VCR2",
"Sys7",
"SAT",
"VCR_EXT",
"SAT2",
"Sys11",
"CD_VIDEO",
"Sys13",
"CD_PHOTO",
"Sys15",
"PREAMP",
"RADIO",
"REC",
"PREAMP2",
"CD",
"COMBI",
"AUDIO_SAT",
"REC2",
"Sys24",
"Sys25",
"CD_R",
"Sys27",
"Sys28",
"Sys29",
"Sys30",
"Sys31"
};
// Selection of TV, VCR, and CD commands to assist with command identification.
// May not be correct for all system types.
static const char *commands[128] = {
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"123",
"11",
"STANDBY",
"MUTE",
"PREFERENCES",
"DISPLAY_INFO",
"INC_VOLUME",
"DEC_VOLUME",
"INC_BRIGHTNESS",
"DEC_BRIGHTNESS",
"INC_SATURATION",
"DEC_SATURATION",
"INC_BASS",
"DEC_BASS",
"INC_TREBLE",
"DEC_TREBLE",
"BALANCE_LEFT",
"BALANCE_RIGHT",
"INC_CONTRAST",
"DEC_CONTRAST",
"SEARCH_UP",
"DEC_TINT",
"CHANNEL_UP",
"CHANNEL_DOWN",
"CHANNEL_LAST",
"STEREO_SELECT",
"STEREO_SPATIAL",
"STEREO_TOGGLE",
"SLEEP_TIMER",
"INC_TINT",
"SWITCH_RF",
"STORE",
"TIME",
"INC_SCAN",
"DEC_SCAN",
"TRAY",
"SECONDARY_MENU",
"CLOCK",
"PAUSE",
"ERASE",
"REWIND",
"GOTO",
"WIND",
"PLAY",
"STOP",
"RECORD",
"EXTERNAL_1",
"EXTERNAL_2",
"CLEAR_MEMORY",
"VIEW_DATA",
"12",
"SYSTEM_STANDBY",
"CRISP",
"TRANSMIT_MODE",
"Cmd64",
"Cmd65",
"Cmd66",
"Cmd67",
"Cmd68",
"Cmd69",
"AUDIO_RESPONSE",
"DIM",
"Cmd72",
"Cmd73",
"Cmd74",
"Cmd75",
"Cmd76",
"INC_LINEAR",
"DEC_LINEAR",
"SOUND_FUNCTIONS",
"UP",
"DOWN",
"MENU_ON",
"MENU_OFF",
"AV_STATUS",
"LEFT",
"RIGHT",
"OK",
"PIP",
"PIP_SHIFT",
"PIP_SWAP",
"PIP_STROBE",
"PIP_MULTI_STROBE",
"PIP_FREEZE_MAIN",
"PIP_MULTI_SCAN",
"PIP_SOURCE",
"PIP_MOSAIC",
"PIP_NOISE",
"PIP_STORE",
"PIP_PHOTO_FINISH",
"PIP_RECALL",
"PIP_FREEZE",
"PIP_UP",
"PIP_DOWN",
"PIP_SIZE",
"VERSION_FUNCTIONS",
"COLOR_KEY",
"RED",
"GREEN",
"YELLOW",
"CYAN",
"INDEX",
"NEXT_OPTION",
"PREVIOUS_OPTION",
"Cmd114",
"Cmd115",
"Cmd116",
"Cmd117",
"SUBMODE",
"OPTIONS",
"FADE",
"Cmd121",
"STORE_OPEN_CLOSE",
"CONNECT_EURO",
"DISCONNECT_EURO",
"Cmd125",
"Cmd126",
"Cmd127"
};
void setup() {
Serial.begin(9600);
}
void loop() {
int cmd = ir.command();
if (cmd >= 0) {
Serial.print("IR system=");
Serial.print(ir.system());
Serial.print(" (RC5_SYS_");
Serial.print(systems[ir.system()]);
Serial.print("), command=");
Serial.print(cmd & 0x7F);
Serial.print(" (RC5_");
Serial.print(commands[cmd & 0x7F]);
Serial.print(")");
if (cmd & IRreceiver::AUTO_REPEAT)
Serial.println(", auto-repeat");
else
Serial.println();
}
}

BIN
libraries/IR/irchip.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 6.0 KiB

8
libraries/IR/keywords.txt Normal file
View File

@ -0,0 +1,8 @@
IRreceiver KEYWORD1
command KEYWORD2
system KEYWORD2
systemFilter KEYWORD2
setSystemFilter KEYWORD2
AUTO_REPEAT LITERAL1