mtp.h

Go to the documentation of this file.

#pragma once
 
#include <osmocom/core/utils.h>
 
/* Q.704 14.2.1, RFC4666 3.4.5.
 * ETSI EG 201 693 Section 5.1: MTP SI code allocations (for NI=00 (international network) only)
 */
enum mtp_si_ni00 {
        MTP_SI_SNM      = 0,
        MTP_SI_STM      = 1,
        MTP_SI_SCCP     = 3,
        MTP_SI_TUP      = 4,
        MTP_SI_ISUP     = 5,
        MTP_SI_DUP      = 6, /* call related */
        MTP_SI_DUP_FAC  = 7, /* facility related */
        MTP_SI_TESTING  = 8,
        MTP_SI_B_ISUP   = 9,
        MTP_SI_SAT_ISUP = 10,
        MTP_SI_SPEECH   = 11, /* speech processing element */
        MTP_SI_AAL2_SIG = 12,
        MTP_SI_BICC     = 13,
        MTP_SI_GCP      = 14,
};
extern const struct value_string mtp_si_vals[];
 
/* Q.704 14.2.2: "In the case of only one national signalling network the spare code of the
 * network indicator reserved for national use can be used, for example, to define an additional
 * 16 User Parts (making a total of 32 User Parts) for that national signalling network."
 * Hence, we keep service indicators for Network Indicator "International network" (00) the same
 * as for "National network" (10), and use "Reserved for national use" to specify extension
 * service indicators.
 * Note we pick enum values reserved in NI00 above in order to allow forming a
 * superset so it can still be used with other NI values. */
enum mtp_si_ni11 {
        MTP_SI_NI11_OSMO_IPA = 2, /* Contains an IPA header + payload */
};
 
/* Q.704 14.2.2 Sub-service field (Network Indicator) */
enum mtp_network_indicator {
        MTP_NI_INTERNATIONAL            = 0,
        MTP_NI_SPARE_INTERNATIONAL      = 1,
        MTP_NI_NATIONAL                 = 2,
        MTP_NI_RESERVED_NATIONAL        = 3
};
extern const struct value_string mtp_network_indicator_vals[];
 
 
/* Q.704 15.17.5 */
enum mtp_unavail_cause {
        MTP_UNAVAIL_C_UNKNOWN           = 0x0,
        MTP_UNAVAIL_C_UNEQUIP_REM_USER  = 0x1,
        MTP_UNAVAIL_C_INACC_REM_USER    = 0x2,
        /* This field is not explicitly listed in Q.704 15.17.5, but it is
         * explicitly described as one of four options in:
         * Q.701 "TABLE 1" and 8.4
         * Q.704 2.4.2
         * Q.711 "Table 18" and 7.2.4
         * Q.714 "Figure D.4"
         */
        MTP_UNAVAIL_C_CONGESTED         = 0x3,
        /* reserved */
};
 
extern const struct value_string mtp_unavail_cause_vals[];
 
static inline const char *mtp_unavail_cause_str(enum mtp_unavail_cause cs) {
        return get_value_string(mtp_unavail_cause_vals, cs);
}