A2300GettingStarted

Democratising Wireless Innovation
Revision as of 16:45, 7 November 2014 by AndrewBack (talk | contribs) (Created page with "To get started using the ASR-2300, you will need to download and install the software drivers, examples, and tools from the A2300 Project. The host drivers are tested on Linux...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

To get started using the ASR-2300, you will need to download and install the software drivers, examples, and tools from the A2300 Project. The host drivers are tested on Linux, Mac, and Windows. These instructions are a copy of the documentation located in the GitHub. For the latest updates please see:

https://github.com/myriadrf/A2300/blob/master/GettingStarted.md 

Pre-requisites

The A2300 supports UHD and GnuRadio functions if these capabilities are desired. Please make sure you have downloaded and properly installed the packages on your system. The A2300 cmake checks to see if they are installed and builds the adaptor libraries accordingly.

For native C/C++ development, the A2300 API is available for development with projects for Eclipse and Visual Studio.

Installation Using Git and CMake on LINUX and Apple IOS

Open a Terminal window and Enter the following commands.

git clone https://github.com/myriadrf/A2300.git
cd A2300
mkdir build
cd build
cmake ..

Now build the project and install it.

make
sudo make install

To test that A2300 API and tools were installed correctly. Plug in your device and type the following command.

A2300Identify

To test that the UHD Adaptor was installed correctly. Run the following UHD application.

UHD_MODULE_PATH=./host/lib/UhdAdaptor/libA2300UhdAdapter.dylib uhd_fft --args "type=a2300" -A Wideband -f 890.4M -s 1M --spec "A:0" -g 0 <click "Average"> <click "Autoscale" twice (or as needed)>

Installing ASR-2300 Device Drivers and Access Permissions

See Section 4 in the document “./host/docs/ASR-2300 GNU Software Document.pdf” This contains various procedures for configuring Linux and Windows platforms to communicate with the ASR-2300 via USB interface.

Procedures for Windows and Linux are somewhat different. On Linux platforms, libusb is used, Cypress FX-3 driver is used on Windows platforms.

Building A2300 API and Tools Using Eclipse on Linux

In a terminal, change to a directory that will contain the A2300 code. Download the code:

git clone https://github.com/myriadrf/A2300.git
  1. Run Eclipse and create a workspace in the root <installdir>/A2300. Note this assumes CDT package is installed for C/C++ development.
  2. In the project explorer panel. Right click and select import, select General/Existing Projects into Workspace option and click _next.
  3. Specify the root directory as <installdir>/A2300 or click browse to select the directory.
  4. Select all the projects found and click finish.
  5. Before you can build the files you will need to make sure that <installdir>/A2300/host/include/A2300/libusb_ext.h exists. This can be generated automatically by running cmake in place or you can create the file from the source attached at the end of this document.
  6. There should be at least 7 projects in the explorer tree. Under the project menu, select build all. If UHD was proprely installed, all seven projects should build and link without error.

A2300 Identify, A2300RxToFile, A2300Update Debugger configuration

Environment Variables:

  • LD_LIBRARY_PATH — Define path to A2300USB shared object e.g. /A2300/host/lib/A2300Usb/Debug

uhd_A2300_probe_shared

Environment Variables:

  • LD_LIBRARY_PATH — Define path to UHD if not in standard location.
  • UHD_MODULE_PATH — Define path to A2300 UhdAdaptor shared library e.g. /A2300/host/lib/UhdAdaptor/Debug/libUhdAdaptor.so.

Installing ASR-2300 Windows USB Drivers

  1. Download and unzip the latest Windows USB drivers located in the tools section of the ASR-2300 Support Page.
  2. Start the Windows Device Manager
  3. Plug in the ASR-2300 device and power it on
  4. Look for the unknown device or FX3 device added to the Device Manager.
  5. Right Click on the device and select ‘Update Driver Software’
  6. Select ‘Browse my computer…’ option.
  7. Click ‘Browse’ and locate the particular version of Windows and processing platform (e.g. Win7 X64) in the unzipped driver folders.
  8. Click ‘Next’ and the Device Manager will attempt to install the driver.
  9. Windows will notify you that the driver is not signed. Click ok to proceed.
  10. If it worked, Windows will indicate that it found the ASR-2300 device.

Building the A2300 API and Tools Using Visual Studio

Coming soon.

Non-cmake, Manually Create lisusb_ext.h Source

// Name: UsbDevice.h
//
// Copyright(c) 2013 Loctronix Corporation
// http://www.loctronix.com
//
// 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.

#ifndef LIBUSB_EXT_H_
#define LIBUSB_EXT_H_

// Using libusb on linux/osx (via libusb) and CyAPI on windows
#ifdef  __cplusplus
extern "C" {
#endif
#ifdef HAVE_LIBUSB
#include <libusb-1.0/libusb.h>
#elif defined(WIN32)
#include <Windows.h>
#include <CyAPI.h>
#endif

#ifdef __cplusplus
}
#endif

#endif /* LIBUSB_EXT_H_ */