wrpll-simulation/README.md
morgan f58ab13e9b improve jitter generation
wave_gen: change to gussian jitter distribution
wrapper: reduce gtx_jitter to meet real world performance
docs: remove noise limitation
2023-12-13 17:14:20 +08:00

57 lines
1.1 KiB
Markdown

# WRPLL simulation
A time domain simulation for WRPLL
## Installation
### Poetry:
```bash
poetry install
poetry run jupyter lab
```
### Poetry shell:
```bash
poetry install
poetry shell
```
### Nix:
```bash
nix develop
```
## Quick start
- Three notebook examples are included
1. `helper_PLL_example.ipynb` : helper PLL only
2. `main_PLL_example.ipynb` : main PLL only with a user specific helper frequency
3. `both_PLL_example.ipynb` : main and helper PLL
- RAM usage and execution time estimate for simulation **ONLY**
1. 100,000,000 time steps: 6GiB RAM and 12 seconds
2. 200,000,000 time steps: 11GiB RAM and 20 seconds
3. 300,000,000 time steps: 16GiB RAM and 35 seconds
<br>
<details><summary><b>WRPLL formulas</b></summary>
- Assume the difference between $f_{main}, f_{gtx}$ is very small
- Let $f_{in} = f_{main} = f_{gtx}$
- $f_{helper} = f_{in} * \dfrac{N-1}{N}$
- $f_{beat} = f_{in} - f_{helper} = \dfrac{f_{in}}{N}$
- Main and helper Si549 DCXO **ADPLL** setting
- $ADPLL = \dfrac{\Delta f_{outppm}}{0.0001164}$
</details><br>
## Limitation