Difference between revisions of "N300/N310 Getting Started Guides"

From Ettus Knowledge Base
Jump to: navigation, search
Line 1: Line 1:
== Device Overview ==
+
==Kit Contents==
The USRP N310 is a networked software defined radio that provides reliability and fault-tolerance for deployment in large scale and distributed wireless systems. This device simplifies control and management of a network of radios by introducing the unique capability to remotely perform tasks such as debugging, updating software, rebooting, factory resetting, self-testing, and monitoring system health. The USRP N310 is an all-in-one device that includes two AD9371 transceivers, the Zynq-7100 SoC baseband processor, two SFP+ ports, a built-in GPSDO module, and various other peripheral and synchronization features. 
+
 
+
== Key Features==
+
 
===N310===
 
===N310===
 
{|
 
{|
 
|style="vertical-align:top"|
 
|style="vertical-align:top"|
* Xilinx Xilinx Zynq-7100 FPGA SoC
+
* USRP N300/N310
* Dual-core ARM A9 866 MHz CPU
+
* DC Power Supply (12V, 7A)
* 4 RX, 4TX in half-wide RU form factor
+
* 1 RJ45 – SFP+ Adapter
* 10 MHz 6 GHz extended frequency range
+
* 1 Gigabit Ethernet Cat-5e Cable (3m)
* Up to 100 MHz of instantaneous bandwidth per channel
+
* USB-A to Micro USB-B Cable (1m)
* RX, TX filter bank
+
* Getting Started Guide
* 16 bit ADC, 14 bit DAC
+
* Ettus Research Sticker
* Configurable sample rates: 122.88, 125, and 153.6 MS/s
+
|[[File:n310 kit.png|700px|center]]
* Two SFP+ ports (1 GbE, 10 GbE, Aurora)
+
* RJ45 (1 GbE) 
+
* 10 MHz clock reference 
+
* PPS time reference
+
* External RX, TX LO input ports
+
* Built-in GPSDO 
+
* 1 Type A USB host port 
+
* 1 micro-USB port (serial console, JTAG) 
+
* Trusted Platform Module v1.2
+
* Watchdog timer 
+
* OpenEmbedded Linux
+
* High channel density
+
* Reliable and fault-tolerant deployment
+
* Remote management capability
+
* Stand-alone operation
+
 
+
|[[File:n310 kit.png|700px|center]]  
+
 
|}
 
|}
  
==RF Specifications==
+
==Verify the Contents of Your Kit==
===Transmitter===
+
Ensure that your kit contains all the items listed above. If any items are missing, please contact sales@ettus.com​ immediately.
* Number of channels: 4
+
* Frequency Range: 10 MHz to 6 GHz
+
* Maximum instantaneous bandwidth: 100 MHz
+
* Minimum frequency step
+
** 7.32 Hz @ 122.88 MHz sample rate
+
** 7.45 Hz @ 125 MHz sample rate
+
** 9.15 Hz @ 153.6 MHz sample rate
+
  
* Maximum output power (P​ out​ ): See Table 1
+
==You Will Need==
* Gain range
+
* For Network Mode: A host computer with an available 1 or 10 Gigabit Ethernet interface for sample streaming.
** -30 dB to 25 dB (10 MHz to 300 MHz)
+
* For Stand-Alone Embedded Mode: A host computer with an available 1 Gigabit Ethernet port or a USB 2.0 port to remotely access the embedded Linux operating system running on ARM CPU.
** -30 dB to 20 dB (300 MHz to 6 GHz)
+
  
* Gain step: 1 dB
+
==Proper Care and Handling==
* Supported I/Q sample rates:
+
All Ettus Research products are individually tested before shipment. The USRP is guaranteed to be functional at the time it is received by the customer. Improper use or handling of the USRP can cause the device to become non-functional. Take the following precautions to prevent damage to the unit.
** 122.88 MHz, 125 MHz, 153.6 MHz
+
  
* Spurious-free dynamic range (SFDR) > 50 dBc
+
* Never allow metal objects to touch the circuit board while powered.
* Output third-order intercept (OIP3) See Table 2
+
* Always properly terminate the transmit port with an antenna or 50Ω load.
 +
* Always handle the board with proper anti-static methods.
 +
* Never allow the board to directly or indirectly come into contact with any voltage spikes.
 +
* Never allow any water or condensing moisture to come into contact with the device.
 +
* Always use caution with FPGA, firmware, or software modifications.
  
 
+
{|
{| class="wikitable" style="width:80%"
+
|style="padding-left:10px; padding-right:10px; padding-bottom:10px;" |[[File:Caution.png|24px|center]]
! Frequency
+
|style="padding-left:10px; padding-right:10px; padding-bottom:10px;" |Never apply more than -15 dBm of power into any RF input.
! Maximum Output Power
+
 
|-
 
|-
 
+
|style="padding-left:10px; padding-right:10px; padding-bottom:10px;" |[[File:Caution.png|24px|center]]
| 10 MHz to 500 MHz
+
|style="padding-left:10px; padding-right:10px; padding-bottom:10px;" |Always use at least 30dB attenuation if operating in loopback configuration
| +16 dBm
+
 
|-
 
|-
 
| > 500 MHz to 1 GHz
 
| +18 dBm
 
|-
 
 
| > 1 GHz to 4 GHz
 
| +18 dBm
 
|-
 
 
| > 4 GHz to 6 GHz
 
| +12 dBm
 
|-
 
 
 
 
|}
 
|}
Table 1: Maximum Output Power
 
  
{| class="wikitable" style="width:80%"
+
==Install and Setup the Software Tools on Your Host Computer==
! Frequency
+
In order to use your Universal Software Radio Peripheral (USRP™), you must have the software tools correctly installed and configured on your host computer. A step-by-step guide for doing this is available at the Building and Installing the USRP Open-Source Toolchain (UHD and GNU Radio) on [[Building and Installing the USRP Open-Source Toolchain (UHD and GNU Radio) on Linux|Linux]], [[Building and Installing the USRP Open-Source Toolchain (UHD and GNU Radio) on OS X|OS X]] and [[Building and Installing the USRP Open Source Toolchain (UHD and GNU Radio) on Windows|Windows]] Application Notes. See the [[N300/N310|Hardware Specifications]] section of the USRP N300 Series Hardware Resources page for additional details on which version of the USRP Hardware Driver, UHD, is required. It is recommended to use the latest stable version of UHD that is available.
! Output Third-Order Intercept (IP3)
+
|-
+
  
| 10 MHz to 2 GHz
+
If you have a USB stick with the [[Live SDR Environment]] installed on it, then you may boot your host computer from that. The LiveUSB SDR Environment does not require anything to be installed on your host computer, and contains a Linux-based environment with the UHD software and the GNU Radio framework already installed. More information about the [[Live SDR Environment]] is available at the [[Live SDR Environment Getting Started Guides]] page.
| > 30 dBm
+
|-
+
  
| > 2 GHz to 4 GHz
+
The USRP N300/N310 requires UHD version 3.11.0.0 or later. Ettus recommends using the latest stable version of UHD. Please consult the UHD Manual at ​[http://uhd.ettus.com​|http://uhd.ettus.com​] for more details on device-specific software features.
| > 20 dBm
+
|-
+
  
| > 4 GHz to 6 GHz
+
==Connecting the Device==
| > 10 dBm
+
|-
+
  
|}
+
===Powering on for the First Time===
Table 2: Third-Order Intercept (IP3)
+
  
 +
You can connect the device to your host computer in the following ways:
 +
* Using the on-board serial-to-USB connector.
 +
* Using the RJ-45 Ethernet port and an SSH client on your host computer.
  
===Receiver===
+
To power on the device for the first time, connect the host computer to the device using the USB cable. This setup allows you to review and modify the network configuration of the device and interact with the bootloader in case of problems during the boot process.
* Number of channels: 4
+
* Frequency Range: 10 MHz to 6 GHz
+
* Maximum instantaneous bandwidth: 100 MHz
+
* Minimum frequency step
+
** 7.32 Hz @ 122.88 MHz sample rate
+
** 7.45 Hz @ 125 MHz sample rate
+
** 9.15 Hz @ 153.6 MHz sample rate
+
  
* Gain step: 1
+
==Setting up a Serial Connection==
* Maximum recommended input power (P​ in​ ) 1 dB: -15 dBm
+
On a Linux or macOS system, the serial connection can be established using a terminal emulator such as screen​, as shown below:
  
* Noise figure: > 50 dBc
+
    sudo screen /dev/ttyUSB0 115200
* Spurious-free dynamic range (SFDR) See Table 3
+
  
* Third-order intermodulation distortion (IMD3) See Table 4
+
The exact device node ​<code>/dev/ttyUSB0</code>​ depends on your operating system's driver and which other USB devices are already connected. It can usually be found by looking through the output of ​<code>dmesg</code>​ or <code>journalctl</code>​ after connecting the device to your host computer. A​ ​<code>dmesg</code>​ output for the serial-to-USB converter could appear as follows:
  
* Supported I/Q sample rates
+
    [924.102764] usb 1-1: FTDI USB Serial Device converter now attached to ttyUSB0
**122.88 MHz, 125 MHz, 153.6 MHz
+
  
 +
On Microsoft Windows, the serial connection can be established using a tool such as ​Putty​.
  
 +
Select a baud rate of ​<code>115200​</code> and the corresponding serial port for the serial-to-USB converter.
  
{| class="wikitable" style="width:80%"
+
Boot messages will appear and update rapidly after you power on the device. Once the boot process successfully completes, a login prompt like the following should appear:
! Frequency
+
! RX2 Noise Figure
+
! TX/RX Noise Figure
+
|-
+
  
|1.8 GHz
+
    ni-3xx-<motherboard serial #>:
|5.8 dB
+
|6.8 dB
+
|-
+
  
|2.4 GHz to 2.6 GHz
+
Enter the username ​<code>root</code>​ and leave the password field blank.
|6.5 dB
+
|7.5 dB
+
|-
+
  
|3.3 GHz to 4.8 GHz
+
You should be presented with a shell like the following:
|5.5 dB
+
|6.0 dB
+
|-
+
  
|5.0 GHz to 5.8 GHz
+
    root@ni-n3xx-<motherboard serial #>:~#
|7.0 dB
+
|7.5 dB
+
|-
+
  
|}
+
==Configuring an SSH Connection==
Table 3: Noise Figure
+
The device relies on the DHCP protocol to automatically obtain an IP address when connected over the RJ45 1 Gigabit Ethernet port. If your network setup does not include a DHCP server, refer to the ​<code>Serial Connection</code>​ section above or configure a DHCP server on the network to provide an IP address to the device.
  
 +
After the device has obtained an IP address, you can remotely log into it from a Linux or macOS system with SSH, as shown below:
  
 +
    $ ssh root@192.168.10.2
  
{| class="wikitable" style="width:80%"
+
NOTE: The IP address may vary depending on your network setup.
!Frequency
+
!RX IMD3
+
|-
+
  
|0.5 GHz to 3 GHz
+
On Microsoft Windows, the connection can be established using ​Putty​. Enter the IP address of the device and the username ​<code>root</code>. The password field should be left blank.
|< -80 dBc
+
|-
+
  
|> 3 GHz to 4 GHz
+
You should be presented with a shell like the following:
|< -74 dBc
+
|-
+
  
|> 4 GHz to 6 GHz
+
    root@nni-n3xx-<motherboard serial #>:~#
|< -81 dBc
+
|-
+
  
|}
+
Find more details on network configuration here: https://files.ettus.com/manual/page_usrp_n3xx.html#n3xx_network_configuration
Table 4: RX Third-Order Intermodulation Distortion (IMD3)
+
* Noise figure is measured at maximum gain state on receiver signal path.
+
  
 +
==Setting Up a Streaming Connection==
  
===Onboard DRAM===
+
The device supports multiple, high-speed, low-latency interfaces on the SFP+ ports for streaming samples to the host computer. Complete the steps below to set up a streaming connection over the 1 Gigabit Ethernet interface on the SFP+ port.
* DDR3 Memory size
+
** 2,048 MB (PL)
+
** 1,024 MB (PS)
+
  
 +
1. Configure your Host's Ethernet adapter as shown below:
  
==Power==
+
    IP Address: 192.168.10.1
You must use either the Level VI Efficiency power supply provided in the shipping kit, or another UL listed ITE power supply marked ​<code>LPS</code>, with the USRP N310.
+
    Subnet Mask: 255.255.255.0
 +
    Gateway: 0.0.0.0
  
* Input voltage: 12 VDC
+
2. Insert the ​ RJ45 – SFP+ adapter ​into​ <code>SFP Port 0</code>​ .
* Input current:  7.0 A, maximum
+
* Typical power consumption: 50 W to 80 W, varies by application
+
  
==Hardware Specifications==
+
3. Connect the adapter to a host computer using the Ethernet cable.
* Ettus Research recommends to always use the latest stable version of UHD
+
* If you need to clean the module, wipe it with a dry towel.
+
  
===N310===
+
The ​ Green LED​ above ​<code>SFP Port 0</code>​ should illuminate.
* Current Hardware Revision: A
+
* Minimum version of UHD required: 3.11.0.0
+
  
==Physical Specifications==
+
4. To test the connection,​ ​<code>ping</code>​ the device at address <code>192.168.10.2​</code> from the host, as shown
 +
below:
  
===Dimensions===
+
    $ ping 192.168.10.2
====(L × W × H)====
+
* 35.71 cm × 21.11 cm × 4.37 cm
+
* 14.06 in. × 8.31 in. × 1.72 in.
+
  
===Weight===
+
For more details on Network Setup and Configuration, please see the “Interfaces and Connectivity” section on the N300/N310 hardware resources page located within the Ettus Research Knowledge Base at ​https://kb.ettus.com/N300/N310​ .
* 3.13 kg
+
  
==Environmental Specifications==
+
==Verifying Device Operation==
===Operating Temperature Range===
+
Once the UHD driver is installed on the host computer, verify the correct operation of the device by running the various utility programs included in the driver. Refer to the Application Note [[Verifying the Operation of the USRP Using UHD and GNU Radio]].
* N310: 0 to 50 °C
+
  
===Storage Temperature Range===
+
==Upgrading to 10 Gigabit Ethernet==
* N310: -40 to 70 °C
+
The device also supports dual 10 Gigabit Ethernet connections. To use these interfaces, we recommend our 10 Gigabit Ethernet Connectivity kit. For more information on this accessory, visit https://www.ettus.com/product/details/10GIGE-KIT​. For more information on using the 10 Gigabit Ethernet interface, refer to [[N300/N310]] Hardware Resources Page.
  
===Operating Humidity Range===
+
==Updating the Filesystem==
* 10% to 90% non-condensing
+
Before operating the device, reimage the microSD card with the latest version of Embedded Linux
 +
Filesystem and the FPGA image. For a detailed step-by-step guide to updating the File System and FPGA
 +
image, refer to [[N300/N310]] Hardware Resources Page.
  
==Schematics==
+
==Turning the Device Off/On==
===N310===
+
To avoid damaging the file system and causing any corruption, do not turn the device off with the power button without first shutting down the system. Use this command to cleanly and properly shut the system down:
[http://files.ettus.com/schematics/N300/N310.pdf N310 Schematics]
+
  
==GPSDO==
+
    shutdown ­-h now
* Support GPSDO NMEA Strings
+
  
===Sensors===
+
==Network Connectivity==
You can query the lock status with the <code>gps_locked</code> sensor, as well as obtain raw NMEA sentences using the <code>gps_gprmc</code>, and <code>gps_gpgga</code> sensors. Location information can be parsed out of the <code>gps_gpgga</code> sensor by using <code>gpsd</code> or another NMEA parser.
+
By default, the N310 USRP will be configured as a DHCP client on the 1 Gigabit Ethernet port. Assuming your network resolves hostnames (depends on your routers / switches), if you connect the device to your network, you should see it appear with the hostname <code><nowiki>ni-n3xx-<motherboard serial #></nowiki></code>.​ You can then access the device over SSH.
  
==FPGA==
+
If the hostname does not resolve, you can discover the IP address by logging into the device over the serial connection, or checking your network’s DHCP tables.
===FPGA User Modifications===
+
The Verilog code for the FPGA in the USRP N300/N310 is open-source, and users are free to modify and customize it for their needs. However, certain modifications may result in either bricking the device, or even in physical damage to the unit. Specifically, changing the I/O interface of the FPGA in any way, or modifying the pin and timing constraint files, could result in physical damage to other components on the motherboard, external to the FPGA, and doing this will void the warranty. Also, even if the PCIe interface is not being used, you cannot remove or reassign these pins in the constraint file. The constraint files should not be modified. Please note that modifications to the FPGA are made at the risk of the user, and may not be covered by the warranty of the device.
+
  
==Interfaces and Connectivity==
+
Once you have logged in to the device, you can reconfigure the network settings (e.g., you could configure it for a static IP address, if you wish).
Follow the links below for additional information on configuring each interface for the USRP N300 or N310 SDRs.
+
 
+
* 100 MS/s Full Duplex @ 16-bit
+
 
+
===Front Panel===
+
{|
+
| style="width:50%" |
+
 
+
* '''PWR''': Power switch
+
 
+
* '''RF 0 Group'''
+
** '''TX/RX SMA/LED''': RF Input Port / Indicates that data is streaming on the TX/RX channel on daughterboard 0, channel 0
+
** '''RX2 SMA/LED''': RF Input Port / Indicates that data is streaming on the RX2 channel on daughterboard 0, channel 0
+
 
+
* '''RF 1 Group'''
+
** '''TX/RX SMA/LED''': RF Input Port / Indicates that data is streaming on the TX/RX channel on daughterboard 0, channel 1
+
** '''RX2 SMA/LED''': RF Input Port / Indicates that data is streaming on the RX2 channel on daughterboard 0, channel 1
+
 
+
* '''RF 2 Group'''
+
** '''TX/RX SMA/LED''': RF Input Port / Indicates that data is streaming on the TX/RX channel on daughterboard 1, channel 0
+
** '''RX2 SMA/LED''': RF Input Port / Indicates that data is streaming on the RX2 channel on daughterboard 1, channel 0
+
 
+
* '''RF 3 Group'''
+
** '''TX/RX SMA/LED''': RF Input Port / Indicates that data is streaming on the TX/RX channel on daughterboard 1, channel 1
+
** '''RX2 SMA/LED''': RF Input Port / Indicates that data is streaming on the RX2 channel on daughterboard 1, channel 1
+
 
+
* '''LO IN 0/1'''
+
** '''TX''': Input port for TX LO of Daughterboard 0
+
** '''RX''': Input port for RX LO of Daughterboard 0
+
 
+
* '''LO IN 2/3'''
+
** '''TX''': Input port for TX LO of Daughterboard 1
+
** '''RX''': Input port for RX LO of Daughterboard 1
+
 
+
* '''GPIO'''
+
** '''GPIO''': DB15 GPIO Interface. Additional details below.
+
 
+
 
+
| style="vertical-align:top" | [[File:n310 front.png|700px]]
+
|}
+
 
+
===Rear Panel===
+
{|
+
| style="width:50%" |
+
* '''GPS ANT''': Connection for the GPS antenna
+
* '''REF IN''': Reference clock input
+
* '''PPS/TRIG IN''': Input port for the PPS signal
+
* '''TRIG OUT''': Output port for the exported reference clock
+
* '''PWR''': Connector for the USRP N310 Series power supply
+
 
+
* '''RESET''': Input button to reset device
+
 
+
* '''MicroSD''': MicroSD Card for OE Linux File System
+
* '''JTAG''': Micro USB connector for the on-board USB-JTAG programmer
+
* '''USB 2.0''': Host USB connector to ARM CPU
+
* '''SFP+''': 1/10Gb SFP+ ports for Ethernet interfaces
+
 
+
* '''10/1000/1000''': 10/100/1000 Mb Ethernet interface to ARM CPU
+
 
+
| style="vertical-align:top" | [[File:n310 back.png|700px]]
+
|}
+
 
+
===Ref Clock - 10 MHz===
+
Using an external 10 MHz reference clock, a square wave will offer the best phase noise performance, but a sinusoid is acceptable. The power level of the reference clock cannot exceed +10 dBm.
+
 
+
===PPS - Pulse Per Second===
+
Using a PPS signal for timestamp synchronization requires a square wave signal with the following a 5Vpp amplitude.
+
 
+
To test the PPS input, you can use the following tool from the UHD examples:
+
 
+
* <code><args></code> are device address arguments (optional if only one USRP device is on your machine)
+
 
+
    cd <install-path>/lib/uhd/examples ./test_pps_input –args=<args>
+
 
+
 
+
===Front Panel GPIO===
+
{|
+
| style="width:50%" |
+
The GPIO port is not meant to drive big loads. You should not try to source more than 5mA per pin.
+
 
+
The +3.3V is for ESD clamping purposes only and not designed to deliver high currents.
+
 
+
|}
+
  
 +
==Logging In==
 +
When you first log in to the device, the user is ‘root’ and the password is empty (no password).
  
====Power on state====
+
==Example Programs==
The hardware power on state and UHD initial state for the front-panel GPIOs is high-Z. For the N310, there are no external pull-ups/pull-downs for the GPIO pins, but the FPGAs do have them and they are configured as follows: N310: pull-down.
+
The UHD driver includes several example programs, which may serve as test programs or the basis for your application program. These example programs are already installed on the N300/N310 USRP, and the source code can be obtained from the UHD repository on GitHub at: https://github.com/EttusResearch/uhd/tree/master/host/examples
  
====Pin Mapping====
+
==Test and Verify the Operation of the USRP==
* Pin 1: +3.3V
+
You can quickly verify the operation of your USRP N300/N310 by running the <code>rx_ascii_art_dft</code> UHD example program.
* Pin 2: Data[0]
+
The <code>rx_ascii_art_dft</code> utility is a simple console ­based, real­time FFT display tool. It is not graphical in nature, so it can be easily run over an SSH connection within a terminal window, and does not need any graphical capability, such as X Windows, to be installed. It can also be run over a serial console connection, although this is not recommended, as the formatting may not render correctly.
* Pin 3: Data[1]
+
* Pin 4: Data[2]
+
* Pin 5: Data[3]
+
* Pin 6: Data[4]
+
* Pin 7: Data[5]
+
* Pin 8: Data[6]
+
* Pin 9: Data[7]
+
* Pin 10: Data[8]
+
* Pin 11: Data[9]
+
* Pin 12: Data[10]
+
* Pin 13: Data[11]
+
* Pin 14: 0V
+
* Pin 15: 0V
+
  
'''Note''': Please see the [http://files.ettus.com/manual/page_gpio_api.html E3x0/X3x0/N3x0 GPIO API] for information on configuring and using the GPIO bus.
+
You can run a simple test of the N300/N310 USRP by connecting an antenna and observing the spectrum of a commercial FM radio station in real­time. Please follow the steps listed below.
  
==Certifications==
+
1. Attach an antenna to the RX2­ antenna port of the N310.
===RoHS===
+
As of December 1st, 2010 all Ettus Research products are RoHS compliant unless otherwise noted. More information can be found at [http://ettus.com/legal/rohs-information http://ettus.com/legal/rohs-information]
+
  
===China RoHS===
+
2. Log into the N310 from an external host computer over Ethernet using an SSH client.
'''Management Methods for Controlling Pollution Caused by Electronic Information Products Regulation'''
+
  
'''Chinese Customers'''
+
3. At a terminal prompt running on the N310, run:
  
National Instruments is in compliance with the Chinese policy on the Restriction of Hazardous Substances (RoHS) used in Electronic Information Products. For more information about the National Instruments China RoHS compliance, visit [http://www.ni.com/environment/rohs_china ni.com/environment/rohs_china].
+
    /usr/lib/uhd/examples/rx_ascii_art_dft ­­--freq 88.1e6 ­­--rate 400e3 ­­--gain 30 ­­--ref­-lvl ­-30
  
==Downloads==
+
4. Modify the command­line argument <code>freq</code> ​above to specify a tuning frequency for a strong local FM radio station.
[http://files.ettus.com/manual/md_fpga.html FPGA Resources]
+
  
[http://files.ettus.com/binaries/uhd_stable/ UHD Stable Binaries]
+
5. You should see a real­time FFT display of 400 KHz of spectrum, centered at the specified tuning frequency.
  
[https://github.com/EttusResearch/uhd UHD Source Code on Github]
+
6. Type "<code>Q</code>" or <code>Ctrl­-C</code> to stop the program and to return to the Linux command line.
  
==Choosing a Host Interface==
+
7. You can adjust the size of your terminal window and then re­run the command to enlarge or shrink the FFT display.
  
===10 Gigabit Ethernet===
+
8. You can run with the "​­­help"​option to see a description of all available command­line options.
'''Recommended 10 Gigabit Ethernet Cards'''
+
* Intel X520-DA2 - Previous generation PCIe Gen 2 adapter. Mature and stable 10GbE adapter, works out-of-the-box with Ubuntu 14.04 LTS and 16.04 LTS
+
** [http://ark.intel.com/products/39776/Intel-Ethernet-Converged-Network-Adapter-X520-DA2 Intel® Ethernet Converged Network Adapter X520-DA2]
+
* Intel X520-DA1 - Previous generation PCIe Gen 2 adapter  Mature and stable 10GbE adapter, works out-of-the-box with Ubuntu 14.04 LTS and 16.04 LTS
+
** [http://ark.intel.com/products/68669/Intel-Ethernet-Converged-Network-Adapter-X520-DA1 Intel® Ethernet Converged Network Adapter X520-DA1 ]
+
* Intel X710-DA2 - New PCIe Gen 3 adapter
+
** [http://ark.intel.com/products/83964/Intel-Ethernet-Converged-Network-Adapter-X710-DA2 Intel® Ethernet Converged Network Adapter X710-DA2 ]
+
* Intel X710-DA4 - New PCIe Gen 3 adapter
+
** [http://ark.intel.com/products/83965/Intel-Ethernet-Converged-Network-Adapter-X710-DA4 Intel® Ethernet Converged Network Adapter X710-DA4 ]
+
  
'''Additional Links and Resources for Intel 10GbE adapters'''
+
Additional information is available at the [[Verifying the Operation of the USRP Using UHD and GNU Radio]] Application Note.
* [http://ark.intel.com/compare/39776,83964,83965 Compare Intel® Products]
+
  
==International Power Supply Options==
+
==Technical Support and Community Knowledge Base==
The power supply provided with the USRP N310 kit is packaged with a power cord that is compatible with power outlets in the US/Japan. If you are not using the USRP N310 in the US/Japan, we recommend purchasing the International USRP N310 Power Cord set.
+
Technical support for USRP hardware is available through email only. If the product arrived in a non­functional state or you require technical assistance, please contact [mailto:support@ettus.com support@ettus.com]. Please allow 24 to 48 hours for response by email, depending on holidays and weekends, although we are often able to reply more quickly than that.
  
 +
We also recommend that you subscribe to the community mailing lists. The mailing lists have a responsive and knowledgeable community of hundreds of developers and technical users who are located around the world. When you join the community, you will be connected to this group of people who can help you learn about SDR and respond to your technical and specific questions. Often your question can be answered quickly on the mailing lists. Each mailing list also provides an archive of all past conversations and discussions going back many years. Your question or problem may have already been addressed before, and a relevant or helpful solution may already exist in the archive.
  
==Guidance on SFP+ Adapters for Fiber Connectivity on USRP N310==
+
Discussions involving the USRP hardware and the UHD software itself are best addressed through the '''u​srp­-users''' ​mailing list at [http://usrp-users.ettus.com http://usrp-users.ettus.com].
  
Ettus Research currently offers direct-connect, copper cabling accessories for the USRP N310. However, it is also possible to use multi-mode fiber instead of copper connections for these devices. In this section, we will provide general guidance on the types of fiber adapters and cables that can be used with these products.
+
Discussions involving the use of [http://gnuradio.org/ GNU Radio] with USRP hardware and UHD software are best addressed through the '''d​iscuss­-gnuradio'''​ mailing list at [https://lists.gnu.org/mailman/listinfo/discuss­gnuradio https://lists.gnu.org/mailman/listinfo/discuss­gnuradio]​.
General Guidance on SFP+ Adapters
+
  
The USRP N310 USRP is compatible with most brands of SFP+ fiber adapters. In some cases, other equipment in the systems such as 1/10 Gigabith Ethernet switches are only compatible with specific brands of SFP+ adapters and cables. As a general rule, we recommend checking compatibility with the switches and network cards in your system before purchasing an adapter.
+
Discussions involving the use of [http://openbts.org/ OpenBTS®] with USRP hardware and UHD software are best addressed through the '''o​penbts­-discuss​''' mailing list at [https://lists.sourceforge.net/lists/listinfo/openbts­discuss​ https://lists.sourceforge.net/lists/listinfo/openbts­discuss​].
  
Ettus Research does test the USRP N310 USRP devices with our [https://www.ettus.com/product/details/10GIGE-KIT 10 Gigabit Ethernet Connectivity Kit] and a Blade Networks G8124 1/10 GigE switch. Here are is a list of known-good cables and adapters.
+
The support page on our website is located at [https://www.ettus.com/support https://www.ettus.com/support]​. The Knowledge Base is located at ​[https://kb.ettus.com https://kb.ettus.com]​.
  
Ettus Research has only tested multi-mode fiber accessories.
+
==Legal Considerations==
 +
Every country has laws governing the transmission and reception of radio signals. Users are solely responsible for insuring they use their USRP system in compliance with all applicable laws and regulations. Before attempting to transmit and/or receive on any frequency, we recommend that you determine what licenses may be required and what restrictions may apply.
  
===Known-Good Adapters===
+
*NOTE: This USRP product is a piece of test equipment.
* [http://approvedoptics.com/blade-networks-bn-ckm-sp-sr/ Approved Optics BN-CKM-SP-SR-A]
+
  
===Known-Good Cables===
+
==Sales and Ordering Support==
* [http://www.colfaxdirect.com/store/pc/viewPrd.asp?idproduct=1696 Elpeus 10GbE SFP+ AOC Cable, 3 meters]
+
If you have any non­-technical questions related to your order, then please contact us by email at [mailto:orders@ettus.com orders@ettus.com]​, or by phone at +1­408­610­6399 (Monday-Friday, 8 AM - 5 PM, Pacific Time). Please be sure to include your order number and the serial number of your USRP.
  
 +
==Terms and Conditions of Sale==
 +
Terms and conditions of sale can be accessed online at the following link: http://www.ettus.com/legal/terms-and-conditions-of-sale
  
[[Category:Hardware Resources]]
+
[[Category:Getting Started Guides]]
 +
[[Category:N300]]
 +
[[Category:N310]]

Revision as of 11:44, 1 March 2018

Kit Contents

N310

  • USRP N300/N310
  • DC Power Supply (12V, 7A)
  • 1 RJ45 – SFP+ Adapter
  • 1 Gigabit Ethernet Cat-5e Cable (3m)
  • USB-A to Micro USB-B Cable (1m)
  • Getting Started Guide
  • Ettus Research Sticker
n310 kit.png

Verify the Contents of Your Kit

Ensure that your kit contains all the items listed above. If any items are missing, please contact sales@ettus.com​ immediately.

You Will Need

  • For Network Mode: A host computer with an available 1 or 10 Gigabit Ethernet interface for sample streaming.
  • For Stand-Alone Embedded Mode: A host computer with an available 1 Gigabit Ethernet port or a USB 2.0 port to remotely access the embedded Linux operating system running on ARM CPU.

Proper Care and Handling

All Ettus Research products are individually tested before shipment. The USRP is guaranteed to be functional at the time it is received by the customer. Improper use or handling of the USRP can cause the device to become non-functional. Take the following precautions to prevent damage to the unit.

  • Never allow metal objects to touch the circuit board while powered.
  • Always properly terminate the transmit port with an antenna or 50Ω load.
  • Always handle the board with proper anti-static methods.
  • Never allow the board to directly or indirectly come into contact with any voltage spikes.
  • Never allow any water or condensing moisture to come into contact with the device.
  • Always use caution with FPGA, firmware, or software modifications.
Caution.png
Never apply more than -15 dBm of power into any RF input.
Caution.png
Always use at least 30dB attenuation if operating in loopback configuration

Install and Setup the Software Tools on Your Host Computer

In order to use your Universal Software Radio Peripheral (USRP™), you must have the software tools correctly installed and configured on your host computer. A step-by-step guide for doing this is available at the Building and Installing the USRP Open-Source Toolchain (UHD and GNU Radio) on Linux, OS X and Windows Application Notes. See the Hardware Specifications section of the USRP N300 Series Hardware Resources page for additional details on which version of the USRP Hardware Driver, UHD, is required. It is recommended to use the latest stable version of UHD that is available.

If you have a USB stick with the Live SDR Environment installed on it, then you may boot your host computer from that. The LiveUSB SDR Environment does not require anything to be installed on your host computer, and contains a Linux-based environment with the UHD software and the GNU Radio framework already installed. More information about the Live SDR Environment is available at the Live SDR Environment Getting Started Guides page.

The USRP N300/N310 requires UHD version 3.11.0.0 or later. Ettus recommends using the latest stable version of UHD. Please consult the UHD Manual at ​[1] for more details on device-specific software features.

Connecting the Device

Powering on for the First Time

You can connect the device to your host computer in the following ways:

  • Using the on-board serial-to-USB connector.
  • Using the RJ-45 Ethernet port and an SSH client on your host computer.

To power on the device for the first time, connect the host computer to the device using the USB cable. This setup allows you to review and modify the network configuration of the device and interact with the bootloader in case of problems during the boot process.

Setting up a Serial Connection

On a Linux or macOS system, the serial connection can be established using a terminal emulator such as screen​, as shown below:

   sudo screen /dev/ttyUSB0 115200

The exact device node ​/dev/ttyUSB0​ depends on your operating system's driver and which other USB devices are already connected. It can usually be found by looking through the output of ​dmesg​ or journalctl​ after connecting the device to your host computer. A​ ​dmesg​ output for the serial-to-USB converter could appear as follows:

   [924.102764] usb 1-1: FTDI USB Serial Device converter now attached to ttyUSB0

On Microsoft Windows, the serial connection can be established using a tool such as ​Putty​.

Select a baud rate of ​115200​ and the corresponding serial port for the serial-to-USB converter.

Boot messages will appear and update rapidly after you power on the device. Once the boot process successfully completes, a login prompt like the following should appear:

   ni-3xx-<motherboard serial #>:

Enter the username ​root​ and leave the password field blank.

You should be presented with a shell like the following:

   root@ni-n3xx-<motherboard serial #>:~#

Configuring an SSH Connection

The device relies on the DHCP protocol to automatically obtain an IP address when connected over the RJ45 1 Gigabit Ethernet port. If your network setup does not include a DHCP server, refer to the ​Serial Connection​ section above or configure a DHCP server on the network to provide an IP address to the device.

After the device has obtained an IP address, you can remotely log into it from a Linux or macOS system with SSH, as shown below:

   $ ssh root@192.168.10.2

NOTE: The IP address may vary depending on your network setup.

On Microsoft Windows, the connection can be established using ​Putty​. Enter the IP address of the device and the username ​root. The password field should be left blank.

You should be presented with a shell like the following:

   root@nni-n3xx-<motherboard serial #>:~#

Find more details on network configuration here: https://files.ettus.com/manual/page_usrp_n3xx.html#n3xx_network_configuration

Setting Up a Streaming Connection

The device supports multiple, high-speed, low-latency interfaces on the SFP+ ports for streaming samples to the host computer. Complete the steps below to set up a streaming connection over the 1 Gigabit Ethernet interface on the SFP+ port.

1. Configure your Host's Ethernet adapter as shown below:

   IP Address: 192.168.10.1
   Subnet Mask: 255.255.255.0
   Gateway: 0.0.0.0

2. Insert the ​ RJ45 – SFP+ adapter ​into​ SFP Port 0​ .

3. Connect the adapter to a host computer using the Ethernet cable.

The ​ Green LED​ above ​SFP Port 0​ should illuminate.

4. To test the connection,​ ​ping​ the device at address 192.168.10.2​ from the host, as shown below:

   $ ping 192.168.10.2

For more details on Network Setup and Configuration, please see the “Interfaces and Connectivity” section on the N300/N310 hardware resources page located within the Ettus Research Knowledge Base at ​https://kb.ettus.com/N300/N310​ .

Verifying Device Operation

Once the UHD driver is installed on the host computer, verify the correct operation of the device by running the various utility programs included in the driver. Refer to the Application Note Verifying the Operation of the USRP Using UHD and GNU Radio.

Upgrading to 10 Gigabit Ethernet

The device also supports dual 10 Gigabit Ethernet connections. To use these interfaces, we recommend our 10 Gigabit Ethernet Connectivity kit. For more information on this accessory, visit https://www.ettus.com/product/details/10GIGE-KIT​. For more information on using the 10 Gigabit Ethernet interface, refer to N300/N310 Hardware Resources Page.

Updating the Filesystem

Before operating the device, reimage the microSD card with the latest version of Embedded Linux Filesystem and the FPGA image. For a detailed step-by-step guide to updating the File System and FPGA image, refer to N300/N310 Hardware Resources Page.

Turning the Device Off/On

To avoid damaging the file system and causing any corruption, do not turn the device off with the power button without first shutting down the system. Use this command to cleanly and properly shut the system down:

   shutdown ­-h now

Network Connectivity

By default, the N310 USRP will be configured as a DHCP client on the 1 Gigabit Ethernet port. Assuming your network resolves hostnames (depends on your routers / switches), if you connect the device to your network, you should see it appear with the hostname ni-n3xx-<motherboard serial #>.​ You can then access the device over SSH.

If the hostname does not resolve, you can discover the IP address by logging into the device over the serial connection, or checking your network’s DHCP tables.

Once you have logged in to the device, you can reconfigure the network settings (e.g., you could configure it for a static IP address, if you wish).

Logging In

When you first log in to the device, the user is ‘root’ and the password is empty (no password).

Example Programs

The UHD driver includes several example programs, which may serve as test programs or the basis for your application program. These example programs are already installed on the N300/N310 USRP, and the source code can be obtained from the UHD repository on GitHub at: https://github.com/EttusResearch/uhd/tree/master/host/examples

Test and Verify the Operation of the USRP

You can quickly verify the operation of your USRP N300/N310 by running the rx_ascii_art_dft UHD example program. The rx_ascii_art_dft utility is a simple console ­based, real­time FFT display tool. It is not graphical in nature, so it can be easily run over an SSH connection within a terminal window, and does not need any graphical capability, such as X Windows, to be installed. It can also be run over a serial console connection, although this is not recommended, as the formatting may not render correctly.

You can run a simple test of the N300/N310 USRP by connecting an antenna and observing the spectrum of a commercial FM radio station in real­time. Please follow the steps listed below.

1. Attach an antenna to the RX2­ antenna port of the N310.

2. Log into the N310 from an external host computer over Ethernet using an SSH client.

3. At a terminal prompt running on the N310, run:

   /usr/lib/uhd/examples/rx_ascii_art_dft ­­--freq 88.1e6 ­­--rate 400e3 ­­--gain 30 ­­--ref­-lvl ­-30

4. Modify the command­line argument freq ​above to specify a tuning frequency for a strong local FM radio station.

5. You should see a real­time FFT display of 400 KHz of spectrum, centered at the specified tuning frequency.

6. Type "Q" or Ctrl­-C to stop the program and to return to the Linux command line.

7. You can adjust the size of your terminal window and then re­run the command to enlarge or shrink the FFT display.

8. You can run with the "​­­help"​option to see a description of all available command­line options.

Additional information is available at the Verifying the Operation of the USRP Using UHD and GNU Radio Application Note.

Technical Support and Community Knowledge Base

Technical support for USRP hardware is available through email only. If the product arrived in a non­functional state or you require technical assistance, please contact support@ettus.com. Please allow 24 to 48 hours for response by email, depending on holidays and weekends, although we are often able to reply more quickly than that.

We also recommend that you subscribe to the community mailing lists. The mailing lists have a responsive and knowledgeable community of hundreds of developers and technical users who are located around the world. When you join the community, you will be connected to this group of people who can help you learn about SDR and respond to your technical and specific questions. Often your question can be answered quickly on the mailing lists. Each mailing list also provides an archive of all past conversations and discussions going back many years. Your question or problem may have already been addressed before, and a relevant or helpful solution may already exist in the archive.

Discussions involving the USRP hardware and the UHD software itself are best addressed through the u​srp­-users ​mailing list at http://usrp-users.ettus.com.

Discussions involving the use of GNU Radio with USRP hardware and UHD software are best addressed through the d​iscuss­-gnuradio​ mailing list at https://lists.gnu.org/mailman/listinfo/discuss­gnuradio​.

Discussions involving the use of OpenBTS® with USRP hardware and UHD software are best addressed through the o​penbts­-discuss​ mailing list at https://lists.sourceforge.net/lists/listinfo/openbts­discuss​.​

The support page on our website is located at https://www.ettus.com/support​. The Knowledge Base is located at ​https://kb.ettus.com​.

Legal Considerations

Every country has laws governing the transmission and reception of radio signals. Users are solely responsible for insuring they use their USRP system in compliance with all applicable laws and regulations. Before attempting to transmit and/or receive on any frequency, we recommend that you determine what licenses may be required and what restrictions may apply.

  • NOTE: This USRP product is a piece of test equipment.

Sales and Ordering Support

If you have any non­-technical questions related to your order, then please contact us by email at orders@ettus.com​, or by phone at +1­408­610­6399 (Monday-Friday, 8 AM - 5 PM, Pacific Time). Please be sure to include your order number and the serial number of your USRP.

Terms and Conditions of Sale

Terms and conditions of sale can be accessed online at the following link: http://www.ettus.com/legal/terms-and-conditions-of-sale