AD5940 Lab

graph TD
    subgraph S1["Physical Layer (IoT Hardware)"]
        SPE["Screen Printed Electrode (SPE)<br/>WE / RE / CE"] --> AFE["AD5940 Precision AFE<br/>(16-bit ADC + DFT Accelerator)"]
        AFE --> MCU["Microcontroller / Edge Host<br/>(SPI Driver & Register Sequencer)"]
    end
    
    subgraph S2["Machine Learning & Signal Core"]
        MCU --> FeatureEng["Electrochemical Signal Processing<br/>(Randles Fitting: Rs, Rct, Cdl, Warburg)"]
        FeatureEng --> Classifier["Analyte ML Classifier<br/>(Heavy Metal Quantification & WQI)"]
    end
    
    subgraph S3["User Telemetry & Action"]
        Classifier --> Dash["Streamlit Telemetry Dashboard<br/>(Nyquist / Bode / CV Plots)"]
        Classifier --> Alert["WHO / EPA Safety Risk Alert<br/>(Safe / Warning / Hazardous)"]
    end

# Clone the repository
git clone https://github.com/C12isme945/BioSmartSense-IoT.git
cd BioSmartSense-IoT

# Install Python dependencies
pip install -r requirements.txt

python -m unittest discover -s tests -v

streamlit run dashboard/app.py

# Run real-time diagnostic scan
python cli.py --analyte "Lead (Pb2+)" --rct 850.0

# Export JSON for IoT telemetry pipelines
python cli.py --analyte "Cadmium (Cd2+)" --json

BioSmartSense-IoT/
├── README.md                      # Master documentation & benchmark guide
├── LICENSE                        # Apache 2.0 Open-Source License
├── requirements.txt               # Pinned Python package dependencies
├── .gitignore                     # Git ignore rules for KiCad and Python
├── cli.py                         # Command-line interface for edge deployment
├── dashboard/
│   └── app.py                     # Streamlit live telemetry dashboard
├── ml_core/
│   ├── feature_extraction.py      # Randles circuit parameter extraction & CV peaks
│   ├── analyte_classifier.py      # Heavy metal & Water Quality Index (WQI) models
│   └── simulation_data.py         # Multi-frequency EIS & CV benchmark generator
├── firmware/
│   └── ad5940_driver.py           # AD5940 SensorPal SPI driver interface
├── hardware/                      # Complete KiCad 8 Hardware Design
│   ├── design/                    # KiCad schematic, PCB, and symbol libraries
│   ├── exports/                   # Schematics PDF, 3D renders, layer drawings
│   ├── JLC_PCB_UPLOAD/            # Ready-to-order JLCPCB Gerbers, drill files, BOM
│   ├── AD5940_Lab_A1_Engineering.zip
│   └── 电气设计与首板调试.md          # Hardware debugging and layout guidelines
├── docs/
│   └── images/                    # High-resolution renders and block diagrams
└── tests/
    └── test_biosmartsense.py      # Comprehensive unit tests