Merge branch 'master' of https://github.com/lab11/socitrack

Author: hedgecrw

software/firmware/tests/peripherals/test_ranging_radio.c

@@ -74,14 +74,19 @@ void delayed_write_test(void)
    assert(dwt_starttx(DWT_START_TX_DELAYED) == DWT_SUCCESS);
 
    // Sleep for 5 seconds
-   am_hal_delay_us(5000000);
+   am_hal_delay_us(1000000);
 }
 
-void read_test(void)
+void read_test(int antenna, int channel)
 {
+   printf("read_test, antenna %d (%s), channel (%d)\n",
+         antenna,
+         antenna == 0 ? "left" : antenna == 1 ? "top" : "right",
+         channel);
+
    // Enable packet reception
-   ranging_radio_choose_antenna(0);
-   ranging_radio_choose_channel(5);
+   ranging_radio_choose_antenna(antenna);
+   ranging_radio_choose_channel(channel);
    ranging_radio_rxenable(DWT_START_RX_IMMEDIATE);
 
    // Sleep for 60 seconds
@@ -104,7 +109,9 @@ int main(void)
       //regular_sleep_test();
       //deep_sleep_test();
       //delayed_write_test();
-      read_test();
+      read_test(0, 5);
+      read_test(1, 5);
+      read_test(2, 5);
    }
 
    // Should never reach this point

software/management/dashboard/parse.py

@@ -6,6 +6,34 @@
 
 
 def process_tottag_data(data, experiment_start_time):
+   """
+   Parses and processes raw binary data read from .ttg files.
+   The processed sensor log is saved to a file named 'converted.pkl'.
+   IMU data is currently skipped.
+
+   Parameters:
+        data (bytes): Raw binary byte stream read from .ttg files.
+        experiment_start_time (float): 10-digit Unix timestamp (in seconds).
+
+   Returns:
+        List[dict]: A list of timestamped dict of data. Each dictionary has:
+            - 't': Absolute timestamp (float)
+            - 'v' (Voltage):
+                Indicates the battery voltage of the device in millivolts.
+            - 'c' (Charging Event):
+                Encodes battery charging status as one of several predefined states, such as
+                charging, full, or discharging. The values are mapped via `BATTERY_CODES`.
+            - 'm' (Motion):
+                A boolean value indicating whether motion was detected at the time.
+                `True` means motion is detected; `False` indicates stillness.
+            - 'r' (Ranges):
+                A dictionary mapping device UIDs (unique IDs) to measured distances (in millimeters).
+                These distances represent proximity to neighboring devices. Only values.
+                below `MAX_RANGING_DISTANCE_MM` are included.
+            - 'b' (BLE Scan Results):
+                A list of device UIDs detected during a Bluetooth Low Energy scan. These IDs represent.
+                nearby TotTags.
+   """
    i = 0
    log_data = defaultdict(dict)
    while i + 5 < len(data):
@@ -64,7 +92,6 @@ def process_tottag_data(data, experiment_start_time):
       pickle.dump(log_data, file, protocol=pickle.HIGHEST_PROTOCOL)
    return log_data
 
-
 if __name__ == "__main__":
 
    if len(sys.argv) != 3:
@@ -73,4 +100,4 @@ def process_tottag_data(data, experiment_start_time):
 
    experiment_start_time = int(sys.argv[2])
    with open(sys.argv[1], mode="rb") as file:
-      process_tottag_data(file.read(), experiment_start_time)
+      process_tottag_data(file.read(), experiment_start_time)