1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
/*! \page page_images Firmware and FPGA Images
\tableofcontents
\section images_overview Images Overview
Every USRP device must be loaded with special firmware and FPGA images.
The methods of loading images into the device vary among devices:
- **USRP1:** The host code will automatically load the firmware and
FPGA at runtime.
- **USRP2:** The user must manually write the images onto the USRP2 SD
card.
- **USRP-N Series:** The user programs an image into on-board storage,
which then is automatically loaded at runtime.
- **USRP-E Series:** The host code will automatically load the FPGA at
runtime.
- **USRP-B Series:** The host code will automatically load the FPGA at
runtime.
- **USRP-X Series:** The user programs an image into on-board storage,
which then is automatically loaded at runtime.
\section images_prebuild Pre-built Images
Pre-built images are available for download.
- <a href="http://files.ettus.com/binaries/images/">Images</a>
The pre-built images come in two forms:
- bundled with UHD software in a platform-specific installer
- stand-alone platform-independent archive files
\subsection images_prebuilt_downloader UHD Images Downloader
The UHD images downloader downloads UHD images compatible with the host
code and places them in the default images directory.
The download script is typically installed into your $PATH and can be invoked
by calling
uhd_images_downloader
It can also be found at: `<install-path>/lib/uhd/utils/uhd_images_downloader.py`
By default, it installs images to: `<install-path>/share/uhd/images`
\subsection images_prebuilt_installers Platform installers
The UNIX-based installers will install the images into `/usr/share/uhd/images`.
The Windows installers will install the images into `C:/Program Files/UHD/share/uhd/images`.
\subsection images_prebuilt_archive Archive install
When installing images from an archive, there are two options:
<b>Option 1:</b>
Unpack the archive into the UHD installation prefix. UHD software will
always search `<install-path>/share/uhd/images` for image files.
Where `<install-path>` was set by the `CMAKE_INSTALL_PREFIX` at
configure-time.
<b>Option 2:</b>
Unpack the archive anywhere and set the `UHD_IMAGES_DIR` environment variable.
The `UHD_IMAGES_DIR` environment variable may contain a list of paths. They
should be ordered by preference.
\section images_building Building Images
The UHD source repository comes with the source code necessary to build
both firmware and FPGA images for all supported devices.
The build commands for a particular image can be found in
`<uhd-repo-path>/images/Makefile`.
\subsection images_building_xilinx Xilinx FPGA builds
USRP Xilinx FPGA images are built with either Vivado or one of two versions of ISE,
depending on the device.
The build requires that you have a UNIX-like environment with `Make`.
Make sure that `xtclsh` from the Xilinx Vivado or ISE bin directory is in your `$PATH`.
- Vivado 2017.4: USRP N3x0, USRP E3x0, USRP X3x0
- Xilinx ISE 14.7: USRP B2x0, USRP B200mini, B200mini-i, B205mini-i, USRP N2x0
See `<uhd-repo-path>/fpga/usrp3/top/`.
- Xilinx ISE 12.2: USRP B1x0, USRP E1x0, USRP2 [All of these devices are EOL as of 2018]
See `<uhd-repo-path>/fpga/usrp2/top/`.
\subsection images_building_zpu ZPU firmware builds
The ZPU GCC compiler is required to build the ZPU firmware images. The
build requires that you have a UNIX-like environment with `CMake` and
`Make`. Make sure that `zpu-elf-gcc` is in your `$PATH`.
See `<uhd-repo-path>/firmware/zpu`.
\subsection images_building_altera Altera FPGA builds
Quartus is required to build the Altera FPGA image for the USRP1.
Pre-built images can also be found in `<uhd-repo-path>/fpga/usrp1/rbf`.
See `<uhd-repo-path>/fpga/usrp1/toplevel/`.
\subsection images_building_fx2 FX2 firmware builds
The SDCC compiler is required to build the FX2 firmware images. The
build requires that you have a UNIX-like environment with `CMake` and `Make`.
See `<uhd-repo-path>/firmware/fx2`.
*/
// vim:ft=doxygen:
|
