view cdg-hybrid/cdginc/p_gmmreg.val @ 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 35f7a1dc9f7d
children
line wrap: on
line source

/*
+--------------------------------------------------------------------------+
| PROJECT : PROTOCOL STACK                                                 |
| FILE    : p_gmmreg.val                                                   |
| SOURCE  : "sap\gmmreg.pdf"                                               |
| LastModified : "2002-11-28"                                              |
| IdAndVersion : "8441.115.99.013"                                         |
| SrcFileTime  : "Thu Nov 29 09:42:12 2007"                                |
| Generated by CCDGEN_2.5.5A on Fri Oct 14 21:41:52 2016                   |
|           !!DO NOT MODIFY!!DO NOT MODIFY!!DO NOT MODIFY!!                |
+--------------------------------------------------------------------------+
*/

/* PRAGMAS
 * PREFIX                 : NONE
 * COMPATIBILITY_DEFINES  : NO (require PREFIX)
 * ALWAYS_ENUM_IN_VAL_FILE: NO
 * ENABLE_GROUP: NO
 * CAPITALIZE_TYPENAME: NO
 */


#ifndef P_GMMREG_VAL
#define P_GMMREG_VAL


#define CDG_ENTER__P_GMMREG_VAL

#define CDG_ENTER__FILENAME _P_GMMREG_VAL
#define CDG_ENTER__P_GMMREG_VAL__FILE_TYPE CDGINC
#define CDG_ENTER__P_GMMREG_VAL__LAST_MODIFIED _2002_11_28
#define CDG_ENTER__P_GMMREG_VAL__ID_AND_VERSION _8441_115_99_013

#define CDG_ENTER__P_GMMREG_VAL__SRC_FILE_TIME _Thu_Nov_29_09_42_12_2007

#include "CDG_ENTER.h"

#undef CDG_ENTER__P_GMMREG_VAL

#undef CDG_ENTER__FILENAME


/*
 * Value constants for VAL_attach_type
 */
#define VAL_ATTACH_TYPE___DEF          (0x0)      /* Combined GPRS attached         */
#define GMMREG_AT_GPRS                 (0x1)      /* GPRS-only attached             */
#define GMMREG_AT_IMSI                 (0x2)      /* non-GPRS-only attached         */
#define GMMREG_AT_COMB                 (0x3)      /* Combined GPRS/IMSI attached    */

/*
 * Value constants for VAL_detach_type
 */
#define VAL_DETACH_TYPE___DEF          (0x0)      /* GPRS detach                    */
#define GMMREG_DT_GPRS                 (0x1)      /* GPRS detach ( IMSI attached, GPRS will be reattached) */
#define GMMREG_DT_IMSI                 (0x2)      /* IMSI detach ( GPRS attached)   */
#define GMMREG_DT_COMB                 (0x3)      /* Combined GPRS/IMSI detach ( GPRS will be reattached) */
#define GMMREG_DT_SIM_REMOVED          (0x4)      /* SIM removed                    */
#define GMMREG_DT_POWER_OFF            (0x5)      /* Power off                      */
#define GMMREG_DT_DISABLE_GPRS         (0x6)      /* GPRS disabled                  */
#define GMMREG_DT_LIMITED_SERVICE      (0x7)      /* Limited Service requested      */
#define GMMREG_DT_SOFT_OFF             (0x8)      /* soft power off. SIM data is not cleaned */

/*
 * Value constants for VAL_v_plmn
 */
#define V_PLMN_PRES                    (0x1)      /* present                        */
#define GMMREG_PLMN_NOT_PRES           (0xff)     /* not present                    */

/*
 * Value constants for VAL_cause
 */
#define MMCS_IMSI_IN_HLR               (0x402)    /* IMSI unknown in HLR            */
#define MMCS_ILLEGAL_MS                (0x403)    /* Illegal MS                     */
#define MMCS_IMSI_IN_VLR               (0x404)    /* IMSI unknown in VLR            */
#define MMCS_IMEI_NOT_ACCEPTED         (0x405)    /* IMEI not accepted              */
#define MMCS_ILLEGAL_ME                (0x406)    /* Illegal ME                     */
#define MMCS_PLMN_NOT_ALLOWED          (0x40b)    /* PLMN not allowed               */
#define MMCS_LA_NOT_ALLOWED            (0x40c)    /* Location Area not allowed      */
#define MMCS_ROAMING_NOT_ALLOWED       (0x40d)    /* Roaming not allowed in this location area */
// VAL-FF: REL99  
// #define MMCS_NO_SUITABLE_CELL_IN_LA    (0x40f) /* Find another allowed location area in the same PLMN */
#define MMCS_NETWORK_FAILURE           (0x411)    /* Network failure                */
#define MMCS_CONGESTION                (0x416)    /* Congestion                     */
#define MMCS_SERVICE_NOT_SUPPORTED     (0x420)    /* Service option not supported   */
#define MMCS_SERVICE_NOT_SUBSCRIBED    (0x421)    /* Requested service option not subscribed */
#define MMCS_SERVICE_ORDER             (0x422)    /* Service option temporarily out of order */
#define MMCS_IDENTIFIY                 (0x426)    /* Call cannot be identified      */
#define MMCS_RETRY_IN_NEW_CELL         (0x430)    /* retry upon entry into a new cell (mapped 0x0430..0x043f -> 0x0430) */
#define MMCS_INCORRECT_MESSAGE         (0x45f)    /* Semantically incorrect message */
#define MMCS_INVALID_MAND_MESSAGE      (0x460)    /* Invalid mandatory information  */
#define MMCS_MESSAGE_TYPE_NOT_IMPLEM   (0x461)    /* Message type non-existent or not implemented */
#define MMCS_MESSAGE_TYPE_INCOMPAT     (0x462)    /* Message type not compatible with the protocol state */
#define MMCS_IE_NOT_IMPLEM             (0x463)    /* Information element non-existent or not implemented */
#define MMCS_CONDITIONAL_IE            (0x464)    /* Conditional IE error           */
#define MMCS_MESSAGE_INCOMPAT          (0x465)    /* Message not compatible with the protocol state */
#define MMCS_UNSPECIFIED               (0x46f)    /* Protocol error, unspecified    */
#define MMCS_SUCCESS                   (0xc400)   /* No error, successful operation (MM) */
#define MMCS_NO_REGISTRATION           (0xc480)   /* MS is not registered or deregistration started */
#define MMCS_TIMER_RECOVERY            (0xc481)   /* time-out in MM during establishment */
#define MMCS_NO_REESTABLISH            (0xc482)   /* Cell does not support call reestablishment */
#define MMCS_INT_PREEM                 (0xc483)   /* Preemptive release, e.g. MO-MT clash in MM */
#define MMCS_PLMN_NOT_IDLE_MODE        (0xc484)   /* reject, not in idle mode (MMR_PLMN_IND) */
#define MMCS_AUTHENTICATION_REJECTED   (0xc488)   /* AUTHENTICATION REJECT received */
#define MMCS_SIM_REMOVED               (0xc489)   /* A valid SIM is not present     */
#define MMCS_INT_NOT_PRESENT           (0xc4ff)   /* No error cause (MM)            */
#define GMMCS_IMSI_UNKNOWN             (0xa02)    /* IMSI unknown in HLR            */
#define GMMCS_ILLEGAL_MS               (0xa03)    /* Illegal MS                     */
#define GMMCS_ILLEGAL_ME               (0xa06)    /* Illegal ME                     */
#define GMMCS_GPRS_NOT_ALLOWED         (0xa07)    /* GPRS services not allowed      */
#define GMMCS_GSM_GPRS_NOT_ALLOWED     (0xa08)    /* GPRS services and non-GPRS services not allowed */
#define GMMCS_NO_MS_ID                 (0xa09)    /* MS identity cannot be derived by the network */
#define GMMCS_IMPLICIT_DETACHED        (0xa0a)    /* Implicitly detached            */
#define GMMCS_PLMN_NOT_ALLOWED         (0xa0b)    /* PLMN not allowed               */
#define GMMCS_LA_NOT_ALLOWED           (0xa0c)    /* Location Area not allowed      */
#define GMMCS_ROAMING_NOT_ALLOWED      (0xa0d)    /* Roaming not allowed in this location area */
#define GMMCS_GPRS_NOT_ALLOWED_IN_PLMN (0xa0e)    /* GPRS services not allowed in this PLMN */
// VAL-FF: REL99  
// #define GMMCS_NO_SUITABLE_CELL_IN_LA   (0xa0f) /* No Suitable Cell               */
#define GMMCS_MSC_TEMP_NOT_REACHABLE   (0xa10)    /* MSC temporarily not reachable  */
#define GMMCS_NET_FAIL                 (0xa11)    /* Network failure                */
#define GMMCS_CONGESTION               (0xa16)    /* Congestion                     */
#define GMMCS_RETRY_IN_NEW_CELL        (0xa30)    /* retry upon entry into a new cell (- 0x0A3F) */
#define GMMCS_SEMANTIC_INCORRECT       (0xa5f)    /* Semantically incorrect message */
#define GMMCS_INVALID_M_INFO           (0xa60)    /* Invalid mandatory information  */
#define GMMCS_TYPE_INVALID             (0xa61)    /* Message type non-existent or not implemented */
#define GMMCS_TYPE_INCOMPATIBLE        (0xa62)    /* Message type not compatible with the protocol state */
#define GMMCS_IE_INVALID               (0xa63)    /* Information element non-existent or not implemented */
#define GMMCS_COND_IE_ERROR            (0xa64)    /* Conditional IE error           */
#define GMMCS_MESSAGE_INVALID          (0xa65)    /* Message not compatible with the protocol state */
#define GMMCS_PROTOCOL_ERROR           (0xa6f)    /* Protocol error, unspecified    */
#define GMMCS_INT_PROTOCOL_ERROR       (0x4a07)   /* GPRS services not allowed (MS MM originated) */
#define GMMCS_INT_IMPLICIT_DETACHED    (0x4a0a)   /* Implicitely detached (MS MM originated) */
#define GNMCS_INT_PROTOCOL_ERROR       (0x4a6f)   /* Protocol error, unspecified (MS MM originated) */
#define GMMCS_NET_CAUSE_NOT_PRESENT    (0x8aff)   /* Network send message without cause information element */
#define GMMCS_SUCCESS                  (0xca00)   /* No error, successful operation (GMM) */
#define GMMCS_AAC_OVER_5               (0xca80)   /* attach_attempt counter over or equal 5 */
#define GMMCS_AAC_UNDER_5              (0xca81)   /* attach_attempt counter under 5 */
#define GMMCS_AUTHENTICATION_REJECTED  (0xca88)   /* AUTHENTICATION REJECT received */
#define GMMCS_SIM_REMOVED              (0xca89)   /* reserved for GACI              */
#define GMMCS_POWER_OFF                (0xca8a)   /* reserved for GACI              */
#define GMMCS_NO_SERVICE               (0xca8b)   /* reserved for GACI, no service available */
#define GMMCS_LIMITED_SERVICE          (0xca8c)   /* reserved for GACI              */
#define GMMCS_INT_NOT_PRESENT          (0xcaff)   /* No error cause (GMM)           */

/*
 * Value constants for VAL_mobile_class
 */
#define VAL_MOBILE_CLASS___DEF         (0x0)      /* Combined GPRS attach           */
#define GMMREG_CLASS_A                 (0x1)      /* Combined GPRS                  */
#define GMMREG_CLASS_B                 (0x2)      /* GPRS and GSM                   */
#define GMMREG_CLASS_BC                (0x3)      /* Combined GPRS if possible, otherwise GSM only */
#define GMMREG_CLASS_BG                (0x4)      /* Combined GPRS if possible, otherwise GPRS only */
#define GMMREG_CLASS_CC                (0x5)      /* GSM-only                       */
#define GMMREG_CLASS_CG                (0x6)      /* GPRS-only                      */

/*
 * Value constants for VAL_forb_ind
 */
#define FORB_PLMN_NOT_INCLUDED         (0x0)      /* Not member of the forbidden PLMN list */
#define FORB_PLMN_INCLUDED             (0x1)      /* Member of the forbidden PLMN list */

/*
 * Value constants for VAL_gprs_status
 */
#define VAL_GPRS_STATUS___DEF          (0x0)      /* PLMN supports GPRS and GSM     */
#define GMMREG_GPRS_GSM                (0x0)      /* PLMN supports GPRS and GSM     */
#define GMMREG_GPRS_ONLY               (0x1)      /* PLMN supports only GPRS        */
#define GMMREG_GSM_ONLY                (0x2)      /* PLMN supports only GSM         */

/*
 * Value constants for VAL_cell_state
 */
#define VAL_CELL_STATE___DEF           (0x0)      /* full service                   */
#define GMMREG_FULL_SERVICE            (0x0)      /* full service                   */
#define GMMREG_LIMITED_SERVICE         (0x1)      /* limited service                */
#define GMMREG_CS_CALL                 (0x2)      /* limited  service because of switching to dedicated mode */
#define GMMREG_GPRS_NOT_SUPPORTED      (0x3)      /* no GPRS cell available         */
#define GMMREG_TRY_TO_UPDATE           (0x4)      /* next attempt to update MS      */

/*
 * Value constants for VAL_net_selection_mode
 */
#define GMMREG_NET_SEL_MODE_AUTO       (0x0)      /* automatic mode                 */
#define GMMREG_NET_SEL_MODE_MAN        (0x1)      /* manual mode                    */

/*
 * Value constants for VAL_time_zone
 */
#define TIMEZONE_GMT                   (0x0)      /* GMT                            */
#define TIMEZONE_GMT_PLS_1HR           (0x40)     /* GMT + 1 hour                   */
#define TIMEZONE_GMT_PLS_2HR           (0x80)     /* GMT + 2 hours                  */
#define TIMEZONE_GMT_MIN_1HR           (0x48)     /* GMT - 1 hour                   */
#define TIMEZONE_GMT_MIN_2HR           (0x88)     /* GMT - 2 hours                  */

/*
 * Value constants for VAL_month
 */

/*
 * Value constants for VAL_second
 */

/*
 * Value constants for VAL_minute
 */

/*
 * Value constants for VAL_hour
 */

/*
 * Value constants for VAL_day
 */

/*
 * Value constants for VAL_year
 */

/*
 * Value constants for VAL_service_mode
 */
#define SERVICE_MODE_LIMITED           (0x0)      /* Search for limited service required */
#define SERVICE_MODE_FULL              (0x1)      /* Search for full service required */

/*
 * Value constants for VAL_search_running
 */
#define GMMREG_SEARCH_NOT_RUNNING      (0x0)      /* Network search not running anymore */
#define GMMREG_SEARCH_RUNNING          (0x1)      /* Network search still running   */

/*
 * Value constants for VAL_cipher_on
 */
#define GMMREG_CIPHER_OFF              (0x0)      /* ciphering switch off           */
#define GMMREG_CIPHER_ON               (0x1)      /* ciphering switch on            */

/*
 * Value constants for VAL_tlli_handling
 */
#define VAL_TLLI_HANDLING___DEF        (0x0)      /* normal TLLI handling           */
#define GMMREG_TLLI_STANDARD           (0x0)      /* normal TLLI handling           */
#define GMMREG_TLLI_TWICE              (0x1)      /* attach complete will be sent with old and with new TLLI */

/*
 * Value constants for VAL_gsm_ciph
 */
#define CIPH_OFF                       (0x0)      /* ciphering off                  */
#define CIPH_ON                        (0x1)      /* ciphering on                   */
#define CIPH_NA                        (0x2)      /* ciphering not applicable / no change in ciphering */

/*
 * Value constants for VAL_lac
 */
#define VAL_LAC___DEF                  (0x0)      /* location area code             */
#define GMMREG_LA_INVALID              (0xfffe)   /* location area code is not known */

/*
 * Value constants for VAL_rac
 */
#define VAL_RAC___DEF                  (0x0)      /* routing area code              */
#define GMMREG_RA_INVALID              (0xff)     /* routing area code is not known */

/*
 * Value constants for VAL_gprs_indicator
 */
#define GMM_GPRS_SUPP_NO               (0x0)      /* GPRS is not supported within the cell */
#define GMM_GPRS_SUPP_LIMITED          (0x1)      /* GPRS is supported in limited service */
#define GMM_GPRS_SUPP_YES              (0x2)      /* GPRS is supported within the cell */
#define GMM_GPRS_SUPP_UNKNOWN          (0x3)      /* GPRS support is unknown within the cell */

/*
 * Value constants for VAL_service
 */
#define NREG_NO_SERVICE                (0x0)      /* no service available           */
#define NREG_LIMITED_SERVICE           (0x1)      /* limited service available      */

// VALTAB-FF: REL99 
// 
// Value constants for VAL_net_daylight_save_time
// 
// VAL-FF: REL99  
// #define GMMREG_ADJ_NO                  (0x0)   /* GMMREG_ADJ_NO                  */
// VAL-FF: REL99  
// #define GMMREG_TIME_ADJ_1              (0x1)   /* +1 hour adjustment for Daylight Saving Time */
// VAL-FF: REL99  
// #define GMMREG_TIME_ADJ_2              (0x2)   /* +2 hours adjustment for Daylight Saving Time */

/*
 * Value constants for VAL_rt
 */
#define RT_GSM                         (0x0)      /* GSM                            */
#define RT_GPRS                        (0x1)      /* GSM/GPRS                       */
#define RT_EDGE                        (0x2)      /* GSM/GPRS/EDGE                  */
#define RT_UMTS_FDD                    (0x3)      /* UMTS FDD                       */

/*
 * Value constants for VAL_bootup_act
 */
#define NORMAL_REG                     (0x0)      /* Normal Registration            */
#define QUICK_REG                      (0x1)      /* Fast Registration              */

/*
 * Value constants for VAL_bootup_cause
 */
#define REG_END                        (0x0)      /* end of registration            */
#define PWR_SCAN_START                 (0x1)      /* power scanning started         */

/*
 * user defined constants
 */
#define GMMREG_MAX_PLMN_ID             (0xc)      
#define MMR_MAX_TEXT_LEN               (0x28)     
#define SIZE_MCC                       (0x3)      
#define SIZE_MNC                       (0x3)      

#include "CDG_LEAVE.h"


#endif