FreeCalypso > hg > fc-tourmaline
view src/cs/layer1/include/l1_proto.h @ 303:f76436d19a7a default tip
!GPRS config: fix long-standing AT+COPS chance hanging bug
There has been a long-standing bug in FreeCalypso going back years:
sometimes in the AT command bring-up sequence of an ACI-only MS,
the AT+COPS command would produce only a power scan followed by
cessation of protocol stack activity (only L1 ADC traces), instead
of the expected network search sequence. This behaviour was seen
in different FC firmware versions going back to Citrine, and seemed
to follow some law of chance, not reliably repeatable.
This bug has been tracked down and found to be specific to !GPRS
configuration, stemming from our TCS2/TCS3 hybrid and reconstruction
of !GPRS support that was bitrotten in TCS3.2/LoCosto version.
ACI module psa_mms.c, needed only for !GPRS, was missing in the TCS3
version and had to be pulled from TCS2 - but as it turns out,
there is a new field in the MMR_REG_REQ primitive that needs to be
set correctly, and that psa_mms.c module is the place where this
initialization needed to be added.
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Thu, 08 Jun 2023 08:23:37 +0000 |
| parents | 4e78acac3d88 |
| children |
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 ((ANLG_FAM == 1) || (ANLG_FAM == 2) || (ANLG_FAM == 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 ((ANLG_FAM == 1) || (ANLG_FAM == 2) || (ANLG_FAM == 3)) UWORD16 Cust_get_pwr_data(UWORD8 txpwr, UWORD16 radio_freq); #endif