191 lines
8.4 KiB
C++
191 lines
8.4 KiB
C++
/*
|
|
* TinyReceiver.cpp
|
|
*
|
|
* Small memory footprint and no timer usage!
|
|
*
|
|
* Receives IR protocol data of NEC protocol using pin change interrupts.
|
|
* On complete received IR command the function handleReceivedIRData(uint16_t aAddress, uint8_t aCommand, uint8_t aFlags)
|
|
* is called in Interrupt context but with interrupts being enabled to enable use of delay() etc.
|
|
* !!!!!!!!!!!!!!!!!!!!!!
|
|
* Functions called in interrupt context should be running as short as possible,
|
|
* so if you require longer action, save the data (address + command) and handle it in the main loop.
|
|
* !!!!!!!!!!!!!!!!!!!!!
|
|
*
|
|
* The FAST protocol is a proprietary modified JVC protocol without address, with parity and with a shorter header.
|
|
* FAST Protocol characteristics:
|
|
* - Bit timing is like NEC or JVC
|
|
* - The header is shorter, 3156 vs. 12500
|
|
* - No address and 16 bit data, interpreted as 8 bit command and 8 bit inverted command,
|
|
* leading to a fixed protocol length of (6 + (16 * 3) + 1) * 526 = 55 * 526 = 28930 microseconds or 29 ms.
|
|
* - Repeats are sent as complete frames but in a 50 ms period / with a 21 ms distance.
|
|
*
|
|
*
|
|
* This file is part of IRMP https://github.com/IRMP-org/IRMP.
|
|
* This file is part of Arduino-IRremote https://github.com/Arduino-IRremote/Arduino-IRremote.
|
|
*
|
|
************************************************************************************
|
|
* MIT License
|
|
*
|
|
* Copyright (c) 2022-2023 Armin Joachimsmeyer
|
|
*
|
|
* 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 <Arduino.h>
|
|
|
|
/*
|
|
* Set sensible receive pin for different CPU's
|
|
*/
|
|
#if defined(__AVR_ATtiny25__) || defined(__AVR_ATtiny45__) || defined(__AVR_ATtiny85__) || defined(__AVR_ATtiny87__) || defined(__AVR_ATtiny167__)
|
|
/*
|
|
* This program runs on 1 MHz CPU clock :-) and is requires only 1550 bytes program memory using ATTiny core
|
|
*/
|
|
#include "ATtinySerialOut.hpp" // TX is at pin 2 - Available as Arduino library "ATtinySerialOut" - Saves up to 700 bytes program memory and 70 bytes RAM for ATtinyCore
|
|
# if defined(ARDUINO_AVR_DIGISPARKPRO)
|
|
#define IR_RECEIVE_PIN 9 // PA3 - on Digispark board labeled as pin 9
|
|
# else
|
|
#define IR_RECEIVE_PIN 0 // PCINT0
|
|
# endif
|
|
#elif defined(__AVR_ATtiny1616__) || defined(__AVR_ATtiny3216__) || defined(__AVR_ATtiny3217__)
|
|
#define IR_RECEIVE_PIN 10
|
|
#elif (defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__))
|
|
#define IR_RECEIVE_PIN 21 // INT0
|
|
#elif defined(ESP8266)
|
|
#define IR_RECEIVE_PIN 14 // D5
|
|
#elif defined(CONFIG_IDF_TARGET_ESP32C3)
|
|
#define IR_RECEIVE_PIN 8
|
|
#elif defined(ESP32)
|
|
#define IR_RECEIVE_PIN 15
|
|
#elif defined(ARDUINO_ARCH_MBED) && defined(ARDUINO_ARCH_MBED_NANO)
|
|
#define IR_RECEIVE_PIN 3 // GPIO15 Use pin 3 since pin 2|GPIO25 is connected to LED on Pi pico
|
|
#elif defined(ARDUINO_ARCH_RP2040) // Pi Pico with arduino-pico core https://github.com/earlephilhower/arduino-pico
|
|
#define IR_RECEIVE_PIN 15 // to be compatible with the Arduino Nano RP2040 Connect (pin3)
|
|
#else
|
|
#define IR_RECEIVE_PIN 2 // INT0
|
|
//#define NO_LED_FEEDBACK_CODE // Activate this if you want to suppress LED feedback or if you do not have a LED. This saves 14 bytes code and 2 clock cycles per interrupt.
|
|
#endif
|
|
|
|
//#define DEBUG // to see if attachInterrupt is used
|
|
//#define TRACE // to see the state of the ISR state machine
|
|
|
|
/*
|
|
* Second: include the code and compile it.
|
|
*/
|
|
//#define DISABLE_PARITY_CHECKS // Disable parity checks. Saves 48 bytes of program memory.
|
|
//#define USE_ONKYO_PROTOCOL // Like NEC, but take the 16 bit address and command each as one 16 bit value and not as 8 bit normal and 8 bit inverted value.
|
|
//#define USE_FAST_PROTOCOL // Use FAST protocol (no address and 16 bit data, interpreted as 8 bit command and 8 bit inverted command) instead of NEC.
|
|
//#define ENABLE_NEC2_REPEATS // Instead of sending / receiving the NEC special repeat code, send / receive the original frame for repeat.
|
|
#include "TinyIRReceiver.hpp"
|
|
|
|
/*
|
|
* Helper macro for getting a macro definition as string
|
|
*/
|
|
#if !defined(STR_HELPER)
|
|
#define STR_HELPER(x) #x
|
|
#define STR(x) STR_HELPER(x)
|
|
#endif
|
|
|
|
volatile struct TinyIRReceiverCallbackDataStruct sCallbackData;
|
|
|
|
void setup() {
|
|
Serial.begin(115200);
|
|
#if defined(__AVR_ATmega32U4__) || defined(SERIAL_PORT_USBVIRTUAL) || defined(SERIAL_USB) /*stm32duino*/|| defined(USBCON) /*STM32_stm32*/|| defined(SERIALUSB_PID) || defined(ARDUINO_attiny3217)
|
|
delay(4000); // To be able to connect Serial monitor after reset or power up and before first print out. Do not wait for an attached Serial Monitor!
|
|
#endif
|
|
// Just to know which program is running on my Arduino
|
|
#if defined(ESP8266) || defined(ESP32)
|
|
Serial.println();
|
|
#endif
|
|
Serial.println(F("START " __FILE__ " from " __DATE__ "\r\nUsing library version " VERSION_TINYIR));
|
|
|
|
// Enables the interrupt generation on change of IR input signal
|
|
if (!initPCIInterruptForTinyReceiver()) {
|
|
Serial.println(F("No interrupt available for pin " STR(IR_RECEIVE_PIN))); // optimized out by the compiler, if not required :-)
|
|
}
|
|
#if defined(USE_FAST_PROTOCOL)
|
|
Serial.println(F("Ready to receive Fast IR signals at pin " STR(IR_RECEIVE_PIN)));
|
|
#else
|
|
Serial.println(F("Ready to receive NEC IR signals at pin " STR(IR_RECEIVE_PIN)));
|
|
#endif
|
|
}
|
|
|
|
void loop() {
|
|
if (sCallbackData.justWritten) {
|
|
sCallbackData.justWritten = false;
|
|
#if defined(USE_FAST_PROTOCOL)
|
|
Serial.print(F("Command=0x"));
|
|
#else
|
|
Serial.print(F("Address=0x"));
|
|
Serial.print(sCallbackData.Address, HEX);
|
|
Serial.print(F(" Command=0x"));
|
|
#endif
|
|
Serial.print(sCallbackData.Command, HEX);
|
|
if (sCallbackData.Flags == IRDATA_FLAGS_IS_REPEAT) {
|
|
Serial.print(F(" Repeat"));
|
|
}
|
|
if (sCallbackData.Flags == IRDATA_FLAGS_PARITY_FAILED) {
|
|
Serial.print(F(" Parity failed"));
|
|
}
|
|
Serial.println();
|
|
}
|
|
/*
|
|
* Put your code here
|
|
*/
|
|
}
|
|
|
|
/*
|
|
* This is the function is called if a complete command was received
|
|
* It runs in an ISR context with interrupts enabled, so functions like delay() etc. should work here
|
|
*/
|
|
#if defined(ESP8266) || defined(ESP32)
|
|
IRAM_ATTR
|
|
#endif
|
|
|
|
#if defined(USE_FAST_PROTOCOL)
|
|
void handleReceivedTinyIRData(uint8_t aCommand, uint8_t aFlags)
|
|
#elif defined(USE_ONKYO_PROTOCOL)
|
|
void handleReceivedTinyIRData(uint16_t aAddress, uint16_t aCommand, uint8_t aFlags)
|
|
#else
|
|
void handleReceivedTinyIRData(uint8_t aAddress, uint8_t aCommand, uint8_t aFlags)
|
|
#endif
|
|
{
|
|
#if defined(ARDUINO_ARCH_MBED) || defined(ESP32)
|
|
// Copy data for main loop, this is the recommended way for handling a callback :-)
|
|
# if !defined(USE_FAST_PROTOCOL)
|
|
sCallbackData.Address = aAddress;
|
|
# endif
|
|
sCallbackData.Command = aCommand;
|
|
sCallbackData.Flags = aFlags;
|
|
sCallbackData.justWritten = true;
|
|
#else
|
|
/*
|
|
* Printing is not allowed in ISR context for any kind of RTOS
|
|
* For Mbed we get a kernel panic and "Error Message: Semaphore: 0x0, Not allowed in ISR context" for Serial.print()
|
|
* for ESP32 we get a "Guru Meditation Error: Core 1 panic'ed" (we also have an RTOS running!)
|
|
*/
|
|
// Print only very short output, since we are in an interrupt context and do not want to miss the next interrupts of the repeats coming soon
|
|
# if defined(USE_FAST_PROTOCOL)
|
|
printTinyReceiverResultMinimal(&Serial, aCommand, aFlags);
|
|
# else
|
|
printTinyReceiverResultMinimal(&Serial, aAddress, aCommand, aFlags);
|
|
# endif
|
|
#endif
|
|
}
|