summaryrefslogtreecommitdiffstats
path: root/src/target/trx_toolkit/fake_pm.py
blob: 0d66099e4931f3cb3cfb03b886cd23283e4d72b4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
#!/usr/bin/env python
# -*- coding: utf-8 -*-

# TRX Toolkit
# Power measurement emulation
#
# (C) 2017-2018 by Vadim Yanitskiy <axilirator@gmail.com>
#
# All Rights Reserved
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# 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.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program; if not, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

from random import randint

class FakePM:
	""" Power measurement emulation for fake transceivers.

	There is no such thing like RF signal level in fake Um-interface,
	so we need to emulate this. The main idea is to have a list of
	all running and idle transceivers. As soon as a measurement
	request is received, FakePM will attempt to find a running
	transceiver on a given frequency.

	The result of such "measurement" is a random RSSI value
	in one of the following ranges:

	  - trx_min ... trx_max - if at least one TRX was found,
	  - noise_min ... noise_max - no TRX instances were found.

	FIXME: it would be great to average the rate of bursts
	       and indicated power / attenuation values for all
	       matching transceivers, so "pure traffic" ARFCNs
	       would be handled properly.

	"""

	def __init__(self, noise_min, noise_max, trx_min, trx_max):
		# Init list of transceivers
		self.trx_list = []

		# RSSI randomization ranges
		self.noise_min = noise_min
		self.noise_max = noise_max
		self.trx_min = trx_min
		self.trx_max = trx_max

	@property
	def rssi_noise(self):
		return randint(self.noise_min, self.noise_max)

	@property
	def rssi_trx(self):
		return randint(self.trx_min, self.trx_max)

	def measure(self, freq, fn = None):
		# Iterate over all known transceivers
		for trx in self.trx_list:
			if not trx.running:
				continue

			# FIXME: we need to know current TDMA frame number here,
			# because some transceivers may use frequency hopping
			if trx.fh is not None and fn is None:
				continue

			# Match by given frequency
			if trx.get_tx_freq(fn) == freq:
				return self.rssi_trx

		return self.rssi_noise