]> sigrok.org Git - libsigrok.git/blame - src/hardware/hantek-4032l/api.c
hantek-4032l: Implement trigger handling.
[libsigrok.git] / src / hardware / hantek-4032l / api.c
CommitLineData
6a25fa42
AZ
1/*
2 * This file is part of the libsigrok project.
3 *
5089a143
AZ
4 * Copyright (C) 2016 Andreas Zschunke <andreas.zschunke@gmx.net>
5 * Copyright (C) 2017 Andrej Valek <andy@skyrain.eu>
6 * Copyright (C) 2017 Uwe Hermann <uwe@hermann-uwe.de>
6a25fa42
AZ
7 *
8 * This program is free software: you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation, either version 3 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <http://www.gnu.org/licenses/>.
20 */
21
22#include <config.h>
23#include "protocol.h"
24
5089a143
AZ
25#define USB_INTERFACE 0
26#define NUM_CHANNELS 32
6a25fa42 27
5089a143
AZ
28static const uint32_t scanopts[] = {
29 SR_CONF_CONN,
30};
31
32static const uint32_t drvopts[] = {
33 SR_CONF_LOGIC_ANALYZER,
34};
35
36static const uint32_t devopts[] = {
37 SR_CONF_SAMPLERATE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
3dc976fe 38 SR_CONF_CAPTURE_RATIO | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
4b75f84c 39 SR_CONF_LIMIT_SAMPLES | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
5089a143
AZ
40 SR_CONF_TRIGGER_MATCH | SR_CONF_LIST,
41 SR_CONF_CONN | SR_CONF_GET,
42 SR_CONF_VOLTAGE_THRESHOLD | SR_CONF_SET | SR_CONF_LIST,
43};
44
45static const int32_t trigger_matches[] = {
46 SR_TRIGGER_ZERO,
47 SR_TRIGGER_ONE,
48 SR_TRIGGER_RISING,
49 SR_TRIGGER_FALLING,
50 SR_TRIGGER_EDGE,
51};
52
53static const uint64_t samplerates[] = {
54 SR_KHZ(1),
55 SR_KHZ(2),
56 SR_KHZ(4),
57 SR_KHZ(8),
58 SR_KHZ(16),
59 SR_HZ(31250),
60 SR_HZ(62500),
61 SR_KHZ(125),
62 SR_KHZ(250),
63 SR_KHZ(500),
64 SR_KHZ(625),
65 SR_HZ(781250),
66 SR_MHZ(1),
67 SR_KHZ(1250),
68 SR_HZ(1562500),
69 SR_MHZ(2),
70 SR_KHZ(2500),
71 SR_KHZ(3125),
72 SR_MHZ(4),
73 SR_MHZ(5),
74 SR_KHZ(6250),
75 SR_MHZ(10),
76 SR_KHZ(12500),
77 SR_MHZ(20),
78 SR_MHZ(25),
79 SR_MHZ(40),
80 SR_MHZ(50),
81 SR_MHZ(80),
82 SR_MHZ(100),
83 SR_MHZ(160),
84 SR_MHZ(200),
85 SR_MHZ(320),
86 SR_MHZ(400),
87};
88
89static const uint64_t samplerates_hw[] = {
90 SR_MHZ(100),
91 SR_MHZ(50),
92 SR_MHZ(25),
93 SR_KHZ(12500),
94 SR_KHZ(6250),
95 SR_KHZ(3125),
96 SR_HZ(1562500),
97 SR_HZ(781250),
98 SR_MHZ(80),
99 SR_MHZ(40),
100 SR_MHZ(20),
101 SR_MHZ(10),
102 SR_MHZ(5),
103 SR_KHZ(2500),
104 SR_KHZ(1250),
105 SR_KHZ(625),
106 SR_MHZ(4),
107 SR_MHZ(2),
108 SR_MHZ(1),
109 SR_KHZ(500),
110 SR_KHZ(250),
111 SR_KHZ(125),
112 SR_HZ(62500),
113 SR_HZ(31250),
114 SR_KHZ(16),
115 SR_KHZ(8),
116 SR_KHZ(4),
117 SR_KHZ(2),
118 SR_KHZ(1),
119 0,
120 0,
121 0,
122 SR_MHZ(200),
123 SR_MHZ(160),
124 SR_MHZ(400),
125 SR_MHZ(320),
126};
127
128SR_PRIV struct sr_dev_driver hantek_4032l_driver_info;
6a25fa42
AZ
129
130static GSList *scan(struct sr_dev_driver *di, GSList *options)
131{
5089a143
AZ
132 struct drv_context *drvc = di->context;
133 GSList *l, *devices, *conn_devices;
134 libusb_device **devlist;
135 struct libusb_device_descriptor des;
136 const char *conn;
137 int i;
138 char connection_id[64];
139 struct sr_channel_group *cg;
140 struct sr_dev_inst *sdi;
141 struct sr_channel *ch;
6a25fa42
AZ
142
143 devices = NULL;
5089a143 144 conn_devices = NULL;
6a25fa42 145 drvc->instances = NULL;
5089a143
AZ
146 conn = NULL;
147
148 for (l = options; l; l = l->next) {
149 struct sr_config *src = l->data;
150 if (src->key == SR_CONF_CONN) {
151 conn = g_variant_get_string(src->data, NULL);
152 break;
153 }
154 }
6a25fa42 155
5089a143
AZ
156 if (conn)
157 conn_devices = sr_usb_find(drvc->sr_ctx->libusb_ctx, conn);
158 else
159 conn_devices = NULL;
160
161 libusb_get_device_list(drvc->sr_ctx->libusb_ctx, &devlist);
162 for (i = 0; devlist[i]; i++) {
163 if (conn) {
164 struct sr_usb_dev_inst *usb = NULL;
165 for (l = conn_devices; l; l = l->next) {
166 usb = l->data;
28f2d07f
AV
167 if (usb->bus == libusb_get_bus_number(devlist[i]) &&
168 usb->address == libusb_get_device_address(devlist[i]))
5089a143
AZ
169 break;
170 }
171 if (!l)
172 /* This device matched none of the ones that
173 * matched the conn specification. */
174 continue;
175 }
176
177 libusb_get_device_descriptor(devlist[i], &des);
178
179 if (des.idVendor != H4032L_USB_VENDOR ||
180 des.idProduct != H4032L_USB_PRODUCT)
181 continue;
182
6c1a76d1
RT
183 if (usb_get_port_path(devlist[i], connection_id, sizeof(connection_id)) < 0)
184 continue;
5089a143
AZ
185
186 sdi = g_malloc0(sizeof(struct sr_dev_inst));
187 sdi->driver = &hantek_4032l_driver_info;
188 sdi->vendor = g_strdup("Hantek");
189 sdi->model = g_strdup("4032L");
190 sdi->connection_id = g_strdup(connection_id);
191
192 struct sr_channel_group *channel_groups[2];
193 for (int j = 0; j < 2; j++) {
194 cg = g_malloc0(sizeof(struct sr_channel_group));
195 cg->name = g_strdup_printf("%c", 'A' + j);
196 channel_groups[j] = cg;
197 sdi->channel_groups = g_slist_append(sdi->channel_groups, cg);
198 }
199
200 /* Assemble channel list and add channel to channel groups. */
201 for (int j = 0; j < NUM_CHANNELS; j++) {
202 char channel_name[4];
203 sprintf(channel_name, "%c%d", 'A' + (j & 1), j / 2);
204 ch = sr_channel_new(sdi, j, SR_CHANNEL_LOGIC, TRUE, channel_name);
205 cg = channel_groups[j & 1];
206 cg->channels = g_slist_append(cg->channels, ch);
207 }
208
209 struct dev_context *devc = g_malloc0(sizeof(struct dev_context));
210
211 /* Initialize command packet. */
212 devc->cmd_pkt.magic = H4032L_CMD_PKT_MAGIC;
213 devc->cmd_pkt.pwm_a = h4032l_voltage2pwm(2.5);
214 devc->cmd_pkt.pwm_b = h4032l_voltage2pwm(2.5);
215 devc->cmd_pkt.sample_size = 16384;
5089a143
AZ
216
217 devc->status = H4032L_STATUS_IDLE;
218
219 devc->capture_ratio = 5;
220
5089a143
AZ
221 sdi->priv = devc;
222 devices = g_slist_append(devices, sdi);
223
224 sdi->status = SR_ST_INACTIVE;
225 sdi->inst_type = SR_INST_USB;
226 sdi->conn = sr_usb_dev_inst_new(
227 libusb_get_bus_number(devlist[i]),
228 libusb_get_device_address(devlist[i]), NULL);
229 }
6a25fa42 230
5089a143
AZ
231 g_slist_free_full(conn_devices, (GDestroyNotify)sr_usb_dev_inst_free);
232 libusb_free_device_list(devlist, 1);
6a25fa42 233
5089a143 234 return std_scan_complete(di, devices);
6a25fa42
AZ
235}
236
237static int dev_open(struct sr_dev_inst *sdi)
238{
5089a143
AZ
239 struct sr_usb_dev_inst *usb = sdi->conn;
240 int ret;
6a25fa42 241
5089a143
AZ
242 ret = h4032l_dev_open(sdi);
243 if (ret != SR_OK) {
244 sr_err("Unable to open device.");
245 return SR_ERR;
246 }
6a25fa42 247
5089a143
AZ
248 ret = libusb_claim_interface(usb->devhdl, USB_INTERFACE);
249 if (ret != 0) {
250 switch (ret) {
251 case LIBUSB_ERROR_BUSY:
252 sr_err("Unable to claim USB interface. Another "
253 "program or driver has already claimed it.");
254 break;
255 case LIBUSB_ERROR_NO_DEVICE:
256 sr_err("Device has been disconnected.");
257 break;
258 default:
259 sr_err("Unable to claim interface: %s.",
260 libusb_error_name(ret));
261 break;
262 }
263
264 return SR_ERR;
265 }
6a25fa42 266
7a7afc00
AV
267 /* Get FPGA version. */
268 if ((ret = h4032l_get_fpga_version(sdi)) != SR_OK)
269 return ret;
270
6a25fa42
AZ
271 return SR_OK;
272}
273
274static int dev_close(struct sr_dev_inst *sdi)
275{
5089a143 276 struct sr_usb_dev_inst *usb;
6a25fa42 277
5089a143 278 usb = sdi->conn;
6a25fa42 279
5089a143
AZ
280 if (!usb->devhdl)
281 return SR_ERR_BUG;
6a25fa42 282
5089a143
AZ
283 sr_info("Closing device on %d.%d (logical) / %s (physical) interface %d.",
284 usb->bus, usb->address, sdi->connection_id, USB_INTERFACE);
285 libusb_release_interface(usb->devhdl, USB_INTERFACE);
286 libusb_close(usb->devhdl);
287 usb->devhdl = NULL;
6a25fa42
AZ
288
289 return SR_OK;
290}
291
292static int config_get(uint32_t key, GVariant **data,
293 const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
294{
5089a143
AZ
295 struct dev_context *devc = sdi->priv;
296 struct sr_usb_dev_inst *usb;
6a25fa42 297
6a25fa42
AZ
298 (void)cg;
299
6a25fa42 300 switch (key) {
5089a143
AZ
301 case SR_CONF_SAMPLERATE:
302 *data = g_variant_new_uint64(samplerates_hw[devc->cmd_pkt.sample_rate]);
303 break;
304 case SR_CONF_CAPTURE_RATIO:
305 *data = g_variant_new_uint64(devc->capture_ratio);
306 break;
307 case SR_CONF_LIMIT_SAMPLES:
308 *data = g_variant_new_uint64(devc->cmd_pkt.sample_size);
309 break;
310 case SR_CONF_CONN:
311 if (!sdi || !(usb = sdi->conn))
312 return SR_ERR_ARG;
313 *data = g_variant_new_printf("%d.%d", usb->bus, usb->address);
314 break;
6a25fa42
AZ
315 default:
316 return SR_ERR_NA;
317 }
318
5089a143 319 return SR_OK;
6a25fa42
AZ
320}
321
322static int config_set(uint32_t key, GVariant *data,
323 const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
324{
5089a143
AZ
325 struct dev_context *devc = sdi->priv;
326 struct h4032l_cmd_pkt *cmd_pkt = &devc->cmd_pkt;
6a25fa42 327
6a25fa42
AZ
328 (void)cg;
329
6a25fa42 330 switch (key) {
5089a143
AZ
331 case SR_CONF_SAMPLERATE: {
332 uint64_t sample_rate = g_variant_get_uint64(data);
333 uint8_t i = 0;
334 while (i < ARRAY_SIZE(samplerates_hw) && samplerates_hw[i] != sample_rate)
335 i++;
336
337 if (i == ARRAY_SIZE(samplerates_hw) || sample_rate == 0) {
4868f15a 338 sr_err("Invalid sample rate.");
5089a143
AZ
339 return SR_ERR_SAMPLERATE;
340 }
341 cmd_pkt->sample_rate = i;
28f2d07f 342 break;
5089a143 343 }
3dc976fe
AV
344 case SR_CONF_CAPTURE_RATIO: {
345 uint64_t capture_ratio = g_variant_get_uint64(data);
346 if (capture_ratio > 99) {
347 sr_err("Invalid capture ratio.");
348 return SR_ERR;
349 }
350 devc->capture_ratio = capture_ratio;
351 break;
352 }
5089a143
AZ
353 case SR_CONF_LIMIT_SAMPLES: {
354 uint64_t number_samples = g_variant_get_uint64(data);
355 number_samples += 511;
356 number_samples &= 0xfffffe00;
4b75f84c
AV
357 if (number_samples < H4043L_NUM_SAMPLES_MIN ||
358 number_samples > H4032L_NUM_SAMPLES_MAX) {
4868f15a
UH
359 sr_err("Invalid sample range 2k...64M: %"
360 PRIu64 ".", number_samples);
5089a143
AZ
361 return SR_ERR;
362 }
363 cmd_pkt->sample_size = number_samples;
28f2d07f 364 break;
5089a143
AZ
365 }
366 case SR_CONF_VOLTAGE_THRESHOLD: {
367 double d1, d2;
368 g_variant_get(data, "(dd)", &d1, &d2);
369 devc->cmd_pkt.pwm_a = h4032l_voltage2pwm(d1);
370 devc->cmd_pkt.pwm_b = h4032l_voltage2pwm(d2);
28f2d07f 371 break;
5089a143 372 }
28f2d07f
AV
373 default:
374 return SR_ERR_NA;
6a25fa42
AZ
375 }
376
28f2d07f 377 return SR_OK;
6a25fa42
AZ
378}
379
380static int config_list(uint32_t key, GVariant **data,
381 const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
382{
6a25fa42 383 switch (key) {
5089a143
AZ
384 case SR_CONF_SCAN_OPTIONS:
385 case SR_CONF_DEVICE_OPTIONS:
386 return STD_CONFIG_LIST(key, data, sdi, cg, scanopts, drvopts, devopts);
387 case SR_CONF_SAMPLERATE:
388 *data = std_gvar_samplerates(ARRAY_AND_SIZE(samplerates));
389 break;
390 case SR_CONF_TRIGGER_MATCH:
391 *data = std_gvar_array_i32(ARRAY_AND_SIZE(trigger_matches));
392 break;
393 case SR_CONF_VOLTAGE_THRESHOLD:
394 *data = std_gvar_tuple_double(2.5, 2.5);
395 break;
4b75f84c
AV
396 case SR_CONF_LIMIT_SAMPLES:
397 *data = std_gvar_tuple_u64(H4043L_NUM_SAMPLES_MIN, H4032L_NUM_SAMPLES_MAX);
398 break;
6a25fa42
AZ
399 default:
400 return SR_ERR_NA;
401 }
402
5089a143 403 return SR_OK;
6a25fa42
AZ
404}
405
5089a143 406static int dev_acquisition_start(const struct sr_dev_inst *sdi)
6a25fa42 407{
5089a143
AZ
408 struct sr_dev_driver *di = sdi->driver;
409 struct drv_context *drvc = di->context;
410 struct dev_context *devc = sdi->priv;
411 struct sr_trigger *trigger = sr_session_trigger_get(sdi->session);
412 struct h4032l_cmd_pkt *cmd_pkt = &devc->cmd_pkt;
413
28f2d07f 414 /* Initialize variables. */
a5b9880e 415 devc->acq_aborted = FALSE;
2958315d 416 devc->submitted_transfers = 0;
3dc976fe 417 devc->sent_samples = 0;
a5b9880e 418
5089a143
AZ
419 /* Calculate packet ratio. */
420 cmd_pkt->pre_trigger_size = (cmd_pkt->sample_size * devc->capture_ratio) / 100;
3dc976fe 421 devc->trigger_pos = cmd_pkt->pre_trigger_size;
5089a143
AZ
422
423 cmd_pkt->trig_flags.enable_trigger1 = 0;
424 cmd_pkt->trig_flags.enable_trigger2 = 0;
425 cmd_pkt->trig_flags.trigger_and_logic = 0;
426
427 if (trigger && trigger->stages) {
428 GSList *stages = trigger->stages;
429 struct sr_trigger_stage *stage1 = stages->data;
430 if (stages->next) {
4868f15a 431 sr_err("Only one trigger stage supported for now.");
5089a143
AZ
432 return SR_ERR;
433 }
434 cmd_pkt->trig_flags.enable_trigger1 = 1;
435 cmd_pkt->trigger[0].flags.edge_type = H4032L_TRIGGER_EDGE_TYPE_DISABLED;
436 cmd_pkt->trigger[0].flags.data_range_enabled = 0;
437 cmd_pkt->trigger[0].flags.time_range_enabled = 0;
438 cmd_pkt->trigger[0].flags.combined_enabled = 0;
439 cmd_pkt->trigger[0].flags.data_range_type = H4032L_TRIGGER_DATA_RANGE_TYPE_MAX;
440 cmd_pkt->trigger[0].data_range_mask = 0;
441 cmd_pkt->trigger[0].data_range_max = 0;
442
443 /* Initialize range mask values. */
444 uint32_t range_mask = 0;
445 uint32_t range_value = 0;
446
447 GSList *channel = stage1->matches;
448 while (channel) {
449 struct sr_trigger_match *match = channel->data;
450
451 switch (match->match) {
452 case SR_TRIGGER_ZERO:
453 range_mask |= (1 << match->channel->index);
454 break;
455 case SR_TRIGGER_ONE:
456 range_mask |= (1 << match->channel->index);
457 range_value |= (1 << match->channel->index);
458 break;
459 case SR_TRIGGER_RISING:
460 if (cmd_pkt->trigger[0].flags.edge_type != H4032L_TRIGGER_EDGE_TYPE_DISABLED) {
4868f15a 461 sr_err("Only one trigger signal with fall/rising/edge allowed.");
5089a143
AZ
462 return SR_ERR;
463 }
464 cmd_pkt->trigger[0].flags.edge_type = H4032L_TRIGGER_EDGE_TYPE_RISE;
465 cmd_pkt->trigger[0].flags.edge_signal = match->channel->index;
466 break;
467 case SR_TRIGGER_FALLING:
468 if (cmd_pkt->trigger[0].flags.edge_type != H4032L_TRIGGER_EDGE_TYPE_DISABLED) {
4868f15a 469 sr_err("Only one trigger signal with fall/rising/edge allowed.");
5089a143
AZ
470 return SR_ERR;
471 }
472 cmd_pkt->trigger[0].flags.edge_type = H4032L_TRIGGER_EDGE_TYPE_FALL;
473 cmd_pkt->trigger[0].flags.edge_signal = match->channel->index;
474 break;
475 case SR_TRIGGER_EDGE:
476 if (cmd_pkt->trigger[0].flags.edge_type != H4032L_TRIGGER_EDGE_TYPE_DISABLED) {
4868f15a 477 sr_err("Only one trigger signal with fall/rising/edge allowed.");
5089a143
AZ
478 return SR_ERR;
479 }
480 cmd_pkt->trigger[0].flags.edge_type = H4032L_TRIGGER_EDGE_TYPE_TOGGLE;
481 cmd_pkt->trigger[0].flags.edge_signal = match->channel->index;
482 break;
483 default:
4868f15a 484 sr_err("Unknown trigger value.");
5089a143
AZ
485 return SR_ERR;
486 }
487
488 channel = channel->next;
489 }
490
491 /* Compress range mask value and apply range settings. */
492 if (range_mask) {
493 cmd_pkt->trigger[0].flags.data_range_enabled = 1;
494 cmd_pkt->trigger[0].data_range_mask |= (range_mask);
495
496 uint32_t new_range_value = 0;
497 uint32_t bit_mask = 1;
498 while (range_mask) {
499 if ((range_mask & 1) != 0) {
500 new_range_value <<= 1;
501 if ((range_value & 1) != 0)
502 new_range_value |= bit_mask;
503 bit_mask <<= 1;
504 }
505 range_mask >>= 1;
506 range_value >>= 1;
507 }
508 cmd_pkt->trigger[0].data_range_max |= range_value;
509 }
510 }
6a25fa42 511
74c4c174 512 usb_source_add(sdi->session, drvc->sr_ctx, 1000,
5089a143 513 h4032l_receive_data, sdi->driver->context);
6a25fa42 514
5089a143
AZ
515 /* Start capturing. */
516 return h4032l_start(sdi);
6a25fa42
AZ
517}
518
5089a143 519static int dev_acquisition_stop(struct sr_dev_inst *sdi)
6a25fa42 520{
2958315d
AV
521 /* Stop capturing. */
522 return h4032l_stop(sdi);
6a25fa42
AZ
523}
524
525SR_PRIV struct sr_dev_driver hantek_4032l_driver_info = {
526 .name = "hantek-4032l",
5089a143 527 .longname = "Hantek 4032L",
6a25fa42 528 .api_version = 1,
5089a143
AZ
529 .init = std_init,
530 .cleanup = std_cleanup,
6a25fa42 531 .scan = scan,
5089a143
AZ
532 .dev_list = std_dev_list,
533 .dev_clear = std_dev_clear,
6a25fa42
AZ
534 .config_get = config_get,
535 .config_set = config_set,
536 .config_list = config_list,
537 .dev_open = dev_open,
538 .dev_close = dev_close,
539 .dev_acquisition_start = dev_acquisition_start,
540 .dev_acquisition_stop = dev_acquisition_stop,
541 .context = NULL,
542};
5089a143 543SR_REGISTER_DEV_DRIVER(hantek_4032l_driver_info);