/** * * \section COPYRIGHT * * Copyright 2013-2015 Software Radio Systems Limited * * \section LICENSE * * This file is part of the srsUE library. * * srsUE is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of * the License, or (at your option) any later version. * * srsUE 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 Affero General Public License for more details. * * A copy of the GNU Affero General Public License can be found in * the LICENSE file in the top-level directory of this distribution * and at http://www.gnu.org/licenses/. * */ #ifndef SRSLTE_BCD_HELPERS_H #define SRSLTE_BCD_HELPERS_H #include #include #include #include namespace srslte { /****************************************************************************** * Convert between string and BCD-coded MCC. * Digits are represented by 4-bit nibbles. Unused nibbles are filled with 0xF. * MCC 001 results in 0xF001 *****************************************************************************/ inline bool string_to_mcc(std::string str, uint16_t *mcc) { uint32_t len = (uint32_t)str.size(); if(len != 3) { return false; } if(!isdigit(str[0]) || !isdigit(str[1]) || !isdigit(str[2])) { return false; } *mcc = 0xF000; *mcc |= ((uint8_t)(str[0]-'0') << 8); *mcc |= ((uint8_t)(str[1]-'0') << 4); *mcc |= ((uint8_t)(str[2]-'0')); return true; } inline bool mcc_to_string(uint16_t mcc, std::string *str) { if((mcc & 0xF000) != 0xF000) { return false; } *str = ""; *str += ((mcc & 0x0F00) >> 8) + '0'; *str += ((mcc & 0x00F0) >> 4) + '0'; *str += (mcc & 0x000F) + '0'; return true; } /****************************************************************************** * Convert between array of bytes and BCD-coded MCC. * Digits are represented by 4-bit nibbles. Unused nibbles are filled with 0xF. * MCC 001 results in 0xF001 *****************************************************************************/ inline bool bytes_to_mcc(uint8_t* bytes, uint16_t* mcc) { *mcc = 0xF000; *mcc |= (((uint16_t)bytes[0]) << 8u); *mcc |= (((uint16_t)bytes[1]) << 4u); *mcc |= (uint16_t)bytes[2]; return true; } inline bool mcc_to_bytes(uint16_t mcc, uint8_t* bytes) { if ((mcc & 0xF000) != 0xF000) { return false; } bytes[0] = (uint8_t)((mcc & 0xF00) >> 8); bytes[1] = (uint8_t)((mcc & 0x0F0) >> 4); bytes[2] = (uint8_t)(mcc & 0x00F); return true; } inline std::string mcc_bytes_to_string(asn1::rrc::mcc_l mcc_bytes) { std::string mcc_str; uint16_t mcc; bytes_to_mcc(&mcc_bytes[0], &mcc); if (!mcc_to_string(mcc, &mcc_str)) { mcc_str = "000"; } return mcc_str; } /****************************************************************************** * Convert between string and BCD-coded MNC. * Digits are represented by 4-bit nibbles. Unused nibbles are filled with 0xF. * MNC 001 results in 0xF001 * MNC 01 results in 0xFF01 *****************************************************************************/ inline bool string_to_mnc(std::string str, uint16_t *mnc) { uint32_t len = str.size(); if(len != 3 && len != 2) { return false; } if(len == 3) { if(!isdigit(str[0]) || !isdigit(str[1]) || !isdigit(str[2])) { return false; } *mnc = 0xF000; *mnc |= ((uint8_t)(str[0]-'0') << 8); *mnc |= ((uint8_t)(str[1]-'0') << 4); *mnc |= ((uint8_t)(str[2]-'0')); } if(len == 2) { if(!isdigit(str[0]) || !isdigit(str[1])) { return false; } *mnc = 0xFF00; *mnc |= ((uint8_t)(str[0]-'0') << 4); *mnc |= ((uint8_t)(str[1]-'0')); } return true; } inline bool mnc_to_string(uint16_t mnc, std::string *str) { if((mnc & 0xF000) != 0xF000) { return false; } *str = ""; if((mnc & 0xFF00) != 0xFF00) { *str += ((mnc & 0x0F00) >> 8) + '0'; } *str += ((mnc & 0x00F0) >> 4) + '0'; *str += (mnc & 0x000F) + '0'; return true; } /****************************************************************************** * Convert between array of bytes and BCD-coded MNC. * Digits are represented by 4-bit nibbles. Unused nibbles are filled with 0xF. * MNC 001 results in 0xF001 * MNC 01 results in 0xFF01 *****************************************************************************/ inline bool bytes_to_mnc(uint8_t* bytes, uint16_t* mnc, uint8_t len) { if (len != 3 && len != 2) { *mnc = 0; return false; } if (len == 3) { *mnc = 0xF000; *mnc |= ((uint16_t)bytes[0]) << 8u; *mnc |= ((uint16_t)bytes[1]) << 4u; *mnc |= ((uint16_t)bytes[2]) << 0u; } if (len == 2) { *mnc = 0xFF00; *mnc |= ((uint16_t)bytes[0]) << 4u; *mnc |= ((uint16_t)bytes[1]) << 0u; } return true; } inline bool mnc_to_bytes(uint16_t mnc, uint8_t* bytes, uint8_t* len) { if ((mnc & 0xF000) != 0xF000) { *len = 0; return false; } uint8_t count = 0; if ((mnc & 0xFF00) != 0xFF00) { bytes[count++] = (mnc & 0xF00) >> 8u; } bytes[count++] = (mnc & 0x00F0) >> 4u; bytes[count++] = (mnc & 0x000F); *len = count; return true; } template bool mnc_to_bytes(uint16_t mnc, Vec& vec) { uint8_t len; uint8_t v[3]; bool ret = mnc_to_bytes(mnc, &v[0], &len); vec.resize(len); memcpy(&vec[0], &v[0], len); return ret; } inline std::string mnc_bytes_to_string(asn1::rrc::mnc_l mnc_bytes) { std::string mnc_str; uint16_t mnc; bytes_to_mnc(&mnc_bytes[0], &mnc, mnc_bytes.size()); if (!mnc_to_string(mnc, &mnc_str)) { mnc_str = "000"; } return mnc_str; } inline std::string plmn_id_to_string(asn1::rrc::plmn_id_s plmn_id) { std::string mcc_str, mnc_str; uint16_t mnc, mcc; bytes_to_mnc(&plmn_id.mnc[0], &mnc, plmn_id.mnc.size()); bytes_to_mcc(&plmn_id.mcc[0], &mcc); mnc_to_string(mnc, &mnc_str); mcc_to_string(mcc, &mcc_str); return mcc_str + mnc_str; } inline bool string_to_plmn_id(asn1::rrc::plmn_id_s& plmn, std::string mccmnc_str) { if (mccmnc_str.size() < 5 or mccmnc_str.size() > 6) { return false; } uint16_t mnc, mcc; if (not string_to_mcc(std::string(mccmnc_str.begin(), mccmnc_str.begin() + 3), &mcc)) { return false; } if (not string_to_mnc(std::string(mccmnc_str.begin() + 3, mccmnc_str.end()), &mnc)) { return false; } plmn.mcc_present = true; if (not mcc_to_bytes(mcc, &plmn.mcc[0])) { return false; } return mnc_to_bytes(mnc, plmn.mnc); } /****************************************************************************** * Convert PLMN to BCD-coded MCC and MNC. * Digits are represented by 4-bit nibbles. Unused nibbles are filled with 0xF. * MNC 001 represented as 0xF001 * MNC 01 represented as 0xFF01 * PLMN encoded as per TS 36.413 sec 9.2.3.8 *****************************************************************************/ inline void s1ap_plmn_to_mccmnc(uint32_t plmn, uint16_t *mcc, uint16_t *mnc) { uint8_t nibbles[6]; nibbles[0] = (plmn & 0xF00000) >> 20; nibbles[1] = (plmn & 0x0F0000) >> 16; nibbles[2] = (plmn & 0x00F000) >> 12; nibbles[3] = (plmn & 0x000F00) >> 8; nibbles[4] = (plmn & 0x0000F0) >> 4; nibbles[5] = (plmn & 0x00000F); *mcc = 0xF000; *mnc = 0xF000; *mcc |= nibbles[1] << 8; // MCC digit 1 *mcc |= nibbles[0] << 4; // MCC digit 2 *mcc |= nibbles[3]; // MCC digit 3 if(nibbles[2] == 0xF) { // 2-digit MNC *mnc |= 0x0F00; // MNC digit 1 *mnc |= nibbles[5] << 4; // MNC digit 2 *mnc |= nibbles[4]; // MNC digit 3 } else { // 3-digit MNC *mnc |= nibbles[2] << 8; // MNC digit 1 *mnc |= nibbles[5] << 4; // MNC digit 2 *mnc |= nibbles[4] ; // MNC digit 3 } } /****************************************************************************** * Convert BCD-coded MCC and MNC to PLMN. * Digits are represented by 4-bit nibbles. Unused nibbles are filled with 0xF. * MNC 001 represented as 0xF001 * MNC 01 represented as 0xFF01 * PLMN encoded as per TS 36.413 sec 9.2.3.8 *****************************************************************************/ inline void s1ap_mccmnc_to_plmn(uint16_t mcc, uint16_t mnc, uint32_t *plmn) { uint8_t nibbles[6]; nibbles[1] = (mcc & 0x0F00) >> 8; // MCC digit 1 nibbles[0] = (mcc & 0x00F0) >> 4; // MCC digit 2 nibbles[3] = (mcc & 0x000F); // MCC digit 3 if((mnc & 0xFF00) == 0xFF00) { // 2-digit MNC nibbles[2] = 0x0F; // MNC digit 1 nibbles[5] = (mnc & 0x00F0) >> 4; // MNC digit 2 nibbles[4] = (mnc & 0x000F); // MNC digit 3 } else { // 3-digit MNC nibbles[2] = (mnc & 0x0F00) >> 8; // MNC digit 1 nibbles[5] = (mnc & 0x00F0) >> 4; // MNC digit 2 nibbles[4] = (mnc & 0x000F); // MNC digit 3 } *plmn = 0x000000; *plmn |= nibbles[0] << 20; *plmn |= nibbles[1] << 16; *plmn |= nibbles[2] << 12; *plmn |= nibbles[3] << 8; *plmn |= nibbles[4] << 4; *plmn |= nibbles[5]; } } // namespace srslte #endif // SRSLTE_BCD_HELPERS_H