IALG - XDAIS Algorithm Interface

Defines
#define	IALG_DEFMEMRECS   4
#define	IALG_OBJMEMREC   0
#define	IALG_SYSCMD   256
#define	IALG_EOK   0
#define	IALG_EFAIL   (-1)
#define	IALG_CUSTOMFAILBASE   (-2048)
#define	IALG_CUSTOMFAILEND   (-256)
#define	IALG_MPROG   0x0008
#define	IALG_MXTRN   0x0010
#define	IALG_isProg(s)
#define	IALG_isOffChip(s)
Data Structures
struct	IALG_MemRec
	Memory records. More...
struct	IALG_Obj
	Algorithm instance object definition. More...
struct	IALG_Params
	Algorithm instance creation parameters. More...
struct	IALG_Status
	Pointer to algorithm specific status structure. More...
struct	IALG_Fxns
	Defines the fields and methods that must be supplied by all XDAIS algorithms. More...
Typedefs
typedef enum IALG_MemAttrs	IALG_MemAttrs
	Memory attributes.
typedef enum IALG_MemSpace	IALG_MemSpace
	Defined memory spaces.
typedef struct IALG_MemRec	IALG_MemRec
	Memory records.
typedef struct IALG_Obj	IALG_Obj
	Algorithm instance object definition.
typedef struct IALG_Obj *	IALG_Handle
	Handle to an algorithm instance object.
typedef struct IALG_Params	IALG_Params
	Algorithm instance creation parameters.
typedef struct IALG_Status	IALG_Status
	Pointer to algorithm specific status structure.
typedef unsigned int	IALG_Cmd
	Algorithm specific command.
typedef struct IALG_Fxns	IALG_Fxns
	Defines the fields and methods that must be supplied by all XDAIS algorithms.
Enumerations
enum	IALG_MemAttrs {   IALG_SCRATCH,   IALG_PERSIST,   IALG_WRITEONCE }
	Memory attributes. More...
enum	IALG_MemSpace {   IALG_EPROG,   IALG_IPROG,   IALG_ESDATA,   IALG_EXTERNAL,   IALG_DARAM0 = 0,   IALG_DARAM1 = 1,   IALG_SARAM = 2,   IALG_SARAM0 = 2,   IALG_SARAM1 = 3,   IALG_DARAM2 = 4,   IALG_SARAM2 = 5 }
	Defined memory spaces. More...

---

Detailed Description

This is the XDAIS IALG interface.

---

Define Documentation

#define IALG_DEFMEMRECS   4

Default number of memory records.

#define IALG_OBJMEMREC   0

Memory record index of instance object.

#define IALG_SYSCMD   256

Minimum "system" IALG_Cmd value.

#define IALG_EOK   0

Successful return status code.

#define IALG_EFAIL   (-1)

Unspecified error return status code.

#define IALG_CUSTOMFAILBASE   (-2048)

Algorithm-specific failure code end.

Remarks:

This is 0xfffff800.

#define IALG_CUSTOMFAILEND   (-256)

Algorithm-specific failure code base.

Remarks:

This is 0xffffff00.

#define IALG_MPROG   0x0008

Program memory space bit.

#define IALG_MXTRN   0x0010

External memory space bit.

#define IALG_isProg

(

s )

Value:

(        \
    (((int)(s)) & IALG_MPROG)   \
)

#define IALG_isOffChip

(

s )

Value:

(     \
    (((int)(s)) & IALG_MXTRN)   \
)

---

Typedef Documentation

typedef enum IALG_MemAttrs IALG_MemAttrs

Memory attributes.

typedef enum IALG_MemSpace IALG_MemSpace

Defined memory spaces.

typedef struct IALG_MemRec IALG_MemRec

Memory records.

typedef struct IALG_Obj IALG_Obj

Algorithm instance object definition.

Remarks:

All XDAIS algorithm instance objects must have this structure as their first element. However, they do not need to initialize it; initialization of this sub-structure is done by the "framework".

typedef struct IALG_Obj* IALG_Handle

Handle to an algorithm instance object.

typedef struct IALG_Params IALG_Params

Algorithm instance creation parameters.

Remarks:

All XDAS algorithm parameter structures must have this as their first element.

typedef struct IALG_Status IALG_Status

Pointer to algorithm specific status structure.

Remarks:

All XDAIS algorithm parameter structures must have this as their first element.

typedef unsigned int IALG_Cmd

Algorithm specific command.

Remarks:

This command is used in conjunction with IALG_Status to get and set algorithm specific attributes via the algControl() method.

typedef struct IALG_Fxns IALG_Fxns

Defines the fields and methods that must be supplied by all XDAIS algorithms.

---

Enumeration Type Documentation

enum IALG_MemAttrs

Memory attributes.

Enumerator:

IALG_SCRATCH	Scratch memory.
IALG_PERSIST	Persistent memory.
IALG_WRITEONCE	Write-once persistent memory.

enum IALG_MemSpace

Defined memory spaces.

Enumerator:

IALG_EPROG	External program memory Program memory space bit. External memory space bit.
IALG_IPROG	Internal program memory Program memory space bit.
IALG_ESDATA	Off-chip data memory (accessed sequentially) External memory space bit.
IALG_EXTERNAL	Off-chip data memory (accessed randomly) External memory space bit.
IALG_DARAM0	Dual access on-chip data memory
IALG_DARAM1	Block 1, if independant blocks required
IALG_SARAM	Single access on-chip data memory
IALG_SARAM0	Block 0, equivalent to IALG_SARAM
IALG_SARAM1	Block 1, if independant blocks required
IALG_DARAM2	Block 2, if a 3rd independent block required
IALG_SARAM2	Block 2, if a 3rd independent block required