Files
openbts/GSM/GSMCommon.cpp
2014-03-25 00:06:30 +01:00

410 lines
10 KiB
C++

/*
* Copyright 2008 Free Software Foundation, Inc.
* Copyright 2011, 2013 Range Networks, Inc.
*
* This software is distributed under multiple licenses;
* see the COPYING file in the main directory for licensing
* information for this specific distribuion.
*
* This use of this software may be subject to additional restrictions.
* See the LEGAL file in the main directory for details.
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.
*/
#include <Globals.h>
#include "GSMCommon.h"
using namespace GSM;
using namespace std;
ostream& GSM::operator<<(ostream& os, L3PD val)
{
switch (val) {
case L3CallControlPD: os << "Call Control"; break;
case L3MobilityManagementPD: os << "Mobility Management"; break;
case L3RadioResourcePD: os << "Radio Resource"; break;
default: os << hex << "0x" << (int)val << dec;
}
return os;
}
const BitVector2 GSM::gTrainingSequence[] = {
BitVector2("00100101110000100010010111"),
BitVector2("00101101110111100010110111"),
BitVector2("01000011101110100100001110"),
BitVector2("01000111101101000100011110"),
BitVector2("00011010111001000001101011"),
BitVector2("01001110101100000100111010"),
BitVector2("10100111110110001010011111"),
BitVector2("11101111000100101110111100"),
};
const BitVector2 GSM::gDummyBurst("0001111101101110110000010100100111000001001000100000001111100011100010111000101110001010111010010100011001100111001111010011111000100101111101010000");
const BitVector2 GSM::gRACHSynchSequence("01001011011111111001100110101010001111000");
unsigned char GSM::encodeGSMChar(unsigned char ascii)
{
// Given an ASCII char, return the corresponding GSM char.
// Do it with a lookup table, generated on the first call.
// You might be tempted to replace this init with some more clever NULL-pointer trick.
// -- Don't. This is thread-safe.
static char reverseTable[256]={'?'};
static volatile bool init = false;
if (!init) {
for (size_t i=0; i<sizeof(gGSMAlphabet); i++) {
reverseTable[(unsigned)gGSMAlphabet[i]]=i;
}
// Set the flag last to be thread-safe.
init=true;
}
return reverseTable[(unsigned)ascii];
}
char GSM::encodeBCDChar(char ascii)
{
// Given an ASCII char, return the corresponding BCD.
if ((ascii>='0') && (ascii<='9')) return ascii-'0';
switch (ascii) {
case '.': return 11;
case '*': return 11;
case '#': return 12;
case 'a': return 13;
case 'b': return 14;
case 'c': return 15;
default: return 15;
}
}
// Must be unsigned char, not signed char, or the conversion in sprintf below will be negative
string GSM::data2hex(const unsigned char *data, unsigned nbytes)
{
//LOG(DEBUG) << LOGVAR(nbytes);
string result;
result.reserve(2+2*nbytes);
result.append("0x");
if (nbytes == 0) { result.append("0"); return result; }
for (unsigned i = 0; i < nbytes; i++) {
char buf[20]; // Paranoid, only need 3.
sprintf(buf,"%02x",*data++);
//LOG(DEBUG) << LOGVAR(buf) <<LOGVAR(result);
result.append(buf);
}
return result;
}
unsigned GSM::uplinkFreqKHz(GSMBand band, unsigned ARFCN)
{
switch (band) {
case GSM850:
//assert((ARFCN<252)&&(ARFCN>129)); // this was a real bug, ticket #1420.
assert((ARFCN>=128)&&(ARFCN<=251));
return 824200+200*(ARFCN-128);
case EGSM900:
if (ARFCN<=124) return 890000+200*ARFCN;
assert((ARFCN>=975)&&(ARFCN<=1023));
return 890000+200*(ARFCN-1024);
case DCS1800:
assert((ARFCN>=512)&&(ARFCN<=885));
return 1710200+200*(ARFCN-512);
case PCS1900:
assert((ARFCN>=512)&&(ARFCN<=810));
return 1850200+200*(ARFCN-512);
default:
assert(0);
}
}
unsigned GSM::uplinkOffsetKHz(GSMBand band)
{
switch (band) {
case GSM850: return 45000;
case EGSM900: return 45000;
case DCS1800: return 95000;
case PCS1900: return 80000;
default: assert(0);
}
}
unsigned GSM::downlinkFreqKHz(GSMBand band, unsigned ARFCN)
{
return uplinkFreqKHz(band,ARFCN) + uplinkOffsetKHz(band);
}
// See GSM 04.08 Table 10.5.68.
const unsigned GSM::RACHSpreadSlots[16] =
{
3,4,5,6,
7,8,9,10,
11,12,14,16,
20,25,32,50
};
// See GSM 04.08 Table 3.1
const unsigned GSM::RACHWaitSParam[16] =
{
55,76,109,163,217,
55,76,109,163,217,
55,76,109,163,217,
55
};
int32_t GSM::FNDelta(int32_t v1, int32_t v2)
{
static const int32_t halfModulus = gHyperframe/2;
int32_t delta = v1-v2;
if (delta>=halfModulus) delta -= gHyperframe;
else if (delta<-halfModulus) delta += gHyperframe;
return (int32_t) delta;
}
int GSM::FNCompare(int32_t v1, int32_t v2)
{
int32_t delta = FNDelta(v1,v2);
if (delta>0) return 1;
if (delta<0) return -1;
return 0;
}
ostream& GSM::operator<<(ostream& os, const Time& t)
{
os << t.TN() << ":" << t.FN();
return os;
}
void Clock::set(const Time& when)
{
mLock.lock();
mBaseTime = Timeval(0);
mBaseFN = when.FN();
mLock.unlock();
}
int32_t Clock::FN() const
{
mLock.lock();
Timeval now;
int32_t deltaSec = now.sec() - mBaseTime.sec();
int32_t deltaUSec = now.usec() - mBaseTime.usec();
int64_t elapsedUSec = 1000000LL*deltaSec + deltaUSec;
int64_t elapsedFrames = elapsedUSec / gFrameMicroseconds;
int32_t currentFN = (mBaseFN + elapsedFrames) % gHyperframe;
mLock.unlock();
return currentFN;
}
double Clock::systime(const GSM::Time& when) const
{
ScopedLock lock(mLock);
const double slotMicroseconds = (48.0 / 13e6) * 156.25;
const double frameMicroseconds = slotMicroseconds * 8.0;
int32_t elapsedFrames = when.FN() - mBaseFN;
if (elapsedFrames<0) elapsedFrames += gHyperframe;
double elapsedUSec = elapsedFrames * frameMicroseconds + when.TN() * slotMicroseconds;
double baseSeconds = mBaseTime.sec() + mBaseTime.usec()*1e-6;
double st = baseSeconds + 1e-6*elapsedUSec;
return st;
}
void Clock::wait(const Time& when) const
{
int32_t now = FN();
int32_t target = when.FN();
int32_t delta = FNDelta(target,now);
if (delta<1) return;
static const int32_t maxSleep = 51*26;
if (delta>maxSleep) delta=maxSleep;
sleepFrames(delta);
}
ostream& GSM::operator<<(ostream& os, TypeOfNumber type)
{
switch (type) {
case UnknownTypeOfNumber: os << "unknown"; break;
case InternationalNumber: os << "international"; break;
case NationalNumber: os << "national"; break;
case NetworkSpecificNumber: os << "network-specific"; break;
case ShortCodeNumber: os << "short code"; break;
default: os << "?" << (int)type << "?";
}
return os;
}
ostream& GSM::operator<<(ostream& os, NumberingPlan plan)
{
switch (plan) {
case UnknownPlan: os << "unknown"; break;
case E164Plan: os << "E.164/ISDN"; break;
case X121Plan: os << "X.121/data"; break;
case F69Plan: os << "F.69/Telex"; break;
case NationalPlan: os << "national"; break;
case PrivatePlan: os << "private"; break;
default: os << "?" << (int)plan << "?";
}
return os;
}
ostream& GSM::operator<<(ostream& os, MobileIDType wID)
{
switch (wID) {
case NoIDType: os << "None"; break;
case IMSIType: os << "IMSI"; break;
case IMEIType: os << "IMEI"; break;
case TMSIType: os << "TMSI"; break;
case IMEISVType: os << "IMEISV"; break;
default: os << "?" << (int)wID << "?";
}
return os;
}
ostream& GSM::operator<<(ostream& os, TypeAndOffset tao)
{
switch (tao) {
case TDMA_MISC: os << "(misc)"; break;
case TCHF_0: os << "TCH/F"; break;
case TCHH_0: os << "TCH/H-0"; break;
case TCHH_1: os << "TCH/H-1"; break;
case SDCCH_4_0: os << "SDCCH/4-0"; break;
case SDCCH_4_1: os << "SDCCH/4-1"; break;
case SDCCH_4_2: os << "SDCCH/4-2"; break;
case SDCCH_4_3: os << "SDCCH/4-3"; break;
case SDCCH_8_0: os << "SDCCH/8-0"; break;
case SDCCH_8_1: os << "SDCCH/8-1"; break;
case SDCCH_8_2: os << "SDCCH/8-2"; break;
case SDCCH_8_3: os << "SDCCH/8-3"; break;
case SDCCH_8_4: os << "SDCCH/8-4"; break;
case SDCCH_8_5: os << "SDCCH/8-5"; break;
case SDCCH_8_6: os << "SDCCH/8-6"; break;
case SDCCH_8_7: os << "SDCCH/8-7"; break;
case TDMA_BEACON: os << "BCH"; break;
case TDMA_BEACON_BCCH: os << "BCCH"; break;
case TDMA_BEACON_CCCH: os << "CCCH"; break;
case TDMA_PDCH: os << "PDCH"; break;
case TDMA_PACCH: os << "PACCH"; break;
case TDMA_PTCCH: os << "PTCCH"; break;
case TDMA_PDIDLE: os << "PDIDLE"; break;
default: os << "?" << (int)tao << "?";
}
return os;
}
ostream& GSM::operator<<(ostream& os, ChannelType val)
{
switch (val) {
case UndefinedCHType: os << "undefined"; return os;
case SCHType: os << "SCH"; break;
case FCCHType: os << "FCCH"; break;
case BCCHType: os << "BCCH"; break;
case RACHType: os << "RACH"; break;
case SDCCHType: os << "SDCCH"; break;
case FACCHType: os << "FACCH"; break;
case CCCHType: os << "CCCH"; break;
case SACCHType: os << "SACCH"; break;
case TCHFType: os << "TCH/F"; break;
case TCHHType: os << "TCH/H"; break;
case AnyTCHType: os << "any TCH"; break;
case LoopbackFullType: os << "Loopback Full"; break;
case LoopbackHalfType: os << "Loopback Half"; break;
case PDTCHCS1Type: os << "PDTCHCS1"; break;
case PDTCHCS2Type: os << "PDTCHCS2"; break;
case PDTCHCS3Type: os << "PDTCHCS3"; break;
case PDTCHCS4Type: os << "PDTCHCS4"; break;
case PSingleBlock1PhaseType: os << "GPRS_SingleBlock1Phase"; break;
case PSingleBlock2PhaseType: os << "GPRS_SingleBlock2Phase"; break;
case AnyDCCHType: os << "any DCCH"; break;
default: os << "?" << (int)val << "?"; break;
}
return os;
}
bool Z100Timer::expired() const
{
assert(mLimitTime!=0);
// A non-active timer does not expire.
if (!mActive) return false;
return mEndTime.passed();
}
void Z100Timer::set()
{
assert(mLimitTime!=0);
mEndTime = Timeval(mLimitTime);
mActive=true;
}
void Z100Timer::expire()
{
mEndTime = Timeval(0);
mActive=true;
}
void Z100Timer::set(long wLimitTime)
{
mLimitTime = wLimitTime;
set();
}
long Z100Timer::remaining() const
{
if (!mActive) return 0;
long rem = mEndTime.remaining();
if (rem<0) rem=0;
return rem;
}
void Z100Timer::wait() const
{
while (!expired()) msleep(remaining());
}
std::ostream& GSM::operator<<(std::ostream& os, const Z100Timer&zt)
{
if (zt.active()) { os << zt.remaining(); }
else { os << "inactive"; }
return os;
}
// vim: ts=4 sw=4