view src/cs/layer1/tm_include/l1tm_ver.h @ 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

/************* Revision Controle System Header *************
 *                  GSM Layer 1 software 
 * L1TM_VER.H
 *
 *        Filename l1tm_ver.h
 *  Copyright 2003 (C) Texas Instruments  
 *
 ************* Revision Controle System Header *************/

/*****************************/
/* Test mode version numbers */
/*****************************/


//#define    TESTMODEVERSION  0x0300L // All previous TestMode versions pertain to
                                    // GGT Protocol version 2.0, which has been replaced
                                    // by version 3.0.

//#define    TESTMODEVERSION  0x0320L // AFC Params part of "rftw"; APCDEL intialized in "tm_init"; New fcn "l1tm_initialize_var" to switch to TestMode
                                    // Uplink-only tests loop count; RACH loop count; Dedicated mode Pass/Fail stats updated
                                    // New structure "T_TM_RETURN_ABBREV"; Continous TX/RX; New fcn "tmstats_auto_result_reset_loops";
                                    // Corrected BSIC reporting problem; Power skip fcn implemented ("rftw/rftr 16"); A-F Loopback modes supported;
                                    // Chan. monitoring while in dedic. mode possible; FB26/D_BAMS_MEAS tasks enabled only with chan. monitoring;
                                    // New fcn "tmstats_mon_confirm"; RF struct incorporates new TX descriptor table;
                                    // AGC includes lna_off bit (least-significant bit); agc_, afc_ & adc_enable part of l1_config struct;
                                    // Variable number of guard bits in "l1tm_fill_burst"......
//#define    TESTMODEVERSION  0x0321L // Implemented FRAME_NUMBER in l1tm_stats_read(). Timing advance takes effect immediately. stats_read reports 16 or 32 bit values only.
                                    // Only one uplink message sent. Some indices in l1tm_version_get implemented. AGC gain and lna_off set only once to save instruction cycles.
                                    // Cleaned up enums in l1_tm_types.h. Removed case STANDARD from rf_param_read. 
                                    // Updated all argument types of testmode functions according to TM100 v3.2.1. Changed mem_read to support reception of page and 
                                    // register values in one 16-bit value from PCTM.  mem_read can read up to 124 bytes. Changed the TestMode primitive structure to include
                                    // only 2 generic ones plus mem_write and mem_read.

//#define    TESTMODEVERSION  0x0400L // REQ991:
                                    // - SIMULATION for test mode => new non-regression flow regress_tm.bat
                                    // - Rework of test mode state machines to make them independent from each other
                                    // - Rework of simulated upper layers (L3,CST) to be able to run L1 scenarios with TESTMODE=3
                                    // Correction of BUG989, BUG990, BUG992

//#define    TESTMODEVERSION  0x0401L // Merge with TM version 0x321

//#define    TESTMODEVERSION  0x0402L // TM rework PART II
//#define    TESTMODEVERSION  0x0403L // Alignment with TM100 v.3.5.0
                                    // Implementation of new functionality: single PM on monitor channel (rfe 15)
//#define    TESTMODEVERSION  0x0404L // Closed REQ01129: Implementation of GPRS test mode
//#define    TESTMODEVERSION  0x0405L // Alignment with SSA 5.3.3, 
                                      // Correction of BUG2048, BUG2050, BUG2294, BUG2295
#define    TESTMODEVERSION  0x0406L   // REQ03410


//#define    TMAPIVERSION     0x0350L  // New: TM API version (TM100 version number)
//#define    TMAPIVERSION     0x0360L  // TM100 change for GPRS test mode
//#define    TMAPIVERSION     0x0361L  // tm patch 361 for SW version 520
//#define    TMAPIVERSION     0x0362L  // tm patch 362 for SW version 531
#define    TMAPIVERSION     0x0370L  // Multi-band support