# CONFIG

KEYSTRING: Control.LUR.AttachDetach
VALUESTRING: 1
COMMENTS:
Attach/detach flag.  Set to 1 to use attach/detach procedure, 0 otherwise.  This will make initial LUR more prompt.  It will also cause an un-regstration if the handset powers off and really heavy LUR loads in areas with spotty coverage.


KEYSTRING: Control.LUR.FailedRegistration.Message
VALUESTRING: Your handset is not provisioned for this network.
COMMENTS:
If defined, send this text message, followed by the IMSI, to unprovisioned handsets that are denied  registration.


KEYSTRING: Control.LUR.FailedRegistration.ShortCode
VALUESTRING: 1000
COMMENTS:
The return address for the failed registration message.  If the message is defined, this must also be defined.


KEYSTRING: Control.LUR.NormalRegistration.Message
COMMENTS:
If defined, send this text message, followed by the IMSI, to provisioned handsets when they attach on Um.


KEYSTRING: Control.LUR.NormalRegistration.ShortCode
VALUESTRING: 0000
COMMENTS:
The return address for the normal registration message.  If the message is defined, this must also be defined.


KEYSTRING: Control.LUR.OpenRegistration.Message
VALUESTRING: Welcome to the GSM test network. Your IMSI is
COMMENTS:
If defined, send this text message, followed by the IMSI, to unprovisioned handsets when they attach on Um due to open registration.


KEYSTRING: Control.LUR.OpenRegistration.ShortCode
VALUESTRING: 101
COMMENTS:
The return address for the open registration message.  If the message is defined, this must also be defined.


KEYSTRING: Control.LUR.UnprovisionedRejectCause
VALUESTRING: 0x04
COMMENTS:
Reject cause for location updating failures for unprovisioned phones.  Reject causes come from GSM 04.08 10.5.3.6.  Reject cause 0x04, IMSI not in VLR, is usually the right one.


KEYSTRING: Control.VEA
VALUESTRING: 1
COMMENTS:
If not NULL, user very early assignment for speech call establishment.  See GSM 04.08 Section 7.3.2 for a detailed explanation of assignment types. If VEA is selected, GSM.CellSelection.NECI should be set to 1.  See GSM 04.08 Sections 9.1.8 and 10.5.2.4 for an explanation of the NECI bit.


KEYSTRING: GSM.CCCH.CCCH-CONF
VALUESTRING: 1
COMMENTS:
CCCH configuration type.  See GSM 10.5.2.11 for encoding.  Value of 1 means we are using a C-V beacon.  Any other value selects a C-IV beacon.


KEYSTRING: GSM.Channels.SDCCHReserve
VALUESTRING: 0
COMMENTS:
Number of SDCCHs to reserve for non-LUR operations. This can be used to force LUR transactions into a lower priority.


KEYSTRING: GSM.CellSelection.CELL-RESELECT-HYSTERESIS
VALUESTRING: 3
COMMENTS:
Cell Reselection Hysteresis.  See GSM 04.08 10.5.2.4, Table 10.5.23 for encoding.  Encoding is $2N$ dB, values of $N$ are 0...7 for 0...14 dB.


KEYSTRING: GSM.CellSelection.NCCsPermitted
VALUESTRING: 1
COMMENTS:
NCCs Permitted.  An 8-bit mask of allowed NCCs.  Unless you are coordinating with another carrier, this should probably just select your own NCC.


KEYSTRING: GSM.CellSelection.NECI
VALUESTRING: 1
COMMENTS:
NECI, New Establishment Causes.  This must be set to "1" if you want to support very early assignment (VEA).  It can be set to "1" even if you do not use VEA, so you might as well leave it as "1".  See GSM 04.08 10.5.2.4, Table 10.5.23 and 04.08 9.1.8, Table 9.9 and the Control.VEA parameter.


KEYSTRING: GSM.Channels.C1sFirst
COMMENTS:
If not NULL, allocate C-I slots first, starting at C0T1.  Otherwise, allocate C-VII slots first.  Static.


KEYSTRING: GSM.Channels.NumC1s
VALUESTRING: 5
COMMENTS:
Number of Combination-I timeslots to configure.  The C-I slot carries a single full-rate TCH, used for speech calling.  Static.


KEYSTRING: GSM.Channels.NumC7s
VALUESTRING: 0
COMMENTS:
Number of Combination-VII timeslots to configure.  The C-VII slot carries 8 SDCCHs, useful to handle high registration loads or SMS.  If C0T0 is C-IV, you must have at least one C-VII also.  Static.


KEYSTRING: GSM.Identity.BSIC.BCC
VALUESTRING: 2
COMMENTS:
GSM basestation color code; lower 3 bits of the BSIC.  BCC values in a multi-BTS network should be assigned so that BTS units with overlapping coverage do not share a BCC.  This value will also select the training sequence used for all slots on this unit.


KEYSTRING: GSM.Identity.BSIC.NCC
VALUESTRING: 0
COMMENTS:
GSM network color code; upper 3 bits of the BSIC.  Assigned by your national regulator.  Must be distinct from NCCs of other GSM operators in your area.


KEYSTRING: GSM.Identity.LAC
VALUESTRING: 1000
COMMENTS:
Location area code, 16 bits, values 0xFFxx are reserved.  For multi-BTS networks, assign a unique LAC to each BTS unit.  (That is not the normal procedure in conventional GSM networks, but is the correct procedure in OpenBTS networks.)


KEYSTRING: GSM.Identity.ShortName
VALUESTRING: Range
COMMENTS:
Network short name, displayed on some phones.  Optional but must be defined if you also want the network to send time-of-day.


KEYSTRING: GSM.MS.TA.Max
VALUESTRING: 5
COMMENTS:
Maximum allowed timing advance in symbol periods.  Ignore RACH bursts with delays greater than this.  Can be used to limit service range.


KEYSTRING: GSM.MaxSpeechLatency
VALUESTRING: 2
COMMENTS:
Maximum allowed speech buffering latency, in 20 ms frames.  If the jitter is larger than this delay, frames will be lost.


KEYSTRING: GSM.RACH.AC
VALUESTRING: 1024
COMMENTS:
Access class flags.  This is the raw parameter sent on the BCCH.  See GSM 04.08 10.5.2.29 for encoding.  Set to 0 to allow full access.  If you do not have proper PSAP integration, set to 0x0400 to indicate no support for emergency calls.


KEYSTRING: GSM.RACH.MaxRetrans
VALUESTRING: 3
COMMENTS:
Maximum RACH retransmission attempts.  This is the raw parameter sent on the BCCH.  See GSM 04.08 10.5.2.29 for encoding.


KEYSTRING: GSM.RACH.TxInteger
VALUESTRING: 8
COMMENTS:
Parameter to spread RACH busts over time.  This is the raw parameter sent on the BCCH.  See GSM 04.08 10.5.2.29 for encoding.


KEYSTRING: GSM.RADIO-LINK-TIMEOUT
VALUESTRING: 15
COMMENTS:
 L1 radio link timeout.  This is the raw parameter sent on the BCCH; see GSM 10.5.2.3 for encoding. Should be coordinated with T3109.


KEYSTRING: GSM.RRLP.RESPONSETIME
VALUESTRING: 4
COMMENTS:
Mobile timeout. (OpenBTS timeout is 130 sec = max response time + 2.) N in 2**N. See 3GPP 04.31 sect A.2.2.1


KEYSTRING: GSM.Radio.Band
VALUESTRING: 1800
COMMENTS:
The GSM operating band.  Valid values are 850 (GSM850), 900 (PGSM900), 1800 (DCS1800) and 1900 (PCS1900).  For most Range models, this value is dictated by the hardware and should not be changed.  Static.


KEYSTRING: GSM.Radio.PowerManager.MaxAttenDB
VALUESTRING: 10
COMMENTS:
Maximum transmitter attenuation level, in dB wrt full scale on the D/A output.  This sets the minimum power output level in the output power control loop.


KEYSTRING: GSM.Radio.PowerManager.MinAttenDB
VALUESTRING: 0
COMMENTS:
Minimum transmitter attenuation level, in dB wrt full scale on the D/A output.  This sets the maximum power output level in the output power control loop.


KEYSTRING: GSM.Radio.RxGain
VALUESTRING: 47
COMMENTS:
Receiver gain setting in dB.  Ideal value is dictacted by the hardware.  This database parameter is static but the receiver gain can be modified in real time with the CLI rxgain command.  Static.


KEYSTRING: GSM.Radio.RSSITarget
VALUESTRING: -50
COMMENTS:
Target uplink RSSI for MS power control loop, in dB wrt to A/D full scale.  Should be 6-10 dB above the noise floor.


KEYSTRING: GSM.Timer.T3113
VALUESTRING: 10000
COMMENTS:
Paging timer T3113 in ms.  This is the timeout for a handset to respond to a paging request.  This should usually be the same as SIP.Timer.B in your VoIP network.


KEYSTRING: GSM.Timer.T3212
VALUESTRING: 30
COMMENTS:
Registration timer T3212 period in minutes.  Should be a factor of 6.  Set to 0 to disable periodic registration.  Should be smaller than SIP registration period.


KEYSTRING: GSM.GPRS
VALUESTRING: 1
COMMENTS:
GPRS support "1" - turn on,  "0" - turn off. You should check GSM Channel configuration, timeslot for GPRS must be free.


KEYSTRING: NTP.Server
VALUESTRING: pool.ntp.org
COMMENTS:
NTP server(s) for time-of-day clock syncing.  For multiple servers, use a space-delimited list.  If left undefined, NTP will not be used, but it is strongly recommended.


KEYSTRING: SIP.RFC3428.NoTrying
VALUESTRING: 0
COMMENTS:
If NULL or 0, send 100 Trying response to SIP MESSAGE, even though that violates RFC-3428. In other words, to actually comply with the RFC, set this to something other than NULL or 0


KEYSTRING: SIP.DTMF.RFC2833.PayloadType
VALUESTRING: 101
COMMENTS:
Payload type to use for RFC-2833 telephone event packets.  If SIP.DTMF.2833 is defined, this must also be defined.


KEYSTRING: SIP.Local.IP
VALUESTRING: 127.0.0.1
COMMENTS:
IP address of the OpenBTS machine as seen by its proxies.  If these are all local, this can be localhost.  Static.


KEYSTRING: SIP.Proxy.Registration
VALUESTRING: 127.0.0.1:5064
COMMENTS:
The IP host and port of the proxy to be used for registration and authentication.  This should normally be the subscriber registry SIP interface, not Asterisk.


KEYSTRING: SIP.Proxy.Speech
VALUESTRING: 127.0.0.1:5060
COMMENTS:
The IP host and port of the proxy to be used for normal speech calls.  This is Asterisk, for example.


KEYSTRING: SIP.SMSC
VALUESTRING: smsc
COMMENTS:
The SMSC handler in smqueue.  This is the entity that handles full 3GPP MIME-encapsulted TPDUs.  If not defined, use direct numeric addressing.  Normally the value is NULL if SMS.MIMIEType is "text/plain" or "smsc" if SMS.MIMEType is "application/vnd.3gpp".


KEYSTRING: SMS.MIMEType
VALUESTRING: application/vnd.3gpp.sms
COMMENTS:
This is the MIME Type that OpenBTS will use for RFC-3428 SIP MESSAGE payloads.  Valid values are "application/vnd.3gpp.sms" and "text/plain".


KEYSTRING: GPRS.TS
VALUESTRING: 6 7
COMMENTS:
Timeslots for GPRS channels. You should check GSM Channel configuration, timeslot for GPRS must be free.


KEYSTRING: SubscriberRegistry.Port
VALUESTRING: 5064
COMMENTS:
Port used by the SIP Authentication Server. NOTE: In some older releases (pre-2.8.1) this is called SIP.myPort.


KEYSTRING: TRX.RadioFrequencyOffset
VALUESTRING: 128
COMMENTS:
Fine-tuning adjustment for the transceiver master clock.  Roughly 170 Hz/step.  Set at the factory.  Do not adjust without proper calibration.  Static.


KEYSTRING: TRX.TxAttenOffset
VALUESTRING: 2
COMMENTS:
Hardware-specific gain adjustment for transmitter, matched to the power amplifier, expessed as an attenuationi in dB.  Set at the factory.  Do not adjust without proper calibration.  Static.


