Check library initialization before handling decoders
[libsigrokdecode.git] / libsigrokdecode-internal.h
1 /*
2  * This file is part of the libsigrokdecode project.
3  *
4  * Copyright (C) 2011 Uwe Hermann <uwe@hermann-uwe.de>
5  * Copyright (C) 2012 Bert Vermeulen <bert@biot.com>
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
20  */
21
22 #ifndef LIBSIGROKDECODE_LIBSIGROKDECODE_INTERNAL_H
23 #define LIBSIGROKDECODE_LIBSIGROKDECODE_INTERNAL_H
24
25 #include "libsigrokdecode.h"
26
27 struct srd_session {
28         int session_id;
29
30         /* List of decoder instances. */
31         GSList *di_list;
32
33         /* List of frontend callbacks to receive decoder output. */
34         GSList *callbacks;
35 };
36
37
38 /* srd.c */
39 SRD_PRIV int srd_decoder_searchpath_add(const char *path);
40 SRD_PRIV gboolean srd_check_init(void);
41
42 /* session.c */
43 SRD_PRIV int session_is_valid(struct srd_session *sess);
44 SRD_PRIV struct srd_pd_callback *srd_pd_output_callback_find(struct srd_session *sess,
45                 int output_type);
46
47 /* instance.c */
48 SRD_PRIV struct srd_decoder_inst *srd_inst_find_by_obj( const GSList *stack,
49                 const PyObject *obj);
50 SRD_PRIV int srd_inst_start(struct srd_decoder_inst *di);
51 SRD_PRIV int srd_inst_decode(const struct srd_decoder_inst *di,
52                 uint64_t start_samplenum, uint64_t end_samplenum,
53                 const uint8_t *inbuf, uint64_t inbuflen);
54 SRD_PRIV void srd_inst_free(struct srd_decoder_inst *di);
55 SRD_PRIV void srd_inst_free_all(struct srd_session *sess, GSList *stack);
56
57 /* log.c */
58 SRD_PRIV int srd_log(int loglevel, const char *format, ...);
59 SRD_PRIV int srd_spew(const char *format, ...);
60 SRD_PRIV int srd_dbg(const char *format, ...);
61 SRD_PRIV int srd_info(const char *format, ...);
62 SRD_PRIV int srd_warn(const char *format, ...);
63 SRD_PRIV int srd_err(const char *format, ...);
64
65 /* util.c */
66 SRD_PRIV int py_attr_as_str(const PyObject *py_obj, const char *attr,
67         char **outstr);
68 SRD_PRIV int py_dictitem_as_str(const PyObject *py_obj, const char *key,
69         char **outstr);
70 SRD_PRIV int py_str_as_str(const PyObject *py_str, char **outstr);
71 SRD_PRIV int py_strlist_to_char(const PyObject *py_strlist, char ***outstr);
72
73 /* exception.c */
74 SRD_PRIV void srd_exception_catch(const char *format, ...);
75
76 #endif