Add Cellular Tracking Technologies Life/Power/HybridTag Support

README.md

@@ -367,6 +367,7 @@ See [CONTRIBUTING.md](./docs/CONTRIBUTING.md).
     [279]  Nexus, CRX, Prego sauna temperature sensor
     [280]  Homelead HG9901 (Geevon, Dr.Meter, Royal Gardineer) soil moisture/temp/light level sensor
     [281]  Maverick XR-50 BBQ Sensor
+    [282]  Cellular Tracking Technologies LifeTag/PowerTag/HybridTag
 
 * Disabled by default, use -R n or a conf file to enable
 

conf/rtl_433.example.conf

@@ -520,6 +520,7 @@ convert si
   protocol 279 # Nexus, CRX, Prego sauna temperature sensor
   protocol 280 # Homelead HG9901 (Geevon, Dr.Meter, Royal Gardineer) soil moisture/temp/light level sensor
   protocol 281 # Maverick XR-50 BBQ Sensor
+  protocol 282 # Cellular Tracking Technologies LifeTag/PowerTag/HybridTag
 
 ## Flex devices (command line option "-X")
 

include/rtl_433_devices.h

@@ -289,6 +289,7 @@
     DECL(nexus_sauna) \
     DECL(homelead_hg9901) \
     DECL(maverick_xr50) \
+    DECL(ctt_life_power_hybrid) \
 
     /* Add new decoders here. */
 

src/CMakeLists.txt

@@ -86,6 +86,7 @@ add_library(r_433 STATIC
     devices/cmr113.c
     devices/companion_wtr001.c
     devices/cotech_36_7959.c
+    devices/ctt_life_power_hybrid.c
     devices/current_cost.c
     devices/danfoss.c
     devices/deltadore_x3d.c

src/devices/ctt_life_power_hybrid.c

@@ -0,0 +1,138 @@
+/** @file
+    Cellular Tracking Technologies (CTT) LifeTag/PowerTag/HybridTag.
+
+    Copyright (C) 2025 Jonathan Caicedo <[email protected]>
+    Credit to https://github.com/tve for the CTT tag implementation details via their work on RadioJay (https://radiojay.org/) and Motus Test Tags (https://github.com/tve/motus-test-tags).
+
+    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.
+*/
+/**
+Cellular Tracking Technologies (https://celltracktech.com/) LifeTag/PowerTag/HybridTag.
+
+The CTT LifeTag/PowerTag/HybridTag is a lightweight transmitter used for wildlife tracking and research - most commonly used with the Motus Wildlife Tracking System (https://motus.org/).
+The tags transmit a unique identifier (ID) at a fixed bitrate of 25 kbps using Frequency Shift Keying (FSK) modulation on 434 MHz.
+
+The packet format consists of:
+
+    • PREAMBLE: 24 bits of alternating 1/0 (0xAA if byte-aligned) for receiver bit-clock sync (preamble length can be shorter, depending on hardware)
+    • SYNC:     2 bytes fixed pattern 0xD3, 0x91 marking the packet start
+    • ID:       20-bit tag ID encoded into 4 bytes (5 bits per byte) using a 32-entry dictionary
+    • CRC:      1-byte SMBus CRC-8 over the 4 encoded ID bytes
+
+    AA AA AA   D3 91   78 55 4C 33   58
+   |--------| |-----| |-----------| |--|
+    Preamble   Sync        ID       CRC
+
+    A beep is a single packet.
+
+    LifeTag - programmed with a standard 5-second beep rate.
+    PowerTag - user-defined beep rate
+    HybridTag - transmits a beep every 2-15 seconds
+
+There's a 20-bit subset of the 32-bit ID space set aside for Motus tag use. We set `valid_motus` to true if all 4 bytes of the ID are present in the Motus code dictionary.
+However, `valid_motus` not being set doesn't mean that a tag is invalid, just that it's not recognized as a tag used with Motus.
+
+*/
+
+#include "decoder.h"
+
+static const uint8_t sync[2] = {0xD3, 0x91};
+
+static const uint8_t motus_code[32] = {
+        0x00, 0x07, 0x19, 0x1E, 0x2A, 0x2D, 0x33, 0x34,
+        0x4B, 0x4C, 0x52, 0x55, 0x61, 0x66, 0x78, 0x7F,
+        0x80, 0x87, 0x99, 0x9E, 0xAA, 0xAD, 0xB3, 0xB4,
+        0xCB, 0xCC, 0xD2, 0xD5, 0xE1, 0xE6, 0xF8, 0xFF};
+
+// Helper: check if a byte is in motus_code
+static int byte_in_motus_code(uint8_t b)
+{
+    for (int j = 0; j < 32; ++j) {
+        if (b == motus_code[j])
+            return 1;
+    }
+    return 0;
+}
+
+static int ctt_decode(r_device *decoder, bitbuffer_t *bitbuffer)
+{
+    data_t *data;
+    int events = 0;
+
+    // Expect at least sync + payload (56 bits), but allow extra (e.g., preamble)
+    const int min_bits = 56;
+
+    for (int row = 0; row < bitbuffer->num_rows; ++row) {
+        if (bitbuffer->bits_per_row[row] < min_bits) {
+            continue; // DECODE_ABORT_LENGTH?
+        }
+
+        // Search for sync (allow 0 bit errors initially; increase to 2 for noisy signals)
+        unsigned sync_pos = bitbuffer_search(bitbuffer, row, 0, sync, 16); // 2 bytes = 16 bits
+
+        if (sync_pos >= bitbuffer->bits_per_row[row]) {
+            continue; // DECODE_ABORT_EARLY?
+        }
+
+        // Ensure enough bits after sync for ID (4B) + CRC (1B) = 40 bits
+        if (sync_pos + 16 + 40 > bitbuffer->bits_per_row[row]) {
+            continue; // DECODE_ABORT_EARLY?
+        }
+
+        // Extract 5 bytes after sync
+        uint8_t payload[5];
+        bitbuffer_extract_bytes(bitbuffer, row, sync_pos + 16, payload, 40);
+
+        // SMBus CRC-8
+        if (crc8(payload, 5, 0x07, 0x00) != 0) {
+            decoder_logf(decoder, 2, __func__, "CRC fail (calc 0x%02X != rx 0x%02X)", crc8(payload, 5, 0x07, 0x00), 0);
+            return DECODE_FAIL_SANITY; // Integrity check failed - no point in continuing
+        }
+
+        uint32_t id = (payload[0] << 24) | (payload[1] << 16) | (payload[2] << 8) | payload[3];
+
+        // Check if all 4 bytes are present in motus_code - this tips us off that the tag is valid for Motus use
+        int motus_tag =
+                byte_in_motus_code(payload[0]) &&
+                byte_in_motus_code(payload[1]) &&
+                byte_in_motus_code(payload[2]) &&
+                byte_in_motus_code(payload[3]);
+
+        /* clang-format off */
+        data = data_make(
+            "model",       "",                        DATA_STRING, "CTT - Life/Power/Hybrid Tag",
+            "id",          "Tag ID",                  DATA_FORMAT, "0x%08X", DATA_INT, id,
+            "valid_motus", "Valid Motus tag",         DATA_INT, motus_tag,
+            "mic",         "Integrity",               DATA_STRING, "CRC",
+            NULL);
+        /* clang-format on */
+
+        decoder_output_data(decoder, data);
+        events++;
+    }
+
+    return events;
+}
+
+static const char *output_fields[] = {
+        "model",
+        "id",
+        "valid_motus",
+        "mic",
+        NULL,
+};
+
+r_device const ctt_life_power_hybrid = {
+        .name       = "Cellular Tracking Technologies LifeTag/PowerTag/HybridTag",
+        .modulation = FSK_PULSE_PCM,
+        /* at BR=25 kbps, bit_time=40µs*/
+        .short_width = 40,
+        .long_width  = 40,
+        .reset_limit = 500, /* 500 µs: slightly above max run of 0's */
+        .decode_fn   = &ctt_decode,
+        .fields      = output_fields,
+        .disabled    = 0,
+};