Power Management Controller (PMC) driver for SAM.
Copyright (c) 2011-2019 Microchip Technology Inc. and its subsidiaries.
#include "compiler.h"
Macros | |
#define | CKGR_MOR_KEY_PASSWD CKGR_MOR_KEY(0x37U) |
Key to unlock CKGR_MOR register. More... | |
#define | PMC_FAST_STARTUP_Msk (0x7FFFFu) |
Mask to access fast startup input. More... | |
#define | PMC_MASK_STATUS0 (0xFFFFFFFC) |
Bit mask for peripheral clocks (PCER0) More... | |
#define | PMC_MASK_STATUS1 (0xFFFFFFFF) |
Bit mask for peripheral clocks (PCER1) More... | |
#define | PMC_OSC_BYPASS 1 |
Oscillator in bypass mode. More... | |
#define | PMC_OSC_XTAL 0 |
Using external oscillator. More... | |
#define | PMC_PCK_0 0 /* PCK0 ID */ |
#define | PMC_PCK_1 1 /* PCK1 ID */ |
#define | PMC_PCK_2 2 /* PCK2 ID */ |
#define | PMC_PCK_3 3 /* PCK3 ID */ |
#define | PMC_PCK_4 4 /* PCK4 ID */ |
#define | PMC_PCK_5 5 /* PCK5 ID */ |
#define | PMC_PCK_6 6 /* PCK6 ID */ |
#define | PMC_PCK_7 7 /* PCK7 ID */ |
#define | PMC_TIMEOUT (2048) |
Loop counter timeout value. More... | |
#define | pmc_us_to_moscxtst(startup_us, slowck_freq) |
Convert startup time from us to MOSCXTST. More... | |
#define | PMC_WAIT_MODE_FLASH_DEEP_POWERDOWN PMC_FSMR_FLPM_FLASH_DEEP_POWERDOWN |
#define | PMC_WAIT_MODE_FLASH_IDLE PMC_FSMR_FLPM_FLASH_IDLE |
#define | PMC_WAIT_MODE_FLASH_STANDBY PMC_FSMR_FLPM_FLASH_STANDBY |
Flash state in Wait Mode. More... | |
#define | PMC_WPMR_WPKEY_PASSWD PMC_WPMR_WPKEY((uint32_t) 0x504D43) |
PMC_WPMR Write Protect KEY, unlock it. More... | |
#define | SUPC_CR_KEY_PASSWD SUPC_CR_KEY(0xA5U) |
Key used to write SUPC registers. More... | |
#define | SUPC_MR_KEY_PASSWD SUPC_MR_KEY(0xA5U) |
Functions | |
Master clock (MCK) Source and Prescaler configuration | |
| |
void | pmc_mck_set_prescaler (uint32_t ul_pres) |
Set the prescaler of the MCK. More... | |
void | pmc_mck_set_division (uint32_t ul_div) |
Set the division of the MCK. More... | |
void | pmc_mck_set_source (uint32_t ul_source) |
Set the source of the MCK. More... | |
uint32_t | pmc_switch_mck_to_sclk (uint32_t ul_pres) |
Switch master clock source selection to slow clock. More... | |
uint32_t | pmc_switch_mck_to_mainck (uint32_t ul_pres) |
Switch master clock source selection to main clock. More... | |
uint32_t | pmc_switch_mck_to_pllack (uint32_t ul_pres) |
Switch master clock source selection to PLLA clock. More... | |
uint32_t | pmc_switch_mck_to_pllbck (uint32_t ul_pres) |
Switch master clock source selection to PLLB clock. More... | |
uint32_t | pmc_switch_mck_to_upllck (uint32_t ul_pres) |
Switch master clock source selection to UPLL clock. More... | |
void | pmc_set_flash_in_wait_mode (uint32_t ul_flash_state) |
Set the embedded flash state in wait mode. More... | |
Slow clock (SLCK) oscillator and configuration | |
void | pmc_switch_sclk_to_32kxtal (uint32_t ul_bypass) |
Switch slow clock source selection to external 32k (Xtal or Bypass). More... | |
uint32_t | pmc_osc_is_ready_32kxtal (void) |
Check if the external 32k Xtal is ready. More... | |
Main Clock (MAINCK) oscillator and configuration | |
void | pmc_switch_mainck_to_fastrc (uint32_t ul_moscrcf) |
Switch main clock source selection to internal fast RC. More... | |
void | pmc_osc_enable_fastrc (uint32_t ul_rc) |
Enable fast RC oscillator. More... | |
void | pmc_osc_disable_fastrc (void) |
Disable the internal fast RC. More... | |
uint32_t | pmc_osc_is_ready_fastrc (void) |
Check if the main fastrc is ready. More... | |
void | pmc_osc_enable_main_xtal (uint32_t ul_xtal_startup_time) |
Enable main XTAL oscillator. More... | |
void | pmc_osc_bypass_main_xtal (void) |
Bypass main XTAL. More... | |
void | pmc_osc_disable_main_xtal (void) |
Disable the main Xtal. More... | |
uint32_t | pmc_osc_is_bypassed_main_xtal (void) |
Check if the main crystal is bypassed. More... | |
uint32_t | pmc_osc_is_ready_main_xtal (void) |
Check if the main crystal is ready. More... | |
void | pmc_switch_mainck_to_xtal (uint32_t ul_bypass, uint32_t ul_xtal_startup_time) |
Switch main clock source selection to external Xtal/Bypass. More... | |
void | pmc_osc_disable_xtal (uint32_t ul_bypass) |
Disable the external Xtal. More... | |
uint32_t | pmc_osc_is_ready_mainck (void) |
Check if the MAINCK is ready. More... | |
void | pmc_mainck_osc_select (uint32_t ul_xtal_rc) |
Select Main Crystal or internal RC as main clock source. More... | |
PLL oscillator and configuration | |
void | pmc_enable_pllack (uint32_t mula, uint32_t pllacount, uint32_t diva) |
Enable PLLA clock. More... | |
void | pmc_disable_pllack (void) |
Disable PLLA clock. More... | |
uint32_t | pmc_is_locked_pllack (void) |
Is PLLA locked? More... | |
void | pmc_enable_pllbck (uint32_t mulb, uint32_t pllbcount, uint32_t divb) |
Enable PLLB clock. More... | |
void | pmc_disable_pllbck (void) |
Disable PLLB clock. More... | |
uint32_t | pmc_is_locked_pllbck (void) |
Is PLLB locked? More... | |
void | pmc_enable_upll_clock (void) |
Enable UPLL clock. More... | |
void | pmc_disable_upll_clock (void) |
Disable UPLL clock. More... | |
uint32_t | pmc_is_locked_upll (void) |
Is UPLL locked? More... | |
Peripherals clock configuration | |
uint32_t | pmc_enable_periph_clk (uint32_t ul_id) |
Enable the specified peripheral clock. More... | |
uint32_t | pmc_disable_periph_clk (uint32_t ul_id) |
Disable the specified peripheral clock. More... | |
void | pmc_enable_all_periph_clk (void) |
Enable all peripheral clocks. More... | |
void | pmc_disable_all_periph_clk (void) |
Disable all peripheral clocks. More... | |
uint32_t | pmc_is_periph_clk_enabled (uint32_t ul_id) |
Check if the specified peripheral clock is enabled. More... | |
Programmable clock Source and Prescaler configuration | |
The following functions may be used to select the clock source and prescaler for the specified programmable clock. | |
void | pmc_pck_set_prescaler (uint32_t ul_id, uint32_t ul_pres) |
Set the prescaler for the specified programmable clock. More... | |
void | pmc_pck_set_source (uint32_t ul_id, uint32_t ul_source) |
Set the source oscillator for the specified programmable clock. More... | |
uint32_t | pmc_switch_pck_to_sclk (uint32_t ul_id, uint32_t ul_pres) |
Switch programmable clock source selection to slow clock. More... | |
uint32_t | pmc_switch_pck_to_mainck (uint32_t ul_id, uint32_t ul_pres) |
Switch programmable clock source selection to main clock. More... | |
uint32_t | pmc_switch_pck_to_pllack (uint32_t ul_id, uint32_t ul_pres) |
Switch programmable clock source selection to PLLA clock. More... | |
uint32_t | pmc_get_slck_config (void) |
Get Slow clock source configuration. More... | |
uint32_t | pmc_get_mainck_config (void) |
Get Main clock source configuration. More... | |
uint32_t | pmc_get_pllack_config (void) |
Get PLLA clock configuration. More... | |
uint32_t | pmc_get_upllckdiv_config (void) |
Get UPLLCKDIV configuration. More... | |
void | pmc_enable_cpck (void) |
Enable Coprocessor Clocks. More... | |
void | pmc_disable_cpck (void) |
Disable Coprocessor Clocks. More... | |
bool | pmc_is_cpck_enabled (void) |
Check if the Coprocessor Clocks is enabled. More... | |
void | pmc_enable_cpbmck (void) |
Enable Coprocessor Bus Master Clocks. More... | |
void | pmc_disable_cpbmck (void) |
Disable Coprocessor Bus Master Clocks. More... | |
bool | pmc_is_cpbmck_enabled (void) |
Check if the Coprocessor Bus Master Clocks is enabled. More... | |
void | pmc_cpck_set_prescaler (uint32_t ul_pres) |
Set the prescaler for the Coprocessor Master Clock. More... | |
void | pmc_cpck_set_source (uint32_t ul_source) |
Set the source for the Coprocessor Master Clock. More... | |
uint32_t | pmc_switch_pck_to_pllbck (uint32_t ul_id, uint32_t ul_pres) |
Switch programmable clock source selection to PLLB clock. More... | |
uint32_t | pmc_switch_pck_to_upllck (uint32_t ul_id, uint32_t ul_pres) |
Switch programmable clock source selection to UPLL clock. More... | |
uint32_t | pmc_switch_pck_to_mck (uint32_t ul_id, uint32_t ul_pres) |
Switch programmable clock source selection to mck. More... | |
void | pmc_enable_pck (uint32_t ul_id) |
Enable the specified programmable clock. More... | |
void | pmc_disable_pck (uint32_t ul_id) |
Disable the specified programmable clock. More... | |
void | pmc_enable_all_pck (void) |
Enable all programmable clocks. More... | |
void | pmc_disable_all_pck (void) |
Disable all programmable clocks. More... | |
uint32_t | pmc_is_pck_enabled (uint32_t ul_id) |
Check if the specified programmable clock is enabled. More... | |
USB clock configuration | |
void | pmc_switch_udpck_to_pllack (uint32_t ul_usbdiv) |
Switch UDP (USB) clock source selection to PLLA clock. More... | |
void | pmc_switch_udpck_to_pllbck (uint32_t ul_usbdiv) |
Switch UDP (USB) clock source selection to PLLB clock. More... | |
void | pmc_switch_udpck_to_upllck (uint32_t ul_usbdiv) |
Switch UDP (USB) clock source selection to UPLL clock. More... | |
void | pmc_enable_udpck (void) |
Enable UDP (USB) clock. More... | |
void | pmc_disable_udpck (void) |
Disable UDP (USB) clock. More... | |
void | pmc_switch_uhpck_to_pllack (uint32_t ul_usbdiv) |
Switch UHP (USB) clock source selection to PLLA clock. More... | |
void | pmc_switch_uhpck_to_pllbck (uint32_t ul_usbdiv) |
Switch UHP (USB) clock source selection to PLLB clock. More... | |
void | pmc_enable_uhpck (void) |
Enable UHP (USB) clock. More... | |
Interrupt and status management | |
void | pmc_enable_interrupt (uint32_t ul_sources) |
Enable PMC interrupts. More... | |
void | pmc_disable_interrupt (uint32_t ul_sources) |
Disable PMC interrupts. More... | |
uint32_t | pmc_get_interrupt_mask (void) |
Get PMC interrupt mask. More... | |
uint32_t | pmc_get_status (void) |
Get current status. More... | |
Power management | |
The following functions are used to configure sleep mode and additional wake up inputs. | |
void | pmc_set_fast_startup_input (uint32_t ul_inputs) |
Set the wake-up inputs for fast startup mode registers (event generation). More... | |
void | pmc_clr_fast_startup_input (uint32_t ul_inputs) |
Clear the wake-up inputs for fast startup mode registers (remove event generation). More... | |
void | pmc_cp_set_fast_startup_input (uint32_t ul_inputs) |
Set the wake-up inputs of coprocessor for fast startup mode registers (event generation). More... | |
void | pmc_cp_clr_fast_startup_input (uint32_t ul_inputs) |
Clear the wake-up inputs of coprocessor for fast startup mode registers (remove event generation). More... | |
void | pmc_enable_sleepmode (uint8_t uc_type) |
Enable Sleep Mode. More... | |
void | pmc_enable_waitmode (void) |
Enable Wait Mode. More... | |
void | pmc_enable_backupmode (void) |
Enable Backup Mode. More... | |
Failure detector | |
void | pmc_enable_clock_failure_detector (void) |
Enable Clock Failure Detector. More... | |
void | pmc_disable_clock_failure_detector (void) |
Disable Clock Failure Detector. More... | |
Slow Crystal Oscillator Frequency Monitoring | |
void | pmc_enable_sclk_osc_freq_monitor (void) |
Enable Slow Crystal Oscillator Frequency Monitoring. More... | |
void | pmc_disable_sclk_osc_freq_monitor (void) |
Disable Slow Crystal Oscillator Frequency Monitoring. More... | |
Write protection | |
void | pmc_set_writeprotect (uint32_t ul_enable) |
Enable or disable write protect of PMC registers. More... | |
uint32_t | pmc_get_writeprotect_status (void) |
Return write protect status. More... | |
Sleepwalking configuration | |
uint32_t | pmc_enable_sleepwalking (uint32_t ul_id) |
Enable the specified peripheral clock. More... | |
uint32_t | pmc_disable_sleepwalking (uint32_t ul_id) |
Disable the sleepwalking of specified peripheral. More... | |
uint32_t | pmc_get_sleepwalking_status0 (void) |
Return peripheral sleepwalking enable status. More... | |
uint32_t | pmc_get_active_status0 (void) |
Return peripheral active status. More... | |
uint32_t | pmc_get_sleepwalking_status1 (void) |
Return peripheral sleepwalking enable status. More... | |
uint32_t | pmc_get_active_status1 (void) |
Return peripheral active status. More... | |
#define CKGR_MOR_KEY_PASSWD CKGR_MOR_KEY(0x37U) |
Key to unlock CKGR_MOR register.
Referenced by pmc_disable_clock_failure_detector(), pmc_disable_sclk_osc_freq_monitor(), pmc_enable_clock_failure_detector(), pmc_enable_sclk_osc_freq_monitor(), pmc_enable_waitmode(), pmc_mainck_osc_select(), pmc_osc_bypass_main_xtal(), pmc_osc_disable_fastrc(), pmc_osc_disable_main_xtal(), pmc_osc_disable_xtal(), pmc_osc_enable_fastrc(), pmc_osc_enable_main_xtal(), pmc_restore_clock_setting(), pmc_save_clock_settings(), pmc_switch_mainck_to_fastrc(), and pmc_switch_mainck_to_xtal().
#define PMC_FAST_STARTUP_Msk (0x7FFFFu) |
Mask to access fast startup input.
Referenced by pmc_clr_fast_startup_input(), pmc_cp_clr_fast_startup_input(), pmc_cp_set_fast_startup_input(), and pmc_set_fast_startup_input().
#define PMC_MASK_STATUS0 (0xFFFFFFFC) |
Bit mask for peripheral clocks (PCER0)
Referenced by pmc_disable_all_periph_clk(), and pmc_enable_all_periph_clk().
#define PMC_MASK_STATUS1 (0xFFFFFFFF) |
Bit mask for peripheral clocks (PCER1)
Referenced by pmc_disable_all_periph_clk(), and pmc_enable_all_periph_clk().
#define PMC_OSC_BYPASS 1 |
Oscillator in bypass mode.
Referenced by osc_disable(), and osc_enable().
#define PMC_OSC_XTAL 0 |
Using external oscillator.
Referenced by osc_disable(), and osc_enable().
#define PMC_PCK_0 0 /* PCK0 ID */ |
#define PMC_PCK_1 1 /* PCK1 ID */ |
#define PMC_PCK_2 2 /* PCK2 ID */ |
#define PMC_PCK_3 3 /* PCK3 ID */ |
#define PMC_PCK_4 4 /* PCK4 ID */ |
#define PMC_PCK_5 5 /* PCK5 ID */ |
#define PMC_PCK_6 6 /* PCK6 ID */ |
#define PMC_PCK_7 7 /* PCK7 ID */ |
#define PMC_TIMEOUT (2048) |
Loop counter timeout value.
Referenced by pmc_switch_mck_to_mainck(), pmc_switch_mck_to_pllack(), pmc_switch_mck_to_pllbck(), pmc_switch_mck_to_sclk(), pmc_switch_mck_to_upllck(), pmc_switch_pck_to_mainck(), pmc_switch_pck_to_mck(), pmc_switch_pck_to_pllack(), pmc_switch_pck_to_pllbck(), pmc_switch_pck_to_sclk(), and pmc_switch_pck_to_upllck().
#define pmc_us_to_moscxtst | ( | startup_us, | |
slowck_freq | |||
) |
Convert startup time from us to MOSCXTST.
Referenced by osc_enable().
#define PMC_WAIT_MODE_FLASH_DEEP_POWERDOWN PMC_FSMR_FLPM_FLASH_DEEP_POWERDOWN |
#define PMC_WAIT_MODE_FLASH_IDLE PMC_FSMR_FLPM_FLASH_IDLE |
Referenced by pmc_enable_waitmode().
#define PMC_WAIT_MODE_FLASH_STANDBY PMC_FSMR_FLPM_FLASH_STANDBY |
Flash state in Wait Mode.
#define PMC_WPMR_WPKEY_PASSWD PMC_WPMR_WPKEY((uint32_t) 0x504D43) |
PMC_WPMR Write Protect KEY, unlock it.
Referenced by pmc_set_writeprotect().
#define SUPC_CR_KEY_PASSWD SUPC_CR_KEY(0xA5U) |
Key used to write SUPC registers.
Referenced by pmc_enable_backupmode(), pmc_sleep(), and pmc_switch_sclk_to_32kxtal().
#define SUPC_MR_KEY_PASSWD SUPC_MR_KEY(0xA5U) |
Referenced by pmc_enable_backupmode(), and pmc_switch_sclk_to_32kxtal().