# mriosrivas/sdr-course-material architecture

> Architecture diagram of the GitHub repository mriosrivas/sdr-course-material, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mriosrivas/sdr-course-material
- Repository: https://github.com/mriosrivas/sdr-course-material

## Overview

##### Component Organization

A. Theory Section (Left)
- Slides organization (Chapters 1,2,4,6,7,8)
- To relevant practical components

B. Simulation Section (Middle)
- MATLAB Scripts organized by chapters
- Relationship between theory and implementation
- Simulation categories:
- Signal Processing (Chapter 2)
- Digital Communications (Chapter 4)
- Synchronization (Chapters 6,7)
- Frame & Channel Coding (Chapter 8)

C. Laboratory Section (Right)
- Four lab modules
- GNU Radio Companion (.grc) files
- LimeSDR integration points

##### Connection and Data Flow

- Knowledge flow from theory to practice
- Data flow in laboratory implementations
- Signal processing chains in GNU Radio blocks
- Hardware-software interfaces

##### Technical Details

- Supported modulation schemes (PSK, FM)
- Signal processing techniques
- Synchronization methods
- Hardware specifications for LimeSDR

##### Implementation Notes

- Clear separation between software components (GNU Radio, MATLAB) and hardware (LimeSDR)
- File relationships between theory and implementation
- Dependencies between components
- Version compatibility information

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Theory
        Slides[Theoretical Materials]
        SP[Signal Processing Theory]
        DC[Digital Communications]
        ST[Synchronization Theory]
        FC[Frame & Channel Coding]
        
        Slides --> SP
        Slides --> DC
        Slides --> ST
        Slides --> FC
    end

    subgraph Simulations
        MATLAB[MATLAB Environment]
        SP_Sim[Signal Processing Sims]
        DC_Sim[Digital Comms Sims]
        TS_Sim[Timing Sync Sims]
        CS_Sim[Carrier Sync Sims]
        FS_Sim[Frame Sync Sims]
        
        MATLAB --> SP_Sim
        MATLAB --> DC_Sim
        MATLAB --> TS_Sim
        MATLAB --> CS_Sim
        MATLAB --> FS_Sim
    end

    subgraph Laboratory
        GRC[GNU Radio Components]
        PSK[PSK Implementation]
        FM_TX[FM Transmitter]
        FM_RX[FM Receiver]
        HW_IF[Hardware Interface]
        
        GRC --> PSK
        GRC --> FM_TX
        GRC --> FM_RX
        GRC --> HW_IF
    end

    subgraph Hardware
        LimeSDR[LimeSDR Module]
        Host[Host Computer]
        
        LimeSDR --- Host
    end

    %% Theory to Simulation connections
    SP --> SP_Sim
    DC --> DC_Sim
    ST --> TS_Sim
    ST --> CS_Sim
    FC --> FS_Sim

    %% Simulation to Implementation connections
    SP_Sim --> PSK
    DC_Sim --> PSK
    TS_Sim --> FM_RX
    CS_Sim --> FM_RX
    FS_Sim --> FM_RX

    %% Implementation to Hardware connections
    PSK --> HW_IF
    FM_TX --> HW_IF
    FM_RX --> HW_IF
    HW_IF --> LimeSDR

    classDef theory fill:#blue,stroke:#333,stroke-width:2px
    classDef simulation fill:#green,stroke:#333,stroke-width:2px
    classDef laboratory fill:#orange,stroke:#333,stroke-width:2px
    classDef hardware fill:#red,stroke:#333,stroke-width:2px

    class Slides,SP,DC,ST,FC theory
    class MATLAB,SP_Sim,DC_Sim,TS_Sim,CS_Sim,FS_Sim simulation
    class GRC,PSK,FM_TX,FM_RX,HW_IF laboratory
    class LimeSDR,Host hardware

    %% Click events for component mapping
    click Slides "https://github.com/mriosrivas/SDR-course-material/tree/main/Slides"
    click SP "https://github.com/mriosrivas/SDR-course-material/blob/main/Slides/Chap 02 Signals and Systems.pdf"
    click DC "https://github.com/mriosrivas/SDR-course-material/blob/main/Slides/Chap 04 Digital Communications Fundamentals.pdf"
    click ST "https://github.com/mriosrivas/SDR-course-material/blob/main/Slides/Chap 06 Timing Synchronization.pdf"
    click FC "https://github.com/mriosrivas/SDR-course-material/blob/main/Slides/Chap 08 Frame Synchronization and Channel Coding.pdf"
    click FM_TX "https://github.com/mriosrivas/SDR-course-material/tree/main/Laboratory/Lab3/Transmitter"
    click FM_RX "https://github.com/mriosrivas/SDR-course-material/tree/main/Laboratory/Lab3/Receiver"
    click PSK "https://github.com/mriosrivas/SDR-course-material/tree/main/Laboratory/Lab 4/PSK Modulation"
    click HW_IF "https://github.com/mriosrivas/SDR-course-material/tree/main/Laboratory/Lab2"
    click SP_Sim "https://github.com/mriosrivas/SDR-course-material/tree/main/Matlab/Chapter_02"
    click DC_Sim "https://github.com/mriosrivas/SDR-course-material/tree/main/Matlab/Chapter_04"
    click TS_Sim "https://github.com/mriosrivas/SDR-course-material/tree/main/Matlab/Chapter_06"
    click CS_Sim "https://github.com/mriosrivas/SDR-course-material/tree/main/Matlab/Chapter_07"
    click FS_Sim "https://github.com/mriosrivas/SDR-course-material/tree/main/Matlab/Chapter_08"
```
