Difference between revisions of "X300/X310 Getting Started Guides"

From Ettus Knowledge Base
Jump to: navigation, search
(Kit Contents)
(remove phone number)
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
ADD - https://www.ettus.com/kb/detail/usrp-x300x310-getting-started-guide-1-page
 
 
 
==Kit Contents==
 
==Kit Contents==
 +
 
* USRP X300/X310
 
* USRP X300/X310
 
* 1 Gigabit Ethernet Cable
 
* 1 Gigabit Ethernet Cable
Line 42: Line 41:
  
 
==Install and Setup the Software Tools on Your Host Computer==
 
==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 [[Basic_Installation_Instructions|Basic Installation Instructions]] Application Note. Release 3.8.4 or later of the USRP Hardware Driver, UHD, is required. It is recommended to use the latest stable version of UHD that is available.  
+
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. Release 3.8.4 or later 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 LiveUSB 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 LiveUSB SDR environment is available at the [[Live SDR Environment Getting Started]] page.
+
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.
  
 
==Basic Connectivity==
 
==Basic Connectivity==
Line 55: Line 54:
 
* To test communications, ping the USRP device at address "192.168.10.2"
 
* To test communications, ping the USRP device at address "192.168.10.2"
  
For more detailed on network setup, please see: http://interfaces.ettus.com
+
For more detailed on network setup, please see the section [https://kb.ettus.com/X300/X310#Interfaces_and_Connectivity Interfaces and Connectivity] of the X300/X310 Hardware Resources page. For help troubleshooting connectivity issues with your X3x0 device, see [[Troubleshooting X300/X310 Device Discovery Issues]].
  
 
==Upgrade to 10 Gigabit Ethernet or PCI-Express==
 
==Upgrade to 10 Gigabit Ethernet or PCI-Express==
The USRP X300/X310 also supports 10 Gigabit Ethernet and PCI-Express.  To use these interfaces, we recommend our high-speed interface kits.  For more information about these interface kits, please visit: http://interfaces.ettus.com
+
The USRP X300/X310 also supports 10 Gigabit Ethernet and PCI-Express.  To use these interfaces, we recommend our high-speed interface kits.  For more information about these interface kits, please see the section [https://kb.ettus.com/X300/X310#Interfaces_and_Connectivity Interfaces and Connectivity] of the X300/X310 Hardware Resources page.
  
 
==Test and Verify the Operation of the USRP==
 
==Test and Verify the Operation of the USRP==
Once the software tools are installed on the host computer, or using the LiveUSB SDR Environment, verify the correct operation of the USRP by running the utility programs on the host computer. More information is available at the [[Verifying the Operation of the USRP Using UHD and GNU Radio]] Application Note.
+
Once the software tools are installed on the host computer, or using the [[Live SDR Environment]], verify the correct operation of the USRP by running the utility programs on the host computer. More information is available at the [[Verifying the Operation of the USRP Using UHD and GNU Radio]] Application Note.
  
 
==Using the GPIO Expansion Kit USRP™ X300 and USRP X310==
 
==Using the GPIO Expansion Kit USRP™ X300 and USRP X310==
Reference: https://www.ettus.com/kb/detail/guide-for-the-usrp-x300x310-gpio-expansion-kit
+
{|
 
+
|style="vertical-align:top; width:60%"|This General Purpose Input/output (GPIO) breakout kit provides access to general purpose digital I/O signals with simple terminal blocks, and a prototyping area where wires and components can be soldered.  Each GPIO pin is connected to an FPGA digital line allowing it to be configured as an input, or an output, using the various software frameworks that support the USRP™ GPIO.  
This General Purpose Input/output (GPIO) breakout kit provides access to general purpose digital I/O signals with simple terminal blocks, and a prototyping area where wires and components can be soldered.  Each GPIO pin is connected to an FPGA digital line allowing it to be configured as an input, or an output, using the various software frameworks that support the USRP™ GPIO.  
+
  
 
These GPIO signals can serve the following functions:
 
These GPIO signals can serve the following functions:
Line 75: Line 73:
 
* Accept input from external devices for local, software-based triggering
 
* Accept input from external devices for local, software-based triggering
 
* Implement a protocol line such as SPI or I2C
 
* Implement a protocol line such as SPI or I2C
 
+
||[[File:Product x3x0 gpio.jpg|250px]]
 +
|}
 
===GPIO Expansion Kit Contents===
 
===GPIO Expansion Kit Contents===
  
Line 89: Line 88:
  
 
===Using GPIO with UHD, GNU Radio, and other Third-Party Frameworks===
 
===Using GPIO with UHD, GNU Radio, and other Third-Party Frameworks===
When used with UHD, or other third party frameworks that leverage UHD, the GPIO expansion can be controlled with simple API calls.  For more information, on the C++ API, and examples of how to use the GPIO in frameworks such as GNU Radio, please see: http://ettus.com/kb
+
When used with UHD, or other third party frameworks that leverage UHD, the GPIO expansion can be controlled with simple API calls.  For more information, on the C++ API, and examples of how to use the GPIO in frameworks such as GNU Radio, please see the [[Application Notes]] section of the [https://kb.ettus.com Ettus Research Knowledge Base].
  
 
===GPIO Specifications (3.3V Bank, LVCMOS)===
 
===GPIO Specifications (3.3V Bank, LVCMOS)===
Line 113: Line 112:
 
!colspan="2"|Configured as Output
 
!colspan="2"|Configured as Output
 
|-
 
|-
|Voltage Stanard
+
|Voltage Standard
 
|3.3V LVCMOS
 
|3.3V LVCMOS
 
|-
 
|-
Line 131: Line 130:
  
 
==Technical Support and Community Knowledge Base==
 
==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 s​upport@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.
+
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.
 
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 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].
  
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 [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]​.
  
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​.​
+
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​].​
  
The support page on our website is located at h​ttp://www.ettus.com/support​. The Knowledge Base is located at ​http://www.ettus.com/kb​.
+
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]​.
  
 
==Legal Considerations==
 
==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.
 
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.
  
Line 149: Line 149:
  
 
==Sales and Ordering Support==
 
==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.
+
 
 +
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]​. 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==
 +
 
Terms and conditions of sale can be accessed online at the following link: http://www.ettus.com/legal/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:Getting Started Guides]]
 
[[Category:Getting Started Guides]]

Latest revision as of 08:48, 28 November 2022

Kit Contents

  • USRP X300/X310
  • 1 Gigabit Ethernet Cable
  • SFP Adapter for 1 GigE
  • Power Supply and US Cord
  • USB 2.0 JTAG Debug Cable
  • Four SMA-Bulkhead Cables
  • Getting Started Guide
Product x300.jpg
Product x310.jpg

Verify the Contents of Your Kit

Make sure that your kit contains all the items listed above. If any items are missing, please contact your sales agent or Ettus Research Technical support immediately.

You Will Need

  • A host computer with an available 1 GigE, 10 GigE, or PCI-Express port

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 easily cause the device to become non-functional. Listed below are some examples of actions which can 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 boards.
  • 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

Assembly

The USRP X300/X310 and compatible RF daughterboards are shipped separately. To operate the device you will need to install the RF daughterboards and supplied bulkhead cables. This can be accomplished by removing the top plate of the USRP X300/X310, which is secured with two screws. After installation, the daughterboards and cables should be secured with the hardware provided. The device must be powered off when installing daughterboards to avoid potential damage. For a detailed step by step guide to assembling your X300/X310, see the USRP X Series Quick Start (Daughterboard Installation) guide.

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. Release 3.8.4 or later 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.

Basic Connectivity

This USRP X300/X310 supports multiple, high-speed, low-latency interface options. This kit includes all of the components necessary to communicate with the device through a 1 Gigabit Ethernet interface. To setup the device, follow these basic instructions:

  • Configure the host Ethernet adapter to use an IP address of "192.168.10.1" and a subnet mask of "255.255.255.0".
  • Slide the SFP Adapter into the SFP "Port 0".
  • Using the supplied Ethernet cable, connect the adapter to a host computer.
  • The Green Led above SFP "Port 0" should illuminate.
  • To test communications, ping the USRP device at address "192.168.10.2"

For more detailed on network setup, please see the section Interfaces and Connectivity of the X300/X310 Hardware Resources page. For help troubleshooting connectivity issues with your X3x0 device, see Troubleshooting X300/X310 Device Discovery Issues.

Upgrade to 10 Gigabit Ethernet or PCI-Express

The USRP X300/X310 also supports 10 Gigabit Ethernet and PCI-Express. To use these interfaces, we recommend our high-speed interface kits. For more information about these interface kits, please see the section Interfaces and Connectivity of the X300/X310 Hardware Resources page.

Test and Verify the Operation of the USRP

Once the software tools are installed on the host computer, or using the Live SDR Environment, verify the correct operation of the USRP by running the utility programs on the host computer. More information is available at the Verifying the Operation of the USRP Using UHD and GNU Radio Application Note.

Using the GPIO Expansion Kit USRP™ X300 and USRP X310

This General Purpose Input/output (GPIO) breakout kit provides access to general purpose digital I/O signals with simple terminal blocks, and a prototyping area where wires and components can be soldered. Each GPIO pin is connected to an FPGA digital line allowing it to be configured as an input, or an output, using the various software frameworks that support the USRP™ GPIO.

These GPIO signals can serve the following functions:

  • Control of external devices, such as power amplifiers and RF switches
  • Provide output signals that can help with debugging
  • Provide observables to be analyzed by oscilloscopes or other external equipment
  • Accept input from external devices for local, software-based triggering
  • Implement a protocol line such as SPI or I2C
Product x3x0 gpio.jpg

GPIO Expansion Kit Contents

  • 1 GPIO Breakout Board
  • 1 DB-15, 1-meter cable
  • GPIO Quick Reference

Circuit Protection

The GPIO signals exposed with this breakout kit are routed directly to the USRP device's FPGA with limited protection circuitry. However, the user must take precautionary measures to ensure input/output signals meet the specifications shown in this document. Over voltage, excess current draw, and other conditions can damage the USRP device and void the warranty. Special care should be taken when the USRP is powered off.

Mounting the GPIO Breakout Board

The GPIO breakout board can be mounted directly to the DB15 connector of a USRP ™ device, or mounted remotely with the cable provided in this kit. The screws on the DB15 connector of the breakout board must be removed to mount the board directly. For remote mounting, the breakout board is supplied with rubber standoffs to avoid scratching surfaces, and several through-holes for hard mounting with screws or other hardware (not provided).

Using GPIO with UHD, GNU Radio, and other Third-Party Frameworks

When used with UHD, or other third party frameworks that leverage UHD, the GPIO expansion can be controlled with simple API calls. For more information, on the C++ API, and examples of how to use the GPIO in frameworks such as GNU Radio, please see the Application Notes section of the Ettus Research Knowledge Base.

GPIO Specifications (3.3V Bank, LVCMOS)

Parameter Typical
Configured as Input
Default Voltage Standard 3.3V LVCMOS
Voltage High Threshold 2.0V
Voltage Low Threshold 0.8V
Voltage Input Limits (no damage) -0.3V/3.45V
Configured as Output
Voltage Standard 3.3V LVCMOS
Voltage High Output 2.8V
Voltage Low Output 0.4V
Current Source Capability 12 mA
Output Source Impedance >33 ohms typical

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​. 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