FreeCalypso > hg > freecalypso-sw
diff gsm-fw/L1/include/l1_proto.h @ 530:25a7fe25864c
gsm-fw/L1/include: switch to LoCosto versions of all header files
| author | Michael Spacefalcon <msokolov@ivan.Harhan.ORG> |
|---|---|
| date | Fri, 01 Aug 2014 16:38:35 +0000 |
| parents | ed6071292a5c |
| children | de635895e0be |
line wrap: on
line diff
--- a/gsm-fw/L1/include/l1_proto.h Tue Jul 15 22:19:53 2014 +0000 +++ b/gsm-fw/L1/include/l1_proto.h Fri Aug 01 16:38:35 2014 +0000 @@ -14,6 +14,9 @@ void frit_task (UWORD32 argc, void *argv); void l1s_task (UWORD32 argc, void *argv); +#if FF_L1_IT_DSP_USF +void usf_task (UWORD32 argc, void *argv); +#endif void l1s_synch (void); void l1s_task_scheduler_process (void); @@ -24,22 +27,24 @@ void l1s_merge_manager (WORD32 dl_pending_task); void l1s_dedicated_mode_manager (void); +void l1s_keep_mftab_hist (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); +void l1s_sleep_manager (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); +void l1s_gauging_task (void); +void l1s_gauging_task_end (void); +UWORD32 l1s_get_next_gauging_in_Packet_Idle(void); +void l1s_adapt_traffic_controller (void); /**************************************/ /* prototypes of L1_MFMGR.C functions */ @@ -63,7 +68,9 @@ void l1s_ctrl_fb26 (UWORD8 task, UWORD8 param2); void l1s_ctrl_sbgen (UWORD8 task, UWORD8 attempt); void l1s_ctrl_sb26 (UWORD8 task, UWORD8 param2); - +#if ((REL99 == 1) && (FF_BHO == 1)) +void l1s_ctrl_fbsb (UWORD8 task , UWORD8 param2); +#endif void l1s_ctrl_smscb (UWORD8 task, UWORD8 burst_id); void l1s_ctrl_snb_dl (UWORD8 task, UWORD8 param2); @@ -91,16 +98,28 @@ void l1s_read_dedic_dl (UWORD8 task, UWORD8 burst_id); void l1s_read_tx_result (UWORD8 param1, UWORD8 param2); + +#if REL99 +#if FF_EMR + void l1s_read_dedic_scell_meas (UWORD8 meas, UWORD8 sub_flag, T_EMR_PARAMS *emr_params); +#endif +#else //REL99 void l1s_read_dedic_scell_meas (UWORD8 meas, UWORD8 sub_flag); +#endif //REL99 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); +#if ((REL99 == 1) && (FF_BHO == 1)) +void l1s_read_fbsb (UWORD8 task, UWORD8 attempt, BOOL fb_flag, BOOL sb_flag, API *data, + UWORD32 toa, UWORD32 pm, UWORD32 angle, UWORD32 snr); +#endif 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); +void l1s_reset_tx_ptr(UWORD8 param1, UWORD8 param2); /**************************************/ @@ -122,24 +141,24 @@ 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 +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); +void l1a_correct_timing (UWORD8 neigh_id,UWORD32 time_alignmt,UWORD32 fn_offset); /**************************************/ /* prototypes of L1_FUNC functions */ /**************************************/ void dsp_power_on (void); -#if ((ANALOG == 1) || (ANALOG == 2) || (ANALOG == 3)) +#if ((ANLG_FAM == 1) || (ANLG_FAM == 2) || (ANLG_FAM == 3) || (ANLG_FAM == 11)) 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); +#if (DSP == 38) || (DSP == 39) +void l1s_reset_db_common_mcu_to_dsp (T_DB_COMMON_MCU_TO_DSP *page_ptr); +#endif 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); @@ -157,6 +176,7 @@ UWORD8 l1s_amr_get_ratscch_type (API *a_ratscch_dl); void l1s_amr_update_from_ratscch (API *a_ratscch_dl); #endif +void l1_memcpy_16bit(void *dst,void* src,unsigned int len); /**************************************/ @@ -164,6 +184,10 @@ /**************************************/ // MCU-DSP interface drivers. //--------------------------- + +#if (FF_L1_FAST_DECODING == 1) +void l1ddsp_load_fast_dec_task(API task, UWORD8 burst_id); +#endif void l1ddsp_load_info (UWORD32 task, API *info_ptr, UWORD8 *data); @@ -181,6 +205,21 @@ void l1ddsp_load_txpwr (UWORD8 txpwr, UWORD16 radio_freq); + +// SAIC low level driver function +#if (L1_SAIC != 0) +void l1ddsp_load_swh_flag (UWORD16 SWH_flag, UWORD16 SAIC_flag); +#endif + +void l1ddsp_read_iq_dump(UWORD8 task); +void l1ddsp_apc_load_apcctrl2(UWORD16 apcctrl2); +void l1ddsp_apc_set_manual_mode(void); +void l1ddsp_apc_set_automatic_mode(void); + +#ifdef TESTMODE + void l1ddsp_apc_load_apclev(UWORD16 apclev); +#endif + #if (AMR == 1) #if (FF_L1_TCH_VOCODER_CONTROL == 1) // Add the AMR synchro bit in the driver's paramters @@ -192,15 +231,25 @@ UWORD8 sync_tch, UWORD8 sync_amr, UWORD8 reset_sacch, + #if !FF_L1_IT_DSP_DTX UWORD8 vocoder_on); #else + UWORD8 vocoder_on, + BOOL dtx_dsp_interrupt); + #endif + #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, + #if !FF_L1_IT_DSP_DTX UWORD8 sync_amr); + #else + UWORD8 sync_amr, + BOOL dtx_dsp_interrupt); + #endif #endif #else #if (FF_L1_TCH_VOCODER_CONTROL == 1) @@ -211,31 +260,41 @@ UWORD8 tch_loop, UWORD8 sync_tch, UWORD8 reset_sacch, + #if !FF_L1_IT_DSP_DTX UWORD8 vocoder_on); #else + UWORD8 vocoder_on, + BOOL dtx_dsp_interrupt); + #endif + #else void l1ddsp_load_tch_param (T_TIME_INFO *next_time, UWORD8 chan_mode, UWORD8 chan_type, UWORD8 subchannel, UWORD8 tch_loop, + #if !FF_L1_IT_DSP_DTX UWORD8 sync_tch); + #else + UWORD8 sync_tch, + BOOL dtx_dsp_interrupt); + #endif #endif #endif -BOOL enable_tch_vocoder (BOOL vocoder_on); - +#if (L1_VOCODER_IF_CHANGE == 0) +BOOL enable_tch_vocoder (BOOL vocoder_on); +#endif // L1_VOCODER_IF_CHANGE == 0 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); +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); + void l1ddsp_load_amr_param (T_AMR_CONFIGURATION amr_param, UWORD8 cmip); #endif - -void l1ddsp_stop_tch (void); - +void l1ddsp_stop_tch (void); +void l1ddsp_load_afc (API afc); // MCU-TPU interface drivers. //--------------------------- @@ -244,7 +303,12 @@ UWORD8 lna_off, UWORD16 win_id, UWORD16 tpu_synchro, - UWORD8 adc_active); + UWORD8 adc_active +#if(RF_FAM == 61) + ,UWORD8 afc_mode + ,UWORD8 if_ctl +#endif + ); void l1dtpu_neig_fb (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off); @@ -258,20 +322,36 @@ UWORD32 time_alignmt, UWORD32 offset_serv, UWORD8 reload_flag, - UWORD8 attempt); + UWORD8 attempt +#if(RF_FAM == 61) + ,UWORD8 if_ctl +#endif + ); void l1dtpu_neig_sb26 (UWORD16 radio_freq, WORD8 agc, UWORD8 lna_off, UWORD32 time_alignmt, UWORD32 fn_offset, - UWORD32 offset_serv); + UWORD32 offset_serv +#if(RF_FAM == 61) + ,UWORD8 if_ctl +#endif + ); 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); + UWORD8 adc_active +#if(RF_FAM == 61) + ,UWORD8 csf_filter_choice + ,UWORD8 if_ctl +#endif +#if (NEW_SNR_THRESHOLD == 1) + ,UWORD8 saic_flag +#endif /* NEW_SNR_THRESHOLD*/ + ); void l1dtpu_serv_tx_nb (UWORD16 radio_freq, UWORD8 timing_advance, UWORD32 offset_serv, @@ -283,7 +363,15 @@ UWORD32 time_alignmt, UWORD32 offset_serv, UWORD8 reload_flag, - UWORD8 nop); + UWORD8 nop +#if(RF_FAM == 61) + ,UWORD8 if_ctl +#endif +#if (NEW_SNR_THRESHOLD == 1) + ,UWORD8 saic_flag +#endif /* NEW_SNR_THRESHOLD*/ + ); + void l1dtpu_serv_tx_ra (UWORD16 radio_freq, UWORD32 offset_serv, UWORD8 txpwr, @@ -341,7 +429,11 @@ void l1a_idle_full_list_meas_process (xSignalHeaderRec *msg); void l1a_test_process (xSignalHeaderRec *msg); void l1a_freq_band_configuration (xSignalHeaderRec *msg); +void l1a_at_power_process (xSignalHeaderRec *msg); +#if(L1_CHECK_COMPATIBLE == 1) +void l1a_checkmsg_compatibility (xSignalHeaderRec *msg); +#endif #if (OP_L1_STANDALONE == 1) // Dynamic configuration process for L1 standalone only void l1a_test_config_process (xSignalHeaderRec *msg); @@ -368,9 +460,8 @@ /**************************************/ /* Prototypes for Nu_main. */ /**************************************/ -UWORD32 get_arm_version (void); -void usart_hisr (void); void Adc_timer (UWORD32 id); + /**************************************/ /* Prototypes for l2 task */ /**************************************/ @@ -389,13 +480,26 @@ UWORD8 *tx_tch_data (void); #if (SEND_FN_TO_L2_IN_DCCH==1) +#if (L1_SAGEM_INTERFACE == 1) +void dll_dcch_downlink (API *info_address, + UWORD8 valid_flag, + UWORD32 frame_number, + UWORD8 channel_type); +#else void dll_dcch_downlink (API *info_address, UWORD8 valid_flag, UWORD32 frame_number); +#endif +#else +#if (L1_SAGEM_INTERFACE == 1) +void dll_dcch_downlink (API *info_address, + UWORD8 valid_flag, + UWORD8 channel_type); #else void dll_dcch_downlink (API *info_address, UWORD8 valid_flag); #endif +#endif /***************************************/ /* Prototypes of L1_TRACE.c functions */ @@ -403,7 +507,6 @@ 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); @@ -415,7 +518,6 @@ /***************************************/ /* Prototypes of HW_DEBUG.c functions */ /***************************************/ -void get_usart_characters (void); // HISR for Rx characters void wait_for_next_message (CHAR *); /***************************************/ @@ -435,7 +537,7 @@ 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_fct_simu (CHAR *fct_name, UWORD32 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); @@ -446,6 +548,14 @@ void trace_flowchart_dsptx (CHAR *task_name); void trace_flowchart_header (void); void trace_sim_freq_band_configuration (UWORD8 freq_band_config); +#if (TOA_ALGO == 2) + void trace_toa_sim_ctrl (UWORD16 SNR_val, UWORD16 TOA_val, UWORD32 l1_mode, + UWORD32 frames_counter, UWORD32 cumul_counter,WORD16 cumul); + void trace_toa_sim_update (WORD16 toa_shift, UWORD32 tpu_offset); +#endif +#if (L1_SAIC != 0) + void trace_saic_sim (UWORD32 Il_for_rxlev, UWORD32 l1_mode, UWORD32 SWH_flag); +#endif /**************************************/ /* prototypes of control functions */ @@ -464,12 +574,36 @@ UWORD16 radio_freq, UWORD32 l1_mode); #endif + +#if (TOA_ALGO == 2) +WORD16 l1ctl_toa (UWORD8 phase, + UWORD32 l1_mode, + UWORD16 SNR_val, + UWORD16 TOA_val); +#else WORD16 l1ctl_toa (UWORD8 phase, UWORD32 l1_mode, UWORD16 SNR_val, UWORD16 TOA_val, BOOL *toa_update, - UWORD16 *toa_period_count); + UWORD16 *toa_period_count +#if (FF_L1_FAST_DECODING == 1) + ,UWORD8 skipped_values +#endif /* FF_L1_FAST_DECODING */ + ); +#endif + +// SAIC Control Function +#if (L1_SAIC != 0) +UWORD8 l1ctl_saic (UWORD8 IL_for_rxlev, + UWORD32 l1_mode +#if (NEW_SNR_THRESHOLD == 1) + ,UWORD8 task, + UWORD8 * saic_flag +#endif /* NEW_SNR_THRESHOLD*/ +); +#endif + UWORD8 l1ctl_txpwr (UWORD8 target_txpwr, UWORD8 current_txpwr); @@ -480,6 +614,7 @@ 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, @@ -508,18 +643,62 @@ UWORD16 l1ctl_get_g_magic (UWORD16 radio_freq); UWORD16 l1ctl_get_lna_att (UWORD16 radio_freq); -void l1ctl_update_TPU_with_toa(void); +UWORD16 l1ctl_update_TPU_with_toa(void); + +#if (FF_L1_FAST_DECODING == 1) +void l1ctl_pagc_missing_bursts (UWORD8 skipped_values); +#endif //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 Cust_get_agc_from_IL (UWORD16 radio_freq, UWORD16 agc_index, UWORD8 table_id,UWORD8 lna_off_val); 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); +#if ((ANLG_FAM == 1) || (ANLG_FAM == 2) || (ANLG_FAM == 3) || (RF_FAM == 61)) + UWORD16 Cust_get_pwr_data(UWORD8 txpwr, UWORD16 radio_freq + #if(REL99 && FF_PRF) + ,UWORD8 number_uplink_timeslot + #endif + ); +#endif + +#if (RF_FAM == 61) +void l1_drp_wrapper_init (void); +void l1_drp_init (void); +void l1dapc_init_ramp_tables(void ); +void cust_get_if_dco_ctl_algo (UWORD16* dco_algo_ctl, UWORD8* if_ctl, + UWORD8 input_level_flag, UWORD8 input_level, UWORD16 radio_freq, UWORD8 if_threshold); #endif +void l1s_restore_synchro(void); + +#if (FF_L1_FAST_DECODING == 1) +BOOL l1s_check_deferred_control(UWORD8 task, UWORD8 burst_id); +BOOL l1s_check_fast_decoding_authorized(UWORD8 task); +#endif /* FF_L1_FAST_DECODING */ + +#if (DRP_FW_EXT == 1) +void l1_get_boot_result_and_version(T_L1_BOOT_VERSION_CODE * p_version); +#endif /* DRP_FW_EXT */ + +/*-----------------------------------------------------------------*/ +/* Prototypes of MULTIBAND related functions */ +/*-----------------------------------------------------------------*/ +#if (L1_FF_MULTIBAND == 1) +#if 0 +UWORD16 l1_multiband_radio_freq_convert_into_operative_radio_freq(UWORD16 radio_freq); +UWORD8 l1_multiband_radio_freq_convert_into_physical_band_id(UWORD16 radio_freq); +UWORD8 l1_multiband_radio_freq_convert_into_effective_band_id(UWORD16 radio_freq); +void l1_multiband_fill_power_meas_array(UWORD16 power_array_size, T_FULL_LIST_MEAS *full_list); +UWORD8 l1_multiband_map_radio_freq_into_tpu_table(UWORD16 radio_freq); +void l1_multiband_increment_effective_band_id(UWORD8 *effective_band_id); +void l1_multiband_trace_params(UWORD8 multiband_table_id, UWORD8 multiband_trace_id) ; +void l1_multiband_tpu_get_power_classes(T_L1_MULTIBAND_POWER_CLASS multiband_power_class[]); +void l1_multiband_error_handler(UWORD16 radio_freq); +#endif // if 0 + +#endif /*if(L1_FF_MULTIBAND == 1)*/