FreeCalypso > hg > fc-magnetite
diff src/cs/riviera/rvm/rvm_gen.h @ 0:945cf7f506b2
src/cs: chipsetsw import from tcs211-fcmodem
binary blobs and LCD demo files have been excluded,
all line endings are LF only
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Sun, 25 Sep 2016 22:50:11 +0000 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/cs/riviera/rvm/rvm_gen.h Sun Sep 25 22:50:11 2016 +0000 @@ -0,0 +1,215 @@ +/** + * @file rvm_gen.h + * + * Defines the generic types used by the Riviera Environment + * and the exported function of the RVM block. + * + * @author David Lamy-Charrier (d-lamy@ti.com) + * @version 0.1 + */ + +/* + * Revision History: + * + * Date Author Modification + * ------------------------------------------------------------------- + * 19/01/2000 David Lamy-Charrier Create. + * 11/20/2001 Vincent Oberle Added BUILD_VERSION_NUMBER. + * Documentation cleaning + * + * (C) Copyright 2000 by Texas Instruments Incorporated, All Rights Reserved + */ + +#ifndef __RVM_GEN_H_ +#define __RVM_GEN_H_ + +#ifndef _WINDOWS + #include "config/rv.cfg" +#endif + +#include "rvf/rvf_api.h" /* for memory bank related definitions & GD*/ +#include "rvm/rvm_api.h" + + +#ifdef __cplusplus +extern "C" { +#endif + + +/* RVM global definitions */ +#define T_RVM_STRING char * +#define T_RVM_ERROR_TYPE UINT32 + +#define RVM_MAX_NB_MEM_BK (3) + +#define RVM_MAX_NB_LINKED_SWE (10) + +#define RVM_USED_MAILBOX RVF_TASK_MBOX_0 + + +/* define the 4 SWE types */ +typedef enum +{ + RVM_SWE_TYPE_1, + RVM_SWE_TYPE_2, + RVM_SWE_TYPE_3, + RVM_SWE_TYPE_4 +} T_RVM_SWE_TYPE; + + +/* Memory bank parameters */ +typedef struct +{ + T_RVF_MB_NAME bank_name; + T_RVF_MB_PARAM initial_params; +} T_RVM_BK_INFO; + + +/* RVM callback function pointer type */ +typedef T_RVM_RETURN (*T_RVM_CB_FUNC)(T_RVM_NAME swe_name, + T_RVM_RETURN error_cause, + T_RVM_ERROR_TYPE error_type, + T_RVM_STRING error_msg); + +/* + * Macro used to build the version number from the + * - major version number (8 bits) + * - minor version number (8 bits) + * - build number (16 bits). A 0 indicates this number is not used. + */ +#define BUILD_VERSION_NUMBER(major, minor, build) ( ((major & 0xFF) << 24) | \ + ((minor & 0xFF) << 16) | \ + (build & 0xFFFF) ) + +/* SWE core function prototype */ +typedef T_RVM_RETURN (*T_RVM_SWE_CORE_FUNC)(void); + +/* Type1 SWE info */ +typedef struct +{ + T_RVM_NAME swe_name; + T_RVM_USE_ID swe_use_id; + UINT32 version; + UINT8 nb_mem_bank; + T_RVM_BK_INFO mem_bank[RVM_MAX_NB_MEM_BK]; + UINT8 nb_linked_swe; + T_RVM_USE_ID linked_swe_id[RVM_MAX_NB_LINKED_SWE]; + T_RV_RETURN_PATH return_path; + T_RVM_RETURN (* set_info) (T_RVF_ADDR_ID addr_id, + T_RV_RETURN_PATH return_path[], + T_RVF_MB_ID bk_id_table[], + T_RVM_CB_FUNC call_back_error_ft); + T_RVM_RETURN (* init) (void); + T_RVM_RETURN (* start) (void); + T_RVM_RETURN (* stop) (/*T_RV_HDR* hdr*/void); //??? + T_RVM_RETURN (* kill) (void); +} T_RVM_SWE_PASSIVE_INFO; + +/* Type2 SWE info */ +typedef struct +{ + T_RVM_NAME swe_name; + T_RVM_USE_ID swe_use_id; + UINT16 stack_size; + UINT8 priority; + UINT32 version; + UINT8 nb_mem_bank; + T_RVM_BK_INFO mem_bank[RVM_MAX_NB_MEM_BK]; + UINT8 nb_linked_swe; + T_RVM_USE_ID linked_swe_id[RVM_MAX_NB_LINKED_SWE]; + T_RV_RETURN_PATH return_path; + T_RVF_GD_ID swe_group_directive; /* A-M-E-N-D-E-D! */ + T_RVM_RETURN (* set_info) (T_RVF_ADDR_ID addr_id, + T_RV_RETURN_PATH return_path[], + T_RVF_MB_ID bk_id_table[], /* A-M-E-N-E-D-E-D! is table or list??*/ + T_RVM_CB_FUNC call_back_error_ft); + T_RVM_RETURN (* init) (void); + T_RVM_RETURN (* start) (void); + T_RVM_RETURN (* handle_message) (T_RV_HDR * msg); + T_RVM_RETURN (* handle_timer) (T_RV_HDR * msg); + T_RVM_RETURN (* stop) (T_RV_HDR* hdr); + T_RVM_RETURN (* kill) (void); +} T_RVM_SWE_GROUP_MEMBER_INFO; + +/* Type3 SWE info */ +typedef struct +{ + T_RVM_NAME swe_name; + T_RVM_USE_ID swe_use_id; + UINT16 stack_size; + UINT8 priority; + UINT32 version; + UINT8 nb_mem_bank; + T_RVM_BK_INFO mem_bank[RVM_MAX_NB_MEM_BK]; + UINT8 nb_linked_swe; + T_RVM_USE_ID linked_swe_id[RVM_MAX_NB_LINKED_SWE]; + T_RV_RETURN_PATH return_path; + T_RVM_RETURN (* set_info) (T_RVF_ADDR_ID addr_id, + T_RV_RETURN_PATH return_path[], + T_RVF_MB_ID bk_id_table[], + T_RVM_CB_FUNC call_back_error_ft); + T_RVM_RETURN (* init) (void); + T_RVM_RETURN (* start) (void); + T_RVM_RETURN (* handle_message) (T_RV_HDR * msg); + T_RVM_RETURN (* handle_timer) (T_RV_HDR * msg); + T_RVM_RETURN (* stop) (T_RV_HDR* hdr); + T_RVM_RETURN (* kill) (void); +} T_RVM_SWE_SINGLE_INFO; + +/* Type4 SWE info */ +typedef struct +{ + T_RVM_NAME swe_name; + T_RVM_USE_ID swe_use_id; + UINT16 stack_size; + UINT8 priority; + UINT32 version; + UINT8 nb_mem_bank; + T_RVM_BK_INFO mem_bank[RVM_MAX_NB_MEM_BK]; + UINT8 nb_linked_swe; + T_RVM_USE_ID linked_swe_id[RVM_MAX_NB_LINKED_SWE]; + T_RV_RETURN_PATH return_path; + T_RVM_RETURN (* set_info) (T_RVF_ADDR_ID addr_id, + T_RV_RETURN_PATH return_path[], + T_RVF_MB_ID bk_id_table[], + T_RVM_CB_FUNC call_back_error_ft); + T_RVM_RETURN (* init) (void); + T_RVM_RETURN (* core) (void); + T_RVM_RETURN (* stop) (/*T_RV_HDR* hdr*/void); // could be removed completely except for legacy code + T_RVM_RETURN (* kill) (void); +} T_RVM_SWE_SELF_MADE_INFO; + + +/* SWE information */ +typedef struct +{ + T_RVM_SWE_TYPE swe_type; + + union + { T_RVM_SWE_PASSIVE_INFO type1; + T_RVM_SWE_GROUP_MEMBER_INFO type2; + T_RVM_SWE_SINGLE_INFO type3; + T_RVM_SWE_SELF_MADE_INFO type4; + } type_info; +} T_RVM_INFO_SWE; + + +/* get info function pointer type */ +typedef T_RVM_RETURN (*T_RVM_GET_INFO_FUNC) (T_RVM_INFO_SWE * param); + + +/* type used in the const SWEs array */ +typedef struct t_rvm_const_swe_info +{ + T_RVM_USE_ID use_id; + T_RVM_GET_INFO_FUNC get_info_func; +} T_RVM_CONST_SWE_INFO; + + +#ifdef __cplusplus +} +#endif + + +#endif /* __RVM_GEN_H_ */ +