Add MITSUBISHI_HEAVY_64 basic protocol support (RYD502A003B)

Adds basic send & decode support for the 64-bit Mitsubishi Heavy
Industries IR protocol used by the RYD502A003B remote (SRKxxAJ-S A/C,
the Chinese "Jinling" joint-venture units).

Scope is basic protocol support only (no IRac / AC-specifics), as
discussed in issue #2262.

Details:
- Lives in ir_MitsubishiHeavy.cpp/.h alongside the 88/152-bit variants
  and named MITSUBISHI_HEAVY_64, per maintainer request.
- Array/state style (uint8_t[8]) rather than a uint64_t, reusing the
  existing irutils::checkInvertedBytePairs() helper. The whole 8-byte
  frame is four inverted byte pairs (FF 00 | B2 ~B2 | B4 ~B4 | 2A D5),
  so there is no separate checksum byte.
- Bytes are sent/decoded LSB-first (MSBfirst=false), matching the
  remote's on-air byte values.
- Unit tests: 4 real captures (Cool 18/24/30, Off) + a send/decode
  round-trip + a bad-frame rejection test. Full temp/mode/fan capture
  set is recorded in issue #2262 for reference.

See #2262

Author: bluebirdlboro

SupportedProtocols.md

@@ -1,6 +1,6 @@
 <!--- WARNING: Do NOT edit this file directly.
       It is generated by './tools/scrape_supported_devices.py'.
-      Last generated: Fri 02 Jan 2026 11:00:57 +0000 --->
+      Last generated: Tue 16 Jun 2026 09:51:31 +0000 --->
 # IR Protocols supported by this library
 
 | Protocol | Brand | Model | A/C Model | Detailed A/C Support |
@@ -88,7 +88,7 @@
 | [Mirage](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_Mirage.cpp) | **[Tronitechnik](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_Mirage.h)** | KKG29A-C1 remote<BR>Reykir 9000 A/C | KKG29AC1<BR>KKG9AC1 | Yes |
 | [Mitsubishi](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_Mitsubishi.cpp) | **[Mitsubishi](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_Mitsubishi.h)** | HC3000 Projector (MITSUBISHI2)<BR>KM14A 0179213 remote<BR>MS-GK24VA A/C<BR>TV (MITSUBISHI) |  | Yes |
 | [Mitsubishi](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_Mitsubishi.cpp) | **[Mitsubishi Electric](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_Mitsubishi.h)** | 001CP T7WE10714 remote (MITSUBISHI136)<BR>KPOA remote (MITSUBISHI112)<BR>MLZ-RX5017AS A/C (MITSUBISHI_AC)<BR>MSH-A24WV A/C (MITSUBISHI112)<BR>MSZ-FHnnVE A/C (MITSUBISHI_AC)<BR>MSZ-GV2519 A/C (MITSUBISHI_AC)<BR>MSZ-SF25VE3 A/C (MITSUBISHI_AC)<BR>MSZ-ZW4017S A/C (MITSUBISHI_AC)<BR>MUH-A24WV A/C (MITSUBISHI112)<BR>PAR-FA32MA remote (MITSUBISHI136)<BR>PEAD-RP71JAA Ducted A/C (MITSUBISHI136)<BR>RH151 remote (MITSUBISHI_AC)<BR>RH151/M21ED6426 remote (MITSUBISHI_AC)<BR>SG153/M21EDF426 remote (MITSUBISHI_AC)<BR>SG15D remote (MITSUBISHI_AC) |  | Yes |
-| [MitsubishiHeavy](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_MitsubishiHeavy.cpp) | **[Mitsubishi Heavy Industries](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_MitsubishiHeavy.h)** | RKX502A001C remote (88 bit)<BR>RLA502A700B remote (152 bit)<BR>SRKxxZJ-S A/C (88 bit)<BR>SRKxxZM-S A/C (152 bit)<BR>SRKxxZMXA-S A/C (152 bit) |  | Yes |
+| [MitsubishiHeavy](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_MitsubishiHeavy.cpp) | **[Mitsubishi Heavy Industries](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_MitsubishiHeavy.h)** | RKX502A001C remote (88 bit)<BR>RLA502A700B remote (152 bit)<BR>RYD502A003B remote (64 bit)<BR>SRKxxAJ-S A/C (64 bit)<BR>SRKxxZJ-S A/C (88 bit)<BR>SRKxxZM-S A/C (152 bit)<BR>SRKxxZMXA-S A/C (152 bit) |  | Yes |
 | [Multibrackets](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_Multibrackets.cpp) | **Multibrackets** | Motorized Swing mount large - 4500 |  | - |
 | [NEC](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_NEC.cpp) | **[Aloka](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_NEC.h)** | SleepyLights LED Lamp |  | - |
 | [NEC](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_NEC.cpp) | **[BBK](https://github.com/crankyoldgit/IRremoteESP8266/blob/master/src/ir_NEC.h)** | SP550S 5.1 sound system |  | - |
@@ -229,6 +229,7 @@
 - MITSUBISHI2
 - MITSUBISHI_AC
 - MITSUBISHI_HEAVY_152
+- MITSUBISHI_HEAVY_64
 - MITSUBISHI_HEAVY_88
 - MULTIBRACKETS
 - MWM

keywords.txt

@@ -4596,3 +4596,6 @@ kZepealTolerance	LITERAL1
 kZepealZeroMark	LITERAL1
 kZepealZeroSpace	LITERAL1
 kZoneFollowStr	LITERAL1
+sendMitsubishiHeavy64	KEYWORD2
+decodeMitsubishiHeavy64	KEYWORD2
+MITSUBISHI_HEAVY_64	LITERAL1

src/IRrecv.cpp

@@ -1227,6 +1227,11 @@ bool IRrecv::decode(decode_results *results, irparams_t *save,
     DPRINTLN("Attempting Eurom decode");
     if (decodeEurom(results, offset, kEuromBits)) return true;
 #endif  // DECODE_EUROM
+#if DECODE_MITSUBISHI_HEAVY_64
+    DPRINTLN("Attempting Mitsubishi Heavy 64-bit decode");
+    if (decodeMitsubishiHeavy64(results, offset, kMitsubishiHeavy64Bits))
+      return true;
+#endif  // DECODE_MITSUBISHI_HEAVY_64
   // Typically new protocols are added above this line.
   }
 #if DECODE_HASH

src/IRrecv.h

@@ -898,6 +898,12 @@ class IRrecv {
                    const uint16_t nbits = kEuromBits,
                    const bool strict = true);
 #endif  // DECODE_EUROM
+#if DECODE_MITSUBISHI_HEAVY_64
+  bool decodeMitsubishiHeavy64(decode_results *results,
+                               uint16_t offset = kStartOffset,
+                               const uint16_t nbits = kMitsubishiHeavy64Bits,
+                               const bool strict = true);
+#endif  // DECODE_MITSUBISHI_HEAVY_64
 };
 
 #endif  // IRRECV_H_

src/IRremoteESP8266.h

@@ -976,6 +976,13 @@ typedef volatile const uint16_t atomic_const_uint16_t;
 #define SEND_EUROM           _IR_ENABLE_DEFAULT_
 #endif  // SEND_EUROM
 
+#ifndef DECODE_MITSUBISHI_HEAVY_64
+#define DECODE_MITSUBISHI_HEAVY_64   _IR_ENABLE_DEFAULT_
+#endif  // DECODE_MITSUBISHI_HEAVY_64
+#ifndef SEND_MITSUBISHI_HEAVY_64
+#define SEND_MITSUBISHI_HEAVY_64     _IR_ENABLE_DEFAULT_
+#endif  // SEND_MITSUBISHI_HEAVY_64
+
 #if (DECODE_ARGO || DECODE_DAIKIN || DECODE_FUJITSU_AC || DECODE_GREE || \
      DECODE_KELVINATOR || DECODE_MITSUBISHI_AC || DECODE_TOSHIBA_AC || \
      DECODE_TROTEC || DECODE_HAIER_AC || DECODE_HITACHI_AC || \
@@ -1164,8 +1171,9 @@ enum decode_type_t {
   YORK,
   BLUESTARHEAVY,
   EUROM,
+  MITSUBISHI_HEAVY_64,  // 2262
   // Add new entries before this one, and update it to point to the last entry.
-  kLastDecodeType = EUROM,
+  kLastDecodeType = MITSUBISHI_HEAVY_64,
 };
 
 // Message lengths & required repeat values
@@ -1356,6 +1364,9 @@ const uint16_t kMitsubishiHeavy88MinRepeat = kNoRepeat;
 const uint16_t kMitsubishiHeavy152StateLength = 19;
 const uint16_t kMitsubishiHeavy152Bits = kMitsubishiHeavy152StateLength * 8;
 const uint16_t kMitsubishiHeavy152MinRepeat = kNoRepeat;
+const uint16_t kMitsubishiHeavy64StateLength = 8;
+const uint16_t kMitsubishiHeavy64Bits = kMitsubishiHeavy64StateLength * 8;
+const uint16_t kMitsubishiHeavy64MinRepeat = kNoRepeat;
 const uint16_t kMultibracketsBits = 8;
 const uint16_t kMultibracketsDefaultRepeat = kSingleRepeat;
 const uint16_t kNikaiBits = 24;

src/IRsend.cpp

@@ -739,6 +739,8 @@ uint16_t IRsend::defaultBits(const decode_type_t protocol) {
       return kDaikin64Bits;
     case ELECTRA_AC:
       return kElectraAcBits;
+    case MITSUBISHI_HEAVY_64:
+      return kMitsubishiHeavy64Bits;
     case EUROM:
       return kEuromBits;
     case GREE:
@@ -1171,7 +1173,6 @@ bool IRsend::send(const decode_type_t type, const uint64_t data,
   return true;
 }
 
-/// Send a complex (>= 64 bits) IR message of a given type.
 /// An unknown/unsupported type will send nothing.
 /// @param[in] type Protocol number/type of the message you want to send.
 /// @param[in] state A pointer to the array of bytes that make up the state[].
@@ -1378,6 +1379,11 @@ bool IRsend::send(const decode_type_t type, const uint8_t *state,
       sendMitsubishiHeavy152(state, nbytes);
       break;
 #endif  // SEND_MITSUBISHIHEAVY
+#if SEND_MITSUBISHI_HEAVY_64
+    case MITSUBISHI_HEAVY_64:
+      sendMitsubishiHeavy64(state, nbytes);
+      break;
+#endif  // SEND_MITSUBISHI_HEAVY_64
 #if SEND_MWM
     case MWM:
       sendMWM(state, nbytes);

src/IRsend.h

@@ -924,6 +924,12 @@ class IRsend {
                  const uint16_t nbytes = kEuromStateLength,
                  const uint16_t repeat = kNoRepeat);
 #endif  // SEND_EUROM
+#if SEND_MITSUBISHI_HEAVY_64
+  void sendMitsubishiHeavy64(
+      const unsigned char data[],
+      const uint16_t nbytes = kMitsubishiHeavy64StateLength,
+      const uint16_t repeat = kNoRepeat);
+#endif  // SEND_MITSUBISHI_HEAVY_64
 
  protected:
 #ifdef UNIT_TEST

src/IRtext.cpp

@@ -563,6 +563,8 @@ IRTEXT_CONST_BLOB_DECL(kAllProtocolNamesStr) {
             D_STR_BLUESTARHEAVY, D_STR_UNSUPPORTED) "\x0"
     COND(DECODE_EUROM || SEND_EUROM,
             D_STR_EUROM, D_STR_UNSUPPORTED) "\x0"
+    COND(DECODE_MITSUBISHI_HEAVY_64 || SEND_MITSUBISHI_HEAVY_64,
+            D_STR_MITSUBISHI_HEAVY_64, D_STR_UNSUPPORTED) "\x0"
     ///< New protocol (macro) strings should be added just above this line.
     "\x0"  ///< This string requires double null termination.
 };

src/IRutils.cpp

@@ -205,6 +205,7 @@ bool hasACState(const decode_type_t protocol) {
     case MITSUBISHI136:
     case MITSUBISHI112:
     case MITSUBISHI_AC:
+    case MITSUBISHI_HEAVY_64:
     case MITSUBISHI_HEAVY_88:
     case MITSUBISHI_HEAVY_152:
     case MWM:

src/ir_MitsubishiHeavy.cpp

@@ -28,6 +28,15 @@ const uint16_t kMitsubishiHeavyOneSpace = 420;
 const uint16_t kMitsubishiHeavyZeroSpace = 1220;
 const uint32_t kMitsubishiHeavyGap = kDefaultMessageGap;  // Just a guess.
 
+// Timing for the 64-bit "Jinling" variant (RYD502A003B remote).
+// @see https://github.com/crankyoldgit/IRremoteESP8266/issues/2262
+const uint16_t kMitsubishiHeavy64HdrMark = 5950;
+const uint16_t kMitsubishiHeavy64HdrSpace = 7475;
+const uint16_t kMitsubishiHeavy64BitMark = 508;
+const uint16_t kMitsubishiHeavy64OneSpace = 3454;
+const uint16_t kMitsubishiHeavy64ZeroSpace = 1496;
+const uint16_t kMitsubishiHeavy64Gap = 7422;
+
 using irutils::addBoolToString;
 using irutils::addIntToString;
 using irutils::addLabeledString;
@@ -70,6 +79,27 @@ void IRsend::sendMitsubishiHeavy152(const unsigned char data[],
 }
 #endif  // SEND_MITSUBISHIHEAVY
 
+#if SEND_MITSUBISHI_HEAVY_64
+/// Send a MitsubishiHeavy 64-bit (RYD502A003B remote) A/C message.
+/// Status: STABLE / Confirmed working with a real remote.
+/// @param[in] data The message (8 bytes) to be sent.
+/// @param[in] nbytes The number of bytes of message to be sent.
+/// @param[in] repeat The number of times the command is to be repeated.
+/// @note The whole frame is four inverted byte pairs, so it carries no
+///   separate checksum byte. The bytes are sent LSB-first.
+void IRsend::sendMitsubishiHeavy64(const unsigned char data[],
+                                   const uint16_t nbytes,
+                                   const uint16_t repeat) {
+  if (nbytes < kMitsubishiHeavy64StateLength)
+    return;  // Not enough bytes to send a proper message.
+  sendGeneric(kMitsubishiHeavy64HdrMark, kMitsubishiHeavy64HdrSpace,
+              kMitsubishiHeavy64BitMark, kMitsubishiHeavy64OneSpace,
+              kMitsubishiHeavy64BitMark, kMitsubishiHeavy64ZeroSpace,
+              kMitsubishiHeavy64BitMark, kMitsubishiHeavy64Gap,
+              data, nbytes, 38000, false, repeat, kDutyDefault);
+}
+#endif  // SEND_MITSUBISHI_HEAVY_64
+
 // Class for decoding and constructing MitsubishiHeavy152 AC messages.
 
 /// Class constructor
@@ -1048,3 +1078,51 @@ bool IRrecv::decodeMitsubishiHeavy(decode_results* results, uint16_t offset,
   return true;
 }
 #endif  // DECODE_MITSUBISHIHEAVY
+
+#if DECODE_MITSUBISHI_HEAVY_64
+/// Decode the supplied MitsubishiHeavy 64-bit (RYD502A003B remote) message.
+/// Status: STABLE / Confirmed working with a real remote.
+/// @param[in,out] results Ptr to the data to decode & where to store the decode
+/// @param[in] offset The starting index to use when attempting to decode the
+///   raw data. Typically/Defaults to kStartOffset.
+/// @param[in] nbits The number of data bits to expect.
+/// @param[in] strict Flag indicating if we should perform strict matching.
+/// @return True if it can decode it, false if it can't.
+/// @note Unlike the 88/152-bit variants, this frame is one block of four
+///   inverted byte pairs: `FF 00 | B2 ~B2 | B4 ~B4 | 2A D5`.
+bool IRrecv::decodeMitsubishiHeavy64(decode_results* results, uint16_t offset,
+                                     const uint16_t nbits, const bool strict) {
+  if (strict && nbits != kMitsubishiHeavy64Bits)
+    return false;  // Not what is expected.
+
+  uint16_t used = matchGeneric(results->rawbuf + offset, results->state,
+                               results->rawlen - offset, nbits,
+                               kMitsubishiHeavy64HdrMark,
+                               kMitsubishiHeavy64HdrSpace,
+                               kMitsubishiHeavy64BitMark,
+                               kMitsubishiHeavy64OneSpace,
+                               kMitsubishiHeavy64BitMark,
+                               kMitsubishiHeavy64ZeroSpace,
+                               kMitsubishiHeavy64BitMark,
+                               kMitsubishiHeavy64Gap, true,
+                               _tolerance, 0, false);
+  if (used == 0) return false;
+
+  // Compliance
+  if (strict) {
+    // The whole frame is four inverted byte pairs (it has no separate
+    // checksum), so every second byte must be the complement of the first.
+    if (!checkInvertedBytePairs(results->state, kMitsubishiHeavy64StateLength))
+      return false;
+    // Fixed header & footer signature bytes. The pair check above implies
+    // state[1] == 0x00 and state[7] == 0xD5.
+    if (results->state[0] != 0xFF || results->state[6] != 0x2A) return false;
+  }
+
+  // Success
+  results->decode_type = MITSUBISHI_HEAVY_64;
+  results->bits = nbits;
+  // No need to record the state as we stored it as we decoded it.
+  return true;
+}
+#endif  // DECODE_MITSUBISHI_HEAVY_64