2 * This file is part of the libsigrok project.
4 * Copyright (C) 2014 Daniel Elstner <daniel.kitta@gmail.com>
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #include "libsigrok.h"
22 #include "libsigrok-internal.h"
28 static const uint32_t scanopts[] = {
32 static const uint32_t devopts[] = {
33 SR_CONF_LOGIC_ANALYZER,
34 SR_CONF_LIMIT_SAMPLES | SR_CONF_GET | SR_CONF_SET,
35 SR_CONF_LIMIT_MSEC | SR_CONF_GET | SR_CONF_SET,
36 SR_CONF_SAMPLERATE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
37 SR_CONF_EXTERNAL_CLOCK | SR_CONF_GET | SR_CONF_SET,
38 SR_CONF_CLOCK_EDGE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
39 SR_CONF_TRIGGER_MATCH | SR_CONF_LIST,
40 SR_CONF_TRIGGER_SOURCE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
41 SR_CONF_TRIGGER_SLOPE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
44 static const int32_t trigger_matches[] = {
51 /* The hardware supports more samplerates than these, but these are the
52 * options hardcoded into the vendor's Windows GUI.
54 static const uint64_t samplerates[] = {
55 SR_MHZ(125), SR_MHZ(100),
56 SR_MHZ(50), SR_MHZ(20), SR_MHZ(10),
57 SR_MHZ(5), SR_MHZ(2), SR_MHZ(1),
58 SR_KHZ(500), SR_KHZ(200), SR_KHZ(100),
59 SR_KHZ(50), SR_KHZ(20), SR_KHZ(10),
60 SR_KHZ(5), SR_KHZ(2), SR_KHZ(1),
61 SR_HZ(500), SR_HZ(200), SR_HZ(100),
64 /* Names assigned to available trigger sources. Indices must match
65 * trigger_source enum values.
67 static const char *const trigger_source_names[] = { "CH", "TRG" };
69 /* Names assigned to available trigger slope choices. Indices must
70 * match the signal_edge enum values.
72 static const char *const signal_edge_names[] = { "r", "f" };
74 SR_PRIV struct sr_dev_driver sysclk_lwla_driver_info;
75 static struct sr_dev_driver *const di = &sysclk_lwla_driver_info;
77 static int init(struct sr_context *sr_ctx)
79 return std_init(sr_ctx, di, LOG_PREFIX);
82 static GSList *gen_channel_list(int num_channels)
85 struct sr_channel *ch;
91 for (i = num_channels; i > 0; --i) {
92 /* The LWLA series simply number channels from CH1 to CHxx. */
93 g_snprintf(name, sizeof(name), "CH%d", i);
95 ch = sr_channel_new(i - 1, SR_CHANNEL_LOGIC, TRUE, name);
96 list = g_slist_prepend(list, ch);
102 static struct sr_dev_inst *dev_inst_new()
104 struct sr_dev_inst *sdi;
105 struct dev_context *devc;
107 /* Allocate memory for our private driver context. */
108 devc = g_try_new0(struct dev_context, 1);
110 sr_err("Device context malloc failed.");
114 /* Register the device with libsigrok. */
115 sdi = sr_dev_inst_new(SR_ST_INACTIVE,
116 VENDOR_NAME, MODEL_NAME, NULL);
118 sr_err("Failed to instantiate device.");
123 /* Enable all channels to match the default channel configuration. */
124 devc->channel_mask = ALL_CHANNELS_MASK;
125 devc->samplerate = DEFAULT_SAMPLERATE;
128 sdi->channels = gen_channel_list(NUM_CHANNELS);
133 static GSList *scan(GSList *options)
135 GSList *usb_devices, *devices, *node;
136 struct drv_context *drvc;
137 struct sr_dev_inst *sdi;
138 struct sr_usb_dev_inst *usb;
139 struct sr_config *src;
141 char connection_id[64];
146 for (node = options; node != NULL; node = node->next) {
148 if (src->key == SR_CONF_CONN) {
149 conn = g_variant_get_string(src->data, NULL);
153 usb_devices = sr_usb_find(drvc->sr_ctx->libusb_ctx, conn);
156 for (node = usb_devices; node != NULL; node = node->next) {
159 usb_get_port_path(libusb_get_device(usb->devhdl),
160 connection_id, sizeof(connection_id));
162 /* Create sigrok device instance. */
163 sdi = dev_inst_new();
165 sr_usb_dev_inst_free(usb);
169 sdi->inst_type = SR_INST_USB;
171 sdi->connection_id = g_strdup(connection_id);
173 /* Register device instance with driver. */
174 drvc->instances = g_slist_append(drvc->instances, sdi);
175 devices = g_slist_append(devices, sdi);
178 g_slist_free(usb_devices);
183 static GSList *dev_list(void)
185 struct drv_context *drvc;
189 return drvc->instances;
192 static void clear_dev_context(void *priv)
194 struct dev_context *devc;
198 sr_dbg("Device context cleared.");
200 lwla_free_acquisition_state(devc->acquisition);
204 static int dev_clear(void)
206 return std_dev_clear(di, &clear_dev_context);
209 static int dev_open(struct sr_dev_inst *sdi)
211 struct drv_context *drvc;
212 struct sr_usb_dev_inst *usb;
218 sr_err("Driver was not initialized.");
224 ret = sr_usb_open(drvc->sr_ctx->libusb_ctx, usb);
228 ret = libusb_claim_interface(usb->devhdl, USB_INTERFACE);
230 sr_err("Failed to claim interface: %s.",
231 libusb_error_name(ret));
235 sdi->status = SR_ST_INITIALIZING;
237 ret = lwla_init_device(sdi);
240 sdi->status = SR_ST_ACTIVE;
245 static int dev_close(struct sr_dev_inst *sdi)
247 struct sr_usb_dev_inst *usb;
250 sr_err("Driver was not initialized.");
258 sdi->status = SR_ST_INACTIVE;
260 /* Trigger download of the shutdown bitstream. */
261 if (lwla_set_clock_config(sdi) != SR_OK)
262 sr_err("Unable to shut down device.");
264 libusb_release_interface(usb->devhdl, USB_INTERFACE);
265 libusb_close(usb->devhdl);
272 static int cleanup(void)
277 static int config_get(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
278 const struct sr_channel_group *cg)
280 struct dev_context *devc;
291 case SR_CONF_SAMPLERATE:
292 *data = g_variant_new_uint64(devc->samplerate);
294 case SR_CONF_LIMIT_MSEC:
295 *data = g_variant_new_uint64(devc->limit_msec);
297 case SR_CONF_LIMIT_SAMPLES:
298 *data = g_variant_new_uint64(devc->limit_samples);
300 case SR_CONF_EXTERNAL_CLOCK:
301 *data = g_variant_new_boolean(devc->cfg_clock_source
304 case SR_CONF_CLOCK_EDGE:
305 idx = devc->cfg_clock_edge;
306 if (idx >= G_N_ELEMENTS(signal_edge_names))
308 *data = g_variant_new_string(signal_edge_names[idx]);
310 case SR_CONF_TRIGGER_SOURCE:
311 idx = devc->cfg_trigger_source;
312 if (idx >= G_N_ELEMENTS(trigger_source_names))
314 *data = g_variant_new_string(trigger_source_names[idx]);
316 case SR_CONF_TRIGGER_SLOPE:
317 idx = devc->cfg_trigger_slope;
318 if (idx >= G_N_ELEMENTS(signal_edge_names))
320 *data = g_variant_new_string(signal_edge_names[idx]);
329 /* Helper for mapping a string-typed configuration value to an index
330 * within a table of possible values.
332 static int lookup_index(GVariant *value, const char *const *table, int len)
337 entry = g_variant_get_string(value, NULL);
341 /* Linear search is fine for very small tables. */
342 for (i = 0; i < len; ++i) {
343 if (strcmp(entry, table[i]) == 0)
349 static int config_set(uint32_t key, GVariant *data, const struct sr_dev_inst *sdi,
350 const struct sr_channel_group *cg)
353 struct dev_context *devc;
360 return SR_ERR_DEV_CLOSED;
363 case SR_CONF_SAMPLERATE:
364 value = g_variant_get_uint64(data);
365 if (value < samplerates[G_N_ELEMENTS(samplerates) - 1]
366 || value > samplerates[0])
367 return SR_ERR_SAMPLERATE;
368 devc->samplerate = value;
370 case SR_CONF_LIMIT_MSEC:
371 value = g_variant_get_uint64(data);
372 if (value > MAX_LIMIT_MSEC)
374 devc->limit_msec = value;
376 case SR_CONF_LIMIT_SAMPLES:
377 value = g_variant_get_uint64(data);
378 if (value > MAX_LIMIT_SAMPLES)
380 devc->limit_samples = value;
382 case SR_CONF_EXTERNAL_CLOCK:
383 devc->cfg_clock_source = (g_variant_get_boolean(data))
384 ? CLOCK_EXT_CLK : CLOCK_INTERNAL;
386 case SR_CONF_CLOCK_EDGE:
387 idx = lookup_index(data, signal_edge_names,
388 G_N_ELEMENTS(signal_edge_names));
391 devc->cfg_clock_edge = idx;
393 case SR_CONF_TRIGGER_SOURCE:
394 idx = lookup_index(data, trigger_source_names,
395 G_N_ELEMENTS(trigger_source_names));
398 devc->cfg_trigger_source = idx;
400 case SR_CONF_TRIGGER_SLOPE:
401 idx = lookup_index(data, signal_edge_names,
402 G_N_ELEMENTS(signal_edge_names));
405 devc->cfg_trigger_slope = idx;
414 static int config_channel_set(const struct sr_dev_inst *sdi,
415 struct sr_channel *ch, unsigned int changes)
417 uint64_t channel_bit;
418 struct dev_context *devc;
422 return SR_ERR_DEV_CLOSED;
424 if (ch->index < 0 || ch->index >= NUM_CHANNELS) {
425 sr_err("Channel index %d out of range.", ch->index);
428 channel_bit = (uint64_t)1 << ch->index;
430 if ((changes & SR_CHANNEL_SET_ENABLED) != 0) {
431 /* Enable or disable input channel for this channel. */
433 devc->channel_mask |= channel_bit;
435 devc->channel_mask &= ~channel_bit;
441 static int config_commit(const struct sr_dev_inst *sdi)
443 if (sdi->status != SR_ST_ACTIVE) {
444 sr_err("Device not ready (status %d).", (int)sdi->status);
448 return lwla_set_clock_config(sdi);
451 static int config_list(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
452 const struct sr_channel_group *cg)
461 case SR_CONF_SCAN_OPTIONS:
462 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
463 scanopts, ARRAY_SIZE(scanopts), sizeof(uint32_t));
465 case SR_CONF_DEVICE_OPTIONS:
466 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
467 devopts, G_N_ELEMENTS(devopts), sizeof(uint32_t));
469 case SR_CONF_SAMPLERATE:
470 g_variant_builder_init(&gvb, G_VARIANT_TYPE("a{sv}"));
471 gvar = g_variant_new_fixed_array(G_VARIANT_TYPE("t"),
472 samplerates, G_N_ELEMENTS(samplerates),
474 g_variant_builder_add(&gvb, "{sv}", "samplerates", gvar);
475 *data = g_variant_builder_end(&gvb);
477 case SR_CONF_TRIGGER_MATCH:
478 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_INT32,
479 trigger_matches, ARRAY_SIZE(trigger_matches),
482 case SR_CONF_TRIGGER_SOURCE:
483 *data = g_variant_new_strv(trigger_source_names,
484 G_N_ELEMENTS(trigger_source_names));
486 case SR_CONF_TRIGGER_SLOPE:
487 case SR_CONF_CLOCK_EDGE:
488 *data = g_variant_new_strv(signal_edge_names,
489 G_N_ELEMENTS(signal_edge_names));
498 static int dev_acquisition_start(const struct sr_dev_inst *sdi, void *cb_data)
500 struct drv_context *drvc;
501 struct dev_context *devc;
502 struct acquisition_state *acq;
507 if (sdi->status != SR_ST_ACTIVE)
508 return SR_ERR_DEV_CLOSED;
513 if (devc->acquisition) {
514 sr_err("Acquisition still in progress?");
517 acq = lwla_alloc_acquisition_state();
519 return SR_ERR_MALLOC;
521 devc->stopping_in_progress = FALSE;
522 devc->transfer_error = FALSE;
524 sr_info("Starting acquisition.");
526 devc->acquisition = acq;
527 lwla_convert_trigger(sdi);
528 ret = lwla_setup_acquisition(sdi);
530 sr_err("Failed to set up acquisition.");
531 devc->acquisition = NULL;
532 lwla_free_acquisition_state(acq);
536 ret = lwla_start_acquisition(sdi);
538 sr_err("Failed to start acquisition.");
539 devc->acquisition = NULL;
540 lwla_free_acquisition_state(acq);
543 usb_source_add(sdi->session, drvc->sr_ctx, 100, &lwla_receive_data,
544 (struct sr_dev_inst *)sdi);
546 sr_info("Waiting for data.");
548 /* Send header packet to the session bus. */
549 std_session_send_df_header(sdi, LOG_PREFIX);
554 static int dev_acquisition_stop(struct sr_dev_inst *sdi, void *cb_data)
558 if (sdi->status != SR_ST_ACTIVE)
559 return SR_ERR_DEV_CLOSED;
561 sr_dbg("Stopping acquisition.");
563 sdi->status = SR_ST_STOPPING;
568 SR_PRIV struct sr_dev_driver sysclk_lwla_driver_info = {
569 .name = "sysclk-lwla",
570 .longname = "SysClk LWLA series",
575 .dev_list = dev_list,
576 .dev_clear = dev_clear,
577 .config_get = config_get,
578 .config_set = config_set,
579 .config_channel_set = config_channel_set,
580 .config_commit = config_commit,
581 .config_list = config_list,
582 .dev_open = dev_open,
583 .dev_close = dev_close,
584 .dev_acquisition_start = dev_acquisition_start,
585 .dev_acquisition_stop = dev_acquisition_stop,