From 801a8f029f6b587a12a5dcf3db443108dbb97b50 Mon Sep 17 00:00:00 2001 From: Sugandha Gupta Date: Thu, 9 May 2019 10:54:40 -0700 Subject: docs: e31x: e320: Update docs for E310 MPM version - Also updated device args and subdev spec --- host/docs/configuration.dox | 12 +- host/docs/dboards.dox | 2 +- host/docs/devices.dox | 3 +- host/docs/gpio_api.dox | 4 +- host/docs/usrp_e320.dox | 754 ------------------------- host/docs/usrp_e3x0.dox | 963 -------------------------------- host/docs/usrp_e3xx.dox | 1287 +++++++++++++++++++++++++++++++++++++++++++ 7 files changed, 1297 insertions(+), 1728 deletions(-) delete mode 100644 host/docs/usrp_e320.dox delete mode 100644 host/docs/usrp_e3x0.dox create mode 100644 host/docs/usrp_e3xx.dox (limited to 'host/docs') diff --git a/host/docs/configuration.dox b/host/docs/configuration.dox index 480410d5c..d37943324 100644 --- a/host/docs/configuration.dox +++ b/host/docs/configuration.dox @@ -26,7 +26,7 @@ and possible more options. fpga | Provide alternative FPGA bitfile | All USB Devices, X3x0 (PCIe only), E310, E1x0 | fpga=/path/to/bitfile.bit fw | Provide alternative firmware | All USB Devices, X3x0 | fw=/path/to/fw.bin ignore-cal-file | Ignores existing device calibration files | All Devices with cal-file support| See \ref ignore_cal_file - master_clock_rate | Master Clock Rate in Hz | X3x0, B2x0, B1x0, E3x0, E1x0, N3xx | master_clock_rate=16e6 + master_clock_rate | Master Clock Rate in Hz | X3x0, B2x0, B1x0, E3xx, E1x0, N3xx | master_clock_rate=16e6 dboard_clock_rate | Daughterboard clock rate in Hz | X3x0 | dboard_clock_rate=50e6 system_ref_rate | Frequency of external reference | X3x0 | system_ref_rate=11.52e6 mcr | Override master clock rate settings (see \ref usrp1_hw_extclk) | USRP1 | mcr=52e6 @@ -35,9 +35,9 @@ and possible more options. self_cal_adc_delay | Run ADC transfer delay self-calibration. | X3x0 | self_cal_adc_delay=1 ext_adc_self_test | Run an extended ADC self test (more than the usual) | X3x0 | ext_adc_self_test=1 recover_mb_eeprom | Disable version checks. Can damage hardware. Only recommended for recovering devices with corrupted EEPROMs. | X3x0, N230 | recover_mb_eeprom=1 - skip_dram | Ignore DRAM FIFO block. Connect TX streamers straight into DUC or radio. | X3x0, N3x0 | skip_dram=1 - skip_ddc | Ignore DDC block. Connect Rx streamers straight into radio. | X3x0, N3x0 | skip_ddc=1 - skip_duc | Ignore DUC block. Connect Rx streamers or DRAM straight into radio. | X3x0, N3x0 | skip_duc=1 + skip_dram | Ignore DRAM FIFO block. Connect TX streamers straight into DUC or radio. | X3x0, N3xx | skip_dram=1 + skip_ddc | Ignore DDC block. Connect Rx streamers straight into radio. | X3x0, N3xx, E3xx | skip_ddc=1 + skip_duc | Ignore DUC block. Connect Rx streamers or DRAM straight into radio. | X3x0, N3xx, E3xx | skip_duc=1 In addition, many of the streaming-related options can be set per-device at configuration time. @@ -91,10 +91,10 @@ a subdev spec string for every device individually. All USRP family motherboards have a first slot named **A:**. The USRP1 and X3x0 have two daughterboard subdevice slots, known as **A:** and **B:**. -The B210 and E310 series have a different configuration, since their two radios +The B210 series have a different configuration, since their two radios are logically connected to the same "daughterboard" (which is in reality the integrated AD9361), but different frontends. -To select both radios on a B200 or an E300, use this string: +To select both radios on a B200, use this string: A:A A:B diff --git a/host/docs/dboards.dox b/host/docs/dboards.dox index dfeadf0ed..4c25ade05 100644 --- a/host/docs/dboards.dox +++ b/host/docs/dboards.dox @@ -439,7 +439,7 @@ Notes: \subsection dboards_e300 E310 MIMO XCVR board -Please refer to \ref e3x0_dboard_e310. +Please refer to \ref e31x_dboards. \subsection dboards_n310 N310 XCVR board diff --git a/host/docs/devices.dox b/host/docs/devices.dox index 4460c5b3b..5deb39f3c 100644 --- a/host/docs/devices.dox +++ b/host/docs/devices.dox @@ -26,8 +26,7 @@ ## USRP E-Series Devices -\li \subpage page_usrp_e3x0 -\li \subpage page_usrp_e320 +\li \subpage page_usrp_e3xx ## USRP X-Series Devices diff --git a/host/docs/gpio_api.dox b/host/docs/gpio_api.dox index 98515d07b..0337f7b08 100644 --- a/host/docs/gpio_api.dox +++ b/host/docs/gpio_api.dox @@ -39,11 +39,11 @@ The +3.3V is for ESD clamping purposes only and not designed to deliver high cur - Pin 14: 0V - Pin 15: 0V -\subsection egpio_internal_gpio E3x0 Internal GPIO +\subsection egpio_internal_gpio E310/E312/E313 Internal GPIO \subsubsection egpio_internal_conn Connector -\image html e3x0_gpio_conn.png "E3x0 GPIO Connector" +\image html e3x0_gpio_conn.png "E31x GPIO Connector" ### Pin Mapping diff --git a/host/docs/usrp_e320.dox b/host/docs/usrp_e320.dox deleted file mode 100644 index c0555c34d..000000000 --- a/host/docs/usrp_e320.dox +++ /dev/null @@ -1,754 +0,0 @@ -/*! \page page_usrp_e320 USRP E320 - -\tableofcontents - -\section e320_feature_list Comparative features list - -The E320 is a 2-channel transmitter/receiver based on the AD9361 transceiver IC. -It is a monolithic board with one AD9361 and provides two RF channels. - -- TX band: 47 MHz to 6.0 GHz -- RX band: 70 MHz to 6.0 GHz -- 56 MHz of instantaneous bandwidth -- 2 RX DDC chains in FPGA -- 2 TX DUC chain in FPGA - -- Hardware Capabilities: - - Single SFP+ Transceivers (can be used with 1 GigE, 10 GigE, and Aurora) - - External PPS input - - External 10 MHz input - - Internal GPSDO for timing, location, and 10 MHz reference clock + PPS - - External GPIO Connector with UHD API control - - External USB Connection for built-in JTAG debugger and serial console - - Xilinx Zynq SoC with dual-core ARM Cortex A9 (Speedgrade 3) and - Kintex-7 FPGA (XC7Z045) - -- Software Capabilities: - - Full Linux system running on the ARM core - - Runs MPM (see also \ref page_mpm) - -- FPGA Capabilities: - - RFNoC capability - -\section e320_overview Overview - -\subsection e320_zynq The Zynq CPU/FPGA and host operating system - -The main CPU of the E320 is a Xilinx Zynq SoC XC7Z045. It -is both a dual-core ARM Cortex A9 CPU and Kintex-7 FPGA on a single die. The -CPU is clocked at 1GHz (speedgrade 3). - -The programmable logic (PL, or FPGA) section of the SoC is responsible for -handling all sampling data, the 1/10 GigE network connections, and any other -high-speed utility such as custom RFNoC logic. The processing system (PS, or CPU) -is running a custom-build OpenEmbedded-based Linux operating system. The OS is -responsible for all the device and peripheral management, such as running MPM -(see section \ref page_mpm), configuring the network interfaces, running local -UHD sessions, etc. - -It is possible to connect to the host OS either via SSH or serial console (see -sections \ref e320_getting_started_ssh and \ref e320_getting_started_serial, -respectively). - -\subsection e320_micro The STM32 microcontroller - -The STM32 microcontroller controls various low-level features of the E320 series -motherboard: It controls the power sequencing, reads out fan speeds and some of -the temperature sensors. It is connected to the Zynq via an I2C bus. - -It is possible to log into the STM32 using the serial interface -(see \ref e320_getting_started_serial_micro). This will allow certain low-level -controls, such as remote power cycling should the CPU have become unresponsive -for whatever reason. - -\subsection e320_sdcard The SD card - -The E320 uses a micro SD card as its main storage. The entire root file -system (Linux kernel, libraries) and any user data are stored on this SD card. - -The SD card is partitioned into four partitions: - -1. Boot partition (contains the bootloader). This partition usually does not - require any modifications. -2. A data partition, mounted in /data. This is the only partition that is not - erased during file system updates. -2. Two identical system partitions (root file systems). These contain the - operating system and the home directory (anything mounted under / that is not - the data or boot partition). The reason there are two of these is to enable - remote updates: An update running on one partition can update the other one - without any effect to the currently running system. Note that the system - partitions are erased during updates and are thus unsuitable for permanently - storing information. - -Note: It is possible to access the currently inactive root file system by -mounting it. After logging into the device using serial console or SSH (see the -following two sections), run the following commands: - - $ mkdir temp - $ mount /dev/mmcblk0p3 temp - $ ls temp # You are now accessing the idle partition: - bin data etc lib media proc sbin tmp usr - boot dev home lost+found mnt run sys uboot var - -The device node in the mount command will likely differ, depending on which -partition is currently already mounted. - -\section e320_getting_started Getting started - -This will run you through the first steps relevant to getting your USRP E320 -up and running. -Note: This guide was creating on an Ubuntu machine, and other distributions -or OS's may have different names/methods. - -\subsection e320_getting_started_assembling Assembling the E320 - -Unlike the X300 or N200 series, there is no assembly of required since it is -a monolithic board. - -Checklist: -- Connect power and network -- Read security settings -- Connect clocking (if required) - -\subsection e320_getting_started_fs_update Updating the file system - -Before doing any major work with a newly acquired USRP E320, it is -recommended to update the file system. For the OEM/Board-only version of -E320, the SD card is physically accessible and filesystem update can be -accomplished directly by using Mender or externally by manually writing -an image onto a micro SD card and inserting it. For the -enclosure version of E320, Mender update is required as there is no direct -physical access to the device. For details on using Mender, -see Section \ref e320_rasm_mender . - -Manual updating is simply loading an image on the micro SD card. The first step -in that process is to obtain an image. - -To obtain the default micro SD card image for a specific version of UHD, install -that version of UHD (3.13.0.2 or later) on a host system with Internet access and run: - - $ uhd_images_downloader -t e320 -t sdimg - - The image will be downloaded to - `/share/uhd/images/usrp_e320_fs.sdimg`, - where `` is the UHD installation directory. - -To load an image onto the micro SD card, connect the card to the host and run: - - $ sudo dd if= of=/dev/ bs=1M - - The `` is the path to the micro SD card image - (i.e.`/share/uhd/images/usrp_e320_fs.sdimg`). - - The `` device node depends on your operating system and which - other devices are plugged in. Typical values are `sdb` or `mmcblk0`.
- - CAUTION: The Linux utility `dd` or `bmap` can cause unrecoverable data loss - if the incorrect disk is selected, or if the parameters are input incorrectly. - Ensure you have selected the correct input and output parameters for your - system configuration. - -The micro SD card used can be the original SD card shipped with the device or -another one that is at least 16 GB in size. - -\subsection e320_getting_started_serial Serial connection - -It is possible to gain root access to the device using a serial terminal -emulator. Most Linux, OSX, or other Unix flavours have a tool called 'screen' -which can be used for this purpose, by running the following command: - - $ sudo screen /dev/ttyUSB2 115200 - -In this command, we prepend 'sudo' to elevate user privileges (by default, -accessing serial ports is not available to regular users), we specify the -device node (in this case, `/dev/ttyUSB2`), and the baud rate (115200). - -The exact device node depends on your operating system's driver and other USB -devices that might be already connected. Modern Linux systems offer alternatives -to simply trying device nodes; instead, the OS might have a directory of -symlinks under `/dev/serial/by-id`: - - $ ls /dev/serial/by-id - /dev/serial/by-id/usb-FTDI_Dual_RS232-HS-if00-port0 - /dev/serial/by-id/usb-FTDI_Dual_RS232-HS-if01-port0 - /dev/serial/by-id/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6A6C-if00-port0 - /dev/serial/by-id/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6A6C-if01-port0 - -Note: Exact names depend on the host operating system version and may differ. - -Every E320 device connected to USB will by default show up as four -different devices. The devices labeled "USB_to_UART_Bridge_Controller" are the -devices that offer a serial prompt. The one with the `if01` suffix connects -to Linux, whereas the one with `if00` suffix connects to the STM32 microcontroller. -If you have multiple E320 devices connected, you may have to try out multiple -devices. In this case, to use this symlink instead of the raw device node -address, modify the command above to: - - $ sudo screen /dev/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6A6C-if01-port0 115200 - -You should be presented with a shell prompt similar to the following: - - root@ni-e320-311FE00:~# - -On this prompt, you can enter any Linux command available. Using the default -configuration, the serial console will also show all kernel log messages (unlike -when using SSH, for example), and give access to the boot loader (U-boot -prompt). This can be used to debug kernel or bootloader issues more efficiently -than when logged in via SSH. - -\subsubsection e320_getting_started_serial_micro Connecting to the microcontroller - -The STM32 microcontroller (which controls the power sequencing, among other -things) also has a serial console available. To connect to the microcontroller, -use the other UART device. In the example above: - - $ sudo screen /dev/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6CB5-if00-port0 115200 - -It provides a very simple prompt. The command 'help' will list all available -commands. A direct connection to the microcontroller can be used to hard-reset -the device without physically accessing it (i.e., emulating a power button press) -and other low-level diagnostics. - -\subsection e320_getting_started_ssh SSH connection - -The USRP E320 devices have two network connections: One SFP port, -and an RJ-45 connector. The latter is by default configured by DHCP; by plugging -it into into 1 Gigabit switch on a DHCP-capable network, it will get assigned -an IP address and thus be accessible via ssh. - -In case your network setup does not include a DHCP server, refer to the section -\ref e320_getting_started_serial. A serial login can be used to assign an IP address manually. - -After the device obtained an IP address you can log in from a Linux or OSX -machine by typing: - - $ ssh root@ni-e320-311FE00 # Replace with your actual device name! - -Depending on your network setup, using a `.local` domain may work: - - $ ssh root@ni-e320-311FE00.local - -Of course, you can also connect to the IP address directly if you know it (or -set it manually using the serial console). - -Note: The device's hostname is derived from its serial number by default -(`ni-e320-`). You can change the hostname by modifying the `/etc/hostname` -file and rebooting. - -On Microsoft Windows, the connection can be established using a tool such as -Putty, by selecting a username of root without password. - -Like with the serial console, you should be presented with a prompt like the -following: - - root@ni-e320-311FE00:~# - -\subsection e320_getting_started_connectivity Network Connectivity - -The RJ45 port (eth0) comes up with a default configuration of DHCP, -that will request a network address from your DHCP server (if available on your -network). - -The SFP+ (sfp0) port is configured with static address 192.168.10.2/24 - -The configuration for the sfp0 port is stored in /etc/systemd/networkd/sfp0.network. - -For configuration please refer to the -systemd-networkd manual pages - -The factory settings are as follows: - - eth0 (DHCP): - - [Match] - Name=eth0 - - [Network] - DHCP=v4 - - [DHCPv4] - UseHostname=false - - sfp0 (static): - - [Match] - Name=sfp0 - - [Network] - Address=192.168.10.2/24 - - [Link] - MTUBytes=8000 - -Note: Care needs to be taken when editing these files on the device, since -vi / vim sometimes generates undo files (e.g. /etc/systemd/networkd/sfp0.network~), -that systemd-networkd might accidentally pick up. - -Note: Temporarily setting the IP addresses via ifconfig etc will only change the -value until the next reboot or reload of the FPGA image. - -\subsection e320_getting_started_security Security-related settings - -The E320 ships without a root password set. It is possible to ssh into the -device by simply connecting as root, and thus gaining access to all subsystems. -To set a password, run the command - - $ passwd - -on the device. - -\subsection e320_getting_started_fpga_update Updating the FPGA - -Updating the FPGA follows the same procedure as other USRPs. Use the `uhd_image_loader` -command line utility to upload a new FPGA image onto the device. The command can be run -on the host to load the image via RJ-45 network connection or it can be run on the -device. - -A common reason to update the FPGA image is in the case of a UHD/FPGA compat -number mismatch (for example, if UHD has been updated, and now expects a newer -version of the FPGA than is on the device). In this case, simply run - - $ uhd_images_downloader - -to update the local cache of FPGA images. Then, run - - $ uhd_image_loader --args type=e3xx,addr=ni-e320-311fe00 - -to update the FPGA using the default settings. Replace ni-e320-311fe00 in the addr with the -correct device address. If a custom FPGA image is targeted for uploading, use the -`--fpga-path` command line argument. Run - - $ uhd_image_loader --help - -to see a full list of command line options. Note that updating the FPGA image -will force a reload of the FPGA, which will temporarily take down the SFP -network interfaces (and temporary settings, such as applied via `ifconfig` on -the command line, will be lost). - - -\section e320_usage Using an E320 USRP from UHD - -Like any other USRP, all E320 USRPs are controlled by the UHD software. To -integrate a USRP E320 into your C++ application, you would generate a UHD -device in the same way you would for any other USRP: - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp} -auto usrp = uhd::usrp::multi_usrp::make("type=e3xx"); -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -For a list of which arguments can be passed into make(), see Section -\ref e320_usage_device_args. - -\subsection e320_usage_device_args Device arguments - - Key | Description | Example Value ----------------------|-------------------------------------------------------------------------------|--------------------- - addr | IPv4 address of primary SFP+ port to connect to. | addr=192.168.30.2 - find_all | When using broadcast, find all devices, even if unreachable via CHDR. | find_all=1 - master_clock_rate | Master Clock Rate in Hz. Default is 16 MHz. | master_clock_rate=30.72e6 - serialize_init | Force serial initialization of daughterboards. | serialize_init=1 - skip_dram | Ignore DRAM FIFO block. Connect TX streamers straight into DUC or radio. | skip_dram=1 - skip_ddc | Ignore DDC block. Connect Rx streamers straight into radio. | skip_ddc=1 - skip_duc | Ignore DUC block. Connect Tx streamers or DRAM straight into radio. | skip_duc=1 - skip_init | Skip the initialization process for the device. | skip_init=1 - ref_clk_freq | Specify the external reference clock frequency, default is internal (20 MHz). | ref_clk_freq=10e6 - init_cals | Specify the bitmask for initial calibrations of the RFIC. | init_cals=BASIC - init_cals_timeout | Timeout for initial calibrations in milliseconds. | init_cals_timeout=45000 - discovery_port | Override default value for MPM discovery port. | discovery_port=49700 - rpc_port | Override default value for MPM RPC port. | rpc_port=49701 - tracking_cals | Specify the bitmask for tracking calibrations of the RFIC. | tracking_cals=ALL - -\subsection e320_usage_sensors The sensor API - -Like other USRPs, the E320 series has RF and motherboard sensors. -When using uhd::usrp::multi_usrp, the following API calls are relevant to -interact with the sensor API: - -- uhd::usrp::multi_usrp::get_mboard_sensor_names() -- uhd::usrp::multi_usrp::get_mboard_sensor() -- uhd::usrp::multi_usrp::get_tx_sensor_names() -- uhd::usrp::multi_usrp::get_rx_sensor_names() -- uhd::usrp::multi_usrp::get_tx_sensor() -- uhd::usrp::multi_usrp::get_rx_sensor() - -The following motherboard sensors are always available: -- `temp_internal`: temperature (in C) of Temperature Sensor on board -- `temp_fpga`: temperature (in C) of the FPGA die -- `temp_rf_channelA`: temperature (in C) near power amplifier RF A -- `temp_rf_channelB`: temperature (in C) near power amplifier RF B -- `temp_main_power`: temperature (in C) near power supply -- `gps_locked`: GPS lock -- `gps_time`: GPS time in seconds sin ce the epch -- `gps_tpv`: A TPV report from GPSd serialized as JSON -- `gps_sky`: A SKY report from GPSd serialized as JSON -- `ref_locked`: This will check that all the daughterboards have locked to the -external/internal reference clock. -- `fan`: get fan speed (in rpm) - -\section e320_rasm Remote Management - -\subsection e320_rasm_mender Mender: Remote update capability - -Mender is a third-party software that enables remote updating of the root -file system without physically accessing the device (see also the -[Mender website](https://mender.io)). Mender can be executed locally on the -device, or a Mender server can be set up which can be used to remotely update -an arbitrary number of USRP devices. Mender servers can be self-hosted, or -hosted by Mender (see [mender.io](https://mender.io) for pricing and -availability). - -When updating the file system using Mender, the tool will overwrite the root file -system partition that is not currently mounted (note: every SD card comes with -two separate root file system partitions, only one is ever used at a single -time). Any data stored on that partition will be permanently lost. After -updating that partition, it will reboot into the newly updated partition. Only -if the update is confirmed by the user, the update will be made permanent. This -means that if an update fails, the device will be always able to reboot into the -partition from which the update was originally launched (which presumably is in -a working state). Another update can be launched now to correct the previous, -failed update, until it works. -See also Section \ref e320_sdcard. - -To initiate an update from the device itself, download a Mender artifact -containing the update itself. These are files with a `.mender` suffix. - -Then run mender on the command line: - - $ mender -rootfs /path/to/latest.mender - -The artifact can also be stored on a remote server: - - $ mender -rootfs http://server.name/path/to/latest.mender - -This procedure will take a while. After mender has logged a successful update, -reboot the device: - - $ reboot - -If the reboot worked, and the device seems functional, commit the changes so -the boot loader knows to permanently boot into this partition: - - $ mender -commit - -To identify the currently installed Mender artifact from the command line, the -following file can be queried: - - $ cat /etc/mender/artifact_info - -If you are running a hosted server, the updates can be initiated from a web -dashboard. From there, you can start the updates without having to log into the -device, and can update groups of USRPs with a few clicks in a web GUI. The -dashboard can also be used to inspect the state of USRPs. This is simple way to -update groups of rack-mounted USRPs with custom file systems. - -\subsection e320_rasm_salt Salt: Remote configuration management and execution - -Salt (also known as SaltStack, see [Salt Website](https://saltstack.com)) is a -Python-based tool for maintaining fleets of remote devices. It can be used to -manage USRP E320 remotely for all types of settings that are not -controlled by UHD. For example, if an operator would like to reset the root -password on multiple devices, or install custom software, this tool might be a -suitable choice. - -Salt is a third-party project with its [own documentation](https://docs.saltstack.com/en/latest/), -which should be consulted for configuring it. However, the Salt minion is -installed by default on every E320 device. To start it, simply log on to the -device and run: - - $ systemctl start salt-minion - -To permanently enable it at every boot, run (this won't by itself launch the -salt-minion): - - $ systemctl enable salt-minion - -To make use of Salt, both the device needs to be configured (the "minion") and, -typically, a server to act as the Salt master. Refer to the Salt documentation -on how to configure the minion and the master. A typical sequence to get started -will look like this: - -1. Install the salt-master package on the server (e.g. by running `apt install salt-master` - if the server is an Ubuntu system), and make sure the Salt master is running. -2. Add the network address / hostname of that server to the `/etc/salt/minion` - file on the device by editing the `master:` line. -3. Launch the Salt minion on the USRP by running the command `systemctl start salt-minion`. -4. The minion will try to connect to the master. You need to authorize the - minion by running `salt-key -a $hostname` where `$hostname` is the name of - the minion. -5. Once the device is authorized, you can try various commands to see if the - communication was established: - - $ [sudo] salt '*' test.ping - ni-n3xx-$serial: - True - $ [sudo] salt '*' network.interfaces - ni-n3xx-$serial: - ---------- - eth0: - ---------- - hwaddr: - 02:00:03:11:fe:00 - inet: - |_ - ---------- - address: - xx.xx.xx.xx - broadcast: - xx.xx.xx.xx - label: - eth0 - netmask: - 255.255.254.0 - up: - True - # [...] - -\section e320_theory_of_ops Theory of Operation - -E320 is on the MPM architecture (see also: \ref page_mpm). -Inside the Linux operating system running on the ARM -cores, there is hardware daemon which needs to be active in order for the -device to function as a USRP (it is enabled to run by default). - -A large portion of hardware-specific setup is handled by the daemon. - -\section e320_software_dev Modifying and compiling UHD and MPM for the E320 - -E320 devices ship with all relevant software installed on the SD card. Updating -UHD and/or MPM on the SD card is typically easiest done by updating the -filesystem image (see Section \ref e320_rasm_mender). However, it is certainly -possible to compile UHD and MPM by hand, e.g., in order to modify and try out -changes without having to build entire filesystems in between. At Ettus R&D, -this mode of operation is often used for rapid iteration cycles. - -\subsection e320_software_dev_mpm_native Compiling MPM natively - -In general, compiling natively is not a recommended way of compiling code for -the ARM processors. However, in the case of MPM, the amount of C++ code that -needs to be compiled is very little, and a full compile of MPM will take a few -minutes even on the device. First, you need to get a copy of the MPM source code -onto your device. If you have an internet connection, you can use git to pull -it directly from the Ettus repository (all commands are run on the device -itself, inside the home directory): - - $ git clone https://github.com/EttusResearch/uhd.git - -You can also SSHFS it from another computer: - - $ mkdir uhd # Create a new, empty directory called uhd - $ sshfs user@yourcomputer:src/uhd uhd # This will mount ~/src/uhd from the remote machine to ~/uhd on the device - -Now, create a build directory and use the regular cmake/make procedure to kick -off a build. It can be advantageous (especially for slow network connections) -to create the build directory outside of the repository directory: - - $ mkdir build_mpm - $ cd build_mpm # You are now in /home/root/build_mpm - $ cmake ../uhd/mpm - $ make -j2 install # This will take several minutes - -Note that this overwrites your system MPM. You can install MPM to another -location by specifying `-DCMAKE_INSTALL_PREFIX`, but make sure to update all of -your paths appropriately. - -If you prefer cross-compiling MPM the same way as UHD, refer to the following -sections and adapt the instructions for UHD appropriately. - -\subsection e320_software_dev_sdk Obtaining an SDK - -The recommended way to develop software for the E320 is to cross-compile. By -running the compiles on a desktop or laptop computer, you will be able to speed -up compile times considerably (compiling UHD natively for the E320 would take -many hours). - -SDKs are distributed along with other binaries. They contain a cross-compiler, -a cross-linker, a cross-debugger, and all the libraries available on the device -to mirror its environment. - -To unpack the SDK, simply execute it after downloading it: - - $ cd /usr/local/share/uhd/images # Change this to where your images are stored - $ ./oecore-x86_64-cortexa9hf-neon-toolchain-nodistro.0.sh - -If this doesn't work, the executable permissions of the file might have been -lost (this can occur with some versions of Python). In that case, add those -permissions back before executing the `.sh` file: - - $ chmod +x oecore-x86_64-cortexa9hf-neon-toolchain-nodistro.0.sh - -Executing the `.sh` file will prompt you for an installation path. Please -ensure you have sufficient disk space, as each of the SDKs may require several -gigabytes of disk space (depending on the image flavor selected). - -This will allow you to compile UHD as well as (depending on the image flavor) -other software. - -Please note, that while several toolchains can be installed in parallel, they -have to be installed to different directories. - -\subsection e320_software_dev_sdkusage SDK Usage - -Having installed the toolchain in the last step, -in order to build software for your device open a new shell and type: - - $ . $SDKPATH/environment-setup-armv7ahf-vfp-neon-oe-linux-gnueabi - -This will modify the PATH, CC, CXX etc, environment variables and allow you to compile software for your USRP E320 device. -To verify all went well you can try: - - $ $CC -dumpmachine - -which should return 'arm-oe-linux-gnueabi'. - -\subsubsection e320_software_dev_uhd Building UHD - --# Obtain the UHD source code via git or tarball --# Set up your environment as described in \ref e320_software_dev_sdkusage --# Type the following in the build directory (assuming a build in host/build): - - $ cmake -DCMAKE_TOOLCHAIN_FILE=../host/cmake/Toolchains/oe-sdk_cross.cmake -DCMAKE_INSTALL_PREFIX=/usr .. # Add any CMake options you desire - $ make # You can run make -j12 to compile on 12 processes at once - -Note: The UHD you are cross-compiling will not run on your host computer (the -one where you're doing the development). Compiling UHD regularly on your host -computer (with MPMD enabled) will allow you to talk to your E320. - -\subsubsection e320_software_dev_gr Building GNU Radio - --# Obtain the GNU Radio source code via git or tarball --# Set up your environment as described in \ref e320_software_dev_sdkusage --# Use the following commands to create a build directory, configure and compile gnuradio. You only need create the build directory once. - -\code{.sh} -$ mkdir build-arm -$ cd build-arm -$ cmake -Wno-dev -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/oe-sdk_cross.cmake \-DCMAKE_INSTALL_PREFIX=/usr -DENABLE_GR_VOCODER=OFF -DENABLE_GR_ATSC=OFF \ --DENABLE_GR_DTV=OFF -DENABLE_DOXYGEN=OFF ../ # Append any CMake options you desire -\endcode - -Several GNU Radio components depend on running binaries built for the build -machine during compile. These binaries can be built and used for cross -compiling, but this is an advanced topic. - -\section e320_neon E320-specific Features - -\subsection e320_panels Front and Rear Panel - -Like the USRP X300 and N310 series, E320 has connectors on both the front and back -panel. The back panel holds the power connector, all network connections, USB -connections for serial console (see \ref e320_getting_started_serial), JTAG and -peripherals, and front-panel GPIO. - -The front panel is used for all RF connections, SMA connectors for GPS antenna -input, 10 MHz external clock reference. - -The connectors are labeled RF A and RF B and are powered by the two channels of -AD9361 RFIC. - -\subsection e320_regmap FPGA Register Map - -The following tables describe how FPGA registers are mapped into the PS. -This is for reference only, most users will not even have to know about this table. - - -AXI Slave | Address Range | UIO Label | Description -----------|-----------------------|------------------|----------------------------------- -Slave 0 | 4000_0000 - 4000_3fff | - | Ethernet DMA SFP -Slave 1 | 4000_4000 - 4000_4fff | misc-enet-regs | Ethernet registers SFP -Slave 2 | 4001_0000 - 4001_3fff | mboard-regs | Motherboard control -Slave 3 | 4001_4000 - 4001_41ff | dboard-regs | Daughterboard control - - - - -
E320 Register Map
AXI Slave Module Address Name Read/Write Description -
Slave 0 axi_eth_dma 4000_0000 - 4000_4fff Ethernet DMA RW See Linux Driver -
Slave 1 e320_mgt_io_core 4000_4000 PORT_INFO RO SFP port information -
[31:24] COMPAT_NUM RO - -
[23:18] 6'h0 RO - -
[17] activity RO - -
[16] link_up RO - -
[15:8] mgt_protocol RO 0 - None, 1 - 1G, 2 - XG, 3 - Aurora -
[7:0] PORTNUM RO - -
e320_mgt_io_core 4000_4004 MAC_CTRL_STATUS RW Control 10gE and Aurora mac -
[0] ctrl_tx_enable (PROTOCOL = "10GbE")RW- -
[0] bist_checker_en (PROTOCOL = "Aurora")RW- -
[1] bist_gen_en RW - -
[2] bist_loopback_enRW - -
[8:3] bist_gen_rate RW - -
[9] phy_areset RW - -
[10] mac_clear RW - -
e320_mgt_io_core 4000_4008 PHY_CTRL_STATUS RW Phy reset control -
e320_mgt_io_core 4000_400C MAC_LED_CTL RW Used by ethtool to indicate port -
[1] identify_enable RW - -
[0] identify_value RW - -
mdio_master 4000_4010 MDIO_DATA RW - -
4000_4014 MDIO_ADDR RW - -
4000_4018 MDIO_OP RW - -
4000_401C MDIO_CTRL_STATUSRW - -
e320_mgt_io_core 4000_4020 AURORA_OVERUNS RO - -
4000_4024 AURORA_CHECKSUM_ERRORSRO - -
4000_4028 AURORA_BIST_CHECKER_SAMPSRO - -
4000_402C AURORA_BIST_CHECKER_ERRORSRO- -
eth_switch 4000_5000 MAC_LSB RW Device MAC LSB -
4000_5004 MAC_MSB RW Device MAC MSB -
4000_6000 IP RW Device IP -
4000_6004 PORT1, PORT0 RW Device UDP port -
eth_dispatch 4000_6008 [1] ndest, [0] bcastRW Enable Crossover -
4000_600c [1] my_icmp_type, [0] my_icmp_code- -
eth_switch 4000_6010 BRIDGE_MAC_LSB Bridge SFP ports in ARM -
4000_6014 BRIDGE_MAC_MSB - -
4000_6018 BRIDGE_IP - -
4000_601c BRIDGE_PORT1, BRIDGE_PORT0 - -
4000_6020 BRIDGE_EN - -
chdr_eth_framer 4000_6108 onwards LOCAL_DST_IP W Destination IP, MAC, UDP for Outgoing Packet for 256 SIDs -
4000_6208 onwards LOCAL_DST_UDP_MAC_MSBW Destination MAC for outgoing packets (MSB) -
4000_6308 onwards LOCAL_DST_MAC_LSBW Destination MAC for outgoing packets (LSB) -
4000_7000 onwards REMOTE_DST_IP W Destination IP, MAC, UDP for Outgoing Packet for 16 local addrs -
4000_7400 onwards REMOTE_DST_UDP_MAC_HIW Destination MAC (MSB) -
4000_7800 onwards REMOTE_DST_MAC_LOW Destination MAC (LSB) - -
Slave 2 e320_core 4001_0000 COMPAT_NUM R FPGA Compat Number -
[31:16] Major RO - -
[15:0] Minor RO - -
4001_0004 DATESTAMP RO - -
4001_0008 GIT_HASH RO - -
4001_000C SCRATCH RO - -
4001_0010 NUM_CE RO Number of Computation Engines (RFNoC Blocks) -
4001_0014 NUM_IO_CE RO Number of fixed IO CEs - Radios + DMA Fifo -
4001_0018 CLOCK_CTRL - -
[0] pps select (internal 10 MHz)RWOne-hot encoded pps_select to use the internal PPS from GPSDO -
[1] pps select (external 10 MHz)RWOne-hot encoded pps_select to use the external PPS. -
[2] refclk_select (internal/external 10 MHz)RWrefclk_select=0 for internal (GPSDO) 10 MHz, refclk_sel=1 for external 10 MHz. -
4001_001C XADC_READBACK RO - -
[11:0] FPGA temperatureRO - -
4001_0020 BUS_CLK_RATE RO - -
4001_0024 BUS_CLK_COUNT RO - -
4001_0028 SFP_PORT_INFO RO Same as port_info register 0x4000_4000 -
4001_002C FP_GPIO_CTRL RW - -
4001_0030 FP_GPIO_MASTER RW - -
4001_0034 FP_GPIO_RADIO_SRC RW - -
4001_0038 GPS_CTRL RW - -
[0] GPS_PWR_EN RW Power on GPSDO -
[1] GPS_RST_N RW - -
[2] GPS_INITSURV_N RW - -
4001_003C GPS_STATUS RO GPSDO Status -
[0] GPS_LOCK RO Returns 1 if GPSDO is locked -
[1] GPS_ALARM RO - -
[2] GPS_PHASELOCK RO - -
[3] GPS_SURVEY RO - -
[4] GPS_WARMUP RO - -
4001_0040 DBOARD_CTRL RO - -
4001_0044 DBOARD_STATUS RO - - -
axi_crossbar 4001_1010 XBAR_VERSION RO See crossbar kernel driver -
4001_1014 XBAR_NUM_PORTS RO See crossbar kernel driver -
4001_1018 LOCAL_ADDR RW See crossbar kernel driver -
4001_1020 remote_offset WO XBAR settings reg -
4001_1420 local_offset WO XBAR settings reg - -
Slave 4 4001_40004001_41FFDaughterboard Registers- Don't exist now. TBD - - -*/ -// vim:ft=doxygen: diff --git a/host/docs/usrp_e3x0.dox b/host/docs/usrp_e3x0.dox deleted file mode 100644 index cc2b99945..000000000 --- a/host/docs/usrp_e3x0.dox +++ /dev/null @@ -1,963 +0,0 @@ -/*! \page page_usrp_e3x0 USRP-E3xx Series - -\tableofcontents - -\section e3x0_feature_list Comparative features list - E310 - -- Hardware Capabilities: - Integrated RF frontend (70 MHz - 6 GHz) - - External PPS reference input - - Configurable clock rate - - Internal GPIO connector with UHD API control - - 2 USB 2.0 Host ports - - Internal GPS - - Soundcard mono input / stereo output - - USB UART - - Internal IMU - - Zynq-7020 FPGA -- FPGA Capabilities: - - 2 RX DDC chains in FPGA - - 2 TX DUC chain in FPGA - - Timed sampling in FPGA - - 16-bit fixed point sample mode (sc16) - -\section e3x0_getting_started Getting started - -This will run you through the first steps relevant to get your USRP E310 -up and running. - -\subsection e3x0_first_boot First boot - -There are two different methods to connect to the device - -- using the onboard Serial to USB connector -- using the gigabit Ethernet connector and a ssh client on your host computer - -For the first boot, booting with the serial cable connected to the device -is recommended, as it allows to review and modify the \ref e3xx_network_configuration -and allows to enter the bootloader in case of issues during the boot. - - -\subsubsection e3x0_first_boot_serial Serial connection - -To use the serial connection together with a Linux or OSX machine (most other UNIX variants come with a version of screen, too) -a terminal emulator such as screen can be used: - - $ sudo screen /dev/ttyUSB0 115200 - -The exact device node /dev/ttyUSB0 depends on your operating system's driver and other USB devices that might be already connected. -It can be usually found by perusing the output of dmesg or journalctl, after connecting the USRP E310 device to your host computer. - -An example of a dmesg output for the serial to usb converter: - - 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 by selecting a baudrate of 115200 and the corresponding serial port for the serial to usb converter. - -In both cases you should see boot messages fly by and finally end up with a login prompt similar to the following: - - ettus-e300 login: - -Note: The username is 'root' and the default password is empty. - -You should be presented with a shell similar to the following - - root@ettus-e300:~# - - -\subsubsection e3x0_first_boot_ssh SSH connection - -The USRP E310 device relies on the DHCP protocol to automatically obtain an IP address. -In case your network setup does not include a DHCP server, refer to the section \ref e3x0_first_boot_serial or configure a DHCP server to hand out IP addresses on your network. - -After the device obtained an IP address you can log in from a Linux or OSX machine by typing: - - $ ssh root@192.168.10.42 - -where the IP address depends on your local network setup. - -On Microsoft Windows again the connection can be established using a tool such as Putty, by selecting a username of root without password. - -You should be presented with a shell similar to the following - - root@ettus-e300:~# - -\section e3x0_sdk Using the SDK - -In order to facilitate software development for the integrated ARM Cortex-A9 processor, a Yocto Project based SDK is provided in the download section of our website. -This SDK contains a cross-compiler, a cross-linker as well as a cross-debugger and can be used to develop your user space applications for the Ettus USRP-E310 devices. - - -\subsection e3x0_sdk_installation Installation -The following section will guide you through the installation of the provided SDK on a Linux development machine. - -\subsubsection e3x0_sdk_installation_download Obtaining the correct SDK -It is necessary for the SDK version and the image version to match, to ensure the versions of the software installed on the device and the version of the software the SDK will build against match. - -If you are not sure which image is installed on your device, upgrading to the latest stable version is recommended. See the appropriate section for details on upgrading. - -\subsubsection e3x0_sdk_installation_install Obtaining the right toolchain - -To install the toolchain you downloaded type: - - $ ./oecore-x86_64-armv7ahf-vfp-neon-toolchain-nodistro.0.sh - -This will prompt you for an installation path. -Please ensure you have sufficient disk space, as each of the SDKs may require several gigabytes of disk space (depends on the image flavor selected). - -This will allow you to compile UHD as well as (depending on the image flavor) other software. - -Please note, that while several toolchains can be installed in parallel, they have to be installed to different directories. - -\subsection e3x0_sdk_usage Usage - -Having installed the toolchain in the last step, -in order to build software for your device open a new shell and type: - - $ . /environment-setup-armv7ahf-vfp-neon-oe-linux-gnueabi - -This will modify the PATH, CC, CXX etc, environment variables and allow you to compile software for your USRP E310 device. -To verify all went well you can try: - - $ $CC -dumpmachine - -which should return 'arm-oe-linux-gnueabi'. - -\subsubsection e3x0_sdk_usage_uhd Building UHD - -The E310 comes with UHD already installed on the SD card. You will only need -to build UHD and install it if there is a critical bug fix in a later UHD or you -have custom UHD modifications. - --# Obtain the UHD source code via git or tarball --# Setup your environment as described in \ref e3x0_sdk_usage --# Type the following in the build directory (assuming a build in host/build): - - $ cmake -DCMAKE_TOOLCHAIN_FILE=../host/cmake/Toolchains/oe-sdk_cross.cmake -DCMAKE_INSTALL_PREFIX=/usr -DENABLE_E300=ON -DENABLE_GPSD=ON .. - $ make - -For instructions on building UHD on a PC to interact with your E-Series device, follow these instructions: \ref e3x0_uhd_build - -\subsubsection e3x0_sdk_usage_gnuradio Building GNU Radio - -GNU Radio is already installed on the SD card. You only need to build GNU Radio -for the E3XX if you are doing custom GNU Radio development work. - --# Obtain the gnuradio source code via git. --# Setup the environment as described in \ref e3x0_sdk_usage --# Use the following commands to create a build directory, configure and compile gnuradio. You only need create the build directory once. - -\code{.sh} -$ mkdir build-arm -$ cd build-arm -$ cmake -Wno-dev -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/oe-sdk_cross.cmake \-DCMAKE_INSTALL_PREFIX=/usr -DENABLE_GR_VOCODER=OFF -DENABLE_GR_ATSC=OFF \ --DENABLE_GR_DTV=OFF -DENABLE_DOXYGEN=OFF ../ -\endcode - -Several GNU Radio components depend on running binaries built for the build -machine during compile. These binaries can be built and used for cross -compiling, but this is an advanced topic. - -\section e3x0_image_building Rebuilding the file system - -The file system images are built using OpenEmbedded Core. The `repo` tool is -used to manage the versions of the various layers that supply recipes for -building the image. For more documentation see http://www.yoctoproject.org. -These notes will show you how to rebuild the files used to create the SD -card included with the E310. These instructions assume you have a working -knowledge of Linux. - -Once you have rebuilt the factory image, you can create your own custom recipes -to build file system images for specific application. - --# Install `repo`. -\code{.sh} - $ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > repo - $ chmod a+x repo - $ sudo mv repo /usr/local/bin -\endcode - --# Configure the repo manifest that controls the build. -\code{.sh} - $ mkdir e300-oe-build - $ cd e300-oe-build - $ repo init -u git://github.com/EttusResearch/e300-manifest.git -b Release-4 -\endcode - --# Initialize the environment. This will take a little while. -\code{.sh} - $ repo sync - $ TEMPLATECONF=`pwd`/meta-ettus/conf source ./oe-core/oe-init-build-env ./build ./bitbake -\endcode -At this point you should review the file in conf/local.conf and make sure -path names make sense for your machine. - --# Build an image. This will take a few hours, especially the first run since -it will download all the required sources. (These are saved locally for future -builds) -\code{.sh} - $ export MACHINE="ettus-e3xx-sg1" - $ bitbake gnuradio-dev-image -\endcode - -When this completes, the files needed to create the SD card are in -`tmp-glibc/deploy/images/ettus-e300`. Building the file that is written -directly to the SD card is covered later in this document. - --# Build the toolchain. -\code{.sh} - $ bitbake -c populate_sdk gnuradio-dev-image -\endcode -The sdk is in `tmp-glibc/deploy/sdk` -Note that you can set the `MACHINE` variable in `local.conf so that you no -longer need to set it from the command line. - --# Building the complete set of E3XX image files and sdk. - -There is a script in the meta-ettus BSP layer that builds SD card images for -all E3XX series devices and the sdk. - -From the build directory run: -\code{.sh} - $ sh ../meta-ettus/scripts/build-all.sh -\endcode - -When the script finishes, the SD card image files are in ./images and the sdk -is in tmp-glibc/deploy/sdk/ . - --# Using the environment -When you log back in, you will need to setup the OpenEmbedded environment -again by: - \code{.sh} - $ cd e300-oe-build/oe-core - $ . oe-core/oe-init-build-env ./build ./bitbake - \endcode - -\section e3x0_upgrade_sd_card Upgrading / Writing image to sd card - -In order to upgrade or reinitialize a sd card for the first time, you can use the 'dd' tool. -Make sure that you are using the right block device for your sd card as failing to do so can wipe your hard drive. - -Replace ``.direct with your image file name and `` with your blockdevice e.g. /dev/mmcblk0 or /dev/sdb. - - $ sudo dd if=.direct of=/dev/ bs=1M - -Notes: The commands will wipe the entire sd card and reinitialize it. Newer images need a 8GB sd card. - -\section e3x0_load_fpga_imgs Specifying a Non-standard FPGA Image - -\subsection e3x0_load_fpga_imgs_uhd Using UHD to load FPGA images - -UHD software will automatically select the USRP E310 images from the -installed images package. The image selection can be overridden with the -`fpga` device address parameter. - -Example device address string representations to specify non-standard -image: - - $ uhd_usrp_probe --args='fpga=usrp_e310_fpga.bit' - -\subsection e3x0_load_fpga_imgs_jtag Using JTAG to load FPGA images - -The USRP-E Series device features an on-board JTAG connector (see \ref e3x0_hw_chipscope) that can be accessed on the PCB -of the device. The iMPACT tool in the Xilinx Programming Tools (ISE, iMPACT) package can be used to load an image over the JTAG interface. - -If you have iMPACT installed, you can use the `impact_jtag_programmer.sh` tool to install images. Make sure your e3x0 is powered on and connected to your computer using the internal JTAG connector. Then run the tool: - - /impact_jtag_programmer.sh --fpga-path= - -\subsection e3x0_setup_change_ip Change the USRP's IP address - -You may need to change the USRP's IP address for several reasons: -- to satisfy your particular network configuration -- to use multiple USRP-E Series devices with the same host computer -- to set a known IP address into USRP (in case you forgot) - -For examples refer to the \ref e3xx_network_configuration section. - -\section e3x0_hw Hardware Notes - -\subsection e3x0_hw_fpanel Front Panel - -\image html e3x0_fp_overlay.png "USRP E310 Front panel" - -- **RF A Group** - + **TX/RX LED**: Indicates that data is streaming on the TX/RX channel on frontend side A - + **RX2 LED**: Indicates that data is streaming on the RX2 channel on frontend side A - -- **RF B Group** - + **TX/RX LED**: Indicates that data is streaming on the TX/RX channel on frontend B - + **RX2 LED**: Indicates that data is streaming on the RX2 channel on frontend B -- **PWR**: Power switch with integrated status LED, for status description see below. - -- **SYNC**: Input port for external PPS signal - -- **GPS**: Connection for the GPS antenna - -- **AUDIO**: Audio input / output - -The status LED in the power switch indicates the power and charge status. -It's behavior is firmware version dependent. - -- **Version 1** (original E310) - + **Off**: Indicates device is off and not charging - + **Solid Red**: Indicates device is charging - + **Solid Green**: Indicates device is on - + **Fast Blinking Red**: Indicates an error code - + 1 - Low voltage error - + 2 - Regulator low voltage error - + 3 - FPGA power error - + 4 - DRAM power error - + 5 - 1.8V rail power error - + 6 - 3.3V rail power error - + 7 - Daughterboard / TX power error - + 9 - Temperature error - -- **Version 2** (E312 and upgraded E310) - + **Off**: Indicates device is off and not charging - + **Slow Blinking Green**: Indicates device is off and charging - + **Fast Blinking Green**: Indicates device is on and charging - + **Solid Green**: Indicates device is on (and not charging, if E312) - + **Solid Orange**: Indicates device is on and discharging - + **Fast Blinking Orange**: Indicates device is on, discharging, and charge is below 10% charge - + **Fast Blinking Red**: Indicates an error code - + 1 - Low voltage error - + 2 - Regulator low voltage error - + 3 - FPGA power error - + 4 - DRAM power error - + 5 - 1.8V rail power error - + 6 - 3.3V rail power error - + 7 - Daughterboard / TX power error - + 8 - Charger error - + 9 - Charger temperature error - + 10 - Battery low error - + 11 - Fuel Gauge temperature error - + 12 - Global (case) temperature error - -\subsection e3x0_hw_rear_panel Rear Panel - -\image html e3x0_rp_overlay.png "USRP E310 Rear Panel" - -- **PWR**: Locking connector (Kycon KLDHCX-0202-A-LT) for the USRP-E Series power supply -- **1G ETH**: RJ45 port for Ethernet interfaces -- **USB**: USB 2.0 Port -- **SERIAL**: Micro USB connection for serial uart console - -\subsection e3x0_hw_sync Clock and Time Synchronization - -Unlike most USRP devices, the E310 does not have independent reference clock and time source inputs. -It is possible, however, to discipline the internal reference clock using an external time (PPS) source -connected to the SYNC input pin. The E310 FPGA has a subsystem that can use the PPS signal from the -SYNC pin or the internal GPS to align edges of the reference clock to edges of a shared PPS signal. -This alignment happens automatically when the time source in UHD is set to "gpsdo" or "external". -Please note that because the SYNC input can only accept a PPS signal, the only supported value for -the reference clock source is "internal". Also, keep in mind that the E310 -does *not* have a GPS-disciplined oscillator like other USRPs, the value "gpsdo" -for the time source was chosen for compatibility with other USRPs. - - -\subsection e3x0_hw_pps PPS - Pulse Per Second -Using a PPS signal for timestamp synchronization requires a LVCMOS or a 5V logic input signal. -An external PPS can be used to discipline the internal reference clock. This feature is automatically -enabled with the time source is set to "external". - -To test the PPS input, you can use the following tool from the UHD examples: - -- `` are device address arguments (optional if only one USRP device is on your machine) - - cd /lib/uhd/examples - ./test_pps_input --args=\ - -\subsection e3x0_hw_gps Internal GPS - -Your USRP-E Series device comes with an internal GPS. -In order to get a lock on a satellite an external GPS antenna is required. -The PPS from the internal GPS can be used to discipline the internal reference -clock. This feature is automatically enabled with the time source is set to -"gpsdo". Again, keep in mind that the E310 does not have an actual -GPS-disciplined oscillator (GPSDO) on the board, the value "gpsdo" was named -such for better compatibility with code written for other devices. - -The device provides a 3.3V supply voltage to an external antenna connected to the *GPS* port -of your device. Note that this supply voltage is turned off in order to safe power upon destruction of the software object. - -\subsection e3x0_hw_imu Inertial Measurement Unit (IMU) - -Your USRP-E Series device has an onboard IMU that provides -9 axis (Gyro, Accelerometer and compass) functionality. - -The USRP-E Series images ship with several example applications based on -RTIMULib that allow the user -to explore the basic functionality of the IMU as well as to calibrate it. - -To test the accelerometer, run: - - $ RTIMULibDrive - -This will print the current accelerometer values on the console. - -To launch the IMU calibration procedure, run: - - $ RTIMULibCal - -and follow the onscreen instructions. Please note that magnetometer calibration is important to obtain -sensible results if the IMU is to be used in sensor fusion applications. - -Using X11 forwarding over SSH (see \ref e3x0_faq) a complete sensor fusion application can be run over SSH -from a host computer by typing: - - $ RTIMULibDemo - -This should open a graphical window on the host computer that displays the various outputs of the IMU, -as well as quaternion measurements based on different sensor fusion algorithms. - -\image html e3x0_imu_demo.png "RTIMULibDemo" - -For more advanced IMU based applications please refer to the RTIMULib repository as well as the datasheets. - -\subsection e3x0_hw_gpio Internal GPIO - -### Connector - -\image html e3x0_gpio_conn.png "E3xx GPIO Connector" - -### Pin Mapping - -- Pin 1: +3.3V -- Pin 2: Reserved -- Pin 3: Data[5] -- Pin 4: Reserved -- Pin 5: Data[4] -- Pin 6: Data[0] -- Pin 7: Data[3] -- Pin 8: Data[1] -- Pin 9: 0V -- Pin 10: Data[2] - -Please see the \ref page_gpio_api for information on configuring and using the GPIO bus. - -\subsection e3x0_hw_audio Audio connectors (if populated) - -The E3x0 2.5 mm Audio Jack TRRS pins are assigned as follows: Tip=Mic, Ring1=Right, Ring2=Left, Sleeve=GND. - -\image html TRRS.png "Audio Jack" - -The Left/Right audio outputs are compatible with typical low-impedance headphones (16 to 32 Ohms). The Microphone pin provides approximately 2 mA bias at 2.2 V when not suspended. A variety of pin configurations can be found on commonly available headsets, so an adapter may be required. - -\subsection e3x0_hw_chipscope Debugging custom FPGA designs with Xilinx Chipscope - -### Connector - -\image html e3x0_jtag_conn.png "E3xx JTAG Connector" - -### Pin Mapping - -- Pin 1: TDO -- Pin 2: 3.3V -- Pin 3: TCK -- Pin 4: TDI -- Pin 5: 0V -- Pin 6: TMS - - -Xilinx chipscope allows for debugging custom FPGA designs similar to a logic analyzer. -USRP-E series devices can be used with Xilinx chipscope using the internal JTAG connector. - -Further information on how to use Chipscope can be found in the *Xilinx Chipscope Pro Software and Cores User Guide (UG029)*. - -\section e3xx_battery Battery notes - -The USRP E312 (and with upgraded firmware E310) supports LiIon Battery packs (e.g. AA Portable Power Corp, 749801-01). - -\subsection e3xx_battery_connector Connector - -The connector J1 on E312's motherboard is a Molex 53014-6310. The corresponding mating connector is a Molex 51004-0300. - -\image html e3xx_conn_photo.jpg "Battery pack connector" - -The pins are as follows: -- Pin 1 (Red): VBat -- Pin 2 (Black): GND -- Pin 3 (White): Battery Thermistor - -\subsection e3xx_battery_information Driver - -The battery information is exposed on the device via the sysfs directory under: - - /sys/class/power_supply/BAT/ - -and for the charger: - - /sys/class/power_supply/AC/ - -The values can be accessed via libudev or manually e.g.: - - root@ettus-e3xx: cat /sys/class/power_supply/BAT/status - -The driver emits uevents on changes, that can be used to write custom UDev rules. -Using UDev rules one can configure the USRP E3xx to shut down on certain events, -such as low battery charge, high temperatures or AC power plug in. - -The following example will cause the system to shut down at a reported temperature -of 73C: -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -SUBSYSTEM=="power_supply", ATTR{online}=="1", ATTR{temp}=="730", RUN+="/sbin/shutdown -h now" -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Another example will cause a safe shutdown once the battery level reaches 5 percent - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -SUBSYSTEM=="power_supply", ATTR{online}=="1", ATTR{status}=="Discharging", ATTR{capacity}=="5", RUN+="/sbin/shutdown -h now" -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -For more information, please see the udev manual pages and Kernel Power Supply Docs . - -\subsection e3xx_battery_calibration Calibration Procedure - -In order for the fuel gauge to give a usable indication of remaining charge it needs to be calibrated. -The procedure for calibration is as follows: - -1. Completely discharge battery (e.g. by booting up without SD card, so OS doesn't autoshutdown) -2. Unplug the battery pack and external power -3. Reconnect the battery pack -4. Reconnect AC power and charge until charge completed. - -A faster (less accurate) calibration procedure is as follows: - -1. Completely charge battery -2. Type: - - $ echo 3200000 > /sys/class/power_supply/BAT/charge_now - -3. Unplug AC power -4. Replug AC power and wait until charge completes - -\section e3x0_dboards Daughterboard notes - -\subsection e3x0_dboard_e310 E310 MIMO XCVR board - -The USRP E310 MIMO XCVR daughterboard features an integrated MIMO capable RF frontend. - -\subsubsection e3x0_dboard_e310_tuning Frontend tuning - -The RF frontend has individually tunable receive and transmit chains. -Both transmit and receive can be used in a MIMO configuration. For -the MIMO case, both receive frontends share the RX LO, and both transmit -frontends share the TX LO. Each LO is tunable between 50 MHz and 6 GHz. - -As there is a single LO for each direction (RX and TX), this means that both -channels need to use the same LO frequency (i.e., both RX channels share an LO -frequency, and both TX channels share an LO frequency). If the two channels -are supposed to receive on different frequencies, the digital tune stages need -to be used for that. The two frequencies will need to be within the currently -selected master clock rate, and the final bandwidths need to be chosen -carefully. Example: Assume the master clock rate is set to 50 MHz, and we want -to receive at 400 MHz and 440 MHz. We can set the LO to 420 MHz, which will -sample the spectrum from 395 MHz to 445 MHz. The LO offsets for both channels -need to be 20 MHz and -20 MHz respectively. However, the final bandwidth should -be less than 10 MHz (preferably lower), or the signals would exhibit aliasing. - -Because both channels share an LO, tuning one channel can possibly affect the -other channel. It is advisable to read back the actual, current frequency from -software before assuming the device is tuned to a specific frequency. - -\subsubsection e3x0_dboard_e310_gain Frontend gain - -All frontends have individual analog gain controls. The receive -frontends have 76 dB of available gain; and the transmit frontends have -89.5 dB of available gain. Gain settings are application specific, but -it is recommended that users consider using at least half of the -available gain to get reasonable dynamic range. - -\subsubsection e3x0_dboard_e310_pll Frontend LO lock status - -The frontends provide a *lo-locked* sensor that can be queried through the UHD API. - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp} -// assumes 'usrp' is a valid uhd::usrp::multi_usrp::sptr instance - -// get status for rx frontend -usrp->get_rx_sensor("lo-locked"); - -// get status for tx frontend -usrp->get_tx_sensor("lo-locked"); -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -\subsubsection e3x0_dboard_e310_band_select Frontend Filter and Antenna Switches - -The transmit and receive filter banks uses switches to select between the available filters. These paths are -also dependent on the antenna switch settings. Incorrectly setting the switches generally results -in attenuated input / output power. Receive filters are band pass (series high & low pass filters), -transmit filters are low pass. - -Source code related to controlling the filter band and antenna switches resides in e300_impl.c. Specifically, refer to methods -`e300_impl::_update_bandsel`, `e300_impl::_update_atrs`, `e300_impl::_update_gpio`, and `e300_impl::_update_enables`. Generally, these -methods set the switches depending on the state of transmit and receive streams. - -The following sections provide switch setting tables for antenna and filter selection for frontends A & B receive and transmit paths. -For further details refer to the schematics. - -\subsubsection e3x0_dboard_e310_frontend_a_switches Frontend Side A Filter and Antenna Switches - -_Note: X = don't care, T = If full duplex, set bits according to transmit table, otherwise don't care. -Filter range A – B will be selected if A <= freq < B._ - -__Receive__ -RX Port | RX Filter (MHz) | VCTXRX2_V1,V2 | VCRX2_V1,V2 | RX2_BANDSEL[2:0] | RX2B_BANDSEL[1:0] | RX2C_BANDSEL[1:0] -:-----: | :-------------: | :-----------: | :---------: | :--------------: | :---------------: | :---------------: -TRX-A | < 450 | 01 | 10 | 101 | XX | 01 -TRX-A | 450 – 700 | 01 | 10 | 011 | XX | 11 -TRX-A | 700 – 1200 | 01 | 10 | 001 | XX | 10 -TRX-A | 1200 – 1800 | 01 | 10 | 000 | 01 | XX -TRX-A | 1800 – 2350 | 01 | 10 | 010 | 11 | XX -TRX-A | 2350 – 2600 | 01 | 10 | 100 | 10 | XX -TRX-A | 2600 – 6000 | 01 | 01 | XXX | XX | XX -RX2-A | 70 – 450 | TT | 01 | 101 | XX | 01 -RX2-A | 450 – 700 | TT | 01 | 011 | XX | 11 -RX2-A | 700 – 1200 | TT | 01 | 001 | XX | 10 -RX2-A | 1200 – 1800 | TT | 01 | 000 | 01 | XX -RX2-A | 1800 – 2350 | TT | 01 | 010 | 11 | XX -RX2-A | 2350 – 2600 | TT | 01 | 100 | 10 | XX -RX2-A | >= 2600 | TT | 10 | XXX | XX | XX - -__Transmit__ -TX Port | TX Filter (MHz) | VCTXRX2_V1,V2 | TX_ENABLE2A,2B | TX_BANDSEL[2:0] -:-----: | :-------------: | :-----------: | :------------: | :-------------: -TRX-A | < 117.7 | 10 | 01 | 111 -TRX-A | 117.7 – 178.2 | 10 | 01 | 110 -TRX-A | 178.2 – 284.3 | 10 | 01 | 101 -TRX-A | 284.3 – 453.7 | 10 | 01 | 100 -TRX-A | 453.7 – 723.8 | 10 | 01 | 011 -TRX-A | 723.8 – 1154.9 | 10 | 01 | 010 -TRX-A | 1154.9 – 1842.6 | 10 | 01 | 001 -TRX-A | 1842.6 – 2940.0 | 10 | 01 | 000 -TRX-A | >= 2940.0 | 11 | 10 | XXX -_Note: Although the transmit filters are low pass, this table describes UHD's tuning range for selecting each filter path. -The table also includes the required transmit enable state._ - -\subsubsection e3x0_dboard_e310_frontend_b_switches Frontend Side B Filter and Antenna Switches - -_Note: X = don't care, T = If full duplex, set bits according to transmit table, otherwise don't care. -Filter range A – B will be selected if A <= freq < B._ - -__Receive__ -RX Port | RX Filter (MHz) | VCTXRX1_V1,V2 | VCRX1_V1,V2 | RX1_BANDSEL[2:0] | RX1B_BANDSEL[1:0] | RX1C_BANDSEL[1:0] -:-----: | :-------------: | :-----------: | :---------: | :--------------: | :---------------: | :---------------: -TRX-B | < 450 | 10 | 01 | 100 | XX | 10 -TRX-B | 450 – 700 | 10 | 01 | 010 | XX | 11 -TRX-B | 700 – 1200 | 10 | 01 | 000 | XX | 01 -TRX-B | 1200 – 1800 | 10 | 01 | 001 | 10 | XX -TRX-B | 1800 – 2350 | 10 | 01 | 011 | 11 | XX -TRX-B | 2350 – 2600 | 10 | 01 | 101 | 01 | XX -TRX-B | 2600 – 6000 | 10 | 10 | XXX | XX | XX -RX2-B | 70 – 450 | TT | 01 | 100 | XX | 10 -RX2-B | 450 – 700 | TT | 01 | 010 | XX | 11 -RX2-B | 700 – 1200 | TT | 01 | 000 | XX | 01 -RX2-B | 1200 – 1800 | TT | 01 | 001 | 10 | XX -RX2-B | 1800 – 2350 | TT | 01 | 011 | 11 | XX -RX2-B | 2350 – 2600 | TT | 01 | 101 | 01 | XX -RX2-B | >= 2600 | TT | 10 | XXX | XX | XX - -__Transmit__ -TX Port | TX Filter (MHz) | VCTXRX1_V1,V2 | TX_ENABLE1A,1B | TX1_BANDSEL[2:0] -:-----: | :-------------: | :-----------: | :------------: | :--------------: -TRX-B | < 117.7 | 00 | 01 | 111 -TRX-B | 117.7 – 178.2 | 00 | 01 | 110 -TRX-B | 178.2 – 284.3 | 00 | 01 | 101 -TRX-B | 284.3 – 453.7 | 00 | 01 | 100 -TRX-B | 453.7 – 723.8 | 00 | 01 | 011 -TRX-B | 723.8 – 1154.9 | 00 | 01 | 010 -TRX-B | 1154.9 – 1842.6 | 00 | 01 | 001 -TRX-B | 1842.6 – 2940.0 | 00 | 01 | 000 -TRX-B | >= 2940.0 | 11 | 10 | XXX -_Note: Although the transmit filters are low pass, the following table describes UHD's tuning range for selecting each filter path. -The table also includes the required transmit enable states._ - -\section e3xx_network_configuration Network configuration - -Your USRP E3XX Series device can be configured by editing the /etc/network/interfaces.
-The device defaults to *DHCP*, meaning it will query the local network's DHCP server for an address. - -\subsection e3xx_network_dhcp DHCP - -The default configuration should look similar to, instructing your device to query -local DHCP servers for an IP address, gateway, etc. -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -auto eth0 -iface eth0 inet dhcp -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -In order to change the hostname used to obtain an IP address via DHCP change - - /etc/hostname - -and edit: - - /etc/network/interfaces - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -auto eth0 -iface eth0 inet dhcp - hostname your-hostname -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Note: In rare occasions it might be necessary to increase the timeout value -for the dhcp client running on the device in order for autoconfiguration -to succeed. - -In order to increase the timeout to e.g. 40 seconds edit: - - /etc/network/interfaces - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -auto eth0 -iface eth0 inet dhcp - hostname your-hostname - udhcpc_opts -t 40 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -\subsection e3xx_network_static Static IP - -To configure a static IP address edit - - /etc/network/interfaces - -to look like - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -auto eth0 -iface eth0 inet static - address your-ip - netmask your-netmask - gateway your-gateway -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -\section e3x0_misc Miscellaneous - -\subsection e3x0_misc_multirx Multiple RX channels - -There are two complete DDC and DUC DSP chains in the FPGA. In the single channel case, -only one chain is ever used. To receive / transmit from both channels, the user must set the **RX** or **TX** -subdevice specification. - -In the following example, a E310 MIMO XCVR is installed. -Channel 0 is sourced from subdevice **A**, -and channel 1 is sourced from subdevice **B** - -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp} -// assumes 'usrp' is a valid uhd::usrp::multi_usrp::sptr instance - -usrp->set_rx_subdev_spec("A:A A:B"); -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -\subsection e3x0_misc_sensors Available Sensors - -The following sensors are available for the USRP-E Series motherboards; -they can be queried through the API. - -- **fe_locked** - rx / tx frontend PLL locked -- **temp** - processor temperature value -- **gps_time** and **gps_locked** sensors are added when the GPS is found - -\subsection e3x0_network_mode Network Mode - -Your USRP-E series device can be used in network mode for narrow band signal observation, evaluation and debugging purposes. See the instructions below for how to use network mode. - -Please note that when compared with normal operation as a standalone device the usable bandwidth is limited and therefore Network Mode is not the recommended mode of operation. - -\subsubsection e3x0_uhd_build Building UHD - -To work with your E-Series device in network mode, you will need to build UHD on your PC with extra CMake flags. Assuming you are in the host/build directory, -see below: - - $ cmake -DENABLE_E300=ON -DE300_FORCE_NETWORK=ON .. - $ make - -Once UHD is installed on your device, it will be able to interact with an E-Series device with network mode active (see below). - -\subsubsection e3x0_activating_network Activating Network Mode on the Device - -In order to use the device in network mode it is necessary to start the *usrp_e3x0_network_mode* executable on the device. -In order to start the executable please log into your device either via SSH or serial console(see \ref e3x0_first_boot) and type - - $ usrp_e3x0_network_mode - -Your device should now be discoverable by your host computer via the usual UHD tools. If you are having trouble communicating with your device see the \ref e3x0_comm_problems section. - -\subsubsection e3x0_addressing Addressing the Device - -### Single device configuration - -In a single-device configuration, -the USRP device must have a unique IPv4 address on the host computer. -The USRP can be identified through its IPv4 address or resolvable hostname. -See the application notes on \ref page_identification. -Use this addressing scheme with the uhd::usrp::multi_usrp interface (not a typo!). - -Example device address string representation for a USRP-E Series device with IPv4 address 192.168.10.2: - - addr=192.168.10.2 - -### Multiple device configuration - -In a multi-device configuration, -each USRP device must have a unique IPv4 address on the host computer. -The device address parameter keys must be suffixed with the device index. -Each parameter key should be of the format \\. -Use this addressing scheme with the uhd::usrp::multi_usrp interface. - -- The order in which devices are indexed corresponds to the indexing of the transmit and receive channels. -- The key indexing provides the same granularity of device identification as in the single device case. - -Example device address string representation for 2 USRPs with IPv4 addresses **192.168.10.2** and **192.168.20.2**: - - addr0=192.168.10.2, addr1=192.168.20.2 - -\subsection e3xx_nfs_root Booting from a NFS root - -Booting your device from a NFS root might be desirable for remote deployment, management or similar applications. - -Requirements: - -- NFS server (for configuration see your Linux distribution's documentation) -- dtc (devicetree compiler) -- Filesystem image - -\subsubsection e3xx_nfs_root_extract Extracting the filesystems - -The first step to make a root filesystem available via NFS is to extract the root file system. -This can be done as follows: - - $ sfdisk -l -uS .direct - -Which should produce output similar to: - - Disk release3-image.direct: 7 GiB, 7516197888 bytes, 14680074 sectors - Units: sectors of 1 * 512 = 512 bytes - Sector size (logical/physical): 512 bytes / 512 bytes - I/O size (minimum/optimal): 512 bytes / 512 bytes - Disklabel type: dos - Disk identifier: 0x8bc3587b - - Device Boot Start End Sectors Size Id Type - release3-image.direct1 * 8 36871 36864 18M c W95 FAT32 (LBA) - release3-image.direct2 36872 14680071 14643200 7G 83 Linux - -From this one can see the second partition (root filesystem) starts at sector *36872*, -and has a length of *14680071*. We can use the *dd* tool to extract the root filesystem -into a handy file. - - $ dd if=.direct of=.direct offset=36872 count=14643200 - -The same procedure can be done for the boot partition. - - $ dd if=.direct of=.direct offset=8 count=36864 - -Both of these files are mountable on your NFS server, e.g. by: - - $ mount .direct /srv/nfs/root-e3xx - $ mount .direct /srv/nfs/root-e3xx/media/FAT - -Copy the uImage, uEnv.txt, u-boot.img, boot.bin from the extracted boot partition to the -boot partition of your device's card. - -Use the devicetree compiler to modify e300-devicetree.dtb file as follows: - - $ dtc -I dtb -O dts e300-devicetree.dtb -o e300-devicetree.dts - -Using your editor of choice modify the *chosen* property in e300-devicetree.dts from: - - console=ttyPS0,115200 root=/dev/mmc0blkp2 rw rootwait earlyprintk - -to: - - console=ttyPS0,115200 root=/dev/nfs rw nfsroot=:,vers=3 rootwait ip=dhcp earlyprintk - -Use the devicetree compiler to compile the modified devicetree as follows: - - $ dtc e300-devicetree.dts -o e300-devicetree.dtb - -Copy the modified *e300-devicetree.dtb* to your device's card. - -For more information on server configuration please refer to your Linux distribution's NFS Server manual, -for more information about NFS root see the -Linux Kernel NFS Root documentation - -\section e3x0_comm_problems Communication Problems - -When setting up a development machine for the first time, -you may have various difficulties communicating with the USRP device. -The following tips are designed to help narrow down and diagnose the problem. - -\subsection e3x0_comm_problems_runtimeerr RuntimeError: no control response - -This is a common error that occurs when you have set the subnet of your network -interface to a different subnet than the network interface of the USRP device. For -example, if your network interface is set to **192.168.20.1**, and the USRP device is **192.168.10.2** -(note the difference in the third numbers of the IP addresses), you -will likely see a 'no control response' error message. - -Fixing this is simple - just set the your host PC's IP address to the same -subnet as that of your USRP device. Instructions for setting your IP address are in the -previous section of this documentation. - -\subsection e3x0_comm_problems_firewall Firewall issues - -When the IP address is not specified, -the device discovery broadcasts UDP packets from each Ethernet interface. -Many firewalls will block the replies to these broadcast packets. -If disabling your system's firewall -or specifying the IP address yields a discovered device, -then your firewall may be blocking replies to UDP broadcast packets. -If this is the case, we recommend that you disable the firewall -or create a rule to allow all incoming packets with UDP source port **49152**. - -\subsection e3x0_comm_problems_ping Ping the device -The USRP device will reply to ICMP echo requests ("ping"). -A successful ping response means that the device has booted properly -and that it is using the expected IP address. - - ping 192.168.10.2 - -\subsection e3x0_comm_problems_monitor Monitor the host network traffic -Use Wireshark to monitor packets sent to and received from the device. - -\subsection e3x0_comm_problems_leds Observe Ethernet port LEDs -When there is network traffic arriving at the Ethernet port, LEDs will light up. -You can use this to make sure the network connection is correctly set up, e.g. -by pinging the USRP and making sure the LEDs start to blink. - - -\subsection e3x0_faq Frequently Asked Questions - - - Communication - -# How do I enable X forwarding so I can run X apps on the E3x0?
- In the file `/etc/ssh/sshd_config`, uncomment the line \#`X11Forwarding no` - and change "no" to "yes". - - - Firmware - -# With Firmware 2.0 the device no longer turns on when AC power is plugged.
- This setting can be adjusted via `/sys/devices/axi_pmu.3/autoboot`. - - Using `$ echo 1 > /sys/devices/axi_pmu.3/autoboot` autoboot is turned on. - - Using `$ echo 0 > /sys/devices/axi_pmu.3/autoboot` autoboot is turned off. - - Note that the path above is subject to change depending on device tree changes. - -\section e3x0_apps Applications - -\subsection e3x0_apps_gsm GSM Base Station - -OpenBTS allows the USRP E310 to serve as a GSM base station capable of providing voice and messaging services to standard GSM handsets. General information on the OpenBTS project can be found at the official webpage. - -http://www.openbts.org - -Special instructions to install OpenBTS on the E310 can be found on the OpenBTS wiki. - -http://openbts.org/w/index.php/E3x0 - - -*/ -// vim:ft=doxygen: diff --git a/host/docs/usrp_e3xx.dox b/host/docs/usrp_e3xx.dox new file mode 100644 index 000000000..9382388a3 --- /dev/null +++ b/host/docs/usrp_e3xx.dox @@ -0,0 +1,1287 @@ +/*! \page page_usrp_e3xx USRP E3xx Series + +\tableofcontents + +\section e3xx_feature_list Comparative features list +There are two category of devices in the E3xx series. +1. E310 series which includes E310, E312 and E313. +2. E320 - OEM board-only and with enclosure. + +These devices have some differences in their hardware capabilities but both +are 2-channel transmitter/receiver based on the AD9361 transceiver IC and +provide two RF channels: + +- TX band: 47 MHz to 6.0 GHz +- RX band: 70 MHz to 6.0 GHz +- 56 MHz of instantaneous bandwidth +- 2 RX DDC chains in FPGA +- 2 TX DUC chain in FPGA + +\subsection e3xx_feature_list_e310 E310 +The E310/E312/E313 has a motherboard and a daughterboard in an enclosed module +with one AD9361 IC with 2 RF channels. + +- Hardware Capabilities: + - External PPS reference input + - 2 USB 2.0 Host ports + - Configurable clock rate + - Internal IMU + - Internal GPS + - Internal GPIO connector with UHD API control + - External USB Connection for built-in JTAG debugger and serial console + - Xilinx Zynq SoC with dual-core ARM Cortex A9 (Speed Grade 1 and 3) and + Kintex-7 FPGA (XC7Z020) +- Software Capabilities: + - Full Linux system running on the ARM core + - Runs MPM (see also \ref page_mpm) (introduced in UHD v3.15.0.0) +- FPGA Capabilities: + - RFNoC capability + +\subsection e3xx_feature_list_e320 E320 +The E320 is monolithic board with one AD9361 IC with 2 RF channels. + +- Hardware Capabilities: + - Single SFP+ Transceivers (can be used with 1 GigE, 10 GigE, and Aurora) + - External PPS input + - External 10 MHz input + - Configurable clock rate + - Internal IMU + - Internal GPSDO for timing, location, and 10 MHz reference clock + PPS + - External GPIO Connector with UHD API control + - External USB Connection for built-in JTAG debugger and serial console + - Xilinx Zynq SoC with dual-core ARM Cortex A9 (Speedgrade 3) and + Kintex-7 FPGA (XC7Z045) + - Fan connector (for board-only version) +- Software Capabilities: + - Full Linux system running on the ARM core + - Runs MPM (see also \ref page_mpm) +- FPGA Capabilities: + - RFNoC capability + +\section e310_overview E310 Overview + +\subsection e310_zynq The Zynq CPU/FPGA and host operating system + +The main CPU of the E310 is a Xilinx Zynq SoC XC7Z020. It +is both a dual-core ARM Cortex A9 CPU and Kintex-7 FPGA on a single die. The +CPU is clocked at 667 MHz (speed grade 1) and 866 MHz (speed grade 3). + +The programmable logic (PL, or FPGA) section of the SoC is responsible for +handling all sampling data, DMA connections, and any other +high-speed utility such as custom RFNoC logic. The processing system (PS, or CPU) +is running a custom-build OpenEmbedded-based Linux operating system. The OS is +responsible for all the device and peripheral management, such as running MPM +(see section \ref page_mpm), running local, UHD sessions, etc. + +\subsection e31x_migration E310 Migration Guide to MPM architecture + +This section covers the details for porting your E310 to the new MPM architecture. +MPM is a hardware daemon running on the Linux operating system on the ARM cores +and responsible for the device to function as a USRP. + +A large portion of hardware-specific setup is handled by the daemon. + +Note that the SD cards shipped with E310s do not contain the latest filesystem images. In order +to use MPM (see section \ref page_mpm) and all its features, the SD cards need to be +manually flashed. Refer to \ref update_sdcard in order to upgrade to E310 with UHD v3.15.0.0 or above. + +After updating the SD card, you should be able to connect your device to the host OS either via SSH or +serial console. See sections \ref e3xx_getting_started_ssh and \ref e3xx_getting_started_serial +respectively, for more details. + +Once you are logged in on the device, you should be able to run uhd_usrp_probe or other UHD examples. + +Here is a list of a changes with the latest E310 filesystem (UHD v3.15.0.0) that can affect customer usage +and applications: + +1. Hostname: +The hostname for the devices have changed from ni-e3xx(-sg3) to ni-e31x-. +This makes it easier to identify devices. You can change the hostname by modifying the +`/etc/hostname` file and rebooting. + +2. "product" name: +The "product" name for E310 is now "e310_" i.e. e310_sg1 and e310_sg3 for speed grade 1 +and 3 respectively. Note that the "type" for e310 remains the same as before i.e. "e3xx". + +3. FPGA bit/bin/rpt file name and image target: + FPGA type | Old filename | New filename + -----------------------------------|-----------------------------|--------------------------------- + IDLE Image (power saving mode) SG1 | usrp_e3xx_fpga_idle.bit | usrp_e310_sg1_idle_fpga.bit + IDLE Image (power saving mode) SG3 | usrp_e3xx_fpga_idle_sg3.bit | usrp_e310_sg3_idle_fpga.bit + NORMAL Image SG1 | usrp_e310_fpga.bit | usrp_e310_sg1_fpga.bit + NORMAL Image SG3 | usrp_e310_fpga_sg3.bit | usrp_e310_sg3_fpga.bit + + The names of the FPGA build targets have been modified but the old FPGA targets would continue to + work as before. The generated bit files names in the build directory will be new as + mentioned above. + - E310_ for default image + - E310__RFNOC for RFNOC image (contains a few blocks) + - E310__IDLE to build idle image (Doesn't need to modified for most cases) + +4. Loading FPGA image: +The device arg "fpga=" can now only be used in the uhd_image_loader; it can no longer be used to +update the fpga image in other UHD applications. This tooling now matches X310, E320, N3XX, etc. +devices. See section \ref e3xx_getting_started_fpga_update for details. + +5. With UHD v3.15.0.0. or higher, a lot of UHD dependencies have been upgraded too e.g. Boost, CMake, +etc. The filesystem now runs a newer Linux kernel (e.g. linux-yocto_4.15 or higher). Existing customer +applications might need to be updated in order to use the new filesystem and new UHD. + +6. In order to build a custom filesystem, refer to \ref e3xx_fsbuild for more details. + +7. E310 filesystem no longer contains GNURadio by default. Custom filesystems are need to run GNURadio. + +8. The network mode (streaming through RJ-45) for the E310 is not supported. In order to use the network +mode use UHD 3.9 LTS release. + +9. Refer section \ref e312_battery for changes related to the battery. + +10. Subdev spec has been changed from "A:A and A:B" to "A:0 and A:1" to match X310, N3xx and E320. + + +\section e320_overview E320 Overview + +\subsection e320_zynq The Zynq CPU/FPGA and host operating system + +The main CPU of the E320 is a Xilinx Zynq SoC XC7Z045. It +is both a dual-core ARM Cortex A9 CPU and Kintex-7 FPGA on a single die. The +CPU is clocked at 1GHz (speed grade 3). + +The programmable logic (PL, or FPGA) section of the SoC is responsible for +handling all sampling data, the 1/10 GigE network connections, and any other +high-speed utility such as custom RFNoC logic. The processing system (PS, or CPU) +is running a custom-build OpenEmbedded-based Linux operating system. The OS is +responsible for all the device and peripheral management, such as running MPM +(see section \ref page_mpm), configuring the network interfaces, running local +UHD sessions, etc. + +It is possible to connect to the host OS either via SSH or serial console (see +sections \ref e3xx_getting_started_ssh and \ref e3xx_getting_started_serial, +respectively). + +\subsection e320_micro The STM32 microcontroller + +The STM32 microcontroller controls various low-level features of the E320 series +motherboard: It controls the power sequencing, reads out fan speeds and some of +the temperature sensors. It is connected to the Zynq via an I2C bus. + +It is possible to log into the STM32 using the serial interface +(see \ref e320_getting_started_serial_micro). This will allow certain low-level +controls, such as remote power cycling should the CPU have become unresponsive +for whatever reason. + +\subsection e3xx_sdcard The SD card + +The E310/E312/E313/E320 use a micro SD card as its main storage. The entire root file +system (Linux kernel, libraries) and any user data are stored on this SD card. + +The SD card is partitioned into four partitions: + +- Boot partition (contains the bootloader). This partition usually does not + require any modifications. +- A data partition, mounted in /data. This is the only partition that is not + erased during file system updates. +- Two identical system partitions (root file systems). These contain the + operating system and the home directory (anything mounted under / that is not + the data or boot partition). The reason there are two of these is to enable + remote updates: An update running on one partition can update the other one + without any effect to the currently running system. Note that the system + partitions are erased during updates and are thus unsuitable for permanently + storing information. + +Note: It is possible to access the currently inactive root file system by +mounting it. After logging into the device using serial console or SSH (see the +following two sections), run the following commands: + + $ mkdir temp + $ mount /dev/mmcblk0p3 temp + $ ls temp # You are now accessing the idle partition: + bin data etc lib media proc sbin tmp usr + boot dev home lost+found mnt run sys uboot var + +The device node in the mount command will likely differ, depending on which +partition is currently already mounted. + +\section e3xx_getting_started Getting started + +This will run you through the first steps relevant to getting your USRP E3XX +up and running. +Note: This guide was creating on an Ubuntu machine, and other distributions +or OS's may have different names/methods. + +\subsection e3xx_getting_started_assembling Assembling the E3XX + +Unlike the X300 or N200 series, there is no assembly required for all E3xx devices +as E310 motherboard and daughterboard comes in an enclosure and E320, on the other +hand is a monolithic board (in board-only version) or comes in an enclosure. + +Checklist: +- Connect power and network +- Read security settings +- Connect clocking (if required) + +\subsection e3xx_getting_started_fs_update Updating the file system + +\subsubsection e31x_fs E310/E312/E313 file system + +The SD cards shipped with E310s do not contain the latest filesystem images. In order +to use MPM and all its features, the SD cards need to be manually flashed. Refer to +\ref update_sdcard in order to upgrade to E310 with UHD v3.15.0.0 or above. Once it has +been upgraded to the new filesystem, Mender can be used to remotely update the filesystems. +For details on using Mender, see Section \ref e3xx_rasm_mender. + +\subsubsection e320_fs E320 file system + +Before doing any major work with a newly acquired USRP E320, it is +recommended to update the file system. For the OEM/Board-only version of +E320, the SD card is physically accessible and filesystem update can be +accomplished directly by using Mender or externally by manually writing +an image onto a micro SD card and inserting it. For the +enclosure version of E320, Mender update is required as there is no direct +physical access to the device. For details on using Mender, +see Section \ref e3xx_rasm_mender . + +\subsubsection update_sdcard Updating the SD card + +Manual updating is simply loading an image on the micro SD card. The first step +in that process is to obtain an image. + +To obtain the default micro SD card image for a specific version of UHD, install +that version of UHD (E320 - 3.13.0.2 or later, E310 - 3.15.0.0 or later) on a host system with Internet access and run: + + $ uhd_images_downloader -t -t sdimg + + The image will be downloaded to + `/share/uhd/images/usrp__fs.sdimg`, + where `` is the UHD installation directory. + +To load an image onto the micro SD card, connect the card to the host and run: + + $ sudo dd if= of=/dev/ bs=1M + + The `` is the path to the micro SD card image + (i.e.`/share/uhd/images/usrp__fs.sdimg`). + + The `` device node depends on your operating system and which + other devices are plugged in. Typical values are `sdb` or `mmcblk0`.
+ + CAUTION: The Linux utility `dd` or `bmap` can cause unrecoverable data loss + if the incorrect disk is selected, or if the parameters are input incorrectly. + Ensure you have selected the correct input and output parameters for your + system configuration. + +The micro SD card used can be the original SD card shipped with the device or +another one that is at least 8GB for E310 and at least 16 GB for E320 in size. + +\section e3xx_fsbuild Building custom filesystems and SD card images + +Ettus Research provides SD card images at regular intervals, but there can be +good reasons to build custom SD cards, e.g., to test the very latest UHD or MPM +for which there has not been an SD card release, to add own applications to the +SD card, or to run a modified version of UHD. + +Note that building SD cards is very disk space and RAM intensive. + +\subsection e3xx_fsbuild_docker Using Docker to build filesystems + +Ettus Research provides a Docker containers to facilitate building filesystems. +Refer to the README for more details. + +\subsection e3xx_getting_started_serial Serial connection + +It is possible to gain root access to the device using a serial terminal +emulator. Most Linux, OSX, or other Unix flavours have a tool called 'screen' +which can be used for this purpose, by running the following command: + + $ sudo screen /dev/ttyUSB2 115200 + +In this command, we prepend 'sudo' to elevate user privileges (by default, +accessing serial ports is not available to regular users), we specify the +device node (in this case, `/dev/ttyUSB2`), and the baud rate (115200). + +The exact device node depends on your operating system's driver and other USB +devices that might be already connected. Modern Linux systems offer alternatives +to simply trying device nodes; instead, the OS might have a directory of +symlinks under `/dev/serial/by-id`: + +For E310: + + $ ls /dev/serial/by-id + /dev/serial/by-id/usb-FTDI_FT230X_Basic_UART_DQ0041HO-if00-port0 + +For E320: + + $ ls /dev/serial/by-id + /dev/serial/by-id/usb-FTDI_Dual_RS232-HS-if00-port0 + /dev/serial/by-id/usb-FTDI_Dual_RS232-HS-if01-port0 + /dev/serial/by-id/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6A6C-if00-port0 + /dev/serial/by-id/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6A6C-if01-port0 + +Note: Exact names depend on the host operating system version and may differ. + +Every E310 device connected to USB will by default show up as one +device. The device labeled "FTDI_FT230X_Basic_UART_DQ0041HO" connects +to Linux. + +Every E320 device connected to USB will by default show up as four +different devices. The devices labeled "USB_to_UART_Bridge_Controller" are the +devices that offer a serial prompt. The one with the `if01` suffix connects +to Linux, whereas the one with `if00` suffix connects to the STM32 microcontroller. +If you have multiple E320 devices connected, you may have to try out multiple +devices. In this case, to use this symlink instead of the raw device node +address, modify the command above to: + +For E310: + + $ sudo screen /dev/serial/by-id/usb-FTDI_FT230X_Basic_UART_DQ0041HO-if00-port0 115200 + +For E320: + + $ sudo screen /dev/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6A6C-if01-port0 115200 + +You should be presented with a shell prompt similar to the following: + + root@ni--:~# + +On this prompt, you can enter any Linux command available. Using the default +configuration, the serial console will also show all kernel log messages (unlike +when using SSH, for example), and give access to the boot loader (U-boot +prompt). This can be used to debug kernel or bootloader issues more efficiently +than when logged in via SSH. + +\subsubsection e320_getting_started_serial_micro Connecting to the microcontroller + +The STM32 microcontroller (which controls the power sequencing, among other +things) also has a serial console available. To connect to the microcontroller, +use the other UART device. In the example above: + + $ sudo screen /dev/usb-Silicon_Labs_CP2105_Dual_USB_to_UART_Bridge_Controller_007F6CB5-if00-port0 115200 + +It provides a very simple prompt. The command 'help' will list all available +commands. A direct connection to the microcontroller can be used to hard-reset +the device without physically accessing it (i.e., emulating a power button press) +and other low-level diagnostics. + +\subsection e3xx_getting_started_ssh SSH connection + +The USRP E310 devices have just one network connection: RJ-45 connector while the +USRP E320 has two network connections: One SFP port, and an RJ-45 connector. + +The RJ-45 connection is by default configured by DHCP; by plugging it into a 1 Gigabit +switch on a DHCP-capable network, it will get assigned an IP address and thus be +accessible via ssh. + +In case your network setup does not include a DHCP server, refer to the section +\ref e3xx_getting_started_serial. A serial login can be used to assign an IP address manually. + +After the device obtained an IP address you can log in from a Linux or OSX +machine by typing: + + $ ssh root@ni-- # Replace with your actual device name! + +Depending on your network setup, using a `.local` domain may work: + + $ ssh root@ni--.local + +Of course, you can also connect to the IP address directly if you know it (or +set it manually using the serial console). + +Note: The device's hostname is derived from its serial number by default +(`ni--`). You can change the hostname by modifying the `/etc/hostname` +file and rebooting. + +On Microsoft Windows, the connection can be established using a tool such as +Putty, by selecting a username of root without password. + +Like with the serial console, you should be presented with a prompt like the +following: + + root@ni--:~# + +\subsection e3xx_getting_started_connectivity Network Connectivity + +The RJ45 port (eth0) comes up with a default configuration of DHCP, +that will request a network address from your DHCP server (if available on your +network). + +The factory settings are as follows: + + eth0 (DHCP): + + [Match] + Name=eth0 + + [Network] + DHCP=v4 + + [DHCPv4] + UseHostname=false + +E320 has an extra SFP+ (sfp0) port which is configured with static address 192.168.10.2/24. +The configuration for the sfp0 port is stored in /etc/systemd/networkd/sfp0.network. + +For configuration please refer to the +systemd-networkd manual pages + +The factory settings are as follows: + + sfp0 (static): + + [Match] + Name=sfp0 + + [Network] + Address=192.168.10.2/24 + + [Link] + MTUBytes=8000 + +Note: Care needs to be taken when editing these files on the device, since +vi / vim sometimes generates undo files (e.g. /etc/systemd/networkd/sfp0.network~), +that systemd-networkd might accidentally pick up. + +Note: Temporarily setting the IP addresses via ifconfig etc will only change the +value until the next reboot or reload of the FPGA image. + +\subsection e3xx_getting_started_security Security-related settings + +The E320 ships without a root password set. It is possible to ssh into the +device by simply connecting as root, and thus gaining access to all subsystems. +To set a password, run the command + + $ passwd + +on the device. + +\subsection e3xx_getting_started_fpga_update Updating the FPGA + +Updating the FPGA follows the same procedure as other USRPs. Use the `uhd_image_loader` +command line utility to upload a new FPGA image onto the device. The command can be run +on the host to load the image via RJ-45 network connection or it can be run on the +device. + +A common reason to update the FPGA image is in the case of a UHD/FPGA compat +number mismatch (for example, if UHD has been updated, and now expects a newer +version of the FPGA than is on the device). In this case, simply run + + $ uhd_images_downloader + +to update the local cache of FPGA images. Then, run + + $ uhd_image_loader --args type=e3xx,addr=ni-- + +to update the FPGA using the default settings. Replace the addr above with the +correct device address. If a custom FPGA image is targeted for uploading, use the +`--fpga-path` command line argument. Run + + $ uhd_image_loader --help + +to see a full list of command line options. Note that updating the FPGA image +will force a reload of the FPGA, and in case of E320 it will temporarily take down +the SFP network interfaces (and temporary settings, such as applied via `ifconfig` +on the command line, will be lost). + + +\section e3xx_usage Using an E3XX USRP from UHD + +Like any other USRP, all E series USRPs are controlled by the UHD software. To +integrate a USRP E310/E312/E313/E320 into your C++ application, you would generate a UHD +device in the same way you would for any other USRP: + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp} +auto usrp = uhd::usrp::multi_usrp::make("type=e3xx"); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For a list of which arguments can be passed into make(), see Section +\ref e3xx_usage_device_args. + +\subsection e3xx_usage_device_args Device arguments + + Key | Description | Example Value +---------------------|-------------------------------------------------------------------------------|--------------------- + addr | IPv4 address of primary SFP+/RJ-45 port to connect to | addr=192.168.30.2 + find_all | When using broadcast, find all devices, even if unreachable via CHDR. | find_all=1 + master_clock_rate | Master Clock Rate in Hz. Default is 16 MHz. | master_clock_rate=30.72e6 + skip_dram | Ignore DRAM FIFO block. Connect TX streamers straight into DUC or radio. | skip_dram=1 + skip_ddc | Ignore DDC block. Connect Rx streamers straight into radio. | skip_ddc=1 + skip_duc | Ignore DUC block. Connect Tx streamers or DRAM straight into radio. | skip_duc=1 + skip_init | Skip the initialization process for the device. | skip_init=1 + discovery_port | Override default value for MPM discovery port. | discovery_port=49700 + rpc_port | Override default value for MPM RPC port. | rpc_port=49701 + +\subsection e3xx_usage_sensors The sensor API + +\subsubsection e310_sensors E31X Sensors + +Like other USRPs, the E310 series has RF and motherboard sensors. +When using uhd::usrp::multi_usrp, the following API calls are relevant to +interact with the sensor API: + +- uhd::usrp::multi_usrp::get_mboard_sensor_names() +- uhd::usrp::multi_usrp::get_mboard_sensor() +- uhd::usrp::multi_usrp::get_tx_sensor_names() +- uhd::usrp::multi_usrp::get_rx_sensor_names() +- uhd::usrp::multi_usrp::get_tx_sensor() +- uhd::usrp::multi_usrp::get_rx_sensor() + +The following motherboard sensors are always available: +- `temp_fpga`: temperature (in Celsius) of the FPGA die +- `temp_mb`: temperature (in Celsius) of the motherboard +- `ref_locked`: This will check that all the daughter boards have locked to the +reference clock. + +\subsubsection e320_sensors E320 Sensors + +Like other USRPs, the E320 series has RF and motherboard sensors. +When using uhd::usrp::multi_usrp, the following API calls are relevant to +interact with the sensor API: + +- uhd::usrp::multi_usrp::get_mboard_sensor_names() +- uhd::usrp::multi_usrp::get_mboard_sensor() +- uhd::usrp::multi_usrp::get_tx_sensor_names() +- uhd::usrp::multi_usrp::get_rx_sensor_names() +- uhd::usrp::multi_usrp::get_tx_sensor() +- uhd::usrp::multi_usrp::get_rx_sensor() + +The following motherboard sensors are always available: +- `temp_internal`: temperature (in Celsius) of Temperature Sensor on board +- `temp_fpga`: temperature (in Celsius) of the FPGA die +- `temp_rf_channelA`: temperature (in Celsius) near power amplifier RF A +- `temp_rf_channelB`: temperature (in Celsius) near power amplifier RF B +- `temp_main_power`: temperature (in Celsius) near power supply +- `gps_locked`: GPS lock +- `gps_time`: GPS time in seconds sin ce the epch +- `gps_tpv`: A TPV report from GPSd serialized as JSON +- `gps_sky`: A SKY report from GPSd serialized as JSON +- `ref_locked`: This will check that all the daughter boards have locked to the +external/internal reference clock. +- `fan`: get fan speed (in rpm) + +\section e3xx_rasm Remote Management + +\subsection e3xx_rasm_mender Mender: Remote update capability + +Mender is a third-party software that enables remote updating of the root +file system without physically accessing the device (see also the +[Mender website](https://mender.io)). Mender can be executed locally on the +device, or a Mender server can be set up which can be used to remotely update +an arbitrary number of USRP devices. Mender servers can be self-hosted, or +hosted by Mender (see [mender.io](https://mender.io) for pricing and +availability). + +When updating the file system using Mender, the tool will overwrite the root file +system partition that is not currently mounted (note: every SD card comes with +two separate root file system partitions, only one is ever used at a single +time). Any data stored on that partition will be permanently lost. After +updating that partition, it will reboot into the newly updated partition. Only +if the update is confirmed by the user, the update will be made permanent. This +means that if an update fails, the device will be always able to reboot into the +partition from which the update was originally launched (which presumably is in +a working state). Another update can be launched now to correct the previous, +failed update, until it works. +See also Section \ref e3xx_sdcard. + +Note: For E310, the SD cards that are shipped with the device do not have the latest +UHD and do not support MPM by default. The SD cards will have to be flashed with +UHD v3.15.0.0 or above to be able to use mender. After the first upgrade, mender +can be used for future upgrades. Refer to the migration guide. \ref e31x_migration + +To initiate an update from the device itself, download a Mender artifact +containing the update itself. These are files with a `.mender` suffix. + +Then run mender on the command line: + + $ mender -rootfs /path/to/latest.mender + +The artifact can also be stored on a remote server: + + $ mender -rootfs http://server.name/path/to/latest.mender + +This procedure will take a while. After mender has logged a successful update, +reboot the device: + + $ reboot + +If the reboot worked, and the device seems functional, commit the changes so +the boot loader knows to permanently boot into this partition: + + $ mender -commit + +To identify the currently installed Mender artifact from the command line, the +following file can be queried: + + $ cat /etc/mender/artifact_info + +If you are running a hosted server, the updates can be initiated from a web +dashboard. From there, you can start the updates without having to log into the +device, and can update groups of USRPs with a few clicks in a web GUI. The +dashboard can also be used to inspect the state of USRPs. This is simple way to +update groups of rack-mounted USRPs with custom file systems. + +\subsection e3xx_rasm_salt Salt: Remote configuration management and execution + +Salt (also known as SaltStack, see [Salt Website](https://saltstack.com)) is a +Python-based tool for maintaining fleets of remote devices. It can be used to +manage USRP E31X/E320 remotely for all types of settings that are not +controlled by UHD. For example, if an operator would like to reset the root +password on multiple devices, or install custom software, this tool might be a +suitable choice. + +Salt is a third-party project with its [own documentation](https://docs.saltstack.com/en/latest/), +which should be consulted for configuring it. However, the Salt minion is +installed by default on every E31X/E320 device. To start it, simply log on to the +device and run: + + $ systemctl start salt-minion + +To permanently enable it at every boot, run (this won't by itself launch the +salt-minion): + + $ systemctl enable salt-minion + +To make use of Salt, both the device needs to be configured (the "minion") and, +typically, a server to act as the Salt master. Refer to the Salt documentation +on how to configure the minion and the master. A typical sequence to get started +will look like this: + +1. Install the salt-master package on the server (e.g. by running `apt install salt-master` + if the server is an Ubuntu system), and make sure the Salt master is running. +2. Add the network address / hostname of that server to the `/etc/salt/minion` + file on the device by editing the `master:` line. +3. Launch the Salt minion on the USRP by running the command `systemctl start salt-minion`. +4. The minion will try to connect to the master. You need to authorize the + minion by running `salt-key -a $hostname` where `$hostname` is the name of + the minion. +5. Once the device is authorized, you can try various commands to see if the + communication was established: + +\code{.sh} + $ [sudo] salt '*' test.ping + ni-e3xx-$serial: + True + $ [sudo] salt '*' network.interfaces + ni-e3xx-$serial: + ---------- + eth0: + ---------- + hwaddr: + 02:00:03:11:fe:00 + inet: + |_ + ---------- + address: + xx.xx.xx.xx + broadcast: + xx.xx.xx.xx + label: + eth0 + netmask: + 255.255.254.0 + up: + True + # [...] +\endcode + +\section e3xx_theory_of_ops Theory of Operation + +All E series devices are on the MPM architecture (see also: \ref page_mpm). +Inside the Linux operating system running on the ARM +cores, there is a hardware daemon which needs to be active in order for the +device to function as a USRP (it is enabled to run by default). + +A large portion of hardware-specific setup is handled by the daemon. + +\section e3xx_software_dev Modifying and compiling UHD and MPM for the E320 + +E320 devices ship with all relevant software installed on the SD card. Updating +UHD and/or MPM on the SD card is typically easiest done by updating the +filesystem image (see Section \ref e3xx_rasm_mender). However, it is certainly +possible to compile UHD and MPM by hand, e.g., in order to modify and try out +changes without having to build entire filesystems in between. At Ettus R&D, +this mode of operation is often used for rapid iteration cycles. + +While on E310 the SD cards that are shipped with the device do not have the latest +UHD and do not support MPM by default. The SD cards will have to be flashed with +UHD v3.15.0.0 or above to be able to use mender. After the first upgrade, mender +can be used for future upgrades. Refer to the migration guide. \ref e31x_migration + +\subsection e3xx_software_dev_mpm_native Compiling MPM natively + +In general, compiling natively is not a recommended way of compiling code for +the ARM processors. However, in the case of MPM, the amount of C++ code that +needs to be compiled is very little, and a full compile of MPM will take a few +minutes even on the device. First, you need to get a copy of the MPM source code +onto your device. If you have an internet connection, you can use git to pull +it directly from the Ettus repository (all commands are run on the device +itself, inside the home directory): + + $ git clone https://github.com/EttusResearch/uhd.git + +You can also SSHFS it from another computer: + + $ mkdir uhd # Create a new, empty directory called uhd + $ sshfs user@yourcomputer:src/uhd uhd # This will mount ~/src/uhd from the remote machine to ~/uhd on the device + +Now, create a build directory and use the regular cmake/make procedure to kick +off a build. It can be advantageous (especially for slow network connections) +to create the build directory outside of the repository directory: + + $ mkdir build_mpm + $ cd build_mpm # You are now in /home/root/build_mpm + $ cmake ../uhd/mpm + $ make -j2 install # This will take several minutes + +Note that this overwrites your system MPM. You can install MPM to another +location by specifying `-DCMAKE_INSTALL_PREFIX`, but make sure to update all of +your paths appropriately. + +If you prefer cross-compiling MPM the same way as UHD, refer to the following +sections and adapt the instructions for UHD appropriately. + +\subsection e3xx_software_dev_sdk Obtaining an SDK + +The recommended way to develop software for the E31X/E320 is to cross-compile. By +running the compiles on a desktop or laptop computer, you will be able to speed +up compile times considerably (compiling UHD natively would take +many hours). + +SDKs are distributed along with other binaries. They contain a cross-compiler, +a cross-linker, a cross-debugger, and all the libraries available on the device +to mirror its environment. +Note: The SDK for E310 has been updated for UHD versions above v.3.15.0.0. Refer to +the migration guide for details. \ref e31x_migration + +To unpack the SDK, simply execute it after downloading it: + + $ cd /usr/local/share/uhd/images # Change this to where your images are stored + $ ./oecore-x86_64-cortexa9hf-neon-toolchain-nodistro.0.sh + +If this doesn't work, the executable permissions of the file might have been +lost (this can occur with some versions of Python). In that case, add those +permissions back before executing the `.sh` file: + + $ chmod +x oecore-x86_64-cortexa9hf-neon-toolchain-nodistro.0.sh + +Executing the `.sh` file will prompt you for an installation path. Please +ensure you have sufficient disk space, as each of the SDKs may require several +gigabytes of disk space (depending on the image flavor selected). + +This will allow you to compile UHD as well as (depending on the image flavor) +other software. + +Please note, that while several toolchains can be installed in parallel, they +have to be installed to different directories. + +\subsection e3xx_software_dev_sdkusage SDK Usage + +Having installed the toolchain in the last step, +in order to build software for your device open a new shell and type: + + $ . $SDKPATH/environment-setup-armv7ahf-vfp-neon-oe-linux-gnueabi + +This will modify the PATH, CC, CXX etc, environment variables and allow you to compile software for your device. +To verify all went well you can try: + + $ $CC -dumpmachine + +which should return 'arm-oe-linux-gnueabi'. + +\subsubsection e3xx_software_dev_uhd Building UHD + +-# Obtain the UHD source code via git or tarball +-# Set up your environment as described in \ref e3xx_software_dev_sdkusage +-# Type the following in the build directory (assuming a build in host/build): + + $ cmake -DCMAKE_TOOLCHAIN_FILE=../host/cmake/Toolchains/oe-sdk_cross.cmake -DCMAKE_INSTALL_PREFIX=/usr .. # Add any CMake options you desire + $ make # You can run make -j12 to compile on 12 processes at once + +Note: The UHD you are cross-compiling will not run on your host computer (the +one where you're doing the development). Compiling UHD regularly on your host +computer (with MPMD enabled) will allow you to talk to your device. + +\subsubsection e3xx_software_dev_gr Building GNU Radio + +-# Obtain the GNU Radio source code via git or tarball +-# Set up your environment as described in \ref e3xx_software_dev_sdkusage +-# Use the following commands to create a build directory, configure and compile gnuradio. You only need create the build directory once. + +\code{.sh} +$ mkdir build-arm +$ cd build-arm +$ cmake -Wno-dev -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/oe-sdk_cross.cmake \-DCMAKE_INSTALL_PREFIX=/usr -DENABLE_GR_VOCODER=OFF -DENABLE_GR_ATSC=OFF \ +-DENABLE_GR_DTV=OFF -DENABLE_DOXYGEN=OFF ../ # Append any CMake options you desire +\endcode + +Several GNU Radio components depend on running binaries built for the build +machine during compile. These binaries can be built and used for cross +compiling, but this is an advanced topic. + +\section e31x_device E310-specific Features + +\subsection e31x_hw_front_panel Front Panel + +\image html e3x0_fp_overlay.png "USRP E310 Front panel" + +- **RF A Group** + + **TX/RX LED**: Indicates that data is streaming on the TX/RX channel on frontend side A + + **RX2 LED**: Indicates that data is streaming on the RX2 channel on frontend side A + +- **RF B Group** + + **TX/RX LED**: Indicates that data is streaming on the TX/RX channel on frontend B + + **RX2 LED**: Indicates that data is streaming on the RX2 channel on frontend B +- **PWR**: Power switch with integrated status LED, for status description see below. + +- **SYNC**: Input port for external PPS signal + +- **GPS**: Connection for the GPS antenna + +The status LED in the power switch indicates the power and charge status. +Its behavior is firmware version dependent. + +- **Version 1** (original E310) + + **Off**: Indicates device is off and not charging + + **Solid Red**: Indicates device is charging + + **Solid Green**: Indicates device is on + + **Fast Blinking Red**: Indicates an error code + + 1 - Low voltage error + + 2 - Regulator low voltage error + + 3 - FPGA power error + + 4 - DRAM power error + + 5 - 1.8V rail power error + + 6 - 3.3V rail power error + + 7 - Daughterboard / TX power error + + 9 - Temperature error + +- **Version 2** (E312 and upgraded E310) + + **Off**: Indicates device is off and not charging + + **Slow Blinking Green**: Indicates device is off and charging + + **Fast Blinking Green**: Indicates device is on and charging + + **Solid Green**: Indicates device is on (and not charging, if E312) + + **Solid Orange**: Indicates device is on and discharging + + **Fast Blinking Orange**: Indicates device is on, discharging, and charge is below 10% charge + + **Fast Blinking Red**: Indicates an error code + + 1 - Low voltage error + + 2 - Regulator low voltage error + + 3 - FPGA power error + + 4 - DRAM power error + + 5 - 1.8V rail power error + + 6 - 3.3V rail power error + + 7 - Daughterboard / TX power error + + 8 - Charger error + + 9 - Charger temperature error + + 10 - Battery low error + + 11 - Fuel Gauge temperature error + + 12 - Global (case) temperature error + +\subsection e31x_hw_rear_panel Rear Panel + +\image html e3x0_rp_overlay.png "USRP E310 Rear Panel" + +- **PWR**: Locking connector (Kycon KLDHCX-0202-A-LT) for the USRP-E Series power supply +- **1G ETH**: RJ45 port for Ethernet interfaces +- **USB**: USB 2.0 Port +- **SERIAL**: Micro USB connection for serial uart console + +\subsection e31x_hw_sync Clock and Time Synchronization + +Unlike most USRP devices, the E310 does not have independent reference clock and time source inputs. +It is possible, however, to discipline the internal reference clock using an external time (PPS) source +connected to the SYNC input pin. The E310 FPGA has a subsystem that can use the PPS signal from the +SYNC pin or the internal GPS to align edges of the reference clock to edges of a shared PPS signal. +This alignment happens automatically when the time source in UHD is set to "gpsdo" or "external". +Please note that because the SYNC input can only accept a PPS signal, the only supported value for +the reference clock source is "internal". Also, keep in mind that the E310 +does *not* have a GPS-disciplined oscillator like other USRPs, the value "gpsdo" +for the time source was chosen for compatibility with other USRPs. + +\subsection e31x_hw_pps PPS - Pulse Per Second +Using a PPS signal for timestamp synchronization requires a LVCMOS or a 5V logic input signal. +An external PPS can be used to discipline the internal reference clock. This feature is automatically +enabled with the time source is set to "external". + +To test the PPS input, you can use the following tool from the UHD examples: + +- `` are device address arguments (optional if only one USRP device is on your machine) + + cd /lib/uhd/examples + ./test_pps_input --args=\ + +\subsection e31x_hw_gps Internal GPS + +Your USRP-E Series device comes with an internal GPS. +In order to get a lock on a satellite an external GPS antenna is required. +The PPS from the internal GPS can be used to discipline the internal reference +clock. This feature is automatically enabled when the time source is set to +"gpsdo". Again, keep in mind that while the E310 does not have an actual +GPS-disciplined oscillator (GPSDO) on the board, the value "gpsdo" was named +such for better compatibility with code written for other devices. + +The device provides a 3.3V supply voltage to an external antenna connected to the *GPS* port +of your device. Note that this supply voltage is turned off in order to safe power upon destruction of the software object. + +\subsection e31x_hw_gpio Internal GPIO + +### Connector + +\image html e3x0_gpio_conn.png "E3xx GPIO Connector" + +### Pin Mapping + +- Pin 1: +3.3V +- Pin 2: Reserved +- Pin 3: Data[5] +- Pin 4: Reserved +- Pin 5: Data[4] +- Pin 6: Data[0] +- Pin 7: Data[3] +- Pin 8: Data[1] +- Pin 9: 0V +- Pin 10: Data[2] + +Please see the \ref page_gpio_api for information on configuring and using the GPIO bus. + +\subsection e31x_hw_chipscope Debugging custom FPGA designs with Xilinx Chipscope + +### Connector + +\image html e3x0_jtag_conn.png "E3xx JTAG Connector" + +### Pin Mapping + +- Pin 1: TDO +- Pin 2: 3.3V +- Pin 3: TCK +- Pin 4: TDI +- Pin 5: 0V +- Pin 6: TMS + + +Xilinx chipscope allows for debugging custom FPGA designs similar to a logic analyzer. +USRP-E series devices can be used with Xilinx chipscope using the internal JTAG connector. + +Further information on how to use Chipscope can be found in the *Xilinx Chipscope Pro Software and Cores User Guide (UG029)*. + +\subsection e312_battery Battery notes + +The USRP E312 (and with upgraded firmware E310) supports LiIon Battery packs (e.g. AA Portable Power Corp, 749801-01). + +\subsubsection e312_battery_connector Connector + +The connector J1 on E312's motherboard is a Molex 53014-6310. The corresponding mating connector is a Molex 51004-0300. + +\image html e3xx_conn_photo.jpg "Battery pack connector" + +The pins are as follows: +- Pin 1 (Red): VBat +- Pin 2 (Black): GND +- Pin 3 (White): Battery Thermistor + +\subsubsection e312_battery_information Driver + +The battery information is exposed on the device via the sysfs directory under: + + /sys/class/power_supply/e31x-battery/ + +and for the charger: + + /sys/class/power_supply/e31x-charger/ + +The values can be accessed via libudev or manually e.g.: + + $ root@ni-e31x-: cat /sys/class/power_supply/e31x-battery/status + +The driver emits uevents on changes, that can be used to write custom UDev rules. +Using UDev rules one can configure the USRP E3xx to shut down on certain events, +such as low battery charge, high temperatures or AC power plug in. + +The following example will cause the system to shut down at a reported temperature +of 73C: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +SUBSYSTEM=="power_supply", ATTR{online}=="1", ATTR{temp}=="730", RUN+="/sbin/shutdown -h now" +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The sysfs property "capacity" is no longer supported by the battery driver in the latest filesystem. It was removed to +comply with the Linux power supply class driver recommendations during the ongoing driver upstreaming process. The capacity +may still be calculated by the customer application using the following formula (charge_now/charge_full) * 100 + +For more information, please see the udev manual pages and Kernel Power Supply Docs . + +\subsubsection e312_battery_calibration Calibration Procedure + +In order for the fuel gauge to give a usable indication of remaining charge it needs to be calibrated. +The procedure for calibration is as follows: + +1. Completely discharge battery (e.g. by booting up without SD card, so OS doesn't auto shutdown) +2. Unplug the battery pack and external power +3. Reconnect the battery pack +4. Reconnect AC power and charge until charge completed. + +A faster (less accurate) calibration procedure is as follows: + +1. Completely charge battery +2. Type: + + $ echo 3200000 > /sys/class/power_supply/e31x-battery/charge_now + +3. Unplug AC power +4. Replug AC power and wait until charge completes + +\subsection e31x_dboards Daughterboard notes + +The USRP E310 MIMO XCVR daughterboard features an integrated MIMO capable RF frontend. + +\subsubsection e31x_dboard_e310_tuning Frontend tuning + +The RF frontend has individually tunable receive and transmit chains. +Both transmit and receive can be used in a MIMO configuration. For +the MIMO case, both receive frontends share the RX LO, and both transmit +frontends share the TX LO. Each LO is tunable between 50 MHz and 6 GHz. + +As there is a single LO for each direction (RX and TX), this means that both +channels need to use the same LO frequency (i.e., both RX channels share an LO +frequency, and both TX channels share an LO frequency). If the two channels +are supposed to receive on different frequencies, the digital tune stages need +to be used for that. The two frequencies will need to be within the currently +selected master clock rate, and the final bandwidths need to be chosen +carefully. Example: Assume the master clock rate is set to 50 MHz, and we want +to receive at 400 MHz and 440 MHz. We can set the LO to 420 MHz, which will +sample the spectrum from 395 MHz to 445 MHz. The LO offsets for both channels +need to be 20 MHz and -20 MHz respectively. However, the final bandwidth should +be less than 10 MHz (preferably lower), or the signals would exhibit aliasing. + +Because both channels share an LO, tuning one channel can possibly affect the +other channel. It is advisable to read back the actual, current frequency from +software before assuming the device is tuned to a specific frequency. + +\subsubsection e31x_dboard_e310_gain Frontend gain + +All frontends have individual analog gain controls. The receive +frontends have 76 dB of available gain; and the transmit frontends have +89.5 dB of available gain. Gain settings are application specific, but +it is recommended that users consider using at least half of the +available gain to get reasonable dynamic range. + +\subsubsection e31x_dboard_e310_pll Frontend LO lock status + +The frontends provide a *lo-locked* sensor that can be queried through the UHD API. + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp} +// assumes 'usrp' is a valid uhd::usrp::multi_usrp::sptr instance + +// get status for rx frontend +usrp->get_rx_sensor("lo-locked"); + +// get status for tx frontend +usrp->get_tx_sensor("lo-locked"); +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +\subsubsection e31x_dboard_e310_band_select Frontend Filter and Antenna Switches + +The transmit and receive filter banks uses switches to select between the available filters. These paths are +also dependent on the antenna switch settings. Incorrectly setting the switches generally results +in attenuated input / output power. Receive filters are band pass (series high & low pass filters), +transmit filters are low pass. + +Source code related to controlling the filter band and antenna switches resides in e31x_radio_ctrl_impl.cpp. The methods set the switches depending on the state of transmit and receive streams. + +The following sections provide switch setting tables for antenna and filter selection for frontends A & B receive and transmit paths. +For further details refer to the schematics. + +\subsubsection e31x_dboard_e310_frontend_a_switches Frontend Side A Filter and Antenna Switches + +_Note: X = don't care, T = If full duplex, set bits according to transmit table, otherwise don't care. +Filter range A – B will be selected if A <= freq < B._ + +__Receive__ +RX Port | RX Filter (MHz) | VCTXRX2_V1,V2 | VCRX2_V1,V2 | RX2_BANDSEL[2:0] | RX2B_BANDSEL[1:0] | RX2C_BANDSEL[1:0] +:-----: | :-------------: | :-----------: | :---------: | :--------------: | :---------------: | :---------------: +TRX-A | < 450 | 01 | 10 | 101 | XX | 01 +TRX-A | 450 – 700 | 01 | 10 | 011 | XX | 11 +TRX-A | 700 – 1200 | 01 | 10 | 001 | XX | 10 +TRX-A | 1200 – 1800 | 01 | 10 | 000 | 01 | XX +TRX-A | 1800 – 2350 | 01 | 10 | 010 | 11 | XX +TRX-A | 2350 – 2600 | 01 | 10 | 100 | 10 | XX +TRX-A | 2600 – 6000 | 01 | 01 | XXX | XX | XX +RX2-A | 70 – 450 | TT | 01 | 101 | XX | 01 +RX2-A | 450 – 700 | TT | 01 | 011 | XX | 11 +RX2-A | 700 – 1200 | TT | 01 | 001 | XX | 10 +RX2-A | 1200 – 1800 | TT | 01 | 000 | 01 | XX +RX2-A | 1800 – 2350 | TT | 01 | 010 | 11 | XX +RX2-A | 2350 – 2600 | TT | 01 | 100 | 10 | XX +RX2-A | >= 2600 | TT | 10 | XXX | XX | XX + +__Transmit__ +TX Port | TX Filter (MHz) | VCTXRX2_V1,V2 | TX_ENABLE2A,2B | TX_BANDSEL[2:0] +:-----: | :-------------: | :-----------: | :------------: | :-------------: +TRX-A | < 117.7 | 10 | 01 | 111 +TRX-A | 117.7 – 178.2 | 10 | 01 | 110 +TRX-A | 178.2 – 284.3 | 10 | 01 | 101 +TRX-A | 284.3 – 453.7 | 10 | 01 | 100 +TRX-A | 453.7 – 723.8 | 10 | 01 | 011 +TRX-A | 723.8 – 1154.9 | 10 | 01 | 010 +TRX-A | 1154.9 – 1842.6 | 10 | 01 | 001 +TRX-A | 1842.6 – 2940.0 | 10 | 01 | 000 +TRX-A | >= 2940.0 | 11 | 10 | XXX +_Note: Although the transmit filters are low pass, this table describes UHD's tuning range for selecting each filter path. +The table also includes the required transmit enable state._ + +\subsubsection e31x_dboard_e310_frontend_b_switches Frontend Side B Filter and Antenna Switches + +_Note: X = don't care, T = If full duplex, set bits according to transmit table, otherwise don't care. +Filter range A – B will be selected if A <= freq < B._ + +__Receive__ +RX Port | RX Filter (MHz) | VCTXRX1_V1,V2 | VCRX1_V1,V2 | RX1_BANDSEL[2:0] | RX1B_BANDSEL[1:0] | RX1C_BANDSEL[1:0] +:-----: | :-------------: | :-----------: | :---------: | :--------------: | :---------------: | :---------------: +TRX-B | < 450 | 10 | 01 | 100 | XX | 10 +TRX-B | 450 – 700 | 10 | 01 | 010 | XX | 11 +TRX-B | 700 – 1200 | 10 | 01 | 000 | XX | 01 +TRX-B | 1200 – 1800 | 10 | 01 | 001 | 10 | XX +TRX-B | 1800 – 2350 | 10 | 01 | 011 | 11 | XX +TRX-B | 2350 – 2600 | 10 | 01 | 101 | 01 | XX +TRX-B | 2600 – 6000 | 10 | 10 | XXX | XX | XX +RX2-B | 70 – 450 | TT | 01 | 100 | XX | 10 +RX2-B | 450 – 700 | TT | 01 | 010 | XX | 11 +RX2-B | 700 – 1200 | TT | 01 | 000 | XX | 01 +RX2-B | 1200 – 1800 | TT | 01 | 001 | 10 | XX +RX2-B | 1800 – 2350 | TT | 01 | 011 | 11 | XX +RX2-B | 2350 – 2600 | TT | 01 | 101 | 01 | XX +RX2-B | >= 2600 | TT | 10 | XXX | XX | XX + +__Transmit__ +TX Port | TX Filter (MHz) | VCTXRX1_V1,V2 | TX_ENABLE1A,1B | TX1_BANDSEL[2:0] +:-----: | :-------------: | :-----------: | :------------: | :--------------: +TRX-B | < 117.7 | 00 | 01 | 111 +TRX-B | 117.7 – 178.2 | 00 | 01 | 110 +TRX-B | 178.2 – 284.3 | 00 | 01 | 101 +TRX-B | 284.3 – 453.7 | 00 | 01 | 100 +TRX-B | 453.7 – 723.8 | 00 | 01 | 011 +TRX-B | 723.8 – 1154.9 | 00 | 01 | 010 +TRX-B | 1154.9 – 1842.6 | 00 | 01 | 001 +TRX-B | 1842.6 – 2940.0 | 00 | 01 | 000 +TRX-B | >= 2940.0 | 11 | 10 | XXX +_Note: Although the transmit filters are low pass, the following table describes UHD's tuning range for selecting each filter path. +The table also includes the required transmit enable states._ + +\section e320_neon E320-specific Features + +\subsection e320_panels Front and Rear Panel + +Like the USRP X300 and N310 series, E320 has connectors on both the front and back +panel. The back panel holds the power connector, all network connections, USB +connections for serial console (see \ref e3xx_getting_started_serial), JTAG and +peripherals, and front-panel GPIO. + +The front panel is used for all RF connections, SMA connectors for GPS antenna +input, 10 MHz external clock reference. + +The connectors are labeled RF A and RF B and are powered by the two channels of +AD9361 RFIC. + +\section e3xx_regmap E3XX FPGA Register Map + +The following tables describe how FPGA registers are mapped into the PS. +This is for reference only, most users will not even have to know about this table. + + +AXI Slave | Address Range | UIO Label | Description +----------|-----------------------|------------------|----------------------------------- +Slave 0 | 4000_0000 - 4000_3fff | - | Ethernet DMA SFP (only for E320) +Slave 1 | 4000_4000 - 4000_4fff | misc-enet-regs | Ethernet registers SFP (only for E320) +Slave 2 | 4001_0000 - 4001_3fff | mboard-regs | Motherboard control +Slave 3 | 4001_4000 - 4001_41ff | dboard-regs | Daughterboard control + + + + +
E3XX Register Map
AXI Slave Module Address Name Read/Write Description +
Slave 0 axi_eth_dma 4000_0000 - 4000_4fff Ethernet DMA RW See Linux Driver (only on E320) +
Slave 1 e320_mgt_io_core 4000_4000 PORT_INFO RO SFP port information +
[31:24] COMPAT_NUM RO - +
[23:18] 6'h0 RO - +
[17] activity RO - +
[16] link_up RO - +
[15:8] mgt_protocol RO 0 - None, 1 - 1G, 2 - XG, 3 - Aurora +
[7:0] PORTNUM RO - +
e320_mgt_io_core 4000_4004 MAC_CTRL_STATUS RW Control 10gE and Aurora mac +
[0] ctrl_tx_enable (PROTOCOL = "10GbE")RW- +
[0] bist_checker_en (PROTOCOL = "Aurora")RW- +
[1] bist_gen_en RW - +
[2] bist_loopback_enRW - +
[8:3] bist_gen_rate RW - +
[9] phy_areset RW - +
[10] mac_clear RW - +
e320_mgt_io_core 4000_4008 PHY_CTRL_STATUS RW Phy reset control +
e320_mgt_io_core 4000_400C MAC_LED_CTL RW Used by ethtool to indicate port +
[1] identify_enable RW - +
[0] identify_value RW - +
mdio_master 4000_4010 MDIO_DATA RW - +
4000_4014 MDIO_ADDR RW - +
4000_4018 MDIO_OP RW - +
4000_401C MDIO_CTRL_STATUSRW - +
e320_mgt_io_core 4000_4020 AURORA_OVERUNS RO - +
4000_4024 AURORA_CHECKSUM_ERRORSRO - +
4000_4028 AURORA_BIST_CHECKER_SAMPSRO - +
4000_402C AURORA_BIST_CHECKER_ERRORSRO- +
eth_switch 4000_5000 MAC_LSB RW Device MAC LSB +
4000_5004 MAC_MSB RW Device MAC MSB +
4000_6000 IP RW Device IP +
4000_6004 PORT1, PORT0 RW Device UDP port +
eth_dispatch 4000_6008 [1] ndest, [0] bcastRW Enable Crossover +
4000_600c [1] my_icmp_type, [0] my_icmp_code- +
eth_switch 4000_6010 BRIDGE_MAC_LSB Bridge SFP ports in ARM +
4000_6014 BRIDGE_MAC_MSB - +
4000_6018 BRIDGE_IP - +
4000_601c BRIDGE_PORT1, BRIDGE_PORT0 - +
4000_6020 BRIDGE_EN - +
chdr_eth_framer 4000_6108 onwards LOCAL_DST_IP W Destination IP, MAC, UDP for Outgoing Packet for 256 SIDs +
4000_6208 onwards LOCAL_DST_UDP_MAC_MSBW Destination MAC for outgoing packets (MSB) +
4000_6308 onwards LOCAL_DST_MAC_LSBW Destination MAC for outgoing packets (LSB) +
4000_7000 onwards REMOTE_DST_IP W Destination IP, MAC, UDP for Outgoing Packet for 16 local addrs +
4000_7400 onwards REMOTE_DST_UDP_MAC_HIW Destination MAC (MSB) +
4000_7800 onwards REMOTE_DST_MAC_LOW Destination MAC (LSB) + +
Slave 2 e320_core 4001_0000 COMPAT_NUM R FPGA Compat Number +
[31:16] Major RO - +
[15:0] Minor RO - +
4001_0004 DATESTAMP RO - +
4001_0008 GIT_HASH RO - +
4001_000C SCRATCH RO - +
4001_0010 NUM_CE RO Number of Computation Engines (RFNoC Blocks) +
4001_0014 NUM_IO_CE RO Number of fixed IO CEs - Radios + DMA Fifo +
4001_0018 CLOCK_CTRL - +
[0] pps select (internal 10 MHz)RWOne-hot encoded pps_select to use the internal PPS from GPSDO +
[1] pps select (external 10 MHz)RWOne-hot encoded pps_select to use the external PPS. +
[2] refclk_select (internal/external 10 MHz)RWrefclk_select=0 for internal (GPSDO) 10 MHz, refclk_sel=1 for external 10 MHz. +
4001_001C XADC_READBACK RO - +
[11:0] FPGA temperatureRO - +
4001_0020 BUS_CLK_RATE RO - +
4001_0024 BUS_CLK_COUNT RO - +
4001_0028 SFP_PORT_INFO RO Same as port_info register 0x4000_4000 +
4001_002C FP_GPIO_CTRL RW - +
4001_0030 FP_GPIO_MASTER RW - +
4001_0034 FP_GPIO_RADIO_SRC RW - +
4001_0038 GPS_CTRL RW - +
[0] GPS_PWR_EN RW Power on GPSDO +
[1] GPS_RST_N RW - +
[2] GPS_INITSURV_N RW - +
4001_003C GPS_STATUS RO GPSDO Status +
[0] GPS_LOCK RO Returns 1 if GPSDO is locked +
[1] GPS_ALARM RO - +
[2] GPS_PHASELOCK RO - +
[3] GPS_SURVEY RO - +
[4] GPS_WARMUP RO - +
4001_0040 DBOARD_CTRL RO - +
4001_0044 DBOARD_STATUS RO - + +
axi_crossbar 4001_1010 XBAR_VERSION RO See crossbar kernel driver +
4001_1014 XBAR_NUM_PORTS RO See crossbar kernel driver +
4001_1018 LOCAL_ADDR RW See crossbar kernel driver +
4001_1020 remote_offset WO XBAR settings reg +
4001_1420 local_offset WO XBAR settings reg + +
Slave 4 4001_40004001_41FFDaughterboard Registers- Don't exist now. TBD + + +*/ +// vim:ft=doxygen: -- cgit v1.2.3