Subversion Repositories signal_waveform_generator

# PWM Controller

This module implements a configurable PWM controller. User can set the following parameters:
- System Input Clock: the frequency (Hz) of the PWM module
- PWM Resolution: PWM Resolution (bits) of the internal counter
- Signal Output Frequency: the frequency (Hz) of the PWM Output Signal
- Signal Output Frequency Error: the frequency error range (Hz) of the PWM Output Signal

<img width="514" alt="pwm" src="https://github.com/user-attachments/assets/762d4079-8940-455b-aca9-65767e7f0288" />

## Usage

Simply set the PWM parameters (i.e., System Input Clock, PWM Resolution, Signal Output Frequency and Signal Output Frequency Error).

The PWM Controller will automatically verify if the requirements are satisfied (essentially the Signal Output Frequency). If not, an error message will be displayed as shown below:

```
PWM Module Configuration Failure !
Signal Output Freq Min: xxx
Signal Output Freq Max: xxx
Actual Signal Output Freq Actual: xxx
```

## PWM Controller Pin Description

### Generics

| Name | Description |
| ---- | ----------- |
| sys_clock | System Input Clock Frequency (Hz) |
| pwm_resolution | PWM Resolution (Bits) |
| signal_output_freq | PWM Signal Output Frequency (Hz) |
| signal_output_freq_error | Range of PWM Signal Output Error Range (Hz) |

### Ports

| Name | Type | Description |
| ---- | ---- | ----------- |
| i_sys_clock | Input | System Input Clock |
| i_reset | Input | Reset ('0': No Reset, '1': Reset) |
| i_duty_cycle | Input | Duty Cycle to apply (Value Range: [0;2<sup>pwm_resolution</sup>]) |
| o_next_duty_cycle_trigger | Output | Next Duty Cycle Trigger ('0': No Trigger, '1': Trigger Enable) |
| o_pwm | Output | PWM Output |