view src/cs/layer1/hmacs/macs_def.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 Control System Header *************
 *                  GSM Layer 1 software
 * MACS_DEF.H
 *
 *        Filename macs_def.h
 *  Copyright 2003 (C) Texas Instruments  
 *
 ************* Revision Control System Header *************/

 /*********************************************************/
 /* Type definition for MAC-S static variables            */
 /*********************************************************/

/*---------------------------------------------------*/
/* MAC-S static parameters                           */
/*---------------------------------------------------*/

typedef struct {

/* General TBF parameters processed by MAC-S */
/*********************************************/
    UWORD8                old_synchro_ts;        // Synchro timeslot when data was received on the slots indicated in last_rx_allocation

// Dynamic allocation mode parameters
    UWORD8                first_monitored_ts;    // First Tx slot allocated by the network
    UWORD8                last_monitored_ts;     // Last Tx slot allocated by the network

// Fixed allocation mode parameters
    UWORD8                dl_ctrl_ts_mask;       // Mask used to verify if conditions are met to map the downlink control timeslot
    UWORD32               sti_block_id;          // Block ID of the starting time

/* Ressources allocated by MAC-S             */
/*********************************************/
    UWORD8                rx_allocation;         // Slots allocated for downlink blocks reception
    UWORD8                tx_allocation;         // Slots allocated for uplink blocks transmission
    UWORD8                tx_data;               // Slots allocated for uplink data block transfer only
    UWORD8                tx_prach_allocation;   // Slots allocated for poll response in PRACH burst format
    UWORD8                pwr_allocation;        // Slots allocated for power measurements
    UWORD8                last_rx_alloc;         // Downlink resources allocated during the last block period

/* MAC-S global parameters */
/***************************/
    UWORD32               rx_blk_period;         // Set to BLOCK_ID if DL blocks were received, FFFFFFFF if no DL blocks
    UWORD8                rlc_blocks_sent;       // Last sent uplink RLC/MAC block ID
    UWORD8                rx_no;                 // Number of received blocks to report to RLC
    UWORD8                last_poll_response;    // Status of the poll responses requested by RLC the block period before
    UWORD8                ul_buffer_index[8];    // UL buffer index table loaded after RLC UL allocation check   

// Dynamic allocation mode parameters     
    UWORD8                usf_vote_enable;       // This bitmap is used to set on which timeslot the DSP USF vote must be enabled
    UWORD8                usf_good;              // Bit set to 1 corresponds to invalid or valid and good USF values
    UWORD32               next_usf_mon_block[2]; // For each uplink block, memorize the next block_id when the USF will be monitored
                                                 // Note: for type 1 MS, max. 2 Tx can be done !!!

// Fixed allocation mode parameters
    UWORD8                tra_gap;               // Number of free Tx slots at the end of the frame
    BOOL                  fix_alloc_exhaust;     // Set to 1 if the fixed allocation bitmap has exhausted

  #if MACS_STATUS
    BOOL                  bcch_monitoring;       // When MAC-S calls RLC, set to TRUE if BCCH monitoring was done during the frame before
  #endif

} T_MACS_STATIC;

/*---------------------------------------------------*/
/* MS Class parameters                               */
/*---------------------------------------------------*/

typedef struct {
    UWORD8 rx;
    UWORD8 tx;
    UWORD8 sum;
    UWORD8 tta;
    UWORD8 ttb;
    UWORD8 tra;
    UWORD8 trb;
} T_MSCLASS_PARAMETERS;