IRremoteESP8266
ir_Neoclima.h
Go to the documentation of this file.
1 // Copyright 2019 David Conran
2 
8 
9 // Supports:
10 // Brand: Neoclima, Model: NS-09AHTI A/C
11 // Brand: Neoclima, Model: ZH/TY-01 remote
12 // Brand: Soleus Air, Model: TTWM1-10-01 A/C
13 // Brand: Soleus Air, Model: ZCF/TL-05 remote
14 
15 #ifndef IR_NEOCLIMA_H_
16 #define IR_NEOCLIMA_H_
17 
18 #define __STDC_LIMIT_MACROS
19 #include <stdint.h>
20 #ifndef UNIT_TEST
21 #include <Arduino.h>
22 #endif
23 #include "IRremoteESP8266.h"
24 #include "IRsend.h"
25 #ifdef UNIT_TEST
26 #include "IRsend_test.h"
27 #endif
28 
29 // Constants
30 // state[1]
31 const uint8_t kNeoclima8CHeatOffset = 1;
32 const uint8_t kNeoclimaIonOffset = 2;
33 // state[3]
34 const uint8_t kNeoclimaLightOffset = 0;
35 const uint8_t kNeoclimaHoldOffset = 2;
36 const uint8_t kNeoclimaTurboOffset = 3;
37 const uint8_t kNeoclimaEconoOffset = 4;
38 const uint8_t kNeoclimaEyeOffset = 6;
39 // state[5]
40 const uint8_t kNeoclimaFreshOffset = 7;
41 const uint8_t kNeoclimaButtonOffset = 0;
42 const uint8_t kNeoclimaButtonSize = 5;
43 const uint8_t kNeoclimaButtonPower = 0x00;
44 const uint8_t kNeoclimaButtonMode = 0x01;
45 const uint8_t kNeoclimaButtonTempUp = 0x02;
46 const uint8_t kNeoclimaButtonTempDown = 0x03;
47 const uint8_t kNeoclimaButtonSwing = 0x04;
48 const uint8_t kNeoclimaButtonFanSpeed = 0x05;
49 const uint8_t kNeoclimaButtonAirFlow = 0x07;
50 const uint8_t kNeoclimaButtonHold = 0x08;
51 const uint8_t kNeoclimaButtonSleep = 0x09;
52 const uint8_t kNeoclimaButtonTurbo = 0x0A;
53 const uint8_t kNeoclimaButtonLight = 0x0B;
54 const uint8_t kNeoclimaButtonEcono = 0x0D;
55 const uint8_t kNeoclimaButtonEye = 0x0E;
56 const uint8_t kNeoclimaButtonFollow = 0x13;
57 const uint8_t kNeoclimaButtonIon = 0x14;
58 const uint8_t kNeoclimaButtonFresh = 0x15;
59 const uint8_t kNeoclimaButton8CHeat = 0x1D;
60 const uint8_t kNeoclimaButtonTempUnit = 0x1E;
61 // state[7]
62 const uint8_t kNeoclimaSleepOffset = 0; // Mask 0b0000000x
63 const uint8_t kNeoclimaPowerOffset = 1; // Mask 0b000000x0
64 const uint8_t kNeoclimaSwingVOffset = 2; // Mask 0b0000xx00
65 const uint8_t kNeoclimaSwingVSize = 2; // Bits
66 const uint8_t kNeoclimaSwingVOn = 0b01;
67 const uint8_t kNeoclimaSwingVOff = 0b10;
68 const uint8_t kNeoclimaSwingHOffset = 4; // Mask 0b000x0000
69 const uint8_t kNeoclimaFanOffest = 5; // Mask 0b0xx00000
70 const uint8_t kNeoclimaFanSize = 2; // Bits
71 const uint8_t kNeoclimaFanAuto = 0b00;
72 const uint8_t kNeoclimaFanHigh = 0b01;
73 const uint8_t kNeoclimaFanMed = 0b10;
74 const uint8_t kNeoclimaFanLow = 0b11;
75 const uint8_t kNeoclimaUseFahrenheitOffset = 7; // Mask 0bx0000000
76 // state[8]
77 const uint8_t kNeoclimaFollowMe = 0x5D; // Also 0x5F
78 // state[9]
79 const uint8_t kNeoclimaTempOffset = 0; // Mask 0b000xxxxx
80 const uint8_t kNeoclimaTempSize = 5; // Bits
81 const uint8_t kNeoclimaMinTempC = 16; // 16C
82 const uint8_t kNeoclimaMaxTempC = 32; // 32C
83 const uint8_t kNeoclimaMinTempF = 61; // 61F
84 const uint8_t kNeoclimaMaxTempF = 90; // 90F
85 const uint8_t kNeoclimaModeOffset = 5; // Mask 0bxxx00000
86 const uint8_t kNeoclimaAuto = 0b000;
87 const uint8_t kNeoclimaCool = 0b001;
88 const uint8_t kNeoclimaDry = 0b010;
89 const uint8_t kNeoclimaFan = 0b011;
90 const uint8_t kNeoclimaHeat = 0b100;
91 
92 // Classes
94 class IRNeoclimaAc {
95  public:
96  explicit IRNeoclimaAc(const uint16_t pin, const bool inverted = false,
97  const bool use_modulation = true);
98  void stateReset(void);
99 #if SEND_NEOCLIMA
100  void send(const uint16_t repeat = kNeoclimaMinRepeat);
105  int8_t calibrate(void) { return _irsend.calibrate(); }
106 #endif // SEND_NEOCLIMA
107  void begin(void);
108  void setButton(const uint8_t button);
109  uint8_t getButton(void);
110  void on(void);
111  void off(void);
112  void setPower(const bool on);
113  bool getPower(void);
114  void setMode(const uint8_t mode);
115  uint8_t getMode(void);
116  void setTemp(const uint8_t temp, const bool celsius = true);
117  uint8_t getTemp(void);
118  void setFan(const uint8_t speed);
119  uint8_t getFan(void);
120  void setSwingV(const bool on);
121  bool getSwingV(void);
122  void setSwingH(const bool on);
123  bool getSwingH(void);
124  void setSleep(const bool on);
125  bool getSleep(void);
126  void setTurbo(const bool on);
127  bool getTurbo(void);
128  void setEcono(const bool on);
129  bool getEcono(void);
130  void setFresh(const bool on);
131  bool getFresh(void);
132  void setHold(const bool on);
133  bool getHold(void);
134  void setIon(const bool on);
135  bool getIon(void);
136  void setLight(const bool on);
137  bool getLight(void);
138  void set8CHeat(const bool on);
139  bool get8CHeat(void);
140  void setEye(const bool on);
141  bool getEye(void);
142  bool getTempUnits(void);
143  // DISABLED: See TODO in ir_Neoclima.cpp
144  // void setFollow(const bool on);
145  bool getFollow(void);
146  uint8_t* getRaw(void);
147  void setRaw(const uint8_t new_code[],
148  const uint16_t length = kNeoclimaStateLength);
149  static bool validChecksum(const uint8_t state[],
150  const uint16_t length = kNeoclimaStateLength);
151  static uint8_t calcChecksum(const uint8_t state[],
152  const uint16_t length = kNeoclimaStateLength);
153  String toString(void);
154  uint8_t convertMode(const stdAc::opmode_t mode);
155  uint8_t convertFan(const stdAc::fanspeed_t speed);
156  static stdAc::opmode_t toCommonMode(const uint8_t mode);
157  static stdAc::fanspeed_t toCommonFanSpeed(const uint8_t speed);
158  stdAc::state_t toCommon(void);
159 #ifndef UNIT_TEST
160 
161  private:
163 #else // UNIT_TEST
164  IRsendTest _irsend;
166 #endif // UNIT_TEST
169  void checksum(const uint16_t length = kNeoclimaStateLength);
170 };
171 
172 #endif // IR_NEOCLIMA_H_
kNeoclimaFanHigh
const uint8_t kNeoclimaFanHigh
Definition: ir_Neoclima.h:72
kNeoclimaUseFahrenheitOffset
const uint8_t kNeoclimaUseFahrenheitOffset
Definition: ir_Neoclima.h:75
IRNeoclimaAc::toCommonFanSpeed
static stdAc::fanspeed_t toCommonFanSpeed(const uint8_t speed)
Convert a native fan speed into its stdAc equivalent.
Definition: ir_Neoclima.cpp:310
kNeoclimaMinTempC
const uint8_t kNeoclimaMinTempC
Definition: ir_Neoclima.h:81
kNeoclimaButtonFanSpeed
const uint8_t kNeoclimaButtonFanSpeed
Definition: ir_Neoclima.h:48
kNeoclimaButtonTurbo
const uint8_t kNeoclimaButtonTurbo
Definition: ir_Neoclima.h:52
kNeoclimaFollowMe
const uint8_t kNeoclimaFollowMe
Definition: ir_Neoclima.h:77
IRNeoclimaAc::getSleep
bool getSleep(void)
Get the Sleep setting of the A/C.
Definition: ir_Neoclima.cpp:328
kNeoclimaEyeOffset
const uint8_t kNeoclimaEyeOffset
Mask 0b0x000000.
Definition: ir_Neoclima.h:38
kNeoclimaTempOffset
const uint8_t kNeoclimaTempOffset
Definition: ir_Neoclima.h:79
IRNeoclimaAc::getEye
bool getEye(void)
Get the Eye (Sensor) setting of the A/C.
Definition: ir_Neoclima.cpp:464
IRNeoclimaAc::getFollow
bool getFollow(void)
Get the Follow Me setting of the A/C.
Definition: ir_Neoclima.cpp:487
kNeoclimaMaxTempC
const uint8_t kNeoclimaMaxTempC
Definition: ir_Neoclima.h:82
stdAc::fanspeed_t
fanspeed_t
Common A/C settings for Fan Speeds.
Definition: IRsend.h:58
kNeoclimaIonOffset
const uint8_t kNeoclimaIonOffset
Definition: ir_Neoclima.h:32
kNeoclimaDry
const uint8_t kNeoclimaDry
Definition: ir_Neoclima.h:88
IRNeoclimaAc::calcChecksum
static uint8_t calcChecksum(const uint8_t state[], const uint16_t length=kNeoclimaStateLength)
Calculate the checksum for a given state.
Definition: ir_Neoclima.cpp:85
IRNeoclimaAc::calibrate
int8_t calibrate(void)
Run the calibration to calculate uSec timing offsets for this platform.
Definition: ir_Neoclima.h:105
IRNeoclimaAc::set8CHeat
void set8CHeat(const bool on)
Set the 8°C Heat setting of the A/C.
Definition: ir_Neoclima.cpp:444
kNeoclimaButtonEye
const uint8_t kNeoclimaButtonEye
Definition: ir_Neoclima.h:55
kNeoclimaButtonPower
const uint8_t kNeoclimaButtonPower
Definition: ir_Neoclima.h:43
IRNeoclimaAc::setFan
void setFan(const uint8_t speed)
Set the speed of the fan.
Definition: ir_Neoclima.cpp:267
kNeoclimaSwingVOn
const uint8_t kNeoclimaSwingVOn
Definition: ir_Neoclima.h:66
kNeoclimaButtonMode
const uint8_t kNeoclimaButtonMode
Definition: ir_Neoclima.h:44
kNeoclimaStateLength
const uint16_t kNeoclimaStateLength
Definition: IRremoteESP8266.h:1023
IRNeoclimaAc::setHold
void setHold(const bool on)
Set the Hold setting of the A/C.
Definition: ir_Neoclima.cpp:401
kNeoclimaSleepOffset
const uint8_t kNeoclimaSleepOffset
Definition: ir_Neoclima.h:62
IRNeoclimaAc::getMode
uint8_t getMode(void)
Get the operating mode setting of the A/C.
Definition: ir_Neoclima.cpp:208
IRNeoclimaAc::getPower
bool getPower(void)
Get the value of the current power setting.
Definition: ir_Neoclima.cpp:181
kNeoclimaMinTempF
const uint8_t kNeoclimaMinTempF
Definition: ir_Neoclima.h:83
IRNeoclimaAc::setRaw
void setRaw(const uint8_t new_code[], const uint16_t length=kNeoclimaStateLength)
Set the internal state from a valid code for this protocol.
Definition: ir_Neoclima.cpp:126
kNeoclimaButtonHold
const uint8_t kNeoclimaButtonHold
Definition: ir_Neoclima.h:50
IRNeoclimaAc::setEcono
void setEcono(const bool on)
Set the Economy (Energy Saver) setting of the A/C.
Definition: ir_Neoclima.cpp:375
IRNeoclimaAc::setTemp
void setTemp(const uint8_t temp, const bool celsius=true)
Set the temperature.
Definition: ir_Neoclima.cpp:241
IRsend.h
kNeoclimaSwingVSize
const uint8_t kNeoclimaSwingVSize
Definition: ir_Neoclima.h:65
kNeoclimaAuto
const uint8_t kNeoclimaAuto
Definition: ir_Neoclima.h:86
kNeoclimaMaxTempF
const uint8_t kNeoclimaMaxTempF
Definition: ir_Neoclima.h:84
IRNeoclimaAc::getFan
uint8_t getFan(void)
Get the current fan speed setting.
Definition: ir_Neoclima.cpp:289
IRNeoclimaAc::setLight
void setLight(const bool on)
Set the Light(LED display) setting of the A/C.
Definition: ir_Neoclima.cpp:427
kNeoclimaFan
const uint8_t kNeoclimaFan
Definition: ir_Neoclima.h:89
IRsend
Class for sending all basic IR protocols.
Definition: IRsend.h:182
IRNeoclimaAc::getRaw
uint8_t * getRaw(void)
Get a PTR to the internal state/code for this protocol.
Definition: ir_Neoclima.cpp:118
kNeoclimaFanAuto
const uint8_t kNeoclimaFanAuto
Definition: ir_Neoclima.h:71
IRsend::calibrate
int8_t calibrate(uint16_t hz=38000U)
Calculate & set any offsets to account for execution times during sending.
Definition: IRsend.cpp:207
kNeoclimaFreshOffset
const uint8_t kNeoclimaFreshOffset
Mask 0bx0000000.
Definition: ir_Neoclima.h:40
IRNeoclimaAc::getFresh
bool getFresh(void)
Get the Fresh (air) setting of the A/C.
Definition: ir_Neoclima.cpp:395
IRNeoclimaAc::getButton
uint8_t getButton(void)
Get the Button/Command setting of the A/C.
Definition: ir_Neoclima.cpp:162
String
std::string String
Definition: IRremoteESP8266.h:1178
IRNeoclimaAc::getSwingH
bool getSwingH(void)
Get the horizontal swing (Air Flow) setting of the A/C.
Definition: ir_Neoclima.cpp:356
kNeoclimaButtonFresh
const uint8_t kNeoclimaButtonFresh
Definition: ir_Neoclima.h:58
IRNeoclimaAc::getTurbo
bool getTurbo(void)
Get the Turbo setting of the A/C.
Definition: ir_Neoclima.cpp:369
kNeoclimaButtonEcono
const uint8_t kNeoclimaButtonEcono
Definition: ir_Neoclima.h:54
IRNeoclimaAc::getEcono
bool getEcono(void)
Get the Economy (Energy Saver) setting of the A/C.
Definition: ir_Neoclima.cpp:382
kNeoclimaButtonAirFlow
const uint8_t kNeoclimaButtonAirFlow
Definition: ir_Neoclima.h:49
IRremoteESP8266.h
IRNeoclimaAc::stateReset
void stateReset(void)
Reset the state of the remote to a known good state/sequence.
Definition: ir_Neoclima.cpp:72
IRNeoclimaAc::convertFan
uint8_t convertFan(const stdAc::fanspeed_t speed)
Convert a stdAc::fanspeed_t enum into it's native speed.
Definition: ir_Neoclima.cpp:296
kNeoclimaButtonOffset
const uint8_t kNeoclimaButtonOffset
Mask 0b000xxxxx.
Definition: ir_Neoclima.h:41
kNeoclimaButtonTempDown
const uint8_t kNeoclimaButtonTempDown
Definition: ir_Neoclima.h:46
IRNeoclimaAc::begin
void begin(void)
Set up hardware to be able to send a message.
Definition: ir_Neoclima.cpp:79
kNeoclima8CHeatOffset
const uint8_t kNeoclima8CHeatOffset
Definition: ir_Neoclima.h:31
kNeoclimaEconoOffset
const uint8_t kNeoclimaEconoOffset
Mask 0b000x0000.
Definition: ir_Neoclima.h:37
kNeoclimaSwingHOffset
const uint8_t kNeoclimaSwingHOffset
Definition: ir_Neoclima.h:68
kNeoclimaPowerOffset
const uint8_t kNeoclimaPowerOffset
Definition: ir_Neoclima.h:63
IRNeoclimaAc::getTemp
uint8_t getTemp(void)
Get the current temperature setting.
Definition: ir_Neoclima.cpp:258
kNeoclimaFanSize
const uint8_t kNeoclimaFanSize
Definition: ir_Neoclima.h:70
IRNeoclimaAc::getSwingV
bool getSwingV(void)
Get the vertical swing setting of the A/C.
Definition: ir_Neoclima.cpp:342
kNeoclimaButtonSize
const uint8_t kNeoclimaButtonSize
Mask 0b000xxxxx.
Definition: ir_Neoclima.h:42
kNeoclimaLightOffset
const uint8_t kNeoclimaLightOffset
Mask 0b0000000x.
Definition: ir_Neoclima.h:34
IRNeoclimaAc::remote_state
uint8_t remote_state[kNeoclimaStateLength]
State of the remote in code.
Definition: ir_Neoclima.h:168
kNeoclimaTempSize
const uint8_t kNeoclimaTempSize
Definition: ir_Neoclima.h:80
kNeoclimaButtonLight
const uint8_t kNeoclimaButtonLight
Definition: ir_Neoclima.h:53
IRNeoclimaAc::setIon
void setIon(const bool on)
Set the Ion (filter) setting of the A/C.
Definition: ir_Neoclima.cpp:414
kNeoclimaButtonSwing
const uint8_t kNeoclimaButtonSwing
Definition: ir_Neoclima.h:47
kNeoclimaButtonFollow
const uint8_t kNeoclimaButtonFollow
Definition: ir_Neoclima.h:56
IRNeoclimaAc::getHold
bool getHold(void)
Get the Hold setting of the A/C.
Definition: ir_Neoclima.cpp:408
IRNeoclimaAc::_irsend
IRsend _irsend
Instance of the IR send class.
Definition: ir_Neoclima.h:162
kNeoclimaSwingVOff
const uint8_t kNeoclimaSwingVOff
Definition: ir_Neoclima.h:67
IRNeoclimaAc::setSwingV
void setSwingV(const bool on)
Set the vertical swing setting of the A/C.
Definition: ir_Neoclima.cpp:334
IRNeoclimaAc::setEye
void setEye(const bool on)
Set the Eye (Sensor) setting of the A/C.
Definition: ir_Neoclima.cpp:457
IRNeoclimaAc::toCommonMode
static stdAc::opmode_t toCommonMode(const uint8_t mode)
Convert a native mode into its stdAc equivalent.
Definition: ir_Neoclima.cpp:228
kNeoclimaButtonSleep
const uint8_t kNeoclimaButtonSleep
Definition: ir_Neoclima.h:51
kNeoclimaTurboOffset
const uint8_t kNeoclimaTurboOffset
Mask 0b0000x000.
Definition: ir_Neoclima.h:36
IRNeoclimaAc::on
void on(void)
Set the requested power state of the A/C to on.
Definition: ir_Neoclima.cpp:167
kNeoclimaFanMed
const uint8_t kNeoclimaFanMed
Definition: ir_Neoclima.h:73
kNeoclimaButtonTempUnit
const uint8_t kNeoclimaButtonTempUnit
Definition: ir_Neoclima.h:60
IRNeoclimaAc::setFresh
void setFresh(const bool on)
Set the Fresh (air) setting of the A/C.
Definition: ir_Neoclima.cpp:388
IRNeoclimaAc::toCommon
stdAc::state_t toCommon(void)
Convert the current internal state into its stdAc::state_t equivalent.
Definition: ir_Neoclima.cpp:493
IRNeoclimaAc::setPower
void setPower(const bool on)
Change the power setting.
Definition: ir_Neoclima.cpp:174
kNeoclimaCool
const uint8_t kNeoclimaCool
Definition: ir_Neoclima.h:87
kNeoclimaHoldOffset
const uint8_t kNeoclimaHoldOffset
Mask 0b00000x00.
Definition: ir_Neoclima.h:35
kNeoclimaButton8CHeat
const uint8_t kNeoclimaButton8CHeat
Definition: ir_Neoclima.h:59
IRNeoclimaAc::getIon
bool getIon(void)
Get the Ion (filter) setting of the A/C.
Definition: ir_Neoclima.cpp:421
kNeoclimaSwingVOffset
const uint8_t kNeoclimaSwingVOffset
Definition: ir_Neoclima.h:64
IRNeoclimaAc::get8CHeat
bool get8CHeat(void)
Get the 8°C Heat setting of the A/C.
Definition: ir_Neoclima.cpp:451
kNeoclimaFanOffest
const uint8_t kNeoclimaFanOffest
Definition: ir_Neoclima.h:69
IRNeoclimaAc::convertMode
uint8_t convertMode(const stdAc::opmode_t mode)
Convert a stdAc::opmode_t enum into its native mode.
Definition: ir_Neoclima.cpp:215
kNeoclimaHeat
const uint8_t kNeoclimaHeat
Definition: ir_Neoclima.h:90
IRNeoclimaAc::setButton
void setButton(const uint8_t button)
Set the Button/Command pressed setting of the A/C.
Definition: ir_Neoclima.cpp:132
kNeoclimaButtonIon
const uint8_t kNeoclimaButtonIon
Definition: ir_Neoclima.h:57
IRNeoclimaAc::toString
String toString(void)
Convert the current internal state into a human readable string.
Definition: ir_Neoclima.cpp:521
IRNeoclimaAc::setMode
void setMode(const uint8_t mode)
Set the operating mode of the A/C.
Definition: ir_Neoclima.cpp:187
kNeoclimaFanLow
const uint8_t kNeoclimaFanLow
Definition: ir_Neoclima.h:74
IRNeoclimaAc::setTurbo
void setTurbo(const bool on)
Set the Turbo setting of the A/C.
Definition: ir_Neoclima.cpp:362
IRNeoclimaAc::getTempUnits
bool getTempUnits(void)
Is the A/C unit using Fahrenheit or Celsius for temperature units.
Definition: ir_Neoclima.cpp:470
IRNeoclimaAc::checksum
void checksum(const uint16_t length=kNeoclimaStateLength)
Calculate & update the checksum for the internal state.
Definition: ir_Neoclima.cpp:103
kNeoclimaModeOffset
const uint8_t kNeoclimaModeOffset
Definition: ir_Neoclima.h:85
IRNeoclimaAc::setSwingH
void setSwingH(const bool on)
Set the horizontal swing setting of the A/C.
Definition: ir_Neoclima.cpp:349
IRNeoclimaAc::send
void send(const uint16_t repeat=kNeoclimaMinRepeat)
Send the current internal state as an IR message.
Definition: ir_Neoclima.cpp:111
IRNeoclimaAc::off
void off(void)
Set the requested power state of the A/C to off.
Definition: ir_Neoclima.cpp:170
stdAc::state_t
Structure to hold a common A/C state.
Definition: IRsend.h:97
kNeoclimaMinRepeat
const uint16_t kNeoclimaMinRepeat
Definition: IRremoteESP8266.h:1025
IRNeoclimaAc::IRNeoclimaAc
IRNeoclimaAc(const uint16_t pin, const bool inverted=false, const bool use_modulation=true)
Class constructor.
Definition: ir_Neoclima.cpp:65
IRNeoclimaAc
Class for handling detailed Neoclima A/C messages.
Definition: ir_Neoclima.h:94
IRNeoclimaAc::getLight
bool getLight(void)
Get the Light (LED display) setting of the A/C.
Definition: ir_Neoclima.cpp:434
IRNeoclimaAc::setSleep
void setSleep(const bool on)
Set the Sleep setting of the A/C.
Definition: ir_Neoclima.cpp:321
IRNeoclimaAc::validChecksum
static bool validChecksum(const uint8_t state[], const uint16_t length=kNeoclimaStateLength)
Verify the checksum is valid for a given state.
Definition: ir_Neoclima.cpp:95
kNeoclimaButtonTempUp
const uint8_t kNeoclimaButtonTempUp
Definition: ir_Neoclima.h:45
stdAc::opmode_t
opmode_t
Common A/C settings for A/C operating modes.
Definition: IRsend.h:46