FreeCalypso > hg > fc-magnetite
view src/cs/riviera/rvt/rvt_env.c @ 600:8f50b202e81f
board preprocessor conditionals: prep for more FC hw in the future
This change eliminates the CONFIG_TARGET_FCDEV3B preprocessor symbol and
all preprocessor conditionals throughout the code base that tested for it,
replacing them with CONFIG_TARGET_FCFAM or CONFIG_TARGET_FCMODEM. These
new symbols are specified as follows:
CONFIG_TARGET_FCFAM is intended to cover all hardware designs created by
Mother Mychaela under the FreeCalypso trademark. This family will include
modem products (repackagings of the FCDEV3B, possibly with RFFE or even
RF transceiver changes), and also my desired FreeCalypso handset product.
CONFIG_TARGET_FCMODEM is intended to cover all FreeCalypso modem products
(which will be firmware-compatible with the FCDEV3B if they use TI Rita
transceiver, or will require a different fw build if we switch to one of
Silabs Aero transceivers), but not the handset product. Right now this
CONFIG_TARGET_FCMODEM preprocessor symbol is used to conditionalize
everything dealing with MCSI.
At the present moment the future of FC hardware evolution is still unknown:
it is not known whether we will ever have any beyond-FCDEV3B hardware at all
(contingent on uncertain funding), and if we do produce further FC hardware
designs, it is not known whether they will retain the same FIC modem core
(triband), if we are going to have a quadband design that still retains the
classic Rita transceiver, or if we are going to switch to Silabs Aero II
or some other transceiver. If we produce a quadband modem that still uses
Rita, it will run exactly the same fw as the FCDEV3B thanks to the way we
define TSPACT signals for the RF_FAM=12 && CONFIG_TARGET_FCFAM combination,
and the current fcdev3b build target will be renamed to fcmodem. OTOH, if
that putative quadband modem will be Aero-based, then it will require a
different fw build target, the fcdev3b target will stay as it is, and the
two targets will both define CONFIG_TARGET_FCFAM and CONFIG_TARGET_FCMODEM,
but will have different RF_FAM numbers. But no matter which way we are
going to evolve, it is not right to have conditionals on CONFIG_TARGET_FCDEV3B
in places like ACI, and the present change clears the way for future
evolution.
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Mon, 01 Apr 2019 01:05:24 +0000 |
| parents | 945cf7f506b2 |
| children |
line wrap: on
line source
/******************************************************************************** * * rvt_env.c * * This module interfaces the environment and contains all start/init/stop... * functions of the trace module. * * (C) Texas Instruments, all rights reserved * * Version number : 0.1 * * History : 0.1 (7/4/2000) - Created * * Date : 7/4/2000 * * Author : Cristian Livadiotti, c-livadiotti@ti.com * ********************************************************************************/ #include "nucleus.h" #include <string.h> #include "rvf/rvf_api.h" #include "rv/rv_general.h" #include "rvm/rvm_gen.h" #include "rvm/rvm_priorities.h" #include "rvt/rvt_gen.h" #include "rvt/rvt_def_i.h" #include "rvt/rvt_env.h" #include "rvt/rvt_env_i.h" #include "rvm/rvm_use_id_list.h" #include "uart/serialswitch.h" #ifndef _WINDOWS #include "config/swconfig.cfg" #include "config/debug.cfg" #endif #define TI_RX_HISR_STACK_SIZE (1024) static UINT8 TI_RX_HISR_stack[TI_RX_HISR_STACK_SIZE]; char *p_rvt_lost_msg = NULL; char *p_rvt_sys_time = NULL; NU_HISR TI_rcv_HISR; T_RVF_MB_ID rvt_mb_id = 0; T_RVT_STATE rvt_module_state = RVT_NOT_STARTED; T_RVF_ADDR_ID rvt_addr_id = 0; /********************************************************************************/ /* */ /* Function Name: rvt_get_info */ /* */ /* Purpose: This function is used to notify the RVM */ /* of the Trace's Memory Banks requirements. */ /* */ /* Input Parameters: */ /* &p_info_swe (refer to rvm_gen.h). */ /* */ /* Output Parameters: */ /* p_info_swe (refer to rvm_gen.h). */ /* */ /* Global Parameters: */ /* None. */ /* */ /* Note: */ /* None. */ /* */ /********************************************************************************/ T_RVM_RETURN rvt_get_info (T_RVM_INFO_SWE *p_info_swe) { if (!p_info_swe) return RVM_INVALID_PARAMETER; p_info_swe->swe_type = RVM_SWE_TYPE_4; p_info_swe->type_info.type4.swe_use_id = RVT_USE_ID; p_info_swe->type_info.type4.version = 1; memcpy (p_info_swe->type_info.type4.swe_name, "TRACE", sizeof ("TRACE")); p_info_swe->type_info.type4.stack_size = TRACE_TASK_STACK_SIZE; p_info_swe->type_info.type4.priority = RVM_TRACE_TASK_PRIORITY; p_info_swe->type_info.type4.return_path.addr_id = 0; p_info_swe->type_info.type4.return_path.callback_func = NULL; // Memory banks definitions. For now, one memory bank is needed p_info_swe->type_info.type4.nb_mem_bank = 1; memcpy (p_info_swe->type_info.type4.mem_bank[0].bank_name, "RV_TRACE", RVM_NAME_MAX_LEN); p_info_swe->type_info.type4.mem_bank[0].initial_params.size = TRACE_MB_SIZE; p_info_swe->type_info.type4.mem_bank[0].initial_params.watermark = TRACE_MB_WATERMARK; // Generic functions p_info_swe->type_info.type4.init = rvt_init; p_info_swe->type_info.type4.core = (T_RVM_SWE_CORE_FUNC)rvt_task_core; p_info_swe->type_info.type4.stop = rvt_stop; p_info_swe->type_info.type4.kill = rvt_kill; p_info_swe->type_info.type4.set_info = rvt_set_info; // Linked SW entities: none, except if Profiler or Nucleus Monitor are defined #if (TI_PROFILER == 1) || (TI_NUC_MONITOR == 1) p_info_swe->type_info.type4.nb_linked_swe = 1; p_info_swe->type_info.type4.linked_swe_id[0] = TI_PRF_USE_ID; #else p_info_swe->type_info.type4.nb_linked_swe = 0; #endif return RVM_OK; } /********************************************************************************/ /* */ /* Function Name: rvt_set_info */ /* */ /* Purpose: This function is used to notify the Trace module */ /* about mb ids and task id. */ /* */ /* Input Parameters: */ /* bk_id[]: array of memory bank IDs. */ /* */ /* Output Parameters: */ /* None. */ /* */ /* Global Parameters: */ /* None. */ /* */ /* Note: */ /* None. */ /* */ /********************************************************************************/ T_RVM_RETURN rvt_set_info (T_RVF_ADDR_ID addr_id, T_RV_RETURN_PATH return_path[], T_RVF_MB_ID bk_id[], T_RVM_CB_FUNC rvm_error_ft) { // Save parameters given by the environment (Addr ID and MB ID respectively) rvt_addr_id = addr_id; rvt_mb_id = bk_id [0]; return RVM_OK; } /********************************************************************************/ /* */ /* Function Name: rvt_init */ /* */ /* Purpose: This is the initialization function. */ /* It is called by the RVM. */ /* */ /* Input Parameters: */ /* None. */ /* */ /* Output Parameters: */ /* None. */ /* */ /* Global Parameters: */ /* None. */ /* */ /* Note: */ /* None. */ /* */ /********************************************************************************/ T_RVM_RETURN rvt_init (void) { if (rvt_module_state != RVT_NOT_STARTED) return RVM_NOT_READY; // The stack is entirely filled with the pattern 0xFE memset (TI_RX_HISR_stack, 0xFE, TI_RX_HISR_STACK_SIZE); // Create the RX HISR if (NU_Create_HISR (&TI_rcv_HISR, \ "TI_RCV_HISR", \ rvt_RX_process, \ 2, \ TI_RX_HISR_stack, \ TI_RX_HISR_STACK_SIZE) != NU_SUCCESS) return RVM_INTERNAL_ERR; // Initialize the baud rate and the callback function for the RX HISR SER_tr_Init (SER_LAYER_1, TR_BAUD_CONFIG, rvt_activate_RX_HISR); #ifdef FRAMING_PROTOCOL // Allocate a buffer that reports the system time (refer to rvf_trace_adapt.c): // - 'User ID' (1 byte), // - 'Trace Type' (4 bytes), // - 'Trace Level' (1 byte), // - 'System Time' (RVT_SYS_TIME_LENGTH bytes), // - Hexadecimal value (RVT_HEX_VALUE_LENGTH bytes). if (rvf_get_buf (rvt_mb_id, \ (RVT_HDR_LENGTH + RVT_SYS_TIME_LENGTH + RVT_HEX_VALUE_LENGTH), \ (T_RVF_BUFFER**)&p_rvt_sys_time) != RVF_RED) { UINT8 *header_p = NULL; header_p = (UINT8*)p_rvt_sys_time; *header_p++ = (UINT8)rv_trace_user_id; *header_p++ = 0; *header_p++ = 0; *header_p++ = 0; *header_p++ = 0; *header_p++ = RV_TRACE_LEVEL_ERROR; memcpy (header_p, RVT_SYS_TIME, RVT_SYS_TIME_LENGTH); } // Allocate a buffer that reports a lack of memory (refer to rvf_trace_adapt.c): // - 'User ID' (1 byte), // - 'Trace Type' (4 bytes), // - 'Trace Level' (1 byte), // - 'Lost Message' (RVT_LOST_MSG_LENGTH bytes), // - Hexadecimal value (RVT_HEX_VALUE_LENGTH bytes). if (rvf_get_buf (rvt_mb_id, (RVT_HDR_LENGTH + RVT_LOST_MSG_LENGTH + RVT_HEX_VALUE_LENGTH), \ (T_RVF_BUFFER**)&p_rvt_lost_msg) != RVF_RED) { UINT8 *header_p = NULL; header_p = (UINT8*)p_rvt_lost_msg; *header_p++ = (UINT8)rv_trace_user_id; *header_p++ = 0; *header_p++ = 0; *header_p++ = 0; *header_p++ = 0; *header_p++ = RV_TRACE_LEVEL_ERROR; memcpy (header_p, RVT_LOST_MSG, RVT_LOST_MSG_LENGTH); } #else // Allocate a buffer that reports the system time if (rvf_get_buf (rvt_mb_id, \ (RVT_SYS_TIME_LENGTH + RVT_HEX_VALUE_LENGTH + RVT_HYPERTERM_LENGTH), \ (T_RVF_BUFFER**)&p_rvt_sys_time) != RVF_RED) { memcpy (p_rvt_sys_time, RVT_SYS_TIME, RVT_SYS_TIME_LENGTH); } // Allocate a buffer that reports a lack of memory if (rvf_get_buf (rvt_mb_id, \ (RVT_LOST_MSG_LENGTH + RVT_HEX_VALUE_LENGTH + RVT_HYPERTERM_LENGTH), \ (T_RVF_BUFFER**)&p_rvt_lost_msg) != RVF_RED) { memcpy (p_rvt_lost_msg, RVT_LOST_MSG, RVT_LOST_MSG_LENGTH); } #endif // State RVT as "STARTED" rvt_module_state = RVT_STARTED; return RVM_OK; } /********************************************************************************/ /* */ /* Function Name: rvt_stop */ /* */ /* Purpose: This function is defined for compilation only. */ /* */ /* Input Parameters: */ /* None. */ /* */ /* Output Parameters: */ /* None. */ /* */ /* Global Parameters: */ /* None. */ /* */ /* Note: */ /* None. */ /* */ /********************************************************************************/ T_RVM_RETURN rvt_stop (void) { return RVM_OK; } /********************************************************************************/ /* */ /* Function Name: rvt_kill */ /* */ /* Purpose: This function is defined for compilation only. */ /* */ /* Input Parameters: */ /* None. */ /* */ /* Output Parameters: */ /* None. */ /* */ /* Global Parameters: */ /* None. */ /* */ /* Note: */ /* None. */ /* */ /********************************************************************************/ T_RVM_RETURN rvt_kill (void) { return RVM_OK; }