git.sur5r.net Git - openocd/blob - src/jtag/drivers/usb_blaster/ublast_access.h

   1 /*
   2  *   Driver for USB-JTAG, Altera USB-Blaster and compatibles
   3  *
   4  *   Inspired from original code from Kolja Waschk's USB-JTAG project
   5  *   (http://www.ixo.de/info/usb_jtag/), and from openocd project.
   6  *
   7  *   Copyright (C) 2013 Franck Jullien franck.jullien@gmail.com
   8  *   Copyright (C) 2012 Robert Jarzmik robert.jarzmik@free.fr
   9  *   Copyright (C) 2011 Ali Lown ali@lown.me.uk
  10  *   Copyright (C) 2009 Catalin Patulea cat@vv.carleton.ca
  11  *   Copyright (C) 2006 Kolja Waschk usbjtag@ixo.de
  12  *
  13  *   This program is free software; you can redistribute it and/or modify
  14  *   it under the terms of the GNU General Public License as published by
  15  *   the Free Software Foundation; either version 2 of the License, or
  16  *   (at your option) any later version.
  17  *
  18  *   This program is distributed in the hope that it will be useful,
  19  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  *   GNU General Public License for more details.
  22  *
  23  */
  24
  25 #include <libusb_common.h>
  26
  27 /* Low level flags */
  28 #define COPY_TDO_BUFFER         (1 << 0)
  29
  30 struct ublast_lowlevel {
  31         uint16_t ublast_vid;
  32         uint16_t ublast_pid;
  33         uint16_t ublast_vid_uninit;
  34         uint16_t ublast_pid_uninit;
  35         char *ublast_device_desc;
  36         struct jtag_libusb_device_handle *libusb_dev;
  37         char *firmware_path;
  38
  39         int (*write)(struct ublast_lowlevel *low, uint8_t *buf, int size,
  40                      uint32_t *bytes_written);
  41         int (*read)(struct ublast_lowlevel *low, uint8_t *buf, unsigned size,
  42                     uint32_t *bytes_read);
  43         int (*open)(struct ublast_lowlevel *low);
  44         int (*close)(struct ublast_lowlevel *low);
  45         int (*speed)(struct ublast_lowlevel *low, int speed);
  46
  47         void *priv;
  48         int flags;
  49 };
  50
  51 /**
  52  * ublast_register_ftdi - get a lowlevel USB Blaster driver
  53  * ublast_register_ftd2xx - get a lowlevel USB Blaster driver
  54  * ublast2_register_libusb - get a lowlevel USB Blaster II driver
  55  *
  56  * Get a lowlevel USB-Blaster driver. In the current implementation, there are 3
  57  * possible lowlevel drivers :
  58  *  - one based on libftdi from ftdichip.com
  59  *  - one based on libftdxx, the free alternative
  60  *  - one based on libusb, specific to the USB-Blaster II
  61  *
  62  * Returns the lowlevel driver structure.
  63  */
  64 extern struct ublast_lowlevel *ublast_register_ftdi(void);
  65 extern struct ublast_lowlevel *ublast_register_ftd2xx(void);
  66 extern struct ublast_lowlevel *ublast2_register_libusb(void);