view cdg-hybrid/cdginc/p_mmgmm.val @ 636:57e67ca2e1cb

pcmdata.c: default +CGMI to "FreeCalypso" and +CGMM to model The present change has no effect whatsoever on Falconia-made and Openmoko-made devices on which /pcm/CGMI and /pcm/CGMM files have been programmed in FFS with sensible ID strings by the respective factories, but what should AT+CGMI and AT+CGMM queries return when the device is a Huawei GTM900 or Tango modem that has been converted to FreeCalypso with a firmware change? Before the present change they would return compiled-in defaults of "<manufacturer>" and "<model>", respectively; with the present change the firmware will self-identify as "FreeCalypso GTM900-FC" or "FreeCalypso Tango" on the two respective targets. This firmware identification will become important if someone incorporates an FC-converted GTM900 or Tango modem into a ZeroPhone-style smartphone where some high-level software like ofono will be talking to the modem and will need to properly identify this modem as FreeCalypso, as opposed to some other AT command modem flavor with different quirks. In technical terms, the compiled-in default for the AT+CGMI query (which will always be overridden by the /pcm/CGMI file in FFS if one is present) is now "FreeCalypso" in all configs on all targets; the compiled-in default for the AT+CGMM query (likewise always overridden by /pcm/CGMM if present) is "GTM900-FC" if CONFIG_TARGET_GTM900 or "Tango" if CONFIG_TARGET_TANGO or the original default of "<model>" otherwise.
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 19 Jan 2020 20:14:58 +0000
parents e7a67accfad9
children
line wrap: on
line source

/*
+--------------------------------------------------------------------------+
| PROJECT : PROTOCOL STACK                                                 |
| FILE    : p_mmgmm.val                                                    |
| SOURCE  : "sap\mmgmm.pdf"                                                |
| LastModified : "2002-08-09"                                              |
| IdAndVersion : "8441.114.99.021"                                         |
| SrcFileTime  : "Thu Nov 29 09:46: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_MMGMM_VAL
#define P_MMGMM_VAL


#define CDG_ENTER__P_MMGMM_VAL

#define CDG_ENTER__FILENAME _P_MMGMM_VAL
#define CDG_ENTER__P_MMGMM_VAL__FILE_TYPE CDGINC
#define CDG_ENTER__P_MMGMM_VAL__LAST_MODIFIED _2002_08_09
#define CDG_ENTER__P_MMGMM_VAL__ID_AND_VERSION _8441_114_99_021

#define CDG_ENTER__P_MMGMM_VAL__SRC_FILE_TIME _Thu_Nov_29_09_46_12_2007

#include "CDG_ENTER.h"

#undef CDG_ENTER__P_MMGMM_VAL

#undef CDG_ENTER__FILENAME


/*
 * Value constants for VAL_mode
 */
#define MODE_AUTO                      (0x0)      /* automatic mode                 */
#define MODE_MAN                       (0x1)      /* manual mode                    */

/*
 * Value constants for VAL_v_tmsi
 */
#define MMGMM_TMSI_NOT_USED            (0x0)      /* TMSI not used                  */
#define MMGMM_TMSI_USED                (0x1)      /* TMSI used                      */

/*
 * Value constants for VAL_tmsi
 */
#define VAL_TMSI___DEF                 (0x0)      /* All other values are a valid TMSI */
#define MMGMM_TMSI_INVALID             (0xffffffff)/* TMSI invalidated               */

/*
 * 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              */
// VAL-FF: REL99  
// #define GMMCS_ROAMING_NOT_ALLOWED_WITH_RAU_REJ (0xca90)/* Roaming not allowed in this location area. */
// VAL-FF: REL99  
// #define GMMCS_NO_SUITABLE_CELL_IN_LA_WITH_RAU_REJ (0xca91)/* Find another allowed location area in the same PLMN. */
#define GMMCS_INT_NOT_PRESENT          (0xcaff)   /* No error cause (GMM)           */

/*
 * 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 MMGMM_GPRS_GSM                 (0x0)      /* PLMN supports GPRS and GSM     */
#define MMGMM_GPRS_ONLY                (0x1)      /* PLMN supports only GPRS        */
#define MMGMM_GSM_ONLY                 (0x2)      /* PLMN supports only GSM         */

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

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

/*
 * Value constants for VAL_resumption
 */
#define MMGMM_RESUMPTION_FAILURE       (0x0)      /* Resumption failure             */
#define MMGMM_RESUMPTION_OK            (0x1)      /* Resumption ok                  */

/*
 * Value constants for VAL_detach_cause
 */
#define CS_SIM_REM                     (0x0)      /* Consider SIM as removed or not valid */
#define CS_POW_OFF                     (0x1)      /* Power off and delete SIM data  */
#define CS_SOFT_OFF                    (0x2)      /* Power off and keep SIM data    */
#define CS_DISABLE                     (0x3)      /* disable GSM                    */

/*
 * Value constants for VAL_detach_done
 */
#define MMGMM_PERFORM_DETACH           (0x0)      /* detach not done                */
#define MMGMM_DETACH_DONE              (0x1)      /* detach done                    */

/*
 * Value constants for VAL_reg_type
 */
#define REG_GPRS_INACTIVE              (0x0)      /* MM acts as an normal GSM mobile */
#define REG_REMOTE_CONTROLLED          (0x1)      /* GPRS requests MM to perform olny LAU procedure */
#define REG_CELL_SEARCH_ONLY           (0x2)      /* MM is not allowed to start lau procedure */

/*
 * 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_cm_establish_res
 */
#define MMGMM_ESTABLISH_OK             (0x0)      /* establishing allowed           */
#define MMGMM_ESTABLISH_REJECT         (0x1)      /* establishing rejected          */

/*
 * Value constants for VAL_tz
 */
#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_status
 */
#define MMGMM_LIMITED_SERVICE          (0x0)      /* limited service only           */
#define MMGMM_FULL_SERVICE             (0x1)      /* full service, no LUP necessary */
#define MMGMM_CELL_SELECTED            (0x2)      /* Cell selected, indifferent     */
#define MMGMM_WAIT_FOR_UPDATE          (0x3)      /* waiting for remote controlled LUP */

/*
 * Value constants for VAL_gprs_indicator
 */
#define MMGMM_GPRS_SUPP_NO             (0x0)      /* GPRS is not supported by the cell */
#define MMGMM_GPRS_SUPP_YES            (0x1)      /* GPRS is supported by the cell  */

/*
 * Value constants for VAL_reason
 */
#define MMGMM_T3212                    (0x0)      /* T3212 has expired              */
#define MMGMM_T_ACCEPT                 (0x1)      /* T_ACCEPT has expired           */
#define MMGMM_IMSI_IN_VLR              (0x2)      /* IMSI unknown in VLR received   */
#define MMGMM_RXLEV_JUMP               (0x3)      /* RR indicated an increased RX level */
#define MMGMM_REG_TIMER                (0x4)      /* Registration timer in MM expired */

/*
 * Value constants for VAL_ciph
 */
#define CIPH_OFF                       (0x0)      /* ciphering off                  */
#define CIPH_ON                        (0x1)      /* ciphering on                   */

/*
 * Value constants for VAL_mobile_class
 */
#define VAL_MOBILE_CLASS___DEF         (0x0)      /* Combined GPRS attach           */
#define MMGMM_CLASS_A                  (0x1)      /* Combined GPRS                  */
#define MMGMM_CLASS_B                  (0x2)      /* GPRS and GSM                   */
#define MMGMM_CLASS_BC                 (0x3)      /* Combined GPRS if possible, otherwise GSM only */
#define MMGMM_CLASS_BG                 (0x4)      /* Combined GPRS if possible, otherwise GPRS only */
#define MMGMM_CLASS_CC                 (0x5)      /* GSM-only                       */
#define MMGMM_CLASS_CG                 (0x6)      /* GPRS-only                      */

// VALTAB-FF: REL99 
// 
// Value constants for VAL_daylight_save_time
// 
// #define MMR_ADJ_NO                     (0x0)   /* No adjustment for Daylight Saving Time */
// #define MMR_TIME_ADJ_1                 (0x1)   /* +1 hour adjustment for Daylight Saving Time */
// #define MMR_TIME_ADJ_2                 (0x2)   /* +2 hours adjustment for Daylight Saving Time */

/*
 * 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 MAX_PLMN_ID                    (0xc)      
#define MMR_MAX_TEXT_LEN               (0x28)     
#define SIZE_MCC                       (0x3)      
#define SIZE_MNC                       (0x3)      
#define SIZE_MNC_MIN                   (0x2)      
#define SIZE_MNC_MAX                   (0x3)      
#define MM_ORIGINATING_ENTITY          (0x4)      
#define GMM_ORIGINATING_ENTITY         (0xa)      
#define MIN_EQ_PLMN_ID                 (0x1)      
#define MAX_EQ_PLMN_ID                 (0x5)      

#include "CDG_LEAVE.h"


#endif