uhd: Added an example for CMake usage

3 files changed, 126 insertions, 0 deletions

diff --git a/host/examples/init_usrp/CMakeLists.txt b/host/examples/init_usrp/CMakeLists.txt
new file mode 100644
index 000000000..8cfea0a32
--- /dev/null
+++ b/host/examples/init_usrp/CMakeLists.txt
@@ -0,0 +1,46 @@
+#
+# Copyright 2014 Ettus Research LLC
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+cmake_minimum_required(VERSION 2.8)
+
+### Set up build environment ##################################################
+# This example also requires Boost:
+set(BOOST_REQUIRED_COMPONENTS
+    program_options
+    system
+    thread
+)
+find_package(Boost "1.35" REQUIRED ${BOOST_REQUIRED_COMPONENTS})
+
+# To add UHD as a dependency to this project, add a line such as this:
+find_package(UHD "3.7.1" REQUIRED)
+# The version in  ^^^^^  here is a minimum version.
+# To specify an exact version:
+#find_package(UHD 3.7.1 EXACT REQUIRED)
+
+### Configure Compiler ########################################################
+include_directories(
+    ${Boost_INCLUDE_DIRS}
+    ${UHD_INCLUDE_DIRS}
+)
+
+### Make the executable #######################################################
+add_executable(init_usrp init_usrp.cpp)
+target_link_libraries(init_usrp ${UHD_LIBRARIES} ${Boost_LIBRARIES})
+
+# Here, you would have commands to install your program.
+# We will skip these in this example.
diff --git a/host/examples/init_usrp/README b/host/examples/init_usrp/README
new file mode 100644
index 000000000..c231ce0d8
--- /dev/null
+++ b/host/examples/init_usrp/README
@@ -0,0 +1,20 @@
+Building UHD Applications using CMake
+=====================================
+
+This directory contains a tiny example of a UHD-based application.
+Unlike the other examples, it is completely independent of the UHD
+source tree and can be compiled from any path as long as UHD is
+currently installed on the current machine.
+
+To try it out, run these commands:
+$ mkdir build/ # Creates a new build directory
+$ cd build/
+$ cmake ..
+$ make
+
+This will find the UHD libraries, and link and compile the example
+program. Include header directories and library names are automatically
+gathered.
+
+See the CMakeLists.txt file to figure out how to set up a build system.
+
diff --git a/host/examples/init_usrp/init_usrp.cpp b/host/examples/init_usrp/init_usrp.cpp
new file mode 100644
index 000000000..c0a211767
--- /dev/null
+++ b/host/examples/init_usrp/init_usrp.cpp
@@ -0,0 +1,60 @@
+//
+// Copyright 2014 Ettus Research LLC
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+// This tiny program is meant as an example on how to set up UHD
+// projects using CMake.
+// The program itself only initializes a USRP. For more elaborate examples,
+// have a look at the files in host/examples/.
+
+#include <uhd/utils/thread_priority.hpp>
+#include <uhd/utils/safe_main.hpp>
+#include <uhd/usrp/multi_usrp.hpp>
+#include <boost/program_options.hpp>
+#include <boost/format.hpp>
+#include <iostream>
+
+namespace po = boost::program_options;
+
+int UHD_SAFE_MAIN(int argc, char *argv[]){
+    uhd::set_thread_priority_safe();
+
+    //variables to be set by po
+    std::string args;
+
+    //setup the program options
+    po::options_description desc("Allowed options");
+    desc.add_options()
+        ("help", "help message")
+        ("args", po::value<std::string>(&args)->default_value(""), "multi uhd device address args")
+    ;
+    po::variables_map vm;
+    po::store(po::parse_command_line(argc, argv, desc), vm);
+    po::notify(vm);
+
+    //print the help message
+    if (vm.count("help")){
+        std::cout << boost::format("Mini-example to initialize a USRP (args==%s).") % args << std::endl;
+        return ~0;
+    }
+
+    //create a usrp device
+    std::cout << std::endl;
+    std::cout << boost::format("Creating the usrp device with: %s...") % args << std::endl;
+    uhd::usrp::multi_usrp::sptr usrp = uhd::usrp::multi_usrp::make(args);
+
+    return EXIT_SUCCESS;
+}