custom_ops.h

用于TM1300/PNX1300系列DSP（主要用于视频处理）的所用到的头文件

#ifndef _CUSTOM_OPS_H_
#define _CUSTOM_OPS_H_

/****************************************************************************
 *
 * custom_ops.h
 * @(#)custom_ops.h  1.34  10/06/99
 *
 * custom_ops header file.
 *
 ****************************************************************************/



#if defined(__TCS__)

/*
 *    TriMedia compiler driver tmcc defines __TCS__
 *    these are the custom_op prototypes for the compiler.
 *    they are organized as in custom_defs.h.
 */

/*
 *	1.	Load/Store Operations
 *
 *	these operations do not have macros
 *	since they are expressible directly in C.
 *
 *		basic load operations
 *		load with displacement operations
 *		load with index operations
 *		load with scaled index operations
 *		basic store operations
 *		store with displacement operations
 *
 *	2.	Compute Operations
 *
 *	the operations which are not directly
 *	expressible in C have macro defines below:
 *
 *		arithmetic operations
 */

custom_op long 	         imax(long a, long b);
custom_op long 	         imin(long a, long b);
custom_op unsigned long  umin(unsigned long a, unsigned long b);
custom_op unsigned long  iabs(long a);
custom_op long 	         ineg(long a);

/*
 *		signed comparison operations
 *		unsigned comparison operations
 *		logical operations
 */

custom_op unsigned long  bitandinv(unsigned long a, unsigned long b);
custom_op unsigned long  rol(unsigned long a, unsigned long b);

/*
 *		sign extension operations
 */

custom_op long  sex8(long a);
custom_op long  sex16(long a);
custom_op long  zex8(long a);
custom_op long  zex16(long a);

/*
 *	3.	Immediate Operations
 *
 *	the operations which are not directly
 *	expressible in C have macro defines below:
 *
 *		immediate operations
 *		logical operations
 */

custom_op unsigned long  asli(unsigned long a, unsigned long b);
custom_op unsigned long  roli(unsigned long a, unsigned long b);
custom_op unsigned long  asri(unsigned long a, unsigned long b);
custom_op unsigned long  lsri(unsigned long a, unsigned long b);
custom_op unsigned long  lsli(unsigned long a, unsigned long b);

/*
 *		arithmetic operations
 */

custom_op long  iaddi(unsigned long a, long b);
custom_op long  isubi(unsigned long a, long b);

/*
 *		signed comparison operations
 */

custom_op long  igtri(long a, long b);
custom_op long  igeqi(long a, long b);
custom_op long  ieqli(long a, long b);
custom_op long  ineqi(long a, long b);
custom_op long  ilesi(long a, long b);
custom_op long  ileqi(long a, long b);

/*
 *		unsigned comparison operations
 */

custom_op long  ugtri(unsigned long a, unsigned long b);
custom_op long  ugeqi(unsigned long a, unsigned long b);
custom_op long  ueqli(unsigned long a, unsigned long b);
custom_op long  uneqi(unsigned long a, unsigned long b);
custom_op long  ulesi(unsigned long a, unsigned long b);
custom_op long  uleqi(unsigned long a, unsigned long b);

/*
 *
 *	4.	Special Compute Operations
 *
 *		clipped arithmetic operations
 */

custom_op long 	                dspiadd(long a, long b);
custom_op long 	                dspisub(long a, long b);
custom_op unsigned long 	dspuadd(unsigned long a, unsigned long b);
custom_op unsigned long         dspusub(unsigned long a, unsigned long b);
custom_op long 	                dspimul(long a, long b);
custom_op unsigned long 	dspumul(unsigned long a, unsigned long b);
custom_op unsigned long 	dspiabs(long a);

/*
 *		carry and borrow operations
 */

custom_op long 	carry(unsigned long a, unsigned long b);
custom_op long 	borrow(unsigned long a, unsigned long b);

/*
 *		special multiply operations
 */

custom_op long 	imulm(long a, long b);
custom_op unsigned long 	umulm(unsigned long a, unsigned long b);

/*
 *		dual arithmetic operations
 */

custom_op unsigned long 	dspidualabs(long a);
custom_op unsigned long 	dspidualadd(long a, long b);
custom_op unsigned long 	dspidualsub(long a, long b);
custom_op unsigned long 	dspidualmul(long a, long b);

/* #if defined(__TCS_tm1100__) */

/*
 *		dual shifting operations
 */

custom_op long			dualasr(long a, unsigned long b);

/*
 *		dual clipping operations
 */

custom_op long			dualiclipi(long a, unsigned long b);
custom_op unsigned long		dualuclipi(long a, unsigned long b);

/* #endif defined(__TCS_tm1100__) */

/*
 *		byte packing operations
 */

custom_op unsigned long 	packbytes(long a, long b);
custom_op unsigned long 	mergemsb(unsigned long a, unsigned long b);
custom_op unsigned long 	mergelsb(unsigned long a, unsigned long b);
custom_op unsigned long 	pack16msb(unsigned long a, unsigned long b);
custom_op unsigned long	        pack16lsb(unsigned long a, unsigned long b);

/* #if defined(__TCS_tm1100__) */

custom_op unsigned long		mergedual16lsb(unsigned long a, unsigned long b);

/* #endif defined(__TCS_tm1100__) */

/*
 *		byte select operations
 */

custom_op unsigned long 	ubytesel(long a, long b);
custom_op long 	                ibytesel(long a, long b);

/*
 *		sum of products operations
 */

custom_op unsigned long 	ufir8uu(unsigned long a, unsigned long b);
custom_op long 	                ifir8ui(unsigned long a, long b);
custom_op long 	                ifir8ii(long a, long b);
custom_op long 	                ifir16(long a, long b);
custom_op unsigned long 	ufir16(unsigned long a, unsigned long b);

/*
 *		sum of differences operations
 */

custom_op unsigned long 	ume8ii(long a, long b);
custom_op unsigned long 	ume8uu(unsigned long a, unsigned long b);

/*
 *		special byte shift operations
 */

custom_op unsigned long 	funshift1(unsigned long a, unsigned long b);
custom_op unsigned long 	funshift2(unsigned long a, unsigned long b);
custom_op unsigned long 	funshift3(unsigned long a, unsigned long b);

/*
 *		clip operations
 */

custom_op long 	                iclipi(long a, unsigned long b);
custom_op unsigned long 	uclipi(long a, unsigned long b);
custom_op unsigned long 	uclipu(unsigned long a, unsigned long b);

/*
 *		quad arithmetic operations
 */

custom_op unsigned long 	quadumulmsb(unsigned long a, unsigned long b);
custom_op unsigned long 	quadavg(unsigned long a, unsigned long b);
custom_op unsigned long         dspuquadaddui(unsigned long a, long b);

/* #if defined(__TCS_tm1100__) */

custom_op unsigned long		quadumax(unsigned long a, unsigned long b);
custom_op unsigned long		quadumin(unsigned long a, unsigned long b);

/* #endif defined(__TCS_tm1100__) */

/*
 *		various special compute operations
 */

custom_op long 	izero(long a, long b);
custom_op long 	inonzero(long a, long b);
custom_op long 	iavgonep(long a, long b);
custom_op long 	iflip(long a, long b);

/*
 *
 *	5.	Special Register Operations
 *
 *		PCSW operations
 */

custom_op unsigned long  readpcsw(void);
custom_op void           writepcsw(unsigned long val, unsigned long mask);

/*
 *		CCCOUNT operations
 *
 * cycles:
 *    Return the lower 32 bits of the 64 bit internal clock in cycles 
 *    For TM1 running at 100 MHz, it runs up to 42.95 sec.
 *    Unix system call clock() returns clock value in micro-seconds.
 * hicycles:
 *    Return the upper 32 bits of the 64 bit internal clock in cycles.
 *    Return 0 for UNIX implementation.
 */

custom_op unsigned long 	cycles(void);
custom_op unsigned long 	hicycles(void);

/*
 *		DPC and SPC operations
 */

custom_op unsigned long  readdpc(void);
custom_op void           writedpc(unsigned long val);
custom_op unsigned long  readspc(void);
custom_op void           writespc(unsigned long val);

/*
 *
 *	6.	Floating Point Operations
 *
 *	the operations which are not directly
 *	expressible in C have macro defines below.
 *
 *	special note: the xxxflags operations are
 *	meant to be used by the compiler and are
 *	therefore not supported here.
 *
 *		arithmetic operations
 *		comparison operations
 *		single argument operations
 */

custom_op float 	fsqrt(float f);
custom_op float 	fabsval(float f);
custom_op long	        fsign(float f);

/*
 *		float to integer conversions
 */

custom_op long          ifixieee(float f);
custom_op unsigned long ufixieee(float f);

/*
 *		integer to float conversions
 */

custom_op float         ifloatrz(long a);
custom_op float         ufloatrz(unsigned long a);

/*
 *		fzero and fnonzero analogous to izero/inonzero
 */

custom_op float 	fzero(long a, float b);
custom_op float 	fnonzero(long a, float b);


/*
 *		dirty tricks to calculate fmin and fmax  
 *		analogous to imin and imax
 * 
 *		DO NOT WORK WHEN BOTH FLOATS ARE NEGATIVE
 * 
 *		DO NOT SET APPROPRIATE IEEE FLAGS !!
 *			
 */

/************ READ COMMENT *************/

custom_op float 	fmin(float a, float b);
custom_op float 	fmax(float a, float b);

/************ READ COMMENT *************/


/*
 *
 *      7.      Cache Operations
 *
 *              data-cache copyback and invalidate operations
 *              data-cache tag and status operations
 *              instruction-cache operations
 *              data-cache prefetch operations
 *              data-cache allocate operations
 *
 *	8.	Control Flow Operations
 *
 *	though these operations are not easily
 *	expressible in C, they are unsafe to
 *	expose to the programmer and therefore
 *	are not supported.
 *
 *		jumps
 *		interruptable jumps
 *
 *      9.      Special Compiler Custom_ops
 *
 *              data-cache copyback and invalidate commands
 */

custom_op void          copyback(void const *a, unsigned long n);
custom_op void          invalidate(void *a, unsigned long n);
custom_op void          prefetch(void *a, unsigned long n);
custom_op void          allocate(void *a, unsigned long n);

/*
 * mux between two values -
 * if a is true (TM boolean), return value of b, else return value of c
 *
 */

custom_op long	        mux(long a, long b, long c);

/*
 * fmux between two values -
 * if a is true (TM boolean), return value of b, else return value of c