LEON3 and LEON4

LEON3 and LEON4 Board Support Package. More...

Topics
	GR740 Bootstrap Signals
	This group contains the GR740 Bootstrap Signals interfaces.
	GR740 I/0 and PLL Configuration
	This group contains the GR740 I/0 and PLL Configuration interfaces.
	GR740 Temperatur Sensor Controller
	This group contains the GR740 Temperatur Sensor Controller interfaces.
	LEON3 AMBA Driver Handler
	AMBA Plag & Play Bus Driver Macros.

Files
file	bsps/sparc/include/bsp/gr_leon4_n2x.h
	This header file provides interfaces of the GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver.
file	bsps/sparc/leon3/clock/ckinit.c
	This source file contains the Clock Driver implementation.
file	bsps/sparc/leon3/console/printk_support.c
	This source file contains the definition of BSP_output_char and BSP_poll_char.
file	bsps/sparc/leon3/gnatsupp/gnatsupp.c
	Support for gnat/rtems interrupts and exception handling.
file	bsps/sparc/leon3/include/bsp.h
	Global BSP definitions.
file	bsps/sparc/leon3/include/bsp/irq.h
	LEON3 generic shared IRQ setup.
file	bsps/sparc/leon3/include/bsp/irqimpl.h
	This header file provides interfaces used by the interrupt support implementation.
file	bsps/sparc/leon3/include/bsp/leon3.h
	This header file provides interfaces used by the BSP implementation.
file	bsps/sparc/leon3/include/leon.h
	LEON3 BSP data types and macros.
file	bsps/sparc/leon3/include/tm27.h
	Implementations for interrupt mechanisms for Time Test 27.
file	bsps/sparc/leon3/start/bspsmp.c
	LEON3 SMP BSP Support.
file	bsps/sparc/leon3/start/bspstart.c
	This source file contains the implementation of bsp_start() and definitions of BSP-specific objects.
file	bsps/sparc/leon3/start/cache.c
	This source file contains the implementation of the Cache Manager.
file	bsps/sparc/leon3/start/cpucounter.c
	This source file contains the implementation of the CPU Counter.
file	bsps/sparc/leon3/start/eirq.c
	This source file contains the implementation of the interrupt controller support.
file	bsps/sparc/leon3/start/gettargethash.c
	This source file contains the sparc/leon3 implementation of rtems_get_target_hash().
file	bsps/sparc/leon3/start/setvec.c
	Install an interrupt vector on SPARC.
file	bsps/sparc/shared/irq/bsp_isr_handler.c
	This source file contains the implementation of _SPARC_Interrupt_dispatch().

Data Structures
struct	leon3_timecounter
	Represents the LEON3-specific timecounter. More...

Macros
#define	LEON3   1
#define	BSP_FEATURE_IRQ_EXTENSION
#define	BSP_IDLE_TASK_BODY   bsp_idle_thread
#define	BSP_NUMBER_OF_TERMIOS_PORTS   8
#define	RTEMS_BSP_NETWORK_DRIVER_NAME_OPENETH   "open_eth1"
#define	RTEMS_BSP_NETWORK_DRIVER_ATTACH_OPENETH   rtems_leon_open_eth_driver_attach
#define	RTEMS_BSP_NETWORK_DRIVER_NAME_SMC91111   "smc_eth1"
#define	RTEMS_BSP_NETWORK_DRIVER_ATTACH_SMC91111   rtems_smc91111_driver_attach_leon3
#define	RTEMS_BSP_NETWORK_DRIVER_NAME_GRETH   "gr_eth1"
#define	RTEMS_BSP_NETWORK_DRIVER_ATTACH_GRETH   rtems_leon_greth_driver_attach
#define	RTEMS_BSP_NETWORK_DRIVER_NAME   RTEMS_BSP_NETWORK_DRIVER_NAME_GRETH
#define	RTEMS_BSP_NETWORK_DRIVER_ATTACH   RTEMS_BSP_NETWORK_DRIVER_ATTACH_GRETH
#define	HAS_SMC91111
#define	GRETH_SUPPORTED
#define	GRETH_MEM_LOAD(addr)
#define	AMBAPPBUS_INFO_AVAIL
#define	APBUART_INFO_AVAIL
#define	GPTIMER_INFO_AVAIL
#define	GRETH_INFO_AVAIL
#define	LEON3_IRQCTRL_ACQUIRE(_lock_context)
	Acquires the interrupt controller lock.
#define	LEON3_IRQCTRL_RELEASE(_lock_context)
	Releases the interrupt controller lock.
#define	LEON3_REG_CACHE_CTRL_FI   0x00200000U
	This constant represents the flush instruction cache flag of the LEON cache control register.
#define	LEON3_REG_CACHE_CTRL_DS   0x00800000U
	This constant represents the data cache snooping enable flag of the LEON cache control register.
#define	LEON3_CLOCK_INDEX   0
	This constant defines the index of the GPTIMER timer used by the clock driver.
#define	LEON3_COUNTER_GPTIMER_INDEX   ( LEON3_CLOCK_INDEX + 1 )
	This constant defines the index of the GPTIMER timer used by the CPU counter if the CPU counter uses the GPTIMER.
#define	LEON3_GPTIMER_0_FREQUENCY_SET_BY_BOOT_LOADER   1000000
	This constant defines the frequency set by the boot loader of the first GPTIMER instance.

Typedefs
typedef void(*)	bsp_shared_isr(void *arg)

Functions
void *	bsp_idle_thread (uintptr_t ignored)
	Optimized idle task.
int	rtems_leon_open_eth_driver_attach (struct rtems_bsdnet_ifconfig *config, int attach)
int	rtems_smc91111_driver_attach_leon3 (struct rtems_bsdnet_ifconfig *config, int attach)
int	rtems_leon_greth_driver_attach (struct rtems_bsdnet_ifconfig *config, int attach)
rtems_isr_entry	set_vector (rtems_isr_entry handler, rtems_vector_number vector, int type)
void	BSP_fatal_exit (uint32_t error)
void	rtems_bsp_delay (int usecs)
void	leon3_ext_irq_init (irqamp *regs)
	Initializes the interrupt controller for the boot processor.
RTEMS_NO_RETURN void	leon3_power_down_loop (void)
	Sets asr19 to zero to enter the power-down mode of the processor in an infinite loop.

Variables
int	CPU_SPARC_HAS_SNOOPING
int	RAM_START
int	RAM_END
int	RAM_SIZE
int	PROM_START
int	PROM_END
int	PROM_SIZE
int	CLOCK_SPEED
int	end
uint32_t	LEON3_Cpu_Index
	This object provides the index of the boot processor.
rtems_interrupt_lock	LEON3_IrqCtrl_Lock
	This lock serializes the interrupt controller access.
irqamp *	LEON3_IrqCtrl_Regs
	This pointer provides the IRQ(A)MP register block address.
struct ambapp_dev *	LEON3_IrqCtrl_Adev
	This pointer provides the IRQ(A)MP device information block.
uint32_t	LEON3_IrqCtrl_EIrq
	This object provides the interrupt number used to multiplex extended interrupts or is zero if no extended interrupts are available.
int	leon3_timer_core_index
	This object lets the user override which on-chip GPTIMER core will be used for system clock timer.
unsigned int	leon3_timer_prescaler
	This object lets the user override system clock timer prescaler.
gptimer *	LEON3_Timer_Regs
	This pointer provides the GPTIMER register block address.
struct ambapp_dev *	LEON3_Timer_Adev
	This pointer provides the GPTIMER device information block.
apbuart *	leon3_debug_uart
	This pointer provides the debug APBUART register block address.
leon3_timecounter	leon3_timecounter_instance
	Provides the LEON3-specific timecounter.

Detailed Description

LEON3 and LEON4 Board Support Package.

Macro Definition Documentation

GRETH_MEM_LOAD

#define GRETH_MEM_LOAD

(

addr

)

Value:

leon_r32_no_cache((uintptr_t)addr)

LEON3_GPTIMER_0_FREQUENCY_SET_BY_BOOT_LOADER

#define LEON3_GPTIMER_0_FREQUENCY_SET_BY_BOOT_LOADER   1000000

This constant defines the frequency set by the boot loader of the first GPTIMER instance.

We assume that a boot loader (usually GRMON) initialized the GPTIMER 0 to run with 1MHz. This is used to determine all clock frequencies of the PnP devices. See also ambapp_freq_init() and ambapp_freq_get().

LEON3_IRQCTRL_ACQUIRE

#define LEON3_IRQCTRL_ACQUIRE

(

_lock_context

)

Value:

rtems_interrupt_lock_acquire( &LEON3_IrqCtrl_Lock, _lock_context )

Acquires the interrupt controller lock.

Parameters

[out]

_lock_context

is the lock context.

LEON3_IRQCTRL_RELEASE

#define LEON3_IRQCTRL_RELEASE

(

_lock_context

)

Value:

rtems_interrupt_lock_release( &LEON3_IrqCtrl_Lock, _lock_context )

Releases the interrupt controller lock.

Parameters

[in,out]

_lock_context

is the lock context.

Function Documentation

bsp_idle_thread()

void * bsp_idle_thread

(

uintptr_t

ignored

)

Optimized idle task.

This idle task sets the power mode to idle. This causes the processor clock to be stopped, while on-chip peripherals remain active. Any enabled interrupt from a peripheral or an external interrupt source will cause the processor to resume execution.

To enable the idle task use the following in the system configuration:

#include <bsp.h>
 
#define CONFIGURE_INIT
 
#define CONFIGURE_IDLE_TASK_BODY bsp_idle_thread
 
#include <confdefs.h>

leon3_ext_irq_init()

void leon3_ext_irq_init

(

irqamp *

regs

)

Initializes the interrupt controller for the boot processor.

Parameters

[in,out]

regs

is the IRQ(A)MP register block address.

Variable Documentation

LEON3_Cpu_Index

uint32_t LEON3_Cpu_Index

extern

This object provides the index of the boot processor.

This object should be read-only after initialization.

LEON3_IrqCtrl_EIrq

uint32_t LEON3_IrqCtrl_EIrq

extern

This object provides the interrupt number used to multiplex extended interrupts or is zero if no extended interrupts are available.

This object should be read-only after initialization.

leon3_timecounter_instance

leon3_timecounter leon3_timecounter_instance

extern

Provides the LEON3-specific timecounter.

It is also used by the CPU counter implementation.

leon3_timer_core_index

int leon3_timer_core_index

extern

This object lets the user override which on-chip GPTIMER core will be used for system clock timer.

This controls which timer core will be accociated with LEON3_Timer_Regs registers base address. This value will by destroyed during initialization.

• 0 = Default configuration. GPTIMER[0]
• 1 = GPTIMER[1]
• 2 = GPTIMER[2]
• ...

leon3_timer_prescaler

unsigned int leon3_timer_prescaler

extern

This object lets the user override system clock timer prescaler.

This affects all timer instances on the system clock timer core determined by leon3_timer_core_index.

• 0 = Default configuration. Use bootloader configured value.
• N = Prescaler is set to N. N must not be less that number of timers.
• 8 = Prescaler is set to 8 (the fastest prescaler possible on all HW)
• ...