This commit is contained in:
2026-06-12 02:55:04 -07:00
commit 30406f4f49
2040 changed files with 571534 additions and 0 deletions

134
RTOS_Labs_common/RTOS_PWM.h Normal file
View File

@@ -0,0 +1,134 @@
/*!
* @defgroup RTOS_PWM
* @brief Pulse width modulation
<table>
<caption id="RTOSPWMpins2">PWM pins on the MSPM0G3507</caption>
<tr><th>Pin <th>Description
<tr><td>PA8 <td>TA0_C0 PWM output
<tr><td>PA9 <td>TA0_C1 PWM output
<tr><td>PB4 <td>TA1_C0 PWM output
<tr><td>PB1 <td>TA1_C1 PWM output
</table>
* @{*/
/**
* @file RTOS_PWM.h
* @brief Pulse width modulation
* @details Hardware creates fixed period, variable duty cycle waves
* \image html PWM_100Hz.png width=500px
* @version ECE319K v1.0
* @author Daniel Valvano and Jonathan Valvano
* @copyright Copyright 2025 by Jonathan W. Valvano, valvano@mail.utexas.edu,
* @warning AS-IS
* @note For more information see http://users.ece.utexas.edu/~valvano/
* @date June 19, 2025
<table>
<caption id="RTOSPWMpins3">PWM pins on the MSPM0G3507</caption>
<tr><th>Pin <th>Description
<tr><td>PA8 <td>TA0_C0 PWM output
<tr><td>PA9 <td>TA0_C1 PWM output
<tr><td>PB4 <td>TA1_C0 PWM output
<tr><td>PB1 <td>TA1_C1 PWM output
</table>
******************************************************************************/
/*
* Derived from timx_timer_mode_pwm_edge_sleep_LP_MSPM0G3507_nortos_ticlang
*/
#ifndef __PWM1_H__
#define __PWM1_H__
/**
* \brief use PWMUSELFCLK to select LFCLK
*/
#define PWMUSELFCLK 2
/**
* \brief use PWMUSEMFCLK to select MFCLK
*/
#define PWMUSEMFCLK 4
/**
* \brief use PWMUSEBUSCLK to select bus CLK
*/
#define PWMUSEBUSCLK 8
/**
* Initialize PWM outputs on PA8 PA9.
* Rising edge synchronized. timerClkDivRatio = 1.
* Once started, hardware will continuously output the waves.
* - timerClkSrc =
* - 2 for 32768 Hz LFCLK
* - 4 for 4MHz MFCLK (not tested)
* - 8 for 80/32/4 BUSCLK
* - TimerA0 is on Power domain PD1
* - for 32MHz bus clock, Timer clock is 32MHz
* - for 40MHz bus clock, Timer clock is MCLK 40MHz
* - for 80MHz bus clock, Timer clock is MCLK 80MHz
* - PWMFreq = (timerClkSrc / (timerClkDivRatio * (timerClkPrescale + 1) * period))
* - For example, source=LFCLK, prescale = 0, period = 1000, PWM frequency = 32.768 Hz
* - For example, source=BUSCLK, 80MHz bus, prescale=79, period = 10000, PWM frequency = 100Hz
*
* @param timerClkSrc is 2 4 or 8
* @param timerClkPrescale divide clock by timerClkPrescale+1, 0 to 255
* @param period sets the PWM period
* @param duty0 sets the duty cycle on PA8
* @param duty1 sets the duty cycle on PA9
* @return none
* @note Assumes LaunchPad_Init has been called to reset and activate power
* @see PWM0_SetDuty
* @brief Initialize PWM
*/
void PWM0_Init(uint32_t timerClkSrc, uint32_t timerClkPrescale,
uint32_t period, uint32_t duty0, uint32_t duty1);
/**
* Set duty cycles on PA12 PA13.
* @param duty0 sets the duty cycle on PA8
* @param duty1 sets the duty cycle on PA9
* @return none
* @note assumes PWM_Init was called
* @see PWM_Init
* @brief Set duty cycles
*/
void PWM0_SetDuty(uint32_t duty0, uint32_t duty1);
/**
* Initialize PWM outputs on PB4 B0.
* Rising edge synchronized. timerClkDivRatio = 1.
* Once started, hardware will continuously output the waves.
* - timerClkSrc =
* - 2 for 32768 Hz LFCLK
* - 4 for 4MHz MFCLK (not tested)
* - 8 for 80/32/4 BUSCLK
* - G0/G8 is on Power domain PD0
* - 32MHz bus clock, BUSCLK clock is 32MHz
* - 40MHz bus clock, BUSCLK clock is ULPCLK 20MHz
* - 80MHz bus clock, BUSCLK clock is ULPCLK 40MHz
* - PWMFreq = (timerClkSrc / (timerClkDivRatio * (timerClkPrescale + 1) * period))
* - For example, source=LFCLK, prescale = 0, period = 1000, PWM frequency = 32.768 Hz
* - For example, source=BUSCLK, 80MHz bus, prescale=79, period = 10000, PWM frequency = 100Hz
*
* @param timerClkSrc is 2 4 or 8
* @param timerClkPrescale divide clock by timerClkPrescale+1, 0 to 255
* @param period sets the PWM period
* @param duty0 sets the duty cycle on PB4
* @param duty1 sets the duty cycle on PB1
* @return none
* @note Assumes LaunchPad_Init has been called to reset and activate power
* @see PWM1_SetDuty
* @brief Initialize PWM
*/
void PWM1_Init(uint32_t timerClkSrc, uint32_t timerClkPrescale,
uint32_t period, uint32_t duty0, uint32_t duty1);
/**
* Set duty cycles on PA12 PA13.
* @param duty0 sets the duty cycle on PB4
* @param duty1 sets the duty cycle on PB1
* @return none
* @note assumes PWM_Init was called
* @see PWM1_Init
* @brief Set duty cycles
*/
void PWM1_SetDuty(uint32_t duty0, uint32_t duty1);
#endif // __PWM_H__
/** @}*/