GNU Radio 3.4.2 C++ API
fusb_ra_wb.h
Go to the documentation of this file.
00001 /* -*- c++ -*- */
00002 /*
00003  * Copyright 2003,2006 Free Software Foundation, Inc.
00004  * 
00005  * This file is part of GNU Radio
00006  * 
00007  * GNU Radio is free software; you can redistribute it and/or modify
00008  * it under the terms of the GNU General Public License as published by
00009  * the Free Software Foundation; either version 3, or (at your option)
00010  * any later version.
00011  * 
00012  * GNU Radio is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00015  * GNU General Public License for more details.
00016  * 
00017  * You should have received a copy of the GNU General Public License
00018  * along with GNU Radio; see the file COPYING.  If not, write to
00019  * the Free Software Foundation, Inc., 51 Franklin Street,
00020  * Boston, MA 02110-1301, USA.
00021  */
00022 
00023 #ifndef _FUSB_RA_WB_H_
00024 #define _FUSB_RA_WB_H_
00025 
00026 #include <fusb.h>
00027 
00028 /*!
00029  * \brief generic implementation of fusb_devhandle using only libusb
00030  */
00031 class fusb_devhandle_ra_wb : public fusb_devhandle
00032 {
00033 public:
00034   // CREATORS
00035   fusb_devhandle_ra_wb (usb_dev_handle *udh);
00036   virtual ~fusb_devhandle_ra_wb ();
00037 
00038   // MANIPULATORS
00039   virtual fusb_ephandle *make_ephandle (int endpoint, bool input_p,
00040                                         int block_size = 0, int nblocks = 0);
00041 };
00042 
00043 
00044 /*!
00045  * \brief generic implementation of fusb_ephandle using only libusb
00046  */
00047 class fusb_ephandle_ra_wb : public fusb_ephandle
00048 {
00049 private:
00050   fusb_devhandle_ra_wb  *d_devhandle;
00051   bool d_ra_wb_on;
00052   
00053 public:
00054   // CREATORS
00055   fusb_ephandle_ra_wb (fusb_devhandle_ra_wb *dh, int endpoint, bool input_p,
00056                        int block_size = 0, int nblocks = 0);
00057   virtual ~fusb_ephandle_ra_wb ();
00058 
00059   // MANIPULATORS
00060 
00061   virtual bool start ();        //!< begin streaming i/o
00062   virtual bool stop ();         //!< stop streaming i/o
00063 
00064   /*!
00065    * \returns \p nbytes if write was successfully enqueued, else -1.
00066    * Will block if no free buffers available.
00067    */
00068   virtual int write (const void *buffer, int nbytes);
00069 
00070   /*!
00071    * \returns number of bytes read or -1 if error.
00072    * number of bytes read will be <= nbytes.
00073    * Will block if no input available.
00074    */
00075   virtual int read (void *buffer, int nbytes);
00076 
00077   /*
00078    * block until all outstanding writes have completed
00079    */
00080   virtual void wait_for_completion ();
00081 };
00082 
00083 #endif /* _FUSB_RA_WB_H_ */
00084