From fdc7bc978bf423f2663b10bb8f6cbd69879d9c02 Mon Sep 17 00:00:00 2001 From: Steve Markgraf Date: Thu, 17 May 2012 23:51:59 +0200 Subject: [PATCH] add an initial version of rtl_test This tool allows to check for lost samples (and thus check the USB connection), as well as benchmark the Elonics E4000 tunable range. (-t switch) Signed-off-by: Steve Markgraf --- include/rtl-sdr.h | 10 ++ src/CMakeLists.txt | 7 +- src/Makefile.am | 5 +- src/librtlsdr.c | 10 ++ src/rtl_test.c | 292 +++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 322 insertions(+), 2 deletions(-) create mode 100644 src/rtl_test.c diff --git a/include/rtl-sdr.h b/include/rtl-sdr.h index 6c342d1..a5b3dfd 100644 --- a/include/rtl-sdr.h +++ b/include/rtl-sdr.h @@ -126,6 +126,16 @@ RTLSDR_API int rtlsdr_set_sample_rate(rtlsdr_dev_t *dev, uint32_t rate); */ RTLSDR_API uint32_t rtlsdr_get_sample_rate(rtlsdr_dev_t *dev); +/*! + * Enable test mode that returns an 8 bit counter instead of the samples. + * The counter is generated inside the RTL2832. + * + * \param dev the device handle given by rtlsdr_open() + * \param test mode, 1 means enabled, 0 disabled + * \return 0 on success + */ +RTLSDR_API int rtlsdr_set_testmode(rtlsdr_dev_t *dev, int on); + /* streaming functions */ RTLSDR_API int rtlsdr_reset_buffer(rtlsdr_dev_t *dev); diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt index 8ffdd85..c0d0f99 100644 --- a/src/CMakeLists.txt +++ b/src/CMakeLists.txt @@ -60,6 +60,7 @@ endif() ######################################################################## add_executable(rtl_sdr rtl_sdr.c) add_executable(rtl_tcp rtl_tcp.c) +add_executable(rtl_test rtl_test.c) target_link_libraries(rtl_sdr rtlsdr_static ${LIBUSB_LIBRARIES} ${CMAKE_THREAD_LIBS_INIT} @@ -68,6 +69,10 @@ target_link_libraries(rtl_tcp rtlsdr_static ${LIBUSB_LIBRARIES} ${CMAKE_THREAD_LIBS_INIT} ) +target_link_libraries(rtl_test rtlsdr_static + ${LIBUSB_LIBRARIES} + ${CMAKE_THREAD_LIBS_INIT} +) if(WIN32) set_property(TARGET rtl_sdr APPEND PROPERTY COMPILE_DEFINITIONS "rtlsdr_STATIC" ) @@ -76,7 +81,7 @@ endif() ######################################################################## # Install built library files & utilities ######################################################################## -install(TARGETS rtlsdr_shared rtlsdr_static rtl_sdr rtl_tcp +install(TARGETS rtlsdr_shared rtlsdr_static rtl_sdr rtl_tcp rtl_test LIBRARY DESTINATION lib${LIB_SUFFIX} # .so/.dylib file ARCHIVE DESTINATION lib${LIB_SUFFIX} # .lib file RUNTIME DESTINATION bin # .dll file diff --git a/src/Makefile.am b/src/Makefile.am index c44d869..bd78e13 100644 --- a/src/Makefile.am +++ b/src/Makefile.am @@ -10,10 +10,13 @@ lib_LTLIBRARIES = librtlsdr.la librtlsdr_la_SOURCES = librtlsdr.c tuner_e4k.c tuner_fc0012.c tuner_fc0013.c tuner_fc2580.c librtlsdr_la_LDFLAGS = -version-info $(LIBVERSION) -bin_PROGRAMS = rtl_sdr rtl_tcp +bin_PROGRAMS = rtl_sdr rtl_tcp rtl_test rtl_sdr_SOURCES = rtl_sdr.c rtl_sdr_LDADD = librtlsdr.la rtl_tcp_SOURCES = rtl_tcp.c rtl_tcp_LDADD = librtlsdr.la + +rtl_test_SOURCES = rtl_tcp.c +rtl_test_LDADD = librtlsdr.la diff --git a/src/librtlsdr.c b/src/librtlsdr.c index b6f9163..7721c4a 100644 --- a/src/librtlsdr.c +++ b/src/librtlsdr.c @@ -726,6 +726,16 @@ uint32_t rtlsdr_get_sample_rate(rtlsdr_dev_t *dev) return dev->rate; } +int rtlsdr_set_testmode(rtlsdr_dev_t *dev, int on) +{ + if (!dev) + return -1; + + rtlsdr_demod_write_reg(dev, 0, 0x19, on ? 0x23 : 0x25 , 1); + + return 0; +} + rtlsdr_dongle_t *find_known_device(uint16_t vid, uint16_t pid) { unsigned int i; diff --git a/src/rtl_test.c b/src/rtl_test.c new file mode 100644 index 0000000..2aabe5a --- /dev/null +++ b/src/rtl_test.c @@ -0,0 +1,292 @@ +/* + * rtl-sdr, turns your Realtek RTL2832 based DVB dongle into a SDR receiver + * Copyright (C) 2012 by Steve Markgraf + * + * 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, see . + */ + +#include +#include +#include +#include +#include + +#ifndef _WIN32 +#include +#else +#include +#endif + +#include "rtl-sdr.h" + +#define DEFAULT_SAMPLE_RATE 2048000 +#define DEFAULT_ASYNC_BUF_NUMBER 32 +#define DEFAULT_BUF_LENGTH (16 * 16384) +#define MINIMAL_BUF_LENGTH 512 +#define MAXIMAL_BUF_LENGTH (256 * 16384) + +#define MHZ(x) ((x)*1000*1000) + +static int do_exit = 0; +static rtlsdr_dev_t *dev = NULL; + +void usage(void) +{ + #ifdef _WIN32 + fprintf(stderr,"rtl-sdr, an I/Q recorder for RTL2832 based USB-sticks\n\n" + "Usage:\t rtl-sdr-win.exe [device_index] [samplerate in kHz] " + "[gain] [frequency in Hz] [filename]\n"); + #else + fprintf(stderr, + "rtl_test, librtlsdr test tool\n\n" + "Usage:\n" + "\t[-s samplerate (default: 2048000 Hz)]\n" + "\t[-d device_index (default: 0)]\n" + "\t[-t enable Elonics E4000 tuner benchmark]\n" + "\t[-b output_block_size (default: 16 * 16384)]\n" + "\t[-S force sync output (default: async)]\n"); + #endif + exit(1); +} + +#ifdef _WIN32 +BOOL WINAPI +sighandler(int signum) +{ + if (CTRL_C_EVENT == signum) { + fprintf(stderr, "Signal caught, exiting!\n"); + do_exit = 1; + rtlsdr_cancel_async(dev); + return TRUE; + } + return FALSE; +} +#else +static void sighandler(int signum) +{ + fprintf(stderr, "Signal caught, exiting!\n"); + do_exit = 1; + rtlsdr_cancel_async(dev); +} +#endif + +uint8_t bcnt, uninit = 1; + +static void rtlsdr_callback(unsigned char *buf, uint32_t len, void *ctx) +{ + uint32_t i, lost = 0; + + if (uninit) { + bcnt = buf[0]; + uninit = 0; + } + + for (i = 0; i < len; i++) { + if(bcnt != buf[i]) { + lost += (buf[i] > bcnt) ? (buf[i] - bcnt) : (bcnt - buf[i]); + bcnt = buf[i]; + } + + bcnt++; + } + + if (lost) + printf("lost at least %d bytes\n", lost); +} + +void e4k_benchmark(void) +{ + uint32_t freq, gap_start = 0, gap_end = 0; + uint32_t range_start = 0, range_end = 0; + + fprintf(stderr, "Benchmarking E4000 PLL...\n"); + + /* find tuner range start */ + for (freq = MHZ(70); freq > MHZ(1); freq -= MHZ(1)) { + if (rtlsdr_set_center_freq(dev, freq) < 0) { + range_start = freq; + break; + } + } + + /* find tuner range end */ + for (freq = MHZ(2000); freq < MHZ(2300UL); freq += MHZ(1)) { + if (rtlsdr_set_center_freq(dev, freq) < 0) { + range_end = freq; + break; + } + } + + /* find start of L-band gap */ + for (freq = MHZ(1000); freq < MHZ(1300); freq += MHZ(1)) { + if (rtlsdr_set_center_freq(dev, freq) < 0) { + gap_start = freq; + break; + } + } + + /* find end of L-band gap */ + for (freq = MHZ(1300); freq > MHZ(1000); freq -= MHZ(1)) { + if (rtlsdr_set_center_freq(dev, freq) < 0) { + gap_end = freq; + break; + } + } + + fprintf(stderr, "E4K range: %i to %i MHz\n", + range_start/MHZ(1) + 1, range_end/MHZ(1) - 1); + + fprintf(stderr, "E4K L-band gap: %i to %i MHz\n", + gap_start/MHZ(1), gap_end/MHZ(1)); +} + +int main(int argc, char **argv) +{ +#ifndef _WIN32 + struct sigaction sigact; +#endif + int n_read; + int r, opt; + int i, tuner_benchmark = 0; + int sync_mode = 0; + uint8_t *buffer; + uint32_t dev_index = 0; + uint32_t samp_rate = DEFAULT_SAMPLE_RATE; + uint32_t out_block_size = DEFAULT_BUF_LENGTH; + int device_count; + +#ifndef _WIN32 + while ((opt = getopt(argc, argv, "d:s:b:tS::")) != -1) { + switch (opt) { + case 'd': + dev_index = atoi(optarg); + break; + case 's': + samp_rate = (uint32_t)atof(optarg); + break; + case 'b': + out_block_size = (uint32_t)atof(optarg); + break; + case 't': + tuner_benchmark = 1; + break; + case 'S': + sync_mode = 1; + break; + default: + usage(); + break; + } + } + +#else +/* TODO fix win usage */ + if (argc < 2) + usage(); + dev_index = atoi(argv[1]); + samp_rate = atoi(argv[2])*1000; +#endif + if(out_block_size < MINIMAL_BUF_LENGTH || + out_block_size > MAXIMAL_BUF_LENGTH ){ + fprintf(stderr, + "Output block size wrong value, falling back to default\n"); + fprintf(stderr, + "Minimal length: %u\n", MINIMAL_BUF_LENGTH); + fprintf(stderr, + "Maximal length: %u\n", MAXIMAL_BUF_LENGTH); + out_block_size = DEFAULT_BUF_LENGTH; + } + + buffer = malloc(out_block_size * sizeof(uint8_t)); + + device_count = rtlsdr_get_device_count(); + if (!device_count) { + fprintf(stderr, "No supported devices found.\n"); + exit(1); + } + + fprintf(stderr, "Found %d device(s):\n", device_count); + for (i = 0; i < device_count; i++) + fprintf(stderr, " %d: %s\n", i, rtlsdr_get_device_name(i)); + fprintf(stderr, "\n"); + + fprintf(stderr, "Using device %d: %s\n", + dev_index, + rtlsdr_get_device_name(dev_index)); + + r = rtlsdr_open(&dev, dev_index); + if (r < 0) { + fprintf(stderr, "Failed to open rtlsdr device #%d.\n", dev_index); + exit(1); + } +#ifndef _WIN32 + sigact.sa_handler = sighandler; + sigemptyset(&sigact.sa_mask); + sigact.sa_flags = 0; + sigaction(SIGINT, &sigact, NULL); + sigaction(SIGTERM, &sigact, NULL); + sigaction(SIGQUIT, &sigact, NULL); + sigaction(SIGPIPE, &sigact, NULL); +#else + SetConsoleCtrlHandler( (PHANDLER_ROUTINE) sighandler, TRUE ); +#endif + /* Set the sample rate */ + r = rtlsdr_set_sample_rate(dev, samp_rate); + if (r < 0) + fprintf(stderr, "WARNING: Failed to set sample rate.\n"); + + if (tuner_benchmark) { + e4k_benchmark(); + goto exit; + } + + /* Enable test mode */ + r = rtlsdr_set_testmode(dev, 1); + + /* Reset endpoint before we start reading from it (mandatory) */ + r = rtlsdr_reset_buffer(dev); + if (r < 0) + fprintf(stderr, "WARNING: Failed to reset buffers.\n"); + + if (sync_mode) { + fprintf(stderr, "Reading samples in sync mode...\n"); + while (!do_exit) { + r = rtlsdr_read_sync(dev, buffer, out_block_size, &n_read); + if (r < 0) { + fprintf(stderr, "WARNING: sync read failed.\n"); + break; + } + + if ((uint32_t)n_read < out_block_size) { + fprintf(stderr, "Short read, samples lost, exiting!\n"); + break; + } + } + } else { + fprintf(stderr, "Reading samples in async mode...\n"); + r = rtlsdr_read_async(dev, rtlsdr_callback, NULL, + DEFAULT_ASYNC_BUF_NUMBER, out_block_size); + } + + if (do_exit) + fprintf(stderr, "\nUser cancel, exiting...\n"); + else + fprintf(stderr, "\nLibrary error %d, exiting...\n", r); + +exit: + rtlsdr_close(dev); + free (buffer); +out: + return r >= 0 ? r : -r; +}