?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
doc: discuss "colons in conn= specs" in the manpage
[sigrok-cli.git] / show.c
blobce001cdc55b47c3b099ad71989612c24cea53771
1 /*
2 * This file is part of the sigrok-cli project.
3 *
4 * Copyright (C) 2013 Bert Vermeulen <bert@biot.com>
5 *
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.
10 *
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.
15 *
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/>.
18 */
19
20 #include <config.h>
21 #include <glib.h>
22 #include <string.h>
23 #include "sigrok-cli.h"
24
25 static gint sort_inputs(gconstpointer a, gconstpointer b)
26 {
27 return strcmp(sr_input_id_get((struct sr_input_module *)a),
28 sr_input_id_get((struct sr_input_module *)b));
29 }
30
31 static gint sort_outputs(gconstpointer a, gconstpointer b)
32 {
33 return strcmp(sr_output_id_get((struct sr_output_module *)a),
34 sr_output_id_get((struct sr_output_module *)b));
35 }
36
37 static gint sort_transforms(gconstpointer a, gconstpointer b)
38 {
39 return strcmp(sr_transform_id_get((struct sr_transform_module *)a),
40 sr_transform_id_get((struct sr_transform_module *)b));
41 }
42
43 static gint sort_drivers(gconstpointer a, gconstpointer b)
44 {
45 const struct sr_dev_driver *sdda = a, *sddb = b;
46
47 return strcmp(sdda->name, sddb->name);
48 }
49
50 #ifdef HAVE_SRD
51 static gint sort_pds(gconstpointer a, gconstpointer b)
52 {
53 const struct srd_decoder *sda = a, *sdb = b;
54
55 return strcmp(sda->id, sdb->id);
56 }
57 #endif
58
59 void show_version(void)
60 {
61 GString *s;
62 GSList *l, *l_orig, *m;
63 char *str;
64 const char *lib, *version;
65
66 printf("sigrok-cli %s\n\n", SC_PACKAGE_VERSION_STRING);
67
68 printf("Libraries and features:\n");
69
70 printf("- libsigrok %s/%s (rt: %s/%s).\n",
71 SR_PACKAGE_VERSION_STRING, SR_LIB_VERSION_STRING,
72 sr_package_version_string_get(), sr_lib_version_string_get());
73
74 s = g_string_sized_new(200);
75 g_string_append(s, " - Libs:\n");
76 l_orig = sr_buildinfo_libs_get();
77 for (l = l_orig; l; l = l->next) {
78 m = l->data;
79 lib = m->data;
80 version = m->next->data;
81 g_string_append_printf(s, " - %s %s\n", lib, version);
82 g_slist_free_full(m, g_free);
83 }
84 g_slist_free(l_orig);
85 s->str[s->len - 1] = '\0';
86 printf("%s\n", s->str);
87 g_string_free(s, TRUE);
88
89 str = sr_buildinfo_host_get();
90 printf(" - Host: %s.\n", str);
91 g_free(str);
92
93 str = sr_buildinfo_scpi_backends_get();
94 printf(" - SCPI backends: %s.\n", str);
95 g_free(str);
96
97 #ifdef HAVE_SRD
98 printf("- libsigrokdecode %s/%s (rt: %s/%s).\n",
99 SRD_PACKAGE_VERSION_STRING, SRD_LIB_VERSION_STRING,
100 srd_package_version_string_get(), srd_lib_version_string_get());
101
102 s = g_string_sized_new(200);
103 g_string_append(s, " - Libs:\n");
104 l_orig = srd_buildinfo_libs_get();
105 for (l = l_orig; l; l = l->next) {
106 m = l->data;
107 lib = m->data;
108 version = m->next->data;
109 g_string_append_printf(s, " - %s %s\n", lib, version);
110 g_slist_free_full(m, g_free);
111 }
112 g_slist_free(l_orig);
113 s->str[s->len - 1] = '\0';
114 printf("%s\n", s->str);
115 g_string_free(s, TRUE);
116
117 str = srd_buildinfo_host_get();
118 printf(" - Host: %s.\n", str);
119 g_free(str);
120 #endif
121 }
122
123 void show_supported(void)
124 {
125 struct sr_dev_driver **drivers, *driver;
126 const struct sr_input_module **inputs, *input;
127 const struct sr_output_module **outputs, *output;
128 const struct sr_transform_module **transforms, *transform;
129 const GSList *l;
130 GSList *sl;
131 int i;
132 #ifdef HAVE_SRD
133 struct srd_decoder *dec;
134 #endif
135
136 printf("Supported hardware drivers:\n");
137 drivers = sr_driver_list(sr_ctx);
138 for (sl = NULL, i = 0; drivers[i]; i++)
139 sl = g_slist_append(sl, drivers[i]);
140 sl = g_slist_sort(sl, sort_drivers);
141 for (l = sl; l; l = l->next) {
142 driver = l->data;
143 printf(" %-20s %s\n", driver->name, driver->longname);
144 }
145 printf("\n");
146 g_slist_free(sl);
147
148 printf("Supported input formats:\n");
149 inputs = sr_input_list();
150 for (sl = NULL, i = 0; inputs[i]; i++)
151 sl = g_slist_append(sl, (gpointer)inputs[i]);
152 sl = g_slist_sort(sl, sort_inputs);
153 for (l = sl; l; l = l->next) {
154 input = l->data;
155 printf(" %-20s %s\n", sr_input_id_get(input),
156 sr_input_description_get(input));
157 }
158 printf("\n");
159 g_slist_free(sl);
160
161 printf("Supported output formats:\n");
162 outputs = sr_output_list();
163 for (sl = NULL, i = 0; outputs[i]; i++)
164 sl = g_slist_append(sl, (gpointer)outputs[i]);
165 sl = g_slist_sort(sl, sort_outputs);
166 for (l = sl; l; l = l->next) {
167 output = l->data;
168 printf(" %-20s %s\n", sr_output_id_get(output),
169 sr_output_description_get(output));
170 }
171 printf("\n");
172 g_slist_free(sl);
173
174 printf("Supported transform modules:\n");
175 transforms = sr_transform_list();
176 for (sl = NULL, i = 0; transforms[i]; i++)
177 sl = g_slist_append(sl, (gpointer)transforms[i]);
178 sl = g_slist_sort(sl, sort_transforms);
179 for (l = sl; l; l = l->next) {
180 transform = l->data;
181 printf(" %-20s %s\n", sr_transform_id_get(transform),
182 sr_transform_description_get(transform));
183 }
184 printf("\n");
185 g_slist_free(sl);
186
187 #ifdef HAVE_SRD
188 if (srd_init(NULL) == SRD_OK) {
189 printf("Supported protocol decoders:\n");
190 srd_decoder_load_all();
191 sl = g_slist_copy((GSList *)srd_decoder_list());
192 sl = g_slist_sort(sl, sort_pds);
193 for (l = sl; l; l = l->next) {
194 dec = l->data;
195 printf(" %-20s %s\n", dec->id, dec->longname);
196 /* Print protocol description upon "-l 3" or higher. */
197 if (opt_loglevel >= SR_LOG_INFO)
198 printf(" %-20s %s\n", "", dec->desc);
199 }
200 g_slist_free(sl);
201 srd_exit();
202 }
203 printf("\n");
204 #endif
205 }
206
207 void show_supported_wiki(void)
208 {
209 #ifndef HAVE_SRD
210 printf("Error, libsigrokdecode support not compiled in.");
211 #else
212 const GSList *l;
213 GSList *sl;
214 struct srd_decoder *dec;
215
216 if (srd_init(NULL) != SRD_OK)
217 return;
218
219 srd_decoder_load_all();
220 sl = g_slist_copy((GSList *)srd_decoder_list());
221 sl = g_slist_sort(sl, sort_pds);
222
223 printf("== Supported protocol decoders ==\n\n");
224
225 printf("<!-- Generated via sigrok-cli --list-supported-wiki. -->\n\n");
226
227 printf("Number of currently supported protocol decoders: "
228 "'''%d'''.\n\n", g_slist_length(sl));
229
230 printf("{| border=\"0\" style=\"font-size: smaller\" "
231 "class=\"alternategrey sortable sigroktable\"\n"
232 "|-\n!Protocol\n!Tags\n!Input IDs\n!Output IDs\n!Status\n"
233 "!Full name\n!Description\n\n");
234
235 for (l = sl; l; l = l->next) {
236 dec = l->data;
237
238 GString *tags = g_string_new(NULL);
239 for (GSList *t = dec->tags; t; t = t->next)
240 g_string_append_printf(tags, "%s, ", (char *)t->data);
241 if (tags->len != 0)
242 g_string_truncate(tags, tags->len - 2);
243
244 GString *in = g_string_new(NULL);
245 for (GSList *t = dec->inputs; t; t = t->next)
246 g_string_append_printf(in, "%s, ", (char *)t->data);
247 if (in->len == 0)
248 g_string_append_printf(in, "&mdash;");
249 else
250 g_string_truncate(in, in->len - 2);
251
252 GString *out = g_string_new(NULL);
253 for (GSList *t = dec->outputs; t; t = t->next)
254 g_string_append_printf(out, "%s, ", (char *)t->data);
255 if (out->len == 0)
256 g_string_append_printf(out, "&mdash;");
257 else
258 g_string_truncate(out, out->len - 2);
259
260 printf("{{pd|%s|%s|%s|%s|%s|%s|%s|supported}}\n",
261 dec->id, dec->name, dec->longname, dec->desc,
262 tags->str, in->str, out->str);
263
264 g_string_free(tags, TRUE);
265 g_string_free(in, TRUE);
266 g_string_free(out, TRUE);
267 }
268 g_slist_free(sl);
269 srd_exit();
270
271 printf("\n|}\n");
272 #endif
273 }
274
275 static gint sort_channels(gconstpointer a, gconstpointer b)
276 {
277 const struct sr_channel *pa = a, *pb = b;
278
279 return pa->index - pb->index;
280 }
281
282 static void print_dev_line(const struct sr_dev_inst *sdi)
283 {
284 struct sr_channel *ch;
285 GSList *sl, *l, *channels;
286 GString *s;
287 GVariant *gvar;
288 struct sr_dev_driver *driver;
289 const char *vendor, *model, *version;
290
291 driver = sr_dev_inst_driver_get(sdi);
292 vendor = sr_dev_inst_vendor_get(sdi);
293 model = sr_dev_inst_model_get(sdi);
294 version = sr_dev_inst_version_get(sdi);
295 channels = sr_dev_inst_channels_get(sdi);
296
297 s = g_string_sized_new(128);
298 g_string_assign(s, driver->name);
299 if (maybe_config_get(driver, sdi, NULL, SR_CONF_CONN, &gvar) == SR_OK) {
300 g_string_append(s, ":conn=");
301 g_string_append(s, g_variant_get_string(gvar, NULL));
302 g_variant_unref(gvar);
303 }
304 g_string_append(s, " - ");
305 if (vendor && vendor[0])
306 g_string_append_printf(s, "%s ", vendor);
307 if (model && model[0])
308 g_string_append_printf(s, "%s ", model);
309 if (version && version[0])
310 g_string_append_printf(s, "%s ", version);
311 if (channels) {
312 if (g_slist_length(channels) == 1) {
313 ch = channels->data;
314 g_string_append_printf(s, "with 1 channel: %s", ch->name);
315 } else {
316 sl = g_slist_sort(g_slist_copy(channels), sort_channels);
317 g_string_append_printf(s, "with %d channels:", g_slist_length(sl));
318 for (l = sl; l; l = l->next) {
319 ch = l->data;
320 g_string_append_printf(s, " %s", ch->name);
321 }
322 g_slist_free(sl);
323 }
324 }
325 g_string_append_printf(s, "\n");
326 printf("%s", s->str);
327 g_string_free(s, TRUE);
328
329 }
330
331 void show_dev_list(void)
332 {
333 struct sr_dev_inst *sdi;
334 GSList *devices, *l;
335
336 if (!(devices = device_scan()))
337 return;
338
339 printf("The following devices were found:\n");
340 for (l = devices; l; l = l->next) {
341 sdi = l->data;
342 print_dev_line(sdi);
343 }
344 g_slist_free(devices);
345
346 }
347
348 void show_drv_detail(struct sr_dev_driver *driver)
349 {
350 const struct sr_key_info *srci;
351 GArray *opts;
352 guint i;
353
354 if ((opts = sr_dev_options(driver, NULL, NULL))) {
355 if (opts->len > 0) {
356 printf("Driver functions:\n");
357 for (i = 0; i < opts->len; i++) {
358 if (!(srci = sr_key_info_get(SR_KEY_CONFIG,
359 g_array_index(opts, uint32_t, i))))
360 continue;
361 printf(" %s\n", srci->name);
362 }
363 }
364 g_array_free(opts, TRUE);
365 }
366
367 if ((opts = sr_driver_scan_options_list(driver))) {
368 if (opts->len > 0) {
369 printf("Scan options:\n");
370 for (i = 0; i < opts->len; i++) {
371 if (!(srci = sr_key_info_get(SR_KEY_CONFIG,
372 g_array_index(opts, uint32_t, i))))
373 continue;
374 printf(" %s\n", srci->id);
375 }
376 }
377 g_array_free(opts, TRUE);
378 }
379 }
380
381 void show_dev_detail(void)
382 {
383 struct sr_dev_driver *driver_from_opt, *driver;
384 struct sr_dev_inst *sdi;
385 const struct sr_key_info *srci, *srmqi, *srmqfi;
386 struct sr_channel *ch;
387 struct sr_channel_group *channel_group, *cg;
388 GSList *devices, *cgl, *chl, *channel_groups;
389 GVariant *gvar_dict, *gvar_list, *gvar;
390 gsize num_elements;
391 double dlow, dhigh, dcur_low, dcur_high;
392 const uint64_t *uint64;
393 uint64_t p = 0, q = 0, low = 0, high = 0;
394 uint64_t tmp_uint64, mask, cur_low, cur_high, cur_p, cur_q;
395 GArray *opts;
396 const int32_t *int32;
397 uint32_t key, o, cur_mq, mq;
398 uint64_t cur_mqflags, mqflags;
399 unsigned int num_devices, i, j;
400 char *tmp_str, *s, c;
401 const char **stropts;
402
403 if (parse_driver(opt_drv, &driver_from_opt, NULL)) {
404 /* A driver was specified, report driver-wide options now. */
405 show_drv_detail(driver_from_opt);
406 }
407
408 if (!(devices = device_scan())) {
409 g_critical("No devices found.");
410 return;
411 }
412
413 num_devices = g_slist_length(devices);
414 if (num_devices > 1) {
415 g_critical("%d devices found. Use --scan to show them, "
416 "and select one to show.", num_devices);
417 return;
418 }
419
420 sdi = devices->data;
421 g_slist_free(devices);
422 print_dev_line(sdi);
423
424 driver = sr_dev_inst_driver_get(sdi);
425 channel_groups = sr_dev_inst_channel_groups_get(sdi);
426
427 if (sr_dev_open(sdi) != SR_OK) {
428 g_critical("Failed to open device.");
429 return;
430 }
431
432 /*
433 * Selected channels and channel group may affect which options are
434 * returned, or which values for them.
435 */
436 select_channels(sdi);
437 channel_group = select_channel_group(sdi);
438
439 if (!(opts = sr_dev_options(driver, sdi, channel_group)))
440 /* Driver supports no device instance options. */
441 return;
442
443 if (channel_groups) {
444 printf("Channel groups:\n");
445 for (cgl = channel_groups; cgl; cgl = cgl->next) {
446 cg = cgl->data;
447 printf(" %s: channel%s", cg->name,
448 g_slist_length(cg->channels) > 1 ? "s" : "");
449 for (chl = cg->channels; chl; chl = chl->next) {
450 ch = chl->data;
451 printf(" %s", ch->name);
452 }
453 printf("\n");
454 }
455 }
456
457 printf("Supported configuration options");
458 if (channel_groups) {
459 if (!channel_group)
460 printf(" across all channel groups");
461 else
462 printf(" on channel group %s", channel_group->name);
463 }
464 printf(":\n");
465 for (o = 0; o < opts->len; o++) {
466 key = g_array_index(opts, uint32_t, o);
467 if (!(srci = sr_key_info_get(SR_KEY_CONFIG, key)))
468 continue;
469
470 if (key == SR_CONF_TRIGGER_MATCH) {
471 if (maybe_config_list(driver, sdi, channel_group, key,
472 &gvar_list) != SR_OK) {
473 printf("\n");
474 continue;
475 }
476 int32 = g_variant_get_fixed_array(gvar_list,
477 &num_elements, sizeof(int32_t));
478 printf(" Supported triggers: ");
479 for (i = 0; i < num_elements; i++) {
480 switch (int32[i]) {
481 case SR_TRIGGER_ZERO:
482 c = '0';
483 break;
484 case SR_TRIGGER_ONE:
485 c = '1';
486 break;
487 case SR_TRIGGER_RISING:
488 c = 'r';
489 break;
490 case SR_TRIGGER_FALLING:
491 c = 'f';
492 break;
493 case SR_TRIGGER_EDGE:
494 c = 'e';
495 break;
496 case SR_TRIGGER_OVER:
497 c = 'o';
498 break;
499 case SR_TRIGGER_UNDER:
500 c = 'u';
501 break;
502 default:
503 c = 0;
504 break;
505 }
506 if (c)
507 printf("%c ", c);
508 }
509 printf("\n");
510 g_variant_unref(gvar_list);
511
512 } else if (key == SR_CONF_LIMIT_SAMPLES
513 && (sr_dev_config_capabilities_list(sdi, NULL, key)
514 & SR_CONF_LIST)) {
515 /*
516 * If implemented in config_list(), this denotes the
517 * maximum number of samples a device can send. This
518 * really applies only to logic analyzers, and then
519 * only to those that don't support compression, or
520 * have it turned off by default. The values returned
521 * are the low/high limits.
522 */
523 if (sr_config_list(driver, sdi, channel_group, key,
524 &gvar) == SR_OK) {
525 g_variant_get(gvar, "(tt)", &low, &high);
526 g_variant_unref(gvar);
527 printf(" Maximum number of samples: %"PRIu64"\n", high);
528 }
529
530 } else if (key == SR_CONF_SAMPLERATE) {
531 /* Supported samplerates */
532 printf(" %s", srci->id);
533 if (maybe_config_list(driver, sdi, channel_group, SR_CONF_SAMPLERATE,
534 &gvar_dict) != SR_OK) {
535 printf("\n");
536 continue;
537 }
538 if ((gvar_list = g_variant_lookup_value(gvar_dict,
539 "samplerates", G_VARIANT_TYPE("at")))) {
540 uint64 = g_variant_get_fixed_array(gvar_list,
541 &num_elements, sizeof(uint64_t));
542 printf(" - supported samplerates:\n");
543 for (i = 0; i < num_elements; i++) {
544 if (!(s = sr_samplerate_string(uint64[i])))
545 continue;
546 printf(" %s\n", s);
547 g_free(s);
548 }
549 g_variant_unref(gvar_list);
550 } else if ((gvar_list = g_variant_lookup_value(gvar_dict,
551 "samplerate-steps", G_VARIANT_TYPE("at")))) {
552 uint64 = g_variant_get_fixed_array(gvar_list,
553 &num_elements, sizeof(uint64_t));
554 /* low */
555 if (!(s = sr_samplerate_string(uint64[0])))
556 continue;
557 printf(" (%s", s);
558 g_free(s);
559 /* high */
560 if (!(s = sr_samplerate_string(uint64[1])))
561 continue;
562 printf(" - %s", s);
563 g_free(s);
564 /* step */
565 if (!(s = sr_samplerate_string(uint64[2])))
566 continue;
567 printf(" in steps of %s)\n", s);
568 g_free(s);
569 g_variant_unref(gvar_list);
570 }
571 g_variant_unref(gvar_dict);
572
573 } else if (srci->datatype == SR_T_UINT64) {
574 printf(" %s: ", srci->id);
575 gvar = NULL;
576 if (maybe_config_get(driver, sdi, channel_group, key,
577 &gvar) == SR_OK) {
578 tmp_uint64 = g_variant_get_uint64(gvar);
579 g_variant_unref(gvar);
580 } else
581 tmp_uint64 = 0;
582 if (maybe_config_list(driver, sdi, channel_group,
583 key, &gvar_list) != SR_OK) {
584 if (gvar) {
585 /* Can't list it, but we have a value to show. */
586 printf("%"PRIu64" (current)", tmp_uint64);
587 }
588 printf("\n");
589 continue;
590 }
591 uint64 = g_variant_get_fixed_array(gvar_list,
592 &num_elements, sizeof(uint64_t));
593 printf(" - supported values:\n");
594 for (i = 0; i < num_elements; i++) {
595 printf(" %"PRIu64, uint64[i]);
596 if (gvar && tmp_uint64 == uint64[i])
597 printf(" (current)");
598 printf("\n");
599 }
600 g_variant_unref(gvar_list);
601
602 } else if (srci->datatype == SR_T_STRING) {
603 printf(" %s: ", srci->id);
604 if (maybe_config_get(driver, sdi, channel_group, key,
605 &gvar) == SR_OK) {
606 tmp_str = g_strdup(g_variant_get_string(gvar, NULL));
607 g_variant_unref(gvar);
608 } else
609 tmp_str = NULL;
610
611 if (maybe_config_list(driver, sdi, channel_group, key,
612 &gvar) != SR_OK) {
613 if (tmp_str) {
614 /* Can't list it, but we have a value to show. */
615 printf("%s (current)", tmp_str);
616 }
617 printf("\n");
618 g_free(tmp_str);
619 continue;
620 }
621
622 stropts = g_variant_get_strv(gvar, &num_elements);
623 for (i = 0; i < num_elements; i++) {
624 if (i)
625 printf(", ");
626 printf("%s", stropts[i]);
627 if (tmp_str && !strcmp(tmp_str, stropts[i]))
628 printf(" (current)");
629 }
630 printf("\n");
631 g_free(stropts);
632 g_free(tmp_str);
633 g_variant_unref(gvar);
634
635 } else if (srci->datatype == SR_T_UINT64_RANGE) {
636 printf(" %s: ", srci->id);
637 if (maybe_config_list(driver, sdi, channel_group, key,
638 &gvar_list) != SR_OK) {
639 printf("\n");
640 continue;
641 }
642
643 if (maybe_config_get(driver, sdi, channel_group, key, &gvar) == SR_OK) {
644 g_variant_get(gvar, "(tt)", &cur_low, &cur_high);
645 g_variant_unref(gvar);
646 } else {
647 cur_low = 0;
648 cur_high = 0;
649 }
650
651 num_elements = g_variant_n_children(gvar_list);
652 for (i = 0; i < num_elements; i++) {
653 gvar = g_variant_get_child_value(gvar_list, i);
654 g_variant_get(gvar, "(tt)", &low, &high);
655 g_variant_unref(gvar);
656 if (i)
657 printf(", ");
658 printf("%"PRIu64"-%"PRIu64, low, high);
659 if (low == cur_low && high == cur_high)
660 printf(" (current)");
661 }
662 printf("\n");
663 g_variant_unref(gvar_list);
664
665 } else if (srci->datatype == SR_T_BOOL) {
666 printf(" %s: ", srci->id);
667 if (maybe_config_get(driver, sdi, channel_group, key,
668 &gvar) == SR_OK) {
669 if (g_variant_get_boolean(gvar))
670 printf("on (current), off\n");
671 else
672 printf("on, off (current)\n");
673 g_variant_unref(gvar);
674 } else
675 printf("on, off\n");
676
677 } else if (srci->datatype == SR_T_DOUBLE_RANGE) {
678 printf(" %s: ", srci->id);
679 if (maybe_config_list(driver, sdi, channel_group, key,
680 &gvar_list) != SR_OK) {
681 printf("\n");
682 continue;
683 }
684
685 if (maybe_config_get(driver, sdi, channel_group, key, &gvar) == SR_OK) {
686 g_variant_get(gvar, "(dd)", &dcur_low, &dcur_high);
687 g_variant_unref(gvar);
688 } else {
689 dcur_low = 0;
690 dcur_high = 0;
691 }
692
693 num_elements = g_variant_n_children(gvar_list);
694 for (i = 0; i < num_elements; i++) {
695 gvar = g_variant_get_child_value(gvar_list, i);
696 g_variant_get(gvar, "(dd)", &dlow, &dhigh);
697 g_variant_unref(gvar);
698 if (i)
699 printf(", ");
700 printf("%.1f-%.1f", dlow, dhigh);
701 if (dlow == dcur_low && dhigh == dcur_high)
702 printf(" (current)");
703 }
704 printf("\n");
705 g_variant_unref(gvar_list);
706
707 } else if (srci->datatype == SR_T_FLOAT) {
708 printf(" %s: ", srci->id);
709 if (maybe_config_get(driver, sdi, channel_group, key,
710 &gvar) == SR_OK) {
711 printf("%f\n", g_variant_get_double(gvar));
712 g_variant_unref(gvar);
713 } else
714 printf("\n");
715
716 } else if (srci->datatype == SR_T_RATIONAL_PERIOD
717 || srci->datatype == SR_T_RATIONAL_VOLT) {
718 printf(" %s", srci->id);
719 if (maybe_config_get(driver, sdi, channel_group, key,
720 &gvar) == SR_OK) {
721 g_variant_get(gvar, "(tt)", &cur_p, &cur_q);
722 g_variant_unref(gvar);
723 } else
724 cur_p = cur_q = 0;
725
726 if (maybe_config_list(driver, sdi, channel_group,
727 key, &gvar_list) != SR_OK) {
728 printf("\n");
729 continue;
730 }
731 printf(" - supported values:\n");
732 num_elements = g_variant_n_children(gvar_list);
733 for (i = 0; i < num_elements; i++) {
734 gvar = g_variant_get_child_value(gvar_list, i);
735 g_variant_get(gvar, "(tt)", &p, &q);
736 if (srci->datatype == SR_T_RATIONAL_PERIOD)
737 s = sr_period_string(p, q);
738 else
739 s = sr_voltage_string(p, q);
740 printf(" %s", s);
741 g_free(s);
742 if (p == cur_p && q == cur_q)
743 printf(" (current)");
744 printf("\n");
745 }
746 g_variant_unref(gvar_list);
747
748 } else if (srci->datatype == SR_T_MQ) {
749 printf(" %s: ", srci->id);
750 if (maybe_config_get(driver, sdi, channel_group, key,
751 &gvar) == SR_OK
752 && g_variant_is_of_type(gvar, G_VARIANT_TYPE_TUPLE)
753 && g_variant_n_children(gvar) == 2) {
754 g_variant_get(gvar, "(ut)", &cur_mq, &cur_mqflags);
755 g_variant_unref(gvar);
756 } else
757 cur_mq = cur_mqflags = 0;
758
759 if (maybe_config_list(driver, sdi, channel_group,
760 key, &gvar_list) != SR_OK) {
761 printf("\n");
762 continue;
763 }
764 printf(" - supported measurements:\n");
765 num_elements = g_variant_n_children(gvar_list);
766 for (i = 0; i < num_elements; i++) {
767 printf(" ");
768 gvar = g_variant_get_child_value(gvar_list, i);
769 g_variant_get(gvar, "(ut)", &mq, &mqflags);
770 if ((srmqi = sr_key_info_get(SR_KEY_MQ, mq)))
771 printf("%s", srmqi->id);
772 else
773 printf("%d", mq);
774 for (j = 0, mask = 1; j < 32; j++, mask <<= 1) {
775 if (!(mqflags & mask))
776 continue;
777 if ((srmqfi = sr_key_info_get(SR_KEY_MQFLAGS, mqflags & mask)))
778 printf("/%s", srmqfi->id);
779 else
780 printf("/%" PRIu64, mqflags & mask);
781 }
782 if (mq == cur_mq && mqflags == cur_mqflags)
783 printf(" (current)");
784 printf("\n");
785 }
786 g_variant_unref(gvar_list);
787
788 } else {
789
790 /* Everything else */
791 printf(" %s\n", srci->id);
792 }
793 }
794 g_array_free(opts, TRUE);
795
796 sr_dev_close(sdi);
797
798 }
799
800 #ifdef HAVE_SRD
801 static void show_pd_detail_single(const char *pd)
802 {
803 struct srd_decoder *dec;
804 struct srd_decoder_option *o;
805 struct srd_channel *pdch;
806 struct srd_decoder_annotation_row *r;
807 GSList *l, *ll, *ol;
808 int idx;
809 char **pdtokens, **pdtok, *optsep, **ann, **bin, *val, *doc, *str;
810
811 pdtokens = g_strsplit(pd, ",", -1);
812 for (pdtok = pdtokens; *pdtok; pdtok++) {
813 /* Strip options. */
814 if ((optsep = strchr(*pdtok, ':')))
815 *optsep = '\0';
816 if (!(dec = srd_decoder_get_by_id(*pdtok))) {
817 g_critical("Protocol decoder %s not found.", *pdtok);
818 return;
819 }
820 printf("ID: %s\nName: %s\nLong name: %s\nDescription: %s\n",
821 dec->id, dec->name, dec->longname, dec->desc);
822 printf("License: %s\n", dec->license);
823 printf("Possible decoder input IDs:\n");
824 if (dec->inputs) {
825 for (l = dec->inputs; l; l = l->next) {
826 str = l->data;
827 printf("- %s\n", str);
828 }
829 } else {
830 printf("None.\n");
831 }
832 printf("Possible decoder output IDs:\n");
833 if (dec->outputs) {
834 for (l = dec->outputs; l; l = l->next) {
835 str = l->data;
836 printf("- %s\n", str);
837 }
838 } else {
839 printf("None.\n");
840 }
841 printf("Decoder tags:\n");
842 if (dec->tags) {
843 for (l = dec->tags; l; l = l->next) {
844 str = l->data;
845 printf("- %s\n", str);
846 }
847 } else {
848 printf("None.\n");
849 }
850 printf("Annotation classes:\n");
851 if (dec->annotations) {
852 for (l = dec->annotations; l; l = l->next) {
853 ann = l->data;
854 printf("- %s: %s\n", ann[0], ann[1]);
855 }
856 } else {
857 printf("None.\n");
858 }
859 printf("Annotation rows:\n");
860 if (dec->annotation_rows) {
861 for (l = dec->annotation_rows; l; l = l->next) {
862 r = l->data;
863 printf("- %s (%s): ", r->id, r->desc);
864 for (ll = r->ann_classes; ll; ll = ll->next) {
865 idx = GPOINTER_TO_INT(ll->data);
866 ann = g_slist_nth_data(dec->annotations, idx);
867 printf("%s", ann[0]);
868 if (ll->next)
869 printf(", ");
870 }
871 printf("\n");
872 }
873 } else {
874 printf("None.\n");
875 }
876 printf("Binary classes:\n");
877 if (dec->binary) {
878 for (l = dec->binary; l; l = l->next) {
879 bin = l->data;
880 printf("- %s: %s\n", bin[0], bin[1]);
881 }
882 } else {
883 printf("None.\n");
884 }
885 printf("Required channels:\n");
886 if (dec->channels) {
887 for (l = dec->channels; l; l = l->next) {
888 pdch = l->data;
889 printf("- %s (%s): %s\n",
890 pdch->id, pdch->name, pdch->desc);
891 }
892 } else {
893 printf("None.\n");
894 }
895 printf("Optional channels:\n");
896 if (dec->opt_channels) {
897 for (l = dec->opt_channels; l; l = l->next) {
898 pdch = l->data;
899 printf("- %s (%s): %s\n",
900 pdch->id, pdch->name, pdch->desc);
901 }
902 } else {
903 printf("None.\n");
904 }
905 printf("Options:\n");
906 if (dec->options) {
907 for (l = dec->options; l; l = l->next) {
908 o = l->data;
909 printf("- %s: %s (", o->id, o->desc);
910 for (ol = o->values; ol; ol = ol->next) {
911 val = g_variant_print(ol->data, FALSE);
912 printf("%s, ", val);
913 g_free(val);
914 }
915 val = g_variant_print(o->def, FALSE);
916 printf("default %s)\n", val);
917 g_free(val);
918 }
919 } else {
920 printf("None.\n");
921 }
922 if ((doc = srd_decoder_doc_get(dec))) {
923 printf("Documentation:\n%s\n",
924 doc[0] == '\n' ? doc + 1 : doc);
925 g_free(doc);
926 }
927 }
928
929 g_strfreev(pdtokens);
930 }
931
932 void show_pd_detail(void)
933 {
934 for (int i = 0; opt_pds[i]; i++)
935 show_pd_detail_single(opt_pds[i]);
936 }
937 #endif
938
939 void show_input(void)
940 {
941 const struct sr_input_module *imod;
942 const struct sr_option **opts;
943 GSList *l;
944 int i;
945 char *s, **tok;
946
947 tok = g_strsplit(opt_input_format, ":", 0);
948 if (!tok[0] || !(imod = sr_input_find(tok[0])))
949 g_critical("Input module '%s' not found.", opt_input_format);
950
951 printf("ID: %s\nName: %s\n", sr_input_id_get(imod),
952 sr_input_name_get(imod));
953 printf("Description: %s\n", sr_input_description_get(imod));
954 if ((opts = sr_input_options_get(imod))) {
955 printf("Options:\n");
956 for (i = 0; opts[i]; i++) {
957 printf(" %s: %s", opts[i]->id, opts[i]->desc);
958 if (opts[i]->def) {
959 s = g_variant_print(opts[i]->def, FALSE);
960 printf(" (default %s", s);
961 g_free(s);
962 if (opts[i]->values) {
963 printf(", possible values ");
964 for (l = opts[i]->values; l; l = l->next) {
965 s = g_variant_print((GVariant *)l->data, FALSE);
966 printf("%s%s", s, l->next ? ", " : "");
967 g_free(s);
968 }
969 }
970 printf(")");
971 }
972 printf("\n");
973 }
974 sr_input_options_free(opts);
975 }
976 g_strfreev(tok);
977 }
978
979 void show_output(void)
980 {
981 const struct sr_output_module *omod;
982 const struct sr_option **opts;
983 GSList *l;
984 int i;
985 char *s, **tok;
986
987 tok = g_strsplit(opt_output_format, ":", 0);
988 if (!tok[0] || !(omod = sr_output_find(tok[0])))
989 g_critical("Output module '%s' not found.", opt_output_format);
990
991 printf("ID: %s\nName: %s\n", sr_output_id_get(omod),
992 sr_output_name_get(omod));
993 printf("Description: %s\n", sr_output_description_get(omod));
994 if ((opts = sr_output_options_get(omod))) {
995 printf("Options:\n");
996 for (i = 0; opts[i]; i++) {
997 printf(" %s: %s", opts[i]->id, opts[i]->desc);
998 if (opts[i]->def) {
999 s = g_variant_print(opts[i]->def, FALSE);
1000 printf(" (default %s", s);
1001 g_free(s);
1002 if (opts[i]->values) {
1003 printf(", possible values ");
1004 for (l = opts[i]->values; l; l = l->next) {
1005 s = g_variant_print((GVariant *)l->data, FALSE);
1006 printf("%s%s", s, l->next ? ", " : "");
1007 g_free(s);
1008 }
1009 }
1010 printf(")");
1011 }
1012 printf("\n");
1013 }
1014 sr_output_options_free(opts);
1015 }
1016 g_strfreev(tok);
1017 }
1018
1019 void show_transform(void)
1020 {
1021 const struct sr_transform_module *tmod;
1022 const struct sr_option **opts;
1023 GSList *l;
1024 int i;
1025 char *s, **tok;
1026
1027 tok = g_strsplit(opt_transform_module, ":", 0);
1028 if (!tok[0] || !(tmod = sr_transform_find(tok[0])))
1029 g_critical("Transform module '%s' not found.", opt_transform_module);
1030
1031 printf("ID: %s\nName: %s\n", sr_transform_id_get(tmod),
1032 sr_transform_name_get(tmod));
1033 printf("Description: %s\n", sr_transform_description_get(tmod));
1034 if ((opts = sr_transform_options_get(tmod))) {
1035 printf("Options:\n");
1036 for (i = 0; opts[i]; i++) {
1037 printf(" %s: %s", opts[i]->id, opts[i]->desc);
1038 if (opts[i]->def) {
1039 s = g_variant_print(opts[i]->def, FALSE);
1040 printf(" (default %s", s);
1041 g_free(s);
1042 if (opts[i]->values) {
1043 printf(", possible values ");
1044 for (l = opts[i]->values; l; l = l->next) {
1045 s = g_variant_print((GVariant *)l->data, FALSE);
1046 printf("%s%s", s, l->next ? ", " : "");
1047 g_free(s);
1048 }
1049 }
1050 printf(")");
1051 }
1052 printf("\n");
1053 }
1054 sr_transform_options_free(opts);
1055 }
1056 g_strfreev(tok);
1057 }
1058
1059 static void print_serial_port(gpointer data, gpointer user_data)
1060 {
1061 struct sr_serial_port *port;
1062
1063 port = (void *)data;
1064 (void)user_data;
1065 printf("\t%s\t%s\n", port->name, port->description);
1066 }
1067
1068 void show_serial_ports(void)
1069 {
1070 GSList *serial_ports;
1071
1072 serial_ports = sr_serial_list(NULL);
1073 if (!serial_ports)
1074 return;
1075
1076 printf("Available serial/HID/BT/BLE ports:\n");
1077 g_slist_foreach(serial_ports, print_serial_port, NULL);
1078 g_slist_free_full(serial_ports, (GDestroyNotify)sr_serial_free);
1079 }
command-line frontend for sigrok