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