2 * This file is part of the sigrok-cli project.
4 * Copyright (C) 2013 Bert Vermeulen <bert@biot.com>
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include "sigrok-cli.h"
25 #define DECODERS_HAVE_TAGS \
26 ((SRD_PACKAGE_VERSION_MAJOR > 0) || \
27 (SRD_PACKAGE_VERSION_MAJOR == 0) && (SRD_PACKAGE_VERSION_MINOR > 5))
29 static gint sort_inputs(gconstpointer a, gconstpointer b)
31 return strcmp(sr_input_id_get((struct sr_input_module *)a),
32 sr_input_id_get((struct sr_input_module *)b));
35 static gint sort_outputs(gconstpointer a, gconstpointer b)
37 return strcmp(sr_output_id_get((struct sr_output_module *)a),
38 sr_output_id_get((struct sr_output_module *)b));
41 static gint sort_transforms(gconstpointer a, gconstpointer b)
43 return strcmp(sr_transform_id_get((struct sr_transform_module *)a),
44 sr_transform_id_get((struct sr_transform_module *)b));
47 static gint sort_drivers(gconstpointer a, gconstpointer b)
49 const struct sr_dev_driver *sdda = a, *sddb = b;
51 return strcmp(sdda->name, sddb->name);
55 static gint sort_pds(gconstpointer a, gconstpointer b)
57 const struct srd_decoder *sda = a, *sdb = b;
59 return strcmp(sda->id, sdb->id);
63 void show_version(void)
66 GSList *l, *l_orig, *m;
68 const char *lib, *version;
70 printf("sigrok-cli %s\n\n", SC_PACKAGE_VERSION_STRING);
72 printf("Libraries and features:\n");
74 printf("- libsigrok %s/%s (rt: %s/%s).\n",
75 SR_PACKAGE_VERSION_STRING, SR_LIB_VERSION_STRING,
76 sr_package_version_string_get(), sr_lib_version_string_get());
78 s = g_string_sized_new(200);
79 g_string_append(s, " - Libs:\n");
80 l_orig = sr_buildinfo_libs_get();
81 for (l = l_orig; l; l = l->next) {
84 version = m->next->data;
85 g_string_append_printf(s, " - %s %s\n", lib, version);
86 g_slist_free_full(m, g_free);
89 s->str[s->len - 1] = '\0';
90 printf("%s\n", s->str);
91 g_string_free(s, TRUE);
93 str = sr_buildinfo_host_get();
94 printf(" - Host: %s.\n", str);
97 str = sr_buildinfo_scpi_backends_get();
98 printf(" - SCPI backends: %s.\n", str);
102 printf("- libsigrokdecode %s/%s (rt: %s/%s).\n",
103 SRD_PACKAGE_VERSION_STRING, SRD_LIB_VERSION_STRING,
104 srd_package_version_string_get(), srd_lib_version_string_get());
106 s = g_string_sized_new(200);
107 g_string_append(s, " - Libs:\n");
108 l_orig = srd_buildinfo_libs_get();
109 for (l = l_orig; l; l = l->next) {
112 version = m->next->data;
113 g_string_append_printf(s, " - %s %s\n", lib, version);
114 g_slist_free_full(m, g_free);
116 g_slist_free(l_orig);
117 s->str[s->len - 1] = '\0';
118 printf("%s\n", s->str);
119 g_string_free(s, TRUE);
121 str = srd_buildinfo_host_get();
122 printf(" - Host: %s.\n", str);
127 void show_supported(void)
129 struct sr_dev_driver **drivers, *driver;
130 const struct sr_input_module **inputs, *input;
131 const struct sr_output_module **outputs, *output;
132 const struct sr_transform_module **transforms, *transform;
137 struct srd_decoder *dec;
140 printf("Supported hardware drivers:\n");
141 drivers = sr_driver_list(sr_ctx);
142 for (sl = NULL, i = 0; drivers[i]; i++)
143 sl = g_slist_append(sl, drivers[i]);
144 sl = g_slist_sort(sl, sort_drivers);
145 for (l = sl; l; l = l->next) {
147 printf(" %-20s %s\n", driver->name, driver->longname);
152 printf("Supported input formats:\n");
153 inputs = sr_input_list();
154 for (sl = NULL, i = 0; inputs[i]; i++)
155 sl = g_slist_append(sl, (gpointer)inputs[i]);
156 sl = g_slist_sort(sl, sort_inputs);
157 for (l = sl; l; l = l->next) {
159 printf(" %-20s %s\n", sr_input_id_get(input),
160 sr_input_description_get(input));
165 printf("Supported output formats:\n");
166 outputs = sr_output_list();
167 for (sl = NULL, i = 0; outputs[i]; i++)
168 sl = g_slist_append(sl, (gpointer)outputs[i]);
169 sl = g_slist_sort(sl, sort_outputs);
170 for (l = sl; l; l = l->next) {
172 printf(" %-20s %s\n", sr_output_id_get(output),
173 sr_output_description_get(output));
178 printf("Supported transform modules:\n");
179 transforms = sr_transform_list();
180 for (sl = NULL, i = 0; transforms[i]; i++)
181 sl = g_slist_append(sl, (gpointer)transforms[i]);
182 sl = g_slist_sort(sl, sort_transforms);
183 for (l = sl; l; l = l->next) {
185 printf(" %-20s %s\n", sr_transform_id_get(transform),
186 sr_transform_description_get(transform));
192 if (srd_init(NULL) == SRD_OK) {
193 printf("Supported protocol decoders:\n");
194 srd_decoder_load_all();
195 sl = g_slist_copy((GSList *)srd_decoder_list());
196 sl = g_slist_sort(sl, sort_pds);
197 for (l = sl; l; l = l->next) {
199 printf(" %-20s %s\n", dec->id, dec->longname);
200 /* Print protocol description upon "-l 3" or higher. */
201 if (opt_loglevel >= SR_LOG_INFO)
202 printf(" %-20s %s\n", "", dec->desc);
211 void show_supported_wiki(void)
214 printf("Error, libsigrokdecode support not compiled in.");
218 struct srd_decoder *dec;
220 if (srd_init(NULL) != SRD_OK)
223 srd_decoder_load_all();
224 sl = g_slist_copy((GSList *)srd_decoder_list());
225 sl = g_slist_sort(sl, sort_pds);
227 printf("== Supported protocol decoders ==\n\n");
229 printf("<!-- Generated via sigrok-cli --list-supported-wiki. -->\n\n");
231 printf("Number of currently supported protocol decoders: "
232 "'''%d'''.\n\n", g_slist_length(sl));
234 printf("{| border=\"0\" style=\"font-size: smaller\" "
235 "class=\"alternategrey sortable sigroktable\"\n"
236 "|-\n!Protocol\n!Tags\n!Input IDs\n!Output IDs\n!Status\n"
237 "!Full name\n!Description\n\n");
239 for (l = sl; l; l = l->next) {
242 #if DECODERS_HAVE_TAGS
243 GString *tags = g_string_new(NULL);
244 for (GSList *t = dec->tags; t; t = t->next)
245 g_string_append_printf(tags, "%s, ", (char *)t->data);
247 g_string_truncate(tags, tags->len - 2);
250 GString *in = g_string_new(NULL);
251 for (GSList *t = dec->inputs; t; t = t->next)
252 g_string_append_printf(in, "%s, ", (char *)t->data);
254 g_string_append_printf(in, "—");
256 g_string_truncate(in, in->len - 2);
258 GString *out = g_string_new(NULL);
259 for (GSList *t = dec->outputs; t; t = t->next)
260 g_string_append_printf(out, "%s, ", (char *)t->data);
262 g_string_append_printf(out, "—");
264 g_string_truncate(out, out->len - 2);
266 #if DECODERS_HAVE_TAGS
267 printf("{{pd|%s|%s|%s|%s|%s|%s|%s|supported}}\n",
268 dec->id, dec->name, dec->longname, dec->desc,
269 tags->str, in->str, out->str);
271 printf("{{pd|%s|%s|%s|%s|%s|%s|supported}}\n",
272 dec->id, dec->name, dec->longname, dec->desc,
276 #if DECODERS_HAVE_TAGS
277 g_string_free(tags, TRUE);
279 g_string_free(in, TRUE);
280 g_string_free(out, TRUE);
289 static gint sort_channels(gconstpointer a, gconstpointer b)
291 const struct sr_channel *pa = a, *pb = b;
293 return pa->index - pb->index;
296 static void print_dev_line(const struct sr_dev_inst *sdi)
298 struct sr_channel *ch;
299 GSList *sl, *l, *channels;
302 struct sr_dev_driver *driver;
303 const char *vendor, *model, *version, *sernum;
305 driver = sr_dev_inst_driver_get(sdi);
306 vendor = sr_dev_inst_vendor_get(sdi);
307 model = sr_dev_inst_model_get(sdi);
308 version = sr_dev_inst_version_get(sdi);
309 sernum = sr_dev_inst_sernum_get(sdi);
310 channels = sr_dev_inst_channels_get(sdi);
312 s = g_string_sized_new(128);
313 g_string_assign(s, driver->name);
314 if (maybe_config_get(driver, sdi, NULL, SR_CONF_CONN, &gvar) == SR_OK) {
315 g_string_append(s, ":conn=");
316 g_string_append(s, g_variant_get_string(gvar, NULL));
317 g_variant_unref(gvar);
319 g_string_append(s, " - ");
320 if (vendor && vendor[0])
321 g_string_append_printf(s, "%s ", vendor);
322 if (model && model[0])
323 g_string_append_printf(s, "%s ", model);
324 if (version && version[0])
325 g_string_append_printf(s, "%s ", version);
326 if (sernum && sernum[0])
327 g_string_append_printf(s, "[S/N: %s] ", sernum);
329 if (g_slist_length(channels) == 1) {
331 g_string_append_printf(s, "with 1 channel: %s", ch->name);
333 sl = g_slist_sort(g_slist_copy(channels), sort_channels);
334 g_string_append_printf(s, "with %d channels:", g_slist_length(sl));
335 for (l = sl; l; l = l->next) {
337 g_string_append_printf(s, " %s", ch->name);
342 g_string_append_printf(s, "\n");
343 printf("%s", s->str);
344 g_string_free(s, TRUE);
348 void show_dev_list(void)
350 struct sr_dev_inst *sdi;
353 if (!(devices = device_scan()))
356 printf("The following devices were found:\n");
357 for (l = devices; l; l = l->next) {
361 g_slist_free(devices);
365 void show_drv_detail(struct sr_dev_driver *driver)
367 const struct sr_key_info *srci;
371 if ((opts = sr_dev_options(driver, NULL, NULL))) {
373 printf("Driver functions:\n");
374 for (i = 0; i < opts->len; i++) {
375 if (!(srci = sr_key_info_get(SR_KEY_CONFIG,
376 g_array_index(opts, uint32_t, i))))
378 printf(" %s\n", srci->name);
381 g_array_free(opts, TRUE);
384 if ((opts = sr_driver_scan_options_list(driver))) {
386 printf("Scan options:\n");
387 for (i = 0; i < opts->len; i++) {
388 if (!(srci = sr_key_info_get(SR_KEY_CONFIG,
389 g_array_index(opts, uint32_t, i))))
391 printf(" %s\n", srci->id);
394 g_array_free(opts, TRUE);
398 void show_dev_detail(void)
400 struct sr_dev_driver *driver_from_opt, *driver;
401 struct sr_dev_inst *sdi;
402 const struct sr_key_info *srci, *srmqi, *srmqfi;
403 struct sr_channel *ch;
404 struct sr_channel_group *channel_group, *cg;
405 GSList *devices, *cgl, *chl, *channel_groups;
406 GVariant *gvar_dict, *gvar_list, *gvar;
408 double dlow, dhigh, dcur_low, dcur_high;
409 const uint64_t *uint64;
410 uint64_t cur_rate, rate;
411 uint64_t p = 0, q = 0, low = 0, high = 0;
412 uint64_t tmp_uint64, mask, cur_low, cur_high, cur_p, cur_q;
414 const int32_t *int32;
415 uint32_t key, o, cur_mq, mq;
416 uint64_t cur_mqflags, mqflags;
417 unsigned int num_devices, i, j;
418 char *tmp_str, *s, c;
419 const char **stropts;
421 gboolean have_tmp_flt, have_curr;
422 const double *fltopts;
424 if (parse_driver(opt_drv, &driver_from_opt, NULL)) {
425 /* A driver was specified, report driver-wide options now. */
426 show_drv_detail(driver_from_opt);
429 if (!(devices = device_scan())) {
430 g_critical("No devices found.");
434 num_devices = g_slist_length(devices);
435 if (num_devices > 1) {
436 g_critical("%d devices found. Use --scan to show them, "
437 "and select one to show.", num_devices);
442 g_slist_free(devices);
445 driver = sr_dev_inst_driver_get(sdi);
446 channel_groups = sr_dev_inst_channel_groups_get(sdi);
448 if (sr_dev_open(sdi) != SR_OK) {
449 g_critical("Failed to open device.");
454 * Selected channels and channel group may affect which options are
455 * returned, or which values for them.
457 select_channels(sdi);
458 channel_group = lookup_channel_group(sdi, NULL);
460 if (!(opts = sr_dev_options(driver, sdi, channel_group)))
461 /* Driver supports no device instance options. */
464 if (channel_groups) {
465 printf("Channel groups:\n");
466 for (cgl = channel_groups; cgl; cgl = cgl->next) {
468 printf(" %s: ", cg->name);
469 if (g_slist_length(cg->channels) == 0)
470 printf("No channels");
472 printf("channel%s", g_slist_length(cg->channels) > 1 ? "s" : "");
473 for (chl = cg->channels; chl; chl = chl->next) {
475 printf(" %s", ch->name);
481 printf("Supported configuration options");
482 if (channel_groups) {
484 printf(" across all channel groups");
486 printf(" on channel group %s", channel_group->name);
489 for (o = 0; o < opts->len; o++) {
490 key = g_array_index(opts, uint32_t, o);
491 if (!(srci = sr_key_info_get(SR_KEY_CONFIG, key)))
494 if (key == SR_CONF_TRIGGER_MATCH) {
495 if (maybe_config_list(driver, sdi, channel_group, key,
496 &gvar_list) != SR_OK) {
500 int32 = g_variant_get_fixed_array(gvar_list,
501 &num_elements, sizeof(int32_t));
502 printf(" Supported triggers: ");
503 for (i = 0; i < num_elements; i++) {
505 case SR_TRIGGER_ZERO:
511 case SR_TRIGGER_RISING:
514 case SR_TRIGGER_FALLING:
517 case SR_TRIGGER_EDGE:
520 case SR_TRIGGER_OVER:
523 case SR_TRIGGER_UNDER:
534 g_variant_unref(gvar_list);
536 } else if (key == SR_CONF_LIMIT_SAMPLES
537 && (sr_dev_config_capabilities_list(sdi, NULL, key)
540 * If implemented in config_list(), this denotes the
541 * maximum number of samples a device can send. This
542 * really applies only to logic analyzers, and then
543 * only to those that don't support compression, or
544 * have it turned off by default. The values returned
545 * are the low/high limits.
547 if (sr_config_list(driver, sdi, channel_group, key,
549 g_variant_get(gvar, "(tt)", &low, &high);
550 g_variant_unref(gvar);
551 printf(" Maximum number of samples: %"PRIu64"\n", high);
554 } else if (key == SR_CONF_SAMPLERATE) {
555 /* Supported samplerates */
556 printf(" %s", srci->id);
558 if (maybe_config_get(driver, sdi, channel_group,
559 SR_CONF_SAMPLERATE, &gvar) == SR_OK) {
560 if (g_variant_is_of_type(gvar, G_VARIANT_TYPE_UINT64))
561 cur_rate = g_variant_get_uint64(gvar);
562 g_variant_unref(gvar);
564 if (maybe_config_list(driver, sdi, channel_group, SR_CONF_SAMPLERATE,
565 &gvar_dict) != SR_OK) {
569 if ((gvar_list = g_variant_lookup_value(gvar_dict,
570 "samplerates", G_VARIANT_TYPE("at")))) {
571 uint64 = g_variant_get_fixed_array(gvar_list,
572 &num_elements, sizeof(uint64_t));
573 printf(" - supported samplerates:\n");
574 for (i = 0; i < num_elements; i++) {
576 s = sr_samplerate_string(rate);
580 if (rate == cur_rate)
581 printf(" (current)");
585 g_variant_unref(gvar_list);
586 } else if ((gvar_list = g_variant_lookup_value(gvar_dict,
587 "samplerate-steps", G_VARIANT_TYPE("at")))) {
588 uint64 = g_variant_get_fixed_array(gvar_list,
589 &num_elements, sizeof(uint64_t));
591 if (!(s = sr_samplerate_string(uint64[0])))
596 if (!(s = sr_samplerate_string(uint64[1])))
601 if (!(s = sr_samplerate_string(uint64[2])))
603 printf(" in steps of %s)\n", s);
605 g_variant_unref(gvar_list);
607 g_variant_unref(gvar_dict);
609 } else if (srci->datatype == SR_T_UINT64) {
610 printf(" %s: ", srci->id);
612 if (maybe_config_get(driver, sdi, channel_group, key,
614 tmp_uint64 = g_variant_get_uint64(gvar);
615 g_variant_unref(gvar);
618 if (maybe_config_list(driver, sdi, channel_group,
619 key, &gvar_list) != SR_OK) {
621 /* Can't list it, but we have a value to show. */
622 printf("%"PRIu64" (current)", tmp_uint64);
627 uint64 = g_variant_get_fixed_array(gvar_list,
628 &num_elements, sizeof(uint64_t));
629 printf(" - supported values:\n");
630 for (i = 0; i < num_elements; i++) {
631 printf(" %"PRIu64, uint64[i]);
632 if (gvar && tmp_uint64 == uint64[i])
633 printf(" (current)");
636 g_variant_unref(gvar_list);
638 } else if (srci->datatype == SR_T_STRING) {
639 printf(" %s: ", srci->id);
640 if (maybe_config_get(driver, sdi, channel_group, key,
642 tmp_str = g_strdup(g_variant_get_string(gvar, NULL));
643 g_variant_unref(gvar);
647 if (maybe_config_list(driver, sdi, channel_group, key,
650 /* Can't list it, but we have a value to show. */
651 printf("%s (current)", tmp_str);
658 stropts = g_variant_get_strv(gvar, &num_elements);
659 for (i = 0; i < num_elements; i++) {
662 printf("%s", stropts[i]);
663 if (tmp_str && !strcmp(tmp_str, stropts[i]))
664 printf(" (current)");
669 g_variant_unref(gvar);
671 } else if (srci->datatype == SR_T_UINT64_RANGE) {
672 printf(" %s: ", srci->id);
673 if (maybe_config_list(driver, sdi, channel_group, key,
674 &gvar_list) != SR_OK) {
679 if (maybe_config_get(driver, sdi, channel_group, key, &gvar) == SR_OK) {
680 g_variant_get(gvar, "(tt)", &cur_low, &cur_high);
681 g_variant_unref(gvar);
687 num_elements = g_variant_n_children(gvar_list);
688 for (i = 0; i < num_elements; i++) {
689 gvar = g_variant_get_child_value(gvar_list, i);
690 g_variant_get(gvar, "(tt)", &low, &high);
691 g_variant_unref(gvar);
694 printf("%"PRIu64"-%"PRIu64, low, high);
695 if (low == cur_low && high == cur_high)
696 printf(" (current)");
699 g_variant_unref(gvar_list);
701 } else if (srci->datatype == SR_T_BOOL) {
702 printf(" %s: ", srci->id);
703 if (maybe_config_get(driver, sdi, channel_group, key,
705 if (g_variant_get_boolean(gvar))
706 printf("on (current), off\n");
708 printf("on, off (current)\n");
709 g_variant_unref(gvar);
713 } else if (srci->datatype == SR_T_DOUBLE_RANGE) {
714 printf(" %s: ", srci->id);
715 if (maybe_config_list(driver, sdi, channel_group, key,
716 &gvar_list) != SR_OK) {
722 if (maybe_config_get(driver, sdi, channel_group, key, &gvar) == SR_OK) {
723 g_variant_get(gvar, "(dd)", &dcur_low, &dcur_high);
724 g_variant_unref(gvar);
728 num_elements = g_variant_n_children(gvar_list);
729 for (i = 0; i < num_elements; i++) {
730 gvar = g_variant_get_child_value(gvar_list, i);
731 g_variant_get(gvar, "(dd)", &dlow, &dhigh);
732 g_variant_unref(gvar);
735 printf("%.1f-%.1f", dlow, dhigh);
738 if (dlow == dcur_low && dhigh == dcur_high)
739 printf(" (current)");
742 g_variant_unref(gvar_list);
744 } else if (srci->datatype == SR_T_FLOAT) {
745 printf(" %s: ", srci->id);
747 have_tmp_flt = FALSE;
748 if (maybe_config_get(driver, sdi, channel_group, key,
750 tmp_flt = g_variant_get_double(gvar);
752 g_variant_unref(gvar);
754 if (maybe_config_list(driver, sdi, channel_group, key,
757 /* Can't list, but got a value to show. */
758 printf("%f (current)", tmp_flt);
763 fltopts = g_variant_get_fixed_array(gvar,
764 &num_elements, sizeof(tmp_flt));
765 for (i = 0; i < num_elements; i++) {
768 printf("%f", fltopts[i]);
769 if (have_tmp_flt && fltopts[i] == tmp_flt)
770 printf(" (current)");
773 g_variant_unref(gvar);
775 } else if (srci->datatype == SR_T_RATIONAL_PERIOD
776 || srci->datatype == SR_T_RATIONAL_VOLT) {
777 printf(" %s", srci->id);
778 if (maybe_config_get(driver, sdi, channel_group, key,
780 g_variant_get(gvar, "(tt)", &cur_p, &cur_q);
781 g_variant_unref(gvar);
785 if (maybe_config_list(driver, sdi, channel_group,
786 key, &gvar_list) != SR_OK) {
790 printf(" - supported values:\n");
791 num_elements = g_variant_n_children(gvar_list);
792 for (i = 0; i < num_elements; i++) {
793 gvar = g_variant_get_child_value(gvar_list, i);
794 g_variant_get(gvar, "(tt)", &p, &q);
795 if (srci->datatype == SR_T_RATIONAL_PERIOD)
796 s = sr_period_string(p, q);
798 s = sr_voltage_string(p, q);
801 if (p == cur_p && q == cur_q)
802 printf(" (current)");
805 g_variant_unref(gvar_list);
807 } else if (srci->datatype == SR_T_MQ) {
808 printf(" %s: ", srci->id);
809 if (maybe_config_get(driver, sdi, channel_group, key,
811 && g_variant_is_of_type(gvar, G_VARIANT_TYPE_TUPLE)
812 && g_variant_n_children(gvar) == 2) {
813 g_variant_get(gvar, "(ut)", &cur_mq, &cur_mqflags);
814 g_variant_unref(gvar);
816 cur_mq = cur_mqflags = 0;
818 if (maybe_config_list(driver, sdi, channel_group,
819 key, &gvar_list) != SR_OK) {
823 printf(" - supported measurements:\n");
824 num_elements = g_variant_n_children(gvar_list);
825 for (i = 0; i < num_elements; i++) {
827 gvar = g_variant_get_child_value(gvar_list, i);
828 g_variant_get(gvar, "(ut)", &mq, &mqflags);
829 if ((srmqi = sr_key_info_get(SR_KEY_MQ, mq)))
830 printf("%s", srmqi->id);
833 for (j = 0, mask = 1; j < 32; j++, mask <<= 1) {
834 if (!(mqflags & mask))
836 if ((srmqfi = sr_key_info_get(SR_KEY_MQFLAGS, mqflags & mask)))
837 printf("/%s", srmqfi->id);
839 printf("/%" PRIu64, mqflags & mask);
841 if (mq == cur_mq && mqflags == cur_mqflags)
842 printf(" (current)");
845 g_variant_unref(gvar_list);
849 /* Everything else */
850 printf(" %s\n", srci->id);
853 g_array_free(opts, TRUE);
860 static void show_pd_detail_single(const char *pd)
862 struct srd_decoder *dec;
863 struct srd_decoder_option *o;
864 struct srd_channel *pdch;
865 struct srd_decoder_annotation_row *r;
868 char **pdtokens, **pdtok, *optsep, **ann, **bin, *val, *doc, *str;
870 pdtokens = g_strsplit(pd, ",", -1);
871 for (pdtok = pdtokens; *pdtok; pdtok++) {
873 if ((optsep = strchr(*pdtok, ':')))
875 if (!(dec = srd_decoder_get_by_id(*pdtok))) {
876 g_critical("Protocol decoder %s not found.", *pdtok);
879 printf("ID: %s\nName: %s\nLong name: %s\nDescription: %s\n",
880 dec->id, dec->name, dec->longname, dec->desc);
881 printf("License: %s\n", dec->license);
882 printf("Possible decoder input IDs:\n");
884 for (l = dec->inputs; l; l = l->next) {
886 printf("- %s\n", str);
891 printf("Possible decoder output IDs:\n");
893 for (l = dec->outputs; l; l = l->next) {
895 printf("- %s\n", str);
900 printf("Decoder tags:\n");
901 #if DECODERS_HAVE_TAGS
903 for (l = dec->tags; l; l = l->next) {
905 printf("- %s\n", str);
911 printf("Annotation classes:\n");
912 if (dec->annotations) {
913 for (l = dec->annotations; l; l = l->next) {
915 printf("- %s: %s\n", ann[0], ann[1]);
920 printf("Annotation rows:\n");
921 if (dec->annotation_rows) {
922 for (l = dec->annotation_rows; l; l = l->next) {
924 printf("- %s (%s): ", r->id, r->desc);
925 for (ll = r->ann_classes; ll; ll = ll->next) {
926 idx = GPOINTER_TO_INT(ll->data);
927 ann = g_slist_nth_data(dec->annotations, idx);
928 printf("%s", ann[0]);
937 printf("Binary classes:\n");
939 for (l = dec->binary; l; l = l->next) {
941 printf("- %s: %s\n", bin[0], bin[1]);
946 printf("Required channels:\n");
948 for (l = dec->channels; l; l = l->next) {
950 printf("- %s (%s): %s\n",
951 pdch->id, pdch->name, pdch->desc);
956 printf("Optional channels:\n");
957 if (dec->opt_channels) {
958 for (l = dec->opt_channels; l; l = l->next) {
960 printf("- %s (%s): %s\n",
961 pdch->id, pdch->name, pdch->desc);
966 printf("Options:\n");
968 for (l = dec->options; l; l = l->next) {
970 printf("- %s: %s (", o->id, o->desc);
971 for (ol = o->values; ol; ol = ol->next) {
972 val = g_variant_print(ol->data, FALSE);
976 val = g_variant_print(o->def, FALSE);
977 printf("default %s)\n", val);
983 if ((doc = srd_decoder_doc_get(dec))) {
984 printf("Documentation:\n%s\n",
985 doc[0] == '\n' ? doc + 1 : doc);
990 g_strfreev(pdtokens);
993 void show_pd_detail(void)
995 for (int i = 0; opt_pds[i]; i++)
996 show_pd_detail_single(opt_pds[i]);
1000 void show_input(void)
1002 const struct sr_input_module *imod;
1003 const struct sr_option **opts;
1008 tok = g_strsplit(opt_input_format, ":", 0);
1009 if (!tok[0] || !(imod = sr_input_find(tok[0])))
1010 g_critical("Input module '%s' not found.", opt_input_format);
1012 printf("ID: %s\nName: %s\n", sr_input_id_get(imod),
1013 sr_input_name_get(imod));
1014 printf("Description: %s\n", sr_input_description_get(imod));
1015 if ((opts = sr_input_options_get(imod))) {
1016 printf("Options:\n");
1017 for (i = 0; opts[i]; i++) {
1018 printf(" %s: %s", opts[i]->id, opts[i]->desc);
1020 s = g_variant_print(opts[i]->def, FALSE);
1021 printf(" (default %s", s);
1023 if (opts[i]->values) {
1024 printf(", possible values ");
1025 for (l = opts[i]->values; l; l = l->next) {
1026 s = g_variant_print((GVariant *)l->data, FALSE);
1027 printf("%s%s", s, l->next ? ", " : "");
1035 sr_input_options_free(opts);
1040 void show_output(void)
1042 const struct sr_output_module *omod;
1043 const struct sr_option **opts;
1048 tok = g_strsplit(opt_output_format, ":", 0);
1049 if (!tok[0] || !(omod = sr_output_find(tok[0])))
1050 g_critical("Output module '%s' not found.", opt_output_format);
1052 printf("ID: %s\nName: %s\n", sr_output_id_get(omod),
1053 sr_output_name_get(omod));
1054 printf("Description: %s\n", sr_output_description_get(omod));
1055 if ((opts = sr_output_options_get(omod))) {
1056 printf("Options:\n");
1057 for (i = 0; opts[i]; i++) {
1058 printf(" %s: %s", opts[i]->id, opts[i]->desc);
1060 s = g_variant_print(opts[i]->def, FALSE);
1061 printf(" (default %s", s);
1063 if (opts[i]->values) {
1064 printf(", possible values ");
1065 for (l = opts[i]->values; l; l = l->next) {
1066 s = g_variant_print((GVariant *)l->data, FALSE);
1067 printf("%s%s", s, l->next ? ", " : "");
1075 sr_output_options_free(opts);
1080 void show_transform(void)
1082 const struct sr_transform_module *tmod;
1083 const struct sr_option **opts;
1088 tok = g_strsplit(opt_transform_module, ":", 0);
1089 if (!tok[0] || !(tmod = sr_transform_find(tok[0])))
1090 g_critical("Transform module '%s' not found.", opt_transform_module);
1092 printf("ID: %s\nName: %s\n", sr_transform_id_get(tmod),
1093 sr_transform_name_get(tmod));
1094 printf("Description: %s\n", sr_transform_description_get(tmod));
1095 if ((opts = sr_transform_options_get(tmod))) {
1096 printf("Options:\n");
1097 for (i = 0; opts[i]; i++) {
1098 printf(" %s: %s", opts[i]->id, opts[i]->desc);
1100 s = g_variant_print(opts[i]->def, FALSE);
1101 printf(" (default %s", s);
1103 if (opts[i]->values) {
1104 printf(", possible values ");
1105 for (l = opts[i]->values; l; l = l->next) {
1106 s = g_variant_print((GVariant *)l->data, FALSE);
1107 printf("%s%s", s, l->next ? ", " : "");
1115 sr_transform_options_free(opts);
1120 static void print_serial_port(gpointer data, gpointer user_data)
1122 struct sr_serial_port *port;
1124 port = (void *)data;
1126 printf(" %s\t%s\n", port->name, port->description);
1129 void show_serial_ports(void)
1131 GSList *serial_ports;
1133 serial_ports = sr_serial_list(NULL);
1137 printf("Available serial/HID/BT/BLE ports:\n");
1138 g_slist_foreach(serial_ports, print_serial_port, NULL);
1139 g_slist_free_full(serial_ports, (GDestroyNotify)sr_serial_free);