2 * This file is part of the libsigrok project.
4 * Copyright (C) 2012 Martin Ling <martin-git@earth.li>
5 * Copyright (C) 2013 Bert Vermeulen <bert@biot.com>
6 * Copyright (C) 2013 Mathias Grimmberger <mgri@zaphod.sax.de>
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.
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.
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/>.
30 #include <libsigrok/libsigrok.h>
31 #include "libsigrok-internal.h"
35 static const uint32_t scanopts[] = {
40 static const uint32_t drvopts[] = {
44 static const uint32_t devopts[] = {
45 SR_CONF_LIMIT_FRAMES | SR_CONF_SET,
46 SR_CONF_SAMPLERATE | SR_CONF_GET,
47 SR_CONF_TIMEBASE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
48 SR_CONF_NUM_HDIV | SR_CONF_GET,
49 SR_CONF_HORIZ_TRIGGERPOS | SR_CONF_SET,
50 SR_CONF_TRIGGER_SOURCE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
51 SR_CONF_TRIGGER_SLOPE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
52 SR_CONF_TRIGGER_LEVEL | SR_CONF_GET | SR_CONF_SET,
53 SR_CONF_DATA_SOURCE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
56 static const uint32_t analog_devopts[] = {
57 SR_CONF_NUM_VDIV | SR_CONF_GET,
58 SR_CONF_VDIV | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
59 SR_CONF_COUPLING | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
60 SR_CONF_PROBE_FACTOR | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
63 static const uint64_t timebases[][2] = {
106 static const uint64_t vdivs[][2] = {
129 #define NUM_TIMEBASE ARRAY_SIZE(timebases)
130 #define NUM_VDIV ARRAY_SIZE(vdivs)
132 static const char *trigger_sources[] = {
157 static const char *trigger_slopes[] = {
162 static const char *coupling[] = {
168 static const uint64_t probe_factor[] = {
181 /* Do not change the order of entries */
182 static const char *data_sources[] = {
202 /* short name, full name */
203 static const struct rigol_ds_vendor supported_vendors[] = {
204 [RIGOL] = {"Rigol", "Rigol Technologies"},
205 [AGILENT] = {"Agilent", "Agilent Technologies"},
208 #define VENDOR(x) &supported_vendors[x]
209 /* vendor, series, protocol, max timebase, min vdiv, number of horizontal divs,
210 * live waveform samples, memory buffer samples */
211 static const struct rigol_ds_series supported_series[] = {
212 [VS5000] = {VENDOR(RIGOL), "VS5000", PROTOCOL_V1, FORMAT_RAW,
213 {50, 1}, {2, 1000}, 14, 2048, 0},
214 [DS1000] = {VENDOR(RIGOL), "DS1000", PROTOCOL_V2, FORMAT_IEEE488_2,
215 {50, 1}, {2, 1000}, 12, 600, 1048576},
216 [DS2000] = {VENDOR(RIGOL), "DS2000", PROTOCOL_V3, FORMAT_IEEE488_2,
217 {500, 1}, {500, 1000000}, 14, 1400, 14000},
218 [DS2000A] = {VENDOR(RIGOL), "DS2000A", PROTOCOL_V3, FORMAT_IEEE488_2,
219 {1000, 1}, {500, 1000000}, 14, 1400, 14000},
220 [DSO1000] = {VENDOR(AGILENT), "DSO1000", PROTOCOL_V3, FORMAT_IEEE488_2,
221 {50, 1}, {2, 1000}, 12, 600, 20480},
222 [DS1000Z] = {VENDOR(RIGOL), "DS1000Z", PROTOCOL_V4, FORMAT_IEEE488_2,
223 {50, 1}, {1, 1000}, 12, 1200, 12000000},
226 #define SERIES(x) &supported_series[x]
227 /* series, model, min timebase, analog channels, digital */
228 static const struct rigol_ds_model supported_models[] = {
229 {SERIES(VS5000), "VS5022", {20, 1000000000}, 2, false},
230 {SERIES(VS5000), "VS5042", {10, 1000000000}, 2, false},
231 {SERIES(VS5000), "VS5062", {5, 1000000000}, 2, false},
232 {SERIES(VS5000), "VS5102", {2, 1000000000}, 2, false},
233 {SERIES(VS5000), "VS5202", {2, 1000000000}, 2, false},
234 {SERIES(VS5000), "VS5022D", {20, 1000000000}, 2, true},
235 {SERIES(VS5000), "VS5042D", {10, 1000000000}, 2, true},
236 {SERIES(VS5000), "VS5062D", {5, 1000000000}, 2, true},
237 {SERIES(VS5000), "VS5102D", {2, 1000000000}, 2, true},
238 {SERIES(VS5000), "VS5202D", {2, 1000000000}, 2, true},
239 {SERIES(DS1000), "DS1052E", {5, 1000000000}, 2, false},
240 {SERIES(DS1000), "DS1102E", {2, 1000000000}, 2, false},
241 {SERIES(DS1000), "DS1152E", {2, 1000000000}, 2, false},
242 {SERIES(DS1000), "DS1052D", {5, 1000000000}, 2, true},
243 {SERIES(DS1000), "DS1102D", {2, 1000000000}, 2, true},
244 {SERIES(DS1000), "DS1152D", {2, 1000000000}, 2, true},
245 {SERIES(DS2000), "DS2072", {5, 1000000000}, 2, false},
246 {SERIES(DS2000), "DS2102", {5, 1000000000}, 2, false},
247 {SERIES(DS2000), "DS2202", {2, 1000000000}, 2, false},
248 {SERIES(DS2000), "DS2302", {1, 1000000000}, 2, false},
249 {SERIES(DS2000A), "DS2072A", {5, 1000000000}, 2, false},
250 {SERIES(DS2000A), "DS2102A", {5, 1000000000}, 2, false},
251 {SERIES(DS2000A), "DS2202A", {2, 1000000000}, 2, false},
252 {SERIES(DS2000A), "DS2302A", {1, 1000000000}, 2, false},
253 {SERIES(DS2000A), "MSO2072A", {5, 1000000000}, 2, true},
254 {SERIES(DS2000A), "MSO2102A", {5, 1000000000}, 2, true},
255 {SERIES(DS2000A), "MSO2202A", {2, 1000000000}, 2, true},
256 {SERIES(DS2000A), "MSO2302A", {1, 1000000000}, 2, true},
257 {SERIES(DSO1000), "DSO1002A", {5, 1000000000}, 2, false},
258 {SERIES(DSO1000), "DSO1004A", {5, 1000000000}, 4, false},
259 {SERIES(DSO1000), "DSO1012A", {2, 1000000000}, 2, false},
260 {SERIES(DSO1000), "DSO1014A", {2, 1000000000}, 4, false},
261 {SERIES(DSO1000), "DSO1022A", {2, 1000000000}, 2, false},
262 {SERIES(DSO1000), "DSO1024A", {2, 1000000000}, 4, false},
263 {SERIES(DS1000Z), "DS1054Z", {5, 1000000000}, 4, false},
264 {SERIES(DS1000Z), "DS1074Z", {5, 1000000000}, 4, false},
265 {SERIES(DS1000Z), "DS1104Z", {5, 1000000000}, 4, false},
266 {SERIES(DS1000Z), "DS1074Z-S", {5, 1000000000}, 4, false},
267 {SERIES(DS1000Z), "DS1104Z-S", {5, 1000000000}, 4, false},
268 {SERIES(DS1000Z), "DS1074Z Plus", {5, 1000000000}, 4, false},
269 {SERIES(DS1000Z), "DS1104Z Plus", {5, 1000000000}, 4, false},
270 {SERIES(DS1000Z), "MSO1074Z", {5, 1000000000}, 4, true},
271 {SERIES(DS1000Z), "MSO1104Z", {5, 1000000000}, 4, true},
272 {SERIES(DS1000Z), "MSO1074Z-S", {5, 1000000000}, 4, true},
273 {SERIES(DS1000Z), "MSO1104Z-S", {5, 1000000000}, 4, true},
276 static struct sr_dev_driver rigol_ds_driver_info;
278 static void clear_helper(void *priv)
280 struct dev_context *devc;
285 g_free(devc->buffer);
286 for (i = 0; i < ARRAY_SIZE(devc->coupling); i++)
287 g_free(devc->coupling[i]);
288 g_free(devc->trigger_source);
289 g_free(devc->trigger_slope);
290 g_free(devc->analog_groups);
294 static int dev_clear(const struct sr_dev_driver *di)
296 return std_dev_clear(di, clear_helper);
299 static struct sr_dev_inst *probe_device(struct sr_scpi_dev_inst *scpi)
301 struct dev_context *devc;
302 struct sr_dev_inst *sdi;
303 struct sr_scpi_hw_info *hw_info;
304 struct sr_channel *ch;
307 const struct rigol_ds_model *model = NULL;
308 gchar *channel_name, **version;
310 if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK) {
311 sr_info("Couldn't get IDN response, retrying.");
314 if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK) {
315 sr_info("Couldn't get IDN response.");
320 for (i = 0; i < ARRAY_SIZE(supported_models); i++) {
321 if (!g_ascii_strcasecmp(hw_info->manufacturer,
322 supported_models[i].series->vendor->full_name) &&
323 !strcmp(hw_info->model, supported_models[i].name)) {
324 model = &supported_models[i];
330 sr_scpi_hw_info_free(hw_info);
334 sdi = g_malloc0(sizeof(struct sr_dev_inst));
335 sdi->vendor = g_strdup(model->series->vendor->name);
336 sdi->model = g_strdup(model->name);
337 sdi->version = g_strdup(hw_info->firmware_version);
339 sdi->driver = &rigol_ds_driver_info;
340 sdi->inst_type = SR_INST_SCPI;
341 sdi->serial_num = g_strdup(hw_info->serial_number);
342 devc = g_malloc0(sizeof(struct dev_context));
343 devc->limit_frames = 0;
345 devc->format = model->series->format;
347 /* DS1000 models with firmware before 0.2.4 used the old data format. */
348 if (model->series == SERIES(DS1000)) {
349 version = g_strsplit(hw_info->firmware_version, ".", 0);
351 if (!version[0] || !version[1] || !version[2])
353 if (version[0][0] == 0 || version[1][0] == 0 || version[2][0] == 0)
355 for (i = 0; i < 3; i++) {
356 if (sr_atol(version[i], &n[i]) != SR_OK)
361 scpi->firmware_version = n[0] * 100 + n[1] * 10 + n[2];
362 if (scpi->firmware_version < 24) {
363 sr_dbg("Found DS1000 firmware < 0.2.4, using raw data format.");
364 devc->format = FORMAT_RAW;
371 sr_scpi_hw_info_free(hw_info);
373 devc->analog_groups = g_malloc0(sizeof(struct sr_channel_group*) *
374 model->analog_channels);
376 for (i = 0; i < model->analog_channels; i++) {
377 channel_name = g_strdup_printf("CH%d", i + 1);
378 ch = sr_channel_new(sdi, i, SR_CHANNEL_ANALOG, TRUE, channel_name);
380 devc->analog_groups[i] = g_malloc0(sizeof(struct sr_channel_group));
382 devc->analog_groups[i]->name = channel_name;
383 devc->analog_groups[i]->channels = g_slist_append(NULL, ch);
384 sdi->channel_groups = g_slist_append(sdi->channel_groups,
385 devc->analog_groups[i]);
388 if (devc->model->has_digital) {
389 devc->digital_group = g_malloc0(sizeof(struct sr_channel_group));
391 for (i = 0; i < ARRAY_SIZE(devc->digital_channels); i++) {
392 channel_name = g_strdup_printf("D%d", i);
393 ch = sr_channel_new(sdi, i, SR_CHANNEL_LOGIC, TRUE, channel_name);
394 g_free(channel_name);
395 devc->digital_group->channels = g_slist_append(
396 devc->digital_group->channels, ch);
398 devc->digital_group->name = g_strdup("LA");
399 sdi->channel_groups = g_slist_append(sdi->channel_groups,
400 devc->digital_group);
403 for (i = 0; i < NUM_TIMEBASE; i++) {
404 if (!memcmp(&devc->model->min_timebase, &timebases[i], sizeof(uint64_t[2])))
405 devc->timebases = &timebases[i];
406 if (!memcmp(&devc->model->series->max_timebase, &timebases[i], sizeof(uint64_t[2])))
407 devc->num_timebases = &timebases[i] - devc->timebases + 1;
410 for (i = 0; i < NUM_VDIV; i++) {
411 if (!memcmp(&devc->model->series->min_vdiv,
412 &vdivs[i], sizeof(uint64_t[2]))) {
413 devc->vdivs = &vdivs[i];
414 devc->num_vdivs = NUM_VDIV - i;
418 devc->buffer = g_malloc(ACQ_BUFFER_SIZE);
419 devc->data = g_malloc(ACQ_BUFFER_SIZE * sizeof(float));
421 devc->data_source = DATA_SOURCE_LIVE;
428 static GSList *scan(struct sr_dev_driver *di, GSList *options)
430 return sr_scpi_scan(di->context, options, probe_device);
433 static int dev_open(struct sr_dev_inst *sdi)
436 struct sr_scpi_dev_inst *scpi = sdi->conn;
438 if ((ret = sr_scpi_open(scpi)) < 0) {
439 sr_err("Failed to open SCPI device: %s.", sr_strerror(ret));
443 if ((ret = rigol_ds_get_dev_cfg(sdi)) < 0) {
444 sr_err("Failed to get device config: %s.", sr_strerror(ret));
448 sdi->status = SR_ST_ACTIVE;
453 static int dev_close(struct sr_dev_inst *sdi)
455 struct sr_scpi_dev_inst *scpi;
456 struct dev_context *devc;
458 if (sdi->status != SR_ST_ACTIVE)
459 return SR_ERR_DEV_CLOSED;
464 if (devc->model->series->protocol == PROTOCOL_V2)
465 rigol_ds_config_set(sdi, ":KEY:LOCK DISABLE");
468 if (sr_scpi_close(scpi) < 0)
470 sdi->status = SR_ST_INACTIVE;
476 static int analog_frame_size(const struct sr_dev_inst *sdi)
478 struct dev_context *devc = sdi->priv;
479 struct sr_channel *ch;
480 int analog_channels = 0;
483 for (l = sdi->channels; l; l = l->next) {
485 if (ch->type == SR_CHANNEL_ANALOG && ch->enabled)
489 if (analog_channels == 0)
492 switch (devc->data_source) {
493 case DATA_SOURCE_LIVE:
494 return devc->model->series->live_samples;
495 case DATA_SOURCE_MEMORY:
496 return devc->model->series->buffer_samples / analog_channels;
502 static int digital_frame_size(const struct sr_dev_inst *sdi)
504 struct dev_context *devc = sdi->priv;
506 switch (devc->data_source) {
507 case DATA_SOURCE_LIVE:
508 return devc->model->series->live_samples * 2;
509 case DATA_SOURCE_MEMORY:
510 return devc->model->series->buffer_samples * 2;
516 static int config_get(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
517 const struct sr_channel_group *cg)
519 struct dev_context *devc;
520 struct sr_channel *ch;
523 int analog_channel = -1;
524 float smallest_diff = INFINITY;
533 /* If a channel group is specified, it must be a valid one. */
534 if (cg && !g_slist_find(sdi->channel_groups, cg)) {
535 sr_err("Invalid channel group specified.");
540 ch = g_slist_nth_data(cg->channels, 0);
543 if (ch->type == SR_CHANNEL_ANALOG) {
544 if (ch->name[2] < '1' || ch->name[2] > '4')
546 analog_channel = ch->name[2] - '1';
551 case SR_CONF_NUM_HDIV:
552 *data = g_variant_new_int32(devc->model->series->num_horizontal_divs);
554 case SR_CONF_NUM_VDIV:
555 *data = g_variant_new_int32(devc->num_vdivs);
557 case SR_CONF_DATA_SOURCE:
558 if (devc->data_source == DATA_SOURCE_LIVE)
559 *data = g_variant_new_string("Live");
560 else if (devc->data_source == DATA_SOURCE_MEMORY)
561 *data = g_variant_new_string("Memory");
563 *data = g_variant_new_string("Segmented");
565 case SR_CONF_SAMPLERATE:
566 if (devc->data_source == DATA_SOURCE_LIVE) {
567 samplerate = analog_frame_size(sdi) /
568 (devc->timebase * devc->model->series->num_horizontal_divs);
569 *data = g_variant_new_uint64(samplerate);
571 sr_dbg("Unknown data source: %d.", devc->data_source);
575 case SR_CONF_TRIGGER_SOURCE:
576 if (!strcmp(devc->trigger_source, "ACL"))
578 else if (!strcmp(devc->trigger_source, "CHAN1"))
580 else if (!strcmp(devc->trigger_source, "CHAN2"))
582 else if (!strcmp(devc->trigger_source, "CHAN3"))
584 else if (!strcmp(devc->trigger_source, "CHAN4"))
587 tmp_str = devc->trigger_source;
588 *data = g_variant_new_string(tmp_str);
590 case SR_CONF_TRIGGER_SLOPE:
591 if (!strncmp(devc->trigger_slope, "POS", 3)) {
593 } else if (!strncmp(devc->trigger_slope, "NEG", 3)) {
596 sr_dbg("Unknown trigger slope: '%s'.", devc->trigger_slope);
599 *data = g_variant_new_string(tmp_str);
601 case SR_CONF_TRIGGER_LEVEL:
602 *data = g_variant_new_double(devc->trigger_level);
604 case SR_CONF_TIMEBASE:
605 for (i = 0; i < devc->num_timebases; i++) {
606 float tb = (float)devc->timebases[i][0] / devc->timebases[i][1];
607 float diff = fabs(devc->timebase - tb);
608 if (diff < smallest_diff) {
609 smallest_diff = diff;
614 sr_dbg("Negative timebase index: %d.", idx);
617 *data = g_variant_new("(tt)", devc->timebases[idx][0],
618 devc->timebases[idx][1]);
621 if (analog_channel < 0) {
622 sr_dbg("Negative analog channel: %d.", analog_channel);
625 for (i = 0; i < ARRAY_SIZE(vdivs); i++) {
626 float vdiv = (float)vdivs[i][0] / vdivs[i][1];
627 float diff = fabs(devc->vdiv[analog_channel] - vdiv);
628 if (diff < smallest_diff) {
629 smallest_diff = diff;
634 sr_dbg("Negative vdiv index: %d.", idx);
637 *data = g_variant_new("(tt)", vdivs[idx][0], vdivs[idx][1]);
639 case SR_CONF_COUPLING:
640 if (analog_channel < 0) {
641 sr_dbg("Negative analog channel: %d.", analog_channel);
644 *data = g_variant_new_string(devc->coupling[analog_channel]);
646 case SR_CONF_PROBE_FACTOR:
647 if (analog_channel < 0) {
648 sr_dbg("Negative analog channel: %d.", analog_channel);
651 *data = g_variant_new_uint64(devc->attenuation[analog_channel]);
660 static int config_set(uint32_t key, GVariant *data, const struct sr_dev_inst *sdi,
661 const struct sr_channel_group *cg)
663 struct dev_context *devc;
673 /* If a channel group is specified, it must be a valid one. */
674 if (cg && !g_slist_find(sdi->channel_groups, cg)) {
675 sr_err("Invalid channel group specified.");
681 case SR_CONF_LIMIT_FRAMES:
682 devc->limit_frames = g_variant_get_uint64(data);
684 case SR_CONF_TRIGGER_SLOPE:
685 tmp_str = g_variant_get_string(data, NULL);
687 if (!tmp_str || !(tmp_str[0] == 'f' || tmp_str[0] == 'r')) {
688 sr_err("Unknown trigger slope: '%s'.",
689 (tmp_str) ? tmp_str : "NULL");
693 g_free(devc->trigger_slope);
694 devc->trigger_slope = g_strdup((tmp_str[0] == 'r') ? "POS" : "NEG");
695 ret = rigol_ds_config_set(sdi, ":TRIG:EDGE:SLOP %s", devc->trigger_slope);
697 case SR_CONF_HORIZ_TRIGGERPOS:
698 t_dbl = g_variant_get_double(data);
699 if (t_dbl < 0.0 || t_dbl > 1.0) {
700 sr_err("Invalid horiz. trigger position: %g.", t_dbl);
703 devc->horiz_triggerpos = t_dbl;
704 /* We have the trigger offset as a percentage of the frame, but
705 * need to express this in seconds. */
706 t_dbl = -(devc->horiz_triggerpos - 0.5) * devc->timebase * devc->num_timebases;
707 g_ascii_formatd(buffer, sizeof(buffer), "%.6f", t_dbl);
708 ret = rigol_ds_config_set(sdi, ":TIM:OFFS %s", buffer);
710 case SR_CONF_TRIGGER_LEVEL:
711 t_dbl = g_variant_get_double(data);
712 g_ascii_formatd(buffer, sizeof(buffer), "%.3f", t_dbl);
713 ret = rigol_ds_config_set(sdi, ":TRIG:EDGE:LEV %s", buffer);
715 devc->trigger_level = t_dbl;
717 case SR_CONF_TIMEBASE:
718 g_variant_get(data, "(tt)", &p, &q);
719 for (i = 0; i < devc->num_timebases; i++) {
720 if (devc->timebases[i][0] == p && devc->timebases[i][1] == q) {
721 devc->timebase = (float)p / q;
722 g_ascii_formatd(buffer, sizeof(buffer), "%.9f",
724 ret = rigol_ds_config_set(sdi, ":TIM:SCAL %s", buffer);
728 if (i == devc->num_timebases) {
729 sr_err("Invalid timebase index: %d.", i);
733 case SR_CONF_TRIGGER_SOURCE:
734 tmp_str = g_variant_get_string(data, NULL);
735 for (i = 0; i < ARRAY_SIZE(trigger_sources); i++) {
736 if (!strcmp(trigger_sources[i], tmp_str)) {
737 g_free(devc->trigger_source);
738 devc->trigger_source = g_strdup(trigger_sources[i]);
739 if (!strcmp(devc->trigger_source, "AC Line"))
741 else if (!strcmp(devc->trigger_source, "CH1"))
743 else if (!strcmp(devc->trigger_source, "CH2"))
745 else if (!strcmp(devc->trigger_source, "CH3"))
747 else if (!strcmp(devc->trigger_source, "CH4"))
750 tmp_str = (char *)devc->trigger_source;
751 ret = rigol_ds_config_set(sdi, ":TRIG:EDGE:SOUR %s", tmp_str);
755 if (i == ARRAY_SIZE(trigger_sources)) {
756 sr_err("Invalid trigger source index: %d.", i);
762 sr_err("No channel group specified.");
763 return SR_ERR_CHANNEL_GROUP;
765 g_variant_get(data, "(tt)", &p, &q);
766 for (i = 0; i < devc->model->analog_channels; i++) {
767 if (cg == devc->analog_groups[i]) {
768 for (j = 0; j < ARRAY_SIZE(vdivs); j++) {
769 if (vdivs[j][0] != p || vdivs[j][1] != q)
771 devc->vdiv[i] = (float)p / q;
772 g_ascii_formatd(buffer, sizeof(buffer), "%.3f",
774 return rigol_ds_config_set(sdi, ":CHAN%d:SCAL %s", i + 1,
777 sr_err("Invalid vdiv index: %d.", j);
781 sr_dbg("Didn't set vdiv, unknown channel(group).");
783 case SR_CONF_COUPLING:
785 sr_err("No channel group specified.");
786 return SR_ERR_CHANNEL_GROUP;
788 tmp_str = g_variant_get_string(data, NULL);
789 for (i = 0; i < devc->model->analog_channels; i++) {
790 if (cg == devc->analog_groups[i]) {
791 for (j = 0; j < ARRAY_SIZE(coupling); j++) {
792 if (!strcmp(tmp_str, coupling[j])) {
793 g_free(devc->coupling[i]);
794 devc->coupling[i] = g_strdup(coupling[j]);
795 return rigol_ds_config_set(sdi, ":CHAN%d:COUP %s", i + 1,
799 sr_err("Invalid coupling index: %d.", j);
803 sr_dbg("Didn't set coupling, unknown channel(group).");
805 case SR_CONF_PROBE_FACTOR:
807 sr_err("No channel group specified.");
808 return SR_ERR_CHANNEL_GROUP;
810 p = g_variant_get_uint64(data);
811 for (i = 0; i < devc->model->analog_channels; i++) {
812 if (cg == devc->analog_groups[i]) {
813 for (j = 0; j < ARRAY_SIZE(probe_factor); j++) {
814 if (p == probe_factor[j]) {
815 devc->attenuation[i] = p;
816 ret = rigol_ds_config_set(sdi, ":CHAN%d:PROB %"PRIu64,
819 rigol_ds_get_dev_cfg_vertical(sdi);
823 sr_err("Invalid probe factor: %"PRIu64".", p);
827 sr_dbg("Didn't set probe factor, unknown channel(group).");
829 case SR_CONF_DATA_SOURCE:
830 tmp_str = g_variant_get_string(data, NULL);
831 if (!strcmp(tmp_str, "Live"))
832 devc->data_source = DATA_SOURCE_LIVE;
833 else if (devc->model->series->protocol >= PROTOCOL_V2
834 && !strcmp(tmp_str, "Memory"))
835 devc->data_source = DATA_SOURCE_MEMORY;
836 else if (devc->model->series->protocol >= PROTOCOL_V3
837 && !strcmp(tmp_str, "Segmented"))
838 devc->data_source = DATA_SOURCE_SEGMENTED;
840 sr_err("Unknown data source: '%s'.", tmp_str);
851 static int config_list(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
852 const struct sr_channel_group *cg)
854 GVariant *tuple, *rational[2];
857 struct dev_context *devc = NULL;
859 /* SR_CONF_SCAN_OPTIONS is always valid, regardless of sdi or channel group. */
860 if (key == SR_CONF_SCAN_OPTIONS) {
861 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
862 scanopts, ARRAY_SIZE(scanopts), sizeof(uint32_t));
866 /* If sdi is NULL, nothing except SR_CONF_DEVICE_OPTIONS can be provided. */
867 if (key == SR_CONF_DEVICE_OPTIONS && !sdi) {
868 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
869 drvopts, ARRAY_SIZE(drvopts), sizeof(uint32_t));
873 /* Every other option requires a valid device instance. */
878 /* If a channel group is specified, it must be a valid one. */
879 if (cg && !g_slist_find(sdi->channel_groups, cg)) {
880 sr_err("Invalid channel group specified.");
885 case SR_CONF_DEVICE_OPTIONS:
887 /* If cg is NULL, only the SR_CONF_DEVICE_OPTIONS that are not
888 * specific to a channel group must be returned. */
889 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
890 devopts, ARRAY_SIZE(devopts), sizeof(uint32_t));
893 if (cg == devc->digital_group) {
894 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
895 NULL, 0, sizeof(uint32_t));
898 for (i = 0; i < devc->model->analog_channels; i++) {
899 if (cg == devc->analog_groups[i]) {
900 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
901 analog_devopts, ARRAY_SIZE(analog_devopts), sizeof(uint32_t));
908 case SR_CONF_COUPLING:
910 sr_err("No channel group specified.");
911 return SR_ERR_CHANNEL_GROUP;
913 *data = g_variant_new_strv(coupling, ARRAY_SIZE(coupling));
915 case SR_CONF_PROBE_FACTOR:
917 sr_err("No channel group specified.");
918 return SR_ERR_CHANNEL_GROUP;
920 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT64,
921 probe_factor, ARRAY_SIZE(probe_factor), sizeof(uint64_t));
925 /* Can't know this until we have the exact model. */
928 sr_err("No channel group specified.");
929 return SR_ERR_CHANNEL_GROUP;
931 g_variant_builder_init(&gvb, G_VARIANT_TYPE_ARRAY);
932 for (i = 0; i < devc->num_vdivs; i++) {
933 rational[0] = g_variant_new_uint64(devc->vdivs[i][0]);
934 rational[1] = g_variant_new_uint64(devc->vdivs[i][1]);
935 tuple = g_variant_new_tuple(rational, 2);
936 g_variant_builder_add_value(&gvb, tuple);
938 *data = g_variant_builder_end(&gvb);
940 case SR_CONF_TIMEBASE:
942 /* Can't know this until we have the exact model. */
944 if (devc->num_timebases <= 0)
946 g_variant_builder_init(&gvb, G_VARIANT_TYPE_ARRAY);
947 for (i = 0; i < devc->num_timebases; i++) {
948 rational[0] = g_variant_new_uint64(devc->timebases[i][0]);
949 rational[1] = g_variant_new_uint64(devc->timebases[i][1]);
950 tuple = g_variant_new_tuple(rational, 2);
951 g_variant_builder_add_value(&gvb, tuple);
953 *data = g_variant_builder_end(&gvb);
955 case SR_CONF_TRIGGER_SOURCE:
957 /* Can't know this until we have the exact model. */
959 *data = g_variant_new_strv(trigger_sources,
960 devc->model->has_digital ? ARRAY_SIZE(trigger_sources) : 4);
962 case SR_CONF_TRIGGER_SLOPE:
963 *data = g_variant_new_strv(trigger_slopes, ARRAY_SIZE(trigger_slopes));
965 case SR_CONF_DATA_SOURCE:
967 /* Can't know this until we have the exact model. */
969 switch (devc->model->series->protocol) {
971 *data = g_variant_new_strv(data_sources, ARRAY_SIZE(data_sources) - 2);
974 *data = g_variant_new_strv(data_sources, ARRAY_SIZE(data_sources) - 1);
977 *data = g_variant_new_strv(data_sources, ARRAY_SIZE(data_sources));
988 static int dev_acquisition_start(const struct sr_dev_inst *sdi)
990 struct sr_scpi_dev_inst *scpi;
991 struct dev_context *devc;
992 struct sr_channel *ch;
993 struct sr_datafeed_packet packet;
994 gboolean some_digital;
1000 devc->num_frames = 0;
1002 some_digital = FALSE;
1003 for (l = sdi->channels; l; l = l->next) {
1005 sr_dbg("handling channel %s", ch->name);
1006 if (ch->type == SR_CHANNEL_ANALOG) {
1008 devc->enabled_channels = g_slist_append(
1009 devc->enabled_channels, ch);
1010 if (ch->enabled != devc->analog_channels[ch->index]) {
1011 /* Enabled channel is currently disabled, or vice versa. */
1012 if (rigol_ds_config_set(sdi, ":CHAN%d:DISP %s", ch->index + 1,
1013 ch->enabled ? "ON" : "OFF") != SR_OK)
1015 devc->analog_channels[ch->index] = ch->enabled;
1017 } else if (ch->type == SR_CHANNEL_LOGIC) {
1018 /* Only one list entry for older protocols. All channels are
1019 * retrieved together when this entry is processed. */
1020 if (ch->enabled && (
1021 devc->model->series->protocol > PROTOCOL_V3 ||
1023 devc->enabled_channels = g_slist_append(
1024 devc->enabled_channels, ch);
1026 some_digital = TRUE;
1027 /* Turn on LA module if currently off. */
1028 if (!devc->la_enabled) {
1029 if (rigol_ds_config_set(sdi,
1030 devc->model->series->protocol >= PROTOCOL_V3 ?
1031 ":LA:STAT ON" : ":LA:DISP ON") != SR_OK)
1033 devc->la_enabled = TRUE;
1036 if (ch->enabled != devc->digital_channels[ch->index]) {
1037 /* Enabled channel is currently disabled, or vice versa. */
1038 if (rigol_ds_config_set(sdi,
1039 devc->model->series->protocol >= PROTOCOL_V3 ?
1040 ":LA:DIG%d:DISP %s" : ":DIG%d:TURN %s", ch->index,
1041 ch->enabled ? "ON" : "OFF") != SR_OK)
1043 devc->digital_channels[ch->index] = ch->enabled;
1048 if (!devc->enabled_channels)
1051 /* Turn off LA module if on and no digital channels selected. */
1052 if (devc->la_enabled && !some_digital)
1053 if (rigol_ds_config_set(sdi,
1054 devc->model->series->protocol >= PROTOCOL_V3 ?
1055 ":LA:STAT OFF" : ":LA:DISP OFF") != SR_OK)
1058 /* Set memory mode. */
1059 if (devc->data_source == DATA_SOURCE_SEGMENTED) {
1060 sr_err("Data source 'Segmented' not yet supported");
1064 devc->analog_frame_size = analog_frame_size(sdi);
1065 devc->digital_frame_size = digital_frame_size(sdi);
1067 switch (devc->model->series->protocol) {
1069 if (rigol_ds_config_set(sdi, ":ACQ:MEMD LONG") != SR_OK)
1073 /* Apparently for the DS2000 the memory
1074 * depth can only be set in Running state -
1075 * this matches the behaviour of the UI. */
1076 if (rigol_ds_config_set(sdi, ":RUN") != SR_OK)
1078 if (rigol_ds_config_set(sdi, ":ACQ:MDEP %d",
1079 devc->analog_frame_size) != SR_OK)
1081 if (rigol_ds_config_set(sdi, ":STOP") != SR_OK)
1088 if (devc->data_source == DATA_SOURCE_LIVE)
1089 if (rigol_ds_config_set(sdi, ":RUN") != SR_OK)
1092 sr_scpi_source_add(sdi->session, scpi, G_IO_IN, 50,
1093 rigol_ds_receive, (void *)sdi);
1095 std_session_send_df_header(sdi);
1097 devc->channel_entry = devc->enabled_channels;
1099 if (rigol_ds_capture_start(sdi) != SR_OK)
1102 /* Start of first frame. */
1103 packet.type = SR_DF_FRAME_BEGIN;
1104 sr_session_send(sdi, &packet);
1109 static int dev_acquisition_stop(struct sr_dev_inst *sdi)
1111 struct dev_context *devc;
1112 struct sr_scpi_dev_inst *scpi;
1116 std_session_send_df_end(sdi);
1118 g_slist_free(devc->enabled_channels);
1119 devc->enabled_channels = NULL;
1121 sr_scpi_source_remove(sdi->session, scpi);
1126 static struct sr_dev_driver rigol_ds_driver_info = {
1128 .longname = "Rigol DS",
1131 .cleanup = std_cleanup,
1133 .dev_list = std_dev_list,
1134 .dev_clear = dev_clear,
1135 .config_get = config_get,
1136 .config_set = config_set,
1137 .config_list = config_list,
1138 .dev_open = dev_open,
1139 .dev_close = dev_close,
1140 .dev_acquisition_start = dev_acquisition_start,
1141 .dev_acquisition_stop = dev_acquisition_stop,
1144 SR_REGISTER_DEV_DRIVER(rigol_ds_driver_info);