blob: f7dee0374eb87aebe1d70dcc86a79d8ebfc30d7e [file] [log] [blame]
Pau Espin Pedrolc8b0f932020-02-11 17:45:26 +01001#####################################################################
2# srsUE configuration file
3#####################################################################
4
5#####################################################################
6# RF configuration
7#
8# dl_earfcn: Downlink EARFCN code.
9# freq_offset: Uplink and Downlink optional frequency offset (in Hz)
10# tx_gain: Transmit gain (dB).
11# rx_gain: Optional receive gain (dB). If disabled, AGC if enabled
12#
13# Optional parameters:
14# dl_freq: Override DL frequency corresponding to dl_earfcn
15# ul_freq: Override UL frequency corresponding to dl_earfcn
16# nof_radios: Number of available RF devices
17# nof_rf_channels: Number of RF channels per radio
18# nof_rx_ant: Number of RX antennas per channel
19# device_name: Device driver family. Supported options: "auto" (uses first found), "UHD" or "bladeRF"
20# device_args: Arguments for the device driver. Options are "auto" or any string.
21# Default for UHD: "recv_frame_size=9232,send_frame_size=9232"
22# Default for bladeRF: ""
23# device_args_2: Arguments for the RF device driver 2.
24# device_args_3: Arguments for the RF device driver 3.
25# time_adv_nsamples: Transmission time advance (in number of samples) to compensate for RF delay
26# from antenna to timestamp insertion.
27# Default "auto". B210 USRP: 100 samples, bladeRF: 27.
28# burst_preamble_us: Preamble length to transmit before start of burst.
29# Default "auto". B210 USRP: 400 us, bladeRF: 0 us.
30# continuous_tx: Transmit samples continuously to the radio or on bursts (auto/yes/no).
31# Default is auto (yes for UHD, no for rest)
32#####################################################################
33[rf]
34dl_earfcn = 3400
35freq_offset = 0
36tx_gain = 80
37#rx_gain = 40
38
39#nof_radios = 1
Pau Espin Pedrolf796ad02020-03-09 15:50:57 +010040nof_antennas = ${ue.num_antennas}
Pau Espin Pedrolc8b0f932020-02-11 17:45:26 +010041
Pau Espin Pedrola9a2fe22020-02-13 19:29:55 +010042device_name = ${ue.rf_dev_type}
43
Pau Espin Pedrolc8b0f932020-02-11 17:45:26 +010044# For best performance in 2x2 MIMO and >= 15 MHz use the following device_args settings:
45# USRP B210: num_recv_frames=64,num_send_frames=64
46
47# For best performance when BW<5 MHz (25 PRB), use the following device_args settings:
48# USRP B210: send_frame_size=512,recv_frame_size=512
49
Pau Espin Pedrola9a2fe22020-02-13 19:29:55 +010050device_args = ${ue.rf_dev_args}
Pau Espin Pedrolc8b0f932020-02-11 17:45:26 +010051#time_adv_nsamples = auto
52#burst_preamble_us = auto
53#continuous_tx = auto
54
55
56#####################################################################
57# Packet capture configuration
58#
59# Packet capture is supported at both MAC and NAS layers.
60# MAC-layer packets are captured to file in the compact format
61# decoded by the Wireshark mac-lte-framed dissector.
62# To use this dissector, edit the preferences for DLT_USER to
63# add an entry with DLT=147, Payload Protocol=mac-lte-framed.
64# For more information see: https://wiki.wireshark.org/MAC-LTE
65# NAS-layer packets are dissected with DLT=148, and
66# Payload Protocol = nas-eps.
67#
68# enable: Enable MAC layer packet captures (true/false)
69# filename: File path to use for MAC packet captures
70# nas_enable: Enable NAS layer packet captures (true/false)
71# nas_filename: File path to use for NAS packet captures
72#####################################################################
73[pcap]
Pau Espin Pedroldcf99ed2020-03-02 11:10:50 +010074enable = true
Pau Espin Pedrolc8b0f932020-02-11 17:45:26 +010075filename = /tmp/ue.pcap
76nas_enable = false
77nas_filename = /tmp/nas.pcap
78
79#####################################################################
80# Log configuration
81#
82# Log levels can be set for individual layers. "all_level" sets log
83# level for all layers unless otherwise configured.
84# Format: e.g. phy_level = info
85#
86# In the same way, packet hex dumps can be limited for each level.
87# "all_hex_limit" sets the hex limit for all layers unless otherwise
88# configured.
89# Format: e.g. phy_hex_limit = 32
90#
91# Logging layers: rf, phy, mac, rlc, pdcp, rrc, nas, gw, usim, all
92# Logging levels: debug, info, warning, error, none
93#
94# filename: File path to use for log output. Can be set to stdout
95# to print logs to standard output
96# file_max_size: Maximum file size (in kilobytes). When passed, multiple files are created.
97# If set to negative, a single log file will be created.
98#####################################################################
99[log]
100all_level = warning
101phy_lib_level = none
102all_hex_limit = 32
103filename = /tmp/ue.log
104file_max_size = -1
105
106#####################################################################
107# USIM configuration
108#
109# mode: USIM mode (soft/pcsc)
110# algo: Authentication algorithm (xor/milenage)
111# op/opc: 128-bit Operator Variant Algorithm Configuration Field (hex)
112# - Specify either op or opc (only used in milenage)
113# k: 128-bit subscriber key (hex)
114# imsi: 15 digit International Mobile Subscriber Identity
115# imei: 15 digit International Mobile Station Equipment Identity
116# pin: PIN in case real SIM card is used
117# reader: Specify card reader by it's name as listed by 'pcsc_scan'. If empty, try all available readers.
118#####################################################################
119[usim]
120mode = soft
121algo = ${ue.auth_algo}
122#opc = 63BFA50EE6523365FF14C1F45F88737D
123k = ${ue.ki}
124imsi = ${ue.imsi}
125imei = 353490069873319
126#reader =
127#pin = 1234
128
129#####################################################################
130# RRC configuration
131#
132# ue_category: Sets UE category (range 1-5). Default: 4
133# release: UE Release (8 to 10)
134# feature_group: Hex value of the featureGroupIndicators field in the
135# UECapabilityInformation message. Default 0xe6041000
136# mbms_service_id: MBMS service id for autostarting MBMS reception
137# (default -1 means disabled)
138# mbms_service_port: Port of the MBMS service
139#####################################################################
140[rrc]
141#ue_category = 4
142#release = 8
143#feature_group = 0xe6041000
144#mbms_service_id = -1
145#mbms_service_port = 4321
146
147#####################################################################
148# NAS configuration
149#
150# apn: Set Access Point Name (APN)
151# apn_protocol: Set APN protocol (IPv4, IPv6 or IPv4v6.)
152# user: Username for CHAP authentication
153# pass: Password for CHAP authentication
154# force_imsi_attach: Whether to always perform an IMSI attach
155# eia: List of integrity algorithms included in UE capabilities
156# Supported: 1 - Snow3G, 2 - AES
157# eea: List of ciphering algorithms included in UE capabilities
158# Supported: 0 - NULL, 1 - Snow3G, 2 - AES
159#####################################################################
160[nas]
161#apn = internetinternet
162#apn_protocol = ipv4
163#user = srsuser
164#pass = srspass
165#force_imsi_attach = false
166#eia = 1,2
167#eea = 0,1,2
168
169#####################################################################
170# GW configuration
171#
172# netns: Network namespace to create TUN device. Default: empty
173# ip_devname: Name of the tun_srsue device. Default: tun_srsue
174# ip_netmask: Netmask of the tun_srsue device. Default: 255.255.255.0
175#####################################################################
176[gw]
177#netns =
178#ip_devname = tun_srsue
179#ip_netmask = 255.255.255.0
180
181#####################################################################
182# GUI configuration
183#
184# Simple GUI displaying PDSCH constellation and channel freq response.
185# (Requires building with srsGUI)
186# enable: Enable the graphical interface (true/false)
187#####################################################################
188[gui]
189enable = false
190
191#####################################################################
192# Channel emulator options:
193# enable: Enable/Disable internal Downlink/Uplink channel emulator
194#
195# -- Fading emulator
196# fading.enable: Enable/disable fading simulator
197# fading.model: Fading model + maximum doppler (E.g. none, epa5, eva70, etu300, etc)
198#
199# -- Delay Emulator delay(t) = delay_min + (delay_max - delay_min) * (1 + sin(2pi*t/period)) / 2
200# Maximum speed [m/s]: (delay_max - delay_min) * pi * 300 / period
201# delay.enable: Enable/disable delay simulator
202# delay.period_s: Delay period in seconds.
203# delay.init_time_s: Delay initial time in seconds.
204# delay.maximum_us: Maximum delay in microseconds
205# delay.minumum_us: Minimum delay in microseconds
206#
207# -- Radio-Link Failure (RLF) Emulator
208# rlf.enable: Enable/disable RLF simulator
209# rlf.t_on_ms: Time for On state of the channel (ms)
210# rlf.t_off_ms: Time for Off state of the channel (ms)
211#
212# -- High Speed Train Doppler model simulator
213# hst.enable: Enable/Disable HST simulator
214# hst.period_s: HST simulation period in seconds
215# hst.fd_hz: Doppler frequency in Hz
216# hst.init_time_s: Initial time in seconds
217#####################################################################
218[channel.dl]
219#enable = false
220
221[channel.dl.fading]
222#enable = false
223#model = none
224
225[channel.dl.delay]
226#enable = false
227#period_s = 3600
228#init_time_s = 0
229#maximum_us = 100
230#minimum_us = 10
231
232[channel.dl.rlf]
233#enable = false
234#t_on_ms = 10000
235#t_off_ms = 2000
236
237[channel.dl.hst]
238#enable = false
239#period_s = 7.2
240#fd_hz = 750.0
241#init_time_s = 0.0
242
243[channel.ul]
244#enable = false
245
246[channel.ul.fading]
247#enable = false
248#model = none
249
250[channel.ul.delay]
251#enable = false
252#period_s = 3600
253#init_time_s = 0
254#maximum_us = 100
255#minimum_us = 10
256
257[channel.ul.rlf]
258#enable = false
259#t_on_ms = 10000
260#t_off_ms = 2000
261
262[channel.ul.hst]
263#enable = false
264#period_s = 7.2
265#fd_hz = -750.0
266#init_time_s = 0.0
267
268#####################################################################
269# PHY configuration options
270#
271# rx_gain_offset: RX Gain offset to add to rx_gain to calibrate RSRP readings
272# prach_gain: PRACH gain (dB). If defined, forces a gain for the tranmsission of PRACH only.,
273# Default is to use tx_gain in [rf] section.
274# cqi_max: Upper bound on the maximum CQI to be reported. Default 15.
275# cqi_fixed: Fixes the reported CQI to a constant value. Default disabled.
276# snr_ema_coeff: Sets the SNR exponential moving average coefficient (Default 0.1)
277# snr_estim_alg: Sets the noise estimation algorithm. (Default refs)
278# Options: pss: use difference between received and known pss signal,
279# refs: use difference between noise references and noiseless (after filtering)
280# empty: use empty subcarriers in the boarder of pss/sss signal
281# pdsch_max_its: Maximum number of turbo decoder iterations (Default 4)
282# nof_phy_threads: Selects the number of PHY threads (maximum 4, minimum 1, default 2)
283# equalizer_mode: Selects equalizer mode. Valid modes are: "mmse", "zf" or any
284# non-negative real number to indicate a regularized zf coefficient.
285# Default is MMSE.
286# sfo_ema: EMA coefficient to average sample offsets used to compute SFO
287# sfo_correct_period: Period in ms to correct sample time to adjust for SFO
288# sss_algorithm: Selects the SSS estimation algorithm. Can choose between
289# {full, partial, diff}.
290# estimator_fil_auto: The channel estimator smooths the channel estimate with an adaptative filter.
291# estimator_fil_stddev: Sets the channel estimator smooth gaussian filter standard deviation.
292# estimator_fil_order: Sets the channel estimator smooth gaussian filter order (even values perform better).
293# The taps are [w, 1-2w, w]
294#
295# snr_to_cqi_offset: Sets an offset in the SNR to CQI table. This is used to adjust the reported CQI.
296#
297# pregenerate_signals: Pregenerate uplink signals after attach. Improves CPU performance.
298#
299# interpolate_subframe_enabled: Interpolates in the time domain the channel estimates within 1 subframe. Default is to average.
300#
301# sic_pss_enabled: Applies Successive Interference Cancellation to PSS signals when searching for neighbour cells.
302# Must be disabled if cells have identical channel and timing, for instance if generated from
303# the same source.
304#
305# pdsch_csi_enabled: Stores the Channel State Information and uses it for weightening the softbits. It is only
306# used in TM1. It is True by default.
307#
308# pdsch_8bit_decoder: Use 8-bit for LLR representation and turbo decoder trellis computation (Experimental)
309# force_ul_amplitude: Forces the peak amplitude in the PUCCH, PUSCH and SRS (set 0.0 to 1.0, set to 0 or negative for disabling)
310#
311#####################################################################
312[phy]
313#rx_gain_offset = 62
314#prach_gain = 30
315#cqi_max = 15
316#cqi_fixed = 10
317#snr_ema_coeff = 0.1
318#snr_estim_alg = refs
319#pdsch_max_its = 8 # These are half iterations
320#nof_phy_threads = 3
321#equalizer_mode = mmse
322#sfo_ema = 0.1
323#sfo_correct_period = 10
324#sss_algorithm = full
325#estimator_fil_auto = false
326#estimator_fil_stddev = 1.0
327#estimator_fil_order = 4
328#snr_to_cqi_offset = 0.0
329#interpolate_subframe_enabled = false
330#sic_pss_enabled = true
331#pregenerate_signals = false
332#pdsch_csi_enabled = true
333#pdsch_8bit_decoder = false
334#force_ul_amplitude = 0
335
336#####################################################################
337# General configuration options
338#
339# metrics_csv_enable: Write UE metrics to CSV file.
340#
341# metrics_period_secs: Sets the period at which metrics are requested from the UE.
342#
343# metrics_csv_filename: File path to use for CSV metrics.
344#
345#####################################################################
346[general]
Pau Espin Pedrola0319952020-03-02 11:06:51 +0100347metrics_csv_enable = true
Pau Espin Pedrolc8b0f932020-02-11 17:45:26 +0100348#metrics_period_secs = 1
349#metrics_csv_filename = /tmp/ue_metrics.csv