FreeCalypso > hg > freecalypso-sw
view gsm-fw/L1/include/l1_proto.h @ 529:f72c9db5e2f5
top level README: status update
author | Michael Spacefalcon <msokolov@ivan.Harhan.ORG> |
---|---|
date | Tue, 15 Jul 2014 22:19:53 +0000 |
parents | ed6071292a5c |
children | 25a7fe25864c |
line wrap: on
line source
/************* Revision Controle System Header ************* * GSM Layer 1 software * L1_PROTO.H * * Filename l1_proto.h * Copyright 2003 (C) Texas Instruments * ************* Revision Controle System Header *************/ /**************************************/ /* prototypes of L1_SYNC.C functions */ /**************************************/ void hisr (void); void frit_task (UWORD32 argc, void *argv); void l1s_task (UWORD32 argc, void *argv); void l1s_synch (void); void l1s_task_scheduler_process (void); void l1s_execute_frame (void); void l1s_meas_manager (void); void l1s_end_manager (void); void l1s_schedule_tasks (WORD32 *pending_task); void l1s_merge_manager (WORD32 dl_pending_task); void l1s_dedicated_mode_manager (void); /**************************************/ /* prototypes of L1_PWMGR.C functions */ /**************************************/ void l1s_sleep_manager (void); void l1s_gauging_task (void); void l1s_gauging_task_end (void); WORD32 l1s_get_next_gauging_in_Packet_Idle(void); void l1s_wakeup (void); void l1s_wakeup_adjust (void); void GAUGING_Handler (void); UWORD8 l1s_recover_Os (void); UWORD8 l1s_check_System (void); void l1s_recover_Frame (void); void l1s_recover_HWTimers (void); BOOL l1s_compute_wakeup_ticks (void); /**************************************/ /* prototypes of L1_MFMGR.C functions */ /**************************************/ void l1s_clear_mftab (T_FRM *frmlst); void l1s_exec_mftab (void); void l1s_load_mftab (const T_FCT *fct, const UWORD8 size, UWORD8 frame, T_FRM *frmlst); /**************************************/ /* prototypes of L1_CMPLX.C functions */ /**************************************/ void l1s_new_synchro (UWORD8 param1, UWORD8 param2); void l1s_abort (UWORD8 param1, UWORD8 param2); void l1s_ctrl_ADC (UWORD8 param1, UWORD8 param2); void l1s_ctrl_msagc (UWORD8 task, UWORD8 param2); void l1s_ctrl_fb (UWORD8 param1, UWORD8 param2); void l1s_ctrl_fb26 (UWORD8 task, UWORD8 param2); void l1s_ctrl_sbgen (UWORD8 task, UWORD8 attempt); void l1s_ctrl_sb26 (UWORD8 task, UWORD8 param2); void l1s_ctrl_smscb (UWORD8 task, UWORD8 burst_id); void l1s_ctrl_snb_dl (UWORD8 task, UWORD8 param2); void l1s_ctrl_snb_ul (UWORD8 task, UWORD8 param2); void l1s_ctrl_nnb (UWORD8 task, UWORD8 param2); void l1s_ctrl_rach (UWORD8 task, UWORD8 param2); void l1s_ctrl_tchtf (UWORD8 task, UWORD8 param2); void l1s_ctrl_tchth (UWORD8 task, UWORD8 param2); void l1s_ctrl_tchtd (UWORD8 task, UWORD8 param2); void l1s_ctrl_tcha (UWORD8 task, UWORD8 param2); void l1s_hopping_algo (UWORD8 param1, UWORD8 param2); void l1s_ctrl_hwtest (UWORD8 task, UWORD8 param2); void l1s_read_hwtest (UWORD8 task, UWORD8 param2); void l1s_read_dummy (UWORD8 task, UWORD8 param2); void l1s_read_msagc (UWORD8 task, UWORD8 param2); void l1s_read_mon_result (UWORD8 task, UWORD8 param2); void l1s_read_rx_result (UWORD8 param1, UWORD8 attempt_for_sb2); void l1s_read_snb_dl (UWORD8 task, UWORD8 burst_id); void l1s_read_nnb (UWORD8 task, UWORD8 param); void l1s_read_dedic_dl (UWORD8 task, UWORD8 burst_id); void l1s_read_tx_result (UWORD8 param1, UWORD8 param2); void l1s_read_dedic_scell_meas (UWORD8 meas, UWORD8 sub_flag); void l1s_dedic_reporting (void); void l1s_read_fb (UWORD8 task, UWORD32 fb_flag, UWORD32 toa, UWORD32 attempt, UWORD32 pm, UWORD32 angle, UWORD32 snr); void l1s_read_sb (UWORD8 task,UWORD32 flag, API *data, UWORD32 toa, UWORD8 attempt, UWORD32 pm, UWORD32 angle, UWORD32 snr); void l1s_read_sacch_dl (API *info_address, UWORD32 task_rx); void l1s_read_dcch_dl (API *info_address, UWORD32 task_rx); void l1s_read_l3frm (UWORD8 pwr_level, API *info_address, UWORD32 task_rx); /**************************************/ /* prototypes of L1_AFUNC functions */ /**************************************/ void l1a_reset_full_list (void); void l1a_reset_ba_list (void); void l1a_add_time_for_nb (UWORD32 *time_alignmt, UWORD32 *fn_offset); void l1a_add_timeslot (UWORD32 *time_alignmt, UWORD32 *fn_offset, UWORD8 tn); void l1a_sub_time_for_nb (UWORD32 *time_alignmt, UWORD32 *fn_offset); void l1a_sub_timeslot (UWORD32 *time_alignmt, UWORD32 *fn_offset, UWORD8 tn); T_DEDIC_SET *l1a_get_free_dedic_set (void); void l1a_fill_bef_sti_param (T_DEDIC_SET *set_ptr, BOOL start_time_present); WORD32 l1a_decode_starting_time (T_STARTING_TIME coded_starting_time); void l1a_reset_cell_info (T_CELL_INFO *cell_info); void l1a_send_confirmation (UWORD32 SignalCode,UWORD8 queue_type); void l1a_send_result (UWORD32 SignalCode, xSignalHeaderRec *msg, UWORD8 queue); UWORD8 l1a_encode_rxqual (UWORD32 inlevel); void l1a_report_failling_ncell_sync (UWORD32 SignalCode, UWORD8 neigh_id); UWORD8 l1a_clip_txpwr (UWORD8 supplied_txpwr, UWORD16 radio_freq); void l1a_correct_timing (UWORD8 neigh_id,UWORD32 time_alignmt,UWORD32 fn_offset); void l1a_add_time_delta (UWORD32 *time_alignmt, UWORD32 *fn_offset, WORD32 delta); void l1a_compensate_sync_ind (T_MPHC_NCELL_SYNC_IND * msg); void l1a_compute_Eotd_data (UWORD8 *first_scell, UWORD8 neigh_id, UWORD32 SignalCode, xSignalHeaderRec *msg); #if (L1_MPHC_RXLEV_IND_REPORT_SORT==1) void l1a_sort_freq_reported_in_rxlev_ind(T_POWER_ARRAY *data_tab,UWORD16 data_tab_size,UWORD16 *index_tab,UWORD16 index_tab_size); #endif /**************************************/ /* prototypes of L1_FUNC functions */ /**************************************/ void dsp_power_on (void); #if ((ANALOG == 1) || (ANALOG == 2) || (ANALOG == 3)) void l1_abb_power_on (void); #endif void tpu_init (void); void l1s_reset_db_mcu_to_dsp (T_DB_MCU_TO_DSP *page_ptr); void l1s_reset_db_dsp_to_mcu (T_DB_DSP_TO_MCU *page_ptr); void initialize_l1var (void); void l1_initialize (T_MMI_L1_CONFIG *mmi_l1_config); void l1_pwr_mgt_init (void); void l1_dpll_init_var (void); void l1s_increment_time (T_TIME_INFO *time, UWORD32 fn_offset); WORD16 l1s_encode_rxlev (UWORD8 inlevel); void l1s_send_ho_finished (UWORD8 cause); void l1s_reset_dedic_serving_meas(void); UWORD32 l1s_swap_iq_dl (UWORD16 radio_freq, UWORD8 task); UWORD32 l1s_swap_iq_ul (UWORD16 radio_freq, UWORD8 task); UWORD8 l1s_ADC_decision_on_NP (void); #if (AMR == 1) UWORD8 l1s_amr_get_ratscch_type (API *a_ratscch_dl); void l1s_amr_update_from_ratscch (API *a_ratscch_dl); #endif /**************************************/ /* prototypes of L1_DRIVE functions */ /**************************************/ // MCU-DSP interface drivers. //--------------------------- void l1ddsp_load_info (UWORD32 task, API *info_ptr, UWORD8 *data); void l1ddsp_load_monit_task (API monit_task, API fb_mode); void l1ddsp_load_afc (API afc); void l1ddsp_load_rx_task (API rx_task, UWORD8 burst_id, UWORD8 tsq); void l1ddsp_load_tx_task (API tx_task, UWORD8 burst_id, UWORD8 tsq); void l1ddsp_load_ra_task (API ra_task); void l1ddsp_load_txpwr (UWORD8 txpwr, UWORD16 radio_freq); #if (AMR == 1) #if (FF_L1_TCH_VOCODER_CONTROL == 1) // Add the AMR synchro bit in the driver's paramters void l1ddsp_load_tch_param (T_TIME_INFO *next_time, UWORD8 chan_mode, UWORD8 chan_type, UWORD8 subchannel, UWORD8 tch_loop, UWORD8 sync_tch, UWORD8 sync_amr, UWORD8 reset_sacch, UWORD8 vocoder_on); #else void l1ddsp_load_tch_param (T_TIME_INFO *next_time, UWORD8 chan_mode, UWORD8 chan_type, UWORD8 subchannel, UWORD8 tch_loop, UWORD8 sync_tch, UWORD8 sync_amr); #endif #else #if (FF_L1_TCH_VOCODER_CONTROL == 1) void l1ddsp_load_tch_param (T_TIME_INFO *next_time, UWORD8 chan_mode, UWORD8 chan_type, UWORD8 subchannel, UWORD8 tch_loop, UWORD8 sync_tch, UWORD8 reset_sacch, UWORD8 vocoder_on); #else void l1ddsp_load_tch_param (T_TIME_INFO *next_time, UWORD8 chan_mode, UWORD8 chan_type, UWORD8 subchannel, UWORD8 tch_loop, UWORD8 sync_tch); #endif #endif BOOL enable_tch_vocoder (BOOL vocoder_on); BOOL l1_select_mcsi_port (UWORD8 port); void l1ddsp_load_ciph_param (UWORD8 a5mode, T_ENCRYPTION_KEY *ciph_key); void l1ddsp_load_tch_mode (UWORD8 dai_mode, BOOL dtx_allowed); #if (AMR == 1) void l1ddsp_load_amr_param (T_AMR_CONFIGURATION amr_param, UWORD8 cmip); #endif void l1ddsp_stop_tch (void); // MCU-TPU interface drivers. //--------------------------- void l1dtpu_meas (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off, UWORD16 win_id, UWORD16 tpu_synchro, UWORD8 adc_active); void l1dtpu_neig_fb (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off); void l1dtpu_neig_fb26 (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off, UWORD32 offset_serv); void l1dtpu_neig_sb (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off, UWORD32 time_alignmt, UWORD32 offset_serv, UWORD8 reload_flag, UWORD8 attempt); void l1dtpu_neig_sb26 (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off, UWORD32 time_alignmt, UWORD32 fn_offset, UWORD32 offset_serv); void l1dtpu_serv_rx_nb (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off, UWORD32 synchro_serv, UWORD32 new_offset, BOOL change_offset, UWORD8 adc_active); void l1dtpu_serv_tx_nb (UWORD16 radio_freq, UWORD8 timing_advance, UWORD32 offset_serv, UWORD8 txpwr, UWORD8 adc_active); void l1dtpu_neig_rx_nb (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off, UWORD32 time_alignmt, UWORD32 offset_serv, UWORD8 reload_flag, UWORD8 nop); void l1dtpu_serv_tx_ra (UWORD16 radio_freq, UWORD32 offset_serv, UWORD8 txpwr, UWORD8 adc_active); // MCU-DSP interface drivers for POWER-ON. //---------------------------------------- void l1dtpu_init_dpram (UWORD8 process); // MCU-DSP interface drivers for RESET. //------------------------------------- void l1ddsp_end_scenario (UWORD8 type); void l1dtpu_end_scenario (void); void l1d_reset_hw (UWORD32 offset_value); /**************************************/ /* Prototypes for L1 ASYNCH task */ /**************************************/ void l1a_task (UWORD32 argc, void *argv); void l1a_balance_l1a_tasks (void); void l1a_mmi_adc_req (xSignalHeaderRec *msg); void l1a_network_lost (xSignalHeaderRec *msg); void l1a_idle_6strongest_monitoring_process (xSignalHeaderRec *msg); void l1a_idle_serving_cell_bcch_reading_process (xSignalHeaderRec *msg); void l1a_idle_serving_cell_paging_process (xSignalHeaderRec *msg); void l1a_idle_smscb_process (xSignalHeaderRec *msg); void l1a_initial_network_sync_process (xSignalHeaderRec *msg); void l1a_cres_process (xSignalHeaderRec *msg); void l1a_dedic_ba_list_meas_process (xSignalHeaderRec *msg); void l1a_full_list_meas_process (xSignalHeaderRec *msg); void l1a_csel_bcch_process (xSignalHeaderRec *msg); void l1a_idle_serv_meas_process (xSignalHeaderRec *msg); void l1a_idle_neigh_meas_process (xSignalHeaderRec *msg); void l1a_idle_neigh_full_bcch_process(xSignalHeaderRec *msg); void l1a_idle_neigh_norm_bcch_process(xSignalHeaderRec *msg); void l1a_idle_neigh_ext_bcch_process (xSignalHeaderRec *msg); void l1a_idle_6conf_process (xSignalHeaderRec *msg); void l1a_idle_smscb_process (xSignalHeaderRec *msg); void l1a_access_process (xSignalHeaderRec *msg); void l1a_dedicated_process (xSignalHeaderRec *msg); void l1a_dedic_bcch_process (xSignalHeaderRec *msg); void l1a_dedic6_process (xSignalHeaderRec *msg); void l1a_dedic_neigh_meas_process (xSignalHeaderRec *msg); void l1a_idle_ba_list_meas_process (xSignalHeaderRec *msg); void l1a_idle_full_list_meas_process (xSignalHeaderRec *msg); void l1a_test_process (xSignalHeaderRec *msg); void l1a_freq_band_configuration (xSignalHeaderRec *msg); #if (OP_L1_STANDALONE == 1) // Dynamic configuration process for L1 standalone only void l1a_test_config_process (xSignalHeaderRec *msg); #endif // ...................NEW FOR ALR.................... void l1a_neighbour_cell_bcch_reading_process (xSignalHeaderRec *msg); // ...................NEW FOR ALR.................... /**************************************/ /* Prototypes for l3 task */ /**************************************/ void l3_task (UWORD32 argc, void *argv); void l3_expire_fct (UWORD32 id); #if TESTMODE void mmi_task (UWORD32 argc, void *argv); #endif /**************************************/ /* Prototypes for Nu_main. */ /**************************************/ UWORD32 get_arm_version (void); void usart_hisr (void); void Adc_timer (UWORD32 id); /**************************************/ /* Prototypes for l2 task */ /**************************************/ T_RADIO_FRAME *dll_read_dcch (UWORD8 chn_mode); T_RADIO_FRAME *dll_read_sacch (UWORD8 chn_mode); void l2_task (UWORD32 argc, void *argv); #if (DSP_BACKGROUND_TASKS == 1) // Task for backgrounds DSP testing void background_task(UWORD32 argc, void *argv); #endif void rx_tch_data (API *data_address, UWORD8 channel_mode, UWORD8 blk_seq_number); UWORD8 *tx_tch_data (void); #if (SEND_FN_TO_L2_IN_DCCH==1) void dll_dcch_downlink (API *info_address, UWORD8 valid_flag, UWORD32 frame_number); #else void dll_dcch_downlink (API *info_address, UWORD8 valid_flag); #endif /***************************************/ /* Prototypes of L1_TRACE.c functions */ /***************************************/ void l1_trace_message (xSignalHeaderRec *msg); void send_debug_sig (UWORD8 debug_code, UWORD8 task); void l1_trace_cpu_load (UWORD8 cpu_load); void l1_trace_ratscch(UWORD16 fn, UWORD16 amr_change_bitmap); #if (TRACE_TYPE==7) // CPU_LOAD void l1_cpu_load_start (void); void l1_cpu_load_stop (void); void l1_cpu_load_init (void); void l1_cpu_load_interm (void); #endif /***************************************/ /* Prototypes of HW_DEBUG.c functions */ /***************************************/ void get_usart_characters (void); // HISR for Rx characters void wait_for_next_message (CHAR *); /***************************************/ /* Prototypes of L1_DEBUG.c functions */ /***************************************/ void scenario_and_log_files (void); void decode_msg (xSignalHeaderRec *msg, CHAR *filename); void trace_mft (CHAR *fct_name, WORD32 frame); #if (L1_EOTD ==1) void trace_EOTD_serving (UWORD16 arfcn, UWORD32 timetag, CHAR *text); void trace_EOTD_serving1 (CHAR *text); void trace_EOTD_neighbour (UWORD8 nbr, UWORD16 arfcn, UWORD32 delta_fn, WORD32 delta_qbit, UWORD32 timetag, CHAR *text); #endif void trace_ULPD (CHAR *text, UWORD32 frame_number); void log_fct (CHAR *fct_name, UWORD32 radio_freq); void trace_msg (CHAR *msg_name, CHAR *queue_name); void log_msg (CHAR *msg_name, CHAR *queue_name); void trace_dedic (void); void trace_fct_simu (CHAR *fct_name, WORD32 radio_freq); void trace_flowchart_msg (CHAR *msg_name, CHAR *dest_queue_name); void trace_flowchart_l1tsk (UWORD32 bit_register, UWORD32 *src_register_set); void trace_flowchart_dedic (WORD32 SignalCode); void trace_flowchart_tpu (CHAR *task_name); void trace_flowchart_dsp (CHAR *task_name); void trace_flowchart_dsp_tpu (CHAR *task_name); void trace_flowchart_dspres (CHAR *task_name); void trace_flowchart_dsptx (CHAR *task_name); void trace_flowchart_header (void); void trace_sim_freq_band_configuration (UWORD8 freq_band_config); /**************************************/ /* prototypes of control functions */ /**************************************/ #if (VCXO_ALGO == 0) WORD16 l1ctl_afc (UWORD8 phase, UWORD32 *frame_count, WORD16 angle, WORD32 snr, UWORD16 radio_freq); #else WORD16 l1ctl_afc (UWORD8 phase, UWORD32 *frame_count, WORD16 angle, WORD32 snr, UWORD16 radio_freq, UWORD32 l1_mode); #endif WORD16 l1ctl_toa (UWORD8 phase, UWORD32 l1_mode, UWORD16 SNR_val, UWORD16 TOA_val, BOOL *toa_update, UWORD16 *toa_period_count); UWORD8 l1ctl_txpwr (UWORD8 target_txpwr, UWORD8 current_txpwr); // Utility for agc control algorithms void l1ctl_encode_lna (UWORD8 input_level, UWORD8 * lna_state, UWORD16 radio_freq); UWORD8 l1ctl_find_max (UWORD8 *buff, UWORD8 buffer_len); // Automatic Gain Control Algorithms void l1ctl_pgc2 (UWORD8 pm_high_agc, UWORD8 pm_low_agc, UWORD16 radio_freq); UWORD8 l1ctl_csgc (UWORD8 pm, UWORD16 radio_freq); UWORD8 l1ctl_pgc (UWORD8 pm, UWORD8 used_IL, UWORD8 lna_off, UWORD16 radio_freq); UWORD8 l1ctl_pagc (UWORD8 pm, UWORD16 radio_freq, T_INPUT_LEVEL *traffic_meas_ptr); UWORD8 l1ctl_dpagc (BOOL dtx_on, BOOL beacon, UWORD8 pm, UWORD16 radio_freq, T_INPUT_LEVEL *traffic_meas_ptr); #if (AMR == 1) UWORD8 l1ctl_dpagc_amr (BOOL dtx_on, BOOL beacon, UWORD8 pm, UWORD16 radio_freq, T_INPUT_LEVEL *traffic_meas_ptr); #endif UWORD16 l1ctl_get_g_magic (UWORD16 radio_freq); UWORD16 l1ctl_get_lna_att (UWORD16 radio_freq); void l1ctl_update_TPU_with_toa(void); //functions for customization void Cust_init_std (void); void Cust_init_params (void); WORD8 Cust_get_agc_from_IL (UWORD16 radio_freq, UWORD16 agc_index, UWORD8 table_id); WORD8 l1ctl_encode_delta1 (UWORD16 radio_freq); WORD8 l1ctl_encode_delta2 (UWORD16 radio_freq); void Cust_get_ramp_tab (API *a_ramp, UWORD8 txpwr_ramp_up, UWORD8 txpwr_ramp_down, UWORD16 radio_freq); #if ((ANALOG == 1) || (ANALOG == 2) || (ANALOG == 3)) UWORD16 Cust_get_pwr_data(UWORD8 txpwr, UWORD16 radio_freq); #endif