]> sigrok.org Git - sigrok-cli.git/blob - sigrok-cli.h
doc: update sigrok-cli(1) for channel assignment to decoder inputs
[sigrok-cli.git] / sigrok-cli.h
1 /*
2  * This file is part of the sigrok-cli project.
3  *
4  * Copyright (C) 2011 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 #ifndef SIGROK_CLI_SIGROK_CLI_H
21 #define SIGROK_CLI_SIGROK_CLI_H
22
23 #ifdef HAVE_SRD
24 /* First, so we avoid a _POSIX_C_SOURCE warning. */
25 #include <libsigrokdecode/libsigrokdecode.h>
26 #endif
27 #include <libsigrok/libsigrok.h>
28
29 #define DEFAULT_OUTPUT_FORMAT_FILE "srzip"
30 #define DEFAULT_OUTPUT_FORMAT_NOFILE "bits:width=64"
31
32 /* main.c */
33 extern struct sr_context *sr_ctx;
34 int select_channels(struct sr_dev_inst *sdi);
35 int maybe_config_get(struct sr_dev_driver *driver,
36                 const struct sr_dev_inst *sdi, struct sr_channel_group *cg,
37                 uint32_t key, GVariant **gvar);
38 int maybe_config_set(struct sr_dev_driver *driver,
39                 const struct sr_dev_inst *sdi, struct sr_channel_group *cg,
40                 uint32_t key, GVariant *gvar);
41 int maybe_config_list(struct sr_dev_driver *driver,
42                 const struct sr_dev_inst *sdi, struct sr_channel_group *cg,
43                 uint32_t key, GVariant **gvar);
44
45 /* show.c */
46 void show_version(void);
47 void show_supported(void);
48 void show_supported_wiki(void);
49 void show_dev_list(void);
50 void show_dev_detail(void);
51 void show_pd_detail(void);
52 void show_input(void);
53 void show_output(void);
54 void show_transform(void);
55 void show_serial_ports(void);
56
57 /* device.c */
58 GSList *device_scan(void);
59 struct sr_channel_group *lookup_channel_group(struct sr_dev_inst *sdi,
60         const char *cg_name);
61
62 /* session.c */
63 struct df_arg_desc {
64         struct sr_session *session;
65         int do_props;
66         struct input_stream_props {
67                 uint64_t samplerate;
68                 GSList *channels;
69                 const struct sr_channel *first_analog_channel;
70                 size_t unitsize;
71                 uint64_t sample_count_logic;
72                 uint64_t sample_count_analog;
73                 uint64_t frame_count;
74                 uint64_t triggered;
75         } props;
76 };
77 void datafeed_in(const struct sr_dev_inst *sdi,
78                 const struct sr_datafeed_packet *packet, void *cb_data);
79 int opt_to_gvar(char *key, char *value, struct sr_config *src);
80 int set_dev_options_array(struct sr_dev_inst *sdi, char **opts);
81 int set_dev_options(struct sr_dev_inst *sdi, GHashTable *args);
82 void run_session(void);
83
84 /* input.c */
85 void load_input_file(gboolean do_props);
86
87 /* output.c */
88 int setup_binary_stdout(void);
89
90 /* decode.c */
91 #ifdef HAVE_SRD
92 extern uint64_t pd_samplerate;
93 int register_pds(gchar **all_pds, char *opt_pd_annotations);
94 int setup_pd_annotations(char *opt_pd_annotations);
95 int setup_pd_meta(char *opt_pd_meta);
96 int setup_pd_binary(char *opt_pd_binary);
97 void show_pd_annotations(struct srd_proto_data *pdata, void *cb_data);
98 void show_pd_meta(struct srd_proto_data *pdata, void *cb_data);
99 void show_pd_binary(struct srd_proto_data *pdata, void *cb_data);
100 void show_pd_prepare(void);
101 void show_pd_close(void);
102 void map_pd_channels(struct sr_dev_inst *sdi);
103 #endif
104
105 /* parsers.c */
106 struct sr_channel *find_channel(GSList *channellist, const char *channelname);
107 GSList *parse_channelstring(struct sr_dev_inst *sdi, const char *channelstring);
108 int parse_triggerstring(const struct sr_dev_inst *sdi, const char *s,
109                 struct sr_trigger **trigger);
110 GHashTable *parse_generic_arg(const char *arg,
111                 gboolean sep_first, const char *key_first);
112 GHashTable *generic_arg_to_opt(const struct sr_option **opts, GHashTable *genargs);
113 GSList *check_unknown_keys(const struct sr_option **avail, GHashTable *used);
114 gboolean warn_unknown_keys(const struct sr_option **avail, GHashTable *used,
115                 const char *caption);
116 int canon_cmp(const char *str1, const char *str2);
117 int parse_driver(char *arg, struct sr_dev_driver **driver, GSList **drvopts);
118
119 /* anykey.c */
120 void add_anykey(struct sr_session *session);
121 void clear_anykey(void);
122
123 /* options.c */
124 extern gboolean opt_version;
125 extern gboolean opt_list_supported;
126 extern gboolean opt_list_supported_wiki;
127 extern gint opt_loglevel;
128 extern gboolean opt_scan_devs;
129 extern gboolean opt_dont_scan;
130 extern gboolean opt_wait_trigger;
131 extern gchar *opt_input_file;
132 extern gchar *opt_output_file;
133 extern gchar *opt_drv;
134 extern gchar **opt_configs;
135 extern gchar *opt_channels;
136 extern gchar *opt_channel_group;
137 extern gchar *opt_triggers;
138 extern gchar **opt_pds;
139 #ifdef HAVE_SRD
140 extern gchar *opt_pd_annotations;
141 extern gchar *opt_pd_meta;
142 extern gchar *opt_pd_binary;
143 extern gboolean opt_pd_samplenum;
144 extern gboolean opt_pd_jsontrace;
145 #endif
146 extern gchar *opt_input_format;
147 extern gchar *opt_output_format;
148 extern gchar *opt_transform_module;
149 extern gboolean opt_show;
150 extern gchar *opt_time;
151 extern gchar *opt_samples;
152 extern gchar *opt_frames;
153 extern gboolean opt_continuous;
154 extern gchar **opt_gets;
155 extern gboolean opt_set;
156 extern gboolean opt_list_serial;
157 int parse_options(int argc, char **argv);
158 void show_help(void);
159
160 #endif