doc: update sigrok-cli(1) for channel assignment to decoder inputs
[sigrok-cli/gsi.git] / sigrok-cli.h
blobb33b076bd1f82824d284395ed7ca4267fd3b516c
1 /*
2 * This file is part of the sigrok-cli project.
4 * Copyright (C) 2011 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/>.
20 #ifndef SIGROK_CLI_SIGROK_CLI_H
21 #define SIGROK_CLI_SIGROK_CLI_H
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>
29 #define DEFAULT_OUTPUT_FORMAT_FILE "srzip"
30 #define DEFAULT_OUTPUT_FORMAT_NOFILE "bits:width=64"
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);
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);
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);
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;
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);
84 /* input.c */
85 void load_input_file(gboolean do_props);
87 /* output.c */
88 int setup_binary_stdout(void);
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
105 /* parsers.c */
106 struct sr_channel *find_channel(GSList *channellist, const char *channelname,
107 gboolean exact_case);
108 GSList *parse_channelstring(struct sr_dev_inst *sdi, const char *channelstring);
109 int parse_triggerstring(const struct sr_dev_inst *sdi, const char *s,
110 struct sr_trigger **trigger);
111 GHashTable *parse_generic_arg(const char *arg,
112 gboolean sep_first, const char *key_first);
113 GHashTable *generic_arg_to_opt(const struct sr_option **opts, GHashTable *genargs);
114 GSList *check_unknown_keys(const struct sr_option **avail, GHashTable *used);
115 gboolean warn_unknown_keys(const struct sr_option **avail, GHashTable *used,
116 const char *caption);
117 int canon_cmp(const char *str1, const char *str2);
118 int parse_driver(char *arg, struct sr_dev_driver **driver, GSList **drvopts);
120 /* anykey.c */
121 void add_anykey(struct sr_session *session);
122 void clear_anykey(void);
124 /* options.c */
125 extern gboolean opt_version;
126 extern gboolean opt_list_supported;
127 extern gboolean opt_list_supported_wiki;
128 extern gint opt_loglevel;
129 extern gboolean opt_scan_devs;
130 extern gboolean opt_dont_scan;
131 extern gboolean opt_wait_trigger;
132 extern gchar *opt_input_file;
133 extern gchar *opt_output_file;
134 extern gchar *opt_drv;
135 extern gchar **opt_configs;
136 extern gchar *opt_channels;
137 extern gchar *opt_channel_group;
138 extern gchar *opt_triggers;
139 extern gchar **opt_pds;
140 #ifdef HAVE_SRD
141 extern gchar *opt_pd_annotations;
142 extern gchar *opt_pd_meta;
143 extern gchar *opt_pd_binary;
144 extern gboolean opt_pd_ann_class;
145 extern gboolean opt_pd_samplenum;
146 extern gboolean opt_pd_jsontrace;
147 #endif
148 extern gchar *opt_input_format;
149 extern gchar *opt_output_format;
150 extern gchar *opt_transform_module;
151 extern gboolean opt_show;
152 extern gchar *opt_time;
153 extern gchar *opt_samples;
154 extern gchar *opt_frames;
155 extern gboolean opt_continuous;
156 extern gchar **opt_gets;
157 extern gboolean opt_set;
158 extern gboolean opt_list_serial;
159 int parse_options(int argc, char **argv);
160 void show_help(void);
162 #endif