libosmogsm  0.11.0-dirty
Osmocom GSM library
include/osmocom/gsm/gsm48.h
Go to the documentation of this file.
00001 
00003 #pragma once
00004 
00005 #include <stdbool.h>
00006 
00007 #include <osmocom/gsm/tlv.h>
00008 #include <osmocom/gsm/protocol/gsm_04_08.h>
00009 #include <osmocom/gsm/gsm48_ie.h>
00010 #include <osmocom/gsm/gsm23003.h>
00011 
00012 /* reserved according to GSM 03.03 § 2.4 */
00013 #define GSM_RESERVED_TMSI   0xFFFFFFFF
00014 
00015 /* Valid MCC and MNC range from 0 to 999.
00016  * To mark an invalid / unset MNC, this value shall be used. */
00017 #define GSM_MCC_MNC_INVALID 0xFFFF
00018 
00019 /* A parsed GPRS routing area */
00020 struct gprs_ra_id {
00021         uint16_t        mcc;
00022         uint16_t        mnc;
00023         bool            mnc_3_digits;
00024         uint16_t        lac;
00025         uint8_t         rac;
00026 };
00027 
00028 extern const struct tlv_definition gsm48_att_tlvdef;
00029 extern const struct tlv_definition gsm48_rr_att_tlvdef;
00030 extern const struct tlv_definition gsm48_mm_att_tlvdef;
00031 const char *gsm48_cc_state_name(uint8_t state);
00032 const char *gsm48_cc_msg_name(uint8_t msgtype);
00033 const char *gsm48_rr_msg_name(uint8_t msgtype);
00034 const char *rr_cause_name(uint8_t cause);
00035 const char *osmo_rai_name(const struct gprs_ra_id *rai);
00036 
00037 int gsm48_decode_lai(struct gsm48_loc_area_id *lai, uint16_t *mcc,
00038                      uint16_t *mnc, uint16_t *lac)
00039         OSMO_DEPRECATED("Use gsm48_decode_lai2() instead, to not lose leading zeros in the MNC");
00040 void gsm48_decode_lai2(const struct gsm48_loc_area_id *lai, struct osmo_location_area_id *decoded);
00041 void gsm48_generate_lai(struct gsm48_loc_area_id *lai48, uint16_t mcc,
00042                         uint16_t mnc, uint16_t lac)
00043         OSMO_DEPRECATED("Use gsm48_generate_lai2() instead, to not lose leading zeros in the MNC");
00044 void gsm48_generate_lai2(struct gsm48_loc_area_id *lai48, const struct osmo_location_area_id *lai);
00045 
00046 int gsm48_generate_mid_from_tmsi(uint8_t *buf, uint32_t tmsi);
00047 int gsm48_generate_mid_from_imsi(uint8_t *buf, const char *imsi);
00048 uint8_t gsm48_generate_mid(uint8_t *buf, const char *id, uint8_t mi_type);
00049 
00050 /* Convert Mobile Identity (10.5.1.4) to string */
00051 int gsm48_mi_to_string(char *string, const int str_len,
00052                         const uint8_t *mi, const int mi_len);
00053 const char *gsm48_mi_type_name(uint8_t mi);
00054 
00055 /* Parse Routeing Area Identifier */
00056 void gsm48_parse_ra(struct gprs_ra_id *raid, const uint8_t *buf);
00057 void gsm48_encode_ra(struct gsm48_ra_id *out, const struct gprs_ra_id *raid);
00058 int gsm48_construct_ra(uint8_t *buf, const struct gprs_ra_id *raid) OSMO_DEPRECATED("Use gsm48_encode_ra() instead");
00059 
00060 int gsm48_number_of_paging_subchannels(struct gsm48_control_channel_descr *chan_desc);
00061 
00062 void gsm48_mcc_mnc_to_bcd(uint8_t *bcd_dst, uint16_t mcc, uint16_t mnc)
00063         OSMO_DEPRECATED("Use osmo_plmn_to_bcd() instead, to not lose leading zeros in the MNC");
00064 void gsm48_mcc_mnc_from_bcd(uint8_t *bcd_src, uint16_t *mcc, uint16_t *mnc)
00065         OSMO_DEPRECATED("Use osmo_plmn_from_bcd() instead, to not lose leading zeros in the MNC");
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines