view chipsetsw/layer1/p_include/l1p_deft.h @ 349:ed3e588600c1 default tip

README update for the successful completion of the L1 reconstruction project
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 30 Oct 2017 18:03:24 +0000
parents 509db1a7b7b8
children
line wrap: on
line source

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

typedef struct
{
  WORD32  rand;
  UWORD16 channel_request_data;
  UWORD8  bs_prach_blks;
  UWORD8  prach_alloc;
  UWORD32 fn_to_report;
}
T_PRACH_INFO;

typedef union
{
  UWORD16 prach_data[12];
  UWORD8  cs1_data[24];
}
T_CHAN_REQ_DATA;

typedef struct
{
  UWORD8          pol_resp_type;
  T_CHAN_REQ_DATA chan_req;
  UWORD32         fn;
  UWORD8          timing_advance;
  UWORD32         fn_to_report;
}
T_POLL_INFO;


typedef struct
{
  UWORD8  data_array[23];
  UWORD8  tn;
  UWORD8  dl_tn_to_restore;
  UWORD8  activity;
}
T_SINGLE_BLOCK;


typedef struct
{
  UWORD32               SignalCode;
  UWORD8                assignment_id;
  UWORD8                synchro_tn;
  UWORD8                allocated_tbf;
  UWORD8                dl_tbf_synchro_timeslot;
  UWORD8                ul_tbf_synchro_timeslot;
  UWORD8                transfer_synchro_timeslot;

  UWORD8                assignment_command;
  UWORD8                multislot_class;
  T_PACKET_TA           packet_ta;
  T_DL_POWER_CTL        dl_pwr_ctl;
  UWORD8                tsc;
  T_PACKET_FREQ_PARAM   freq_param;
  UWORD8                mac_mode;
  T_TBF_STI             tbf_sti;

  T_UL_RESSOURCE_ALLOC  *ul_tbf_alloc;
  T_DL_RESSOURCE_ALLOC  dl_tbf_alloc;

  BOOL                  interf_meas_enable;
  UWORD8                ts_override;
  BOOL                  pc_meas_chan;
}
T_TRANSFER_SET;


typedef struct
{
  UWORD8       ta_update_cmd;
  UWORD8       assignment_id;
  UWORD16      radio_freq;
  UWORD8       activity;
  BOOL         request_dl;
  T_PACKET_TA  packet_ta;
}
T_PTCCH_PARAM;

typedef struct
{
  UWORD8       tbf_release_cmd;
  UWORD8       released_tbf;
}
T_TBF_RELEASE_PARAM;

typedef struct
{
  UWORD8       pdch_release_cmd;
  UWORD8       timeslot_available;
  UWORD8       assignment_id;
}
T_PDCH_RELEASE_PARAM;

typedef struct
{
 UWORD8        assignment_id;
 UWORD8        txpwr[8];
 BOOL          crc_error;
 WORD8         bcch_level;
 UWORD16       radio_freq_tbl[4];
 WORD8         burst_level[4];
}
T_DL_PWR_CTRL;

typedef struct
{
  UWORD8       psi_param_update_cmd;
  UWORD8       Scell_pb;
  UWORD8       access_burst_type;
}
T_PSI_PARAM_UPDATE;

typedef struct
{
  BOOL                              semaphore;

  T_TRANSFER_SET                    *aset;
  T_TRANSFER_SET                    *fset[2];
  T_TRANSFER_SET                    set[3];

  T_UL_RESSOURCE_ALLOC              ul_tbf_alloc[3];

  T_SINGLE_BLOCK                    single_block;

  T_PTCCH_PARAM                     ptcch;
  T_TBF_RELEASE_PARAM               tbf_release_param;
  T_PDCH_RELEASE_PARAM              pdch_release_param;
  T_MPHP_REPEAT_UL_FIXED_ALLOC_REQ  repeat_alloc;
  T_PSI_PARAM_UPDATE                psi_param;

  T_DL_PWR_CTRL                     dl_pwr_ctrl;
}
T_TRANSFER_PARAM;

/***************************************************************************************/
/* L1S packet global variable structure...                                             */
/***************************************************************************************/

typedef struct
{
  BOOL            new_set;
  UWORD8          assignment_id;
  UWORD8          allocated_tbf;
  UWORD8          dl_tfi;
  UWORD8          ul_tfi;
  T_DL_POWER_CTL  dl_pwr_ctl;
  BOOL            pc_meas_chan;
  UWORD16         radio_freq_for_lna;
} T_READ_PARAM;

typedef struct
{
  UWORD8     ILmin_beacon;
  UWORD8     ILmin_others[8];

  // No power control AGC algorithm variables
  UWORD32    fn_select;
  BOOL       phase;

  // Downlink power control mode B variables
  UWORD8     last_PR_good;

  // TBF Parameters used during the PDTCH read phase
  T_READ_PARAM   read_param;

  // Flag used to know if the pc_meas_chan measurement has been controlled
  BOOL pc_meas_chan_ctrl;
}
T_L1PS_GLOBAL;

/***********************************************************/
/* L1PA global variable structure...                       */
/***********************************************************/
typedef struct
{
  // State for L1A state machines...
  //-----------------------------------------
  UWORD8    state[NBR_L1PA_PROCESSES];

  // Measurement tasks management...
  //-----------------------------------------
  UWORD32   l1pa_en_meas[NBR_L1PA_PROCESSES];
}
T_L1PA_GLOBAL;


/*************************************************************/
/* Packet Idle mode tasks information...                     */
/*************************************************************/
/* must be filled according to Packet Idle parameters...     */
/* ...                                                       */
/*************************************************************/
// Packet Idle Parameter description
typedef struct
{
  UWORD16  radio_freq;
  UWORD16  radio_freq_d;
  UWORD16  radio_freq_dd;
}
T_P_IDLE_PARAM;

// Packet Paging description
typedef struct
{
  // -------- Packet Paging description --------------
  UWORD8                  bs_pag_blks_res; // BS_PAG_BLKS_RES parameter (cf. S921 specification)
  UWORD8                  bs_pbcch_blks;   // BS_PBCCH_BLKS parameter (cf. S921 specification)
  T_PACKET_CHANNEL_DESC   packet_chn_desc; // Packet Channel Description: arfcn/Hopping description + TN + TSC
  T_MOBILE_ALLOCATION     frequency_list;  // Mobile allocation description
  UWORD8                  nb_ppch_per_mf52;// Number of Packet PCCH per MF52
  UWORD16                 first_pg_grp;    // First Paging Group index
  UWORD16                 pg_blks_avail;   // Number of Paging blocks available per MF52
  UWORD16                 pg_offset;       // (IMSI mo 1000) div (KC*N) (Note N = 1 for PCCCH)
  UWORD16                 split_pg_value;  // Min(pg_blks_avail, split_pg_cycle)

  //--
  BOOL                    epg_computation; // Packet Paging STATE used in Extended Paging scheduling
  UWORD16                 pnp_period;      // Paging Period = (52*64)/split_pg_value
  WORD16                  time_to_pnp;     // Time to  next PPCH block position.
}
T_PCCCH_PARAM;

typedef struct
{
  BOOL                    change_synchro;
  BOOL                    control_offset;
  BOOL                    read_all_psi;

  UWORD8                  nbr_psi;
  UWORD8                  bs_pbcch_blks;
  UWORD8                  psi1_repeat_period;
  UWORD8                  relative_position_array[20]; // Array for Relative position
  UWORD16                 offset_array[20];            // Array of offset computed from relative position
  T_PACKET_CHANNEL_DESC   packet_chn_desc;             // Packet Channel Description: arfcn/Hopping description + TN + TSC
  T_MOBILE_ALLOCATION     frequency_list;              // Mobile allocation description
  UWORD8                  rel_pos_to_report;           // Relative Position of the PBCCH block read and to
                                                       // to report to L3.
  UWORD16                 pbcch_period;                // PBCCH period = MFL52 * psi1_repaet_period;
  UWORD8                  tn_pbcch;                    // Time slot number relative for DSP point of view.
}
T_PBCCHS_PARAM;

typedef struct
{
  BOOL                    change_synchro;

  UWORD8                  pb;
  UWORD8                  bs_pbcch_blks;
  UWORD8                  psi1_repeat_period;
  UWORD8                  relative_position;           // for Relative position
  UWORD16                 offset;                      // offset computed from relative position
  T_PACKET_CHANNEL_DESC   packet_chn_desc;             // Packet Channel Description: arfcn/Hopping description + TN + TSC
  T_MOBILE_ALLOCATION     frequency_list;              // Mobile allocation description
  UWORD16                 pbcch_period;                // PBCCH period = MFL52 * psi1_repaet_period;
  UWORD16                 bcch_carrier;                // beacon of the neighbor cell (used by the DSP)
  WORD32                  fn_offset;
  WORD32                  time_alignmt;
}
T_PBCCHN_PARAM;

typedef struct
{
  BOOL                    dsp_r_page_switch_req;       // If true, the dsp_r_page must be toggled in the interference measurement read
  UWORD8                  multislot_class;             // Mobile multislot class
  UWORD8                  meas_bitmap;                 // Timeslots on which the interference measurements are done
  UWORD8                  position;                    // Position on which measurements must be done (search or ptcch frame)
  UWORD8                  idle_tn_rx;                  // Timeslot bitmap in packet idle with PCCCH on the frame before
  UWORD8                  idle_tn_no_rx;               // Timeslot bitmap in packet idle without PCCCH on the frame before
  UWORD16                 radio_freq;                  // Radio freq. processed by l1s_hopping_algo()
  T_PACKET_FREQ_PARAM     packet_intm_freq_param;      // Frequency parameters
}
T_ITMEAS_PARAM;

typedef struct
{
  UWORD32             fn;               // Absolute FN reported during the last measurement session
  UWORD8              rxlev[8];         // Buffer used to save the parameters reported to L3
  UWORD8              meas_bitmap;      // Interf meas bitmap.
  UWORD8              id;               // Id.
} T_L1A_INT_MEAS_PARAM;

typedef struct
{
  UWORD8                  lna;  // Input level result
  UWORD8                  il;   // LNA parameter
}
T_IL_LNA;

typedef struct
{
  UWORD8         next_to_ctrl;     // Carrier for next power measurement result.
  UWORD8         next_to_read;     // Next carrier to measure.

  UWORD8         pnp_ctrl;         // Specify to l1s_meas_manager() that a PPCH burst has been ctrl.

  UWORD8         ms_ctrl;
  UWORD8         ms_ctrl_d;
  UWORD8         ms_ctrl_dd;

  T_IL_LNA       used_il_lna[NB_MEAS_MAX_GPRS];
  T_IL_LNA       used_il_lna_d[NB_MEAS_MAX_GPRS];
  T_IL_LNA       used_il_lna_dd[NB_MEAS_MAX_GPRS];
}
T_CR_FREQ_LIST;

typedef struct
{
  UWORD8   nb_carrier;
  UWORD16  freq_list[32+1];
  UWORD8   list_id;
} T_CRES_LIST_PARAM;

typedef struct
{
  T_CRES_LIST_PARAM  *alist;
  T_CRES_LIST_PARAM  *flist;
  T_CRES_LIST_PARAM  list[2];
} T_CRES_FREQ_LIST;

typedef struct
{
  UWORD8            tcr_next_to_ctrl;
  UWORD8            tcr_next_to_read;
  UWORD8            last_stored_tcr_to_read;

  UWORD8            ms_ctrl;
  UWORD8            ms_ctrl_d;
  UWORD8            ms_ctrl_dd;

  BOOL              first_pass_flag;

  T_IL_LNA          used_il_lna;
  T_IL_LNA          used_il_lna_d;
  T_IL_LNA          used_il_lna_dd;

  BOOL              new_list_present;

  WORD8             beacon_meas;

  WORD8             fn_report;
  UWORD8            cres_meas_report;

} T_TCR_LIST_SET;

/***************************************************************************************/
/* L1A <-> L1S communication structure dedicated to packet mode                        */
/***************************************************************************************/
typedef struct
{
  // Packet Idle Parameters

  // PCCCH parameters
  T_PCCCH_PARAM     pccch;

  //--
  T_P_IDLE_PARAM          p_idle_param;    // Packet Idle Parameters description

  // Packet Access Parameters
  T_PRACH_INFO      pra_info;

  // Packet Access Parameters
  T_POLL_INFO       poll_info;

  // Packet Transfer Parameters
  T_TRANSFER_PARAM  transfer;

  // Serving Cell PBCCH parameters
  T_PBCCHS_PARAM     pbcchs;

  // Neigbour Cell PBCCH parameters
  T_PBCCHN_PARAM     pbcchn;

  // Interference measurement parameters
  T_ITMEAS_PARAM     itmeas;

  // Measurement tasks management...
  //-----------------------------------------
  UWORD32         meas_param;         // Synchro semaphore bit register for packet measurement tasks.
  UWORD32         l1ps_en_meas;       // Enable packet Meas task bit register.

  // Access burst type
  //------------------
  UWORD8           access_burst_type;

  // Frequency list Parameters used in Cell Reselection measurements
  // ---------------------------------------------------------------
  T_CR_FREQ_LIST   cr_freq_list;

  // Parameters used in Packet Transfer Neighbour measurement task
  // -------------------------------------------------------------
  T_TCR_LIST_SET   tcr_freq_list;

  // Cell Reselection list, used both in Packet Idle and Packet Transfer
  // -------------------------------------------------------------------
  T_CRES_FREQ_LIST  cres_freq_list;

} T_L1PA_L1PS_COM;


/***************************************************************************************/
/* API (MCU <-> DSP) communication structures                                          */
/***************************************************************************************/

typedef struct
{
  // GPRS Extension...............
  API d_task_d_gprs;        // (map?) Task, burst per burst  (part of header)
  API d_task_u_gprs;        // (map?) Task, burst per burst  (part of header)
  API d_task_pm_gprs;       // (map?) Task, burst per burst  (part of header)
  API d_burst_nb_gprs;      // (map?) burst identifier. (part of header)
  API a_ctrl_abb_gprs[8];   // (map?) Analog baseband control, burst per burst.
  API a_ctrl_power_gprs[8]; // (map?) Power control value, burst per burst.
}
T_DB_MCU_TO_DSP_GPRS;

typedef struct
{
  // GPRS Extension...............
  API d_task_d_gprs;        // (map?) Task, burst per burst  (part of header)
  API d_task_u_gprs;        // (map?) Task, burst per burst  (part of header)
  API d_task_pm_gprs;       // (map?) Task, burst per burst  (part of header)
  API d_burst_nb_gprs;      // (map?) burst identifier. (part of header)

  API a_burst_toa_gprs[8];  // (map?) Time of arrival, burst per burst
  API a_burst_pm_gprs[8];   // (map?) Receive Power Level, burst per burst
  API a_burst_angle_gprs[8];// (map?) Angle deviation, burst per burst
  API a_burst_snr_gprs[8];  // (map?) Signal to noise ratio, burst per burst
}
T_DB_DSP_TO_MCU_GPRS;

#if (DSP == 34) || (DSP == 35) || (DSP == 36)
  typedef struct
  {
    // GEA module
    API d_gea_mode;
    API a_gea_kc[4];

    API d_hole1_ndb_gprs[8];
    API d_a5mode_ovly;

    API d_sched_mode_gprs;

    API d_hole2_ndb_gprs[5];

    API d_usf_updated_gprs;
    API d_win_start_gprs;
    API d_usf_vote_enable;
    API d_bbctrl_gprs;

    API d_hole3_ndb_gprs[2];

    // (map?) BTS physical timeslot mapping.
    API a_ctrl_ched_gprs[8];  // (map?) Ched configuration, burst per burst
    API a_ul_buffer_gprs[8];  // (map?) UL burst / UL buffer mapping, burst per burst. (part of header)
    API a_usf_gprs[8];
    API a_interf_meas_gprs[8];

    API a_ptcchu_gprs[4];

    API a_dd_md_gprs[16];

    API a_du_gprs[4][29];
    API a_pu_gprs[4][15];

    API d_rlcmac_rx_no_gprs;

    API a_dd_gprs[8][31];

    API a_ramp_gprs[8][16];

  }
  T_NDB_MCU_DSP_GPRS;

#elif (DSP == 33)
  typedef struct
  {
    // GEA module
    API d_gea_mode;
    API a_gea_kc[4];

    API d_hole1_ndb_gprs[8];
    API d_a5mode_ovly;

    API d_sched_mode_gprs;

    API d_hole2_ndb_gprs[5];

    API d_usf_updated_gprs;
    API d_win_start_gprs;
    API d_usf_vote_enable;
    API d_bbctrl_gprs;

    API d_hole3_ndb_gprs[2];

    // (map?) BTS physical timeslot mapping.
    API a_ctrl_ched_gprs[8];  // (map?) Ched configuration, burst per burst
    API a_ul_buffer_gprs[8];  // (map?) UL burst / UL buffer mapping, burst per burst. (part of header)
    API a_usf_gprs[8];
    API a_interf_meas_gprs[8];

    API a_ptcchu_gprs[4];

    API a_dd_md_gprs[16];

    API a_du_gprs[4][29];
    API a_pu_gprs[4][15];

    API d_rlcmac_rx_no_gprs;

    API a_dd_gprs[8][31];

    API a_ramp_gprs[8][16];

  }
  T_NDB_MCU_DSP_GPRS;

#else

typedef struct
{
  // GPRS Extension...............
  API a_ramp_gprs[8][16];

  #if (CODE_VERSION != SIMULATION)
  API a_hole1_gprs[22];         // hole for a_du_1 and d_a5_mode
  #endif

  API d_ptcchu_ctrl_abb_gprs;
  API d_ptcchu_ctrl_power_gprs;
  API d_ptcchd_burst_nb_gprs;

  #if (CODE_VERSION != SIMULATION)
  API a_hole2_gprs[184];
  #endif

  API d_usf_updated_gprs;
  API d_win_start_gprs;     // (map?) BTS physical timeslot mapping.
  API a_ctrl_ched_gprs[8];  // (map?) Ched configuration, burst per burst
  API a_ul_buffer_gprs[8];  // (map?) UL burst / UL buffer mapping, burst per burst. (part of header)
  API a_usf_gprs[8];
  API a_interf_meas_gprs[8];

  API d_background_enable;
  API d_background_abort;
  API d_background_state;
  API d_max_background;
  API a_background_tasks[16];
  API a_back_task_io[10];

  #if (CODE_VERSION != SIMULATION)
  API a_hole3_gprs[19];
  #endif
  API d_gea_mode;

  API a_gea_kc[4];

  API d_sched_mode_gprs;

  #if (CODE_VERSION != SIMULATION)
  API a_hole4_gprs[384];
  #endif

  API a_du_gprs[4][29];
  API d_rlcmac_rx_no_gprs;
  API a_dd_gprs[4][31];
  API a_pu_gprs[4][15];

  #if (CODE_VERSION != SIMULATION)
  API a_hole5_gprs[112];
  #endif

  API a_ptcchu_gprs[4];
  API a_dd_md_gprs[16];
}
T_NDB_MCU_DSP_GPRS;
#endif

#if (DSP == 34) || (DSP == 35) || (DSP == 36)
  typedef struct
  {
    // GPRS Extension...............
    API_SIGNED d_overlay_rlcmac_cfg_gprs;
    API_SIGNED d_mac_threshold;
    API_SIGNED d_sd_threshold;
    API_SIGNED d_nb_max_iteration;
  }
  T_PARAM_MCU_DSP_GPRS;
#elif (DSP == 33)
  typedef struct
  {
    // GPRS Extension...............
    API_SIGNED d_overlay_rlcmac_cfg_gprs;
    API_SIGNED d_mac_threshold;
    API_SIGNED d_sd_threshold;
    API_SIGNED d_nb_max_iteration;
  }
  T_PARAM_MCU_DSP_GPRS;
#else
  typedef struct
  {
    // GPRS Extension...............
    API_SIGNED d_overlay_rlcmac_cfg_gprs;
    API_SIGNED d_lat_mcu_bridge;
    API_SIGNED d_lat_pll2div;
    API_SIGNED d_lat_mcu_hom2sam;
    API_SIGNED d_gprs_install_address;
    API_SIGNED d_mac_threshold;
    API_SIGNED d_sd_threshold;
    API_SIGNED d_nb_max_iteration;
  }
  T_PARAM_MCU_DSP_GPRS;
#endif

/***************************************************************************************/
/* L1PS -> DSP communication structure...                                              */
/***************************************************************************************/
typedef struct
{
  T_DB_DSP_TO_MCU_GPRS  *pdsp_db_r_ptr;   // MCU<->DSP comm. read  page (Double Buffered comm. memory).
  T_DB_MCU_TO_DSP_GPRS  *pdsp_db_w_ptr;   // MCU<->DSP comm. write page (Double Buffered comm. memory).
  T_NDB_MCU_DSP_GPRS    *pdsp_ndb_ptr;    // MCU<->DSP comm. read/write (Non Double Buffered comm. memory).
  T_PARAM_MCU_DSP_GPRS  *pdsp_param_ptr;  // MCU<->DSP comm. read/write (Param comm. memory).
}
T_L1PS_DSP_COM;

/***************************************************************************************/
/* L1PS -> MAC-S communication structure...                                            */
/***************************************************************************************/

typedef struct
{
  UWORD8  nb;      // Number of error found
  UWORD8  id[10];  // Error ID
}
T_MACS_STATUS;

typedef struct
{
  BOOL            new_set;                 // Set to 1 if allocation parameters have changed, reset by MAC-S
  UWORD8          rx_allocation;           // Downlink resources relative to Layer 1 frames
  UWORD8          tx_nb_allocation;        // Uplink resources used to transmit normal bursts relative to Layer 1 frames
  UWORD8          tx_prach_allocation;     // Uplink resources used to transmit PRACH bursts relative to Layer 1 frames
  UWORD8          pwr_allocation;          // Measurement gap relative to Layer 1 frames
  BOOL            fix_alloc_exhaust_flag;  // Set to 1 if the fixed allocation has just exhausted
  BOOL            rlc_downlink_call;
  T_MACS_STATUS   macs_status;
}
T_L1PS_MACS_COM;