| /* 3GPP USIM specific structures / routines */ |
| /* |
| * (C) 2012 by Harald Welte <laforge@gnumonks.org> |
| * |
| * All Rights Reserved |
| * |
| * This program is free software; you can redistribute it and/or modify |
| * it under the terms of the GNU General Public License as published by |
| * the Free Software Foundation; either version 2 of the License, or |
| * (at your option) any later version. |
| * |
| * This program is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU General Public License for more details. |
| * |
| * You should have received a copy of the GNU General Public License along |
| * with this program; if not, write to the Free Software Foundation, Inc., |
| * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| */ |
| |
| |
| #include <errno.h> |
| #include <string.h> |
| |
| #include <osmocom/sim/sim.h> |
| #include <osmocom/core/talloc.h> |
| #include <osmocom/gsm/gsm48.h> |
| |
| #include "sim_int.h" |
| #include "gsm_int.h" |
| |
| /* TS 31.102 Version 7.7.0 / Chapoter 7.3 */ |
| const struct osim_card_sw ts31_102_sw[] = { |
| { |
| 0x9862, 0xffff, SW_TYPE_STR, SW_CLS_ERROR, |
| .u.str = "Security management - Authentication error, incorrect MAC", |
| }, { |
| 0x9864, 0xffff, SW_TYPE_STR, SW_CLS_ERROR, |
| .u.str = "Security management - Authentication error, security context not supported", |
| }, { |
| 0x9865, 0xffff, SW_TYPE_STR, SW_CLS_ERROR, |
| .u.str = "Security management - Key freshness error", |
| }, |
| OSIM_CARD_SW_LAST |
| }; |
| |
| static const struct osim_card_sw *usim_card_sws[] = { |
| ts31_102_sw, |
| ts102221_uicc_sw, |
| NULL |
| }; |
| |
| |
| static int default_decode(struct osim_decoded_data *dd, |
| const struct osim_file_desc *desc, |
| int len, uint8_t *data) |
| { |
| struct osim_decoded_element *elem; |
| |
| elem = element_alloc(dd, "Unknown Payload", ELEM_T_BYTES, ELEM_REPR_HEX); |
| elem->u.buf = talloc_memdup(elem, data, len); |
| |
| return 0; |
| } |
| |
| /* TS 102 221 Chapter 13.1 */ |
| static const struct osim_file_desc uicc_ef_in_mf[] = { |
| EF_LIN_FIX_N(0x2f00, "EF.DIR", 0, |
| "Application directory"), |
| EF_TRANSP_N(0x2FE2, "EF.ICCID", 0, |
| "ICC Identification"), |
| EF_TRANSP_N(0x2F05, "EF.PL", 0, |
| "Preferred Languages"), |
| EF_LIN_FIX_N(0x2F06, "EF.ARR", F_OPTIONAL, |
| "Access Rule Reference"), |
| }; |
| |
| static const struct osim_file_desc usim_ef_in_df_gsm_access[] = { |
| EF_TRANSP_N(0x4f20, "EF.Kc", 0, |
| "Ciphering Key Kc"), |
| EF_TRANSP_N(0x4f52, "EF.KcGPRS", 0, |
| "GPRS Ciphering key KcGPRS"), |
| EF_TRANSP_N(0x4f63, "EF.CPBCCH", F_OPTIONAL, |
| "CPBCCH Information"), |
| EF_TRANSP_N(0x4f64, "EF.invSCAN", F_OPTIONAL, |
| "Investigation Scan"), |
| }; |
| |
| /* 31.102 Chapter 4.2 */ |
| static const struct osim_file_desc usim_ef_in_adf_usim[] = { |
| EF_TRANSP(0x6F05, "EF.LI", 0, |
| "Language Indication", &gsm_lp_decode, NULL), |
| EF_TRANSP(0x6F07, "EF.IMSI", 0, |
| "IMSI", &gsm_imsi_decode, NULL), |
| EF_TRANSP_N(0x6F08, "EF.Keys", 0, |
| "Ciphering and Integrity Keys"), |
| EF_TRANSP_N(0x6F09, "EF.KeysPS", 0, |
| "Ciphering and Integrity Keys for Packet Switched domain"), |
| EF_TRANSP_N(0x6F60, "EF.PLMNwAcT", F_OPTIONAL, |
| "User controlled PLMN Selector with Access Technology"), |
| EF_TRANSP(0x6F31, "EF.HPPLMN", 0, |
| "Higher Priority PLMN search period", &gsm_hpplmn_decode, NULL), |
| EF_TRANSP_N(0x6F37, "EF.ACMmax", F_OPTIONAL, |
| "ACM maximum value"), |
| EF_TRANSP_N(0x6F38, "EF.UST", 0, |
| "USIM Service Table"), |
| EF_CYCLIC_N(0x6F39, "EF.ACM", F_OPTIONAL, |
| "Accumulated call meter"), |
| EF_TRANSP_N(0x6F3E, "EF.GID1", F_OPTIONAL, |
| "Group Identifier Level 1"), |
| EF_TRANSP_N(0x6F3F, "EF.GID2", F_OPTIONAL, |
| "Group Identifier Level 2"), |
| EF_TRANSP_N(0x6F46, "EF.SPN", F_OPTIONAL, |
| "Service Provider Name"), |
| EF_TRANSP_N(0x6F41, "EF.PUCT", F_OPTIONAL, |
| "Price per unit and currency table"), |
| EF_TRANSP_N(0x6F45, "EF.CBMI", F_OPTIONAL, |
| "Cell broadcast massage identifier selection"), |
| EF_TRANSP_N(0x6F78, "EF.ACC", 0, |
| "Access control class"), |
| EF_TRANSP_N(0x6F7B, "EF.FPLMN", 0, |
| "Forbidden PLMNs"), |
| EF_TRANSP_N(0x6F7E, "EF.LOCI", 0, |
| "Location information"), |
| EF_TRANSP_N(0x6FAD, "EF.AD", 0, |
| "Administrative data"), |
| EF_TRANSP_N(0x6F48, "EF.CBMID", F_OPTIONAL, |
| "Cell Broadcast Message Identifier for Data Download"), |
| EF_TRANSP_N(0x6FB7, "EF.ECC", F_OPTIONAL, |
| "Emergency Call Code"), |
| EF_TRANSP_N(0x6F50, "EF.CBMIR", F_OPTIONAL, |
| "Cell broadcast message identifier range selection"), |
| EF_TRANSP_N(0x6F73, "EF.PSLOCI", 0, |
| "Pacet Switched location information"), |
| EF_LIN_FIX_N(0x6F3B, "EF.FDN", F_OPTIONAL, |
| "Fixed dialling numbers"), |
| EF_LIN_FIX_N(0x6F3C, "EF.SMS", F_OPTIONAL, |
| "Short messages"), |
| EF_LIN_FIX_N(0x6F40, "EF.MSISDN", F_OPTIONAL, |
| "MSISDN"), |
| EF_LIN_FIX_N(0x6F42, "EF.SMSP", F_OPTIONAL, |
| "Short message service parameters"), |
| EF_TRANSP_N(0x6F43, "EF.SMSS", F_OPTIONAL, |
| "SMS Status"), |
| EF_LIN_FIX_N(0x6F49, "EF.SDN", F_OPTIONAL, |
| "Service Dialling Numbers"), |
| EF_LIN_FIX_N(0x6F4B, "EF.EXT2", F_OPTIONAL, |
| "Extension 2"), |
| EF_LIN_FIX_N(0x6F4C, "EF.EXT3", F_OPTIONAL, |
| "Extension 3"), |
| EF_LIN_FIX_N(0x6F47, "EF.SMSR", F_OPTIONAL, |
| "Short message status reports"), |
| EF_CYCLIC_N(0x6F80, "EF.ICI", F_OPTIONAL, |
| "Incoming Calling Information"), |
| EF_CYCLIC_N(0x6F81, "EF.OCI", F_OPTIONAL, |
| "Outgoing Calling Information"), |
| EF_CYCLIC_N(0x6F82, "EF.ICT", F_OPTIONAL, |
| "Incoming Call Timer"), |
| EF_CYCLIC_N(0x6F83, "EF.OCT", F_OPTIONAL, |
| "Outgoing Call Timer"), |
| EF_LIN_FIX_N(0x6F4E, "EF.EXT5", F_OPTIONAL, |
| "Extension 5"), |
| EF_LIN_FIX_N(0x6F4F, "EF.CCP2", F_OPTIONAL, |
| "Capability Configuration Parameters 2"), |
| EF_TRANSP_N(0x6FB5, "EF.eMLPP", F_OPTIONAL, |
| "enhanced Multi Level Precedence and Pre-emption"), |
| EF_TRANSP_N(0x6FB6, "EF.AAeM", F_OPTIONAL, |
| "Automatic Answer for eMLPP Service"), |
| EF_TRANSP_N(0x6FC3, "EF.Hiddenkey", F_OPTIONAL, |
| "Key for hidden phone book entries"), |
| EF_LIN_FIX_N(0x6F4D, "EF.BDN", F_OPTIONAL, |
| "Barred Dialling Numbers"), |
| EF_LIN_FIX_N(0x6F4E, "EF.EXT4", F_OPTIONAL, |
| "Extension 4"), |
| EF_LIN_FIX_N(0x6F58, "EF.CMI", F_OPTIONAL, |
| "Comparison Method Information"), |
| EF_TRANSP_N(0x6F56, "EF.EST", F_OPTIONAL, |
| "Enhanced Services Table"), |
| EF_TRANSP_N(0x6F57, "EF.ACL", F_OPTIONAL, |
| "Access Point Name Control List"), |
| EF_TRANSP_N(0x6F2C, "EF.DCK", F_OPTIONAL, |
| "Depersonalisation Control Keys"), |
| EF_TRANSP_N(0x6F32, "EF.CNL", F_OPTIONAL, |
| "Co-operative Network List"), |
| EF_TRANSP_N(0x6F5B, "EF.START-HFN", 0, |
| "Initialisation values for Hyperframe number"), |
| EF_TRANSP_N(0x6F5C, "EF.THRESHOLD", 0, |
| "Maximum value of START"), |
| EF_TRANSP_N(0x6F61, "EF.OPLMNwAcT", F_OPTIONAL, |
| "Operator controlled PLMN Selector with Access Technology"), |
| EF_TRANSP_N(0x6F62, "EF.HPLMNwAcT", F_OPTIONAL, |
| "HPLMN Selector with Access Technology"), |
| EF_LIN_FIX_N(0x6F06, "EF.ARR", 0, |
| "Access Rule Reference"), |
| EF_TRANSP_N(0x6FC4, "EF.NETPAR", 0, |
| "Network Parameters"), |
| EF_LIN_FIX_N(0x6FC5, "EF.PNN", F_OPTIONAL, |
| "PLMN Network Name"), |
| EF_LIN_FIX_N(0x6FC6, "EF.OPL", F_OPTIONAL, |
| "Operator PLMN List"), |
| EF_LIN_FIX_N(0x6FC7, "EF.MBDN", F_OPTIONAL, |
| "Mailbox Dialling Numbers"), |
| EF_LIN_FIX_N(0x6FC8, "EF.EXT6", F_OPTIONAL, |
| "Extension 6"), |
| EF_LIN_FIX_N(0x6FC9, "EF.MBI", F_OPTIONAL, |
| "Mailbox Identifier"), |
| EF_LIN_FIX_N(0x6FCA, "EF.MWIS", F_OPTIONAL, |
| "Message Waiting Indication Status"), |
| EF_LIN_FIX_N(0x6FCB, "EF.CFIS", F_OPTIONAL, |
| "Call Forwarding Indication Status"), |
| EF_LIN_FIX_N(0x6FCC, "EF.EXT7", F_OPTIONAL, |
| "Extension 7"), |
| EF_TRANSP_N(0x6FCD, "EF.SPDI", F_OPTIONAL, |
| "Service Provider Display Information"), |
| EF_LIN_FIX_N(0x6FCE, "EF.MMSN", F_OPTIONAL, |
| "MMS Notification"), |
| EF_LIN_FIX_N(0x6FCF, "EF.EXT8", F_OPTIONAL, |
| "Extension 8"), |
| EF_TRANSP_N(0x6FD0, "EF.MMSICP", F_OPTIONAL, |
| "MMS Issuer Connectivity Parameters"), |
| EF_LIN_FIX_N(0x6FD1, "EF.MMSUP", F_OPTIONAL, |
| "MMS User Preferences"), |
| EF_TRANSP_N(0x6FD2, "EF.MMSUCP", F_OPTIONAL, |
| "MMS User Connectivity Parameters"), |
| EF_LIN_FIX_N(0x6FD3, "EF.NIA", F_OPTIONAL, |
| "Network's Indication of Alerting"), |
| EF_TRANSP_N(0x6FB1, "EF.VGCS", F_OPTIONAL, |
| "Voice Group Call Service"), |
| EF_TRANSP_N(0x6FB2, "EF.VGCSS", F_OPTIONAL, |
| "Voice Group Call Service Status"), |
| EF_TRANSP_N(0x6FB3, "EF.VBS", F_OPTIONAL, |
| "Voice Broadcast Service"), |
| EF_TRANSP_N(0x6FB4, "EF.VBSS", F_OPTIONAL, |
| "Voice Broadcast Service Status"), |
| EF_TRANSP_N(0x6FD4, "EF.VGCSCA", F_OPTIONAL, |
| "Voice Group Call Service Ciphering Algorithm"), |
| EF_TRANSP_N(0x6FD5, "EF.VBSCA", F_OPTIONAL, |
| "Voice Broadcast Service Ciphering Algorithm"), |
| EF_TRANSP_N(0x6FD6, "EF.GBABP", F_OPTIONAL, |
| "GBA Bootstrapping parameters"), |
| EF_LIN_FIX_N(0x6FD7, "EF.MSK", F_OPTIONAL, |
| "MBMS Serviec Key List"), |
| EF_LIN_FIX_N(0x6FD8, "EF.MUK", F_OPTIONAL, |
| "MBMS User Key"), |
| EF_LIN_FIX_N(0x6FDA, "EF.GBANL", F_OPTIONAL, |
| "GBA NAF List"), |
| EF_TRANSP_N(0x6FD9, "EF.EHPLMN", F_OPTIONAL, |
| "Equivalent HPLMN"), |
| }; |
| |
| |
| |
| /* 31.102 Chapter 4.4.1 */ |
| static const struct osim_file_desc usim_ef_in_solsa[] = { |
| EF_TRANSP_N(0x4F30, "EF.SAI", F_OPTIONAL, |
| "SoLSA Access Indicator"), |
| EF_LIN_FIX_N(0x4F31, "EF.SLL", F_OPTIONAL, |
| "SoLSA LSA List"), |
| /* LSA descriptor files 4Fxx, hard to represent here */ |
| }; |
| |
| /* Annex E - TS 101 220 */ |
| static const uint8_t adf_usim_aid[] = { 0xA0, 0x00, 0x00, 0x00, 0x87, 0x10, 0x02 }; |
| |
| struct osim_card_profile *osim_cprof_usim(void *ctx) |
| { |
| struct osim_card_profile *cprof; |
| struct osim_file_desc *mf, *gsm, *tc, *uadf; |
| |
| cprof = talloc_zero(ctx, struct osim_card_profile); |
| cprof->name = "3GPP USIM"; |
| cprof->sws = usim_card_sws; |
| |
| mf = alloc_df(cprof, 0x3f00, "MF"); |
| |
| cprof->mf = mf; |
| |
| /* Core UICC Files */ |
| add_filedesc(mf, uicc_ef_in_mf, ARRAY_SIZE(uicc_ef_in_mf)); |
| |
| /* ADF.USIM with its EF siblings */ |
| uadf = add_adf_with_ef(mf, adf_usim_aid, sizeof(adf_usim_aid), |
| "ADF.USIM", usim_ef_in_adf_usim, |
| ARRAY_SIZE(usim_ef_in_adf_usim)); |
| |
| /* DFs under ADF.USIM */ |
| add_df_with_ef(uadf, 0x5F3A, "DF.PHONEBOOK", NULL, 0); |
| add_df_with_ef(uadf, 0x5F3B, "DF.GSM-ACCESS", usim_ef_in_df_gsm_access, |
| ARRAY_SIZE(usim_ef_in_df_gsm_access)); |
| add_df_with_ef(uadf, 0x5F3C, "DF.MExE", NULL, 0); |
| add_df_with_ef(uadf, 0x5F40, "DF.WLAN", NULL, 0); |
| add_df_with_ef(uadf, 0x5F70, "DF.SoLSA", usim_ef_in_solsa, ARRAY_SIZE(usim_ef_in_solsa)); |
| |
| #if 0 |
| /* DF.TELECOM as sub-directory of MF */ |
| tc = add_df_with_ef(mf, 0x7F10, "DF.TELECOM", sim_ef_in_telecom, |
| ARRAY_SIZE(sim_ef_in_telecom)); |
| add_df_with_ef(tc, 0x5F50, "DF.GRAPHICS", sim_ef_in_graphics, |
| ARRAY_SIZE(sim_ef_in_graphics)); |
| |
| /* DF.GSM for backwards compatibility */ |
| gsm = add_df_with_ef(mf, 0x7F20, "DF.GSM", sim_ef_in_gsm, |
| ARRAY_SIZE(sim_ef_in_gsm)); |
| /* FIXME: DF's below DF.GSM (51.011) */ |
| #endif |
| |
| return cprof; |
| } |