Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
System Clock internals

System clock management is fairly straightforward apart from one thing: Enabling and disabling bus bridges. When all peripherals on a given bus are disabled, the bridge to the bus may be disabled. Only the PBA and PBB busses support this, and it is not practical to disable the PBA bridge as it includes the Power Manager, so turning it off would make it impossible to turn anything back on again.

The system clock implementation keeps track of a reference count for PBB. When the reference count is zero, the bus bridge is disabled, otherwise it is enabled.

Functions

void sysclk_priv_disable_module (unsigned int bus_id, unsigned int module_index)
 Disable a maskable module clock. More...
 
void sysclk_priv_enable_module (unsigned int bus_id, unsigned int module_index)
 Enable a maskable module clock. More...
 

Variables

static uint8_t sysclk_pbb_refcount
 Number of enabled peripherals on the PBB bus. More...
 

Initial module clock masks

These are the mask values written to the xxxMASK registers during initialization if the user has overridden the default behavior of all clocks left enabled. These values assume that:

  • Debugging should be possible
  • The program may be running from flash
  • The PM should be available to unmask other clocks
  • All on-chip RAM should be available
  • INTC, PM and GPIO are made permanently available for now; this may change in the future.
#define SYSCLK_INIT_MINIMAL_CPUMASK   ((1 << SYSCLK_OCD) | (1 << SYSCLK_SYSTIMER))
 Initial value of CPUMASK. More...
 
#define SYSCLK_INIT_MINIMAL_HSBMASK
 Initial value of HSBMASK. More...
 
#define SYSCLK_INIT_MINIMAL_PBAMASK
 Initial value of PBAMASK. More...
 
#define SYSCLK_INIT_MINIMAL_PBBMASK   0
 Initial value of PBBMASK. More...
 

#define SYSCLK_INIT_MINIMAL_CPUMASK   ((1 << SYSCLK_OCD) | (1 << SYSCLK_SYSTIMER))

Initial value of CPUMASK.

Referenced by sysclk_init().

#define SYSCLK_INIT_MINIMAL_HSBMASK
Value:
#define SYSCLK_FLASHC_DATA
Flash data interface.
Definition: uc3b0_b1/sysclk.h:229
#define SYSCLK_PBA_BRIDGE
HSB&lt;-&gt;PBA bridge.
Definition: uc3b0_b1/sysclk.h:231

Initial value of HSBMASK.

Referenced by sysclk_init().

#define SYSCLK_INIT_MINIMAL_PBAMASK
Value:
((1 << SYSCLK_INTC) \
| (1 << SYSCLK_GPIO) \
| (1 << SYSCLK_PM))
#define SYSCLK_PM
PM/RTC/EIM configuration.
Definition: uc3b0_b1/sysclk.h:249
#define SYSCLK_INTC
Internal interrupt controller.
Definition: uc3b0_b1/sysclk.h:243
#define SYSCLK_GPIO
General-Purpose I/O.
Definition: uc3b0_b1/sysclk.h:245

Initial value of PBAMASK.

Referenced by sysclk_init().

#define SYSCLK_INIT_MINIMAL_PBBMASK   0

Initial value of PBBMASK.

Referenced by sysclk_init().

void sysclk_priv_disable_module ( unsigned int  bus_id,
unsigned int  module_index 
)

Disable a maskable module clock.

Parameters
bus_idBus index, given by the AVR32_PM_CLK_GRP_xxx definitions.
module_indexIndex of the module to be disabled. This is the bit number in the corresponding xxxMASK register.

References cpu_irq_restore(), and cpu_irq_save().

Referenced by sysclk_disable_cpu_module(), sysclk_disable_hsb_module(), sysclk_disable_pba_module(), and sysclk_disable_pbb_module().

void sysclk_priv_enable_module ( unsigned int  bus_id,
unsigned int  module_index 
)

Enable a maskable module clock.

Parameters
bus_idBus index, given by the AVR32_PM_CLK_GRP_xxx definitions.
module_indexIndex of the module to be enabled. This is the bit number in the corresponding xxxMASK register.

References cpu_irq_restore(), and cpu_irq_save().

Referenced by sysclk_enable_cpu_module(), sysclk_enable_hsb_module(), sysclk_enable_pba_module(), and sysclk_enable_pbb_module().

uint8_t sysclk_pbb_refcount
static

Number of enabled peripherals on the PBB bus.

Referenced by sysclk_disable_pbb_module(), and sysclk_enable_pbb_module().