Add samples for WallarGe CLTX001

tests/WallarGe/CLTX001/01/test_1_433.92M_1000k.json

@@ -0,0 +1 @@
+{ "model": "WallarGe-CLTX001", "id": 12345, "channel": 1, "temperature_C":  12.300, "mic": "CHECKSUM" }

tests/WallarGe/CLTX001/01/test_2_433.92M_1000k.json

@@ -0,0 +1 @@
+{ "model": "WallarGe-CLTX001", "id": 12345, "channel": 1, "temperature_C":  12.300, "mic": "CHECKSUM" }

tests/WallarGe/CLTX001/01/test_3_433.92M_1000k.json

@@ -0,0 +1 @@
+{ "model": "WallarGe-CLTX001", "id": 12345, "channel": 2, "battery_ok": 0, "temperature_C": -12.300, "mic": "CHECKSUM" }

tests/WallarGe/CLTX001/01/test_4_433.92M_1000k.json

@@ -0,0 +1 @@
+{ "model": "WallarGe-CLTX001", "id": 54321, "channel": 3, "temperature_C":   0.000, "test": 1, "mic": "CHECKSUM" }

tests/WallarGe/CLTX001/README.md

@@ -0,0 +1,64 @@
+# WallarGe CLTX001 (Outdoor Temperature Sensor)
+
+FCC ID: [2AYIQ-TX100](https://fcc.report/FCC-ID/2AYIQ-TX100)
+
+Can be purchased individually ([Amazon.com](https://www.amazon.com/dp/B0CB17H77R/))
+or bundled with WallarGe clocks like the CL6007 ([Amazon.com](https://www.amazon.com/dp/B0D9BNSQCS))
+and CL7001 ([Amazon.com](https://www.amazon.com/dp/B0BYNJW532), [US-WallarGe.com](http://www.us-wallarge.com/item/3015.html)).
+
+## Test Files
+
+The provided recordings are faithful recreations of the kind of signals the CLTX001 transmits, emitted using a [D-LIFE 433.92 MHz transmitter module](https://www.amazon.com/dp/B0BZRRBBNK) and recorded with rtl_433. Both the CL6007 and CL7001 clocks interpret these signals as expected. Note that the original transmitter shows less overshoot and has a cleaner waveform than these recordings.
+
+| Test | Files                                                                    | Sensor ID | Channel | Low Battery | Temperature | Test Mode |
+| ---- | ------------------------------------------------------------------------ | --------- | ------- | ----------- | ----------- | --------- |
+|    1 | [CU8](01/test_1_433.92M_1000k.cu8), [JSON](01/test_1_433.92M_1000k.json) |     12345 | 1       |             |      12.3°C |           |
+|    2 | [CU8](01/test_2_433.92M_1000k.cu8), [JSON](01/test_2_433.92M_1000k.json) |     12345 | 1       |             |      12.3°C |           |
+|    3 | [CU8](01/test_3_433.92M_1000k.cu8), [JSON](01/test_3_433.92M_1000k.json) |     12345 | 2       | Yes         |     -12.3°C |           |
+|    4 | [CU8](01/test_4_433.92M_1000k.cu8), [JSON](01/test_4_433.92M_1000k.json) |     54321 | 3       |             |       0.0°C | Yes       |
+
+**Test 1:** The kind of signal sent right after changing the channel on the sensor, including a recreation of [a bug](#bugs) in the transmitter.<br>
+The pulse in the preamble is too short for rtl_433 and therefore has no effect. The last bit in the payload being 0 creates an additional gap that exceeds the gap limit of 650 µs, resulting in a second empty row between rows with data.
+
+**Test 2:** Same as test 1, but matching the kind of signal sent periodically, including a recreation of [three bugs](#bugs) in the transmitter, causing the second and fifth transmission of the payload to be spread across two rows each.<br>
+The pulse in the preamble is too short for rtl_433 and therefore has no effect. The last bit in the payload being 0 creates an additional gap that exceeds the gap limit of 650 µs, resulting in a second empty row between rows with data.
+
+**Test 3:** Example with a different channel, a negative temperature and a low battery.<br>
+The pulse in the preamble is long enough for rtl_433 to register, resulting in an extra leading row with a single bit. The last bit in the payload is a 1, resulting in only a single empty row between rows with data.
+
+**Test 4:** Example with a different sensor ID, channel, temperature: 0°C and test mode enabled. In test mode, the clock keeps the receiver on after receiving a signal instead of conserving battery life until the next expected transmission.<br>
+The pulse in the preamble is long enough for rtl_433 to register, resulting in an extra leading row with a single bit. The last bit in the payload is a 1, resulting in only a single empty row between rows with data.
+
+## Photos
+![](image_1_front.jpg "Front view")
+![](image_2_back_closed.jpg "Back view")
+![](image_3_back_open.jpg "Back view with battery cover removed")
+![](image_4_plate.jpg "Front plate from behind")
+![](image_5_plate_opening.jpg "Opening in front plate")
+![](image_6_internal.jpg "Internals")
+![](image_7_pcb.jpg "PCB Closeup")
+
+## Bugs
+
+The CLTX001 sensor has been observed to skip ahead at times by 250 µs and even flip bits, especially when transmitting periodically instead of after changing the channel. Three such instances are highlighted below using [Universal Radio Hacker](https://github.com/jopohl/urh).
+
+When looking at the recordings with Universal Radio Hacker, make sure the sample rate is set to 1M (Blue "i" icon). Set Samples/Symbol to 250 and Pause Threshold to 2 (wrench icon next to the Modulation dropdown menu). 
+
+Generally, 110 = 1 and 100 = 0 for this protocol, but due to the long=0 and short=1 convention, rtl_433 interprets these as 110 = 0 and 100 = 1, requiring inversion of the data before decoding it in rtl_433.
+
+### Example 1
+Instead of 100, we see 10. Luckily, the PWM slicer in rtl_433 does not care too much about the length of gaps as long as they don't exceed the gap limit.
+
+![](bug_1.png "Example 1")
+
+
+### Example 2
+Instead of 100100 we see 11100, i.e. not only was a 250 µs period skipped, but the data is also incorrect. This pulse exceeds the expected high period of 500 µs, causing rtl_433 to drop both bits and split the row.
+
+![](bug_2.png "Example 2")
+
+
+### Example 3
+Instead of 110110 we see 11110. Essentially the same issue as in example 1, but resulting in there not being a gap at all. This pulse exceeds the expected high period of 500 µs, causing rtl_433 to drop both bits and split the row.
+
+![](bug_3.png "Example 3")

tests/WallarGe/CLTX001/wallarge_cltx001.conf

@@ -0,0 +1,16 @@
+# temperature_C_x10: 123 = 12.3°C, does not work for temperatures < 0°C
+decoder {
+  name       = WallarGe-CLTX001-Flex,
+  modulation = OOK_PWM,
+  short      = 250,
+  long       = 500,
+  gap        = 650,
+  reset      = 1250,
+  tolerance  = 75,
+  bits       = 56, repeats >= 2, unique, invert,
+  get        = @0:{16}:id,
+  get        = @24:{1}:low_battery,
+  get        = @25:{1}:test_mode,
+  get        = @26:{2}:channel:[0:A 1:B 2:C 3:D],
+  get        = @28:{12}:temperature_C_x10
+}