]>
Commit | Line | Data |
---|---|---|
cd62e027 JS |
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 | ||
d486cbdd | 20 | #include <config.h> |
cd62e027 | 21 | #include <glib.h> |
662a1e27 | 22 | #include "sigrok-cli.h" |
cd62e027 JS |
23 | |
24 | gboolean opt_version = FALSE; | |
6293db8a | 25 | gboolean opt_list_supported = FALSE; |
c45dd41c | 26 | gboolean opt_list_supported_wiki = FALSE; |
cd62e027 JS |
27 | gint opt_loglevel = SR_LOG_WARN; /* Show errors+warnings by default. */ |
28 | gboolean opt_scan_devs = FALSE; | |
b20ea789 | 29 | gboolean opt_dont_scan = FALSE; |
cd62e027 JS |
30 | gboolean opt_wait_trigger = FALSE; |
31 | gchar *opt_input_file = NULL; | |
32 | gchar *opt_output_file = NULL; | |
33 | gchar *opt_drv = NULL; | |
6c94f0c1 | 34 | gchar **opt_configs = NULL; |
cd62e027 JS |
35 | gchar *opt_channels = NULL; |
36 | gchar *opt_channel_group = NULL; | |
37 | gchar *opt_triggers = NULL; | |
551f570c | 38 | gchar **opt_pds = NULL; |
cd62e027 | 39 | #ifdef HAVE_SRD |
cd62e027 JS |
40 | gchar *opt_pd_annotations = NULL; |
41 | gchar *opt_pd_meta = NULL; | |
42 | gchar *opt_pd_binary = NULL; | |
625606db | 43 | gboolean opt_pd_ann_class = FALSE; |
08e9378b | 44 | gboolean opt_pd_samplenum = FALSE; |
54614916 | 45 | gboolean opt_pd_jsontrace = FALSE; |
cd62e027 JS |
46 | #endif |
47 | gchar *opt_input_format = NULL; | |
48 | gchar *opt_output_format = NULL; | |
6f7b4c5d | 49 | gchar *opt_transform_module = NULL; |
2620358a | 50 | gboolean opt_show = FALSE; |
cd62e027 JS |
51 | gchar *opt_time = NULL; |
52 | gchar *opt_samples = NULL; | |
53 | gchar *opt_frames = NULL; | |
2620358a | 54 | gboolean opt_continuous = FALSE; |
323368a2 | 55 | gchar **opt_gets = NULL; |
2620358a | 56 | gboolean opt_set = FALSE; |
56fc0d6d | 57 | gboolean opt_list_serial = FALSE; |
cd62e027 | 58 | |
f0f54487 UH |
59 | /* |
60 | * Defines a callback function that generates an error if an | |
61 | * option occurs twice. | |
62 | */ | |
0894b972 JS |
63 | #define CHECK_ONCE(option) \ |
64 | static gboolean check_ ## option \ | |
65 | (const gchar *option_name, const gchar *value, \ | |
66 | gpointer data, GError **error) \ | |
67 | { \ | |
68 | (void)data; \ | |
69 | \ | |
70 | static gboolean seen = FALSE; \ | |
71 | if (seen) { \ | |
72 | g_set_error(error, G_OPTION_ERROR, G_OPTION_ERROR_FAILED, \ | |
73 | "superfluous option \"%s\"", option_name); \ | |
74 | return FALSE; \ | |
75 | } \ | |
76 | \ | |
77 | option = g_strdup(value); \ | |
78 | seen = TRUE; \ | |
79 | return TRUE; \ | |
80 | } | |
81 | ||
82 | CHECK_ONCE(opt_drv) | |
0894b972 JS |
83 | CHECK_ONCE(opt_input_format) |
84 | CHECK_ONCE(opt_output_format) | |
6f7b4c5d | 85 | CHECK_ONCE(opt_transform_module) |
0894b972 JS |
86 | CHECK_ONCE(opt_channels) |
87 | CHECK_ONCE(opt_channel_group) | |
88 | CHECK_ONCE(opt_triggers) | |
89 | #ifdef HAVE_SRD | |
0894b972 JS |
90 | CHECK_ONCE(opt_pd_annotations) |
91 | CHECK_ONCE(opt_pd_meta) | |
92 | CHECK_ONCE(opt_pd_binary) | |
93 | #endif | |
94 | CHECK_ONCE(opt_time) | |
95 | CHECK_ONCE(opt_samples) | |
96 | CHECK_ONCE(opt_frames) | |
97 | ||
98 | #undef CHECK_STR_ONCE | |
99 | ||
44ac7614 JS |
100 | static gchar **input_file_array = NULL; |
101 | static gchar **output_file_array = NULL; | |
102 | ||
cd62e027 JS |
103 | static const GOptionEntry optargs[] = { |
104 | {"version", 'V', 0, G_OPTION_ARG_NONE, &opt_version, | |
6293db8a UH |
105 | "Show version", NULL}, |
106 | {"list-supported", 'L', 0, G_OPTION_ARG_NONE, &opt_list_supported, | |
107 | "List supported devices/modules/decoders", NULL}, | |
c45dd41c UH |
108 | {"list-supported-wiki", 0, 0, G_OPTION_ARG_NONE, &opt_list_supported_wiki, |
109 | "List supported decoders (MediaWiki)", NULL}, | |
cd62e027 JS |
110 | {"loglevel", 'l', 0, G_OPTION_ARG_INT, &opt_loglevel, |
111 | "Set loglevel (5 is most verbose)", NULL}, | |
0894b972 | 112 | {"driver", 'd', 0, G_OPTION_ARG_CALLBACK, &check_opt_drv, |
cd62e027 | 113 | "The driver to use", NULL}, |
6c94f0c1 | 114 | {"config", 'c', 0, G_OPTION_ARG_STRING_ARRAY, &opt_configs, |
cd62e027 | 115 | "Specify device configuration options", NULL}, |
44ac7614 | 116 | {"input-file", 'i', 0, G_OPTION_ARG_FILENAME_ARRAY, &input_file_array, |
cd62e027 | 117 | "Load input from file", NULL}, |
0894b972 | 118 | {"input-format", 'I', 0, G_OPTION_ARG_CALLBACK, &check_opt_input_format, |
cd62e027 | 119 | "Input format", NULL}, |
44ac7614 | 120 | {"output-file", 'o', 0, G_OPTION_ARG_FILENAME_ARRAY, &output_file_array, |
cd62e027 | 121 | "Save output to file", NULL}, |
0894b972 | 122 | {"output-format", 'O', 0, G_OPTION_ARG_CALLBACK, &check_opt_output_format, |
cd62e027 | 123 | "Output format", NULL}, |
6f7b4c5d UH |
124 | {"transform-module", 'T', 0, G_OPTION_ARG_CALLBACK, &check_opt_transform_module, |
125 | "Transform module", NULL}, | |
0894b972 | 126 | {"channels", 'C', 0, G_OPTION_ARG_CALLBACK, &check_opt_channels, |
cd62e027 | 127 | "Channels to use", NULL}, |
0894b972 | 128 | {"channel-group", 'g', 0, G_OPTION_ARG_CALLBACK, &check_opt_channel_group, |
cd62e027 | 129 | "Channel groups", NULL}, |
0894b972 | 130 | {"triggers", 't', 0, G_OPTION_ARG_CALLBACK, &check_opt_triggers, |
cd62e027 JS |
131 | "Trigger configuration", NULL}, |
132 | {"wait-trigger", 'w', 0, G_OPTION_ARG_NONE, &opt_wait_trigger, | |
133 | "Wait for trigger", NULL}, | |
134 | #ifdef HAVE_SRD | |
551f570c | 135 | {"protocol-decoders", 'P', 0, G_OPTION_ARG_STRING_ARRAY, &opt_pds, |
cd62e027 | 136 | "Protocol decoders to run", NULL}, |
0894b972 | 137 | {"protocol-decoder-annotations", 'A', 0, G_OPTION_ARG_CALLBACK, &check_opt_pd_annotations, |
cd62e027 | 138 | "Protocol decoder annotation(s) to show", NULL}, |
0894b972 | 139 | {"protocol-decoder-meta", 'M', 0, G_OPTION_ARG_CALLBACK, &check_opt_pd_meta, |
cd62e027 | 140 | "Protocol decoder meta output to show", NULL}, |
0894b972 | 141 | {"protocol-decoder-binary", 'B', 0, G_OPTION_ARG_CALLBACK, &check_opt_pd_binary, |
cd62e027 | 142 | "Protocol decoder binary output to show", NULL}, |
625606db SS |
143 | {"protocol-decoder-ann-class", 0, 0, G_OPTION_ARG_NONE, &opt_pd_ann_class, |
144 | "Show annotation class in decoder output", NULL}, | |
08e9378b | 145 | {"protocol-decoder-samplenum", 0, 0, G_OPTION_ARG_NONE, &opt_pd_samplenum, |
bf5d7c77 | 146 | "Show sample numbers in decoder output", NULL}, |
54614916 GS |
147 | {"protocol-decoder-jsontrace", 0, 0, G_OPTION_ARG_NONE, &opt_pd_jsontrace, |
148 | "Output in Google Trace Event format (JSON)", NULL}, | |
cd62e027 JS |
149 | #endif |
150 | {"scan", 0, 0, G_OPTION_ARG_NONE, &opt_scan_devs, | |
151 | "Scan for devices", NULL}, | |
b20ea789 GS |
152 | {"dont-scan", 'D', 0, G_OPTION_ARG_NONE, &opt_dont_scan, |
153 | "Don't auto-scan (use -d spec only)", NULL}, | |
cd62e027 | 154 | {"show", 0, 0, G_OPTION_ARG_NONE, &opt_show, |
96d09211 | 155 | "Show device/format/decoder details", NULL}, |
0894b972 | 156 | {"time", 0, 0, G_OPTION_ARG_CALLBACK, &check_opt_time, |
cd62e027 | 157 | "How long to sample (ms)", NULL}, |
0894b972 | 158 | {"samples", 0, 0, G_OPTION_ARG_CALLBACK, &check_opt_samples, |
cd62e027 | 159 | "Number of samples to acquire", NULL}, |
0894b972 | 160 | {"frames", 0, 0, G_OPTION_ARG_CALLBACK, &check_opt_frames, |
cd62e027 JS |
161 | "Number of frames to acquire", NULL}, |
162 | {"continuous", 0, 0, G_OPTION_ARG_NONE, &opt_continuous, | |
163 | "Sample continuously", NULL}, | |
323368a2 GS |
164 | {"get", 0, 0, G_OPTION_ARG_STRING_ARRAY, &opt_gets, |
165 | "Get device options only", NULL}, | |
cd62e027 | 166 | {"set", 0, 0, G_OPTION_ARG_NONE, &opt_set, "Set device options only", NULL}, |
a360511e | 167 | {"list-serial", 0, 0, G_OPTION_ARG_NONE, &opt_list_serial, "List available serial/HID/BT/BLE ports", NULL}, |
cd62e027 JS |
168 | {NULL, 0, 0, 0, NULL, NULL, NULL} |
169 | }; | |
170 | ||
f0f54487 UH |
171 | /* |
172 | * Parses the command line and sets all the 'opt_...' variables. | |
173 | * Returns zero on success, non-zero otherwise. | |
174 | */ | |
cd62e027 JS |
175 | int parse_options(int argc, char **argv) |
176 | { | |
177 | GError *error = NULL; | |
178 | GOptionContext *context = g_option_context_new(NULL); | |
179 | int ret = 1; | |
180 | ||
181 | g_option_context_add_main_entries(context, optargs, NULL); | |
182 | ||
183 | if (!g_option_context_parse(context, &argc, &argv, &error)) { | |
184 | g_critical("%s", error->message); | |
185 | goto done; | |
186 | } | |
187 | ||
44ac7614 JS |
188 | /* |
189 | * Because of encoding issues with filenames (mentioned in the glib | |
190 | * documentation), we don't check them with a callback function, but | |
191 | * collect them into arrays and then check if the arrays contain at | |
192 | * most one element. | |
193 | */ | |
194 | if (NULL != input_file_array) { | |
195 | if (NULL != input_file_array[0] && NULL != input_file_array[1]) { | |
196 | g_critical("option \"--input-file/-i\" only allowed once"); | |
197 | goto done; | |
198 | } | |
199 | opt_input_file = g_strdup(input_file_array[0]); | |
200 | } | |
201 | ||
202 | if (NULL != output_file_array) { | |
203 | if (NULL != output_file_array[0] && NULL != output_file_array[1]) { | |
204 | g_critical("option \"--output-file/-o\" only allowed once"); | |
205 | goto done; | |
206 | } | |
207 | opt_output_file = g_strdup(output_file_array[0]); | |
208 | } | |
209 | ||
41ce2cbb JS |
210 | if (1 != argc) { |
211 | g_critical("superfluous command line argument \"%s\"", argv[1]); | |
212 | goto done; | |
213 | } | |
214 | ||
cd62e027 JS |
215 | ret = 0; |
216 | ||
217 | done: | |
218 | g_option_context_free(context); | |
44ac7614 JS |
219 | g_strfreev(input_file_array); |
220 | g_strfreev(output_file_array); | |
221 | input_file_array = NULL; | |
222 | output_file_array = NULL; | |
cd62e027 JS |
223 | |
224 | return ret; | |
225 | } | |
226 | ||
227 | void show_help(void) | |
228 | { | |
229 | GOptionContext *context = g_option_context_new(NULL); | |
230 | g_option_context_add_main_entries(context, optargs, NULL); | |
231 | ||
232 | char *help = g_option_context_get_help(context, TRUE, NULL); | |
233 | printf("%s", help); | |
234 | g_free(help); | |
235 | ||
236 | g_option_context_free(context); | |
65c1ecf9 GS |
237 | |
238 | #ifdef HAVE_SRD | |
239 | #define SHOW_DECODER_TEXT "| -P <decoder> " | |
240 | #else | |
241 | #define SHOW_DECODER_TEXT "" | |
242 | #endif | |
243 | printf("Example use, typical options:\n"); | |
244 | printf(" -d <driver> --scan\n"); | |
245 | printf(" -d <driver> { --samples N | --frames N | --time T | --continuous }\n"); | |
246 | printf(" { -d <driver> | -I <format> | -O <format> %s} --show\n", SHOW_DECODER_TEXT); | |
247 | printf(" See the manpage or the wiki for more details.\n"); | |
248 | printf(" Note: --samples/--frames/--time/--continuous is required for acquisition.\n"); | |
cd62e027 | 249 | } |