HACKING: catch up with libsigrok docs (mem alloc, var decl)
[sigrok-cli/gsi.git] / sigrok-cli.h
blob684aed99a8bd302da3ae8d88f6ff9e9be94ee867
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 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);
119 /* anykey.c */
120 void add_anykey(struct sr_session *session);
121 void clear_anykey(void);
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_ann_class;
144 extern gboolean opt_pd_samplenum;
145 extern gboolean opt_pd_jsontrace;
146 #endif
147 extern gchar *opt_input_format;
148 extern gchar *opt_output_format;
149 extern gchar *opt_transform_module;
150 extern gboolean opt_show;
151 extern gchar *opt_time;
152 extern gchar *opt_samples;
153 extern gchar *opt_frames;
154 extern gboolean opt_continuous;
155 extern gchar **opt_gets;
156 extern gboolean opt_set;
157 extern gboolean opt_list_serial;
158 int parse_options(int argc, char **argv);
159 void show_help(void);
161 #endif