usbio_impl.h

   1 /*
   2 Calf Box, an open source musical instrument.
   3 Copyright (C) 2010-2013 Krzysztof Foltman
   4
   5 This program is free software: you can redistribute it and/or modify
   6 it under the terms of the GNU General Public License as published by
   7 the Free Software Foundation, either version 3 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU General Public License for more details.
  14
  15 You should have received a copy of the GNU General Public License
  16 along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17 */
  18
  19 /*
  20
  21 Note:
  22 Those are private structures and functions for the USB driver implementation.
  23 I'm not too happy with the organization of the code yet, it's just a first
  24 try at breaking it up into manageable parts.
  25 */
  26
  27
  28 #ifndef USBIO_IMPL_H
  29 #define USBIO_IMPL_H
  30
  31 #include <libusb.h>
  32
  33 #include "errors.h"
  34 #include "io.h"
  35 #include "midi.h"
  36 #include "mididest.h"
  37
  38 struct usbio_endpoint_descriptor
  39 {
  40     uint8_t found:1;
  41     uint8_t interrupt:1;
  42     uint8_t reserved:6;
  43     uint8_t bEndpointAddress;
  44     uint16_t wMaxPacketSize;
  45 };
  46
  47 struct usbio_transfer
  48 {
  49     struct libusb_context *usbctx;
  50     struct libusb_transfer *transfer;
  51     void *user_data;
  52     gboolean pending;
  53     gboolean cancel_confirm;
  54     const char *transfer_type;
  55     int index;
  56 };
  57
  58 struct cbox_usb_io_impl
  59 {
  60     struct cbox_io_impl ioi;
  61
  62     struct libusb_context *usbctx;
  63     struct libusb_context *usbctx_probe;
  64
  65     GHashTable *device_table;
  66
  67     struct libusb_device_handle *handle_audiodev;
  68     int sample_rate, buffer_size, output_resolution;
  69     int output_channels; // always 2 for now
  70
  71     unsigned int playback_buffers;
  72     unsigned int sync_buffers;
  73     int playback_counter;
  74     int sync_counter;
  75
  76     unsigned int iso_packets, iso_packets_multimix;
  77
  78     pthread_t thr_engine;
  79     volatile gboolean stop_engine, setup_error, no_resubmit;
  80
  81     int desync;
  82     uint64_t samples_played;
  83     int device_removed;
  84     struct usbio_transfer **playback_transfers;
  85     struct usbio_transfer **sync_transfers;
  86     int read_ptr;
  87
  88     GList *midi_ports;
  89     GList *rt_midi_ports;
  90     struct cbox_midi_merger midi_input_merger;
  91     /*
  92     struct cbox_midi_buffer **midi_input_port_buffers;
  93     int *midi_input_port_pos;
  94     int midi_input_port_count;
  95     */
  96     void (*play_function)(struct cbox_usb_io_impl *uii);
  97     int8_t audio_output_endpoint;
  98     int8_t audio_sync_endpoint;
  99     uint32_t sync_freq;
 100     uint32_t audio_output_pktsize;
 101     int debug_sync;
 102 };
 103
 104 enum cbox_usb_device_status
 105 {
 106     CBOX_DEVICE_STATUS_PROBING,
 107     CBOX_DEVICE_STATUS_UNSUPPORTED,
 108     CBOX_DEVICE_STATUS_OPENED,
 109 };
 110
 111 struct cbox_usb_device_info
 112 {
 113     struct libusb_device *dev;
 114     struct libusb_device_handle *handle;
 115     enum cbox_usb_device_status status;
 116     uint8_t bus;
 117     uint8_t devadr;
 118     uint16_t busdevadr;
 119     struct {
 120         uint16_t vid;
 121         uint16_t pid;
 122     };
 123     int active_config;
 124     gboolean is_midi, is_audio;
 125     uint32_t configs_with_midi;
 126     uint32_t configs_with_audio;
 127     time_t last_probe_time;
 128     int failures;
 129 };
 130
 131 struct cbox_usb_audio_info
 132 {
 133     struct cbox_usb_device_info *udi;
 134     int intf;
 135     int alt_setting;
 136     struct usbio_endpoint_descriptor epdesc;
 137 };
 138
 139 enum usb_midi_protocol_type
 140 {
 141     USBMIDI_PROTOCOL_CLASS,
 142     USBMIDI_PROTOCOL_MPD16,
 143     USBMIDI_PROTOCOL_NOCTURN,
 144 };
 145
 146 struct cbox_usb_midi_info
 147 {
 148     struct cbox_usb_device_info *udi;
 149     int intf;
 150     int alt_setting;
 151     struct usbio_endpoint_descriptor epdesc_in;
 152     struct usbio_endpoint_descriptor epdesc_out;
 153     enum usb_midi_protocol_type protocol;
 154 };
 155
 156 #define MAX_MIDI_PACKET_SIZE 256
 157 #define MAX_SYSEX_SIZE CBOX_MIDI_MAX_LONG_DATA
 158
 159 struct cbox_usb_midi_interface
 160 {
 161     struct cbox_usb_io_impl *uii;
 162     struct cbox_usb_device_info *devinfo;
 163     struct libusb_device_handle *handle;
 164     int busdevadr;
 165     struct usbio_endpoint_descriptor epdesc_in, epdesc_out;
 166     struct usbio_transfer *transfer_in, *transfer_out;
 167     struct cbox_midi_buffer midi_buffer;
 168     uint8_t midi_recv_data[MAX_MIDI_PACKET_SIZE];
 169     uint8_t sysex_data[MAX_SYSEX_SIZE];
 170     uint32_t current_sysex_length;
 171     enum usb_midi_protocol_type protocol;
 172 };
 173
 174 #define USB_MIDI_OUTPUT_QUEUE 256
 175
 176 struct cbox_usb_midi_output
 177 {
 178     struct cbox_midi_output hdr;
 179     struct cbox_usb_midi_interface *ifptr;
 180     uint8_t endpoint_buffer[USB_MIDI_OUTPUT_QUEUE];
 181     uint32_t endpoint_buffer_pos;
 182 };
 183
 184 extern struct usbio_transfer *usbio_transfer_new(struct libusb_context *usbctx, const char *transfer_type, int index, int isopackets, void *user_data);
 185 extern void usbio_transfer_shutdown(struct usbio_transfer *xfer);
 186 extern int usbio_transfer_submit(struct usbio_transfer *xfer);
 187 extern void usbio_transfer_destroy(struct usbio_transfer *xfer);
 188
 189 extern void cbox_usb_midi_info_init(struct cbox_usb_midi_info *umi, struct cbox_usb_device_info *udi);
 190 extern void usbio_start_midi_capture(struct cbox_usb_io_impl *uii);
 191 extern void usbio_stop_midi_capture(struct cbox_usb_io_impl *uii);
 192 extern struct cbox_usb_midi_interface *usbio_open_midi_interface(struct cbox_usb_io_impl *uii,
 193     const struct cbox_usb_midi_info *uminf, struct libusb_device_handle *handle);
 194 extern void usbio_send_midi_to_output(struct cbox_usb_midi_output *umo);
 195 extern void usbio_fill_midi_output_buffer(struct cbox_usb_midi_output *umo);
 196
 197 extern void cbox_usb_audio_info_init(struct cbox_usb_audio_info *uai, struct cbox_usb_device_info *udi);
 198 extern void usbio_start_audio_playback(struct cbox_usb_io_impl *uii);
 199 extern void usbio_stop_audio_playback(struct cbox_usb_io_impl *uii);
 200 extern gboolean usbio_open_audio_interface(struct cbox_usb_io_impl *uii,
 201     struct cbox_usb_audio_info *uainf, struct libusb_device_handle *handle, GError **error);
 202 extern gboolean usbio_open_audio_interface_multimix(struct cbox_usb_io_impl *uii, int bus, int devadr, struct libusb_device_handle *handle, GError **error);
 203
 204 extern void usbio_play_buffer_asynchronous(struct cbox_usb_io_impl *uii);
 205 extern gboolean usbio_scan_devices(struct cbox_usb_io_impl *uii, gboolean probe_only);
 206
 207 extern void usbio_forget_device(struct cbox_usb_io_impl *uii, struct cbox_usb_device_info *devinfo);
 208 extern void usbio_run_idle_loop(struct cbox_usb_io_impl *uii);
 209
 210 #define USB_DEVICE_SETUP_TIMEOUT 2000
 211
 212 static inline gboolean configure_usb_interface(struct libusb_device_handle *handle, int bus, int devadr, int ifno, int altset, const char *purpose, GError **error)
 213 {
 214     int err = 0;
 215     if (libusb_kernel_driver_active(handle, ifno) == 1)
 216     {
 217         err = libusb_detach_kernel_driver(handle, ifno);
 218         if (err)
 219         {
 220             g_set_error(error, CBOX_MODULE_ERROR, CBOX_MODULE_ERROR_FAILED, "Cannot detach kernel driver from interface %d on device %03d:%03d: %s. Please rmmod snd-usb-audio as root.", ifno, bus, devadr, libusb_error_name(err));
 221             return FALSE;
 222         }
 223     }
 224     err = libusb_claim_interface(handle, ifno);
 225     if (err)
 226     {
 227         g_set_error(error, CBOX_MODULE_ERROR, CBOX_MODULE_ERROR_FAILED, "Cannot claim interface %d on device %03d:%03d for %s: %s", ifno, bus, devadr, purpose, libusb_error_name(err));
 228         return FALSE;
 229     }
 230     err = altset ? libusb_set_interface_alt_setting(handle, ifno, altset) : 0;
 231     if (err)
 232     {
 233         g_set_error(error, CBOX_MODULE_ERROR, CBOX_MODULE_ERROR_FAILED, "Cannot set alt-setting %d for interface %d on device %03d:%03d for %s: %s", altset, ifno, bus, devadr, purpose, libusb_error_name(err));
 234         return FALSE;
 235     }
 236     return TRUE;
 237 }
 238
 239
 240 #endif