AMBA

AMBA Plug & Play routines. More...

Files
file	bsps/include/grlib/ambapp.h
file	bsps/include/grlib/ambapp_ids.h
	AMBA Plug & Play Bus Vendor and Device IDs.
file	bsps/include/grlib/grlib.h
	Common GRLIB AMBA Core Register definitions.

Data Structures
struct	ambapp_common_info
struct	ambapp_apb_info
struct	ambapp_ahb_info
struct	ambapp_dev
struct	ambapp_core
struct	ambapp_ahb_bus
struct	ambapp_mmap
struct	ambapp_bus
struct	ambapp_pnp_ahb
struct	ambapp_pnp_apb
struct	ambapp_context

Macros
#define	AHB_BUS_MAX   6
#define	AMBAPP_FLAG_FFACT_DIR   0x100
#define	AMBAPP_FLAG_FFACT   0x0f0
#define	AMBAPP_FLAG_MBUS   0x00c
#define	AMBAPP_FLAG_SBUS   0x003
#define	DEV_TO_APB(adev)
#define	DEV_TO_AHB(adev)
#define	DEV_TO_COMMON(adev)
#define	DEV_IS_FREE(dev)
#define	DEV_IS_ALLOCATED(dev)
#define	OPTIONS_AHB_MSTS   0x00000001
#define	OPTIONS_AHB_SLVS   0x00000002
#define	OPTIONS_APB_SLVS   0x00000004
#define	OPTIONS_ALL_DEVS   (OPTIONS_AHB_MSTS|OPTIONS_AHB_SLVS|OPTIONS_APB_SLVS)
#define	OPTIONS_FREE   0x00000010
#define	OPTIONS_ALLOCATED   0x00000020
#define	OPTIONS_ALL   (OPTIONS_FREE|OPTIONS_ALLOCATED)
#define	OPTIONS_DEPTH_FIRST   0x00000100
#define	DEV_AHB_NONE   0
#define	DEV_AHB_MST   1
#define	DEV_AHB_SLV   2
#define	DEV_APB_SLV   3
#define	ambapp_pnp_vendor(id)
#define	ambapp_pnp_device(id)
#define	ambapp_pnp_ver(id)
#define	ambapp_pnp_irq(id)
#define	ambapp_pnp_start(mbar)
#define	ambapp_pnp_mbar_mask(mbar)
#define	ambapp_pnp_mbar_type(mbar)
#define	ambapp_pnp_apb_start(iobar, base)
#define	ambapp_pnp_apb_mask(iobar)
#define	AMBA_TYPE_AHBIO_ADDR(addr, base_ioarea)
#define	AMBA_TYPE_APBIO   0x1
#define	AMBA_TYPE_MEM   0x2
#define	AMBA_TYPE_AHBIO   0x3

Typedefs
typedef int(*)	ambapp_func_t(struct ambapp_dev *dev, int index, void *arg)
typedef void *(*)	ambapp_memcpy_t(void *dest, const void *src, int n, struct ambapp_bus *abus)

Functions
struct ambapp_bus *	ambapp_plb (void)
	Gets the fully scanned AMBA Plug & Play Processor Local Bus (PLB).
int	ambapp_scan (struct ambapp_bus *abus, unsigned int ioarea, const struct ambapp_context *ctx, struct ambapp_mmap *mmaps)
void	ambapp_freq_init (struct ambapp_bus *abus, struct ambapp_dev *dev, unsigned int freq)
unsigned int	ambapp_freq_get (struct ambapp_bus *abus, struct ambapp_dev *dev)
int	ambapp_for_each (struct ambapp_bus *abus, unsigned int options, int vendor, int device, ambapp_func_t func, void *arg)
int	ambapp_find_by_idx (struct ambapp_dev *dev, int index, void *pcount)
int	ambapp_dev_count (struct ambapp_bus *abus, unsigned int options, int vendor, int device)
void	ambapp_print (struct ambapp_bus *abus, int show_depth)
int	ambapp_alloc_dev (struct ambapp_dev *dev, void *owner)
void	ambapp_free_dev (struct ambapp_dev *dev)
struct ambapp_dev *	ambapp_find_parent (struct ambapp_dev *dev)
int	ambapp_depth (struct ambapp_dev *dev)
char *	ambapp_device_id2str (int vendor, int id)
char *	ambapp_vendor_id2str (int vendor)
int	ambapp_vendev_id2str (int vendor, int id, char *buf)
int	ambapp_find_apbslv (struct ambapp_bus *abus, int vendor, int device, struct ambapp_apb_info *dev)
int	ambapp_find_apbslv_next (struct ambapp_bus *abus, int vendor, int device, struct ambapp_apb_info *dev, int index)
int	ambapp_find_apbslvs_next (struct ambapp_bus *abus, int vendor, int device, struct ambapp_apb_info *dev, int index, int maxno)
int	ambapp_find_apbslvs (struct ambapp_bus *abus, int vendor, int device, struct ambapp_apb_info *dev, int maxno)
int	ambapp_find_ahbslv (struct ambapp_bus *abus, int vendor, int device, struct ambapp_ahb_info *dev)
int	ambapp_find_ahbslv_next (struct ambapp_bus *abus, int vendor, int device, struct ambapp_ahb_info *dev, int index)
int	ambapp_find_ahbslvs_next (struct ambapp_bus *abus, int vendor, int device, struct ambapp_ahb_info *dev, int index, int maxno)
int	ambapp_find_ahbslvs (struct ambapp_bus *abus, int vendor, int device, struct ambapp_ahb_info *dev, int maxno)
int	ambapp_get_number_ahbslv_devices (struct ambapp_bus *abus, int vendor, int device)
int	ambapp_get_number_apbslv_devices (struct ambapp_bus *abus, int vendor, int device)

Detailed Description

AMBA Plug & Play routines.

Macro Definition Documentation

AMBA_TYPE_AHBIO_ADDR

#define AMBA_TYPE_AHBIO_ADDR	(		addr,
			base_ioarea )

Value:

((unsigned int)(base_ioarea) | ((addr) >> 12))

ambapp_pnp_apb_mask

#define ambapp_pnp_apb_mask

(

iobar

)

Value:

((~(ambapp_pnp_mbar_mask(iobar)<<8) & 0x000fffff) + 1)

ambapp_pnp_apb_start

#define ambapp_pnp_apb_start	(		iobar,
			base )

Value:

((base) | ((((iobar) & 0xfff00000)>>12) & (((iobar) & 0xfff0)<<4)) )

ambapp_pnp_device

#define ambapp_pnp_device

(

id

)

Value:

(((id) >> 12) & 0xfff)

ambapp_pnp_irq

#define ambapp_pnp_irq

(

id

)

Value:

((id) & 0x1f)

ambapp_pnp_mbar_mask

#define ambapp_pnp_mbar_mask

(

mbar

)

Value:

(((mbar)>>4) & 0xfff)

ambapp_pnp_mbar_type

#define ambapp_pnp_mbar_type

(

mbar

)

Value:

((mbar) & 0xf)

ambapp_pnp_start

#define ambapp_pnp_start

(

mbar

)

Value:

(((mbar) & 0xfff00000) & (((mbar) & 0xfff0) << 16))

ambapp_pnp_vendor

#define ambapp_pnp_vendor

(

id

)

Value:

(((id) >> 24) & 0xff)

ambapp_pnp_ver

#define ambapp_pnp_ver

(

id

)

Value:

(((id)>>5) & 0x1f)

DEV_IS_ALLOCATED

#define DEV_IS_ALLOCATED

(

dev

)

Value:

(dev->owner != NULL)

DEV_IS_FREE

#define DEV_IS_FREE

(

dev

)

Value:

(dev->owner == NULL)

DEV_TO_AHB

#define DEV_TO_AHB

(

adev

)

Value:

((struct ambapp_ahb_info *)((adev)->devinfo))

DEV_TO_APB

#define DEV_TO_APB

(

adev

)

Value:

((struct ambapp_apb_info *)((adev)->devinfo))

DEV_TO_COMMON

#define DEV_TO_COMMON

(

adev

)

Value:

(((adev)->devinfo))