]> sigrok.org Git - libsigrok.git/blob - hardware/fx2lafw/fx2lafw.c
fx2lafw: Say if chip is old FX2 or FX2LP
[libsigrok.git] / hardware / fx2lafw / fx2lafw.c
1 /*
2  * This file is part of the sigrok project.
3  *
4  * Copyright (C) 2010-2012 Bert Vermeulen <bert@biot.com>
5  * Copyright (C) 2012 Joel Holdsworth <joel@airwebreathe.org.uk>
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation, either version 3 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
19  */
20
21 #include <stdio.h>
22 #include <stdlib.h>
23 #include <string.h>
24 #include <inttypes.h>
25 #include <libusb.h>
26 #include "libsigrok.h"
27 #include "libsigrok-internal.h"
28 #include "fx2lafw.h"
29 #include "command.h"
30
31 static const struct fx2lafw_profile supported_fx2[] = {
32         /*
33          * CWAV USBee AX
34          * EE Electronics ESLA201A
35          * ARMFLY AX-Pro
36          */
37         { 0x08a9, 0x0014, "CWAV", "USBee AX", NULL,
38                 FIRMWARE_DIR "/fx2lafw-cwav-usbeeax.fw",
39                 0 },
40         /*
41          * CWAV USBee DX
42          * XZL-Studio DX
43          */
44         { 0x08a9, 0x0015, "CWAV", "USBee DX", NULL,
45                 FIRMWARE_DIR "/fx2lafw-cwav-usbeedx.fw",
46                 DEV_CAPS_16BIT },
47
48         /*
49          * CWAV USBee SX
50          */
51         { 0x08a9, 0x0009, "CWAV", "USBee SX", NULL,
52                 FIRMWARE_DIR "/fx2lafw-cwav-usbeesx.fw",
53                 0 },
54
55         /*
56          * Saleae Logic
57          * EE Electronics ESLA100
58          * Robomotic MiniLogic
59          * Robomotic BugLogic 3
60          */
61         { 0x0925, 0x3881, "Saleae", "Logic", NULL,
62                 FIRMWARE_DIR "/fx2lafw-saleae-logic.fw",
63                 0 },
64
65         /*
66          * Default Cypress FX2 without EEPROM, e.g.:
67          * Lcsoft Mini Board
68          * Braintechnology USB Interface V2.x
69          */
70         { 0x04B4, 0x8613, "Cypress", "FX2", NULL,
71                 FIRMWARE_DIR "/fx2lafw-cypress-fx2.fw",
72                 DEV_CAPS_16BIT },
73
74         /*
75          * Braintechnology USB-LPS
76          */
77         { 0x16d0, 0x0498, "Braintechnology", "USB-LPS", NULL,
78                 FIRMWARE_DIR "/fx2lafw-braintechnology-usb-lps.fw",
79                 DEV_CAPS_16BIT },
80
81         { 0, 0, 0, 0, 0, 0, 0 }
82 };
83
84 static const int hwcaps[] = {
85         SR_HWCAP_LOGIC_ANALYZER,
86         SR_HWCAP_SAMPLERATE,
87
88         /* These are really implemented in the driver, not the hardware. */
89         SR_HWCAP_LIMIT_SAMPLES,
90         SR_HWCAP_CONTINUOUS,
91         0,
92 };
93
94 static const char *probe_names[] = {
95         "0",  "1",  "2",  "3",  "4",  "5",  "6",  "7",
96         "8",  "9", "10", "11", "12", "13", "14", "15",
97         NULL,
98 };
99
100 static const uint64_t supported_samplerates[] = {
101         SR_KHZ(20),
102         SR_KHZ(25),
103         SR_KHZ(50),
104         SR_KHZ(100),
105         SR_KHZ(200),
106         SR_KHZ(250),
107         SR_KHZ(500),
108         SR_MHZ(1),
109         SR_MHZ(2),
110         SR_MHZ(3),
111         SR_MHZ(4),
112         SR_MHZ(6),
113         SR_MHZ(8),
114         SR_MHZ(12),
115         SR_MHZ(16),
116         SR_MHZ(24),
117         0,
118 };
119
120 static const struct sr_samplerates samplerates = {
121         0,
122         0,
123         0,
124         supported_samplerates,
125 };
126
127 SR_PRIV struct sr_dev_driver fx2lafw_driver_info;
128 static struct sr_dev_driver *di = &fx2lafw_driver_info;
129 static int hw_dev_close(struct sr_dev_inst *sdi);
130 static int hw_dev_config_set(const struct sr_dev_inst *sdi, int hwcap,
131                 const void *value);
132 static int hw_dev_acquisition_stop(struct sr_dev_inst *sdi, void *cb_data);
133
134 /**
135  * Check the USB configuration to determine if this is an fx2lafw device.
136  *
137  * @return TRUE if the device's configuration profile match fx2lafw
138  *         configuration, FALSE otherwise.
139  */
140 static gboolean check_conf_profile(libusb_device *dev)
141 {
142         struct libusb_device_descriptor des;
143         struct libusb_device_handle *hdl;
144         gboolean ret;
145         unsigned char strdesc[64];
146
147         hdl = NULL;
148         ret = FALSE;
149         while (!ret) {
150                 /* Assume the FW has not been loaded, unless proven wrong. */
151                 if (libusb_get_device_descriptor(dev, &des) != 0)
152                         break;
153
154                 if (libusb_open(dev, &hdl) != 0)
155                         break;
156
157                 if (libusb_get_string_descriptor_ascii(hdl,
158                     des.iManufacturer, strdesc, sizeof(strdesc)) < 0)
159                         break;
160                 if (strncmp((const char *)strdesc, "sigrok", 6))
161                         break;
162
163                 if (libusb_get_string_descriptor_ascii(hdl,
164                                 des.iProduct, strdesc, sizeof(strdesc)) < 0)
165                         break;
166                 if (strncmp((const char *)strdesc, "fx2lafw", 7))
167                         break;
168
169                 /* If we made it here, it must be an fx2lafw. */
170                 ret = TRUE;
171         }
172         if (hdl)
173                 libusb_close(hdl);
174
175         return ret;
176 }
177
178 static int fx2lafw_dev_open(struct sr_dev_inst *sdi)
179 {
180         libusb_device **devlist;
181         struct libusb_device_descriptor des;
182         struct dev_context *devc;
183         struct drv_context *drvc;
184         struct version_info vi;
185         int ret, skip, i, device_count;
186         uint8_t revid;
187
188         drvc = di->priv;
189         devc = sdi->priv;
190
191         if (sdi->status == SR_ST_ACTIVE)
192                 /* Device is already in use. */
193                 return SR_ERR;
194
195         skip = 0;
196         device_count = libusb_get_device_list(drvc->sr_ctx->libusb_ctx, &devlist);
197         if (device_count < 0) {
198                 sr_err("Failed to get device list: %s.",
199                        libusb_error_name(device_count));
200                 return SR_ERR;
201         }
202
203         for (i = 0; i < device_count; i++) {
204                 if ((ret = libusb_get_device_descriptor(devlist[i], &des))) {
205                         sr_err("Failed to get device descriptor: %s.",
206                                libusb_error_name(ret));
207                         continue;
208                 }
209
210                 if (des.idVendor != devc->profile->vid
211                     || des.idProduct != devc->profile->pid)
212                         continue;
213
214                 if (sdi->status == SR_ST_INITIALIZING) {
215                         if (skip != sdi->index) {
216                                 /* Skip devices of this type that aren't the one we want. */
217                                 skip += 1;
218                                 continue;
219                         }
220                 } else if (sdi->status == SR_ST_INACTIVE) {
221                         /*
222                          * This device is fully enumerated, so we need to find
223                          * this device by vendor, product, bus and address.
224                          */
225                         if (libusb_get_bus_number(devlist[i]) != devc->usb->bus
226                                 || libusb_get_device_address(devlist[i]) != devc->usb->address)
227                                 /* This is not the one. */
228                                 continue;
229                 }
230
231                 if (!(ret = libusb_open(devlist[i], &devc->usb->devhdl))) {
232                         if (devc->usb->address == 0xff)
233                                 /*
234                                  * First time we touch this device after FW
235                                  * upload, so we don't know the address yet.
236                                  */
237                                 devc->usb->address = libusb_get_device_address(devlist[i]);
238                 } else {
239                         sr_err("Failed to open device: %s.",
240                                libusb_error_name(ret));
241                         break;
242                 }
243
244                 ret = command_get_fw_version(devc->usb->devhdl, &vi);
245                 if (ret != SR_OK) {
246                         sr_err("Failed to get firmware version.");
247                         break;
248                 }
249
250                 ret = command_get_revid_version(devc->usb->devhdl, &revid);
251                 if (ret != SR_OK) {
252                         sr_err("Failed to get REVID.");
253                         break;
254                 }
255
256                 /*
257                  * Changes in major version mean incompatible/API changes, so
258                  * bail out if we encounter an incompatible version.
259                  * Different minor versions are OK, they should be compatible.
260                  */
261                 if (vi.major != FX2LAFW_REQUIRED_VERSION_MAJOR) {
262                         sr_err("Expected firmware version %d.x, "
263                                "got %d.%d.", FX2LAFW_REQUIRED_VERSION_MAJOR,
264                                vi.major, vi.minor);
265                         break;
266                 }
267
268                 sdi->status = SR_ST_ACTIVE;
269                 sr_info("Opened device %d on %d.%d, "
270                         "interface %d, firmware %d.%d.",
271                         sdi->index, devc->usb->bus, devc->usb->address,
272                         USB_INTERFACE, vi.major, vi.minor);
273
274                 sr_info("Detected REVID=%d, it's a Cypress CY7C68013%s.",
275                         revid, (revid != 1) ? " (FX2)" : "A (FX2LP)");
276
277                 break;
278         }
279         libusb_free_device_list(devlist, 1);
280
281         if (sdi->status != SR_ST_ACTIVE)
282                 return SR_ERR;
283
284         return SR_OK;
285 }
286
287 static int configure_probes(const struct sr_dev_inst *sdi)
288 {
289         struct dev_context *devc;
290         struct sr_probe *probe;
291         GSList *l;
292         int probe_bit, stage, i;
293         char *tc;
294
295         devc = sdi->priv;
296         for (i = 0; i < NUM_TRIGGER_STAGES; i++) {
297                 devc->trigger_mask[i] = 0;
298                 devc->trigger_value[i] = 0;
299         }
300
301         stage = -1;
302         for (l = sdi->probes; l; l = l->next) {
303                 probe = (struct sr_probe *)l->data;
304                 if (probe->enabled == FALSE)
305                         continue;
306
307                 if (probe->index > 7)
308                         devc->sample_wide = TRUE;
309
310                 probe_bit = 1 << (probe->index);
311                 if (!(probe->trigger))
312                         continue;
313
314                 stage = 0;
315                 for (tc = probe->trigger; *tc; tc++) {
316                         devc->trigger_mask[stage] |= probe_bit;
317                         if (*tc == '1')
318                                 devc->trigger_value[stage] |= probe_bit;
319                         stage++;
320                         if (stage > NUM_TRIGGER_STAGES)
321                                 return SR_ERR;
322                 }
323         }
324
325         if (stage == -1)
326                 /*
327                  * We didn't configure any triggers, make sure acquisition
328                  * doesn't wait for any.
329                  */
330                 devc->trigger_stage = TRIGGER_FIRED;
331         else
332                 devc->trigger_stage = 0;
333
334         return SR_OK;
335 }
336
337 static struct dev_context *fx2lafw_dev_new(void)
338 {
339         struct dev_context *devc;
340
341         if (!(devc = g_try_malloc0(sizeof(struct dev_context)))) {
342                 sr_err("Device context malloc failed.");
343                 return NULL;
344         }
345
346         devc->trigger_stage = TRIGGER_FIRED;
347
348         return devc;
349 }
350
351 static int clear_instances(void)
352 {
353         GSList *l;
354         struct sr_dev_inst *sdi;
355         struct drv_context *drvc;
356         struct dev_context *devc;
357         int ret;
358
359         drvc = di->priv;
360         ret = SR_OK;
361         for (l = drvc->instances; l; l = l->next) {
362                 if (!(sdi = l->data)) {
363                         /* Log error, but continue cleaning up the rest. */
364                         sr_err("sdi was NULL, continuing.");
365                         ret = SR_ERR_BUG;
366                         continue;
367                 }
368                 if (!(devc = sdi->priv)) {
369                         /* Log error, but continue cleaning up the rest. */
370                         sr_err("sdi->priv was NULL, continuing.");
371                         ret = SR_ERR_BUG;
372                         continue;
373                 }
374                 hw_dev_close(sdi);
375                 sr_usb_dev_inst_free(devc->usb);
376                 sdi = l->data;
377                 sr_dev_inst_free(sdi);
378         }
379
380         g_slist_free(drvc->instances);
381         drvc->instances = NULL;
382
383         return ret;
384 }
385
386 static int hw_init(struct sr_context *sr_ctx)
387 {
388         struct drv_context *drvc;
389
390         if (!(drvc = g_try_malloc0(sizeof(struct drv_context)))) {
391                 sr_err("Driver context malloc failed.");
392                 return SR_ERR_MALLOC;
393         }
394
395         drvc->sr_ctx = sr_ctx;
396         di->priv = drvc;
397
398         return SR_OK;
399 }
400
401 static GSList *hw_scan(GSList *options)
402 {
403         GSList *devices;
404         struct libusb_device_descriptor des;
405         struct sr_dev_inst *sdi;
406         const struct fx2lafw_profile *prof;
407         struct drv_context *drvc;
408         struct dev_context *devc;
409         struct sr_probe *probe;
410         libusb_device **devlist;
411         int devcnt, num_logic_probes, ret, i, j;
412
413         (void)options;
414
415         drvc = di->priv;
416
417         /* This scan always invalidates any previous scans. */
418         clear_instances();
419
420         /* Find all fx2lafw compatible devices and upload firmware to them. */
421         devices = NULL;
422         libusb_get_device_list(drvc->sr_ctx->libusb_ctx, &devlist);
423         for (i = 0; devlist[i]; i++) {
424
425                 if ((ret = libusb_get_device_descriptor(
426                      devlist[i], &des)) != 0) {
427                         sr_warn("Failed to get device descriptor: %s.",
428                                 libusb_error_name(ret));
429                         continue;
430                 }
431
432                 prof = NULL;
433                 for (j = 0; supported_fx2[j].vid; j++) {
434                         if (des.idVendor == supported_fx2[j].vid &&
435                                 des.idProduct == supported_fx2[j].pid) {
436                                 prof = &supported_fx2[j];
437                         }
438                 }
439
440                 /* Skip if the device was not found. */
441                 if (!prof)
442                         continue;
443
444                 devcnt = g_slist_length(drvc->instances);
445                 sdi = sr_dev_inst_new(devcnt, SR_ST_INITIALIZING,
446                         prof->vendor, prof->model, prof->model_version);
447                 if (!sdi)
448                         return NULL;
449                 sdi->driver = di;
450
451                 /* Fill in probelist according to this device's profile. */
452                 num_logic_probes = prof->dev_caps & DEV_CAPS_16BIT ? 16 : 8;
453                 for (j = 0; j < num_logic_probes; j++) {
454                         if (!(probe = sr_probe_new(j, SR_PROBE_LOGIC, TRUE,
455                                         probe_names[j])))
456                                 return NULL;
457                         sdi->probes = g_slist_append(sdi->probes, probe);
458                 }
459
460                 devc = fx2lafw_dev_new();
461                 devc->profile = prof;
462                 sdi->priv = devc;
463                 drvc->instances = g_slist_append(drvc->instances, sdi);
464                 devices = g_slist_append(devices, sdi);
465
466                 if (check_conf_profile(devlist[i])) {
467                         /* Already has the firmware, so fix the new address. */
468                         sr_dbg("Found an fx2lafw device.");
469                         sdi->status = SR_ST_INACTIVE;
470                         devc->usb = sr_usb_dev_inst_new
471                             (libusb_get_bus_number(devlist[i]),
472                              libusb_get_device_address(devlist[i]), NULL);
473                 } else {
474                         if (ezusb_upload_firmware(devlist[i], USB_CONFIGURATION,
475                                 prof->firmware) == SR_OK)
476                                 /* Store when this device's FW was updated. */
477                                 devc->fw_updated = g_get_monotonic_time();
478                         else
479                                 sr_err("Firmware upload failed for "
480                                        "device %d.", devcnt);
481                         devc->usb = sr_usb_dev_inst_new
482                                 (libusb_get_bus_number(devlist[i]), 0xff, NULL);
483                 }
484         }
485         libusb_free_device_list(devlist, 1);
486
487         return devices;
488 }
489
490 static GSList *hw_dev_list(void)
491 {
492         struct drv_context *drvc;
493
494         drvc = di->priv;
495
496         return drvc->instances;
497 }
498
499 static int hw_dev_open(struct sr_dev_inst *sdi)
500 {
501         struct dev_context *devc;
502         int ret;
503         int64_t timediff_us, timediff_ms;
504
505         devc = sdi->priv;
506
507         /*
508          * If the firmware was recently uploaded, wait up to MAX_RENUM_DELAY_MS
509          * milliseconds for the FX2 to renumerate.
510          */
511         ret = SR_ERR;
512         if (devc->fw_updated > 0) {
513                 sr_info("Waiting for device to reset.");
514                 /* Takes >= 300ms for the FX2 to be gone from the USB bus. */
515                 g_usleep(300 * 1000);
516                 timediff_ms = 0;
517                 while (timediff_ms < MAX_RENUM_DELAY_MS) {
518                         if ((ret = fx2lafw_dev_open(sdi)) == SR_OK)
519                                 break;
520                         g_usleep(100 * 1000);
521
522                         timediff_us = g_get_monotonic_time() - devc->fw_updated;
523                         timediff_ms = timediff_us / 1000;
524                         sr_spew("Waited %" PRIi64 "ms.", timediff_ms);
525                 }
526                 if (ret != SR_OK) {
527                         sr_err("Device failed to renumerate.");
528                         return SR_ERR;
529                 }
530                 sr_info("Device came back after %" PRIi64 "ms.", timediff_ms);
531         } else {
532                 sr_info("Firmware upload was not needed.");
533                 ret = fx2lafw_dev_open(sdi);
534         }
535
536         if (ret != SR_OK) {
537                 sr_err("Unable to open device.");
538                 return SR_ERR;
539         }
540
541         devc = sdi->priv;
542
543         ret = libusb_claim_interface(devc->usb->devhdl, USB_INTERFACE);
544         if (ret != 0) {
545                 switch(ret) {
546                 case LIBUSB_ERROR_BUSY:
547                         sr_err("Unable to claim USB interface. Another "
548                                "program or driver has already claimed it.");
549                         break;
550                 case LIBUSB_ERROR_NO_DEVICE:
551                         sr_err("Device has been disconnected.");
552                         break;
553                 default:
554                         sr_err("Unable to claim interface: %s.",
555                                libusb_error_name(ret));
556                         break;
557                 }
558
559                 return SR_ERR;
560         }
561
562         if (devc->cur_samplerate == 0) {
563                 /* Samplerate hasn't been set; default to the slowest one. */
564                 if (hw_dev_config_set(sdi, SR_HWCAP_SAMPLERATE,
565                     &supported_samplerates[0]) == SR_ERR)
566                         return SR_ERR;
567         }
568
569         return SR_OK;
570 }
571
572 static int hw_dev_close(struct sr_dev_inst *sdi)
573 {
574         struct dev_context *devc;
575
576         devc = sdi->priv;
577         if (devc->usb->devhdl == NULL)
578                 return SR_ERR;
579
580         sr_info("Closing device %d on %d.%d, interface %d.",
581                 sdi->index, devc->usb->bus, devc->usb->address, USB_INTERFACE);
582         libusb_release_interface(devc->usb->devhdl, USB_INTERFACE);
583         libusb_close(devc->usb->devhdl);
584         devc->usb->devhdl = NULL;
585         sdi->status = SR_ST_INACTIVE;
586
587         return SR_OK;
588 }
589
590 static int hw_cleanup(void)
591 {
592         struct drv_context *drvc;
593         int ret;
594
595         if (!(drvc = di->priv))
596                 return SR_OK;
597
598         ret = clear_instances();
599
600         g_free(drvc);
601         di->priv = NULL;
602
603         return ret;
604 }
605
606 static int hw_info_get(int info_id, const void **data,
607                 const struct sr_dev_inst *sdi)
608 {
609         struct dev_context *devc;
610
611         switch (info_id) {
612         case SR_DI_HWCAPS:
613                 *data = hwcaps;
614                 break;
615         case SR_DI_NUM_PROBES:
616                 if (sdi) {
617                         devc = sdi->priv;
618                         *data = GINT_TO_POINTER(
619                                 (devc->profile->dev_caps & DEV_CAPS_16BIT) ?
620                                 16 : 8);
621                 } else
622                         return SR_ERR;
623                 break;
624         case SR_DI_PROBE_NAMES:
625                 *data = probe_names;
626                 break;
627         case SR_DI_SAMPLERATES:
628                 *data = &samplerates;
629                 break;
630         case SR_DI_TRIGGER_TYPES:
631                 *data = TRIGGER_TYPES;
632                 break;
633         case SR_DI_CUR_SAMPLERATE:
634                 if (sdi) {
635                         devc = sdi->priv;
636                         *data = &devc->cur_samplerate;
637                 } else
638                         return SR_ERR;
639                 break;
640         default:
641                 return SR_ERR_ARG;
642         }
643
644         return SR_OK;
645 }
646
647 static int hw_dev_config_set(const struct sr_dev_inst *sdi, int hwcap,
648                 const void *value)
649 {
650         struct dev_context *devc;
651         int ret;
652
653         devc = sdi->priv;
654
655         if (hwcap == SR_HWCAP_SAMPLERATE) {
656                 devc->cur_samplerate = *(const uint64_t *)value;
657                 ret = SR_OK;
658         } else if (hwcap == SR_HWCAP_LIMIT_SAMPLES) {
659                 devc->limit_samples = *(const uint64_t *)value;
660                 ret = SR_OK;
661         } else {
662                 ret = SR_ERR;
663         }
664
665         return ret;
666 }
667
668 static int receive_data(int fd, int revents, void *cb_data)
669 {
670         struct timeval tv;
671         struct drv_context *drvc;
672
673         (void)fd;
674         (void)revents;
675         (void)cb_data;
676
677         drvc = di->priv;
678
679         tv.tv_sec = tv.tv_usec = 0;
680         libusb_handle_events_timeout(drvc->sr_ctx->libusb_ctx, &tv);
681
682         return TRUE;
683 }
684
685 static void abort_acquisition(struct dev_context *devc)
686 {
687         int i;
688
689         devc->num_samples = -1;
690
691         for (i = devc->num_transfers - 1; i >= 0; i--) {
692                 if (devc->transfers[i])
693                         libusb_cancel_transfer(devc->transfers[i]);
694         }
695 }
696
697 static void finish_acquisition(struct dev_context *devc)
698 {
699         struct sr_datafeed_packet packet;
700         struct drv_context *drvc = di->priv;
701         const struct libusb_pollfd **lupfd;
702         int i;
703
704         /* Terminate session. */
705         packet.type = SR_DF_END;
706         sr_session_send(devc->session_dev_id, &packet);
707
708         /* Remove fds from polling. */
709         lupfd = libusb_get_pollfds(drvc->sr_ctx->libusb_ctx);
710         for (i = 0; lupfd[i]; i++)
711                 sr_source_remove(lupfd[i]->fd);
712         free(lupfd); /* NOT g_free()! */
713
714         devc->num_transfers = 0;
715         g_free(devc->transfers);
716 }
717
718 static void free_transfer(struct libusb_transfer *transfer)
719 {
720         struct dev_context *devc;
721         unsigned int i;
722
723         devc = transfer->user_data;
724
725         g_free(transfer->buffer);
726         transfer->buffer = NULL;
727         libusb_free_transfer(transfer);
728
729         for (i = 0; i < devc->num_transfers; i++) {
730                 if (devc->transfers[i] == transfer) {
731                         devc->transfers[i] = NULL;
732                         break;
733                 }
734         }
735
736         devc->submitted_transfers--;
737         if (devc->submitted_transfers == 0)
738                 finish_acquisition(devc);
739 }
740
741 static void resubmit_transfer(struct libusb_transfer *transfer)
742 {
743         int ret;
744
745         if ((ret = libusb_submit_transfer(transfer)) == LIBUSB_SUCCESS)
746                 return;
747
748         free_transfer(transfer);
749         /* TODO: Stop session? */
750
751         sr_err("%s: %s", __func__, libusb_error_name(ret));
752 }
753
754 static void receive_transfer(struct libusb_transfer *transfer)
755 {
756         gboolean packet_has_error = FALSE;
757         struct sr_datafeed_packet packet;
758         struct sr_datafeed_logic logic;
759         struct dev_context *devc;
760         int trigger_offset, i, sample_width, cur_sample_count;
761         int trigger_offset_bytes;
762         uint8_t *cur_buf;
763
764         devc = transfer->user_data;
765
766         /*
767          * If acquisition has already ended, just free any queued up
768          * transfer that come in.
769          */
770         if (devc->num_samples == -1) {
771                 free_transfer(transfer);
772                 return;
773         }
774
775         sr_info("receive_transfer(): status %d received %d bytes.",
776                 transfer->status, transfer->actual_length);
777
778         /* Save incoming transfer before reusing the transfer struct. */
779         cur_buf = transfer->buffer;
780         sample_width = devc->sample_wide ? 2 : 1;
781         cur_sample_count = transfer->actual_length / sample_width;
782
783         switch (transfer->status) {
784         case LIBUSB_TRANSFER_NO_DEVICE:
785                 abort_acquisition(devc);
786                 free_transfer(transfer);
787                 return;
788         case LIBUSB_TRANSFER_COMPLETED:
789         case LIBUSB_TRANSFER_TIMED_OUT: /* We may have received some data though. */
790                 break;
791         default:
792                 packet_has_error = TRUE;
793                 break;
794         }
795
796         if (transfer->actual_length == 0 || packet_has_error) {
797                 devc->empty_transfer_count++;
798                 if (devc->empty_transfer_count > MAX_EMPTY_TRANSFERS) {
799                         /*
800                          * The FX2 gave up. End the acquisition, the frontend
801                          * will work out that the samplecount is short.
802                          */
803                         abort_acquisition(devc);
804                         free_transfer(transfer);
805                 } else {
806                         resubmit_transfer(transfer);
807                 }
808                 return;
809         } else {
810                 devc->empty_transfer_count = 0;
811         }
812
813         trigger_offset = 0;
814         if (devc->trigger_stage >= 0) {
815                 for (i = 0; i < cur_sample_count; i++) {
816
817                         const uint16_t cur_sample = devc->sample_wide ?
818                                 *((const uint16_t*)cur_buf + i) :
819                                 *((const uint8_t*)cur_buf + i);
820
821                         if ((cur_sample & devc->trigger_mask[devc->trigger_stage]) ==
822                                 devc->trigger_value[devc->trigger_stage]) {
823                                 /* Match on this trigger stage. */
824                                 devc->trigger_buffer[devc->trigger_stage] = cur_sample;
825                                 devc->trigger_stage++;
826
827                                 if (devc->trigger_stage == NUM_TRIGGER_STAGES ||
828                                         devc->trigger_mask[devc->trigger_stage] == 0) {
829                                         /* Match on all trigger stages, we're done. */
830                                         trigger_offset = i + 1;
831
832                                         /*
833                                          * TODO: Send pre-trigger buffer to session bus.
834                                          * Tell the frontend we hit the trigger here.
835                                          */
836                                         packet.type = SR_DF_TRIGGER;
837                                         packet.payload = NULL;
838                                         sr_session_send(devc->session_dev_id, &packet);
839
840                                         /*
841                                          * Send the samples that triggered it,
842                                          * since we're skipping past them.
843                                          */
844                                         packet.type = SR_DF_LOGIC;
845                                         packet.payload = &logic;
846                                         logic.unitsize = sizeof(*devc->trigger_buffer);
847                                         logic.length = devc->trigger_stage * logic.unitsize;
848                                         logic.data = devc->trigger_buffer;
849                                         sr_session_send(devc->session_dev_id, &packet);
850
851                                         devc->trigger_stage = TRIGGER_FIRED;
852                                         break;
853                                 }
854                         } else if (devc->trigger_stage > 0) {
855                                 /*
856                                  * We had a match before, but not in the next sample. However, we may
857                                  * have a match on this stage in the next bit -- trigger on 0001 will
858                                  * fail on seeing 00001, so we need to go back to stage 0 -- but at
859                                  * the next sample from the one that matched originally, which the
860                                  * counter increment at the end of the loop takes care of.
861                                  */
862                                 i -= devc->trigger_stage;
863                                 if (i < -1)
864                                         i = -1; /* Oops, went back past this buffer. */
865                                 /* Reset trigger stage. */
866                                 devc->trigger_stage = 0;
867                         }
868                 }
869         }
870
871         if (devc->trigger_stage == TRIGGER_FIRED) {
872                 /* Send the incoming transfer to the session bus. */
873                 trigger_offset_bytes = trigger_offset * sample_width;
874                 packet.type = SR_DF_LOGIC;
875                 packet.payload = &logic;
876                 logic.length = transfer->actual_length - trigger_offset_bytes;
877                 logic.unitsize = sample_width;
878                 logic.data = cur_buf + trigger_offset_bytes;
879                 sr_session_send(devc->session_dev_id, &packet);
880
881                 devc->num_samples += cur_sample_count;
882                 if (devc->limit_samples &&
883                         (unsigned int)devc->num_samples > devc->limit_samples) {
884                         abort_acquisition(devc);
885                         free_transfer(transfer);
886                         return;
887                 }
888         } else {
889                 /*
890                  * TODO: Buffer pre-trigger data in capture
891                  * ratio-sized buffer.
892                  */
893         }
894
895         resubmit_transfer(transfer);
896 }
897
898 static unsigned int to_bytes_per_ms(unsigned int samplerate)
899 {
900         return samplerate / 1000;
901 }
902
903 static size_t get_buffer_size(struct dev_context *devc)
904 {
905         size_t s;
906
907         /*
908          * The buffer should be large enough to hold 10ms of data and
909          * a multiple of 512.
910          */
911         s = 10 * to_bytes_per_ms(devc->cur_samplerate);
912         return (s + 511) & ~511;
913 }
914
915 static unsigned int get_number_of_transfers(struct dev_context *devc)
916 {
917         unsigned int n;
918
919         /* Total buffer size should be able to hold about 500ms of data. */
920         n = 500 * to_bytes_per_ms(devc->cur_samplerate) / get_buffer_size(devc);
921
922         if (n > NUM_SIMUL_TRANSFERS)
923                 return NUM_SIMUL_TRANSFERS;
924
925         return n;
926 }
927
928 static unsigned int get_timeout(struct dev_context *devc)
929 {
930         size_t total_size;
931         unsigned int timeout;
932
933         total_size = get_buffer_size(devc) * get_number_of_transfers(devc);
934         timeout = total_size / to_bytes_per_ms(devc->cur_samplerate);
935         return timeout + timeout / 4; /* Leave a headroom of 25% percent. */
936 }
937
938 static int hw_dev_acquisition_start(const struct sr_dev_inst *sdi,
939                 void *cb_data)
940 {
941         struct sr_datafeed_packet packet;
942         struct sr_datafeed_header header;
943         struct sr_datafeed_meta_logic meta;
944         struct dev_context *devc;
945         struct drv_context *drvc;
946         struct libusb_transfer *transfer;
947         const struct libusb_pollfd **lupfd;
948         unsigned int i, timeout, num_transfers;
949         int ret;
950         unsigned char *buf;
951         size_t size;
952
953         drvc = di->priv;
954         devc = sdi->priv;
955
956         if (devc->submitted_transfers != 0)
957                 return SR_ERR;
958
959         if (configure_probes(sdi) != SR_OK) {
960                 sr_err("Failed to configure probes.");
961                 return SR_ERR;
962         }
963
964         devc->session_dev_id = cb_data;
965         devc->num_samples = 0;
966         devc->empty_transfer_count = 0;
967
968         timeout = get_timeout(devc);
969         num_transfers = get_number_of_transfers(devc);
970         size = get_buffer_size(devc);
971
972         devc->transfers = g_try_malloc0(sizeof(*devc->transfers) * num_transfers);
973         if (!devc->transfers) {
974                 sr_err("USB transfers malloc failed.");
975                 return SR_ERR_MALLOC;
976         }
977
978         devc->num_transfers = num_transfers;
979
980         for (i = 0; i < num_transfers; i++) {
981                 if (!(buf = g_try_malloc(size))) {
982                         sr_err("USB transfer buffer malloc failed.");
983                         return SR_ERR_MALLOC;
984                 }
985                 transfer = libusb_alloc_transfer(0);
986                 libusb_fill_bulk_transfer(transfer, devc->usb->devhdl,
987                                 2 | LIBUSB_ENDPOINT_IN, buf, size,
988                                 receive_transfer, devc, timeout);
989                 if ((ret = libusb_submit_transfer(transfer)) != 0) {
990                         sr_err("Failed to submit transfer: %s.",
991                                libusb_error_name(ret));
992                         libusb_free_transfer(transfer);
993                         g_free(buf);
994                         abort_acquisition(devc);
995                         return SR_ERR;
996                 }
997                 devc->transfers[i] = transfer;
998                 devc->submitted_transfers++;
999         }
1000
1001         lupfd = libusb_get_pollfds(drvc->sr_ctx->libusb_ctx);
1002         for (i = 0; lupfd[i]; i++)
1003                 sr_source_add(lupfd[i]->fd, lupfd[i]->events,
1004                               timeout, receive_data, NULL);
1005         free(lupfd); /* NOT g_free()! */
1006
1007         packet.type = SR_DF_HEADER;
1008         packet.payload = &header;
1009         header.feed_version = 1;
1010         gettimeofday(&header.starttime, NULL);
1011         sr_session_send(cb_data, &packet);
1012
1013         /* Send metadata about the SR_DF_LOGIC packets to come. */
1014         packet.type = SR_DF_META_LOGIC;
1015         packet.payload = &meta;
1016         meta.samplerate = devc->cur_samplerate;
1017         meta.num_probes = devc->sample_wide ? 16 : 8;
1018         sr_session_send(cb_data, &packet);
1019
1020         if ((ret = command_start_acquisition(devc->usb->devhdl,
1021                 devc->cur_samplerate, devc->sample_wide)) != SR_OK) {
1022                 abort_acquisition(devc);
1023                 return ret;
1024         }
1025
1026         return SR_OK;
1027 }
1028
1029 /* TODO: This stops acquisition on ALL devices, ignoring dev_index. */
1030 static int hw_dev_acquisition_stop(struct sr_dev_inst *sdi, void *cb_data)
1031 {
1032         (void)cb_data;
1033
1034         abort_acquisition(sdi->priv);
1035
1036         return SR_OK;
1037 }
1038
1039 SR_PRIV struct sr_dev_driver fx2lafw_driver_info = {
1040         .name = "fx2lafw",
1041         .longname = "fx2lafw (generic driver for FX2 based LAs)",
1042         .api_version = 1,
1043         .init = hw_init,
1044         .cleanup = hw_cleanup,
1045         .scan = hw_scan,
1046         .dev_list = hw_dev_list,
1047         .dev_clear = clear_instances,
1048         .dev_open = hw_dev_open,
1049         .dev_close = hw_dev_close,
1050         .info_get = hw_info_get,
1051         .dev_config_set = hw_dev_config_set,
1052         .dev_acquisition_start = hw_dev_acquisition_start,
1053         .dev_acquisition_stop = hw_dev_acquisition_stop,
1054         .priv = NULL,
1055 };