Add support for TFA Dostmann 14.1504 Radio-controlled grill and meat thermometer (merbanan#2296)

Co-authored-by: root@rpi <[email protected]>

Author: 2 people

README.md

@@ -314,6 +314,7 @@ See [CONTRIBUTING.md](./docs/CONTRIBUTING.md).
     [229]* WEC-2103 temperature/humidity sensor
     [230]  Vauno EN8822C
     [231]  Govee Water Leak Detector H5054
+    [232]  TFA Dostmann 14.1504.V2 Radio-controlled grill and meat thermometer
 
 * Disabled by default, use -R n or a conf file to enable
 

conf/rtl_433.example.conf

@@ -447,12 +447,14 @@ stop_after_successful_events false
   protocol 223 # Badger ORION water meter, 100kbps (-f 916.45M -s 1200k)
   protocol 224 # GEO minim+ energy monitor
   protocol 225 # TyreGuard 400 TPMS
+<<<<<<< HEAD
   protocol 226 # Kia TPMS (-s 1000k)
   protocol 227 # SRSmith Pool Light Remote Control SRS-2C-TX (-f 915M)
   protocol 228 # Neptune R900 flow meters
 # protocol 229 # WEC-2103 temperature/humidity sensor
   protocol 230 # Vauno EN8822C
   protocol 231 # Govee Water Leak Detector H5054
+  protocol 232 # TFA Dostmann 14.1504.V2 Radio-controlled grill and meat thermometer
 
 ## Flex devices (command line option "-X")
 

include/rtl_433_devices.h

@@ -239,6 +239,7 @@
     DECL(wec2103) \
     DECL(vauno_en8822c) \
     DECL(govee_h5054) \
+    DECL(tfa_14_1504_v2) \
 
     /* Add new decoders here. */
 

src/CMakeLists.txt

@@ -206,6 +206,7 @@ add_library(r_433 STATIC
     devices/srsmith_pool_srs_2c_tx.c
     devices/steelmate.c
     devices/telldus_ft0385r.c
+    devices/tfa_14_1504_v2.c
     devices/tfa_30_3196.c
     devices/tfa_30_3221.c
     devices/tfa_drop_30.3233.c

src/devices/tfa_14_1504_v2.c

@@ -0,0 +1,139 @@
+/** @file
+    Decoder for TFA Dostmann 14.1504.V2 (30.3254.01)
+    Radio-controlled grill and meat thermometer
+
+    Copyright (C) 2022-2023 Joël Bourquard <[email protected]>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+*/
+
+/**
+Decoder for TFA Dostmann 14.1504.V2 (30.3254.01)
+
+CAUTION: Do not confuse with TFA Dostmann 14.1504 (30.3201) which had a completely different protocol => [71] Maverick ET-732/733 BBQ Sensor
+
+Payload format:
+- Preamble         {36} 0x7aaaaaa5c (for robustness we only use the tail: {24}0xaaaa5c)
+- Flags            {4}  OR between: 0x2=battery ok, 0x5=resync button
+- Temperature      {12} Raw temperature value. Temperature in ºC = (value/4)-532. Example: 0x8a0 = 20 ºC
+- Separator        {8}  0xff (differs if resync)
+- Digest           {16} 16-bit LFSR digest + final XOR
+
+To get raw data:
+```
+rtl_433 -R 0 -X 'n=TFA-141504v2,m=FSK_PCM,s=360,l=360,r=4096,preamble={24}aaaa5c'
+```
+
+Example payloads (excluding preamble):
+- Resync   = 7052f9cee3 (encoding differs from temperature readings => not handled)
+- No probe = 2700ffb791 (just like a temperature reading => in this case we report the appropriate probe status and no temperature reading)
+- ...
+- 20 ºC    = 28a0ffce69
+- 21 ºC    = 28a4ffa0f5
+- ...
+- 24 ºC    = 28b0ff6438
+- ...
+- 44 ºC    = 2900ff8c9d
+- ...
+*/
+
+#include "decoder.h"
+
+#define NUM_BITS_PREAMBLE 24
+#define NUM_BYTES_DATA    5
+#define OFFSET_MIC        (NUM_BYTES_DATA - 2)
+#define NUM_BITS_DATA     (NUM_BYTES_DATA * 8)
+#define NUM_BITS_TOTAL    (NUM_BITS_PREAMBLE + NUM_BITS_DATA)
+#define NUM_BITS_MAX      (NUM_BITS_TOTAL + 12)
+
+static int tfa_14_1504_v2_callback(r_device *decoder, bitbuffer_t *bitbuffer)
+{
+    uint8_t const preamble[] = {
+            0xaa, 0xaa, 0x5c,
+    };
+
+    if (bitbuffer->num_rows != 1) {
+        return DECODE_ABORT_EARLY;
+    }
+    unsigned const row = 0;
+
+    // Optional optimization: Early exit if row too short
+    if (bitbuffer->bits_per_row[row] < NUM_BITS_TOTAL) {
+        return DECODE_ABORT_EARLY; // considered "early" because preamble not checked
+    }
+
+    // Sync on preamble
+    unsigned start_pos = bitbuffer_search(bitbuffer, row, 0, preamble, NUM_BITS_PREAMBLE);
+
+    if (start_pos == bitbuffer->bits_per_row[row]) {
+        return DECODE_ABORT_EARLY; // no preamble detected
+    }
+
+    const unsigned available_bits = bitbuffer->bits_per_row[row] - start_pos;
+
+    // check min length
+    if (available_bits < NUM_BITS_TOTAL ||
+            available_bits > NUM_BITS_MAX) {
+        return DECODE_ABORT_LENGTH;
+    }
+
+    uint8_t data[NUM_BYTES_DATA];
+    bitbuffer_extract_bytes(bitbuffer, row, start_pos + NUM_BITS_PREAMBLE, data, NUM_BITS_DATA);
+
+    uint8_t flags = data[0] >> 4;
+    // ignore resync button
+    if ((flags & 0x5) == 0x5) {
+        return DECODE_FAIL_SANITY;
+    }
+    unsigned battery_ok = (flags & 0x2) != 0;
+
+    if (data[2] != 0xff) {
+        return DECODE_FAIL_SANITY;
+    }
+
+    uint16_t calc_mic = lfsr_digest16(data, OFFSET_MIC, 0x8810, 0x0d42) ^ 0x16eb;
+    uint16_t data_mic = (data[OFFSET_MIC] << 8) + data[OFFSET_MIC+1];
+    if (calc_mic != data_mic) {
+        return DECODE_FAIL_MIC;
+    }
+
+    // we discard the last 2 bits as those are always zero
+    uint16_t raw_temp_c = ((data[0] & 0xf) << 6) + (data[1] >> 2);
+    unsigned is_probe_connected = (raw_temp_c != 0x1c0);
+    float temp_c = ((int)raw_temp_c) - 532;
+
+    /* clang-format off */
+    data_t *output = data_make(
+            "model",            "",                 DATA_STRING,    "TFA-141504v2",
+            "battery_ok",       "Battery",          DATA_INT,       battery_ok,
+            "probe_fail",       "Probe failure",    DATA_INT,       !is_probe_connected,
+            "temperature_C",    "Temperature",      DATA_COND,      is_probe_connected,     DATA_FORMAT,    "%.0f C",   DATA_DOUBLE,    temp_c,
+            "mic",              "Integrity",        DATA_STRING,    "CRC",
+            NULL);
+    /* clang-format on */
+
+    decoder_output_data(decoder, output);
+    return 1;
+}
+
+static char *output_fields[] = {
+        "model",
+        "battery_ok",
+        "probe_fail",
+        "temperature_C",
+        "mic",
+        NULL,
+};
+
+r_device tfa_14_1504_v2 = {
+        .name        = "TFA Dostmann 14.1504.V2 Radio-controlled grill and meat thermometer",
+        .modulation  = FSK_PULSE_PCM,
+        .short_width = 360,
+        .long_width  = 360,
+        .reset_limit = 4096,
+        .decode_fn   = &tfa_14_1504_v2_callback,
+        .fields      = output_fields,
+};