X-Git-Url: https://sigrok.org/gitweb/?p=libsigrokdecode.git;a=blobdiff_plain;f=libsigrokdecode-internal.h;h=6fb590cff7ce8d4c5d1139aee9ca8b7eee44214e;hp=600b9fd1e186f76b31212b28802add2a50c0313e;hb=9553e9622bb26dfbe6296ef6f330b1cf0f5b40e6;hpb=2994587f98f205bb8847554bd28483532b277f2c;ds=sidebyside diff --git a/libsigrokdecode-internal.h b/libsigrokdecode-internal.h index 600b9fd..6fb590c 100644 --- a/libsigrokdecode-internal.h +++ b/libsigrokdecode-internal.h @@ -15,50 +15,131 @@ * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + * along with this program; if not, see . */ #ifndef LIBSIGROKDECODE_LIBSIGROKDECODE_INTERNAL_H #define LIBSIGROKDECODE_LIBSIGROKDECODE_INTERNAL_H +/* Use the stable ABI subset as per PEP 384. */ +#define Py_LIMITED_API 0x03020000 + +#include /* First, so we avoid a _POSIX_C_SOURCE warning. */ #include "libsigrokdecode.h" -/*--- controller.c ----------------------------------------------------------*/ +enum { + SRD_TERM_HIGH, + SRD_TERM_LOW, + SRD_TERM_RISING_EDGE, + SRD_TERM_FALLING_EDGE, + SRD_TERM_EITHER_EDGE, + SRD_TERM_NO_EDGE, + SRD_TERM_SKIP, +}; + +struct srd_term { + int type; + int channel; + uint64_t num_samples_to_skip; + uint64_t num_samples_already_skipped; +}; + +/* Custom Python types: */ + +typedef struct { + PyObject_HEAD + struct srd_decoder_inst *di; + uint64_t abs_start_samplenum; + unsigned int itercnt; + uint8_t *inbuf; + uint64_t inbuflen; + PyObject *sample; +} srd_logic; + +struct srd_session { + int session_id; + /* List of decoder instances. */ + GSList *di_list; + + /* List of frontend callbacks to receive decoder output. */ + GSList *callbacks; +}; + +/* srd.c */ SRD_PRIV int srd_decoder_searchpath_add(const char *path); -SRD_PRIV struct srd_decoder_inst *srd_inst_find_by_obj(const GSList *stack, - const PyObject *obj); -SRD_PRIV int srd_inst_start(struct srd_decoder_inst *di, PyObject *args); -SRD_PRIV int srd_inst_decode(uint64_t start_samplenum, - const struct srd_decoder_inst *dec, - const uint8_t *inbuf, uint64_t inbuflen); + +/* session.c */ +SRD_PRIV int session_is_valid(struct srd_session *sess); +SRD_PRIV struct srd_pd_callback *srd_pd_output_callback_find(struct srd_session *sess, + int output_type); + +/* instance.c */ +SRD_PRIV struct srd_decoder_inst *srd_inst_find_by_obj( const GSList *stack, + const PyObject *obj); +SRD_PRIV int srd_inst_start(struct srd_decoder_inst *di); +SRD_PRIV void match_array_free(struct srd_decoder_inst *di); +SRD_PRIV void condition_list_free(struct srd_decoder_inst *di); +SRD_PRIV int srd_inst_decode(struct srd_decoder_inst *di, + uint64_t abs_start_samplenum, uint64_t abs_end_samplenum, + const uint8_t *inbuf, uint64_t inbuflen, uint64_t unitsize); +SRD_PRIV int process_samples_until_condition_match(struct srd_decoder_inst *di, gboolean *found_match); +SRD_PRIV int srd_inst_terminate_reset(struct srd_decoder_inst *di); SRD_PRIV void srd_inst_free(struct srd_decoder_inst *di); -SRD_PRIV void srd_inst_free_all(GSList *stack); -SRD_PRIV struct srd_pd_callback *srd_pd_output_callback_find(int output_type); -SRD_PRIV int srd_inst_pd_output_add(struct srd_decoder_inst *di, - int output_type, const char *output_id); +SRD_PRIV void srd_inst_free_all(struct srd_session *sess); -/*--- exception.c -----------------------------------------------------------*/ +/* log.c */ +#if defined(G_OS_WIN32) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4)) +/* + * On MinGW, we need to specify the gnu_printf format flavor or GCC + * will assume non-standard Microsoft printf syntax. + */ +SRD_PRIV int srd_log(int loglevel, const char *format, ...) + __attribute__((__format__ (__gnu_printf__, 2, 3))); +#else +SRD_PRIV int srd_log(int loglevel, const char *format, ...) G_GNUC_PRINTF(2, 3); +#endif + +#define srd_spew(...) srd_log(SRD_LOG_SPEW, __VA_ARGS__) +#define srd_dbg(...) srd_log(SRD_LOG_DBG, __VA_ARGS__) +#define srd_info(...) srd_log(SRD_LOG_INFO, __VA_ARGS__) +#define srd_warn(...) srd_log(SRD_LOG_WARN, __VA_ARGS__) +#define srd_err(...) srd_log(SRD_LOG_ERR, __VA_ARGS__) -SRD_PRIV void srd_exception_catch(const char *format, ...); +/* decoder.c */ +SRD_PRIV long srd_decoder_apiver(const struct srd_decoder *d); -/*--- log.c -----------------------------------------------------------------*/ +/* type_decoder.c */ +SRD_PRIV PyObject *srd_Decoder_type_new(void); -SRD_PRIV int srd_log(int loglevel, const char *format, ...); -SRD_PRIV int srd_spew(const char *format, ...); -SRD_PRIV int srd_dbg(const char *format, ...); -SRD_PRIV int srd_info(const char *format, ...); -SRD_PRIV int srd_warn(const char *format, ...); -SRD_PRIV int srd_err(const char *format, ...); +/* type_logic.c */ +SRD_PRIV PyObject *srd_logic_type_new(void); -/*--- util.c ----------------------------------------------------------------*/ +/* module_sigrokdecode.c */ +PyMODINIT_FUNC PyInit_sigrokdecode(void); -SRD_PRIV int py_attr_as_str(const PyObject *py_obj, const char *attr, - char **outstr); -SRD_PRIV int py_dictitem_as_str(const PyObject *py_obj, const char *key, - char **outstr); -SRD_PRIV int py_str_as_str(const PyObject *py_str, char **outstr); -SRD_PRIV int py_strlist_to_char(const PyObject *py_strlist, char ***outstr); +/* util.c */ +SRD_PRIV PyObject *py_import_by_name(const char *name); +SRD_PRIV int py_attr_as_str(PyObject *py_obj, const char *attr, char **outstr); +SRD_PRIV int py_attr_as_strlist(PyObject *py_obj, const char *attr, GSList **outstrlist); +SRD_PRIV int py_dictitem_as_str(PyObject *py_obj, const char *key, char **outstr); +SRD_PRIV int py_listitem_as_str(PyObject *py_obj, Py_ssize_t idx, char **outstr); +SRD_PRIV int py_pydictitem_as_str(PyObject *py_obj, PyObject *py_key, char **outstr); +SRD_PRIV int py_pydictitem_as_long(PyObject *py_obj, PyObject *py_key, uint64_t *out); +SRD_PRIV int py_str_as_str(PyObject *py_str, char **outstr); +SRD_PRIV int py_strseq_to_char(PyObject *py_strseq, char ***out_strv); +SRD_PRIV GVariant *py_obj_to_variant(PyObject *py_obj); + +/* exception.c */ +#if defined(G_OS_WIN32) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4)) +/* + * On MinGW, we need to specify the gnu_printf format flavor or GCC + * will assume non-standard Microsoft printf syntax. + */ +SRD_PRIV void srd_exception_catch(const char *format, ...) + __attribute__((__format__ (__gnu_printf__, 1, 2))); +#else +SRD_PRIV void srd_exception_catch(const char *format, ...) G_GNUC_PRINTF(1, 2); +#endif #endif