feat(PeriphDrivers): Add Clock Setter APIs for MAX32690 & MAX78002 Peripherals, Add Dual Mode TMR Support, Add MAX32690 Clock Calibration API for IPO, Add MAX32690 RISCV Clock Setter, CFS Support Functions

[Jake-Carter]

Description

This PR adds various APIs and features to support CFS clock config code generation.

Primarily, this includes clock setter APIs.

Since many of the peripheral's Init APIs also configure the clock source, a locking mechanism was developed to allow the CFS config to take precedence. This is a temporary solution until CFS can perform full peripheral configuration, which is in the roadmap.

Additionally, it adds the weak ClockInit() function to the system startup code. CFS will override this function.

This PR also adds dual-mode TMR support. The process involves initializing the TMR instance twice, once with the 16A bit-mode config, and once with the 16B bit-mode config.

Dual-Mode Example

/******************************************************************************
 *
 * Copyright (C) 2024 Analog Devices, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 ******************************************************************************/

// Dual mode timer configuration example for MAX78002.

/***** Includes *****/
#include <stdio.h>
#include <stdint.h>
#include "mxc_device.h"
#include "led.h"
#include "board.h"
#include "tmr.h"
#include "nvic_table.h"

/***** Definitions *****/

/***** Globals *****/

/***** Functions *****/
void TMR_ISR(void)
{
    uint32_t flags = MXC_TMR_GetFlags(MXC_TMR0);
    if (flags & MXC_F_TMR_INTFL_IRQ_A) {
        LED_Toggle(0);
        MXC_TMR0->intfl |= MXC_F_TMR_INTFL_IRQ_A;
    }
    
    if (flags & MXC_F_TMR_INTFL_IRQ_B) {
        LED_Toggle(1);
        MXC_TMR0->intfl |= MXC_F_TMR_INTFL_IRQ_B;
    }
}

// *****************************************************************************
int main(void)
{
    mxc_tmr_cfg_t tmr0a_cfg = {
        .bitMode = MXC_TMR_BIT_MODE_16A,
        .clock = MXC_TMR_APB_CLK,
        .cmp_cnt = MXC_TMR_GetPeriod(MXC_TMR0, MXC_TMR_ISO_CLK, 128, 1),
        .mode = MXC_TMR_MODE_CONTINUOUS,
        .pol = 0,
        .pres = MXC_TMR_PRES_128
    };

    mxc_tmr_cfg_t tmr0b_cfg = {
        .bitMode = MXC_TMR_BIT_MODE_16B,
        .clock = MXC_TMR_APB_CLK,  
        .cmp_cnt = MXC_TMR_GetPeriod(MXC_TMR0, MXC_TMR_ISO_CLK, 128, 2),
        .mode = MXC_TMR_MODE_CONTINUOUS,
        .pol = 0,
        .pres = MXC_TMR_PRES_128
    };

    MXC_TMR_Init(MXC_TMR0, &tmr0a_cfg, false);
    MXC_TMR_Init(MXC_TMR0, &tmr0b_cfg, false);

    MXC_TMR_EnableInt(MXC_TMR0);
    NVIC_EnableIRQ(TMR0_IRQn);
    MXC_NVIC_SetVector(TMR0_IRQn, TMR_ISR);

    MXC_TMR_Start(MXC_TMR0);
}

This RISCV system clock input can now also be set with MXC_SYS_RISCVClockSelect.

Checklist Before Requesting Review

• PR Title follows correct guidelines.
• Description of changes and all other relevant information.
• (Optional) Link any related GitHub issues using a keyword
• (Optional) Provide info on any relevant functional testing/validation. For API changes or significant features, this is not optional.

[sihyung-maxim]

Can you add this note to the header device files (max32690.h)? Some developers only pull the CMSIS.

[Jake-Carter]

5de0fea