ir_Sanyo.h

Go to the documentation of this file.

// Copyright 2020-2021 David Conran
 
 
// Supports:
//   Brand: Sanyo,  Model: SA 8650B - disabled
//   Brand: Sanyo,  Model: LC7461 transmitter IC (SANYO_LC7461)
//   Brand: Sanyo,  Model: SAP-K121AHA A/C (SANYO_AC)
//   Brand: Sanyo,  Model: RCS-2HS4E remote (SANYO_AC)
//   Brand: Sanyo,  Model: SAP-K242AH A/C (SANYO_AC)
//   Brand: Sanyo,  Model: RCS-2S4E remote (SANYO_AC)
//   Brand: Sanyo,  Model: RCS-4MHVPIS4EE remote (SANYO_AC152)
//   Brand: Sanyo,  Model: SAP-KMRV124EHE A/C (SANYO_AC152)
 
#ifndef IR_SANYO_H_
#define IR_SANYO_H_
 
#define __STDC_LIMIT_MACROS
#include <stdint.h>
#ifdef ARDUINO
#include <Arduino.h>
#endif
#include "IRremoteESP8266.h"
#include "IRsend.h"
#ifdef UNIT_TEST
#include "IRsend_test.h"
#endif
 
union SanyoProtocol{
  uint8_t raw[kSanyoAcStateLength];  
  // Ref: https://docs.google.com/spreadsheets/d/1dYfLsnYvpjV-SgO8pdinpfuBIpSzm8Q1R5SabrLeskw/edit?usp=sharing
  struct {
    // Byte 0
    uint8_t :8;  // 0x6A (Fixed?)
    // Byte 1
    uint8_t Temp :5;
    uint8_t      :3;
    // Byte 2
    uint8_t SensorTemp :5;
    uint8_t Sensor     :1;  
    uint8_t Beep       :1;
    uint8_t            :1;
    // Byte 3
    uint8_t OffHour :4;
    uint8_t         :4;
    // Byte 4
    uint8_t Fan      :2;
    uint8_t OffTimer :1;
    uint8_t          :1;
    uint8_t Mode     :3;
    uint8_t          :1;
    // Byte 5
    uint8_t SwingV :3;
    uint8_t        :3;
    uint8_t Power  :2;
    // Byte 6
    uint8_t       :3;
    uint8_t Sleep :1;
    uint8_t       :4;
    // Byte 7
    uint8_t :8;
    // Byte 8
    uint8_t Sum :8;
  };
};
 
// Constants
 
const uint8_t kSanyoAcTempMin = 16;    
const uint8_t kSanyoAcTempMax = 30;    
const uint8_t kSanyoAcTempDelta = 4;   
 
const uint8_t kSanyoAcHourMax = 15;       
 
const uint8_t kSanyoAcHeat = 1;        
const uint8_t kSanyoAcCool = 2;        
const uint8_t kSanyoAcDry =  3;        
const uint8_t kSanyoAcAuto = 4;        
const uint8_t kSanyoAcFanAuto =   0;   
const uint8_t kSanyoAcFanHigh =   1;   
const uint8_t kSanyoAcFanLow =    2;   
const uint8_t kSanyoAcFanMedium = 3;   
 
// const uint8_t kSanyoAcPowerStandby =           0b00;  ///< Standby?
const uint8_t kSanyoAcPowerOff =                  0b01;  
const uint8_t kSanyoAcPowerOn =                   0b10;  
const uint8_t kSanyoAcSwingVAuto =         0;  
const uint8_t kSanyoAcSwingVLowest =       2;  
const uint8_t kSanyoAcSwingVLow =          3;  
const uint8_t kSanyoAcSwingVLowerMiddle =  4;  
const uint8_t kSanyoAcSwingVUpperMiddle =  5;  
const uint8_t kSanyoAcSwingVHigh =         6;  
const uint8_t kSanyoAcSwingVHighest =      7;  
 
// Classes
class IRSanyoAc {
 public:
  explicit IRSanyoAc(const uint16_t pin, const bool inverted = false,
                     const bool use_modulation = true);
  void stateReset(void);
#if SEND_SANYO_AC
  void send(const uint16_t repeat = kNoRepeat);
  int8_t calibrate(void) { return _irsend.calibrate(); }
#endif  // SEND_SANYO_AC
  void begin(void);
  void on(void);
  void off(void);
  void setPower(const bool on);
  bool getPower(void) const;
  void setTemp(const uint8_t degrees);
  uint8_t getTemp(void) const;
  void setSensorTemp(const uint8_t degrees);
  uint8_t getSensorTemp(void) const;
  void setFan(const uint8_t speed);
  uint8_t getFan(void) const;
  void setMode(const uint8_t mode);
  uint8_t getMode(void) const;
  void setSleep(const bool on);
  bool getSleep(void) const;
  void setSensor(const bool location);
  bool getSensor(void) const;
  void setBeep(const bool on);
  bool getBeep(void) const;
  void setSwingV(const uint8_t setting);
  uint8_t getSwingV(void) const;
  void setRaw(const uint8_t newState[]);
  uint8_t* getRaw(void);
  uint16_t getOffTimer(void) const;
  void setOffTimer(const uint16_t mins);
  static bool validChecksum(const uint8_t state[],
                            const uint16_t length = kSanyoAcStateLength);
  static uint8_t convertMode(const stdAc::opmode_t mode);
  static uint8_t convertFan(const stdAc::fanspeed_t speed);
  static uint8_t convertSwingV(const stdAc::swingv_t position);
  static stdAc::opmode_t toCommonMode(const uint8_t mode);
  static stdAc::fanspeed_t toCommonFanSpeed(const uint8_t speed);
  static stdAc::swingv_t toCommonSwingV(const uint8_t setting);
  stdAc::state_t toCommon(void) const;
  String toString(void) const;
#ifndef UNIT_TEST
 
 private:
  IRsend _irsend;  
#else  // UNIT_TEST
  IRsendTest _irsend;  
#endif  // UNIT_TEST
  SanyoProtocol _;
  void checksum(void);
  static uint8_t calcChecksum(const uint8_t state[],
                              const uint16_t length = kSanyoAcStateLength);
};
 
const uint8_t kSanyoAc88Auto     = 0;  
const uint8_t kSanyoAc88FeelCool = 1;  
const uint8_t kSanyoAc88Cool     = 2;  
const uint8_t kSanyoAc88FeelHeat = 3;  
const uint8_t kSanyoAc88Heat     = 4;  
const uint8_t kSanyoAc88Fan     =  5;  
 
const uint8_t kSanyoAc88TempMin = 10;  
const uint8_t kSanyoAc88TempMax = 30;  
 
const uint8_t kSanyoAc88FanAuto =   0;  
const uint8_t kSanyoAc88FanLow =    1;  
const uint8_t kSanyoAc88FanMedium = 2;  
const uint8_t kSanyoAc88FanHigh =   3;  
 
union SanyoAc88Protocol{
  uint8_t raw[kSanyoAc88StateLength];  
  // Ref: https://docs.google.com/spreadsheets/d/1weUmGAsEpfX38gg5rlDN69Uchnbr6gQl9FqHffLBIRk/edit#gid=0
  struct {
    // Byte 0-1
    uint8_t                  :8;  // 0xAA (Fixed?)
    uint8_t                  :8;  // 0x55 (Fixed?)
    // Byte 2
    uint8_t Fan              :2;
    uint8_t                  :2;
    uint8_t Mode             :3;
    uint8_t Power            :1;
    // Byte 3
    uint8_t Temp             :5;
    uint8_t Filter           :1;
    uint8_t SwingV           :1;
    uint8_t                  :1;
    // Byte 4
    uint8_t ClockSecs        :8;  // Nr. of Seconds
    // Byte 5
    uint8_t ClockMins        :8;  // Nr. of Minutes
    // Byte 6
    uint8_t ClockHrs         :8;  // Nr. of Hours
    // Byte 7-9  (Timer times?)
    uint8_t                  :8;
    uint8_t                  :8;
    uint8_t                  :8;
    // Byte 10
    uint8_t                  :3;
    uint8_t Turbo            :1;
    uint8_t EnableStartTimer :1;
    uint8_t EnableStopTimer  :1;
    uint8_t Sleep            :1;
    uint8_t                  :1;
  };
};
 
// Classes
class IRSanyoAc88 {
 public:
  explicit IRSanyoAc88(const uint16_t pin, const bool inverted = false,
                       const bool use_modulation = true);
  void stateReset(void);
#if SEND_SANYO_AC88
  void send(const uint16_t repeat = kSanyoAc88MinRepeat);
  int8_t calibrate(void) { return _irsend.calibrate(); }
#endif  // SEND_SANYO_AC88
  void begin(void);
  void on(void);
  void off(void);
  void setPower(const bool on);
  bool getPower(void) const;
  void setTemp(const uint8_t degrees);
  uint8_t getTemp(void) const;
  void setFan(const uint8_t speed);
  uint8_t getFan(void) const;
  void setMode(const uint8_t mode);
  uint8_t getMode(void) const;
  void setSleep(const bool on);
  bool getSleep(void) const;
  void setTurbo(const bool on);
  bool getTurbo(void) const;
  void setFilter(const bool on);
  bool getFilter(void) const;
  void setSwingV(const bool on);
  bool getSwingV(void) const;
  uint16_t getClock(void) const;
  void setClock(const uint16_t mins_since_midnight);
  void setRaw(const uint8_t newState[]);
  uint8_t* getRaw(void);
  static uint8_t convertMode(const stdAc::opmode_t mode);
  static 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) const;
  String toString(void) const;
#ifndef UNIT_TEST
 
 private:
  IRsend _irsend;  
#else  // UNIT_TEST
  IRsendTest _irsend;  
#endif  // UNIT_TEST
  SanyoAc88Protocol _;
  void checksum(void);
  static uint8_t calcChecksum(const uint8_t state[],
                              const uint16_t length = kSanyoAcStateLength);
};
#endif  // IR_SANYO_H_