🧩 Chapter 1 β€” Python Baseline Model

AITL Architecture: PID Γ— FSM Γ— LLM

This chapter provides the foundational behavioral model used throughout the AITL Silicon Pathway.
The Python implementation here defines the golden reference used for RTL, OpenLane, GDSII, and SPICE stages.


Language GitHub Pages 🌐 GitHub πŸ’»
πŸ‡ΊπŸ‡Έ English GitHub Pages EN GitHub Repo EN

⚠ Diagram Rendering Notice

The system pathway diagram above is written in Mermaid.
Due to current limitations of GitHub Pages, Mermaid diagrams are not rendered on this site.

Please refer to the GitHub repository view (linked above) to see the diagram correctly rendered.


πŸ“˜ What You Will Learn


πŸ“‚ Chapter 1 Contents

File Description
README.md Folder-level overview & usage guide
overview.md Conceptual explanation of control architecture
python_model.md Detailed explanation of the PID/FSM/Controller code
fsm.md Canonical AITL FSM specification (used for RTL)
api.md API reference for the Python model
getting_started.md Installation & execution guide

πŸ—‚ Directory Map

chapter1_python_model/
β”œβ”€ example/                # Jupyter notebooks
β”œβ”€ plots/                  # Generated plots
β”œβ”€ sim/                    # Simulation scripts
β”œβ”€ src/                    # PID / FSM / Controller code
β”œβ”€ tests/                  # Unit tests
β”œβ”€ main.py                 # Entry example
└─ requirements.txt        # Dependencies

🎯 Role of Chapter 1 in the Full Silicon Pathway

This chapter is the starting point of the end-to-end hardware education pipeline:

Python β†’ Verilog (RTL) β†’ OpenLane β†’ GDSII β†’ Magic RC Extraction β†’ SPICE

βœ” Behavioral correctness is established here

All downstream steps rely on the Python model as the reference.

βœ” FSM rules defined here become RTL (Chapter 2)

βœ” Controller timing and transitions influence ASIC design (Ch.3–5)


πŸ§ͺ Simulations

Step Response

Produces controller output, PID action, and FSM transitions.

Fault Scenario

Simulates transient fault injection and automated recovery.

Images are stored here:

docs/chapter1/images/

πŸ–Ό Key Diagrams (GitHub Pages absolute paths)

FSM Overview

flowchart TD
    PY[Python Baseline Model]
    SPEC[FSM Specification]
    RTL[Verilog RTL]
    OL[OpenLane Flow]
    GDS[GDSII Layout]
    EXT[RC Extraction]
    SPICE[SPICE Simulation]

    PY --> SPEC
    SPEC --> RTL
    RTL --> OL
    OL --> GDS
    GDS --> EXT
    EXT --> SPICE

Controller Data Flow

flowchart TD
    R[Reference]
    E[Error]
    PID[PID Controller]
    FSM[FSM Supervisor]
    PLANT[Plant]
    Y[Output]
    LLM[LLM Meta Control]

    R --> E
    Y --> E
    E --> PID
    PID --> PLANT
    PLANT --> Y

    FSM --> PID
    FSM --> PLANT

    LLM -. tuning .-> PID
    LLM -. policy .-> FSM

Step Response Simulation


πŸ”— Continue Reading

πŸ‘‰ Next: overview.md
πŸ‘‰ or jump to python_model.md


Β© AITL Silicon Pathway Project