Correct const-ness of write to agree with ftdi.h
[libftdi] / ftdipp / ftdi.hpp
index 7b6a9a0..4e3511d 100644 (file)
@@ -1,9 +1,38 @@
-#ifndef FTDICPP_H
-#define FTDICPP_H
+/***************************************************************************
+                          ftdi.hpp  -  C++ wrapper for libftdi
+                             -------------------
+    begin                : Mon Oct 13 2008
+    copyright            : (C) 2008-2017 by Marek Vavruša and libftdi developers
+    email                : opensource@intra2net.com and marek@vavrusa.com
+ ***************************************************************************/
+/*
+Copyright (C) 2008-2017 by Marek Vavruša and libftdi developers
+
+The software in this package is distributed under the GNU General
+Public License version 2 (with a special exception described below).
+
+A copy of GNU General Public License (GPL) is included in this distribution,
+in the file COPYING.GPL.
+
+As a special exception, if other files instantiate templates or use macros
+or inline functions from this file, or you compile this file and link it
+with other works to produce a work based on this file, this file
+does not by itself cause the resulting work to be covered
+by the GNU General Public License.
+
+However the source code for this file must still be made available
+in accordance with section (3) of the GNU General Public License.
+
+This exception does not invalidate any other reasons why a work based
+on this file might be covered by the GNU General Public License.
+*/
+#ifndef __libftdi_hpp__
+#define __libftdi_hpp__
 
 #include <list>
 #include <string>
-#include "ftdi.h"
+#include <boost/shared_ptr.hpp>
+#include <ftdi.h>
 
 namespace Ftdi
 {
@@ -17,142 +46,174 @@ class Eeprom;
  */
 class Context
 {
-   /* Friends */
-   friend class Eeprom;
-   friend class List;
-   
-   public:
-
-      /*! \brief Direction flags for flush().
-       */
-      enum Direction
-      {
-         Input,
-         Output
-      };
-
-      /*! \brief Modem control flags.
-       */
-      enum ModemCtl
-      {
-         Dtr,
-         Rts
-      };
-
-      /* Constructor, Destructor */
-      Context();
-      ~Context();
-      
-      /* Properties */
-      Eeprom* eeprom();
-      const std::string& vendor();
-      const std::string& description();
-      const std::string& serial();
-
-      /* Device manipulators */
-      bool is_open();
-      int open(struct usb_device *dev = 0);
-      int open(int vendor, int product, const std::string& description = std::string(), const std::string& serial = std::string());
-      int close();
-      int reset();
-      int flush(int mask = Input|Output);
-      int set_interface(enum ftdi_interface interface);
-      void set_usb_device(struct usb_dev_handle *dev);
-      /* Line manipulators */
-      int set_baud_rate(int baudrate);
-      int set_line_property(enum ftdi_bits_type bits, enum ftdi_stopbits_type sbit, enum ftdi_parity_type parity);
-      int set_line_property(enum ftdi_bits_type bits, enum ftdi_stopbits_type sbit, enum ftdi_parity_type parity, enum ftdi_break_type break_type);
-
-      /* I/O */
-      int read(unsigned char *buf, int size);
-      int write(unsigned char *buf, int size);
-      int set_read_chunk_size(unsigned int chunksize);
-      int set_write_chunk_size(unsigned int chunksize);
-      int read_chunk_size();
-      int write_chunk_size();
-
-      /* Async IO
-      TODO: should wrap?
-      int writeAsync(unsigned char *buf, int size);
-      void asyncComplete(int wait_for_more);
-      */
-
-      /* Flow control */
-      int set_event_char(unsigned char eventch, unsigned char enable);
-      int set_error_char(unsigned char errorch, unsigned char enable);
-      int set_flow_control(int flowctrl);
-      int set_modem_control(int mask = Dtr|Rts);
-      int set_latency(unsigned char latency);
-      int set_dtr(bool state);
-      int set_rts(bool state);
-      
-      unsigned short poll_modem_status();
-      unsigned latency();
-
-      /* BitBang mode */
-      int set_bitmode(unsigned char bitmask, unsigned char mode);
-      int bitbang_enable(unsigned char bitmask);
-      int bitbang_disable();
-      int read_pins(unsigned char *pins);
-
-      /* Misc */
-      char* error_string();
-
-   protected:
-      int get_strings();
-
-      /* Properties */
-      struct ftdi_context* context();
-      void set_context(struct ftdi_context* context);
-      void set_usb_device(struct usb_device *dev);
-
-   private:
-      class Private;
-      Private *d;
-
-      /* Disable copy constructor */
-      Context(const Context &) {}
-      Context& operator=(const Context &) {}
+    /* Friends */
+    friend class Eeprom;
+    friend class List;
+
+public:
+    /*! \brief Direction flags for flush().
+     */
+    enum Direction
+    {
+        Input,
+        Output
+    };
+
+    /*! \brief Modem control flags.
+     */
+    enum ModemCtl
+    {
+        Dtr,
+        Rts
+    };
+
+    /* Constructor, Destructor */
+    Context();
+    ~Context();
+
+    /* Properties */
+    Eeprom* eeprom();
+    const std::string& vendor();
+    const std::string& description();
+    const std::string& serial();
+
+    /* Device manipulators */
+    bool is_open();
+    int open(struct libusb_device *dev = 0);
+    int open(int vendor, int product);
+    int open(int vendor, int product, const std::string& description, const std::string& serial = std::string(), unsigned int index=0);
+    int open(const std::string& description);
+    int close();
+    int reset();
+    int flush(int mask = Input|Output);
+    int set_interface(enum ftdi_interface interface);
+    void set_usb_device(struct libusb_device_handle *dev);
+
+    /* Line manipulators */
+    int set_baud_rate(int baudrate);
+    int set_line_property(enum ftdi_bits_type bits, enum ftdi_stopbits_type sbit, enum ftdi_parity_type parity);
+    int set_line_property(enum ftdi_bits_type bits, enum ftdi_stopbits_type sbit, enum ftdi_parity_type parity, enum ftdi_break_type break_type);
+    int get_usb_read_timeout() const;
+    void set_usb_read_timeout(int usb_read_timeout);
+    int get_usb_write_timeout() const;
+    void set_usb_write_timeout(int usb_write_timeout);
+
+    /* I/O */
+    int read(unsigned char *buf, int size);
+    int write(const unsigned char *buf, int size);
+    int set_read_chunk_size(unsigned int chunksize);
+    int set_write_chunk_size(unsigned int chunksize);
+    int read_chunk_size();
+    int write_chunk_size();
+
+    /* Async IO
+    TODO: should wrap?
+    int writeAsync(const unsigned char *buf, int size);
+    void asyncComplete(int wait_for_more);
+    */
+
+    /* Flow control */
+    int set_event_char(unsigned char eventch, unsigned char enable);
+    int set_error_char(unsigned char errorch, unsigned char enable);
+    int set_flow_control(int flowctrl);
+    int set_modem_control(int mask = Dtr|Rts);
+    int set_latency(unsigned char latency);
+    int set_dtr(bool state);
+    int set_rts(bool state);
+
+    unsigned short poll_modem_status();
+    unsigned latency();
+
+    /* BitBang mode */
+    int set_bitmode(unsigned char bitmask, unsigned char mode);
+    int set_bitmode(unsigned char bitmask, enum ftdi_mpsse_mode mode);
+    int bitbang_disable();
+    int read_pins(unsigned char *pins);
+
+    /* Misc */
+    const char* error_string();
+
+protected:
+    int get_strings(bool vendor=true, bool description=true, bool serial=true);
+    int get_strings_and_reopen(bool vendor=true, bool description=true, bool serial=true);
+
+    /* Properties */
+    struct ftdi_context* context();
+    void set_context(struct ftdi_context* context);
+    void set_usb_device(struct libusb_device *dev);
+
+private:
+    class Private;
+    boost::shared_ptr<Private> d;
 };
 
 /*! \brief Device EEPROM.
  */
 class Eeprom
 {
-   public:
-      Eeprom(Context* parent);
-      ~Eeprom();
-
-      void init_defaults();
-      void set_size(int size);
-      int size(unsigned char *eeprom, int maxsize);
-      int chip_id(unsigned int *chipid);
-      int build(unsigned char *output);
-      int read(unsigned char *eeprom);
-      int write(unsigned char *eeprom);
-      int erase();
-
-   private:
-      class Private;
-      Private *d;
+public:
+    Eeprom(Context* parent);
+    ~Eeprom();
+
+    int init_defaults(char *manufacturer, char* product, char * serial);
+    int chip_id(unsigned int *chipid);
+    int build(unsigned char *output);
+
+    int read(unsigned char *eeprom);
+    int write(unsigned char *eeprom);
+    int read_location(int eeprom_addr, unsigned short *eeprom_val);
+    int write_location(int eeprom_addr, unsigned short eeprom_val);
+    int erase();
+
+private:
+    class Private;
+    boost::shared_ptr<Private> d;
 };
 
-typedef std::list<Context*> ListBase;
-
 /*! \brief Device list.
  */
-class List : public ListBase
+class List
 {
-   public:
-      List(struct ftdi_device_list* devlist = 0);
-      ~List();
-
-      static List* find_all(int vendor, int product);
-
-   private:
-      class Private;
-      Private *d;
+public:
+    List(struct ftdi_device_list* devlist = 0);
+    ~List();
+
+    static List* find_all(Context &context, int vendor, int product);
+
+    /// List type storing "Context" objects
+    typedef std::list<Context> ListType;
+    /// Iterator type for the container
+    typedef ListType::iterator iterator;
+    /// Const iterator type for the container
+    typedef ListType::const_iterator const_iterator;
+    /// Reverse iterator type for the container
+    typedef ListType::reverse_iterator reverse_iterator;
+    /// Const reverse iterator type for the container
+    typedef ListType::const_reverse_iterator const_reverse_iterator;
+
+    iterator begin();
+    iterator end();
+    const_iterator begin() const;
+    const_iterator end() const;
+
+    reverse_iterator rbegin();
+    reverse_iterator rend();
+    const_reverse_iterator rbegin() const;
+    const_reverse_iterator rend() const;
+
+    ListType::size_type size() const;
+    bool empty() const;
+    void clear();
+
+    void push_back(const Context& element);
+    void push_front(const Context& element);
+
+    iterator erase(iterator pos);
+    iterator erase(iterator beg, iterator end);
+
+private:
+    class Private;
+    boost::shared_ptr<Private> d;
 };
 
 }