TSM30Layer1 » History » Revision 4
Revision 3 (laforge, 02/19/2016 10:49 PM) → Revision 4/6 (laforge, 02/19/2016 10:49 PM)
[[PageOutline]] == General Terminlogy == * L1 sync -- The synchronous side of the Layer 1, triggered by the TDMA frame interrupt issued by the DSP * L1 async -- The asynchronous side of the Layer 1, driven by the L2/L3 == Files == === Layer1/L1i/Src/dl1_mem.c === allocating/receiving/sending signals. === Layer1/L1i/Src/dl1_pei.c === create/initialise/close protocol stack entity === Layer1/L1c/Src/l1_afunc.c === Functionality related bit and timeslot synchronization === Layer1/L1c/Inc/l1_defty.h === DSP shared memory API definitions === Layer1/L1c/Src/l1_sync.c === Code driven by TDMA frame interrupt as issued by DSP == Functions == === Frame/Src/Frame.c:pf_ProcessSystemPrim(USHORT TaskHandle, T_VOID_STRUCT *pPrim) === called from Frame/Src/vsi_com.c:vsi_c_primitive(), in turn from Layer1/L1i/Src/dl1_mem.c:os_receive_sig(UWORD8 queue) whenever the Layer1 receives a Signal. === Layer1/L1i/Src/dl1_pei.c:pei_run(T_VSI_CHANDLE handle) === process primitives, called by main loop in the protocol stack entity === Layer1/L1c/Src/l1_async.c:l1a_task() === {{{ /* L1A (Layer 1 Asynchronous) task function. This */ /* function manages the interface between L3 and L1. It */ /* is composed with a set of state machine, each machine */ /* handles a particular GSM functionality. When a */ /* message is received in L1_C1 message queue, it is */ /* submitted to every state machine. The one which are */ /* impacted by the message process it. At the end of */ /* "l1a_task()" function, a balance routine is called, */ /* it enables L1S tasks consequently to the state machine*/ /* requests. */ }}} * iterates over list of primitives, call l1pa_task() === Layer1/L1c/Src/l1p_asyn.c:l1pa_task(xSignalHeaderRec *msg) === call into the various lapa_*_process() functions for GPRS === layer1 asynchronous === ==== l1a_test_process() ==== Hardware test ==== l1a_stats_process() ==== Statistics or Test process ==== l1a_mmi_adc_req() ==== ADC conversion ==== l1a_freq_band_configuration() ==== Frequency Band configuration: GSM900, E-GSM900, DCS1800, DUAL, DUALEXT, PCS 1900 {{{ /* Description : This state machine handles the frequency*/ /*band configuration: E_GSM900, GSM900, DCS1800, PCS1900,*/ /*DUAL, DUALEXT, DUALEXT_PCS1900... */ /* */ /* Starting messages: MPHC_INIT_L1_REQ */ /* */ /* Result messages (input): none */ /* Result messages (output): MPHC_INIT_L1_CON */ /* Reset messages (input): none */ }}} ==== l1a_initial_network_sync_process() ==== Synchronization with a Neighbour cell for Cell Selection {{{ /* Description : This state machine handles the 1st */ /* synchronization with the network. */ /* */ /* Starting messages: MPHC_NETWORK_SYNC_REQ */ /* */ /* Result messages (input): L1C_FB_INFO */ /* L1C_SB_INFO */ /* */ /* Result messages (output): MPHC_NETWORK_SYNC_IND */ /* */ /* Reset messages (input): MPHC_STOP_NETWORK_SYNC_REQ */ /* (MPHC_STOP_NETWORK_SYNC_CON) */ }}} ==== l1a_network_lost() ==== lost Network ==== l1a_full_list_meas_process() ==== Full list receive level monitoring {{{ /* Description: */ /* ------------ */ /* This function is a state machine which handles the */ /* Cell Selection Full List Power Measurement L1/L3 */ /* interface and it handles the neigbour cell */ /* measurement process in IDLE mode with FULL list. */ /* When a message MPHC_RXLEV_REQ is received */ /* the L1S task FSMS_MEAS is enabled. When this task */ /* is completed a reporting message L1C_VALID_MEAS_INFO */ /* is received and forwarded to L3. */ /* */ /* Starting messages: MPHC_RXLEV_REQ. */ /* */ /* Result messages (input): L1C_VALID_MEAS_INFO */ /* */ /* Result messages (output): MPHC_RXLEV_IND */ /* */ /* Reset messages (input): none */ /* */ /* Stop message (input): MPHC_STOP_RXLEV_REQ */ /* */ /* Stop message (output): MPHC_STOP_RXLEV_CON */ /* */ /* Rem: */ /* ---- */ /* L3 is in charge of the number of pass to follow the */ /* GSM recommendation. */ }}} ==== l1a_idle_ba_list_meas_process() ==== {{{ /* Description : This state machine handles neigbor cell */ /* measurement process in IDLE mode with BA list. */ /* */ /* Starting messages: MPHC_RXLEV_PERIODIC_REQ */ /* ------------------ */ /* L1 starts then the periodic BA list receive level */ /* monitoring. */ /* */ /* Subsequent messages: MPHC_RXLEV_PERIODIC_REQ */ /* -------------------- */ /* L1 changes the BA list and starts the periodic BA */ /* list receive level monitoring with this new list. */ /* */ /* Result messages (input): L1C_RXLEV_PERIODIC_DONE */ /* ------------------------ */ /* This is the periodic reporting message from L1s. */ /* */ /* Result messages (output): MPHC_RXLEV_PERIODIC_IND */ /* ------------------------- */ /* This is the periodic reporting message to L3. */ /* */ /* Reset messages (input): MPHC_STOP_RXLEV_PERIODIC_REQ*/ /* ----------------------- */ /* BA list neigbor cell measurement process in IDLE */ /* is stopped by this message. */ }}} ==== l1a_idle_6strongest_monitoring_process() ==== 6 strongest Neighbor cells synchro. monitoring {{{ /* Description: */ /* ------------ */ /* This function is a state machine which handles the */ /* synchronization with up to 6 neighbor cells */ /* */ /* Starting messages: MPHC_NCELL_SYNC_REQ */ /* ------------------ MPHC_NCELL_LIST_SYNC_REQ */ /* L1 makes an attempt to read the FB/SB or to confirm */ /* SB. */ /* */ /* */ /* Result messages (input): L1C_FB_INFO */ /* ------------------------ L1C_SB_INFO */ /* L1C_SBCONF_INFO */ /* Result messages from L1S. FB detection, SB detection,*/ /* SB confirmation. */ /* */ /* Result messages (output): MPHC_NCELL_SYNC_IND */ /* ------------------------- */ /* SB indication. */ /* */ /* Reset messages (input): MPHC_STOP_NCELL_SYNC_REQ */ /* ----------------------- (MPHC_STOP_NCELL_SYNC_CON) */ }}} ==== l1a_neighbour_cell_bcch_reading_process() ==== 6 strongest Neighbor cells BCCH reading {{{ /* Description: */ /* ------------ */ /* This function is a state machine which handles the */ /* BCCH reading from up to 6 neighbour cells */ /* */ /* Starting messages: MPHC_NCELL_BCCH_REQ */ /* ------------------ */ /* */ /* Result messages (input): L1C_BCCHN_INFO */ /* ------------------------ */ /* */ /* Result messages (output): MPHC_NCELL_BCCH_IND */ /* ------------------------- */ /* */ /* Reset messages (input): MPHC_STOP_NCELL_BCCH_REQ */ /* ----------------------- (MPHC_STOP_NCELL_BCCH_CON) */ }}} ==== l1a_idle_serving_cell_bcch_reading_process() ==== Serving Cell BCCH reading {{{ /* Starting messages: MPHC_SCELL_NBCCH_REQ */ /* ------------------ MPHC_SCELL_EBCCH_REQ */ /* */ /* L1 continuously reads the serving cell BCCH and/or */ /* Extended BCCH as requested by the scheduling info. */ /* */ /* Result messages (input): L1C_BCCHS_INFO */ /* ------------------------ */ /* System information data block from L1S. */ /* */ /* Reset messages (input): MPHC_STOP_SCELL_BCCH_REQ */ /* ----------------------- (MPHC_STOP_SCELL_BCCH_CON) */ }}} ==== l1a_idle_serving_cell_paging_process() ==== Serving Cell PAGING reading {{{ /* Description : This state machine handles paging */ /* */ /* Starting messages: MPHC_START_CCCH_REQ */ /* ------------------ */ /* */ /* L1 continuously reads the serving cell BCCH and/or */ /* Extended BCCH as requested by the scheduling info. */ /* */ /* Result messages (input): L1C_ALLC_INFO */ /* ------------------------ L1C_NP_INFO */ /* L1C_EP_INFO */ /* */ /* Reset messages (input): MPHC_STOP_CCCH_REQ */ /* ----------------------- (MPHC_STOP_CCCH_CON) */ }}} ==== l1a_idle_smscb_process() ==== Short Message Servive Cell Broadcast reading {{{ /* Description : This state machine handles the SMSCB */ /* (Short Message Service Cell Broadcast). */ /* */ /* Starting messages: MPHC_CONFIG_CBCH_REQ */ /* */ /* Subsequent messages: MPHC_CBCH_SCHEDULE_REQ */ /* MPHC_CBCH_INFO_REQ */ /* MPHC_CBCH_UPDATE_REQ */ /* */ /* Result messages (input): L1C_CB_INFO */ /* */ /* Result messages (output): MPHC_DATA_IND */ /* */ /* Reset messages (input): MPHC_STOP_CBCH_REQ */ /* */ }}} ==== l1a_cres_process() ==== Cell reselection process Synchronization and requested BCCH reading --> camp on new cell {{{ /* Description: */ /* ------------ */ /* This function is a state machine which handles Cell */ /* Reselection. */ /* */ /* Starting messages: MPHC_NEW_SCELL_REQ */ /* ------------------ */ /* L1 camps on the given ARFCN. */ /* */ /* Result messages (output): MPHC_NEW_SCELL_CON */ }}} The following data is supplied along with the MPHC_NEW_SCELL_REQ message: * radio_freq (ARFCN) * BSIC * time_alignment information * fn_offfset (frame number offset) Those values are stored in l1s_l1s_com.Scell_info (serving cell info) and the SYNCHRO L1S task is marked for execution. Finally, MPHC_NEW_SCELL_CON is sent up to L2/3. ==== l1a_access_process() ==== Link Access Process. {{{ /* Description : This state machine handles the access */ /* to the network while in IDLE mode. */ /* */ /* Starting messages: MPHC_RA_REQ */ /* */ /* Subsequent messages: MPHC_RA_REQ */ /* */ /* Result messages (input): L1C_RA_DONE */ /* */ /* Result messages (output): MPHC_RA_CON */ /* */ /* Reset message (input): MPHC_STOP_RA_REQ */ /* */ /* Reset message (input): MPHC_STOP_RA_CON */ }}} ==== l1a_dedicated_process() ==== Dedicated mode process {{{ /* Description : This state machine handles the dedicated*/ /* mode setup (L1A side). */ /* */ /* Starting messages: MPHC_IMMED_ASSIGN_REQ */ /* */ /* Subsequent messages: MPHC_CHANNEL_ASSIGN_REQ */ /* MPHC_SYNC_HO_REQ */ /* MPHC_PRE_SYNC_HO_REQ */ /* MPHC_PSEUDO_SYNC_HO_REQ */ /* MPHC_ASYNC_HO_REQ */ /* MPHC_ASYNC_HO_COMPLETE */ /* MPHC_HANDOVER_FAIL_REQ */ /* MPHC_CHANGE_FREQUENCY */ /* OML1_CLOSE_TCH_LOOP_REQ */ /* OML1_OPEN_TCH_LOOP_REQ */ /* OML1_START_DAI_TEST_REQ */ /* OML1_STOP_DAI_TEST_REQ */ /* */ /* Result messages (input): L1C_DEDIC_DONE */ /* L1C_SACCH_INFO */ /* */ /* Result messages (output): MPHC_CHANNEL_ASSIGN_CON */ /* MPHC_SYNC_HO_CON */ /* MPHC_PRE_SYNC_HO_CON */ /* MPHC_PSEUDO_SYNC_HO_CON */ /* MPHC_ASYNC_HO_CON */ /* MPHC_TA_FAIL_IND */ /* MPHC_DATA_IND */ /* OML1_CLOSE_TCH_LOOP_CON */ /* OML1_OPEN_TCH_LOOP_CON */ /* OML1_START_DAI_TEST_CON */ /* OML1_STOP_DAI_TEST_CON */ /* */ /* Reset messages (input): MPHC_CHANNEL_RELEASE */ }}} ==== l1a_dedic6_process ==== 6 strongest Neighbor cells synchro. monitoring and BCCH reading {{{ /* Description : This state machine handles the 6 strong.*/ /* neighbor cells management in dedicated mode. */ /* */ /* Remark: in dedicated mode there is no reason to use */ /* the task parameters semaphores since there is no */ /* ambiguity and no asynchronous/synchronous conflict to */ /* care about. */ /* */ /* Starting messages: L1C_DEDIC_DONE */ /* */ /* Result messages (input): L1C_FB_INFO */ /* L1C_SB_INFO */ /* L1C_SBCONF_INFO */ /* */ /* Reset messages (input): MPHC_CHANNEL_RELEASE */ }}} === layer 1 synchronous === ==== Layer1/L1c/Src/l1_sync.c:hisr() ==== Interrupt Service Routine called by the DSP TDMA frame interrupt * Calls l1s_synch() ==== Layer1/L1c/Src/l1_sync.c:l1s_synch() ==== {{{ /* This function is the core of L1S. Here is a summary */ /* of the execution: */ /* */ /* - Frame counters management. */ /* - Get current communication page pointers. */ /* - RESET internal variables. */ /* - RESET MCU->DSP DB communication page. */ /* - TOA update management. */ /* */ /* - L1 task manager, */ /* - Dedicated_mode_manager. */ /* - Task_scheduler. */ /* - Execute_frame. */ /* - Neighbor cells measurement manager. */ /* - End manager. */ }}} ==== l1s_dedicated_mode_manager() ==== * assignment of a new channel, changing channel mode, ciphering start, etc. ==== l1s_task_scheduler_process() ==== {{{ /* This function is the task scheduler of L1S. It */ /* schedules any enabled task. When a task must start, */ /* it becomes PENDING. Since several tasks can become */ /* pending at the same time, the highest priority one */ /* is elected. The elected task compete then with the */ /* current running task. If they conflict, the highest */ /* priority one wins. If the winning is the new comer */ /* then the multiframe table is reset and the new coming */ /* task is installed. */ }}} ==== l1s_execute_frame() ==== * call l1s_exec_mftab() ==== Layer1/L1c/Src/l1_mfmgr.c:l1s_exec_mftab() ==== * Execute functions from MFTAB FIXME ==== l1s_meas_manager() ==== {{{ /* Description: */ /* ------------ */ /* This function is the measurement tasks manager. */ /* The followings tasks are handled: */ /* */ /* FSMS_MEAS: */ /* 1) Full list measurement in Cell Selection */ /* The machine performs 1 valid measurement per carrier */ /* from the full list of GSM carriers. To achieve 1 */ /* valid measurement, 2 attempt with 2 different AGC */ /* are performed worst case. When all carriers are */ /* a reporting message L1C_VALID_MEAS_INFO is built and */ /* sent to L1A. */ /* */ /* 2) Full list measurement in Idle mode. */ /* The machine performs 1 valid measurement per carrier */ /* from the full list of GSM carriers. To achieve 1 */ /* valid measurement, 2 attempt with 2 different AGC */ /* are performed worst case. When all carriers are */ /* a reporting message L1C_VALID_MEAS_INFO is built and */ /* sent to L1A. */ /* */ /* I_BAMS_MEAS: BA list measurement in Idle mode. */ /* The machine performs 7 measurements per PCH reading */ /* (3*2+1) looping on the BA list. When 7 measurements are */ /* completed (end of PCH) a reporting message */ /* L1C_RXLEV_PERIODIC_DONE is built and sent to L1A. */ }}} ==== l1s_end_manager() ==== * copy page into real time trace buffer ==== l1s_increment_time() ==== * Increament the various framenumbers by one === L1A Tasks === ==== SYNCHRO ==== This task synchronizes the L1S to a new cell. It receives input parameters (arfcn, tn_difference, time_alignment) from L2/3 and programs the TPU accordingly. There is no DSP task executed as part of SYNCHRO. === DSP Tasks === {{{ #define HWTEST 0 // DSP checksum reading #define ADC_CSMODE0 1 // ADC task in CS_MODE0 mode #define DEDIC 2 // Global Dedicated mode switch #define RAACC 3 // Channel access (ul) #define RAHO 4 // Handover access (ul) #define NSYNC 5 // Global Neighbour cell synchro switch #define POLL 6 // Packet Polling (Access) #define PRACH 7 // Packet Random Access Channel #define ITMEAS 8 // Interference measurements #define FBNEW 9 // Frequency burst search (Idle mode) #define SBCONF 10 // Synchro. burst confirmation #define SB2 11 // Synchro. burst read (1 frame uncertainty / SB position) //#define PTCCH 12 // Packet Timing Advance control channel CCR 9-12-02 BUG02527 #define FB26 12 // Frequency burst search, dedic/transfer mode MF26 or MF52 #define SB26 13 // Synchro burst search, dedic/transfer mode MF26 or MF52 #define SBCNF26 14 // Synchro burst confirmation, dedic/transfer mode MF26 or MF52 #define FB51 15 // Frequency burst search, dedic mode MF51 #define SB51 16 // Synchro burst search, dedic MF51 #define SBCNF51 17 // Synchro burst confirmation, dedic MF51 #define PDTCH 18 // Packet Data channel #define BCCHN 19 // BCCH Neighbor in GSM Idle #define ALLC 20 // All CCCH Reading #define EBCCHS 21 // Extended BCCH Serving Reading #define NBCCHS 22 // Normal BCCH Serving Reading #define SMSCB 23 // CBCH serving Reading #define ADL 24 // SACCH(SDCCH) DL #define AUL 25 // SACCH(SDCCH) UL #define DDL 26 // SDCCH DL #define DUL 27 // SDCCH UL #define TCHD 28 // Dummy for TCH Half rate #define TCHA 29 // SACCH(TCH) #define TCHTF 30 // TCH Full rate #define TCHTH 31 // TCH Half rate #define PALLC 32 // All PCCCH reading #define PSMSCB 33 // CBCH serving Reading while in Packet Idle #define PBCCHS 34 // PBCCH serving reading #define PNP 35 // Packet Normal paging Reading #define PEP 36 // Packet Extended paging Reading #define SINGLE 37 // Single Block for GPRS #define PBCCHN_TRAN 38 // Packet BCCH Neighbor in Packet Transfer mode. #define PBCCHN_IDLE 39 // Packet BCCH Neighbor in Idle mode. #define BCCHN_TRAN 40 // BCCH Neighbour in Packet Transfer mode #define NP 41 // Normal paging Reading #define EP 42 // Extended paging Reading #define BCCHN_TOP 43 // BCCH Neighbour TOP priority in Idle mode #define PTCCH 44 // Packet Timing Advance control channel #define SYNCHRO 45 // synchro task: L1S reset #define PTS_START_TX_BURST_TEST 46 // PTS transmission test #define PTS_START_RX_BURST_TEST 47 // PTS receive test #define PTS_START_FB_BURST_TEST 48 // PTS frequency burst receive test #define PTS_START_FB26_BURST_TEST 49 // PTS frequency burst receive test #define PTS_START_SB26_BURST_TEST 50 // PTS frequency burst receive test }}} === DSP Driver (l1_drive.c) === ==== l1ddsp_load_monit_task(API monit_task, fb_mode) ==== * monit_taks = number of measurements (max 8) + sometimes 0x200 * set FB detection algorithm ==== l1ddsp_load_txpwr(u8 vp_TxPower, u16 vp_Arfcn) ==== ==== l1ddsp_load_rx_task(API rx_task, UWORD8 burst_id, UWORD8 tsq) ==== Load values into l1s_dsp_com.dsp_db_w_ptr: * d_task_d = rx_task * d_burst_d = burst_id * d_ctrl_system |= tsq << B_TSQ ==== l1ddsp_load_ra_task(API ra_task) ==== * d_task_ra = ra_task ==== l1ddsp_load_tch_mode(UWORD8 dai_mode, BOOL dtx_allowed) ==== ==== l1ddsp_load_tch_param() ==== ==== l1ddsp_load_ciph_param(UWORD8 a5mode, T_ENCRYPTION_KEY *ciph_key) ==== Set * l1s_dsp_com.dsp_ndb_ptr->d_a5mode = a5mode * l1s_dsp_com.dsp_ndb_ptr->a_kc ==== l1ddsp_stop_tch() ==== Set * l1s_dsp_com.dsp_db_w_ptr->d_ctrl_tch |= (B_STOP_TCH_UL|B_STOP_TCH_DL) ==== l1ddsp_end_scenario() ==== * l1s_dsp_com.dsp_w_page * l1s_dsp_com.dsp_ndb_ptr->d_dsp_page * call l1dmacro_set_frame_it() ==== l1dmacro_set_frame_it() ==== Enable GSM Frame Interrupt on next TDMA frame Typically called at the end of processing a TDMA frame interrupt ==== l1d_reset_hw(UWORD32 offset_value) ==== === TPU Macros (Layer1/L1d/src/l1d_Tpu.hm) === ==== MC_L1D_TPU_REWIND ==== Re-initialize the global current TPU pointer to L1D_TPU_RAM. ==== MC_L1D_TPU_SLEEP ==== Sleep for one TPU tick (instruction 0) ==== MC_L1D_TPU_MOVE(addr,data) ==== Put a MOVE instruction at the current TPU pointer ==== MC_L1D_TPU_AT(time) ==== Put an AT instruction at the current TPU pointer ==== MC_L1D_TPU_SYNC(time) ==== Put a SYNC instruction at the current TPU pointer ==== MC_L1D_TPU_WAIT(time) ==== Put a WAIT instruction at the current TPU pointer ==== MC_L1D_TPU_OFFSET(time) ==== Put a OFFSET instruction at the current TPU pointer ==== MC_L1D_TSP_ACT_INIT(signal) ==== * set v_L1d_TspActValue == signal * issue MC_L1D_TPU_MOVE instructions for L1D_TSP_ACTX and L1D_TSP_ACT ==== MC_L1D_TSP_ACT_SET(signal) ==== * set v_L1d_TspActValue |= signal * issue MC_L1D_TPU_MOVE instructions as required ==== MC_L1D_TSP_ACT_RESET(signal) ==== * unset v_L1d_TspActValue |= signal * issue MC_L1D_TPU_MOVE instructions as required === TPU (Layer1/L1d/src/l1d_Tpu.c) === ==== TP_Reset(u16 on) ==== * Issue L1D_TPU_CTRL_RESET in L1D_TPU_CTRL register * Wait until reset has been asserted ==== TP_Enable(u16 on) ==== * Set or unset L1D_TPU_CTRL_T_ENBL in L1D_TPU_CTRL ==== l1dmacro_idle(void) ==== ==== l1dmacro_offset(u32 offset_value, s32 relative_time) ==== ==== l1dmacro_synchro(u32 when, u32 value) ==== ==== TPU_ClkEnable(SYS_UWORD16 on) ==== * Set or unset L1D_TPU_CTRL_CLK_EN in TPU_CTRL * wait until change becomes active ==== TPU_FrameItEnable(void) ==== * Enable Frame interrupt by TPU_CTRL_D_ENBL in TPU_CTRL ==== l1dmacro_set_frame_it(void) ==== * Call TPU_FrameItEnable() ==== l1pdmacro_it_dsp_gen(WORD16 time) * MC_L1D_TPU_AT (time); * MC_L1D_TPU_MOVE (L1D_TPU_IT_DSP_PG,0x0001); ==== l1pdmacro_anchor(WORD16 time) * MC_L1D_TPU_AT (time); ==== TPU_check_IT_DSP(void) ==== * check if an IT DSP is still pending === RF Frontend Driver === ==== l1d0_0ActivateTx (u16 vp_Start, u8 vp_TxPwr, u8 vp_Band) ==== Activate TX path of the radio section to transmit a burst ==== l1d0_1DeactivateTx (u16 vp_Start, u8 vp_TxPwr, u8 vp_Band) ==== ==== l1d0_2CalcArfcnNcntValue(u16 vp_Arfcn, u8 vp_TxRx, u8 vp_Band) ==== Calculate N-Counter for RF-PLL ==== l1d0_3BuildGainReg(u16 vp_Arfcn, u8 vp_Band, t_L1d_Level *pp_Level) ==== Calculate AGC register prior to Rx ==== l1d0_4DeactivateRx(u16 vp_Start) ==== Deactivate Radio Rx power control paths ==== l1d0_6RxWinCtrl(u16 vp_Arfcn, u8 vp_WinId, t_L1d_Level *pp_level, u8 vp_Fb26SpecialCase) ==== Program everything on Vega & LMX for TX path ==== l1d0_7TxWinCtrl(u16 vp_Arfcn, u8 vp_WinId, u8 vp_TxPwr) ==== Programs everything on vega & LMX for TX path except power ramping ==== l1d0_8ILToGain(u16 vp_Arfcn, u8 vp_Band, t_L1d_Level *pp_level) ==== Computes the various gains to be programmed in the LMX3411 RF chip according to the expected input level at the antenna ==== l1d0_13ActivateRx (u16 vp_Start, u8 vp_Band) ==== Activate the Radio Rx path ==== l1d0_15RfInit(void) ==== Initialization routine for RF ==== l1d0_16ProgRfArfcn(u16 vp_Arfcn, u8 vp_TxRx, u8 vp_Band) ==== Program RF synthesizer N-Counter ==== l1dmacro_reset_hw(u32 vp_ServingCellOffset) ==== Reset and set OFFSET register serving cell offset ==== l1dmacro_init_hw(void) ==== Reset VEGA, then remove reset & Init RF synthesizers ==== l1d_GenerateLMXRCountRegister(u8 vp_Band, u8 vp_TxRx) ==== Creates R counter register for LMX == Data Structures == === l1s (Layer1/L1c/Inc/l1_defty.h:T_L1S_GLOBAL) === Global Layer1 Sync variables, such as * L1S Task Management * MFTAB management variables * Control Parameters (TOA) * TPU and DSP control registers * Frame Number Management for serving cell (actual_time, next_time, next_plus_time) * TX Power management * RXqual mesurement === l1a (Layer1/L1c/Inc/l1_defty.h:T_L1A_GLOBAL) === Global Layer1 Async variables, such as * State for L1A machines (1 for each L1A_PROCESS) * L1A Task management * MEasurement task management === l1a_l1s_com (T_L1A_L1S_COM) === Communication Structure from L1A into L1S * serving cell identity / information * parameters for idle mode * parameters for CBCH * random access information * ADC management * TXPWR management * dedicated channel parameters (T_DEDIC_PARAM) * neighbor cell information * BA list / FULL list * L1S task management * measurement tasks management * input level memory for AGC management === l1s_dsp_com (T_L1S_DSP_COM) === Communication structure for L1S -> DSP communication * active page for ARM writing to DSP * active page for ARM reading from DSP * pointers to dual-buffered (DB) and non-dual-buffered (NDB) MCU<->DSP pages ==== T_DB_MCU_TO_DSP ==== === * {downlink,uplink} task {command, burst identifier} * d_task_d -- Downlink DSP task number * d_burst_d -- Downlink burst identifier * d_task_u -- Uplink DSP task number * d_burst_u -- Uplink burst identifier * d_task_md -- downlink monitoring (FB/SB) command * d_background -- background tasks * d_debug -- Debug/Acknowledge/general purpose word * d_task_ra -- RA task command * d_fn -- frane mumber in case of TCH {{{ // bit [0..7] -> b_fn_report, FN in the normalized reporting period. // bit [8..15] -> b_fn_sid, FN % 104, used for SID positionning. }}} * d_ctrl_tch -- TCH description {{{ // bit [0..3] -> b_chan_mode, channel mode. // bit [4..5] -> b_chan_type, channel type. // bit [6] -> reset SACCH. // bit [7] -> vocoder ON // bit [8] -> b_sync_tch_ul, synchro. TCH/UL. // bit [9] -> b_sync_amr, // bit [10] -> b_stop_tch_ul, stop TCH/UL. // bit [11] -> b_stop_tch_dl, stop TCH/DL. // bit [12.14] -> b_tch_loop, tch loops A/B/C. // bit [15] -> b_subchannel }}} * d_ctrl_abb -- Bit field indicating teh analog baseband register to send {{{ // bit [0] -> b_ramp: the ramp information(a_ramp[]) is located in NDB // bit [1.2] -> unused // bit [3] -> b_apcdel: delays-register in NDB // bit [4] -> b_afc: freq control register in DB // bit [5..15] -> unused }}} * da_a5fn -- encryption frame number {{{ // word 0, bit [0..4] -> T2. // word 0, bit [5..10] -> T3. // word 1, bit [0..11] -> T1. }}} * d_power_ctl -- power level control (L1D_AUXAPC|n) * d_afc -- AFC value (enabled by b_afc in d_ctrl_abb) * d_ctrl_system -- Control Register for RESET/RESUME {{{ // bit [0..2] -> b_tsq, training sequence. // bit [3] -> b_bcch_freq_ind, BCCH frequency indication. // bit [15] -> b_task_abort, DSP task abort command. }}} ==== T_DB_DSP_TO_MCU ==== * {downlink,uplink} task {command, burst identifier} * d_task_d * d_burst_d * d_task_u * d_burst_u * d_task_md -- downlink monitoring (FB/SB) command * number of cells to monitor * d_background -- background tasks * d_task_ra -- RA task command * a_serv_Demod -- Serv. cell demod. result, array of 4 words (TOA,PM,ANGLE,SNR) * a_pm -- Power measurement results, array of 3 words * a_sch -- Header + SB information, array of 5 words ==== T_NDB_MCU_DSP ==== * d_dsp_page {{{ // bit[0] -> B_GSM_PAGE: which of the two double-buffered pages is current // bit[1] -> B_GSM_TASK: is the GSM TASK active? // bit[2] -> B_MISC_PAGE: which of the two misc pages is current // bit[3] -> B_MISC_TASK: are MISC tasks active? }}} * d_error_status -- DSP status returned (DSP->MCU) * d_spcx_rif -- RIF control (MCU->DSP), always set to 0x179 * d_tch_mode -- TCH mode register {{{ // bit [0..1] -> b_dai_mode. // bit [2] -> b_dtx. // bit[3] -> play_ul when set to 1 // bit[4] -> play_dl when set to 1 // bit[5] -> DTX selection for voice memo // bit[6] -> Reserved for ciphering debug // bit[7..10] -> Reserved for ramp up control // bit[11] -> Reserved for analog device selection }}} * d_debug1 -- bit 0 at 1 enable dsp f_tx delay of 400000 cyc DEBUG * d_dsp_test * API version number information * d_version_number1 -- code version number * d_version_number2 -- patch version number * debug buffer for tracing * p_debug_buffer * d_debug_buffer_size * d_debug_trace_type * d_dsp_state -- DSP report its stata: 0 run, 1 Idle1, 2 Idle2, 3 Idle3 * p_debug_amr -- AMR debugging * d_mcsi_select -- Related to the MCSI bus interface * New words APCDEL1 and APCDEL2 for 2TX: TX/PRACH combinations * d_apcdel1_bis * d_apcdel2_bis * New registres due to IOTA ABB * d_apcdel2 -- copied from l1config.params.apcdel2 * d_vbctrl2 * d_bulgcal -- Calibration value copied from l1_config.params.bulgcal * Analog Base Band * d_afcctladd -- Copied form l1_config.params.afcctladd * d_vbuctrl -- Voice Uplink Control? * d_vbdctrl -- Voice Downlink Control? * d_apcdel1 -- APC? * d_apcoff -- APC? * d_bulioff -- Copied from l1_config.params.bulioff * d_bulqoff -- Copied from l1_config.params.bulqoff * d_dai_onoff -- Copied from l1_config.params.dai_onoff * d_auxdac -- * d_bbctrl * results of monitoring tasks (FB + SB) DSP->MCU * d_fb_det -- FB detection result (1 for FOUND) * d_fb_mode -- Mode for FB detection algorithm * FB_MODE_0 -- wideband search for FB detection * FB_MODE_1 * a_async_demod[4] -- FB/SB demod. result (TOA,PM,ANGLE,SNR) * audio gain for upolink and downlink * d_audio_gain_ul * d_audio_gain_dl * audio playback related data * d_audio_compressor_ctrl * d_audio_init * d_audio_status * Tones (MCU -> DSP) * d_toneskb_init * d_toneskb_status * d_k_x1_t0 * d_k_x1_t1 * d_k_x1_t2 * d_pe_rep * d_pe_off * d_se_off * d_bu_off * d_t0_on * d_t0_off * d_t1_on * d_t1_off * d_t2_on * d_t2_off * d_k_x1_kt0 * d_k_x1_kt1 * d_dur_kb * d_shiftdl * d_shiftul * d_aec_ctrl * d_es_level_api * d_mu_api * melody ringer module * d_melo_osc_used * d_melo_osc_active * a_melo_route0 ... a_melo_route7 * d_melody_selection -- selection of melody format * speech recognition related data * d_sr_status * d_sr_param -- parameters for the DSP speech recognition task: OOV threshold * d_sr_bit_exact_test * d_sr_nb_words -- number of words used in the speech recognition task * d_sr_db_level -- Estimate voice level in dB * d_sr_db_noise -- Estimate noise in dB * a_n_best_words -- Array of the 4 best words * a_n_best_score -- Array of the 4 best scores (32bit for each score) * audio buffer * a_dd_1[22] * a_du_1[22] * v42bis module * d_v42b_nego0 * d_v42b_nego1 * d_v42b_control * d_v42b_ratio_ind * d_mcu_control * d_mcu_control_sema * background tasks * d_background_enable * B_DSPBGD_RECO -- background recognition task code * C_BGD_RECOGN * B_DSPBGD_UPD -- start of alignment update in dsp background * C_BGD_ALIGN * d_background_abort * d_background_state * d_max_background * a_background_tasks[16] * a_back_task_io[16] * GPRS/GEA ciphering info * d_gea_mode_ovly * a_gea_kc_ovly[4] * d_thr_usf_detect -- word used for the init of USF threshold * d_a5mode -- A5 encryption mode * d_sched_mode_grps_ovly * a_ramp[16] -- power ramp information * actual data inside logical channels * a_cd[15] -- CCCH/SACCH downlink information * a_fd[15] -- FACCH downlink information * a_dd_0[22] -- traffic downlink data frames * a_cu[15] -- CCCH/SACCH uplink information * a_fu[15] -- FACCH upilink information * a_du_0[22] -- TCH upilink data frames * d_rach -- RACH information (MCU -> DSP) * a_kc[4] -- Kc (MCU->DSP) * integrated data services module * speech recognition model * EOTD related data * AMR v1.0 buffers * a_amr_config[4] * a_ratscch_ul[6] * a_ratscch_dl[6] * d_amr_snr_est -- estimation of the SNR of the AMR speech block * detection thresholds ==== T_PARAM_MCU_DSP ==== All parameters are initialized at dsp_power_on() time form a static array. * d_transfer_rate * GPRS related latencies * d_lat_mcu_bridge * d_lat_mcu_hom2sam * d_lat_mcu_bef_fast_access * d_lat_dsp_after_sam * d_grps_install_address (dsp start address) * d_misc_config * d_cn_sw_workaround * d_fb_margin_beg * Frequency Correction Burst (FB) * d_fb_margin_beg * d_fb_margin_end * d_nsubb_idle * d_nsubb_dedic * d_fb_thr_det_iacq * d_fb_thr_det_track * Demodulation * d_dc_off_thres * d_dummy_thres * d_dem_pond_gewl * d_dem_pond_red * TCH/F V1 Full-Rate Speech * d_maccthresh1 * d_mldt * d_maccthresh * d_gu * d_go * d_attmax * d_sm * d_b * V42bis related data * TCH/H V1 Half-Rate * d_ldT_hr * d_maccthresh_hr * d_maccthresh1_hr * d_gu_hr * d_go_hr * d_sm_hr * d_attmax_hr * TCH/F V2 EFR * c_mldt_efr * c_maccthresh_efr * c_maccthresh1_efr * c_gu_efr * c_go_efr * c_b_efr * c_sm_efr * c_attmax_efr * CHED * FACCH module * d_facch_thr * IDS module * FIR coefficients * a_fir31_uplink[31]; * a_fir32_downlink[31]; === l1s_tpu_com (T_L1S_TPU_COM) ===