The USRP N310 is very different from a USB SDR such as the USRP B210. You do not simply install a driver, connect one cable, and select the radio in GNU Radio.
The N310 is a four-channel networked SDR with its own embedded Linux system, FPGA image, management network, high-speed SFP+ data interfaces, clock and time sources, GPSDO, and multiple possible Ethernet configurations.
A correct first setup therefore has several layers:
This guide walks through that complete process using current UHD 4.x workflows and explains the details that commonly cause first-time N310 setups to fail.
Browse the USRP N310 4×4 networked SDR, USRP SDR hardware, and request a formal SDR lab quote from SDRstore.eu.
| Step | Recommended first setup |
|---|---|
| Host OS | Linux is the easiest environment for a first research-lab setup |
| Driver | Current compatible UHD installation |
| Management | Rear RJ45 interface using DHCP |
| High-speed data | SFP1 at 10GbE |
| Host SFP1 IP | 192.168.20.1/24 |
| N310 SFP1 IP | 192.168.20.2/24 |
| 10GbE MTU | 9000 |
| FPGA image | HG for 1GbE SFP0 + 10GbE SFP1; XG for dual 10GbE |
| First clock source | Internal |
| First time source | Internal |
| First RF channel | RF0 / subdevice A:0 |
| First test | uhd_find_devices → uhd_usrp_probe → rx_ascii_art_dft |
For the simplest first successful setup, use the RJ45 port for management and SFP1 for 10GbE sample streaming.
A practical N310 setup should include:
For more advanced work, add:
The N310 is expensive RF laboratory equipment. Treat the RF inputs accordingly.
Do not connect a transmitter directly into an N310 receiver input.
Ettus documentation warns against applying excessive RF power to the receive inputs and recommends substantial attenuation for direct loopback tests.
For first setup, use a passive receive antenna and an ordinary local broadcast signal.
For conducted TX/RX testing later, use a path such as:
N310 TX
→ suitable fixed attenuation
→ additional attenuation if required
→ N310 RX Calculate the level before making the connection.
The N310 contains four TX/RX channels.
Internally, those channels are split across two AD9371 RF transceivers:
AD9371 / Slot A
├── RF0 → A:0
└── RF1 → A:1
AD9371 / Slot B
├── RF2 → B:0
└── RF3 → B:1 The current UHD mapping is:
| Front-panel RF label | UHD subdevice |
|---|---|
| RF0 | A:0 |
| RF1 | A:1 |
| RF2 | B:0 |
| RF3 | B:1 |
This mapping is worth documenting in every lab because it appears repeatedly in UHD, GNU Radio, MIMO scripts and benchmark commands.
UHD is the USRP Hardware Driver used to discover, configure and stream samples to and from the N310.
As of August 7, 2026, the current official release is UHD 4.10.0.0.
For a new laboratory, use a current supported UHD release unless a specific research stack requires an older version.
After installation, verify UHD:
uhd_config_info --version You should see the installed UHD version.
Run:
uhd_images_downloader This downloads firmware and FPGA images that correspond to the installed UHD version.
For the N3xx filesystem image specifically, UHD also supports:
uhd_images_downloader -t n3xx_common_sdimg_default Matching the software stack is important on the N310 because several components interact:
Host UHD
↕
MPM on N310 embedded Linux
↕
FPGA image
↕
AD9371 RF hardware If those components are significantly mismatched, UHD may report compatibility errors rather than opening the radio.
This is one of the most common N310 mistakes.
Installing a new UHD package on the workstation does not automatically mean that the embedded software currently installed on the N310 matches it.
For a controlled research lab, document:
Then treat those versions as one validated laboratory configuration.
The N310 boots from a microSD card containing its embedded Linux system and MPM software.
Current UHD supports two broad update approaches:
uhd_images_downloader -t n3xx_common_sdimg_default The resulting file is normally called:
usrp_n3xx_fs.sdimg sudo dd if=/path/to/usrp_n3xx_fs.sdimg of=/dev/YOUR_SD_DEVICE bs=1M status=progress Be extremely careful with the output device. Selecting your system SSD instead of the microSD card will overwrite the wrong disk.
N3xx devices can also update one root-filesystem partition while the other remains bootable.
A typical current UHD 4.x process is:
mender install /path/to/update.mender
reboot After confirming that the new system works:
mender commit This dual-partition system is useful in research installations because a failed update does not necessarily leave the radio unbootable.
The rear RJ45 interface is connected to the N310's ARM Linux system.
By default:
RJ45 / eth0 uses DHCP.
Connect it to a network with a DHCP server.
You can then discover the device using:
uhd_find_devices or current UHD tooling such as:
usrpctl find The N310 may also advertise a hostname based on its serial number.
Once you know the management IP:
ssh root@N310_MANAGEMENT_IP The N3xx embedded Linux environment allows you to inspect:
On a newly deployed unit, set a root password instead of leaving unrestricted root access:
passwd This is particularly important when the radio is connected to a shared university or company network.
| Interface | Default | Main role |
|---|---|---|
| RJ45 / eth0 | DHCP | Management, SSH, MPM communication |
| SFP0 / sfp0 | 192.168.10.2/24 | 1GbE or 10GbE depending on FPGA image |
| SFP1 / sfp1 | 192.168.20.2/24 | 10GbE in normal HG/XG configurations |
The important distinction is:
Management traffic and IQ sample streaming do not have to use the same physical interface.
University / lab LAN
│
└── RJ45 ─────────── N310 management
Linux workstation
10GbE NIC
│
└── SFP+ DAC ─────── N310 SFP1 This keeps management and high-rate sample transport separate.
The easiest high-performance first setup is SFP1.
N310 SFP1 default:
192.168.20.2/24 Configure the workstation's dedicated 10GbE interface as:
IP address: 192.168.20.1
Subnet: 255.255.255.0
Gateway: none
MTU: 9000 On Linux using the ip command, a temporary configuration can look like:
sudo ip addr flush dev enp5s0
sudo ip addr add 192.168.20.1/24 dev enp5s0
sudo ip link set dev enp5s0 mtu 9000
sudo ip link set dev enp5s0 up Replace enp5s0 with the actual 10GbE interface name.
Connect a compatible 10GbE SFP+ direct-attach cable or supported optical link between the workstation and N310 SFP1.
Then run:
ping 192.168.20.2 If this fails, check:
The FPGA image controls what the two SFP+ interfaces do.
| FPGA image | SFP0 | SFP1 |
|---|---|---|
| HG | 1 Gigabit Ethernet | 10 Gigabit Ethernet |
| XG | 10 Gigabit Ethernet | 10 Gigabit Ethernet |
| HA | 1GbE | Aurora |
| XA | 10GbE | Aurora |
| AA | Aurora | Aurora |
| WX | White Rabbit | 10GbE |
You want a simple mixed configuration with 1GbE available on SFP0 and 10GbE on SFP1.
You want both SFP ports available as 10GbE data interfaces.
For most new N310 labs using one 10GbE connection, HG plus SFP1 is perfectly reasonable.
First update the local image cache:
uhd_images_downloader Then use the image loader:
uhd_image_loader --args type=n3xx,addr=N310_ADDRESS Use the address or hostname through which the N310 is reachable.
Updating the FPGA causes the FPGA to reload, temporarily taking down the SFP interfaces.
Do not assume a failed ping immediately after an FPGA reload means the device is broken.
For experiments requiring higher aggregate throughput, use the XG image.
Configure two host interfaces:
Host: 192.168.10.1/24
N310 SFP0: 192.168.10.2/24
MTU: 9000 Host: 192.168.20.1/24
N310 SFP1: 192.168.20.2/24
MTU: 9000 Then a UHD device argument can include:
addr=192.168.10.2,second_addr=192.168.20.2 Dual-link operation is most useful when streaming multiple wideband channels simultaneously.
No.
For a first FM receiver or low-rate GNU Radio flowgraph, one 10GbE link is more than enough.
Start simple:
SFP1
192.168.20.1 host
192.168.20.2 N310
MTU 9000 Add the second link only when the required aggregate IQ throughput justifies it.
The default HG FPGA image makes SFP0 a 1GbE interface.
The traditional getting-started setup uses:
Host: 192.168.10.1
N310: 192.168.10.2 For low-rate streams this can be useful, but it does not provide enough bandwidth for demanding four-channel operation.
For a high-end N310 research system, install 10GbE rather than designing the entire lab around 1GbE.
Once network connectivity works:
uhd_find_devices You can narrow discovery:
uhd_find_devices --args="type=n3xx" or directly target an address:
uhd_find_devices --args="addr=192.168.20.2" A successful result should identify the device as an N3xx/N310 and report its serial and network details.
Next run:
uhd_usrp_probe --args="type=n3xx,addr=192.168.20.2" If management runs through a separate RJ45 address, specify it explicitly:
uhd_usrp_probe --args="type=n3xx,mgmt_addr=YOUR_MGMT_IP,addr=192.168.20.2" This is one of the most important diagnostic commands in the entire setup process.
A successful probe verifies:
The N310 supports three principal master clock rates:
A device argument can explicitly select one:
master_clock_rate=125e6 For example:
type=n3xx,addr=192.168.20.2,master_clock_rate=125e6 The desired streaming sample rate must be compatible with the selected master clock and FPGA decimation/interpolation structure.
For a first receive test, do not start with 100 MHz of IQ bandwidth.
Start with something easy such as:
2.5 MS/s or:
5 MS/s This lets you verify:
without immediately stressing the host, network and storage system.
For your first signal, use:
clock_source=internal
time_source=internal This avoids external-reference variables while you verify the rest of the system.
Example:
type=n3xx,addr=192.168.20.2,clock_source=internal,time_source=internal These are related but different concepts.
| Setting | Purpose |
|---|---|
| Clock source | Provides the frequency reference |
| Time source | Provides the timing/PPS reference |
For a single basic receiver, internal/internal is sufficient.
For multiple synchronized SDRs, clock and time become critical.
For laboratory synchronization:
clock_source=external
time_source=external Connect:
External clock and PPS should originate from a properly designed common timing source when several radios must operate together.
The N3xx hardware supports external frequency-reference options including the standard 10 MHz laboratory reference, with other supported reference frequencies available depending on configuration.
A custom reference-frequency device argument can be supplied where required, for example:
ref_clk_freq=20e6 For an ordinary lab, use 10 MHz unless there is a specific reason to do otherwise.
The N310 includes an internal GPS-disciplined timing capability.
Connect a suitable active GPS antenna to the GPS antenna port and place it where the receiver has adequate satellite visibility.
Then use:
clock_source=gpsdo
time_source=gpsdo GPS lock may not be immediate after startup.
The N310 exposes motherboard sensors including:
gps_lockedgps_timegps_tpvgps_skyref_lockedGPSDO is useful for:
It is not required just to receive FM radio with one N310 on a desk.
This is particularly important for N310 MIMO users.
A shared reference can provide:
but phase-coherent array work can additionally require:
Read: MIMO Testbed Hardware: 2×2, 4×4, Synchronization, Clocks, and Antennas.
The rear-panel indicators provide useful diagnostic information.
| LED | Meaning |
|---|---|
| LINK | The N310 has been claimed by a UHD session |
| REF | Reference clock lock indication |
| GPS | GPS lock |
| PPS | Valid PPS activity |
These LEDs can save substantial troubleshooting time when clocking or GPS is not behaving as expected.
Before building a four-channel MIMO flowgraph, test the host/network path with UHD's benchmark_rate utility.
For a simple single-channel receive test:
benchmark_rate \
--args "type=n3xx,addr=192.168.20.2,master_clock_rate=125e6" \
--duration 30 \
--channels "0" \
--rx_rate 25e6 \
--rx_subdev "A:0" The exact executable path depends on how UHD was installed.
The goal is to reach the desired rate without overruns.
An RX overrun means the radio produced samples faster than the receiving path could reliably consume them.
Possible causes include:
Do not immediately assume the N310 RF hardware is defective.
For demanding N310 work, use:
Avoid routing N310 sample traffic through a normal office network unless that network was specifically designed for sustained SDR traffic.
Ettus provides the rx_ascii_art_dft example specifically for a quick live spectrum test.
Connect a suitable receive antenna to RF0.
Then use a known strong local signal, such as an FM broadcast station.
Example:
rx_ascii_art_dft \
--args "type=n3xx,addr=192.168.20.2,master_clock_rate=125e6" \
--freq 100e6 \
--rate 2.5e6 \
--gain 30 \
--ant RX2 \
--subdev "A:0" \
--ref-lvl="-40" \
--dyn-rng 80 Replace 100e6 with the frequency of a strong local station.
If your management interface is separate:
--args "type=n3xx,mgmt_addr=YOUR_MGMT_IP,addr=192.168.20.2,master_clock_rate=125e6" You should see a live ASCII spectrum centered on the selected frequency.
That confirms:
Once the UHD command-line test works, move to GNU Radio.
Create a simple flowgraph:
UHD: USRP Source
↓
Frequency Xlating / channel filter if required
↓
WBFM Receive
↓
Audio Sink For a basic spectrum-only test:
UHD: USRP Source
↓
QT GUI Frequency Sink A useful first configuration is:
| Setting | Example |
|---|---|
| Device address | type=n3xx,addr=192.168.20.2 |
| Clock source | internal |
| Time source | internal |
| Channel | 0 |
| Subdevice | A:0 |
| Sample rate | 2.5e6 |
| Center frequency | Local FM station |
| Gain | Start moderate and adjust |
Do not begin with all four channels.
Get RF0 working first, then add channels one at a time.
The full current subdevice specification is:
A:0 A:1 B:0 B:1 That corresponds to:
Channel 0 → RF0
Channel 1 → RF1
Channel 2 → RF2
Channel 3 → RF3 For a four-channel GNU Radio or UHD application, configure the channels and subdevices explicitly rather than relying on assumptions about ordering.
When a UHD session initializes the N310, the platform performs operations including:
The N310 can reuse initialization state when appropriate, which makes later sessions faster.
Changing major settings such as:
can trigger a full slower reinitialization.
Do not assume the radio is frozen simply because opening it takes longer after changing major clock settings.
Check the problem in this order:
Try:
uhd_find_devices --args="type=n3xx,addr=192.168.20.2" This often indicates that layer-3 networking works but the UHD/MPM environment does not.
Check:
Run:
uhd_usrp_probe --args="type=n3xx,addr=192.168.20.2" The error message usually provides the next clue.
Check the FPGA image.
With the default HG image:
SFP0 = 1GbE
SFP1 = 10GbE If you need 10GbE on SFP0, load XG.
This is one of the most common N310 configuration misunderstandings.
Check the MTU on both ends.
For 10GbE, use:
MTU 9000 Verify the Linux interface:
ip link show enp5s0 You should see the configured MTU.
Then run benchmark_rate before debugging GNU Radio.
Reduce the sample rate first.
For example, if 100 MS/s fails, test:
10 MS/s
25 MS/s
50 MS/s If low rates work but high rates fail, investigate:
Check:
Use the GPS sensor information rather than assuming that a connected antenna means the GPSDO is locked.
Confirm:
clock_source=external is selected.ref_locked is true.The REF LED is also useful during troubleshooting.
Use XG when the experiment requires:
For one narrowband receiver, XG provides no practical advantage over simply using SFP1 with HG.
The N3xx can operate as a White Rabbit slave using an appropriate FPGA image.
This is an advanced timing workflow useful for:
It is not required for ordinary N310 GNU Radio operation.
Get the radio working with internal timing before introducing White Rabbit.
After individual channels work, move to four-channel testing.
A basic 4×4 research setup can include:
Do not start MIMO development until each individual channel has been tested separately.
┌──────────── Lab LAN
│
Management
│
RJ45
│
┌────┴────┐
│ N310 │
└────┬────┘
│ SFP+
│ 10GbE
│
Dedicated SDR NIC
│
Linux workstation
│
NVMe / GPU / DSP For dual 10GbE:
N310 SFP0 ───────── 10GbE NIC 1
N310 SFP1 ───────── 10GbE NIC 2 Avoid mixing high-rate IQ data with normal corporate LAN traffic if possible.
Record:
This becomes extremely valuable once the laboratory owns several networked USRPs.
The N310 is particularly useful when GNU Radio projects require:
Read: Best SDR for GNU Radio Projects.
The four-channel architecture makes N310 attractive for:
Remember that synchronization and calibration are part of the testbed, not optional details added after the radio works.
Read: MIMO Testbed Hardware.
N310 can also be useful as part of advanced networked wireless research where four RF channels, external timing and distributed deployment matter.
However, software compatibility should be verified against the exact version of the RAN stack before purchasing hardware for one specific private 5G application.
Read: Private 5G Lab Hardware Checklist.
Best for: university research, 4×4 MIMO, GNU Radio, channel sounding, beamforming, RFNoC and advanced wireless development.
USRP N310 is required as a four-channel networked software-defined radio platform for GNU Radio, UHD, 4×4 MIMO, beamforming, channel sounding, multi-channel wireless research, distributed SDR deployment, external synchronization and FPGA/RFNoC development.
A dedicated 10 Gigabit Ethernet interface and SFP+ connection are required to transport high-rate complex IQ data between the USRP N310 and research workstation without the throughput limitations of standard Gigabit Ethernet.
External 10 MHz and PPS timing equipment is required to provide common frequency and time references for repeatable synchronized SDR experiments, multi-device measurements and MIMO research.
RF attenuators, dummy loads, RF power meters, spectrum analyzers, VNA equipment and known-good cables are required to protect N310 RF inputs and create repeatable, measurable and safe laboratory signal paths.
Universities, research institutes, telecom teams, MIMO laboratories, wireless engineering groups, cybersecurity labs and public-sector organizations can request a formal quotation directly from SDRstore.eu.
Use the Add to Quote button on product pages or the document icon on product cards. Add the N310, networking accessories, antennas, clocking equipment, RF cables, attenuators, dummy loads, RF power meters, spectrum analyzers, NanoVNA/VNA equipment and project requirements to one request.
A quote request is useful for:
Read: How to Choose SDR Hardware for a Research Grant or University Purchase Order.
Before calling the N310 installation complete, verify all of the following:
uhd_config_info --version reports the expected UHD version.uhd_find_devices discovers the radio.uhd_usrp_probe completes successfully.benchmark_rate works at the sample rate required by the project.For the first N310 setup, keep the architecture simple.
Use the rear RJ45 port for management, use SFP1 as a dedicated 10GbE data link, configure the workstation as 192.168.20.1/24 with MTU 9000, leave clock and time sources set to internal, and test only RF0/A:0 at a modest sample rate.
Run uhd_find_devices, then uhd_usrp_probe, then a low-rate rx_ascii_art_dft receive test. Only after those steps work should you introduce GNU Radio, external references, GPSDO, additional channels, dual 10GbE, 4×4 MIMO or RFNoC.
Most difficult N310 problems become much easier to diagnose when networking, UHD compatibility, clocking and RF channels are validated separately instead of configuring everything at once.
The N310 has been supported since UHD 3.11, but new installations should normally use a current compatible UHD release unless the research software stack requires a particular older version. As of August 7, 2026, the latest official UHD release is 4.10.0.0.
The default SFP0 address is 192.168.10.2/24.
The default SFP1 address is 192.168.20.2/24.
A standard direct 10GbE setup uses 192.168.20.1/24 on the workstation and 192.168.20.2/24 on N310 SFP1.
Ettus' N310 10GbE setup guidance uses an MTU of 9000. The host and device network configuration must be compatible to avoid streaming problems.
HG configures SFP0 as 1GbE and SFP1 as 10GbE. XG configures both SFP0 and SFP1 as 10GbE.
No. One 10GbE connection through SFP1 is sufficient for many experiments and is ideal for initial setup. Dual 10GbE becomes useful for high aggregate throughput across multiple wideband channels.
Run uhd_find_devices followed by uhd_usrp_probe. You can also provide the N310 address explicitly using device arguments.
RF0 maps to subdevice A:0. RF1 maps to A:1, RF2 to B:0 and RF3 to B:1.
The N310 supports master clock rates of 122.88 MHz, 125 MHz and 153.6 MHz.
Yes. The N310 architecture includes an internal GPS-disciplined timing capability and exposes GPS status and time through UHD sensors. A suitable GPS antenna is required for satellite reception.
Use internal clock and internal time for the first successful receive test. Configure GPSDO or external clocking only after basic networking and UHD communication are confirmed.
Yes. N310 supports an external frequency reference and PPS timing input for synchronized laboratory setups.
Yes. GNU Radio integrates with USRP hardware through UHD. Configure a UHD USRP Source or Sink with the N310 device address, channel, subdevice, sample rate, center frequency, gain and clocking options.
A full initialization can include clock setup, JESD link training, AD9371 initialization, RF calibrations and multi-chip synchronization. Changing major clock or calibration settings can trigger a slower full reinitialization.
Ping only confirms IP connectivity. UHD may still fail because of host/device UHD incompatibility, an incorrect FPGA image, MPM problems, blocked RPC traffic or incorrect device arguments.
Yes. Use the Add to Quote button on the N310 product page or the document icon on product cards and include networking, clocking, antennas, RF cables, attenuators, dummy loads and test equipment required by the project.
No posts found
Write a review