IRremoteESP8266
ir_Argo.h
Go to the documentation of this file.
1 // Copyright 2017 Schmolders
4 
5 // Supports:
6 // Brand: Argo, Model: Ulisse 13 DCI Mobile Split A/C
7 
8 #ifndef IR_ARGO_H_
9 #define IR_ARGO_H_
10 
11 #ifndef UNIT_TEST
12 #include <Arduino.h>
13 #endif
14 #include "IRremoteESP8266.h"
15 #include "IRsend.h"
16 #ifdef UNIT_TEST
17 #include "IRsend_test.h"
18 #endif
19 
20 
21 // ARGO Ulisse DCI
22 
23 union ArgoProtocol {
24  uint8_t raw[kArgoStateLength];
25  struct {
26  // Byte 0
27  uint64_t :8; // Typically 0b00110101
28  // Byte 1
29  uint64_t :8; // Typically 0b10101111
30  // Byte 2~4
31  uint64_t :3;
32  uint64_t Mode :3;
33  uint64_t Temp :5; // straddle byte 2 and 3
34  uint64_t Fan :2;
35  uint64_t RoomTemp :5; // straddle byte 3 and 4
36  uint64_t Flap :3; // SwingV
37  uint64_t :3; // OnTimer, maybe hours
38  // Byte 5
39  uint64_t :8; // OnTimer, maybe minutes
40  // Byte 6
41  uint64_t :8; // OffTimer, maybe minutes
42  // Byte 7
43  uint64_t :3; // OffTimer, maybe hours
44  uint64_t :5; // Time
45  // Byte 8
46  uint32_t :6; // Time
47  uint32_t :1; // Timer On/Off
48  uint32_t :1; // Timer Program
49  // Byte 9
50  uint32_t :1; // Timer Program
51  uint32_t :1; // Timer 1h
52  uint32_t Night :1;
53  uint32_t Max :1;
54  uint32_t :1; // Filter
55  uint32_t Power :1;
56  uint32_t :1; // const 0
57  uint32_t iFeel :1;
58  // Byte 10~11
59  uint32_t :2; // const 01
60  uint32_t Sum :8; // straddle byte 10 and 11
61  uint32_t :6;
62  };
63 };
64 
65 // Constants. Store MSB left.
66 
67 const uint8_t kArgoHeatBit = 0b00100000;
68 
69 // Mode 0b00111000
70 const uint8_t kArgoCool = 0b000;
71 const uint8_t kArgoDry = 0b001;
72 const uint8_t kArgoAuto = 0b010;
73 const uint8_t kArgoOff = 0b011;
74 const uint8_t kArgoHeat = 0b100;
75 const uint8_t kArgoHeatAuto = 0b101;
76 // ?no idea what mode that is
77 const uint8_t kArgoHeatBlink = 0b110;
78 
79 // Fan 0b00011000
80 const uint8_t kArgoFanAuto = 0; // 0b00
81 const uint8_t kArgoFan1 = 1; // 0b01
82 const uint8_t kArgoFan2 = 2; // 0b10
83 const uint8_t kArgoFan3 = 3; // 0b11
84 
85 // Temp
86 const uint8_t kArgoTempDelta = 4;
87 const uint8_t kArgoMaxRoomTemp = 35; // Celsius
88 const uint8_t kArgoMinTemp = 10; // Celsius delta +4
89 const uint8_t kArgoMaxTemp = 32; // Celsius
90 
91 // Flap/SwingV
92 const uint8_t kArgoFlapAuto = 0;
93 const uint8_t kArgoFlap1 = 1;
94 const uint8_t kArgoFlap2 = 2;
95 const uint8_t kArgoFlap3 = 3;
96 const uint8_t kArgoFlap4 = 4;
97 const uint8_t kArgoFlap5 = 5;
98 const uint8_t kArgoFlap6 = 6;
99 const uint8_t kArgoFlapFull = 7;
100 
101 // Legacy defines. (Deperecated)
102 #define ARGO_COOL_ON kArgoCoolOn
103 #define ARGO_COOL_OFF kArgoCoolOff
104 #define ARGO_COOL_AUTO kArgoCoolAuto
105 #define ARGO_COOL_HUM kArgoCoolHum
106 #define ARGO_HEAT_ON kArgoHeatOn
107 #define ARGO_HEAT_AUTO kArgoHeatAuto
108 #define ARGO_HEAT_BLINK kArgoHeatBlink
109 #define ARGO_MIN_TEMP kArgoMinTemp
110 #define ARGO_MAX_TEMP kArgoMaxTemp
111 #define ARGO_FAN_AUTO kArgoFanAuto
112 #define ARGO_FAN_3 kArgoFan3
113 #define ARGO_FAN_2 kArgoFan2
114 #define ARGO_FAN_1 kArgoFan1
115 #define ARGO_FLAP_AUTO kArgoFlapAuto
116 #define ARGO_FLAP_1 kArgoFlap1
117 #define ARGO_FLAP_2 kArgoFlap2
118 #define ARGO_FLAP_3 kArgoFlap3
119 #define ARGO_FLAP_4 kArgoFlap4
120 #define ARGO_FLAP_5 kArgoFlap5
121 #define ARGO_FLAP_6 kArgoFlap6
122 #define ARGO_FLAP_FULL kArgoFlapFull
123 
124 
126 class IRArgoAC {
127  public:
128  explicit IRArgoAC(const uint16_t pin, const bool inverted = false,
129  const bool use_modulation = true);
130 
131 #if SEND_ARGO
132  void send(const uint16_t repeat = kArgoDefaultRepeat);
137  int8_t calibrate(void) { return _irsend.calibrate(); }
138 #endif // SEND_ARGO
139  void begin(void);
140  void on(void);
141  void off(void);
142 
143  void setPower(const bool on);
144  bool getPower(void) const;
145 
146  void setTemp(const uint8_t degrees);
147  uint8_t getTemp(void) const;
148 
149  void setFan(const uint8_t fan);
150  uint8_t getFan(void) const;
151 
152  void setFlap(const uint8_t flap);
153  uint8_t getFlap(void) const;
154 
155  void setMode(const uint8_t mode);
156  uint8_t getMode(void) const;
157 
158  void setMax(const bool on);
159  bool getMax(void) const;
160 
161  void setNight(const bool on);
162  bool getNight(void) const;
163 
164  void setiFeel(const bool on);
165  bool getiFeel(void) const;
166 
167  void setTime(void);
168  void setRoomTemp(const uint8_t degrees);
169  uint8_t getRoomTemp(void) const;
170 
171  uint8_t* getRaw(void);
172  void setRaw(const uint8_t state[]);
173  static uint8_t calcChecksum(const uint8_t state[],
174  const uint16_t length = kArgoStateLength);
175  static bool validChecksum(const uint8_t state[],
176  const uint16_t length = kArgoStateLength);
177  static uint8_t convertMode(const stdAc::opmode_t mode);
178  static uint8_t convertFan(const stdAc::fanspeed_t speed);
179  static uint8_t convertSwingV(const stdAc::swingv_t position);
180  static stdAc::opmode_t toCommonMode(const uint8_t mode);
181  static stdAc::fanspeed_t toCommonFanSpeed(const uint8_t speed);
182  stdAc::state_t toCommon(void) const;
183  String toString(void) const;
184 #ifndef UNIT_TEST
185 
186  private:
188 #else
189  IRsendTest _irsend;
191 #endif
193  // # of bytes per command
195  void stateReset(void);
196  void checksum(void);
197 
198  // Attributes
199  uint8_t flap_mode;
200  uint8_t heat_mode;
201  uint8_t cool_mode;
202 };
203 
204 #endif // IR_ARGO_H_
IRArgoAC::setTime
void setTime(void)
Set the time for the A/C.
Definition: ir_Argo.cpp:244
IRArgoAC::calcChecksum
static uint8_t calcChecksum(const uint8_t state[], const uint16_t length=kArgoStateLength)
Verify the checksum is valid for a given state.
Definition: ir_Argo.cpp:72
ArgoProtocol::Sum
uint32_t Sum
Definition: ir_Argo.h:60
IRArgoAC::flap_mode
uint8_t flap_mode
Definition: ir_Argo.h:199
IRArgoAC::setFan
void setFan(const uint8_t fan)
Set the speed of the fan.
Definition: ir_Argo.cpp:176
IRArgoAC::_irsend
IRsend _irsend
instance of the IR send class
Definition: ir_Argo.h:187
kArgoHeatBlink
const uint8_t kArgoHeatBlink
Definition: ir_Argo.h:77
stdAc::swingv_t
swingv_t
Common A/C settings for Vertical Swing.
Definition: IRsend.h:70
IRArgoAC::getFan
uint8_t getFan(void) const
Get the current fan speed setting.
Definition: ir_Argo.cpp:182
kArgoMaxTemp
const uint8_t kArgoMaxTemp
Definition: ir_Argo.h:89
kArgoDefaultRepeat
const uint16_t kArgoDefaultRepeat
Definition: IRremoteESP8266.h:864
IRArgoAC::setTemp
void setTemp(const uint8_t degrees)
Set the temperature.
Definition: ir_Argo.cpp:159
IRArgoAC::setFlap
void setFlap(const uint8_t flap)
Set the flap position. i.e. Swing.
Definition: ir_Argo.cpp:189
IRArgoAC::toString
String toString(void) const
Convert the current internal state into a human readable string.
Definition: ir_Argo.cpp:372
IRArgoAC::convertMode
static uint8_t convertMode(const stdAc::opmode_t mode)
Convert a stdAc::opmode_t enum into its native mode.
Definition: ir_Argo.cpp:265
IRArgoAC::getRoomTemp
uint8_t getRoomTemp(void) const
Get the currently stored value for the room temperature setting.
Definition: ir_Argo.cpp:258
stdAc::fanspeed_t
fanspeed_t
Common A/C settings for Fan Speeds.
Definition: IRsend.h:58
kArgoFlap2
const uint8_t kArgoFlap2
Definition: ir_Argo.h:94
IRArgoAC::getFlap
uint8_t getFlap(void) const
Get the flap position. i.e. Swing.
Definition: ir_Argo.cpp:197
IRArgoAC::stateReset
void stateReset(void)
Reset the internals of the object to a known good state.
Definition: ir_Argo.cpp:98
ArgoProtocol::Night
uint32_t Night
Definition: ir_Argo.h:52
kArgoFlap4
const uint8_t kArgoFlap4
Definition: ir_Argo.h:96
kArgoHeatBit
const uint8_t kArgoHeatBit
Definition: ir_Argo.h:67
IRArgoAC::calibrate
int8_t calibrate(void)
Run the calibration to calculate uSec timing offsets for this platform.
Definition: ir_Argo.h:137
IRsend.h
IRArgoAC::getPower
bool getPower(void) const
Get the power setting from the internal state.
Definition: ir_Argo.cpp:144
kArgoFlap3
const uint8_t kArgoFlap3
Definition: ir_Argo.h:95
IRsend
Class for sending all basic IR protocols.
Definition: IRsend.h:176
IRArgoAC::validChecksum
static bool validChecksum(const uint8_t state[], const uint16_t length=kArgoStateLength)
Verify the checksum is valid for a given state.
Definition: ir_Argo.cpp:83
IRsend::calibrate
int8_t calibrate(uint16_t hz=38000U)
Calculate & set any offsets to account for execution times during sending.
Definition: IRsend.cpp:207
kArgoStateLength
const uint16_t kArgoStateLength
Definition: IRremoteESP8266.h:862
String
std::string String
Definition: IRremoteESP8266.h:1148
kArgoFan1
const uint8_t kArgoFan1
Definition: ir_Argo.h:81
IRArgoAC::toCommonMode
static stdAc::opmode_t toCommonMode(const uint8_t mode)
Convert a native mode into its stdAc equivilant.
Definition: ir_Argo.cpp:322
kArgoOff
const uint8_t kArgoOff
Definition: ir_Argo.h:73
ArgoProtocol::Flap
uint64_t Flap
Definition: ir_Argo.h:36
IRArgoAC::getiFeel
bool getiFeel(void) const
Get the status of iFeel mode.
Definition: ir_Argo.cpp:240
IRArgoAC::convertSwingV
static uint8_t convertSwingV(const stdAc::swingv_t position)
Convert a stdAc::swingv_t enum into it's native setting.
Definition: ir_Argo.cpp:302
kArgoFlapFull
const uint8_t kArgoFlapFull
Definition: ir_Argo.h:99
ArgoProtocol::Mode
uint64_t Mode
Definition: ir_Argo.h:32
IRremoteESP8266.h
IRArgoAC::getTemp
uint8_t getTemp(void) const
Get the current temperature setting.
Definition: ir_Argo.cpp:170
kArgoDry
const uint8_t kArgoDry
Definition: ir_Argo.h:71
IRArgoAC::toCommon
stdAc::state_t toCommon(void) const
Convert the current internal state into its stdAc::state_t equivilant.
Definition: ir_Argo.cpp:346
kArgoAuto
const uint8_t kArgoAuto
Definition: ir_Argo.h:72
IRArgoAC::setRoomTemp
void setRoomTemp(const uint8_t degrees)
Set the value for the current room temperature.
Definition: ir_Argo.cpp:250
IRArgoAC::convertFan
static uint8_t convertFan(const stdAc::fanspeed_t speed)
Convert a stdAc::fanspeed_t enum into it's native speed.
Definition: ir_Argo.cpp:284
IRArgoAC::off
void off(void)
Set the internal state to have the power off.
Definition: ir_Argo.cpp:134
ArgoProtocol::Temp
uint64_t Temp
Definition: ir_Argo.h:33
ArgoProtocol::Power
uint32_t Power
Definition: ir_Argo.h:55
IRArgoAC::setPower
void setPower(const bool on)
Set the internal state to have the desired power.
Definition: ir_Argo.cpp:138
kArgoFlap1
const uint8_t kArgoFlap1
Definition: ir_Argo.h:93
ArgoProtocol::raw
uint8_t raw[kArgoStateLength]
The state in native IR code form.
Definition: ir_Argo.h:24
IRArgoAC::getRaw
uint8_t * getRaw(void)
Get the raw state of the object, suitable to be sent with the appropriate IRsend object method.
Definition: ir_Argo.cpp:119
ArgoProtocol::Fan
uint64_t Fan
Definition: ir_Argo.h:34
IRArgoAC::heat_mode
uint8_t heat_mode
Definition: ir_Argo.h:200
ArgoProtocol::Max
uint32_t Max
Definition: ir_Argo.h:53
ArgoProtocol::RoomTemp
uint64_t RoomTemp
Definition: ir_Argo.h:35
kArgoMinTemp
const uint8_t kArgoMinTemp
Definition: ir_Argo.h:88
IRArgoAC::on
void on(void)
Set the internal state to have the power on.
Definition: ir_Argo.cpp:131
IRArgoAC::setNight
void setNight(const bool on)
Turn on/off the Night mode. i.e. Sleep.
Definition: ir_Argo.cpp:224
kArgoFan2
const uint8_t kArgoFan2
Definition: ir_Argo.h:82
kArgoCool
const uint8_t kArgoCool
Definition: ir_Argo.h:70
IRArgoAC::send
void send(const uint16_t repeat=kArgoDefaultRepeat)
Send the current internal state as an IR message.
Definition: ir_Argo.cpp:63
IRArgoAC::_
ArgoProtocol _
Definition: ir_Argo.h:194
kArgoHeatAuto
const uint8_t kArgoHeatAuto
Definition: ir_Argo.h:75
ArgoProtocol
Definition: ir_Argo.h:23
IRArgoAC::toCommonFanSpeed
static stdAc::fanspeed_t toCommonFanSpeed(const uint8_t speed)
Convert a native fan speed into its stdAc equivilant.
Definition: ir_Argo.cpp:335
kArgoHeat
const uint8_t kArgoHeat
Definition: ir_Argo.h:74
IRArgoAC::setRaw
void setRaw(const uint8_t state[])
Set the raw state of the object.
Definition: ir_Argo.cpp:126
IRArgoAC::getMode
uint8_t getMode(void) const
Get the current operation mode setting.
Definition: ir_Argo.cpp:201
kArgoFlap5
const uint8_t kArgoFlap5
Definition: ir_Argo.h:97
IRArgoAC::IRArgoAC
IRArgoAC(const uint16_t pin, const bool inverted=false, const bool use_modulation=true)
Class constructor.
Definition: ir_Argo.cpp:53
kArgoTempDelta
const uint8_t kArgoTempDelta
Definition: ir_Argo.h:86
IRArgoAC::checksum
void checksum(void)
Update the checksum for the internal state.
Definition: ir_Argo.cpp:89
kArgoFlap6
const uint8_t kArgoFlap6
Definition: ir_Argo.h:98
IRArgoAC::cool_mode
uint8_t cool_mode
Definition: ir_Argo.h:201
IRArgoAC::getMax
bool getMax(void) const
Is the Max (i.e. Turbo) setting on?
Definition: ir_Argo.cpp:154
IRArgoAC::getNight
bool getNight(void) const
Get the status of Night mode. i.e. Sleep.
Definition: ir_Argo.cpp:230
IRArgoAC::setiFeel
void setiFeel(const bool on)
Turn on/off the iFeel mode.
Definition: ir_Argo.cpp:234
ArgoProtocol::iFeel
uint32_t iFeel
Definition: ir_Argo.h:57
IRArgoAC::setMax
void setMax(const bool on)
Control the current Max setting. (i.e. Turbo)
Definition: ir_Argo.cpp:148
kArgoFlapAuto
const uint8_t kArgoFlapAuto
Definition: ir_Argo.h:92
stdAc::state_t
Structure to hold a common A/C state.
Definition: IRsend.h:97
kArgoFan3
const uint8_t kArgoFan3
Definition: ir_Argo.h:83
IRArgoAC
Class for handling detailed Argo A/C messages.
Definition: ir_Argo.h:126
kArgoFanAuto
const uint8_t kArgoFanAuto
Definition: ir_Argo.h:80
IRArgoAC::begin
void begin(void)
Set up hardware to be able to send a message.
Definition: ir_Argo.cpp:58
IRArgoAC::setMode
void setMode(const uint8_t mode)
Set the desired operation mode.
Definition: ir_Argo.cpp:207
kArgoMaxRoomTemp
const uint8_t kArgoMaxRoomTemp
Definition: ir_Argo.h:87
stdAc::opmode_t
opmode_t
Common A/C settings for A/C operating modes.
Definition: IRsend.h:46