diff options
Diffstat (limited to 'host/examples')
| -rw-r--r-- | host/examples/CMakeLists.txt | 47 | ||||
| -rw-r--r-- | host/examples/getopt/CMakeLists.txt | 25 | ||||
| -rw-r--r-- | host/examples/getopt/getopt.c | 1056 | ||||
| -rw-r--r-- | host/examples/getopt/getopt.h | 180 | ||||
| -rw-r--r-- | host/examples/getopt/getopt1.c | 188 | ||||
| -rw-r--r-- | host/examples/rx_samples_c.c | 291 | ||||
| -rw-r--r-- | host/examples/tx_samples_c.c | 241 | 
7 files changed, 2027 insertions, 1 deletions
| diff --git a/host/examples/CMakeLists.txt b/host/examples/CMakeLists.txt index 92947d86c..43e0db9c0 100644 --- a/host/examples/CMakeLists.txt +++ b/host/examples/CMakeLists.txt @@ -1,5 +1,5 @@  # -# Copyright 2010-2014 Ettus Research LLC +# Copyright 2010-2015 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 @@ -61,3 +61,48 @@ IF(CURSES_FOUND)      TARGET_LINK_LIBRARIES(rx_ascii_art_dft uhd ${CURSES_LIBRARIES} ${Boost_LIBRARIES})      UHD_INSTALL(TARGETS rx_ascii_art_dft RUNTIME DESTINATION ${PKG_LIB_DIR}/examples COMPONENT examples)  ENDIF(CURSES_FOUND) + +######################################################################## +# Examples using C API +######################################################################## +IF(ENABLE_C_API) +    # +    # Check if this particular C99 feature is available with this compiler +    # +    INCLUDE(CheckCSourceCompiles) +    CHECK_C_SOURCE_COMPILES(" +    typedef struct { +        int bar; +        int baz; +    } foo; + +    int main() +    { +        foo wat = { +            .bar = 1, +            .baz = 2 +        }; + +        return 0; +    } +    " HAVE_C99_STRUCTDECL) + +    IF(HAVE_C99_STRUCTDECL) +        ADD_SUBDIRECTORY(getopt) +        INCLUDE_DIRECTORIES(${CMAKE_CURRENT_SOURCE_DIR}/getopt) + +        SET(C_API_EXAMPLES +            rx_samples_c +            tx_samples_c +        ) + +        FOREACH(example ${C_API_EXAMPLES}) +            ADD_EXECUTABLE(${example} ${example}.c) +            TARGET_LINK_LIBRARIES(${example} uhd getopt) +            IF(UNIX) +                TARGET_LINK_LIBRARIES(${example} m) +            ENDIF(UNIX) +            UHD_INSTALL(TARGETS ${example} RUNTIME DESTINATION ${PKG_LIB_DIR}/examples COMPONENT examples) +        ENDFOREACH(example ${C_API_EXAMPLES}) +    ENDIF(HAVE_C99_STRUCTDECL) +ENDIF(ENABLE_C_API) diff --git a/host/examples/getopt/CMakeLists.txt b/host/examples/getopt/CMakeLists.txt new file mode 100644 index 000000000..2321a0d94 --- /dev/null +++ b/host/examples/getopt/CMakeLists.txt @@ -0,0 +1,25 @@ +# +# Copyright 2015 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/>. +# + +######################################################################## +# getopt library for C examples since MSVC does not include it +######################################################################## +INCLUDE_DIRECTORIES(${CMAKE_CURRENT_SOURCE_DIRECTORY}) +ADD_LIBRARY(getopt STATIC +    ${CMAKE_CURRENT_SOURCE_DIR}/getopt.c +    ${CMAKE_CURRENT_SOURCE_DIR}/getopt1.c +) diff --git a/host/examples/getopt/getopt.c b/host/examples/getopt/getopt.c new file mode 100644 index 000000000..ad9ec2f9b --- /dev/null +++ b/host/examples/getopt/getopt.c @@ -0,0 +1,1056 @@ +/* Getopt for GNU. +   NOTE: getopt is now part of the C library, so if you don't know what +   "Keep this file name-space clean" means, talk to drepper@gnu.org +   before changing it! +   Copyright (C) 1987,88,89,90,91,92,93,94,95,96,98,99,2000,2001 +   	Free Software Foundation, Inc. +   This file is part of the GNU C Library. + +   The GNU C Library is free software; you can redistribute it and/or +   modify it under the terms of the GNU Lesser General Public +   License as published by the Free Software Foundation; either +   version 2.1 of the License, or (at your option) any later version. + +   The GNU C Library 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 +   Lesser General Public License for more details. + +   You should have received a copy of the GNU Lesser General Public +   License along with the GNU C Library; if not, write to the Free +   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA +   02111-1307 USA.  */ + +/* This tells Alpha OSF/1 not to define a getopt prototype in <stdio.h>. +   Ditto for AIX 3.2 and <stdlib.h>.  */ +#ifndef _NO_PROTO +# define _NO_PROTO +#endif + +#ifdef HAVE_CONFIG_H +# include <config.h> +#endif + +#if !defined __STDC__ || !__STDC__ +/* This is a separate conditional since some stdc systems +   reject `defined (const)'.  */ +# ifndef const +#  define const +# endif +#endif + +#include <stdio.h> + +/* Comment out all this code if we are using the GNU C Library, and are not +   actually compiling the library itself.  This code is part of the GNU C +   Library, but also included in many other GNU distributions.  Compiling +   and linking in this code is a waste when using the GNU C library +   (especially if it is a shared library).  Rather than having every GNU +   program understand `configure --with-gnu-libc' and omit the object files, +   it is simpler to just do this in the source for each such file.  */ + +#define GETOPT_INTERFACE_VERSION 2 +#if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2 +# include <gnu-versions.h> +# if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION +#  define ELIDE_CODE +# endif +#endif + +#ifndef ELIDE_CODE + + +/* This needs to come after some library #include +   to get __GNU_LIBRARY__ defined.  */ +#ifdef	__GNU_LIBRARY__ +/* Don't include stdlib.h for non-GNU C libraries because some of them +   contain conflicting prototypes for getopt.  */ +# include <stdlib.h> +# include <unistd.h> +#endif	/* GNU C library.  */ + +#ifdef VMS +# include <unixlib.h> +# if HAVE_STRING_H - 0 +#  include <string.h> +# endif +#endif + +#ifndef _ +/* This is for other GNU distributions with internationalized messages.  */ +# if (HAVE_LIBINTL_H && ENABLE_NLS) || defined _LIBC +#  include <libintl.h> +#  ifndef _ +#   define _(msgid)	gettext (msgid) +#  endif +# else +#  define _(msgid)	(msgid) +# endif +#endif + +/* This version of `getopt' appears to the caller like standard Unix `getopt' +   but it behaves differently for the user, since it allows the user +   to intersperse the options with the other arguments. + +   As `getopt' works, it permutes the elements of ARGV so that, +   when it is done, all the options precede everything else.  Thus +   all application programs are extended to handle flexible argument order. + +   Setting the environment variable POSIXLY_CORRECT disables permutation. +   Then the behavior is completely standard. + +   GNU application programs can use a third alternative mode in which +   they can distinguish the relative order of options and other arguments.  */ + +#include "getopt.h" + +/* For communication from `getopt' to the caller. +   When `getopt' finds an option that takes an argument, +   the argument value is returned here. +   Also, when `ordering' is RETURN_IN_ORDER, +   each non-option ARGV-element is returned here.  */ + +char *optarg; + +/* Index in ARGV of the next element to be scanned. +   This is used for communication to and from the caller +   and for communication between successive calls to `getopt'. + +   On entry to `getopt', zero means this is the first call; initialize. + +   When `getopt' returns -1, this is the index of the first of the +   non-option elements that the caller should itself scan. + +   Otherwise, `optind' communicates from one call to the next +   how much of ARGV has been scanned so far.  */ + +/* 1003.2 says this must be 1 before any call.  */ +int optind = 1; + +/* Formerly, initialization of getopt depended on optind==0, which +   causes problems with re-calling getopt as programs generally don't +   know that. */ + +int __getopt_initialized; + +/* The next char to be scanned in the option-element +   in which the last option character we returned was found. +   This allows us to pick up the scan where we left off. + +   If this is zero, or a null string, it means resume the scan +   by advancing to the next ARGV-element.  */ + +static char *nextchar; + +/* Callers store zero here to inhibit the error message +   for unrecognized options.  */ + +int opterr = 1; + +/* Set to an option character which was unrecognized. +   This must be initialized on some systems to avoid linking in the +   system's own getopt implementation.  */ + +int optopt = '?'; + +/* Describe how to deal with options that follow non-option ARGV-elements. + +   If the caller did not specify anything, +   the default is REQUIRE_ORDER if the environment variable +   POSIXLY_CORRECT is defined, PERMUTE otherwise. + +   REQUIRE_ORDER means don't recognize them as options; +   stop option processing when the first non-option is seen. +   This is what Unix does. +   This mode of operation is selected by either setting the environment +   variable POSIXLY_CORRECT, or using `+' as the first character +   of the list of option characters. + +   PERMUTE is the default.  We permute the contents of ARGV as we scan, +   so that eventually all the non-options are at the end.  This allows options +   to be given in any order, even with programs that were not written to +   expect this. + +   RETURN_IN_ORDER is an option available to programs that were written +   to expect options and other ARGV-elements in any order and that care about +   the ordering of the two.  We describe each non-option ARGV-element +   as if it were the argument of an option with character code 1. +   Using `-' as the first character of the list of option characters +   selects this mode of operation. + +   The special argument `--' forces an end of option-scanning regardless +   of the value of `ordering'.  In the case of RETURN_IN_ORDER, only +   `--' can cause `getopt' to return -1 with `optind' != ARGC.  */ + +static enum +{ +  REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER +} ordering; + +/* Value of POSIXLY_CORRECT environment variable.  */ +static char *posixly_correct; + +#ifdef	__GNU_LIBRARY__ +/* We want to avoid inclusion of string.h with non-GNU libraries +   because there are many ways it can cause trouble. +   On some systems, it contains special magic macros that don't work +   in GCC.  */ +# include <string.h> +# define my_index	strchr +#else + +#include <string.h> + +/* Avoid depending on library functions or files +   whose names are inconsistent.  */ + +#ifndef getenv +#ifdef _MSC_VER +// DDK will complain if you don't use the stdlib defined getenv +#include <stdlib.h> +#else +extern char *getenv (); +#endif +#endif + +static char * +my_index (str, chr) +     const char *str; +     int chr; +{ +  while (*str) +    { +      if (*str == chr) +	return (char *) str; +      str++; +    } +  return 0; +} + +/* If using GCC, we can safely declare strlen this way. +   If not using GCC, it is ok not to declare it.  */ +#ifdef __GNUC__ +/* Note that Motorola Delta 68k R3V7 comes with GCC but not stddef.h. +   That was relevant to code that was here before.  */ +# if (!defined __STDC__ || !__STDC__) && !defined strlen +/* gcc with -traditional declares the built-in strlen to return int, +   and has done so at least since version 2.4.5. -- rms.  */ +extern int strlen (const char *); +# endif /* not __STDC__ */ +#endif /* __GNUC__ */ + +#endif /* not __GNU_LIBRARY__ */ + +/* Handle permutation of arguments.  */ + +/* Describe the part of ARGV that contains non-options that have +   been skipped.  `first_nonopt' is the index in ARGV of the first of them; +   `last_nonopt' is the index after the last of them.  */ + +static int first_nonopt; +static int last_nonopt; + +#ifdef _LIBC +/* Stored original parameters. +   XXX This is no good solution.  We should rather copy the args so +   that we can compare them later.  But we must not use malloc(3).  */ +extern int __libc_argc; +extern char **__libc_argv; + +/* Bash 2.0 gives us an environment variable containing flags +   indicating ARGV elements that should not be considered arguments.  */ + +# ifdef USE_NONOPTION_FLAGS +/* Defined in getopt_init.c  */ +extern char *__getopt_nonoption_flags; + +static int nonoption_flags_max_len; +static int nonoption_flags_len; +# endif + +# ifdef USE_NONOPTION_FLAGS +#  define SWAP_FLAGS(ch1, ch2) \ +  if (nonoption_flags_len > 0)						      \ +    {									      \ +      char __tmp = __getopt_nonoption_flags[ch1];			      \ +      __getopt_nonoption_flags[ch1] = __getopt_nonoption_flags[ch2];	      \ +      __getopt_nonoption_flags[ch2] = __tmp;				      \ +    } +# else +#  define SWAP_FLAGS(ch1, ch2) +# endif +#else	/* !_LIBC */ +# define SWAP_FLAGS(ch1, ch2) +#endif	/* _LIBC */ + +/* Exchange two adjacent subsequences of ARGV. +   One subsequence is elements [first_nonopt,last_nonopt) +   which contains all the non-options that have been skipped so far. +   The other is elements [last_nonopt,optind), which contains all +   the options processed since those non-options were skipped. + +   `first_nonopt' and `last_nonopt' are relocated so that they describe +   the new indices of the non-options in ARGV after they are moved.  */ + +#if defined __STDC__ && __STDC__ +static void exchange (char **); +#endif + +static void +exchange (argv) +     char **argv; +{ +  int bottom = first_nonopt; +  int middle = last_nonopt; +  int top = optind; +  char *tem; + +  /* Exchange the shorter segment with the far end of the longer segment. +     That puts the shorter segment into the right place. +     It leaves the longer segment in the right place overall, +     but it consists of two parts that need to be swapped next.  */ + +#if defined _LIBC && defined USE_NONOPTION_FLAGS +  /* First make sure the handling of the `__getopt_nonoption_flags' +     string can work normally.  Our top argument must be in the range +     of the string.  */ +  if (nonoption_flags_len > 0 && top >= nonoption_flags_max_len) +    { +      /* We must extend the array.  The user plays games with us and +	 presents new arguments.  */ +      char *new_str = malloc (top + 1); +      if (new_str == NULL) +	nonoption_flags_len = nonoption_flags_max_len = 0; +      else +	{ +	  memset (__mempcpy (new_str, __getopt_nonoption_flags, +			     nonoption_flags_max_len), +		  '\0', top + 1 - nonoption_flags_max_len); +	  nonoption_flags_max_len = top + 1; +	  __getopt_nonoption_flags = new_str; +	} +    } +#endif + +  while (top > middle && middle > bottom) +    { +      if (top - middle > middle - bottom) +	{ +	  /* Bottom segment is the short one.  */ +	  int len = middle - bottom; +	  register int i; + +	  /* Swap it with the top part of the top segment.  */ +	  for (i = 0; i < len; i++) +	    { +	      tem = argv[bottom + i]; +	      argv[bottom + i] = argv[top - (middle - bottom) + i]; +	      argv[top - (middle - bottom) + i] = tem; +	      SWAP_FLAGS (bottom + i, top - (middle - bottom) + i); +	    } +	  /* Exclude the moved bottom segment from further swapping.  */ +	  top -= len; +	} +      else +	{ +	  /* Top segment is the short one.  */ +	  int len = top - middle; +	  register int i; + +	  /* Swap it with the bottom part of the bottom segment.  */ +	  for (i = 0; i < len; i++) +	    { +	      tem = argv[bottom + i]; +	      argv[bottom + i] = argv[middle + i]; +	      argv[middle + i] = tem; +	      SWAP_FLAGS (bottom + i, middle + i); +	    } +	  /* Exclude the moved top segment from further swapping.  */ +	  bottom += len; +	} +    } + +  /* Update records for the slots the non-options now occupy.  */ + +  first_nonopt += (optind - last_nonopt); +  last_nonopt = optind; +} + +/* Initialize the internal data when the first call is made.  */ + +#if defined __STDC__ && __STDC__ +static const char *_getopt_initialize (int, char *const *, const char *); +#endif +static const char * +_getopt_initialize (argc, argv, optstring) +     int argc; +     char *const *argv; +     const char *optstring; +{ +  /* Start processing options with ARGV-element 1 (since ARGV-element 0 +     is the program name); the sequence of previously skipped +     non-option ARGV-elements is empty.  */ + +  first_nonopt = last_nonopt = optind; + +  nextchar = NULL; + +  posixly_correct = getenv ("POSIXLY_CORRECT"); + +  /* Determine how to handle the ordering of options and nonoptions.  */ + +  if (optstring[0] == '-') +    { +      ordering = RETURN_IN_ORDER; +      ++optstring; +    } +  else if (optstring[0] == '+') +    { +      ordering = REQUIRE_ORDER; +      ++optstring; +    } +  else if (posixly_correct != NULL) +    ordering = REQUIRE_ORDER; +  else +    ordering = PERMUTE; + +#if defined _LIBC && defined USE_NONOPTION_FLAGS +  if (posixly_correct == NULL +      && argc == __libc_argc && argv == __libc_argv) +    { +      if (nonoption_flags_max_len == 0) +	{ +	  if (__getopt_nonoption_flags == NULL +	      || __getopt_nonoption_flags[0] == '\0') +	    nonoption_flags_max_len = -1; +	  else +	    { +	      const char *orig_str = __getopt_nonoption_flags; +	      int len = nonoption_flags_max_len = strlen (orig_str); +	      if (nonoption_flags_max_len < argc) +		nonoption_flags_max_len = argc; +	      __getopt_nonoption_flags = +		(char *) malloc (nonoption_flags_max_len); +	      if (__getopt_nonoption_flags == NULL) +		nonoption_flags_max_len = -1; +	      else +		memset (__mempcpy (__getopt_nonoption_flags, orig_str, len), +			'\0', nonoption_flags_max_len - len); +	    } +	} +      nonoption_flags_len = nonoption_flags_max_len; +    } +  else +    nonoption_flags_len = 0; +#endif + +  return optstring; +} + +/* Scan elements of ARGV (whose length is ARGC) for option characters +   given in OPTSTRING. + +   If an element of ARGV starts with '-', and is not exactly "-" or "--", +   then it is an option element.  The characters of this element +   (aside from the initial '-') are option characters.  If `getopt' +   is called repeatedly, it returns successively each of the option characters +   from each of the option elements. + +   If `getopt' finds another option character, it returns that character, +   updating `optind' and `nextchar' so that the next call to `getopt' can +   resume the scan with the following option character or ARGV-element. + +   If there are no more option characters, `getopt' returns -1. +   Then `optind' is the index in ARGV of the first ARGV-element +   that is not an option.  (The ARGV-elements have been permuted +   so that those that are not options now come last.) + +   OPTSTRING is a string containing the legitimate option characters. +   If an option character is seen that is not listed in OPTSTRING, +   return '?' after printing an error message.  If you set `opterr' to +   zero, the error message is suppressed but we still return '?'. + +   If a char in OPTSTRING is followed by a colon, that means it wants an arg, +   so the following text in the same ARGV-element, or the text of the following +   ARGV-element, is returned in `optarg'.  Two colons mean an option that +   wants an optional arg; if there is text in the current ARGV-element, +   it is returned in `optarg', otherwise `optarg' is set to zero. + +   If OPTSTRING starts with `-' or `+', it requests different methods of +   handling the non-option ARGV-elements. +   See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above. + +   Long-named options begin with `--' instead of `-'. +   Their names may be abbreviated as long as the abbreviation is unique +   or is an exact match for some defined option.  If they have an +   argument, it follows the option name in the same ARGV-element, separated +   from the option name by a `=', or else the in next ARGV-element. +   When `getopt' finds a long-named option, it returns 0 if that option's +   `flag' field is nonzero, the value of the option's `val' field +   if the `flag' field is zero. + +   The elements of ARGV aren't really const, because we permute them. +   But we pretend they're const in the prototype to be compatible +   with other systems. + +   LONGOPTS is a vector of `struct option' terminated by an +   element containing a name which is zero. + +   LONGIND returns the index in LONGOPT of the long-named option found. +   It is only valid when a long-named option has been found by the most +   recent call. + +   If LONG_ONLY is nonzero, '-' as well as '--' can introduce +   long-named options.  */ + +int +_getopt_internal (argc, argv, optstring, longopts, longind, long_only) +     int argc; +     char *const *argv; +     const char *optstring; +     const struct option *longopts; +     int *longind; +     int long_only; +{ +  int print_errors = opterr; +  if (optstring[0] == ':') +    print_errors = 0; + +  if (argc < 1) +    return -1; + +  optarg = NULL; + +  if (optind == 0 || !__getopt_initialized) +    { +      if (optind == 0) +	optind = 1;	/* Don't scan ARGV[0], the program name.  */ +      optstring = _getopt_initialize (argc, argv, optstring); +      __getopt_initialized = 1; +    } + +  /* Test whether ARGV[optind] points to a non-option argument. +     Either it does not have option syntax, or there is an environment flag +     from the shell indicating it is not an option.  The later information +     is only used when the used in the GNU libc.  */ +#if defined _LIBC && defined USE_NONOPTION_FLAGS +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0'	      \ +		      || (optind < nonoption_flags_len			      \ +			  && __getopt_nonoption_flags[optind] == '1')) +#else +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0') +#endif + +  if (nextchar == NULL || *nextchar == '\0') +    { +      /* Advance to the next ARGV-element.  */ + +      /* Give FIRST_NONOPT & LAST_NONOPT rational values if OPTIND has been +	 moved back by the user (who may also have changed the arguments).  */ +      if (last_nonopt > optind) +	last_nonopt = optind; +      if (first_nonopt > optind) +	first_nonopt = optind; + +      if (ordering == PERMUTE) +	{ +	  /* If we have just processed some options following some non-options, +	     exchange them so that the options come first.  */ + +	  if (first_nonopt != last_nonopt && last_nonopt != optind) +	    exchange ((char **) argv); +	  else if (last_nonopt != optind) +	    first_nonopt = optind; + +	  /* Skip any additional non-options +	     and extend the range of non-options previously skipped.  */ + +	  while (optind < argc && NONOPTION_P) +	    optind++; +	  last_nonopt = optind; +	} + +      /* The special ARGV-element `--' means premature end of options. +	 Skip it like a null option, +	 then exchange with previous non-options as if it were an option, +	 then skip everything else like a non-option.  */ + +      if (optind != argc && !strcmp (argv[optind], "--")) +	{ +	  optind++; + +	  if (first_nonopt != last_nonopt && last_nonopt != optind) +	    exchange ((char **) argv); +	  else if (first_nonopt == last_nonopt) +	    first_nonopt = optind; +	  last_nonopt = argc; + +	  optind = argc; +	} + +      /* If we have done all the ARGV-elements, stop the scan +	 and back over any non-options that we skipped and permuted.  */ + +      if (optind == argc) +	{ +	  /* Set the next-arg-index to point at the non-options +	     that we previously skipped, so the caller will digest them.  */ +	  if (first_nonopt != last_nonopt) +	    optind = first_nonopt; +	  return -1; +	} + +      /* If we have come to a non-option and did not permute it, +	 either stop the scan or describe it to the caller and pass it by.  */ + +      if (NONOPTION_P) +	{ +	  if (ordering == REQUIRE_ORDER) +	    return -1; +	  optarg = argv[optind++]; +	  return 1; +	} + +      /* We have found another option-ARGV-element. +	 Skip the initial punctuation.  */ + +      nextchar = (argv[optind] + 1 +		  + (longopts != NULL && argv[optind][1] == '-')); +    } + +  /* Decode the current option-ARGV-element.  */ + +  /* Check whether the ARGV-element is a long option. + +     If long_only and the ARGV-element has the form "-f", where f is +     a valid short option, don't consider it an abbreviated form of +     a long option that starts with f.  Otherwise there would be no +     way to give the -f short option. + +     On the other hand, if there's a long option "fubar" and +     the ARGV-element is "-fu", do consider that an abbreviation of +     the long option, just like "--fu", and not "-f" with arg "u". + +     This distinction seems to be the most useful approach.  */ + +  if (longopts != NULL +      && (argv[optind][1] == '-' +	  || (long_only && (argv[optind][2] || !my_index (optstring, argv[optind][1]))))) +    { +      char *nameend; +      const struct option *p; +      const struct option *pfound = NULL; +      int exact = 0; +      int ambig = 0; +      int indfound = -1; +      int option_index; + +      for (nameend = nextchar; *nameend && *nameend != '='; nameend++) +	/* Do nothing.  */ ; + +      /* Test all long options for either exact match +	 or abbreviated matches.  */ +      for (p = longopts, option_index = 0; p->name; p++, option_index++) +	if (!strncmp (p->name, nextchar, nameend - nextchar)) +	  { +	    if ((unsigned int) (nameend - nextchar) +		== (unsigned int) strlen (p->name)) +	      { +		/* Exact match found.  */ +		pfound = p; +		indfound = option_index; +		exact = 1; +		break; +	      } +	    else if (pfound == NULL) +	      { +		/* First nonexact match found.  */ +		pfound = p; +		indfound = option_index; +	      } +	    else if (long_only +		     || pfound->has_arg != p->has_arg +		     || pfound->flag != p->flag +		     || pfound->val != p->val) +	      /* Second or later nonexact match found.  */ +	      ambig = 1; +	  } + +      if (ambig && !exact) +	{ +	  if (print_errors) +	    fprintf (stderr, _("%s: option `%s' is ambiguous\n"), +		     argv[0], argv[optind]); +	  nextchar += strlen (nextchar); +	  optind++; +	  optopt = 0; +	  return '?'; +	} + +      if (pfound != NULL) +	{ +	  option_index = indfound; +	  optind++; +	  if (*nameend) +	    { +	      /* Don't test has_arg with >, because some C compilers don't +		 allow it to be used on enums.  */ +	      if (pfound->has_arg) +		optarg = nameend + 1; +	      else +		{ +		  if (print_errors) +		    { +		      if (argv[optind - 1][1] == '-') +			/* --option */ +			fprintf (stderr, +				 _("%s: option `--%s' doesn't allow an argument\n"), +				 argv[0], pfound->name); +		      else +			/* +option or -option */ +			fprintf (stderr, +				 _("%s: option `%c%s' doesn't allow an argument\n"), +				 argv[0], argv[optind - 1][0], pfound->name); +		    } + +		  nextchar += strlen (nextchar); + +		  optopt = pfound->val; +		  return '?'; +		} +	    } +	  else if (pfound->has_arg == 1) +	    { +	      if (optind < argc) +		optarg = argv[optind++]; +	      else +		{ +		  if (print_errors) +		    fprintf (stderr, +			   _("%s: option `%s' requires an argument\n"), +			   argv[0], argv[optind - 1]); +		  nextchar += strlen (nextchar); +		  optopt = pfound->val; +		  return optstring[0] == ':' ? ':' : '?'; +		} +	    } +	  nextchar += strlen (nextchar); +	  if (longind != NULL) +	    *longind = option_index; +	  if (pfound->flag) +	    { +	      *(pfound->flag) = pfound->val; +	      return 0; +	    } +	  return pfound->val; +	} + +      /* Can't find it as a long option.  If this is not getopt_long_only, +	 or the option starts with '--' or is not a valid short +	 option, then it's an error. +	 Otherwise interpret it as a short option.  */ +      if (!long_only || argv[optind][1] == '-' +	  || my_index (optstring, *nextchar) == NULL) +	{ +	  if (print_errors) +	    { +	      if (argv[optind][1] == '-') +		/* --option */ +		fprintf (stderr, _("%s: unrecognized option `--%s'\n"), +			 argv[0], nextchar); +	      else +		/* +option or -option */ +		fprintf (stderr, _("%s: unrecognized option `%c%s'\n"), +			 argv[0], argv[optind][0], nextchar); +	    } +	  nextchar = (char *) ""; +	  optind++; +	  optopt = 0; +	  return '?'; +	} +    } + +  /* Look at and handle the next short option-character.  */ + +  { +    char c = *nextchar++; +    char *temp = my_index (optstring, c); + +    /* Increment `optind' when we start to process its last character.  */ +    if (*nextchar == '\0') +      ++optind; + +    if (temp == NULL || c == ':') +      { +	if (print_errors) +	  { +	    if (posixly_correct) +	      /* 1003.2 specifies the format of this message.  */ +	      fprintf (stderr, _("%s: illegal option -- %c\n"), +		       argv[0], c); +	    else +	      fprintf (stderr, _("%s: invalid option -- %c\n"), +		       argv[0], c); +	  } +	optopt = c; +	return '?'; +      } +    /* Convenience. Treat POSIX -W foo same as long option --foo */ +    if (temp[0] == 'W' && temp[1] == ';') +      { +	char *nameend; +	const struct option *p; +	const struct option *pfound = NULL; +	int exact = 0; +	int ambig = 0; +	int indfound = 0; +	int option_index; + +	/* This is an option that requires an argument.  */ +	if (*nextchar != '\0') +	  { +	    optarg = nextchar; +	    /* If we end this ARGV-element by taking the rest as an arg, +	       we must advance to the next element now.  */ +	    optind++; +	  } +	else if (optind == argc) +	  { +	    if (print_errors) +	      { +		/* 1003.2 specifies the format of this message.  */ +		fprintf (stderr, _("%s: option requires an argument -- %c\n"), +			 argv[0], c); +	      } +	    optopt = c; +	    if (optstring[0] == ':') +	      c = ':'; +	    else +	      c = '?'; +	    return c; +	  } +	else +	  /* We already incremented `optind' once; +	     increment it again when taking next ARGV-elt as argument.  */ +	  optarg = argv[optind++]; + +	/* optarg is now the argument, see if it's in the +	   table of longopts.  */ + +	for (nextchar = nameend = optarg; *nameend && *nameend != '='; nameend++) +	  /* Do nothing.  */ ; + +	/* Test all long options for either exact match +	   or abbreviated matches.  */ +	for (p = longopts, option_index = 0; p != NULL && p->name; p++, option_index++) +	  if (!strncmp (p->name, nextchar, nameend - nextchar)) +	    { +	      if ((unsigned int) (nameend - nextchar) == strlen (p->name)) +		{ +		  /* Exact match found.  */ +		  pfound = p; +		  indfound = option_index; +		  exact = 1; +		  break; +		} +	      else if (pfound == NULL) +		{ +		  /* First nonexact match found.  */ +		  pfound = p; +		  indfound = option_index; +		} +	      else +		/* Second or later nonexact match found.  */ +		ambig = 1; +	    } +	if (ambig && !exact) +	  { +	    if (print_errors) +	      fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"), +		       argv[0], argv[optind]); +	    nextchar += strlen (nextchar); +	    optind++; +	    return '?'; +	  } +	if (pfound != NULL) +	  { +	    option_index = indfound; +	    if (*nameend) +	      { +		/* Don't test has_arg with >, because some C compilers don't +		   allow it to be used on enums.  */ +		if (pfound->has_arg) +		  optarg = nameend + 1; +		else +		  { +		    if (print_errors) +		      fprintf (stderr, _("\ +%s: option `-W %s' doesn't allow an argument\n"), +			       argv[0], pfound->name); + +		    nextchar += strlen (nextchar); +		    return '?'; +		  } +	      } +	    else if (pfound->has_arg == 1) +	      { +		if (optind < argc) +		  optarg = argv[optind++]; +		else +		  { +		    if (print_errors) +		      fprintf (stderr, +			       _("%s: option `%s' requires an argument\n"), +			       argv[0], argv[optind - 1]); +		    nextchar += strlen (nextchar); +		    return optstring[0] == ':' ? ':' : '?'; +		  } +	      } +	    nextchar += strlen (nextchar); +	    if (longind != NULL) +	      *longind = option_index; +	    if (pfound->flag) +	      { +		*(pfound->flag) = pfound->val; +		return 0; +	      } +	    return pfound->val; +	  } +	  nextchar = NULL; +	  return 'W';	/* Let the application handle it.   */ +      } +    if (temp[1] == ':') +      { +	if (temp[2] == ':') +	  { +	    /* This is an option that accepts an argument optionally.  */ +	    if (*nextchar != '\0') +	      { +		optarg = nextchar; +		optind++; +	      } +	    else +	      optarg = NULL; +	    nextchar = NULL; +	  } +	else +	  { +	    /* This is an option that requires an argument.  */ +	    if (*nextchar != '\0') +	      { +		optarg = nextchar; +		/* If we end this ARGV-element by taking the rest as an arg, +		   we must advance to the next element now.  */ +		optind++; +	      } +	    else if (optind == argc) +	      { +		if (print_errors) +		  { +		    /* 1003.2 specifies the format of this message.  */ +		    fprintf (stderr, +			     _("%s: option requires an argument -- %c\n"), +			     argv[0], c); +		  } +		optopt = c; +		if (optstring[0] == ':') +		  c = ':'; +		else +		  c = '?'; +	      } +	    else +	      /* We already incremented `optind' once; +		 increment it again when taking next ARGV-elt as argument.  */ +	      optarg = argv[optind++]; +	    nextchar = NULL; +	  } +      } +    return c; +  } +} + +int +getopt (argc, argv, optstring) +     int argc; +     char *const *argv; +     const char *optstring; +{ +  return _getopt_internal (argc, argv, optstring, +			   (const struct option *) 0, +			   (int *) 0, +			   0); +} + +#endif	/* Not ELIDE_CODE.  */ + +#ifdef TEST + +/* Compile with -DTEST to make an executable for use in testing +   the above definition of `getopt'.  */ + +int +main (argc, argv) +     int argc; +     char **argv; +{ +  int c; +  int digit_optind = 0; + +  while (1) +    { +      int this_option_optind = optind ? optind : 1; + +      c = getopt (argc, argv, "abc:d:0123456789"); +      if (c == -1) +	break; + +      switch (c) +	{ +	case '0': +	case '1': +	case '2': +	case '3': +	case '4': +	case '5': +	case '6': +	case '7': +	case '8': +	case '9': +	  if (digit_optind != 0 && digit_optind != this_option_optind) +	    printf ("digits occur in two different argv-elements.\n"); +	  digit_optind = this_option_optind; +	  printf ("option %c\n", c); +	  break; + +	case 'a': +	  printf ("option a\n"); +	  break; + +	case 'b': +	  printf ("option b\n"); +	  break; + +	case 'c': +	  printf ("option c with value `%s'\n", optarg); +	  break; + +	case '?': +	  break; + +	default: +	  printf ("?? getopt returned character code 0%o ??\n", c); +	} +    } + +  if (optind < argc) +    { +      printf ("non-option ARGV-elements: "); +      while (optind < argc) +	printf ("%s ", argv[optind++]); +      printf ("\n"); +    } + +  exit (0); +} + +#endif /* TEST */ diff --git a/host/examples/getopt/getopt.h b/host/examples/getopt/getopt.h new file mode 100644 index 000000000..a1b8dd665 --- /dev/null +++ b/host/examples/getopt/getopt.h @@ -0,0 +1,180 @@ +/* Declarations for getopt. +   Copyright (C) 1989-1994, 1996-1999, 2001 Free Software Foundation, Inc. +   This file is part of the GNU C Library. + +   The GNU C Library is free software; you can redistribute it and/or +   modify it under the terms of the GNU Lesser General Public +   License as published by the Free Software Foundation; either +   version 2.1 of the License, or (at your option) any later version. + +   The GNU C Library 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 +   Lesser General Public License for more details. + +   You should have received a copy of the GNU Lesser General Public +   License along with the GNU C Library; if not, write to the Free +   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA +   02111-1307 USA.  */ + +#ifndef _GETOPT_H + +#ifndef __need_getopt +# define _GETOPT_H 1 +#endif + +/* If __GNU_LIBRARY__ is not already defined, either we are being used +   standalone, or this is the first header included in the source file. +   If we are being used with glibc, we need to include <features.h>, but +   that does not exist if we are standalone.  So: if __GNU_LIBRARY__ is +   not defined, include <ctype.h>, which will pull in <features.h> for us +   if it's from glibc.  (Why ctype.h?  It's guaranteed to exist and it +   doesn't flood the namespace with stuff the way some other headers do.)  */ +#if !defined __GNU_LIBRARY__ +# include <ctype.h> +#endif + +#ifdef	__cplusplus +extern "C" { +#endif + +/* For communication from `getopt' to the caller. +   When `getopt' finds an option that takes an argument, +   the argument value is returned here. +   Also, when `ordering' is RETURN_IN_ORDER, +   each non-option ARGV-element is returned here.  */ + +extern char *optarg; + +/* Index in ARGV of the next element to be scanned. +   This is used for communication to and from the caller +   and for communication between successive calls to `getopt'. + +   On entry to `getopt', zero means this is the first call; initialize. + +   When `getopt' returns -1, this is the index of the first of the +   non-option elements that the caller should itself scan. + +   Otherwise, `optind' communicates from one call to the next +   how much of ARGV has been scanned so far.  */ + +extern int optind; + +/* Callers store zero here to inhibit the error message `getopt' prints +   for unrecognized options.  */ + +extern int opterr; + +/* Set to an option character which was unrecognized.  */ + +extern int optopt; + +#ifndef __need_getopt +/* Describe the long-named options requested by the application. +   The LONG_OPTIONS argument to getopt_long or getopt_long_only is a vector +   of `struct option' terminated by an element containing a name which is +   zero. + +   The field `has_arg' is: +   no_argument		(or 0) if the option does not take an argument, +   required_argument	(or 1) if the option requires an argument, +   optional_argument 	(or 2) if the option takes an optional argument. + +   If the field `flag' is not NULL, it points to a variable that is set +   to the value given in the field `val' when the option is found, but +   left unchanged if the option is not found. + +   To have a long-named option do something other than set an `int' to +   a compiled-in constant, such as set a value from `optarg', set the +   option's `flag' field to zero and its `val' field to a nonzero +   value (the equivalent single-letter option character, if there is +   one).  For long options that have a zero `flag' field, `getopt' +   returns the contents of the `val' field.  */ + +struct option +{ +# if (defined __STDC__ && __STDC__) || defined __cplusplus +  const char *name; +# else +  char *name; +# endif +  /* has_arg can't be an enum because some compilers complain about +     type mismatches in all the code that assumes it is an int.  */ +  int has_arg; +  int *flag; +  int val; +}; + +/* Names for the values of the `has_arg' field of `struct option'.  */ + +# define no_argument		0 +# define required_argument	1 +# define optional_argument	2 +#endif	/* need getopt */ + + +/* Get definitions and prototypes for functions to process the +   arguments in ARGV (ARGC of them, minus the program name) for +   options given in OPTS. + +   Return the option character from OPTS just read.  Return -1 when +   there are no more options.  For unrecognized options, or options +   missing arguments, `optopt' is set to the option letter, and '?' is +   returned. + +   The OPTS string is a list of characters which are recognized option +   letters, optionally followed by colons, specifying that that letter +   takes an argument, to be placed in `optarg'. + +   If a letter in OPTS is followed by two colons, its argument is +   optional.  This behavior is specific to the GNU `getopt'. + +   The argument `--' causes premature termination of argument +   scanning, explicitly telling `getopt' that there are no more +   options. + +   If OPTS begins with `--', then non-option arguments are treated as +   arguments to the option '\0'.  This behavior is specific to the GNU +   `getopt'.  */ + +#if (defined __STDC__ && __STDC__) || defined __cplusplus +# ifdef __GNU_LIBRARY__ +/* Many other libraries have conflicting prototypes for getopt, with +   differences in the consts, in stdlib.h.  To avoid compilation +   errors, only prototype getopt for the GNU C library.  */ +extern int getopt (int __argc, char *const *__argv, const char *__shortopts); +# else /* not __GNU_LIBRARY__ */ +extern int getopt (); +# endif /* __GNU_LIBRARY__ */ + +# ifndef __need_getopt +extern int getopt_long (int __argc, char *const *__argv, const char *__shortopts, +		        const struct option *__longopts, int *__longind); +extern int getopt_long_only (int __argc, char *const *__argv, +			     const char *__shortopts, +		             const struct option *__longopts, int *__longind); + +/* Internal only.  Users should not call this directly.  */ +extern int _getopt_internal (int __argc, char *const *__argv, +			     const char *__shortopts, +		             const struct option *__longopts, int *__longind, +			     int __long_only); +# endif +#else /* not __STDC__ */ +extern int getopt (); +# ifndef __need_getopt +extern int getopt_long (); +extern int getopt_long_only (); + +extern int _getopt_internal (); +# endif +#endif /* __STDC__ */ + +#ifdef	__cplusplus +} +#endif + +/* Make sure we later can get all the definitions and declarations.  */ +#undef __need_getopt + +#endif /* getopt.h */ diff --git a/host/examples/getopt/getopt1.c b/host/examples/getopt/getopt1.c new file mode 100644 index 000000000..22a7efbdd --- /dev/null +++ b/host/examples/getopt/getopt1.c @@ -0,0 +1,188 @@ +/* getopt_long and getopt_long_only entry points for GNU getopt. +   Copyright (C) 1987,88,89,90,91,92,93,94,96,97,98 +     Free Software Foundation, Inc. +   This file is part of the GNU C Library. + +   The GNU C Library is free software; you can redistribute it and/or +   modify it under the terms of the GNU Lesser General Public +   License as published by the Free Software Foundation; either +   version 2.1 of the License, or (at your option) any later version. + +   The GNU C Library 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 +   Lesser General Public License for more details. + +   You should have received a copy of the GNU Lesser General Public +   License along with the GNU C Library; if not, write to the Free +   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA +   02111-1307 USA.  */ + +#ifdef HAVE_CONFIG_H +#include <config.h> +#endif + +#include "getopt.h" + +#if !defined __STDC__ || !__STDC__ +/* This is a separate conditional since some stdc systems +   reject `defined (const)'.  */ +#ifndef const +#define const +#endif +#endif + +#include <stdio.h> + +/* Comment out all this code if we are using the GNU C Library, and are not +   actually compiling the library itself.  This code is part of the GNU C +   Library, but also included in many other GNU distributions.  Compiling +   and linking in this code is a waste when using the GNU C library +   (especially if it is a shared library).  Rather than having every GNU +   program understand `configure --with-gnu-libc' and omit the object files, +   it is simpler to just do this in the source for each such file.  */ + +#define GETOPT_INTERFACE_VERSION 2 +#if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2 +#include <gnu-versions.h> +#if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION +#define ELIDE_CODE +#endif +#endif + +#ifndef ELIDE_CODE + + +/* This needs to come after some library #include +   to get __GNU_LIBRARY__ defined.  */ +#ifdef __GNU_LIBRARY__ +#include <stdlib.h> +#endif + +#ifndef	NULL +#define NULL 0 +#endif + +int +getopt_long (argc, argv, options, long_options, opt_index) +     int argc; +     char *const *argv; +     const char *options; +     const struct option *long_options; +     int *opt_index; +{ +  return _getopt_internal (argc, argv, options, long_options, opt_index, 0); +} + +/* Like getopt_long, but '-' as well as '--' can indicate a long option. +   If an option that starts with '-' (not '--') doesn't match a long option, +   but does match a short option, it is parsed as a short option +   instead.  */ + +int +getopt_long_only (argc, argv, options, long_options, opt_index) +     int argc; +     char *const *argv; +     const char *options; +     const struct option *long_options; +     int *opt_index; +{ +  return _getopt_internal (argc, argv, options, long_options, opt_index, 1); +} + + +#endif	/* Not ELIDE_CODE.  */ + +#ifdef TEST + +#include <stdio.h> + +int +main (argc, argv) +     int argc; +     char **argv; +{ +  int c; +  int digit_optind = 0; + +  while (1) +    { +      int this_option_optind = optind ? optind : 1; +      int option_index = 0; +      static struct option long_options[] = +      { +	{"add", 1, 0, 0}, +	{"append", 0, 0, 0}, +	{"delete", 1, 0, 0}, +	{"verbose", 0, 0, 0}, +	{"create", 0, 0, 0}, +	{"file", 1, 0, 0}, +	{0, 0, 0, 0} +      }; + +      c = getopt_long (argc, argv, "abc:d:0123456789", +		       long_options, &option_index); +      if (c == -1) +	break; + +      switch (c) +	{ +	case 0: +	  printf ("option %s", long_options[option_index].name); +	  if (optarg) +	    printf (" with arg %s", optarg); +	  printf ("\n"); +	  break; + +	case '0': +	case '1': +	case '2': +	case '3': +	case '4': +	case '5': +	case '6': +	case '7': +	case '8': +	case '9': +	  if (digit_optind != 0 && digit_optind != this_option_optind) +	    printf ("digits occur in two different argv-elements.\n"); +	  digit_optind = this_option_optind; +	  printf ("option %c\n", c); +	  break; + +	case 'a': +	  printf ("option a\n"); +	  break; + +	case 'b': +	  printf ("option b\n"); +	  break; + +	case 'c': +	  printf ("option c with value `%s'\n", optarg); +	  break; + +	case 'd': +	  printf ("option d with value `%s'\n", optarg); +	  break; + +	case '?': +	  break; + +	default: +	  printf ("?? getopt returned character code 0%o ??\n", c); +	} +    } + +  if (optind < argc) +    { +      printf ("non-option ARGV-elements: "); +      while (optind < argc) +	printf ("%s ", argv[optind++]); +      printf ("\n"); +    } + +  exit (0); +} + +#endif /* TEST */ diff --git a/host/examples/rx_samples_c.c b/host/examples/rx_samples_c.c new file mode 100644 index 000000000..0be0d8afe --- /dev/null +++ b/host/examples/rx_samples_c.c @@ -0,0 +1,291 @@ +/* + * Copyright 2015 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/>. + */ + +#include <uhd.h> + +#include "getopt.h" + +#include <stdio.h> +#include <stdlib.h> +#include <string.h> + +#define EXECUTE_OR_GOTO(label, ...) \ +    if(__VA_ARGS__){ \ +        return_code = EXIT_FAILURE; \ +        goto label; \ +    } + +void print_help(void){ +    fprintf(stderr, "rx_samples_c - A simple RX example using UHD's C API\n\n" + +                    "Options:\n" +                    "    -a (device args)\n" +                    "    -f (frequency in Hz)\n" +                    "    -r (sample rate in Hz)\n" +                    "    -g (gain)\n" +                    "    -n (number of samples to receive)\n" +                    "    -o (output filename, default = \"out.dat\")\n" +                    "    -v (enable verbose prints)\n" +                    "    -h (print this help message)\n"); +}; + +int main(int argc, char* argv[]) +{ +    if(uhd_set_thread_priority(uhd_default_thread_priority, true)){ +        fprintf(stderr, "Unable to set thread priority. Continuing anyway.\n"); +    } + +    int option = 0; +    double freq = 500e6; +    double rate = 1e6; +    double gain = 5.0; +    char* device_args = ""; +    size_t channel = 0; +    char* filename = "out.dat"; +    size_t n_samples = 1000000; +    bool verbose = false; +    int return_code = EXIT_SUCCESS; +    bool custom_filename = false; +    char error_string[512]; + +    // Process options +    while((option = getopt(argc, argv, "a:f:r:g:n:o:vh")) != -1){ +        switch(option){ +            case 'a': +                device_args = strdup(optarg); +                break; + +            case 'f': +                freq = atof(optarg); +                break; + +            case 'r': +                rate = atof(optarg); +                break; + +            case 'g': +                gain = atof(optarg); +                break; + +            case 'n': +                n_samples = atoi(optarg); +                break; + +            case 'o': +                filename = strdup(optarg); +                custom_filename = true; +                break; + +            case 'v': +                verbose = true; +                break; + +            case 'h': +                print_help(); +                goto free_option_strings; + +            default: +                print_help(); +                return_code = EXIT_FAILURE; +                goto free_option_strings; +        } +    } + +    // Create USRP +    uhd_usrp_handle usrp; +    fprintf(stderr, "Creating USRP with args \"%s\"...\n", device_args); +    EXECUTE_OR_GOTO(free_usrp, +        uhd_usrp_make(&usrp, device_args) +    ) + +    // Create RX streamer +    uhd_rx_streamer_handle rx_streamer; +    EXECUTE_OR_GOTO(free_rx_streamer, +        uhd_rx_streamer_make(&rx_streamer) +    ) + +    // Create RX metadata +    uhd_rx_metadata_handle md; +    EXECUTE_OR_GOTO(free_rx_metadata, +        uhd_rx_metadata_make(&md) +    ) + +    // Create other necessary structs +    uhd_tune_request_t tune_request = { +        .target_freq = freq, +        .rf_freq_policy = UHD_TUNE_REQUEST_POLICY_AUTO, +        .dsp_freq_policy = UHD_TUNE_REQUEST_POLICY_AUTO, +    }; +    uhd_tune_result_t tune_result; + +    uhd_stream_args_t stream_args = { +        .cpu_format = "fc32", +        .otw_format = "sc16", +        .args = "", +        .channel_list = &channel, +        .n_channels = 1 +    }; + +    uhd_stream_cmd_t stream_cmd = { +        .stream_mode = UHD_STREAM_MODE_NUM_SAMPS_AND_DONE, +        .num_samps = n_samples, +        .stream_now = true +    }; + +    size_t samps_per_buff; +    float *buff = NULL; +    void **buffs_ptr = NULL; +    FILE *fp = NULL; +    size_t num_acc_samps = 0; + +    // Set rate +    fprintf(stderr, "Setting RX Rate: %f...\n", rate); +    EXECUTE_OR_GOTO(free_rx_metadata, +        uhd_usrp_set_rx_rate(usrp, rate, channel) +    ) + +    // See what rate actually is +    EXECUTE_OR_GOTO(free_rx_metadata, +        uhd_usrp_get_rx_rate(usrp, channel, &rate) +    ) +    fprintf(stderr, "Actual RX Rate: %f...\n", rate); + +    // Set gain +    fprintf(stderr, "Setting RX Gain: %f dB...\n", gain); +    EXECUTE_OR_GOTO(free_rx_metadata, +        uhd_usrp_set_rx_gain(usrp, gain, channel, "") +    ) + +    // See what gain actually is +    EXECUTE_OR_GOTO(free_rx_metadata, +        uhd_usrp_get_rx_gain(usrp, channel, "", &gain) +    ) +    fprintf(stderr, "Actual RX Gain: %f...\n", gain); + +    // Set frequency +    fprintf(stderr, "Setting RX frequency: %f MHz...\n", freq/1e6); +    EXECUTE_OR_GOTO(free_rx_metadata, +        uhd_usrp_set_rx_freq(usrp, &tune_request, channel, &tune_result) +    ) + +    // See what frequency actually is +    EXECUTE_OR_GOTO(free_rx_metadata, +        uhd_usrp_get_rx_freq(usrp, channel, &freq) +    ) +    fprintf(stderr, "Actual RX frequency: %f MHz...\n", freq / 1e6); + +    // Set up streamer +    stream_args.channel_list = &channel; +    EXECUTE_OR_GOTO(free_rx_streamer, +        uhd_usrp_get_rx_stream(usrp, &stream_args, rx_streamer) +    ) + +    // Set up buffer +    EXECUTE_OR_GOTO(free_rx_streamer, +        uhd_rx_streamer_max_num_samps(rx_streamer, &samps_per_buff) +    ) +    fprintf(stderr, "Buffer size in samples: %zu\n", samps_per_buff); +    buff = malloc(samps_per_buff * 2 * sizeof(float)); +    buffs_ptr = (void**)&buff; + +    // Issue stream command +    fprintf(stderr, "Issuing stream command.\n"); +    EXECUTE_OR_GOTO(free_buffer, +        uhd_rx_streamer_issue_stream_cmd(rx_streamer, &stream_cmd) +    ) + +    // Set up file output +    fp = fopen(filename, "wb"); + +    // Actual streaming +    while (num_acc_samps < n_samples) { +        size_t num_rx_samps = 0; +        EXECUTE_OR_GOTO(close_file, +            uhd_rx_streamer_recv(rx_streamer, buffs_ptr, samps_per_buff, md, 3.0, false, &num_rx_samps) +        ) + +        uhd_rx_metadata_error_code_t error_code; +        EXECUTE_OR_GOTO(close_file, +            uhd_rx_metadata_error_code(md, &error_code) +        ) +        if(return_code != UHD_RX_METADATA_ERROR_CODE_NONE){ +            fprintf(stderr, "Error code 0x%x was returned during streaming. Aborting.\n", return_code); +            goto close_file; +        } + +        // Handle data +        fwrite(buff, sizeof(float) * 2, num_rx_samps, fp); +        if (verbose) { +            time_t full_secs; +            double frac_secs; +            uhd_rx_metadata_time_spec(md, &full_secs, &frac_secs); +            fprintf(stderr, "Received packet: %zu samples, %zu full secs, %f frac secs\n", +                    num_rx_samps, +                    full_secs, +                    frac_secs); +        } + +        num_acc_samps += num_rx_samps; +    } + +    // Cleanup +    close_file: +        fclose(fp); + +    free_buffer: +        if(buff){ +            if(verbose){ +                fprintf(stderr, "Freeing buffer.\n"); +            } +            free(buff); +        } +        buff = NULL; +        buffs_ptr = NULL; + +    free_rx_streamer: +        if(verbose){ +            fprintf(stderr, "Cleaning up RX streamer.\n"); +        } +        uhd_rx_streamer_free(&rx_streamer); + +    free_rx_metadata: +        if(verbose){ +            fprintf(stderr, "Cleaning up RX metadata.\n"); +        } +        uhd_rx_metadata_free(&md); + +    free_usrp: +        if(verbose){ +            fprintf(stderr, "Cleaning up USRP.\n"); +        } +        if(return_code != EXIT_SUCCESS){ +            uhd_usrp_last_error(usrp, error_string, 512); +            fprintf(stderr, "USRP reported the following error: %s\n", error_string); +        } +        uhd_usrp_free(&usrp); + +    free_option_strings: +        if(strcmp(device_args,"")){ +            free(device_args); +        } +        if(custom_filename){ +            free(filename); +        } + +    fprintf(stderr, (return_code ? "Failure\n" : "Success\n")); +    return return_code; +} diff --git a/host/examples/tx_samples_c.c b/host/examples/tx_samples_c.c new file mode 100644 index 000000000..5a4b79005 --- /dev/null +++ b/host/examples/tx_samples_c.c @@ -0,0 +1,241 @@ +/* + * Copyright 2015 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/>. + */ + +#include <uhd.h> + +#include "getopt.h" + +#include <math.h> +#include <signal.h> +#include <stdio.h> +#include <stdlib.h> +#include <string.h> + +#define EXECUTE_OR_GOTO(label, ...) \ +    if(__VA_ARGS__){ \ +        return_code = EXIT_FAILURE; \ +        goto label; \ +    } + +void print_help(void){ +    fprintf(stderr, "tx_samples_c - A simple TX example using UHD's C API\n\n" + +                    "Options:\n" +                    "    -a (device args)\n" +                    "    -f (frequency in Hz)\n" +                    "    -r (sample rate in Hz)\n" +                    "    -g (gain)\n" +                    "    -v (enable verbose prints)\n" +                    "    -h (print this help message)\n"); +} + +bool stop_signal_called = false; + +void sigint_handler(int code){ +    (void)code; +    stop_signal_called = true; +} + +int main(int argc, char* argv[]){ +    int option = 0; +    double freq = 2e9; +    double rate = 1e6; +    double gain = 0; +    char* device_args = ""; +    size_t channel = 0; +    bool verbose = false; +    int return_code = EXIT_SUCCESS; +    char error_string[512]; + +    // Process options +    while((option = getopt(argc, argv, "a:f:r:g:vh")) != -1){ +        switch(option){ +            case 'a': +                device_args = strdup(optarg); +                break; + +            case 'f': +                freq = atof(optarg); +                break; + +            case 'r': +                rate = atof(optarg); +                break; + +            case 'g': +                gain = atof(optarg); +                break; + +            case 'v': +                verbose = true; +                break; + +            case 'h': +                print_help(); +                goto free_option_strings; + +            default: +                print_help(); +                return_code = EXIT_FAILURE; +                goto free_option_strings; +        } +    } + +    if(uhd_set_thread_priority(uhd_default_thread_priority, true)){ +        fprintf(stderr, "Unable to set thread priority. Continuing anyway.\n"); +    } + +    // Create USRP +    uhd_usrp_handle usrp; +    fprintf(stderr, "Creating USRP with args \"%s\"...\n", device_args); +    EXECUTE_OR_GOTO(free_usrp, +        uhd_usrp_make(&usrp, device_args) +    ) + +    // Create TX streamer +    uhd_tx_streamer_handle tx_streamer; +    EXECUTE_OR_GOTO(free_tx_streamer, +        uhd_tx_streamer_make(&tx_streamer) +    ) + +    // Create TX metadata +    uhd_tx_metadata_handle md; +    EXECUTE_OR_GOTO(free_tx_metadata, +        uhd_tx_metadata_make(&md, false, 0.0, 0.1, true, false) +    ) + +    // Create other necessary structs +    uhd_tune_request_t tune_request = { +        .target_freq = freq, +        .rf_freq_policy = UHD_TUNE_REQUEST_POLICY_AUTO, +        .dsp_freq_policy = UHD_TUNE_REQUEST_POLICY_AUTO +    }; +    uhd_tune_result_t tune_result; + +    uhd_stream_args_t stream_args = { +        .cpu_format = "fc32", +        .otw_format = "sc16", +        .args = "", +        .channel_list = &channel, +        .n_channels = 1 +    }; + +    size_t samps_per_buff; +    float* buff = NULL; +    const void** buffs_ptr = NULL; + +    // Set rate +    fprintf(stderr, "Setting TX Rate: %f...\n", rate); +    EXECUTE_OR_GOTO(free_tx_metadata, +        uhd_usrp_set_tx_rate(usrp, rate, channel) +    ) + +    // See what rate actually is +    EXECUTE_OR_GOTO(free_tx_metadata, +        uhd_usrp_get_tx_rate(usrp, channel, &rate) +    ) +    fprintf(stderr, "Actual TX Rate: %f...\n\n", rate); + +    // Set gain +    fprintf(stderr, "Setting TX Gain: %f db...\n", gain); +    EXECUTE_OR_GOTO(free_tx_metadata, +        uhd_usrp_set_tx_gain(usrp, gain, 0, "") +    ) + +    // See what gain actually is +    EXECUTE_OR_GOTO(free_tx_metadata, +        uhd_usrp_get_tx_gain(usrp, channel, "", &gain) +    ) +    fprintf(stderr, "Actual TX Gain: %f...\n", gain); + +    // Set frequency +    fprintf(stderr, "Setting TX frequency: %f MHz...\n", freq / 1e6); +    EXECUTE_OR_GOTO(free_tx_metadata, +        uhd_usrp_set_tx_freq(usrp, &tune_request, channel, &tune_result) +    ) + +    // See what frequency actually is +    EXECUTE_OR_GOTO(free_tx_metadata, +        uhd_usrp_get_tx_freq(usrp, channel, &freq) +    ) +    fprintf(stderr, "Actual TX frequency: %f MHz...\n", freq / 1e6); + +    // Set up streamer +    stream_args.channel_list = &channel; +    EXECUTE_OR_GOTO(free_tx_streamer, +        uhd_usrp_get_tx_stream(usrp, &stream_args, tx_streamer) +    ) + +    // Set up buffer +    EXECUTE_OR_GOTO(free_tx_streamer, +        uhd_tx_streamer_max_num_samps(tx_streamer, &samps_per_buff) +    ) +    fprintf(stderr, "Buffer size in samples: %zu\n", samps_per_buff); +    buff = malloc(samps_per_buff * 2 * sizeof(float)); +    buffs_ptr = (const void**)&buff; +    size_t i = 0; +    for(i = 0; i < (samps_per_buff*2); i+=2){ +        buff[i] = 0.1; +        buff[i+1] = 0; +    } + +    // Ctrl+C will exit loop +    signal(SIGINT, &sigint_handler); +    fprintf(stderr, "Press Ctrl+C to stop streaming...\n"); + +    // Actual streaming +    size_t num_samps_sent = 0; +    while(!stop_signal_called){ +        EXECUTE_OR_GOTO(free_tx_streamer, +            uhd_tx_streamer_send(tx_streamer, buffs_ptr, samps_per_buff, md, 0.1, &num_samps_sent) +        ) +        if(verbose){ +            fprintf(stderr, "Sent %zu samples\n", num_samps_sent); +        } +    } + +    free_tx_streamer: +        if(verbose){ +            fprintf(stderr, "Cleaning up TX streamer.\n"); +        } +        uhd_tx_streamer_free(&tx_streamer); + +    free_tx_metadata: +        if(verbose){ +            fprintf(stderr, "Cleaning up TX metadata.\n"); +        } +        uhd_tx_metadata_free(&md); + +    free_usrp: +        if(verbose){ +            fprintf(stderr, "Cleaning up USRP.\n"); +        } +        if(return_code != EXIT_SUCCESS){ +            uhd_usrp_last_error(usrp, error_string, 512); +            fprintf(stderr, "USRP reported the following error: %s\n", error_string); +        } +        uhd_usrp_free(&usrp); + +    free_option_strings: +        if(strcmp(device_args,"")){ +            free(device_args); +        } + +    fprintf(stderr, (return_code ? "Failure" : "Success")); + +    return return_code; +} | 
