libosmogsm  0.9.3
Osmocom GSM library
include/osmocom/gsm/protocol/gsm_04_11.h
00001 #pragma once
00002 
00003 #include <stdint.h>
00004 
00005 /* GSM TS 04.11  definitions */
00006 
00007 /* Chapter 5.2.3: SMC-CS states at the user/network side */
00008 enum gsm411_cp_state {
00009         GSM411_CPS_IDLE                 = 0,
00010         GSM411_CPS_MM_CONN_PENDING      = 1,    /* only MT ! */
00011         GSM411_CPS_WAIT_CP_ACK          = 2,
00012         GSM411_CPS_MM_ESTABLISHED       = 3,
00013 };
00014 
00015 /* Chapter 6.2.2: SMR states at the user/network side */
00016 enum gsm411_rp_state {
00017         GSM411_RPS_IDLE                 = 0,
00018         GSM411_RPS_WAIT_FOR_RP_ACK      = 1,
00019         GSM411_RPS_WAIT_TO_TX_RP_ACK    = 3,
00020         GSM411_RPS_WAIT_FOR_RETRANS_T   = 4,
00021 };
00022 
00023 /* Chapter 8.1.2 (refers to GSM 04.07 Chapter 11.2.3.1.1 */
00024 #define GSM411_PDISC_SMS        0x09
00025 
00026 /* Chapter 8.1.3 */
00027 #define GSM411_MT_CP_DATA       0x01
00028 #define GSM411_MT_CP_ACK        0x04
00029 #define GSM411_MT_CP_ERROR      0x10
00030 
00031 enum gsm411_cp_ie {
00032         GSM411_CP_IE_USER_DATA          = 0x01, /* 8.1.4.1 */
00033         GSM411_CP_IE_CAUSE              = 0x02, /* 8.1.4.2. */
00034 };
00035 
00036 /* Section 8.1.4.2 / Table 8.2 */
00037 enum gsm411_cp_cause {
00038         GSM411_CP_CAUSE_NET_FAIL        = 17,
00039         GSM411_CP_CAUSE_CONGESTION      = 22,
00040         GSM411_CP_CAUSE_INV_TRANS_ID    = 81,
00041         GSM411_CP_CAUSE_SEMANT_INC_MSG  = 95,
00042         GSM411_CP_CAUSE_INV_MAND_INF    = 96,
00043         GSM411_CP_CAUSE_MSGTYPE_NOTEXIST= 97,
00044         GSM411_CP_CAUSE_MSG_INCOMP_STATE= 98,
00045         GSM411_CP_CAUSE_IE_NOTEXIST     = 99,
00046         GSM411_CP_CAUSE_PROTOCOL_ERR    = 111,
00047 };
00048 
00049 /* Chapter 8.2.2 */
00050 #define GSM411_MT_RP_DATA_MO    0x00
00051 #define GSM411_MT_RP_DATA_MT    0x01
00052 #define GSM411_MT_RP_ACK_MO     0x02
00053 #define GSM411_MT_RP_ACK_MT     0x03
00054 #define GSM411_MT_RP_ERROR_MO   0x04
00055 #define GSM411_MT_RP_ERROR_MT   0x05
00056 #define GSM411_MT_RP_SMMA_MO    0x06
00057 
00058 enum gsm411_rp_ie {
00059         GSM411_IE_RP_USER_DATA          = 0x41, /* 8.2.5.3 */
00060         GSM411_IE_RP_CAUSE              = 0x42, /* 8.2.5.4 */
00061 };
00062 
00063 /* Chapter 8.2.5.4 Table 8.4 */
00064 enum gsm411_rp_cause {
00065         /* valid only for MO */
00066         GSM411_RP_CAUSE_MO_NUM_UNASSIGNED       = 1,
00067         GSM411_RP_CAUSE_MO_OP_DET_BARR          = 8,
00068         GSM411_RP_CAUSE_MO_CALL_BARRED          = 10,
00069         GSM411_RP_CAUSE_MO_SMS_REJECTED         = 21,
00070         GSM411_RP_CAUSE_MO_DEST_OUT_OF_ORDER    = 27,
00071         GSM411_RP_CAUSE_MO_UNIDENTIFIED_SUBSCR  = 28,
00072         GSM411_RP_CAUSE_MO_FACILITY_REJ         = 29,
00073         GSM411_RP_CAUSE_MO_UNKNOWN_SUBSCR       = 30,
00074         GSM411_RP_CAUSE_MO_NET_OUT_OF_ORDER     = 38,
00075         GSM411_RP_CAUSE_MO_TEMP_FAIL            = 41,
00076         GSM411_RP_CAUSE_MO_CONGESTION           = 42,
00077         GSM411_RP_CAUSE_MO_RES_UNAVAIL          = 47,
00078         GSM411_RP_CAUSE_MO_REQ_FAC_NOTSUBSCR    = 50,
00079         GSM411_RP_CAUSE_MO_REQ_FAC_NOTIMPL      = 69,
00080         GSM411_RP_CAUSE_MO_INTERWORKING         = 127,
00081         /* valid only for MT */
00082         GSM411_RP_CAUSE_MT_MEM_EXCEEDED         = 22,
00083         /* valid for both directions */
00084         GSM411_RP_CAUSE_INV_TRANS_REF           = 81,
00085         GSM411_RP_CAUSE_SEMANT_INC_MSG          = 95,
00086         GSM411_RP_CAUSE_INV_MAND_INF            = 96,
00087         GSM411_RP_CAUSE_MSGTYPE_NOTEXIST        = 97,
00088         GSM411_RP_CAUSE_MSG_INCOMP_STATE        = 98,
00089         GSM411_RP_CAUSE_IE_NOTEXIST             = 99,
00090         GSM411_RP_CAUSE_PROTOCOL_ERR            = 111,
00091 };
00092 
00093 /* Chapter 10: Timers */
00094 #define GSM411_TMR_TR1M         40, 0   /* 35 < x < 45 seconds */
00095 #define GSM411_TMR_TRAM         30, 0   /* 25 < x < 35 seconds */
00096 #define GSM411_TMR_TR2M         15, 0   /* 12 < x < 20 seconds */
00097 
00098 #define GSM411_TMR_TC1A         30, 0   /* TR1M - 10 */
00099 #define GSM411_TMR_TC1A_SEC     30      /* TR1M - 10 */
00100 
00101 /* Chapter 8.2.1 */
00102 struct gsm411_rp_hdr {
00103         uint8_t len;
00104         uint8_t msg_type;
00105         uint8_t msg_ref;
00106         uint8_t data[0];
00107 } __attribute__ ((packed));
00108 
00109 /* our own enum, not related to on-air protocol */
00110 enum sms_alphabet {
00111         DCS_NONE,
00112         DCS_7BIT_DEFAULT,
00113         DCS_UCS2,
00114         DCS_8BIT_DATA,
00115 };
00116 
00117 /* GSM 03.40 / Chapter 9.2.3.1: TP-Message-Type-Indicator */
00118 #define GSM340_SMS_DELIVER_SC2MS        0x00
00119 #define GSM340_SMS_DELIVER_REP_MS2SC    0x00
00120 #define GSM340_SMS_STATUS_REP_SC2MS     0x02
00121 #define GSM340_SMS_COMMAND_MS2SC        0x02
00122 #define GSM340_SMS_SUBMIT_MS2SC         0x01
00123 #define GSM340_SMS_SUBMIT_REP_SC2MS     0x01
00124 #define GSM340_SMS_RESERVED             0x03
00125 
00126 /* GSM 03.40 / Chapter 9.2.3.2: TP-More-Messages-to-Send */
00127 #define GSM340_TP_MMS_MORE              0
00128 #define GSM340_TP_MMS_NO_MORE           1
00129 
00130 /* GSM 03.40 / Chapter 9.2.3.3: TP-Validity-Period-Format */
00131 #define GSM340_TP_VPF_NONE              0
00132 #define GSM340_TP_VPF_RELATIVE          2
00133 #define GSM340_TP_VPF_ENHANCED          1
00134 #define GSM340_TP_VPF_ABSOLUTE          3
00135 
00136 /* GSM 03.40 / Chapter 9.2.3.4: TP-Status-Report-Indication */
00137 #define GSM340_TP_SRI_NONE              0
00138 #define GSM340_TP_SRI_PRESENT           1
00139 
00140 /* GSM 03.40 / Chapter 9.2.3.5: TP-Status-Report-Request */
00141 #define GSM340_TP_SRR_NONE              0
00142 #define GSM340_TP_SRR_REQUESTED         1
00143 
00144 /* GSM 03.40 / Chapter 9.2.3.9: TP-Protocol-Identifier */
00145 /* telematic interworking (001 or 111 in bits 7-5) */
00146 #define GSM340_TP_PID_IMPLICIT          0x00
00147 #define GSM340_TP_PID_TELEX             0x01
00148 #define GSM340_TP_PID_FAX_G3            0x02
00149 #define GSM340_TP_PID_FAX_G4            0x03
00150 #define GSM340_TP_PID_VOICE             0x04
00151 #define GSM430_TP_PID_ERMES             0x05
00152 #define GSM430_TP_PID_NATIONAL_PAGING   0x06
00153 #define GSM430_TP_PID_VIDEOTEX          0x07
00154 #define GSM430_TP_PID_TELETEX_UNSPEC    0x08
00155 #define GSM430_TP_PID_TELETEX_PSPDN     0x09
00156 #define GSM430_TP_PID_TELETEX_CSPDN     0x0a
00157 #define GSM430_TP_PID_TELETEX_PSTN      0x0b
00158 #define GSM430_TP_PID_TELETEX_ISDN      0x0c
00159 #define GSM430_TP_PID_TELETEX_UCI       0x0d
00160 #define GSM430_TP_PID_MSG_HANDLING      0x10
00161 #define GSM430_TP_PID_MSG_X400          0x11
00162 #define GSM430_TP_PID_EMAIL             0x12
00163 #define GSM430_TP_PID_GSM_MS            0x1f
00164 /* if bit 7 = 0 and bit 6 = 1 */
00165 #define GSM430_TP_PID_SMS_TYPE_0        0
00166 #define GSM430_TP_PID_SMS_TYPE_1        1
00167 #define GSM430_TP_PID_SMS_TYPE_2        2
00168 #define GSM430_TP_PID_SMS_TYPE_3        3
00169 #define GSM430_TP_PID_SMS_TYPE_4        4
00170 #define GSM430_TP_PID_SMS_TYPE_5        5
00171 #define GSM430_TP_PID_SMS_TYPE_6        6
00172 #define GSM430_TP_PID_SMS_TYPE_7        7
00173 #define GSM430_TP_PID_RETURN_CALL_MSG   0x1f
00174 #define GSM430_TP_PID_ME_DATA_DNLOAD    0x3d
00175 #define GSM430_TP_PID_ME_DE_PERSONAL    0x3e
00176 #define GSM430_TP_PID_ME_SIM_DNLOAD     0x3f
00177 
00178 /* GSM 03.38 Chapter 4: SMS Data Coding Scheme */
00179 #define GSM338_DCS_00_
00180 
00181 #define GSM338_DCS_1110_7BIT            (0 << 2)
00182 #define GSM338_DCS_1111_7BIT            (0 << 2)
00183 #define GSM338_DCS_1111_8BIT_DATA       (1 << 2)
00184 #define GSM338_DCS_1111_CLASS0          0
00185 #define GSM338_DCS_1111_CLASS1_ME       1
00186 #define GSM338_DCS_1111_CLASS2_SIM      2
00187 #define GSM338_DCS_1111_CLASS3_TE       3       /* See TS 07.05 */