You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/file_formats/SubGhzFileFormats.md
+46-9Lines changed: 46 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,9 +6,9 @@ Flipper uses `.sub` files to store SubGhz transmissions. These are text files in
6
6
7
7
A `.sub` files consist of 3 parts:
8
8
9
-
-**header**: contains file type, version, and frequency
10
-
-**preset information**: preset type and, in case of a custom preset, transceiver configuration data
11
-
-**protocol and its data**: contains protocol name and its specific data, such as key, bit length, etc., or RAW data
9
+
-**header**, contains file type, version, and frequency
10
+
-**preset information**, preset type and, in case of a custom preset, transceiver configuration data
11
+
-**protocol and its data**, contains protocol name and its specific data, such as key, bit length, etc., or RAW data
12
12
13
13
Flipper's SubGhz subsystem uses presets to configure the radio transceiver. Presets are used to configure modulation, bandwidth, filters, etc. There are several presets available in stock firmware, and there is a way to create custom presets. See [SubGhz Presets](#adding-a-custom-preset) for more details.
14
14
@@ -45,10 +45,10 @@ Built-in presets:
45
45
46
46
Transceiver configuration data is a string of bytes, encoded in hex format, separated by spaces. For CC1101 data structure is: `XX YY XX YY .. 00 00 ZZ ZZ ZZ ZZ ZZ ZZ ZZ ZZ`, where:
You can find more details in the [CC1101 datasheet](https://www.ti.com/lit/ds/symlink/cc1101.pdf) and `furi_hal_subghz` code.
54
54
@@ -87,8 +87,8 @@ RAW `.sub` files contain raw signal data that is not processed through protocol-
87
87
88
88
For RAW files, 2 fields are required:
89
89
90
-
-`Protocol`, must be `RAW`
91
-
-`RAW_Data`, contains an array of timings, specified in microseconds Values must be non-zero, start with a positive number, and interleaved (change sign with each value). Up to 512 values per line. Can be specified multiple times to store multiple lines of data.
90
+
-**Protocol**, must be `RAW`
91
+
-**RAW_Data**, contains an array of timings, specified in microseconds Values must be non-zero, start with a positive number, and interleaved (change sign with each value). Up to 512 values per line. Can be specified multiple times to store multiple lines of data.
92
92
93
93
Example of RAW data:
94
94
@@ -97,6 +97,43 @@ Example of RAW data:
97
97
98
98
Long payload not fitting into internal memory buffer and consisting of short duration timings (< 10us) may not be read fast enough from the SD card. That might cause the signal transmission to stop before reaching the end of the payload. Ensure that your SD Card has good performance before transmitting long or complex RAW payloads.
99
99
100
+
### BIN_RAW Files
101
+
102
+
BinRAW `.sub` files and `RAW` files both contain data that has not been decoded by any protocol. However, unlike `RAW`, `BinRAW` files only record a useful repeating sequence of durations with a restored byte transfer rate and without broadcast noise. These files can emulate nearly all static protocols, whether Flipper knows them or not.
103
+
104
+
- Usually, you have to receive the signal a little longer so that Flipper accumulates sufficient data for correct analysis.
105
+
106
+
For `BinRAW` files, the following parameters are required and must be aligned to the left:
107
+
108
+
-**Protocol**, must be `BinRAW`.
109
+
-**Bit**, is the length of the payload of the entire file, in bits (max 4096).
110
+
-**TE**, is the quantization interval, in us.
111
+
-**Bit_RAW**, is the length of the payload in the next Data_RAW parameter, in bits.
112
+
-**Data_RAW**, is an encoded sequence of durations, where each bit in the sequence encodes one TE interval: 1 - high level (there is a carrier), 0 - low (no carrier).
113
+
For example, TE=100, Bit_RAW=8, Data_RAW=0x37 => 0b00110111, that is, `-200 200 -100 300` will be transmitted.
114
+
When sending uploads, `Bit_RAW` and `Data_RAW` form a repeating block. Several such blocks are necessary if you want to send different sequences sequentially. However, usually, there will be only one block.
0 commit comments