feat(PeriphDrivers): Add MXC_TMR_SetClockSourceFreq API for timers (#1589)

Add a new MXC_TMR_SetClockSourceFreq API so that the timer frequency can be manually set when
using external clock as timer clock source.

Signed-off-by: Tahsin Mutlugun <Tahsin.Mutlugun@analog.com>

Author: ttmut

Libraries/PeriphDrivers/Include/MAX32650/tmr.h

@@ -149,6 +149,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 void MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg);
 
+/**
+ * @brief      Set the timer input clock frequency.
+ * @param      tmr  Pointer to timer instance.
+ * @param      clksrc_freq Timer input clock frequency in Hz.
+ * @note       Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no
+ *             effect on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief      Shutdown timer module clock.
  * @param      tmr  Pointer to timer module to shutdown.

Libraries/PeriphDrivers/Include/MAX32655/tmr.h

@@ -191,6 +191,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg, bool init_pins);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32657/tmr.h

@@ -189,6 +189,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg, bool init_pins);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32660/tmr.h

@@ -169,6 +169,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32662/tmr.h

@@ -194,6 +194,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg, bool init_pins, sys_map_t pin_sel);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32665/tmr.h

@@ -147,6 +147,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 void MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg);
 
+/**
+ * @brief      Set the timer input clock frequency.
+ * @param      tmr  Pointer to timer instance.
+ * @param      clksrc_freq Timer input clock frequency in Hz.
+ * @note       Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no
+ *             effect on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief      Shutdown timer module clock.
  * @param      tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32670/tmr.h

@@ -190,6 +190,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg, bool init_pins);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32672/tmr.h

@@ -190,6 +190,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg, bool init_pins);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32675/tmr.h

@@ -189,6 +189,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg, bool init_pins);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.

Libraries/PeriphDrivers/Include/MAX32680/tmr.h

@@ -191,6 +191,15 @@ typedef void (*mxc_tmr_complete_t)(int error);
  */
 int MXC_TMR_Init(mxc_tmr_regs_t *tmr, mxc_tmr_cfg_t *cfg, bool init_pins);
 
+/**
+ * @brief   Set the timer input clock frequency.
+ * @param   tmr  Pointer to timer instance.
+ * @param   clksrc_freq Timer input clock frequency in Hz.
+ * @note    Call this after selecting MXC_TMR_EXT_CLK on RevB timers. This API has no effect
+ *          on timer revisions without selectable clock sources.
+ */
+void MXC_TMR_SetClockSourceFreq(mxc_tmr_regs_t *tmr, int clksrc_freq);
+
 /**
  * @brief   Shutdown timer module clock.
  * @param   tmr  Pointer to timer module to initialize.