# Dataset README

## Project Title
Miniaturized Lagrangian Sensor-Systems for Position Detection in 
(Bio-)Chemical Reactors 

## Related Publication
This dataset accompanies the V1 sensor-sphere publication:

Anton Geläschus, Lukas Rennpferdt, Vamika Rathi, Mohammad Daniyal Hussain, Daniel Ruprecht, and Khiem Hoc Trieu, "Millimeter-Scale Lagrangian Sensor Spheres for Local State Monitoring in SMART Reactors," MikroSystemTechnik KONGRESS 2025, Duisburg, Germany, 2025. DOI: [10.30420/456614119](https://doi.org/10.30420/456614119)

## Principal Investigators / Authors

Anton Geläschus \
Hamburg University of Technology \
ORCID: 0000-0003-1904-2473

Marcel Haack \
Hamburg University of Technology

Julius von Sulecki \
Hamburg University of Technology \

Khiem Hoc Trieu \
Hamburg University of Technology \
ORCID: 0000-0002-6102-4132

## Funding Acknowledgement
This data set was generated as part of the DFG-funded project CRC 1615: SMART Reactors for Future Process Engineering (DFG Project Number: 503850735).

## 1. General Information

### Data Set Title
Data for "Miniaturized Lagrangian Sensor-Systems for Position Detection in 
(Bio-)Chemical Reactors "

### Short Description
This TORE dataset contains supporting data, V1 PCB documentation, and V1 firmware material for the first-generation millimeter-scale Lagrangian sensor sphere described in the related MikroSystemTechnik KONGRESS 2025 publication. The data were collected to document and evaluate an early miniaturized Lagrangian sensor platform for position and state monitoring in stirred (bio-)chemical reactor environments, where freely moving sensor particles can provide local information that is difficult to obtain with fixed probes. The dataset is organized into measurement data (`01_Data`), PCB documentation (`02_PCB`), and firmware sources plus development configuration (`03_Firmware`).


### Date of Data Collection
The available measurement file names and firmware comments indicate material generated in 2025. This local dataset package was prepared for TORE documentation on `2026-06-30`.

### Geographical Coverage
Hamburg-Harburg, Germany

### Keywords
SMART Reactors, Lagrangian sensor spheres, V1 hardware, embedded firmware, inertial measurement, power measurement, PCB documentation, MAX32660, ICM-20948

## 2. Methodological Information

### Data Collection and Processing
The dataset contains engineering measurement data and design files related to the V1 sensor-sphere platform. The measurements were acquired during development and demonstration of a compact, battery-powered sensor sphere intended to move with the surrounding fluid and report local motion- and state-related information. The voltage/current log documents electrical behavior of the platform, while the trajectory example captures firmware-generated sensor output used to reconstruct or inspect the motion of the sensor sphere in the experimental workflow:

- `Log03_05_2025_15-31-55_500K-ch1_RAW.csv` is a voltage and current log with columns `Timestamp`, `U[V]`, and `I[A]`.
- `beispielmessung_trajektorie_evysy_max32660.txt` is a comma-separated example trajectory measurement without a header line. Its structure corresponds to the embedded firmware output from the V1 sensor platform and should be interpreted together with the firmware sources.
- `02_PCB/` contains V1 bill-of-material, schematic, and layout documentation.
- `03_Firmware/` contains embedded C firmware for a MAX32660-based platform with ICM-20948 IMU and AK09916 magnetometer support, light-based data transmission, build files, and IDE/debug configuration.

### Experimental Design / Study Context
The archived files document and support the V1 implementation of a millimeter-scale Lagrangian sensor sphere for local state monitoring in SMART reactors. The research context is the development of mobile sensing systems for process-engineering reactors, where sensor particles follow the flow instead of measuring only at fixed wall-mounted positions. Such Lagrangian sensor systems are intended to complement conventional instrumentation by enabling local, time-resolved information about particle motion and operating conditions inside opaque or spatially heterogeneous reactor volumes. The included materials cover:

- Electrical power or current/voltage characterization of the V1 platform.
- Recorded sensor output from the embedded platform.
- PCB design documentation for the V1 electronics.
- Firmware for sensor initialization, data acquisition, and optical data transmission.

### Data Validation and Quality Assurance
Quality assurance is based on consistency between the recorded data files, the V1 firmware sources, and the PCB documentation. The voltage/current log contains explicit column headers and units. The sensor-output text file does not contain a header and should be interpreted together with the firmware implementation and publication context.

## 3. Data and File Overview

### List of Files and Structure

| File / Folder | Description | Format | Notes |
| --- | --- | --- | --- |
| `01_Data/` | Measurement and sensor-output data | `.csv`, `.txt` | Contains voltage/current logging and firmware-generated sensor output. |
| `02_PCB/` | V1 PCB documentation | `.xlsx`, `.pdf` | Contains BOM, schematic, and layout files. |
| `03_Firmware/` | V1 embedded firmware project | `.c`, `.h`, `Makefile`, `.mk`, IDE/debug configuration | MAX32660/MSDK-based firmware project. |
| `License.md` | License allocation for data, firmware, and PCB material | `.md` | See Section 4. |

Inside `01_Data/`:

| File | Description | Format |
| --- | --- | --- |
| `Log03_05_2025_15-31-55_500K-ch1_RAW.csv` | Voltage/current log with `Timestamp`, `U[V]`, and `I[A]` columns | `.csv` |
| `beispielmessung_trajektorie_evysy_max32660.txt` | Comma-separated example trajectory measurement from the V1 platform | `.txt` |

Inside `02_PCB/`:

| File group | Description |
| --- | --- |
| `V1_BOM.xlsx`, `V1_Schematic.pdf`, `V1_Layout.pdf` | PCB bill of materials, schematic, and layout for hardware revision V1. |

Inside `03_Firmware/`:

| File group | Description |
| --- | --- |
| `main.c`, `ICM20948.*`, `MAX302660_Drivers.*`, `light_send.*` | Firmware source and header files for sensor setup, data acquisition, board setup, and optical data transmission. |
| `Makefile`, `project.mk` | Build configuration for the MAX32660/MSDK firmware project. |
| `.project`, `.cproject`, `.settings/`, `.vscode/`, `I2C_Sensor.launch` | Eclipse/VS Code project and debug configuration. |
| `flash.log` | Local flashing log retained with the firmware project. |

### File Naming Convention
File names follow the original measurement and development workflow:

- Measurement exports use timestamp- and sampling-related names, for example `Log03_05_2025_15-31-55_500K-ch1_RAW.csv`.
- PCB files use the `V1_...` prefix to indicate the hardware revision.
- Firmware files follow embedded C naming conventions and include source/header pairs such as `ICM20948.c` and `ICM20948.h`.

### Number of Records / Observations
The dataset contains heterogeneous files rather than a single rectangular table. Record counts vary by file. Users should inspect the CSV or text file directly for row counts and sampling intervals.

## 4. Access and Licensing Information

### Repository and Persistent Identifier
This dataset is prepared for dataset submission via TORE. The final dataset DOI has not yet been inserted in this local README.

### License for Use
Licensing is assigned by material type:

- `01_Data/`: Public Domain Mark 1.0 for pure measurement and sensor-output data.
- Dataset-level documentation and metadata: Creative Commons Attribution 4.0 International (`CC-BY-4.0`).
- `03_Firmware/`: MIT License, unless a file contains its own license header.
- `02_PCB/`: CERN Open Hardware Licence Version 2 - Permissive (`CERN-OHL-P-2.0`).

See `License.md` for the license allocation and links to the corresponding license texts.

### Access Restrictions
This dataset appears intended for open dataset submission. Any embargo or repository-side access restriction should be declared during final deposit if needed.

### Text for Citation
A. Geläschus, L. Rennpferdt, V. Rathi, M. D. Hussain, D. Ruprecht, and H. K. Trieu, "Data for Miniaturized Lagrangian Sensor-Systems for Position Detection in 
(Bio-)Chemical Reactors", TORE, 2026. Dataset DOI to be added after deposit. Related publication DOI: 10.30420/456614119.

## 5. Reproducibility and Software Dependencies

### Software Required
The included materials indicate the following practical dependencies:

- Software capable of reading `.csv`, `.txt`, `.xlsx`, `.pdf`, and `.md` files.
- Analog Devices/Maxim MSDK for building the MAX32660 firmware.
- Optional development environments represented by the included project files: Eclipse/CDT and Visual Studio Code with the Maxim/MSDK workflow.

### Scripts and Workflow
No standalone analysis scripts are included in this V1 dataset. The firmware workflow is contained in `03_Firmware/`:

- `Makefile` and `project.mk` define the MSDK-based build configuration.
- `.vscode/README.md` documents the VS Code Maxim/MSDK setup.
- `I2C_Sensor.launch`, `.project`, and `.cproject` provide IDE/debug configuration.

The measurement data in `01_Data/` can be inspected directly with spreadsheet, text, or scientific data-analysis tools.

### Reproducibility Notes
The dataset supports inspection of the V1 platform through its recorded data, PCB documentation, and firmware source code. The power log can be analyzed directly from the CSV columns. The sensor-output log should be interpreted together with the firmware source files that define the sensor setup, data acquisition, and output behavior.

## 6. Ethical and Legal Aspects

### Data Protection
No personal or participant-related data are evident in the inspected dataset contents. The material consists of engineering measurement data, PCB documentation, and firmware source files.

### Consent Statement
Not applicable based on the currently included materials.

## 7. Versioning and Updates

### Version Number
`v1.0-dataset`

### Date of Release
`2026-06-30`

### Change Log
- `2026-06-30`: Initial TORE dataset documentation created for the V1 sensor-sphere publication dataset.

## 8. Contact Information

### Corresponding Author
Anton Geläschus \
Hamburg University of Technology \
ORCID: 0000-0003-1904-2473