...
 

003.010.000 Build Notes

Build Date

Built with code downloaded on September 15th, 2016.

Important

UHD.dll and the SDR Console must be built with the same version of:

  • Boost (to avoid differences in structure definitions),
  • C runtime library (must be the same as the C runtime is shared via a Microsoft runtime DLL) so:
    • Version 2 is compiled with VS2010,
    • Version 3 is compiled with VS2013.

CMake Fields

These fields must be defined, it may take up to two Configure runs with CMake before all fields are visible. The stages are:

  • Boost - note using Boost 1.61.
  • LIBUSB - currently using 1.0.19 but 1.0.20 also works
  • UHD_IMAGES_DIR - must be selected so this environment variable can be defined.
Field Value 
Boost_INCLUDE_DIR E:/boost_1_61_0
Boost_LIBRARY_DIR
E:/boost_1_61_0/lib64-msvc-12.0
ENABLE_USB
LIBUSB_INCLUDE_DIRS E:/libusb-1.0.19/include/libusb-1.0
LIBUSB_LIBRARIES E:/libusb-1.0.19/MS64/static/libusb-1.0.lib
UHD_IMAGES_DIR

 

Images

The testing is performed with the images located in the default folder, these must be downloaded and are not shipped with SDR-Radio.com's software (the distribution is far too big). The binary distribution is uhd_003.010.000.000-release/ (16-Aug-2016 19:44). The binary folder is here.

UHD_IMAGES_DIR not yet tested.

Debug Information

Additional Diagnostics are available via DebugView - see V3 Diagnostics. Using the DebugView output is useful should the program crash before you are able to open the logfile.

Two logfiles are available here:

  1. Searching for the B200 from the Radio Definitions window.
  2. Starting the B200. Here the radio is started with a bandwidth of 14MHz, runs for a few seconds and is closed down.

To-Do

  • Modify the UHD.dll project optimisation options for absolute maximum speed.
  • Apply the UHD update (when available) to support up to 61MHz bandwidth from the B200.
Dos and Don'ts

Do

Make sure you have the correct firmware images on your system.

Do Not

Overwrite / replace the UHD.dll file installed by these kits.

 

003.009.002 - March 13th, 2016

Install

Image Files

You must install the firmware images required by hardware such as the B2x0. These are installed using the same release level as the UHD source - in this case 003.009.002 by downloading from the Ettus website.

Notes:

  • Only the FPGA firmware images are required for this software.
  • Install in the default location.
  • It is not (should not be) necessary to add UHD to the PATH.

The software uses the UHD_IMAGES_DIR environment variable if defined, otherwise UHD package path / share / uhd / images, (for more information read paths.hpp in the source code for UHD).

On a Windows 10 64-bit system the firmware images are installed in C:\Program Files\UHD\share\uhd\images


Developer Notes

Introduction

UHD and the console must be built with the same version of:

  • Boost (to avoid differences in structure definitions),
  • C runtime library (must be the same as the C runtime is shared via a DLL).

Build

Instructions: http://files.ettus.com/manual/page_build_guide.html

Boost kits: http://sourceforge.net/projects/boost/files/boost-binaries/1.58.0/

UHD built using:

  • UHD Source 003.009.002
  • Boost 1.58.0

Separate builds for Visual Studio:

  • 2010 
  • 2013

Visual Studio 2010 doesn't compile correctly - Boost_LIBRARY_DIR is ignored, instead select all projects, properties, edit the library paths to include the Boost libraries. Having done this all is OK.

Include Files

The folder host\include\... (include all subfolders) is copied over, version.hpp from host\build\include is also copied into host\include\uhd, version.hpp contains UHD_VERSION_ABI_STRING which is used to print out the version information in the CSDRSourceEttusApp constructor.

 

USB3 Cables

To ensure robust operation of the UHD.dll code you must use very high quality USB3 cables. Using USB3 extension cables seems to affect timing inside UHD.dll resulting in the software crashing with an access violation.

B200/B210

The B200 / B210 boards use the Analog Devices AD9361 RFIC https://www.ettus.com/product/details/UB200-KIT with continuous RF coverage from 70 MHz –6 GHz. This is a very interesting board, especially for satellite use.

September 28th, 2014 A B200 is at my home in Cornwall, works very well.

Drivers

Windows 10

On Windows 10 the B200 was plugged in, using the Device Manager shown as Universal Serial Bus devices\WestBridge. When started for the first time it was updated automatically to show as Universal Serial Bus devices\USRP B200. The same logic applies whenever the B200 is power-cycled.

Other

After plugging your shiny new board into your Windows PC you must run Zadig to install the WinUSB driver for this device (WinUSB already exists on your Windows PC). Zadig is found at http://zadig.akeo.ie/ . Your B200 / B210 must be shown as Westbridge, if not:

  1. Uninstall the device,
  2. Disconnect the device (unplug the USB3 cable),
  3. Shutdown and restart your computer,
  4. Plug the device back in and try again.

GPSDO

If you have a GPSDO connected you must connect an antenna and wait until it has synchronised (green LED next to the GPSDO indicates the fix).

Toshiba USB sleep-&-charge ports

A user - let's call him Mike - had to disable sleep-&-charge on his Toshiba laptop before the B200 could be detected.

http://www.toshiba.com/us/sleep-and-charge