aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--include/rtl-sdr.h10
-rw-r--r--src/CMakeLists.txt7
-rw-r--r--src/Makefile.am5
-rw-r--r--src/librtlsdr.c10
-rw-r--r--src/rtl_test.c292
5 files changed, 322 insertions, 2 deletions
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 <steve@steve-m.de>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#include <errno.h>
+#include <signal.h>
+#include <string.h>
+#include <stdio.h>
+#include <stdlib.h>
+
+#ifndef _WIN32
+#include <unistd.h>
+#else
+#include <Windows.h>
+#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;
+}