Tasmota/lib/lib_basic/IRremoteESP8266-2.7.13/src/ir_Neoclima.h

// Copyright 2019 David Conran

/// @file
/// @brief Support for Neoclima protocols.
/// Analysis by crankyoldgit & AndreyShpilevoy
/// @see https://github.com/crankyoldgit/IRremoteESP8266/issues/764
/// @see https://drive.google.com/file/d/1kjYk4zS9NQcMQhFkak-L4mp4UuaAIesW/view

// Supports:
//   Brand: Neoclima,  Model: NS-09AHTI A/C
//   Brand: Neoclima,  Model: ZH/TY-01 remote
//   Brand: Soleus Air,  Model: TTWM1-10-01 A/C
//   Brand: Soleus Air,  Model: ZCF/TL-05 remote

#ifndef IR_NEOCLIMA_H_
#define IR_NEOCLIMA_H_

#define __STDC_LIMIT_MACROS
#include <stdint.h>
#ifndef UNIT_TEST
#include <Arduino.h>
#endif
#include "IRremoteESP8266.h"
#include "IRsend.h"
#ifdef UNIT_TEST
#include "IRsend_test.h"
#endif

// Constants
// state[1]
const uint8_t kNeoclima8CHeatOffset = 1;
const uint8_t kNeoclimaIonOffset = 2;
// state[3]
const uint8_t kNeoclimaLightOffset = 0;   ///< Mask 0b0000000x
const uint8_t kNeoclimaHoldOffset = 2;    ///< Mask 0b00000x00
const uint8_t kNeoclimaTurboOffset = 3;   ///< Mask 0b0000x000
const uint8_t kNeoclimaEconoOffset = 4;   ///< Mask 0b000x0000
const uint8_t kNeoclimaEyeOffset = 6;     ///< Mask 0b0x000000
// state[5]
const uint8_t kNeoclimaFreshOffset = 7;   ///< Mask 0bx0000000
const uint8_t kNeoclimaButtonOffset = 0;  ///< Mask 0b000xxxxx
const uint8_t kNeoclimaButtonSize = 5;    ///< Mask 0b000xxxxx
const uint8_t kNeoclimaButtonPower =    0x00;
const uint8_t kNeoclimaButtonMode =     0x01;
const uint8_t kNeoclimaButtonTempUp =   0x02;
const uint8_t kNeoclimaButtonTempDown = 0x03;
const uint8_t kNeoclimaButtonSwing =    0x04;
const uint8_t kNeoclimaButtonFanSpeed = 0x05;
const uint8_t kNeoclimaButtonAirFlow =  0x07;
const uint8_t kNeoclimaButtonHold =     0x08;
const uint8_t kNeoclimaButtonSleep =    0x09;
const uint8_t kNeoclimaButtonTurbo =    0x0A;
const uint8_t kNeoclimaButtonLight =    0x0B;
const uint8_t kNeoclimaButtonEcono =    0x0D;
const uint8_t kNeoclimaButtonEye =      0x0E;
const uint8_t kNeoclimaButtonFollow =   0x13;
const uint8_t kNeoclimaButtonIon =      0x14;
const uint8_t kNeoclimaButtonFresh =    0x15;
const uint8_t kNeoclimaButton8CHeat =   0x1D;
const uint8_t kNeoclimaButtonTempUnit = 0x1E;
// state[7]
const uint8_t kNeoclimaSleepOffset = 0;          // Mask 0b0000000x
const uint8_t kNeoclimaPowerOffset = 1;          // Mask 0b000000x0
const uint8_t kNeoclimaSwingVOffset = 2;         // Mask 0b0000xx00
const uint8_t kNeoclimaSwingVSize = 2;  // Bits
const uint8_t kNeoclimaSwingVOn =                            0b01;
const uint8_t kNeoclimaSwingVOff =                           0b10;
const uint8_t kNeoclimaSwingHOffset = 4;         // Mask 0b000x0000
const uint8_t kNeoclimaFanOffest = 5;            // Mask 0b0xx00000
const uint8_t kNeoclimaFanSize = 2;  // Bits
const uint8_t kNeoclimaFanAuto =                          0b00;
const uint8_t kNeoclimaFanHigh =                          0b01;
const uint8_t kNeoclimaFanMed =                           0b10;
const uint8_t kNeoclimaFanLow =                           0b11;
const uint8_t kNeoclimaUseFahrenheitOffset = 7;  // Mask 0bx0000000
// state[8]
const uint8_t kNeoclimaFollowMe = 0x5D;  // Also 0x5F
// state[9]
const uint8_t kNeoclimaTempOffset = 0;  // Mask 0b000xxxxx
const uint8_t kNeoclimaTempSize = 5;  // Bits
const uint8_t kNeoclimaMinTempC = 16;   // 16C
const uint8_t kNeoclimaMaxTempC = 32;   // 32C
const uint8_t kNeoclimaMinTempF = 61;   // 61F
const uint8_t kNeoclimaMaxTempF = 90;   // 90F
const uint8_t kNeoclimaModeOffset = 5;  // Mask 0bxxx00000
const uint8_t kNeoclimaAuto =     0b000;
const uint8_t kNeoclimaCool =     0b001;
const uint8_t kNeoclimaDry =      0b010;
const uint8_t kNeoclimaFan =      0b011;
const uint8_t kNeoclimaHeat =     0b100;

// Classes
/// Class for handling detailed Neoclima A/C messages.
class IRNeoclimaAc {
 public:
  explicit IRNeoclimaAc(const uint16_t pin, const bool inverted = false,
                        const bool use_modulation = true);
  void stateReset(void);
#if SEND_NEOCLIMA
  void send(const uint16_t repeat = kNeoclimaMinRepeat);
  /// Run the calibration to calculate uSec timing offsets for this platform.
  /// @return The uSec timing offset needed per modulation of the IR Led.
  /// @note This will produce a 65ms IR signal pulse at 38kHz.
  ///   Only ever needs to be run once per object instantiation, if at all.
  int8_t calibrate(void) { return _irsend.calibrate(); }
#endif  // SEND_NEOCLIMA
  void begin(void);
  void setButton(const uint8_t button);
  uint8_t getButton(void);
  void on(void);
  void off(void);
  void setPower(const bool on);
  bool getPower(void);
  void setMode(const uint8_t mode);
  uint8_t getMode(void);
  void setTemp(const uint8_t temp, const bool celsius = true);
  uint8_t getTemp(void);
  void setFan(const uint8_t speed);
  uint8_t getFan(void);
  void setSwingV(const bool on);
  bool getSwingV(void);
  void setSwingH(const bool on);
  bool getSwingH(void);
  void setSleep(const bool on);
  bool getSleep(void);
  void setTurbo(const bool on);
  bool getTurbo(void);
  void setEcono(const bool on);
  bool getEcono(void);
  void setFresh(const bool on);
  bool getFresh(void);
  void setHold(const bool on);
  bool getHold(void);
  void setIon(const bool on);
  bool getIon(void);
  void setLight(const bool on);
  bool getLight(void);
  void set8CHeat(const bool on);
  bool get8CHeat(void);
  void setEye(const bool on);
  bool getEye(void);
  bool getTempUnits(void);
  // DISABLED: See TODO in ir_Neoclima.cpp
  // void setFollow(const bool on);
  bool getFollow(void);
  uint8_t* getRaw(void);
  void setRaw(const uint8_t new_code[],
              const uint16_t length = kNeoclimaStateLength);
  static bool validChecksum(const uint8_t state[],
                            const uint16_t length = kNeoclimaStateLength);
  static uint8_t calcChecksum(const uint8_t state[],
                              const uint16_t length = kNeoclimaStateLength);
  String toString(void);
  uint8_t convertMode(const stdAc::opmode_t mode);
  uint8_t convertFan(const stdAc::fanspeed_t speed);
  static stdAc::opmode_t toCommonMode(const uint8_t mode);
  static stdAc::fanspeed_t toCommonFanSpeed(const uint8_t speed);
  stdAc::state_t toCommon(void);
#ifndef UNIT_TEST

 private:
  IRsend _irsend;  ///< Instance of the IR send class
#else  // UNIT_TEST
  /// @cond IGNORE
  IRsendTest _irsend;  ///< Instance of the testing IR send class
  /// @endcond
#endif  // UNIT_TEST
  uint8_t remote_state[kNeoclimaStateLength];  ///< State of the remote in code.
  void checksum(const uint16_t length = kNeoclimaStateLength);
};

#endif  // IR_NEOCLIMA_H_