Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 90 lines (57 sloc) 2.805 kB
f8fd38f @avian2 Adding README, licensing information.
avian2 authored
1 Introduction
2 ============
3
4 This is a spectrum sensing application for the VESNA platform. It presents
5 a unified interface to different radiofrequency energy detection modules
6 through a serial terminal. It also serves as an example use of hardware
7 drivers using the low-level spectrum sensing API.
8
9 All spectrum sensing devices supported by this application work by tuning
10 to a radiofrequency channel and estimating the power level at the antenna
11 interface. The range of frequencies that can be sensed is determined by a
12 hardware configuration. Each device may support one or more configurations.
13 A configuration is characterized by the frequency of the bottom-most
14 channel, channel spacing, channel bandwidth, number of channels and the
15 time it takes the device to perform a measurement for a single channel.
16
17 Currently two hardware models are supported:
18
19 - MODEL_TDA18219
20
21 VESNA SNC + SNE-CREWTV hardware configuration
22
23 wide-band energy detection in the UHF band using NXP TDA18219HN tuner
24 (also requires proprietary libtda18219 VESNA library)
25
26 - MODEL_NULL
27
28 VESNA SNC hardware configuration
29
30 dummy software-only device, returning noise and zero measurements
31
32 For more info on VESNA, see http://sensorlab.ijs.si/hardware.html
33
34
35 Compilation
36 ===========
37
38 To compile and upload firmware to a VESNA using OpenOCD and Olimex
39 ARM-USB-OCD:
40
41 $ make MODEL=sne-crewtv spectrum-sensor.u
42
43 Set the MODEL variable to the name of the hardware model you are
44 using.
45
46
47 Usage
48 =====
49
50 Connect VESNA to a serial terminal using 115200 baud, 8 data bits, 1 stop
51 bit, no parity.
52
53 You can then use the terminal to interact with the application in a
54 command-line fashion (conclude each command with a new line)
55
56 Type "help" to print a list of available commands with brief descriptions.
57
58 A typical session consists of:
59
60 1. "list" command to get the list of hardware configurations available
61
62 2. "select" command to select a configuration and setup the spectrum sweep
63 parameters.
64
65 3. "report-on" command to start the sweep.
66
67 4. "report-off" command to stop the sweep.
68
69
70 License
71 =======
72
73 Copyright (C) 2012 SensorLab, Jozef Stefan Institute
74 http://sensorlab.ijs.si
75
76 This program is free software: you can redistribute it and/or modify
77 it under the terms of the GNU General Public License as published by
78 the Free Software Foundation, either version 3 of the License, or
79 (at your option) any later version.
80
81 This program is distributed in the hope that it will be useful,
82 but WITHOUT ANY WARRANTY; without even the implied warranty of
83 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
84 GNU General Public License for more details.
85
86 You should have received a copy of the GNU General Public License
87 along with this program. If not, see <http://www.gnu.org/licenses/>.
88
89 Author: Tomaz Solc, <tomaz.solc@ijs.si>
Something went wrong with that request. Please try again.