How zuhayrl/eee4022s_thesis works
This repository is a thesis project for a salinity-measurement system, with controller firmware, salinity calculations, probe/controller hardware designs, and related analysis notebooks and plotting. The intended user workflow is to measure a sample with the probe, acquire signals through the controller, and derive salinity. The supplied excerpts verify the voltage-to-salinity calculation pipeline and CSV voltage plotting; firmware-to-hardware and ML runtime connections are not shown, so those links are omitted. The top-level README provides no further capability or workflow detail.
Main entry points: salinity.cpp Voltage conversion · Salinity_Controller.ino Controller firmware · Salinity_Testing.ino Salinity test firmware · salinity.h Salinity API
Components 16
Measurement firmware
- Controller firmware
Code/Salinity_Controller/Salinity_Controller.ino - Salinity test firmware
Code/Salinity_Testing/Salinity_Testing.ino - Calibration test
Code/Tests/CalibrationTest-ESPIDF/src/main.c - ADC/DAC test
Code/Tests/ADC_DAC_Test/ADC_DAC_Test.ino - DAC serial test
Code/Tests/ESPS2_DAC_Test_serial/ESPS2_DAC_Test_serial.ino
Salinity calculation
- Voltage conversion
Code/Salinity_Testing/salinity.cpp - Conductivity conversion
Code/Salinity_Testing/salinity.cpp - PSS-78 salinity
Code/Salinity_Testing/salinity.cpp - Salinity API
Code/Salinity_Testing/salinity.h
Measurement hardware
- Probe PCB
PCB/Probe/probe_v5-0/probe.kicad_pcb - Electrode PCB
PCB/GoldElectrodes/GoldElectrode_v2-0/GoldElectrode.kicad_pcb - Controller PCB
PCB/Controller/controller_v2-0/controller.kicad_pcb
Data analysis
- Voltage CSV plotter
Testing/AC_Plotting/voltage_plotter.py - Salinity ML notebook
MachineLearning/Salinity_ML/salinity_ml.ipynb - Permittivity notebook
MachineLearning/RC_ML/permittivity_test.ipynb
Other components
- Operator
Connections 9
- Operator → Controller firmware: operates
- Controller firmware → Probe PCB: acquires from
- Controller firmware → Voltage conversion: converts readings
- Salinity test firmware → Voltage conversion: uses calculations
- Voltage conversion → Conductivity conversion: computes next
Code/Salinity_Testing/salinity.cpp - Conductivity conversion → PSS-78 salinity: feeds conductivity
Code/Salinity_Testing/salinity.cpp - Voltage conversion → PSS-78 salinity: calls salinity pipeline
Code/Salinity_Testing/salinity.cpp - Salinity API → Voltage conversion: declares interface
Code/Salinity_Testing/salinity.h - Operator → Voltage CSV plotter: selects CSV
Testing/AC_Plotting/voltage_plotter.py