make examples into SigMF format

RUB-SysSec · Mar 4, 2023 · bd8dd8e · bd8dd8e
1 parent ee4057a
commit bd8dd8e
Show file tree

Hide file tree

Showing 5 changed files with 33 additions and 7 deletions.
diff --git a/README.md b/README.md
@@ -28,7 +28,7 @@ You can use `inspectrum` to visualize the raw sample file:
 
 ```
 sudo apt install inspectrum
-inspectrum -r 50e6 samples/mini2_sm
+inspectrum samples/mini2_sm.sigmf-data
 ```
 
 <img alt="Inspectrum screenshot of Drone-ID bursts" width=500 src="./img/inspectrum.png"></a></p>
@@ -45,7 +45,7 @@ pip3 install -r requirements.txt
 
 You can now run the decoder on the sample file:
 ```
-./src/droneid_receiver_offline.py -i samples/mini2_sm
+./src/droneid_receiver_offline.py -i samples/mini2_sm.sigmf-data
 ```
 
 ### Results
@@ -82,9 +82,9 @@ The script performs detection and decoding just as the live receiver would. It p
 }
 ```
 
-The summary contains decoding stats and flight path. In the `mini2_sm` sample, the drone did not have GPS coordinates locked yet, and only the smartphone's location is transmitted:
+The summary contains decoding stats and flight path. In the `mini2_sm.sigmf-data` sample, the drone did not have GPS coordinates locked yet, and only the smartphone's location is transmitted:
 ```
-$ ./src/droneid_receiver_offline.py -i samples/mini2_sm
+$ ./src/droneid_receiver_offline.py -i samples/mini2_sm.sigmf-data
 … … …
 Frame detection: 10 candidates
 Decoder: 9 total, CRC OK: 7 (2 CRC errors)
@@ -96,9 +96,9 @@ App Coordinates:
 (51.447176178716916, 7.266528392911369)
 ```
 
-For `samples/mavic_air_2` both locations are transmitted:
+For `samples/mavic_air_2.sigmf-data` both locations are transmitted:
 ```
-$ ./src/droneid_receiver_offline.py -i samples/mavic_air_2
+$ ./src/droneid_receiver_offline.py -i samples/mavic_air_2.sigmf-data
 …
 Decoder: 1 total, CRC OK: 1 (0 CRC errors)
 Drone Coordinates:
@@ -139,7 +139,7 @@ The receiver will hop through a list of frequencies and, if a drone is detected,
 
 > If you're looking for a deeper dive into the processing steps, we suggest calling the offline decoder with `--debug`. This will **enable a GUI** with step-by-step decoding.
 > ```
-> ./src/droneid_receiver_offline.py -i samples/mini2_sm
+> ./src/droneid_receiver_offline.py -i samples/mini2_sm.sigmf-data
 > ```
 
 

diff --git a/samples/mavic_air_2 → samples/mavic_air_2.sigmf-data b/samples/mavic_air_2 → samples/mavic_air_2.sigmf-data
diff --git a/samples/mavic_air_2.sigmf-meta b/samples/mavic_air_2.sigmf-meta
@@ -0,0 +1,13 @@
+{
+  "annotations": [ ],
+  "captures": [
+    {
+      "core:sample_start": 0
+    }
+  ],
+  "global": {
+    "core:datatype": "cf32_le",
+    "core:description": "DroneID Bursts from a Mavic Air 2",
+    "core:sample_rate": 50000000
+  }
+}
diff --git a/samples/mini2_sm → samples/mini2_sm.sigmf-data b/samples/mini2_sm → samples/mini2_sm.sigmf-data
diff --git a/samples/mini2_sm.sigmf-meta b/samples/mini2_sm.sigmf-meta
@@ -0,0 +1,13 @@
+{
+  "annotations": [ ],
+  "captures": [
+    {
+      "core:sample_start": 0
+    }
+  ],
+  "global": {
+    "core:datatype": "cf32_le",
+    "core:description": "DroneID Bursts",
+    "core:sample_rate": 50000000
+  }
+}