]> sigrok.org Git - libsigrok.git/blob - src/hardware/rigol-ds/api.c
825d965ad7321439080272a504a030c64b895f45
[libsigrok.git] / src / hardware / rigol-ds / api.c
1 /*
2  * This file is part of the libsigrok project.
3  *
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>
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 <fcntl.h>
24 #include <unistd.h>
25 #include <stdlib.h>
26 #include <string.h>
27 #include <strings.h>
28 #include <math.h>
29 #include <glib.h>
30 #include <libsigrok/libsigrok.h>
31 #include "libsigrok-internal.h"
32 #include "scpi.h"
33 #include "protocol.h"
34
35 static const uint32_t scanopts[] = {
36         SR_CONF_CONN,
37         SR_CONF_SERIALCOMM,
38 };
39
40 static const uint32_t drvopts[] = {
41         SR_CONF_OSCILLOSCOPE,
42 };
43
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,
54 };
55
56 static const uint32_t devopts_cg_analog[] = {
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,
61 };
62
63 static const uint64_t timebases[][2] = {
64         /* nanoseconds */
65         { 1, 1000000000 },
66         { 2, 1000000000 },
67         { 5, 1000000000 },
68         { 10, 1000000000 },
69         { 20, 1000000000 },
70         { 50, 1000000000 },
71         { 100, 1000000000 },
72         { 500, 1000000000 },
73         /* microseconds */
74         { 1, 1000000 },
75         { 2, 1000000 },
76         { 5, 1000000 },
77         { 10, 1000000 },
78         { 20, 1000000 },
79         { 50, 1000000 },
80         { 100, 1000000 },
81         { 200, 1000000 },
82         { 500, 1000000 },
83         /* milliseconds */
84         { 1, 1000 },
85         { 2, 1000 },
86         { 5, 1000 },
87         { 10, 1000 },
88         { 20, 1000 },
89         { 50, 1000 },
90         { 100, 1000 },
91         { 200, 1000 },
92         { 500, 1000 },
93         /* seconds */
94         { 1, 1 },
95         { 2, 1 },
96         { 5, 1 },
97         { 10, 1 },
98         { 20, 1 },
99         { 50, 1 },
100         { 100, 1 },
101         { 200, 1 },
102         { 500, 1 },
103         { 1000, 1 },
104 };
105
106 static const uint64_t vdivs[][2] = {
107         /* microvolts */
108         { 500, 1000000 },
109         /* millivolts */
110         { 1, 1000 },
111         { 2, 1000 },
112         { 5, 1000 },
113         { 10, 1000 },
114         { 20, 1000 },
115         { 50, 1000 },
116         { 100, 1000 },
117         { 200, 1000 },
118         { 500, 1000 },
119         /* volts */
120         { 1, 1 },
121         { 2, 1 },
122         { 5, 1 },
123         { 10, 1 },
124         { 20, 1 },
125         { 50, 1 },
126         { 100, 1 },
127 };
128
129 static const char *trigger_sources_2_chans[] = {
130         "CH1", "CH2",
131         "EXT", "AC Line",
132         "D0", "D1", "D2", "D3", "D4", "D5", "D6", "D7",
133         "D8", "D9", "D10", "D11", "D12", "D13", "D14", "D15",
134 };
135 static const char *trigger_sources_4_chans[] = {
136         "CH1", "CH2", "CH3", "CH4",
137         "EXT", "AC Line",
138         "D0", "D1", "D2", "D3", "D4", "D5", "D6", "D7",
139         "D8", "D9", "D10", "D11", "D12", "D13", "D14", "D15",
140 };
141
142 static const char *trigger_slopes[] = {
143         "r", "f",
144 };
145
146 static const char *coupling[] = {
147         "AC", "DC", "GND",
148 };
149
150 static const uint64_t probe_factor[] = {
151         1, 2, 5, 10, 20, 50, 100, 200, 500, 1000,
152 };
153
154 /* Do not change the order of entries */
155 static const char *data_sources[] = {
156         "Live",
157         "Memory",
158         "Segmented",
159 };
160
161 enum vendor {
162         RIGOL,
163         AGILENT,
164 };
165
166 enum series {
167         VS5000,
168         DS1000,
169         DS2000,
170         DS2000A,
171         DSO1000,
172         DS1000Z,
173 };
174
175 /* short name, full name */
176 static const struct rigol_ds_vendor supported_vendors[] = {
177         [RIGOL] = {"Rigol", "Rigol Technologies"},
178         [AGILENT] = {"Agilent", "Agilent Technologies"},
179 };
180
181 #define VENDOR(x) &supported_vendors[x]
182 /* vendor, series/name, protocol, data format, max timebase, min vdiv,
183  * number of horizontal divs, live waveform samples, memory buffer samples */
184 static const struct rigol_ds_series supported_series[] = {
185         [VS5000] = {VENDOR(RIGOL), "VS5000", PROTOCOL_V1, FORMAT_RAW,
186                 {50, 1}, {2, 1000}, 14, 2048, 0},
187         [DS1000] = {VENDOR(RIGOL), "DS1000", PROTOCOL_V2, FORMAT_IEEE488_2,
188                 {50, 1}, {2, 1000}, 12, 600, 1048576},
189         [DS2000] = {VENDOR(RIGOL), "DS2000", PROTOCOL_V3, FORMAT_IEEE488_2,
190                 {500, 1}, {500, 1000000}, 14, 1400, 14000},
191         [DS2000A] = {VENDOR(RIGOL), "DS2000A", PROTOCOL_V3, FORMAT_IEEE488_2,
192                 {1000, 1}, {500, 1000000}, 14, 1400, 14000},
193         [DSO1000] = {VENDOR(AGILENT), "DSO1000", PROTOCOL_V3, FORMAT_IEEE488_2,
194                 {50, 1}, {2, 1000}, 12, 600, 20480},
195         [DS1000Z] = {VENDOR(RIGOL), "DS1000Z", PROTOCOL_V4, FORMAT_IEEE488_2,
196                 {50, 1}, {1, 1000}, 12, 1200, 12000000},
197 };
198
199 #define SERIES(x) &supported_series[x]
200 #define CHANINFO(num, digital) num, digital, trigger_sources_##num##_chans, digital ? ARRAY_SIZE(trigger_sources_##num##_chans) : (num + 2)
201 /* series, model, min timebase, analog channels, digital */
202 static const struct rigol_ds_model supported_models[] = {
203         {SERIES(VS5000), "VS5022", {20, 1000000000}, CHANINFO(2, false)},
204         {SERIES(VS5000), "VS5042", {10, 1000000000}, CHANINFO(2, false)},
205         {SERIES(VS5000), "VS5062", {5, 1000000000}, CHANINFO(2, false)},
206         {SERIES(VS5000), "VS5102", {2, 1000000000}, CHANINFO(2, false)},
207         {SERIES(VS5000), "VS5202", {2, 1000000000}, CHANINFO(2, false)},
208         {SERIES(VS5000), "VS5022D", {20, 1000000000}, CHANINFO(2, true)},
209         {SERIES(VS5000), "VS5042D", {10, 1000000000}, CHANINFO(2, true)},
210         {SERIES(VS5000), "VS5062D", {5, 1000000000}, CHANINFO(2, true)},
211         {SERIES(VS5000), "VS5102D", {2, 1000000000}, CHANINFO(2, true)},
212         {SERIES(VS5000), "VS5202D", {2, 1000000000}, CHANINFO(2, true)},
213         {SERIES(DS1000), "DS1052E", {5, 1000000000}, CHANINFO(2, false)},
214         {SERIES(DS1000), "DS1102E", {2, 1000000000}, CHANINFO(2, false)},
215         {SERIES(DS1000), "DS1152E", {2, 1000000000}, CHANINFO(2, false)},
216         {SERIES(DS1000), "DS1052D", {5, 1000000000}, CHANINFO(2, true)},
217         {SERIES(DS1000), "DS1102D", {2, 1000000000}, CHANINFO(2, true)},
218         {SERIES(DS1000), "DS1152D", {2, 1000000000}, CHANINFO(2, true)},
219         {SERIES(DS2000), "DS2072", {5, 1000000000}, CHANINFO(2, false)},
220         {SERIES(DS2000), "DS2102", {5, 1000000000}, CHANINFO(2, false)},
221         {SERIES(DS2000), "DS2202", {2, 1000000000}, CHANINFO(2, false)},
222         {SERIES(DS2000), "DS2302", {1, 1000000000}, CHANINFO(2, false)},
223         {SERIES(DS2000A), "DS2072A", {5, 1000000000}, CHANINFO(2, false)},
224         {SERIES(DS2000A), "DS2102A", {5, 1000000000}, CHANINFO(2, false)},
225         {SERIES(DS2000A), "DS2202A", {2, 1000000000}, CHANINFO(2, false)},
226         {SERIES(DS2000A), "DS2302A", {1, 1000000000}, CHANINFO(2, false)},
227         {SERIES(DS2000A), "MSO2072A", {5, 1000000000}, CHANINFO(2, true)},
228         {SERIES(DS2000A), "MSO2102A", {5, 1000000000}, CHANINFO(2, true)},
229         {SERIES(DS2000A), "MSO2202A", {2, 1000000000}, CHANINFO(2, true)},
230         {SERIES(DS2000A), "MSO2302A", {1, 1000000000}, CHANINFO(2, true)},
231         {SERIES(DSO1000), "DSO1002A", {5, 1000000000}, CHANINFO(2, false)},
232         {SERIES(DSO1000), "DSO1004A", {5, 1000000000}, CHANINFO(4, false)},
233         {SERIES(DSO1000), "DSO1012A", {2, 1000000000}, CHANINFO(2, false)},
234         {SERIES(DSO1000), "DSO1014A", {2, 1000000000}, CHANINFO(4, false)},
235         {SERIES(DSO1000), "DSO1022A", {2, 1000000000}, CHANINFO(2, false)},
236         {SERIES(DSO1000), "DSO1024A", {2, 1000000000}, CHANINFO(4, false)},
237         {SERIES(DS1000Z), "DS1054Z", {5, 1000000000}, CHANINFO(4, false)},
238         {SERIES(DS1000Z), "DS1074Z", {5, 1000000000}, CHANINFO(4, false)},
239         {SERIES(DS1000Z), "DS1104Z", {5, 1000000000}, CHANINFO(4, false)},
240         {SERIES(DS1000Z), "DS1074Z-S", {5, 1000000000}, CHANINFO(4, false)},
241         {SERIES(DS1000Z), "DS1104Z-S", {5, 1000000000}, CHANINFO(4, false)},
242         {SERIES(DS1000Z), "DS1074Z Plus", {5, 1000000000}, CHANINFO(4, false)},
243         {SERIES(DS1000Z), "DS1104Z Plus", {5, 1000000000}, CHANINFO(4, false)},
244         {SERIES(DS1000Z), "MSO1074Z", {5, 1000000000}, CHANINFO(4, true)},
245         {SERIES(DS1000Z), "MSO1104Z", {5, 1000000000}, CHANINFO(4, true)},
246         {SERIES(DS1000Z), "MSO1074Z-S", {5, 1000000000}, CHANINFO(4, true)},
247         {SERIES(DS1000Z), "MSO1104Z-S", {5, 1000000000}, CHANINFO(4, true)},
248 };
249
250 static struct sr_dev_driver rigol_ds_driver_info;
251
252 static void clear_helper(struct dev_context *devc)
253 {
254         unsigned int i;
255
256         g_free(devc->data);
257         g_free(devc->buffer);
258         for (i = 0; i < ARRAY_SIZE(devc->coupling); i++)
259                 g_free(devc->coupling[i]);
260         g_free(devc->trigger_source);
261         g_free(devc->trigger_slope);
262         g_free(devc->analog_groups);
263 }
264
265 static int dev_clear(const struct sr_dev_driver *di)
266 {
267         return std_dev_clear_with_callback(di, (std_dev_clear_callback)clear_helper);
268 }
269
270 static struct sr_dev_inst *probe_device(struct sr_scpi_dev_inst *scpi)
271 {
272         struct dev_context *devc;
273         struct sr_dev_inst *sdi;
274         struct sr_scpi_hw_info *hw_info;
275         struct sr_channel *ch;
276         long n[3];
277         unsigned int i;
278         const struct rigol_ds_model *model = NULL;
279         gchar *channel_name, **version;
280
281         if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK) {
282                 sr_info("Couldn't get IDN response, retrying.");
283                 sr_scpi_close(scpi);
284                 sr_scpi_open(scpi);
285                 if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK) {
286                         sr_info("Couldn't get IDN response.");
287                         return NULL;
288                 }
289         }
290
291         for (i = 0; i < ARRAY_SIZE(supported_models); i++) {
292                 if (!g_ascii_strcasecmp(hw_info->manufacturer,
293                                         supported_models[i].series->vendor->full_name) &&
294                                 !strcmp(hw_info->model, supported_models[i].name)) {
295                         model = &supported_models[i];
296                         break;
297                 }
298         }
299
300         if (!model) {
301                 sr_scpi_hw_info_free(hw_info);
302                 return NULL;
303         }
304
305         sdi = g_malloc0(sizeof(struct sr_dev_inst));
306         sdi->vendor = g_strdup(model->series->vendor->name);
307         sdi->model = g_strdup(model->name);
308         sdi->version = g_strdup(hw_info->firmware_version);
309         sdi->conn = scpi;
310         sdi->driver = &rigol_ds_driver_info;
311         sdi->inst_type = SR_INST_SCPI;
312         sdi->serial_num = g_strdup(hw_info->serial_number);
313         devc = g_malloc0(sizeof(struct dev_context));
314         devc->limit_frames = 0;
315         devc->model = model;
316         devc->format = model->series->format;
317
318         /* DS1000 models with firmware before 0.2.4 used the old data format. */
319         if (model->series == SERIES(DS1000)) {
320                 version = g_strsplit(hw_info->firmware_version, ".", 0);
321                 do {
322                         if (!version[0] || !version[1] || !version[2])
323                                 break;
324                         if (version[0][0] == 0 || version[1][0] == 0 || version[2][0] == 0)
325                                 break;
326                         for (i = 0; i < 3; i++) {
327                                 if (sr_atol(version[i], &n[i]) != SR_OK)
328                                         break;
329                         }
330                         if (i != 3)
331                                 break;
332                         scpi->firmware_version = n[0] * 100 + n[1] * 10 + n[2];
333                         if (scpi->firmware_version < 24) {
334                                 sr_dbg("Found DS1000 firmware < 0.2.4, using raw data format.");
335                                 devc->format = FORMAT_RAW;
336                         }
337                         break;
338                 } while (0);
339                 g_strfreev(version);
340         }
341
342         sr_scpi_hw_info_free(hw_info);
343
344         devc->analog_groups = g_malloc0(sizeof(struct sr_channel_group*) *
345                                         model->analog_channels);
346
347         for (i = 0; i < model->analog_channels; i++) {
348                 channel_name = g_strdup_printf("CH%d", i + 1);
349                 ch = sr_channel_new(sdi, i, SR_CHANNEL_ANALOG, TRUE, channel_name);
350
351                 devc->analog_groups[i] = g_malloc0(sizeof(struct sr_channel_group));
352
353                 devc->analog_groups[i]->name = channel_name;
354                 devc->analog_groups[i]->channels = g_slist_append(NULL, ch);
355                 sdi->channel_groups = g_slist_append(sdi->channel_groups,
356                                 devc->analog_groups[i]);
357         }
358
359         if (devc->model->has_digital) {
360                 devc->digital_group = g_malloc0(sizeof(struct sr_channel_group));
361
362                 for (i = 0; i < ARRAY_SIZE(devc->digital_channels); i++) {
363                         channel_name = g_strdup_printf("D%d", i);
364                         ch = sr_channel_new(sdi, i, SR_CHANNEL_LOGIC, TRUE, channel_name);
365                         g_free(channel_name);
366                         devc->digital_group->channels = g_slist_append(
367                                         devc->digital_group->channels, ch);
368                 }
369                 devc->digital_group->name = g_strdup("LA");
370                 sdi->channel_groups = g_slist_append(sdi->channel_groups,
371                                 devc->digital_group);
372         }
373
374         for (i = 0; i < ARRAY_SIZE(timebases); i++) {
375                 if (!memcmp(&devc->model->min_timebase, &timebases[i], sizeof(uint64_t[2])))
376                         devc->timebases = &timebases[i];
377                 if (!memcmp(&devc->model->series->max_timebase, &timebases[i], sizeof(uint64_t[2])))
378                         devc->num_timebases = &timebases[i] - devc->timebases + 1;
379         }
380
381         for (i = 0; i < ARRAY_SIZE(vdivs); i++) {
382                 if (!memcmp(&devc->model->series->min_vdiv,
383                                         &vdivs[i], sizeof(uint64_t[2]))) {
384                         devc->vdivs = &vdivs[i];
385                         devc->num_vdivs = ARRAY_SIZE(vdivs) - i;
386                 }
387         }
388
389         devc->buffer = g_malloc(ACQ_BUFFER_SIZE);
390         devc->data = g_malloc(ACQ_BUFFER_SIZE * sizeof(float));
391
392         devc->data_source = DATA_SOURCE_LIVE;
393
394         sdi->priv = devc;
395
396         return sdi;
397 }
398
399 static GSList *scan(struct sr_dev_driver *di, GSList *options)
400 {
401         return sr_scpi_scan(di->context, options, probe_device);
402 }
403
404 static int dev_open(struct sr_dev_inst *sdi)
405 {
406         int ret;
407         struct sr_scpi_dev_inst *scpi = sdi->conn;
408
409         if ((ret = sr_scpi_open(scpi)) < 0) {
410                 sr_err("Failed to open SCPI device: %s.", sr_strerror(ret));
411                 return SR_ERR;
412         }
413
414         if ((ret = rigol_ds_get_dev_cfg(sdi)) < 0) {
415                 sr_err("Failed to get device config: %s.", sr_strerror(ret));
416                 return SR_ERR;
417         }
418
419         return SR_OK;
420 }
421
422 static int dev_close(struct sr_dev_inst *sdi)
423 {
424         struct sr_scpi_dev_inst *scpi;
425         struct dev_context *devc;
426
427         scpi = sdi->conn;
428         devc = sdi->priv;
429
430         if (!scpi)
431                 return SR_ERR_BUG;
432
433         if (devc->model->series->protocol == PROTOCOL_V2)
434                 rigol_ds_config_set(sdi, ":KEY:LOCK DISABLE");
435
436         return sr_scpi_close(scpi);
437 }
438
439 static int analog_frame_size(const struct sr_dev_inst *sdi)
440 {
441         struct dev_context *devc = sdi->priv;
442         struct sr_channel *ch;
443         int analog_channels = 0;
444         GSList *l;
445
446         for (l = sdi->channels; l; l = l->next) {
447                 ch = l->data;
448                 if (ch->type == SR_CHANNEL_ANALOG && ch->enabled)
449                         analog_channels++;
450         }
451
452         if (analog_channels == 0)
453                 return 0;
454
455         switch (devc->data_source) {
456         case DATA_SOURCE_LIVE:
457                 return devc->model->series->live_samples;
458         case DATA_SOURCE_MEMORY:
459                 return devc->model->series->buffer_samples / analog_channels;
460         default:
461                 return 0;
462         }
463 }
464
465 static int digital_frame_size(const struct sr_dev_inst *sdi)
466 {
467         struct dev_context *devc = sdi->priv;
468
469         switch (devc->data_source) {
470         case DATA_SOURCE_LIVE:
471                 return devc->model->series->live_samples * 2;
472         case DATA_SOURCE_MEMORY:
473                 return devc->model->series->buffer_samples * 2;
474         default:
475                 return 0;
476         }
477 }
478
479 static int config_get(uint32_t key, GVariant **data,
480         const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
481 {
482         struct dev_context *devc;
483         struct sr_channel *ch;
484         const char *tmp_str;
485         uint64_t samplerate;
486         int analog_channel = -1;
487         float smallest_diff = INFINITY;
488         int idx = -1;
489         unsigned i;
490
491         if (!sdi)
492                 return SR_ERR_ARG;
493
494         devc = sdi->priv;
495
496         /* If a channel group is specified, it must be a valid one. */
497         if (cg && !g_slist_find(sdi->channel_groups, cg)) {
498                 sr_err("Invalid channel group specified.");
499                 return SR_ERR;
500         }
501
502         if (cg) {
503                 ch = g_slist_nth_data(cg->channels, 0);
504                 if (!ch)
505                         return SR_ERR;
506                 if (ch->type == SR_CHANNEL_ANALOG) {
507                         if (ch->name[2] < '1' || ch->name[2] > '4')
508                                 return SR_ERR;
509                         analog_channel = ch->name[2] - '1';
510                 }
511         }
512
513         switch (key) {
514         case SR_CONF_NUM_HDIV:
515                 *data = g_variant_new_int32(devc->model->series->num_horizontal_divs);
516                 break;
517         case SR_CONF_NUM_VDIV:
518                 *data = g_variant_new_int32(devc->num_vdivs);
519                 break;
520         case SR_CONF_DATA_SOURCE:
521                 if (devc->data_source == DATA_SOURCE_LIVE)
522                         *data = g_variant_new_string("Live");
523                 else if (devc->data_source == DATA_SOURCE_MEMORY)
524                         *data = g_variant_new_string("Memory");
525                 else
526                         *data = g_variant_new_string("Segmented");
527                 break;
528         case SR_CONF_SAMPLERATE:
529                 if (devc->data_source == DATA_SOURCE_LIVE) {
530                         samplerate = analog_frame_size(sdi) /
531                                 (devc->timebase * devc->model->series->num_horizontal_divs);
532                         *data = g_variant_new_uint64(samplerate);
533                 } else {
534                         sr_dbg("Unknown data source: %d.", devc->data_source);
535                         return SR_ERR_NA;
536                 }
537                 break;
538         case SR_CONF_TRIGGER_SOURCE:
539                 if (!strcmp(devc->trigger_source, "ACL"))
540                         tmp_str = "AC Line";
541                 else if (!strcmp(devc->trigger_source, "CHAN1"))
542                         tmp_str = "CH1";
543                 else if (!strcmp(devc->trigger_source, "CHAN2"))
544                         tmp_str = "CH2";
545                 else if (!strcmp(devc->trigger_source, "CHAN3"))
546                         tmp_str = "CH3";
547                 else if (!strcmp(devc->trigger_source, "CHAN4"))
548                         tmp_str = "CH4";
549                 else
550                         tmp_str = devc->trigger_source;
551                 *data = g_variant_new_string(tmp_str);
552                 break;
553         case SR_CONF_TRIGGER_SLOPE:
554                 if (!strncmp(devc->trigger_slope, "POS", 3)) {
555                         tmp_str = "r";
556                 } else if (!strncmp(devc->trigger_slope, "NEG", 3)) {
557                         tmp_str = "f";
558                 } else {
559                         sr_dbg("Unknown trigger slope: '%s'.", devc->trigger_slope);
560                         return SR_ERR_NA;
561                 }
562                 *data = g_variant_new_string(tmp_str);
563                 break;
564         case SR_CONF_TRIGGER_LEVEL:
565                 *data = g_variant_new_double(devc->trigger_level);
566                 break;
567         case SR_CONF_TIMEBASE:
568                 for (i = 0; i < devc->num_timebases; i++) {
569                         float tb = (float)devc->timebases[i][0] / devc->timebases[i][1];
570                         float diff = fabs(devc->timebase - tb);
571                         if (diff < smallest_diff) {
572                                 smallest_diff = diff;
573                                 idx = i;
574                         }
575                 }
576                 if (idx < 0) {
577                         sr_dbg("Negative timebase index: %d.", idx);
578                         return SR_ERR_NA;
579                 }
580                 *data = g_variant_new("(tt)", devc->timebases[idx][0],
581                                               devc->timebases[idx][1]);
582                 break;
583         case SR_CONF_VDIV:
584                 if (analog_channel < 0) {
585                         sr_dbg("Negative analog channel: %d.", analog_channel);
586                         return SR_ERR_NA;
587                 }
588                 for (i = 0; i < ARRAY_SIZE(vdivs); i++) {
589                         float vdiv = (float)vdivs[i][0] / vdivs[i][1];
590                         float diff = fabs(devc->vdiv[analog_channel] - vdiv);
591                         if (diff < smallest_diff) {
592                                 smallest_diff = diff;
593                                 idx = i;
594                         }
595                 }
596                 if (idx < 0) {
597                         sr_dbg("Negative vdiv index: %d.", idx);
598                         return SR_ERR_NA;
599                 }
600                 *data = g_variant_new("(tt)", vdivs[idx][0], vdivs[idx][1]);
601                 break;
602         case SR_CONF_COUPLING:
603                 if (analog_channel < 0) {
604                         sr_dbg("Negative analog channel: %d.", analog_channel);
605                         return SR_ERR_NA;
606                 }
607                 *data = g_variant_new_string(devc->coupling[analog_channel]);
608                 break;
609         case SR_CONF_PROBE_FACTOR:
610                 if (analog_channel < 0) {
611                         sr_dbg("Negative analog channel: %d.", analog_channel);
612                         return SR_ERR_NA;
613                 }
614                 *data = g_variant_new_uint64(devc->attenuation[analog_channel]);
615                 break;
616         default:
617                 return SR_ERR_NA;
618         }
619
620         return SR_OK;
621 }
622
623 static int config_set(uint32_t key, GVariant *data,
624         const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
625 {
626         struct dev_context *devc;
627         uint64_t p;
628         double t_dbl;
629         int ret, idx, i;
630         const char *tmp_str;
631         char buffer[16];
632
633         devc = sdi->priv;
634
635         /* If a channel group is specified, it must be a valid one. */
636         if (cg && !g_slist_find(sdi->channel_groups, cg)) {
637                 sr_err("Invalid channel group specified.");
638                 return SR_ERR;
639         }
640
641         switch (key) {
642         case SR_CONF_LIMIT_FRAMES:
643                 devc->limit_frames = g_variant_get_uint64(data);
644                 break;
645         case SR_CONF_TRIGGER_SLOPE:
646                 if ((idx = std_str_idx(data, ARRAY_AND_SIZE(trigger_slopes))) < 0)
647                         return SR_ERR_ARG;
648                 g_free(devc->trigger_slope);
649                 devc->trigger_slope = g_strdup((trigger_slopes[idx][0] == 'r') ? "POS" : "NEG");
650                 return rigol_ds_config_set(sdi, ":TRIG:EDGE:SLOP %s", devc->trigger_slope);
651         case SR_CONF_HORIZ_TRIGGERPOS:
652                 t_dbl = g_variant_get_double(data);
653                 if (t_dbl < 0.0 || t_dbl > 1.0) {
654                         sr_err("Invalid horiz. trigger position: %g.", t_dbl);
655                         return SR_ERR;
656                 }
657                 devc->horiz_triggerpos = t_dbl;
658                 /* We have the trigger offset as a percentage of the frame, but
659                  * need to express this in seconds. */
660                 t_dbl = -(devc->horiz_triggerpos - 0.5) * devc->timebase * devc->num_timebases;
661                 g_ascii_formatd(buffer, sizeof(buffer), "%.6f", t_dbl);
662                 return rigol_ds_config_set(sdi, ":TIM:OFFS %s", buffer);
663         case SR_CONF_TRIGGER_LEVEL:
664                 t_dbl = g_variant_get_double(data);
665                 g_ascii_formatd(buffer, sizeof(buffer), "%.3f", t_dbl);
666                 ret = rigol_ds_config_set(sdi, ":TRIG:EDGE:LEV %s", buffer);
667                 if (ret == SR_OK)
668                         devc->trigger_level = t_dbl;
669                 return ret;
670         case SR_CONF_TIMEBASE:
671                 if ((idx = std_u64_tuple_idx(data, devc->timebases, devc->num_timebases)) < 0)
672                         return SR_ERR_ARG;
673                 devc->timebase = (float)devc->timebases[idx][0] / devc->timebases[idx][1];
674                 g_ascii_formatd(buffer, sizeof(buffer), "%.9f",
675                                 devc->timebase);
676                 return rigol_ds_config_set(sdi, ":TIM:SCAL %s", buffer);
677         case SR_CONF_TRIGGER_SOURCE:
678                 if ((idx = std_str_idx(data, devc->model->trigger_sources, devc->model->num_trigger_sources)) < 0)
679                         return SR_ERR_ARG;
680                 g_free(devc->trigger_source);
681                 devc->trigger_source = g_strdup(devc->model->trigger_sources[idx]);
682                 if (!strcmp(devc->trigger_source, "AC Line"))
683                         tmp_str = "ACL";
684                 else if (!strcmp(devc->trigger_source, "CH1"))
685                         tmp_str = "CHAN1";
686                 else if (!strcmp(devc->trigger_source, "CH2"))
687                         tmp_str = "CHAN2";
688                 else if (!strcmp(devc->trigger_source, "CH3"))
689                         tmp_str = "CHAN3";
690                 else if (!strcmp(devc->trigger_source, "CH4"))
691                         tmp_str = "CHAN4";
692                 else
693                         tmp_str = (char *)devc->trigger_source;
694                 return rigol_ds_config_set(sdi, ":TRIG:EDGE:SOUR %s", tmp_str);
695         case SR_CONF_VDIV:
696                 if (!cg)
697                         return SR_ERR_CHANNEL_GROUP;
698                 if ((i = std_cg_idx(cg, devc->analog_groups, devc->model->analog_channels)) < 0)
699                         return SR_ERR_ARG;
700                 if ((idx = std_u64_tuple_idx(data, ARRAY_AND_SIZE(vdivs))) < 0)
701                         return SR_ERR_ARG;
702                 devc->vdiv[i] = (float)vdivs[idx][0] / vdivs[idx][1];
703                 g_ascii_formatd(buffer, sizeof(buffer), "%.3f", devc->vdiv[i]);
704                 return rigol_ds_config_set(sdi, ":CHAN%d:SCAL %s", i + 1, buffer);
705         case SR_CONF_COUPLING:
706                 if (!cg)
707                         return SR_ERR_CHANNEL_GROUP;
708                 if ((i = std_cg_idx(cg, devc->analog_groups, devc->model->analog_channels)) < 0)
709                         return SR_ERR_ARG;
710                 if ((idx = std_str_idx(data, ARRAY_AND_SIZE(coupling))) < 0)
711                         return SR_ERR_ARG;
712                 g_free(devc->coupling[i]);
713                 devc->coupling[i] = g_strdup(coupling[idx]);
714                 return rigol_ds_config_set(sdi, ":CHAN%d:COUP %s", i + 1, devc->coupling[i]);
715         case SR_CONF_PROBE_FACTOR:
716                 if (!cg)
717                         return SR_ERR_CHANNEL_GROUP;
718                 if ((i = std_cg_idx(cg, devc->analog_groups, devc->model->analog_channels)) < 0)
719                         return SR_ERR_ARG;
720                 if ((idx = std_u64_idx(data, ARRAY_AND_SIZE(probe_factor))) < 0)
721                         return SR_ERR_ARG;
722                 p = g_variant_get_uint64(data);
723                 devc->attenuation[i] = probe_factor[idx];
724                 ret = rigol_ds_config_set(sdi, ":CHAN%d:PROB %"PRIu64, i + 1, p);
725                 if (ret == SR_OK)
726                         rigol_ds_get_dev_cfg_vertical(sdi);
727                 return ret;
728         case SR_CONF_DATA_SOURCE:
729                 tmp_str = g_variant_get_string(data, NULL);
730                 if (!strcmp(tmp_str, "Live"))
731                         devc->data_source = DATA_SOURCE_LIVE;
732                 else if (devc->model->series->protocol >= PROTOCOL_V2
733                         && !strcmp(tmp_str, "Memory"))
734                         devc->data_source = DATA_SOURCE_MEMORY;
735                 else if (devc->model->series->protocol >= PROTOCOL_V3
736                          && !strcmp(tmp_str, "Segmented"))
737                         devc->data_source = DATA_SOURCE_SEGMENTED;
738                 else {
739                         sr_err("Unknown data source: '%s'.", tmp_str);
740                         return SR_ERR;
741                 }
742                 break;
743         default:
744                 return SR_ERR_NA;
745         }
746
747         return SR_OK;
748 }
749
750 static int config_list(uint32_t key, GVariant **data,
751         const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
752 {
753         struct dev_context *devc;
754
755         devc = (sdi) ? sdi->priv : NULL;
756
757         switch (key) {
758         case SR_CONF_SCAN_OPTIONS:
759         case SR_CONF_DEVICE_OPTIONS:
760                 if (!cg)
761                         return STD_CONFIG_LIST(key, data, sdi, cg, scanopts, drvopts, devopts);
762                 if (!devc)
763                         return SR_ERR_ARG;
764                 if (cg == devc->digital_group) {
765                         *data = std_gvar_array_u32(NULL, 0);
766                         return SR_OK;
767                 } else {
768                         if (std_cg_idx(cg, devc->analog_groups, devc->model->analog_channels) < 0)
769                                 return SR_ERR_ARG;
770                         *data = std_gvar_array_u32(ARRAY_AND_SIZE(devopts_cg_analog));
771                         return SR_OK;
772                 }
773                 break;
774         case SR_CONF_COUPLING:
775                 if (!cg)
776                         return SR_ERR_CHANNEL_GROUP;
777                 *data = g_variant_new_strv(ARRAY_AND_SIZE(coupling));
778                 break;
779         case SR_CONF_PROBE_FACTOR:
780                 if (!cg)
781                         return SR_ERR_CHANNEL_GROUP;
782                 *data = std_gvar_array_u64(ARRAY_AND_SIZE(probe_factor));
783                 break;
784         case SR_CONF_VDIV:
785                 if (!devc)
786                         /* Can't know this until we have the exact model. */
787                         return SR_ERR_ARG;
788                 if (!cg)
789                         return SR_ERR_CHANNEL_GROUP;
790                 *data = std_gvar_tuple_array(devc->vdivs, devc->num_vdivs);
791                 break;
792         case SR_CONF_TIMEBASE:
793                 if (!devc)
794                         /* Can't know this until we have the exact model. */
795                         return SR_ERR_ARG;
796                 if (devc->num_timebases <= 0)
797                         return SR_ERR_NA;
798                 *data = std_gvar_tuple_array(devc->timebases, devc->num_timebases);
799                 break;
800         case SR_CONF_TRIGGER_SOURCE:
801                 if (!devc)
802                         /* Can't know this until we have the exact model. */
803                         return SR_ERR_ARG;
804                 *data = g_variant_new_strv(devc->model->trigger_sources, devc->model->num_trigger_sources);
805                 break;
806         case SR_CONF_TRIGGER_SLOPE:
807                 *data = g_variant_new_strv(ARRAY_AND_SIZE(trigger_slopes));
808                 break;
809         case SR_CONF_DATA_SOURCE:
810                 if (!devc)
811                         /* Can't know this until we have the exact model. */
812                         return SR_ERR_ARG;
813                 switch (devc->model->series->protocol) {
814                 case PROTOCOL_V1:
815                         *data = g_variant_new_strv(data_sources, ARRAY_SIZE(data_sources) - 2);
816                         break;
817                 case PROTOCOL_V2:
818                         *data = g_variant_new_strv(data_sources, ARRAY_SIZE(data_sources) - 1);
819                         break;
820                 default:
821                         *data = g_variant_new_strv(ARRAY_AND_SIZE(data_sources));
822                         break;
823                 }
824                 break;
825         default:
826                 return SR_ERR_NA;
827         }
828
829         return SR_OK;
830 }
831
832 static int dev_acquisition_start(const struct sr_dev_inst *sdi)
833 {
834         struct sr_scpi_dev_inst *scpi;
835         struct dev_context *devc;
836         struct sr_channel *ch;
837         struct sr_datafeed_packet packet;
838         gboolean some_digital;
839         GSList *l;
840
841         scpi = sdi->conn;
842         devc = sdi->priv;
843
844         devc->num_frames = 0;
845
846         some_digital = FALSE;
847         for (l = sdi->channels; l; l = l->next) {
848                 ch = l->data;
849                 sr_dbg("handling channel %s", ch->name);
850                 if (ch->type == SR_CHANNEL_ANALOG) {
851                         if (ch->enabled)
852                                 devc->enabled_channels = g_slist_append(
853                                                 devc->enabled_channels, ch);
854                         if (ch->enabled != devc->analog_channels[ch->index]) {
855                                 /* Enabled channel is currently disabled, or vice versa. */
856                                 if (rigol_ds_config_set(sdi, ":CHAN%d:DISP %s", ch->index + 1,
857                                                 ch->enabled ? "ON" : "OFF") != SR_OK)
858                                         return SR_ERR;
859                                 devc->analog_channels[ch->index] = ch->enabled;
860                         }
861                 } else if (ch->type == SR_CHANNEL_LOGIC) {
862                         /* Only one list entry for older protocols. All channels are
863                          * retrieved together when this entry is processed. */
864                         if (ch->enabled && (
865                                                 devc->model->series->protocol > PROTOCOL_V3 ||
866                                                 !some_digital))
867                                 devc->enabled_channels = g_slist_append(
868                                                 devc->enabled_channels, ch);
869                         if (ch->enabled) {
870                                 some_digital = TRUE;
871                                 /* Turn on LA module if currently off. */
872                                 if (!devc->la_enabled) {
873                                         if (rigol_ds_config_set(sdi,
874                                                         devc->model->series->protocol >= PROTOCOL_V3 ?
875                                                                 ":LA:STAT ON" : ":LA:DISP ON") != SR_OK)
876                                                 return SR_ERR;
877                                         devc->la_enabled = TRUE;
878                                 }
879                         }
880                         if (ch->enabled != devc->digital_channels[ch->index]) {
881                                 /* Enabled channel is currently disabled, or vice versa. */
882                                 if (rigol_ds_config_set(sdi,
883                                                 devc->model->series->protocol >= PROTOCOL_V3 ?
884                                                         ":LA:DIG%d:DISP %s" : ":DIG%d:TURN %s", ch->index,
885                                                 ch->enabled ? "ON" : "OFF") != SR_OK)
886                                         return SR_ERR;
887                                 devc->digital_channels[ch->index] = ch->enabled;
888                         }
889                 }
890         }
891
892         if (!devc->enabled_channels)
893                 return SR_ERR;
894
895         /* Turn off LA module if on and no digital channels selected. */
896         if (devc->la_enabled && !some_digital)
897                 if (rigol_ds_config_set(sdi,
898                                 devc->model->series->protocol >= PROTOCOL_V3 ?
899                                         ":LA:STAT OFF" : ":LA:DISP OFF") != SR_OK)
900                         return SR_ERR;
901
902         /* Set memory mode. */
903         if (devc->data_source == DATA_SOURCE_SEGMENTED) {
904                 sr_err("Data source 'Segmented' not yet supported");
905                 return SR_ERR;
906         }
907
908         devc->analog_frame_size = analog_frame_size(sdi);
909         devc->digital_frame_size = digital_frame_size(sdi);
910
911         switch (devc->model->series->protocol) {
912         case PROTOCOL_V2:
913                 if (rigol_ds_config_set(sdi, ":ACQ:MEMD LONG") != SR_OK)
914                         return SR_ERR;
915                 break;
916         case PROTOCOL_V3:
917                 /* Apparently for the DS2000 the memory
918                  * depth can only be set in Running state -
919                  * this matches the behaviour of the UI. */
920                 if (rigol_ds_config_set(sdi, ":RUN") != SR_OK)
921                         return SR_ERR;
922                 if (rigol_ds_config_set(sdi, ":ACQ:MDEP %d",
923                                         devc->analog_frame_size) != SR_OK)
924                         return SR_ERR;
925                 if (rigol_ds_config_set(sdi, ":STOP") != SR_OK)
926                         return SR_ERR;
927                 break;
928         default:
929                 break;
930         }
931
932         if (devc->data_source == DATA_SOURCE_LIVE)
933                 if (rigol_ds_config_set(sdi, ":RUN") != SR_OK)
934                         return SR_ERR;
935
936         sr_scpi_source_add(sdi->session, scpi, G_IO_IN, 50,
937                         rigol_ds_receive, (void *)sdi);
938
939         std_session_send_df_header(sdi);
940
941         devc->channel_entry = devc->enabled_channels;
942
943         if (rigol_ds_capture_start(sdi) != SR_OK)
944                 return SR_ERR;
945
946         /* Start of first frame. */
947         packet.type = SR_DF_FRAME_BEGIN;
948         sr_session_send(sdi, &packet);
949
950         return SR_OK;
951 }
952
953 static int dev_acquisition_stop(struct sr_dev_inst *sdi)
954 {
955         struct dev_context *devc;
956         struct sr_scpi_dev_inst *scpi;
957
958         devc = sdi->priv;
959
960         std_session_send_df_end(sdi);
961
962         g_slist_free(devc->enabled_channels);
963         devc->enabled_channels = NULL;
964         scpi = sdi->conn;
965         sr_scpi_source_remove(sdi->session, scpi);
966
967         return SR_OK;
968 }
969
970 static struct sr_dev_driver rigol_ds_driver_info = {
971         .name = "rigol-ds",
972         .longname = "Rigol DS",
973         .api_version = 1,
974         .init = std_init,
975         .cleanup = std_cleanup,
976         .scan = scan,
977         .dev_list = std_dev_list,
978         .dev_clear = dev_clear,
979         .config_get = config_get,
980         .config_set = config_set,
981         .config_list = config_list,
982         .dev_open = dev_open,
983         .dev_close = dev_close,
984         .dev_acquisition_start = dev_acquisition_start,
985         .dev_acquisition_stop = dev_acquisition_stop,
986         .context = NULL,
987 };
988 SR_REGISTER_DEV_DRIVER(rigol_ds_driver_info);