RTEMS  5.0.0
pmc.h
1 /* ---------------------------------------------------------------------------- */
2 /* Atmel Microcontroller Software Support */
3 /* SAM Software Package License */
4 /* ---------------------------------------------------------------------------- */
5 /* Copyright (c) 2015, Atmel Corporation */
6 /* */
7 /* All rights reserved. */
8 /* */
9 /* Redistribution and use in source and binary forms, with or without */
10 /* modification, are permitted provided that the following condition is met: */
11 /* */
12 /* - Redistributions of source code must retain the above copyright notice, */
13 /* this list of conditions and the disclaimer below. */
14 /* */
15 /* Atmel's name may not be used to endorse or promote products derived from */
16 /* this software without specific prior written permission. */
17 /* */
18 /* DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR */
19 /* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF */
20 /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE */
21 /* DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT, */
22 /* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT */
23 /* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, */
24 /* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF */
25 /* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING */
26 /* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, */
27 /* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
28 /* ---------------------------------------------------------------------------- */
29 
30 #ifndef _PMC_
31 #define _PMC_
32 
33 /*----------------------------------------------------------------------------
34  * Headers
35  *----------------------------------------------------------------------------*/
36 #include <stdint.h>
37 
38 
39 /*----------------------------------------------------------------------------
40  * Definitions
41  *----------------------------------------------------------------------------*/
42 /* Definition for fast RC frequency */
43 #define FAST_RC_4MHZ CKGR_MOR_MOSCRCF_4MHz
44 #define FAST_RC_8MHZ CKGR_MOR_MOSCRCF_8MHz
45 #define FAST_RC_12MHZ CKGR_MOR_MOSCRCF_12MHz
46 
47 /* Definitions for startup count.
48  * Note: 1 count unit stand for: 1 / 32768 * 8 = 244 us
49  */
50 /* Default startup count for 4/8/12MHz fast RC (startup time: 10us) */
51 #define DEFAUTL_FAST_RC_COUNT 1
52 /* Default startup count for 3-20MHz main oscillator (startup time: 1.4ms) */
53 #define DEFAUTL_MAIN_OSC_COUNT 8
54 /* Default startup count for PLLA (startup time: 200us) */
55 #define DEFAUTL_PLLA_COUNT 1
56 /* Default startup count for UPLL */
57 #define DEFAUTL_UPLL_COUNT 3
58 /* No change for default startup count */
59 #define DEFAUTL_COUNT_NO_CHANGE 0xFFFF
60 
61 
62 /*----------------------------------------------------------------------------
63  * Exported functions
64  *----------------------------------------------------------------------------*/
65 
66 #ifdef __cplusplus
67 extern "C" {
68 #endif
69 
70 extern void PMC_EnablePeripheral(uint32_t dwId);
71 extern void PMC_DisablePeripheral(uint32_t dwId);
72 
73 extern void PMC_EnableAllPeripherals(void);
74 extern void PMC_DisableAllPeripherals(void);
75 
76 extern uint32_t PMC_IsPeriphEnabled(uint32_t dwId);
77 
78 extern void PMC_SelectExtOsc(void);
79 extern void PMC_EnableExtOsc(void);
80 extern void PMC_DisableExtOsc(void);
81 extern void PMC_SelectExtBypassOsc(void);
82 extern void PMC_EnableIntRC4_8_12MHz(uint32_t fastRcFreq);
83 extern void PMC_DisableIntRC4_8_12MHz(void);
84 extern void PMC_SetPllaClock(uint32_t mul, uint32_t div);
85 extern void PMC_SetPllbClock(uint32_t mul, uint32_t div);
86 extern void PMC_SetMckSelection(uint32_t clockSource, uint32_t prescaler);
87 extern void PMC_DisableAllClocks(void);
88 extern void PMC_ConfigureMckWithPlla(uint32_t mul, uint32_t div,
89  uint32_t prescaler);
90 extern void PMC_ConfigureMckWithPllb(uint32_t mul, uint32_t div,
91  uint32_t prescaler);
92 extern void PMC_EnableXT32KFME(void);
93 extern void PMC_ConfigurePCK0(uint32_t MasterClk, uint32_t prescaler);
94 extern void PMC_ConfigurePCK1(uint32_t MasterClk, uint32_t prescaler);
95 extern void PMC_ConfigurePCK2(uint32_t MasterClk, uint32_t prescaler);
96 
97 #ifdef __cplusplus
98 }
99 #endif
100 
101 #endif /* #ifndef _PMC_ */
void PMC_DisableExtOsc(void)
Disable external 12MHz oscillator.
Definition: pmc.c:296
void PMC_DisableIntRC4_8_12MHz(void)
Disable internal 4/8/12MHz fast RC.
Definition: pmc.c:398
uint32_t PMC_IsPeriphEnabled(uint32_t dwId)
Get Periph Status for the given peripheral ID.
Definition: pmc.c:243
void PMC_EnablePeripheral(uint32_t dwId)
Enables the clock of a peripheral. The peripheral ID is used to identify which peripheral is targeted...
Definition: pmc.c:156
void PMC_ConfigurePCK1(uint32_t MasterClk, uint32_t prescaler)
Configure PLLA as clock input for MCK.
Definition: pmc.c:566
void PMC_EnableExtOsc(void)
Enable external oscillator as main clock input.
Definition: pmc.c:257
void PMC_DisableAllClocks(void)
Disable all clocks.
Definition: pmc.c:467
void PMC_SetMckSelection(uint32_t clockSource, uint32_t prescaler)
Selection of Master Clock.
Definition: pmc.c:444
void PMC_SelectExtBypassOsc(void)
Select external OSC.
Definition: pmc.c:341
void PMC_EnableIntRC4_8_12MHz(uint32_t freqSelect)
Enable internal 4/8/12MHz fast RC as main clock input.
Definition: pmc.c:368
void PMC_ConfigurePCK2(uint32_t MasterClk, uint32_t prescaler)
Configure PLLA as clock input for MCK.
Definition: pmc.c:586
void PMC_DisableAllPeripherals(void)
Disable all the periph clock via PMC.
Definition: pmc.c:225
void PMC_EnableAllPeripherals(void)
Enable all the periph clock via PMC.
Definition: pmc.c:209
void PMC_SelectExtOsc(void)
Select external OSC.
Definition: pmc.c:310
void PMC_SetPllaClock(uint32_t mul, uint32_t div)
Configure PLLA clock by giving MUL and DIV. Disable PLLA when &#39;mul&#39; set to 0.
Definition: pmc.c:418
void PMC_DisablePeripheral(uint32_t dwId)
Disables the clock of a peripheral. The peripheral ID is used to identify which peripheral is targete...
Definition: pmc.c:185
void PMC_ConfigureMckWithPlla(uint32_t mul, uint32_t div, uint32_t prescaler)
Configure PLLA as clock input for MCK.
Definition: pmc.c:496
void PMC_EnableXT32KFME(void)
Configure PLLA as clock input for MCK.
Definition: pmc.c:520
void PMC_ConfigurePCK0(uint32_t MasterClk, uint32_t prescaler)
Configure PLLA as clock input for MCK.
Definition: pmc.c:545