--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cs/riviera/rvf/rvf_i.h	Fri Oct 16 06:23:26 2020 +0000
@@ -0,0 +1,262 @@
+/****************************************************************************/
+/*                                                                          */
+/*  Name        rvf_i.h                                                     */
+/*                                                                          */
+/*  Function    this file contains rvf private definitions                  */
+/*                                                                          */
+/*  Version		0.4															*/
+/*																			*/
+/* 	Date       	Modification												*/
+/*  ------------------------------------									*/
+/*  3/12/99		Create														*/
+/*	30/11/99	compliant to RV coding guidelines							*/
+/*  12/23/1999	change buffer structures, add memory bank related structures*/
+/*  02/21/2000	change memory bank implementation.							*/
+/*  12/07/2000	implement dynamic memory allocation.						*/
+/*																			*/
+/*	Author		David Lamy-Charrier (dlamy@tif.ti.com)						*/
+/*																			*/
+/* (C) Copyright 1999 by Texas Instruments Incorporated, All Rights Reserved*/
+/****************************************************************************/
+
+
+#ifndef _RVF_I_H
+#define _RVF_I_H
+
+
+#include "rv/general.h"
+#include "rvf/rvf_api.h"
+#include "nucleus.h" 	/* A-M-E-N-D-E-D! */
+#include "rvm/rvm_i.h"
+
+/********************************************************************/
+/**  Buffer Management Data Structures                             **/
+/********************************************************************/
+#define MAX_RVF_G_ADDR_ID	200
+
+
+/* define the OVERHEAD per buffer */
+#if RVF_ENABLE_BUF_CORRUPTION_CHECK
+	#define RVF_CORRUPT_OVERHEAD (sizeof(UINT32))
+	BOOLEAN _rvf_chk_buf_damage(void *bptr);
+#else
+	#define RVF_CORRUPT_OVERHEAD 0
+#endif
+/* calculate the size required in bytes, add the overhead for buffer corruption and round up to a multiple of 4 */
+#define REQ2SIZE(size) ( ((size) + 3 + RVF_CORRUPT_OVERHEAD) & ~0x00000003)
+
+
+#define RVF_MIN_USABLE_SIZE	( sizeof(T_RVF_INTERNAL_BUF) + sizeof(UINT32) )
+
+/* macros to get the internal header from the user pointer and vice-versa */
+#define USER2MEM(buf)  ( (T_RVF_INTERNAL_BUF*)(((UINT8*)(buf)) - sizeof(T_RVF_INTERNAL_BUF) ) )
+#define MEM2USER(buf)  ( ((UINT8*)(buf)) + sizeof(T_RVF_INTERNAL_BUF) )
+
+
+/* NOTE: since buffer size is always a multiple of 4, the last 2 bits may be used for flags */
+
+#define GETSIZE(hdr)	((UINT32)(hdr->buf_size & ~0x03) )
+
+/* macros to manage if buffers are linked or not */
+#define RVF_BUF_IS_LINKED(hdr) 		(0x00000001 & hdr->buf_size)
+#define RVF_SET_BUF_LINKED(hdr)		( (hdr)->buf_size |= 0x00000001)
+
+#define RVF_BUF_IS_UNLINKED(hdr)	(!(RVF_BUF_IS_LINKED(hdr)) )
+#define RVF_SET_BUF_UNLINKED(hdr)	( (hdr)->buf_size &= ~0x00000001)
+
+
+/* macros to set and check the usage of the previous buffer */
+#define RVF_IS_PREV_IN_USE(hdr) 	(0x00000002 & hdr->buf_size)
+#define RVF_SET_PREV_IN_USE(hdr)	( (hdr)->buf_size |= 0x00000002)
+
+#define RVF_IS_PREV_FREE(hdr)		(!(RVF_IS_PREV_IN_USE(hdr)) )
+#define RVF_SET_PREV_FREE(hdr)		( (hdr)->buf_size &= ~0x00000002)
+
+
+#define SETSIZE(hdr, size)			{	(hdr)->buf_size &= 0x03;\
+										(hdr)->buf_size |= (size); }
+									
+
+
+#define NEXTCHUNK(hdr)	( (T_RVF_INTERNAL_BUF *)( (UINT8*)hdr + GETSIZE(hdr) + sizeof(T_RVF_INTERNAL_BUF) ) )
+
+#define ENDSIZE(hdr)	( ((T_RVF_INTERNAL_BUF*)( (UINT8*)hdr + GETSIZE(hdr) + sizeof(T_RVF_INTERNAL_BUF) - sizeof(UINT32) ))->buf_size )
+
+
+#define RVF_NB_FREE_LISTS	32
+/* macro used to get the list index from the buffer size */
+/* 32 lists :	8  lists for buffer < 256  all spaced 32 bytes apart,
+				8  lists for buffer < 1280 all spaced 128 bytes apart,
+				8  lists for buffer < 5376 all spaced 512 bytes apart, 
+				8  lists for buffer > 5376 all spaced 16384 bytes apart.*/
+
+#define RVF_BUF_LIST_INDEX(size)	( ((size) < 256 ) ? ( (UINT8)((size)>>5) ) :\
+									( ((size) < 1280 ) ? ((UINT8)(8 + ((size-256)>>7) ) ) :\
+									( ((size) < 5376) ? ((UINT8)(16 + ((size-1280)>>9) ) ) :\
+									( ((size) < 136448)? ((UINT8)(24 + ((size-5376)>>14) ) ): (UINT8)(31) ) ) ) )
+
+/* internal buffer structure */
+typedef struct _t_internal_buf
+{	UINT32	buf_size;					/* size of the user buffer */
+	struct	_t_internal_buf * p_next;	/* pointer to the next buffer in the queue */ 
+	
+	union header
+	{	struct external
+		{	UINT16	mb_id;						/* id of the memory bank which owns the buffer */
+			UINT16	mb_expected;				/* id of the memory bank on which the buffer want to be counted */
+		}external;
+		
+		struct	_t_internal_buf * p_prev;		/* pointer to the previous buffer in the queue */ 
+	}header;
+	
+	
+} T_RVF_INTERNAL_BUF;
+
+
+
+
+
+/* RVF will managed at most 2 pools of memory for dynamic allocation */
+/* buffer pool structure*/
+typedef struct _t_rvf_pool
+{
+	void * start_address;			/* address of the beginnig of the pool */
+	UINT32 pool_size;				/* total size of the pool */
+} T_RVF_POOL;
+
+
+
+
+/* memory bank structure */
+typedef struct _t_rvf_mb
+{	UINT32	cur_memory_used;		/* size of current memory usage */
+	UINT32	watermark;				/* watermark */
+	UINT32	max;					/* max size */
+	MB_CALLBACK_FUNC func;			/* function to call when mb_state switch to GREEN */
+	BOOLEAN	returned_red;			/* flag indicating that this memory bank returned a RED value, */
+									/* its callback function has to be called and/or buffer are waiting */	
+	UINT16	first_buffer_index;		/* index of the first waiting buffer in the array */
+	UINT16	last_buffer_index;		/* index of the last waiting buffer in the array */
+#if RVF_ENABLE_STATS
+	UINT32	max_reached;			/* maximum memory usage reached */
+	UINT32	required_size;			/* total size in byte required by the rvf_get_buf function */
+	UINT32	num_buf;				/* total number of buffer allocated by rvf_get_buf function */
+#endif
+
+} T_RVF_MB;
+
+
+/* structure which associates mb name and mb id */
+typedef struct _t_rvf_mb_name_id
+{	char mb_name[RVF_MAX_MB_LEN];	/* name of the memory bank */
+	UINT16 mb_id;					/* id of the memory bank */
+	T_RVF_MB_PARAM mb_params;		/* parameters of the memory bank */
+} T_RVF_MB_NAME_ID;
+
+
+/* note:
+ * - hosting_list overhead is reduced with an 8 bit addr id
+ * - is hosting_list needed? would known_swe struct be enough to derive all info?  */
+typedef struct _rvf_rt_addr_id_data {					/* A-M-E-N-D-E-D!  */
+	UINT8				type_code;						/* poss. derived?  */
+	UINT8				priority;
+	T_RVF_G_ADDR_ID		host_addr_id;					/* Poss. union: JavaRef-32b or addrId-16 */
+	UINT8				hosting_count;
+	T_RVF_G_ADDR_ID		parasites[MAX_PARASITES];
+	UINT8				swe_db_index;
+	char*				symbolic_name;
+	NU_TASK*			pOSTCB;
+	NU_EVENT_GROUP*		pOSEvtGrp;
+	UINT8*				p_os_stack;
+	UINT16				os_stack_size;
+	T_RVF_G_ADDR_ID		virtualContext;
+	UINT8				gdHost;
+	T_RVF_INTERNAL_BUF* OSTaskQFirst[RVF_NUM_TASK_MBOX]; 
+	T_RVF_INTERNAL_BUF*	OSTaskQLast [RVF_NUM_TASK_MBOX];
+	T_RV_RET			(* handle_message)	(T_RV_HDR * msg);  // note: T_RV_RETURN and not T_RVM...
+	T_RV_RET			(* handle_timer)	(T_RV_HDR * msg);
+} T_RVF_RT_ADDR_ID_DATA;
+
+typedef struct _rvf_tm_attrib {					
+	T_RVF_G_ADDR_ID		host_addr_id;		
+	UINT8				legacyFlag;
+	void*				action;
+} T_RVF_TM_ATTRIB;
+
+typedef NU_TIMER T_RV_TM;
+
+typedef union _rvf_tm_ublk {					
+	T_RV_TM*		ptr;		
+	UINT32			id;
+	
+} T_RVF_TM_UBLK;
+
+typedef union _rvf_tm_attib {
+	char				str[8];
+	T_RVF_TM_ATTRIB		attrib;
+} T_RVF_TM_ATTRIB_UBLK;
+
+typedef union _rvf_tm_action {
+	UINT32				action_id;
+	void*				p_action;
+} T_RVF_TM_ACTION_UBLK;
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+T_RVF_RET	rvf_send_priority_msg	(T_RVF_G_ADDR_ID addr_id, void *msg) ;
+T_RVF_RET	rvf_adapt_send_msg (T_RVF_G_ADDR_ID addr_id, void *msg, UINT8 mbox) ;
+
+void		rvf_yield();
+
+void		rvf_mbox_buffer_init(T_RVF_RT_ADDR_ID_DATA* pRtAddrIdElement);
+void		_rvf_buffer_init (void);
+void		_rvf_timers_init(void);
+T_RVF_RET	rvf_get_available_mem( UINT32 * total_size, UINT32 * used_size );
+T_RV_RET	_rvf_empty_mailboxes (T_RVF_G_ADDR_ID task_id);
+
+void		_rvf_init_mem_pool(void);
+void		_rvf_init_free_queue (UINT8 id, UINT32 size, void *p_mem);
+UINT16		_rvf_get_mem_usage_ratio(void);
+UINT16		_rvf_get_number_of_pool(void);
+#ifdef		_WINDOWS
+  void		_rvf_window_dump_mem(void *m);
+#endif
+
+
+T_RVF_RET		rvf_free_sys_resources(T_RVF_G_ADDR_ID gid, UINT8 rm);
+T_RVF_G_ADDR_ID	rvf_allocate_task_id(UINT8 isRealTask) ;   /* return should be changed to 16 or 32 bit val */
+T_RVF_RET		rvf_setRtAddrSweIndex(T_RVF_G_ADDR_ID id, UINT8 sweIndex);
+T_RVF_G_ADDR_ID	resolveHostAddrId(T_RVF_G_ADDR_ID id) ;
+T_RVF_RET		rvf_create_virtual_task(T_RV_RET (* handle_message)(T_RV_HDR * msg),
+										T_RV_RET (* handle_timer)(T_RV_HDR * msg),
+										T_RVF_G_ADDR_ID task_id, T_RVF_G_ADDR_ID host_task_id, char *taskname, UINT8 priority, UINT8 tcode) ;
+T_RVF_RET		rvf_register_t3_handlers (T_RVF_G_ADDR_ID task_id,
+								   T_RV_RET (* handle_message)(T_RV_HDR * msg),
+								   T_RV_RET (* handle_timer)(T_RV_HDR * msg) ) ;
+T_RVF_RET		rvf_create_host_task (T_RV_RET (* proxy)(void), T_RVF_G_ADDR_ID task_id, char *taskname, UINT8 *stack, UINT16 stacksize,\
+										 UINT8 priority, UINT8 tcode, UINT8 time_slicing, T_RVF_TASK_STATE suspend);
+T_RVF_RET		rvf_registerToHost(T_RVF_G_ADDR_ID host_id, T_RVF_G_ADDR_ID eid) ;
+T_RVF_RET		rvf_unregisterFromHost(T_RVF_G_ADDR_ID host_id, T_RVF_G_ADDR_ID pid) ;
+T_RVF_RET		rvf_setHostTaskStackPtr(T_RVF_G_ADDR_ID id, UINT8* pStack) ;
+
+T_RVF_G_ADDR_ID rvf_resolveHostingAddrId(T_RVM_GROUP_DIRECTIVE gd);
+T_RVF_RET		rvf_associateGrpToHost(T_RVF_G_ADDR_ID host_id, T_RVF_GD_ID gd_id);
+T_RVF_RET		rvf_isHostingTaskIdle(T_RVF_G_ADDR_ID id, UINT8* status);
+void			rvf_setRDV(T_RVF_G_ADDR_ID tid,T_RVF_G_ADDR_ID vid);
+
+/* Internal RVF data structures*/
+
+extern T_RVF_INTERNAL_BUF *OSTaskQFirst[1][1]; //MAX_RVF_TASKS][RVF_NUM_TASK_MBOX];
+extern T_RVF_INTERNAL_BUF *OSTaskQLast[1][1]; //[MAX_RVF_TASKS][RVF_NUM_TASK_MBOX];
+
+extern T_RVF_RT_ADDR_ID_DATA* pRtAddrIdTable[MAX_RVF_G_ADDR_ID];
+
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _RVF_I_H */