TSM30Layer1 » History » Revision 3
Revision 2 (laforge, 02/19/2016 10:49 PM) → Revision 3/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
=== 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) ===
