]> sigrok.org Git - libsigrok.git/blame - libsigrok-internal.h
Add new software trigger as a library-wide facility.
[libsigrok.git] / libsigrok-internal.h
CommitLineData
1483577e 1/*
50985c20 2 * This file is part of the libsigrok project.
1483577e 3 *
13d8e03c 4 * Copyright (C) 2013 Bert Vermeulen <bert@biot.com>
1483577e
UH
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
04cb9157
MH
20/** @file
21 * @internal
22 */
23
a5827886
UH
24#ifndef LIBSIGROK_LIBSIGROK_INTERNAL_H
25#define LIBSIGROK_LIBSIGROK_INTERNAL_H
1483577e 26
b08024a8 27#include <stdarg.h>
cc8a7d25 28#include <glib.h>
1a081ca6 29#include "config.h" /* Needed for HAVE_LIBUSB_1_0 and others. */
69890f73
UH
30#ifdef HAVE_LIBUSB_1_0
31#include <libusb.h>
32#endif
c4f2dfd0 33#ifdef HAVE_LIBSERIALPORT
dc991353 34#include <libserialport.h>
c4f2dfd0 35#endif
b08024a8 36
393fb9cb
UH
37/**
38 * @file
39 *
40 * libsigrok private header file, only to be used internally.
41 */
42
4cea9eb2
UH
43/*--- Macros ----------------------------------------------------------------*/
44
45#ifndef ARRAY_SIZE
46#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
47#endif
48
49#ifndef ARRAY_AND_SIZE
50#define ARRAY_AND_SIZE(a) (a), ARRAY_SIZE(a)
51#endif
52
a4f9c35b
AJ
53/**
54 * Read a 8 bits integer out of memory.
55 * @param x a pointer to the input memory
56 * @return the corresponding integer
57 */
58#define R8(x) ((unsigned)((const uint8_t*)(x))[0])
59
e28ef28a
AJ
60/**
61 * Read a 16 bits big endian integer out of memory.
62 * @param x a pointer to the input memory
63 * @return the corresponding integer
64 */
79a1176b
AJ
65#define RB16(x) (((unsigned)((const uint8_t*)(x))[0] << 8) | \
66 (unsigned)((const uint8_t*)(x))[1])
e28ef28a
AJ
67
68/**
69 * Read a 16 bits little endian integer out of memory.
70 * @param x a pointer to the input memory
71 * @return the corresponding integer
72 */
79a1176b
AJ
73#define RL16(x) (((unsigned)((const uint8_t*)(x))[1] << 8) | \
74 (unsigned)((const uint8_t*)(x))[0])
e28ef28a
AJ
75
76/**
77 * Read a 32 bits big endian integer out of memory.
78 * @param x a pointer to the input memory
79 * @return the corresponding integer
80 */
79a1176b
AJ
81#define RB32(x) (((unsigned)((const uint8_t*)(x))[0] << 24) | \
82 ((unsigned)((const uint8_t*)(x))[1] << 16) | \
83 ((unsigned)((const uint8_t*)(x))[2] << 8) | \
84 (unsigned)((const uint8_t*)(x))[3])
e28ef28a
AJ
85
86/**
87 * Read a 32 bits little endian integer out of memory.
88 * @param x a pointer to the input memory
89 * @return the corresponding integer
90 */
79a1176b
AJ
91#define RL32(x) (((unsigned)((const uint8_t*)(x))[3] << 24) | \
92 ((unsigned)((const uint8_t*)(x))[2] << 16) | \
93 ((unsigned)((const uint8_t*)(x))[1] << 8) | \
94 (unsigned)((const uint8_t*)(x))[0])
e28ef28a 95
ea2d6d99
AJ
96/**
97 * Write a 8 bits integer to memory.
98 * @param p a pointer to the output memory
99 * @param x the input integer
100 */
101#define W8(p, x) do { ((uint8_t*)(p))[0] = (uint8_t) (x); } while(0)
102
103/**
104 * Write a 16 bits integer to memory stored as big endian.
105 * @param p a pointer to the output memory
106 * @param x the input integer
107 */
108#define WB16(p, x) do { ((uint8_t*)(p))[1] = (uint8_t) (x); \
109 ((uint8_t*)(p))[0] = (uint8_t)((x)>>8); } while(0)
110
111/**
112 * Write a 16 bits integer to memory stored as little endian.
113 * @param p a pointer to the output memory
114 * @param x the input integer
115 */
116#define WL16(p, x) do { ((uint8_t*)(p))[0] = (uint8_t) (x); \
117 ((uint8_t*)(p))[1] = (uint8_t)((x)>>8); } while(0)
118
119/**
120 * Write a 32 bits integer to memory stored as big endian.
121 * @param p a pointer to the output memory
122 * @param x the input integer
123 */
124#define WB32(p, x) do { ((uint8_t*)(p))[3] = (uint8_t) (x); \
125 ((uint8_t*)(p))[2] = (uint8_t)((x)>>8); \
126 ((uint8_t*)(p))[1] = (uint8_t)((x)>>16); \
127 ((uint8_t*)(p))[0] = (uint8_t)((x)>>24); } while(0)
128
129/**
130 * Write a 32 bits integer to memory stored as little endian.
131 * @param p a pointer to the output memory
132 * @param x the input integer
133 */
134#define WL32(p, x) do { ((uint8_t*)(p))[0] = (uint8_t) (x); \
135 ((uint8_t*)(p))[1] = (uint8_t)((x)>>8); \
136 ((uint8_t*)(p))[2] = (uint8_t)((x)>>16); \
137 ((uint8_t*)(p))[3] = (uint8_t)((x)>>24); } while(0)
138
6bf4273e
UH
139/* Portability fixes for FreeBSD. */
140#ifdef __FreeBSD__
141#define LIBUSB_CLASS_APPLICATION 0xfe
142#define libusb_handle_events_timeout_completed(ctx, tv, c) \
143 libusb_handle_events_timeout(ctx, tv)
144#endif
145
b8072700 146struct sr_context {
785b9ff2
PS
147#ifdef HAVE_LIBUSB_1_0
148 libusb_context *libusb_ctx;
6640324f 149 gboolean usb_source_present;
5321ac6b
ML
150#ifdef _WIN32
151 GThread *usb_thread;
152 gboolean usb_thread_running;
153 GMutex usb_mutex;
154 HANDLE usb_event;
155 GPollFD usb_pollfd;
144f6660 156 sr_receive_data_callback usb_cb;
5321ac6b
ML
157 void *usb_cb_data;
158#endif
785b9ff2 159#endif
b8072700
PS
160};
161
69890f73 162#ifdef HAVE_LIBUSB_1_0
04cb9157 163/** USB device instance */
d68e2d1a 164struct sr_usb_dev_inst {
98582bf5
BV
165 /** USB bus */
166 uint8_t bus;
167 /** Device address on USB bus */
168 uint8_t address;
169 /** libusb device handle */
170 struct libusb_device_handle *devhdl;
69890f73
UH
171};
172#endif
173
c4f2dfd0 174#ifdef HAVE_LIBSERIALPORT
a9bce5a5
ML
175#define SERIAL_PARITY_NONE SP_PARITY_NONE
176#define SERIAL_PARITY_EVEN SP_PARITY_EVEN
177#define SERIAL_PARITY_ODD SP_PARITY_ODD
d68e2d1a 178struct sr_serial_dev_inst {
98582bf5
BV
179 /** Port name, e.g. '/dev/tty42'. */
180 char *port;
181 /** Comm params for serial_set_paramstr(). */
182 char *serialcomm;
183 /** Port is non-blocking. */
9647ce69 184 int nonblocking;
98582bf5
BV
185 /** libserialport port handle */
186 struct sp_port *data;
ba1949f5
ML
187 /** libserialport event set */
188 struct sp_event_set *event_set;
189 /** GPollFDs for event polling */
190 GPollFD *pollfds;
69890f73 191};
c4f2dfd0 192#endif
69890f73 193
ae67644f
ML
194struct sr_usbtmc_dev_inst {
195 char *device;
196 int fd;
197};
198
026c822d
UH
199/* Private driver context. */
200struct drv_context {
98582bf5
BV
201 /** sigrok context */
202 struct sr_context *sr_ctx;
026c822d
UH
203 GSList *instances;
204};
205
48a486cd
BV
206/*--- log.c -----------------------------------------------------------------*/
207
208SR_PRIV int sr_log(int loglevel, const char *format, ...);
209SR_PRIV int sr_spew(const char *format, ...);
210SR_PRIV int sr_dbg(const char *format, ...);
211SR_PRIV int sr_info(const char *format, ...);
212SR_PRIV int sr_warn(const char *format, ...);
213SR_PRIV int sr_err(const char *format, ...);
214
3544f848
ML
215/* Message logging helpers with subsystem-specific prefix string. */
216#ifndef NO_LOG_WRAPPERS
217#define sr_log(l, s, args...) sr_log(l, "%s: " s, LOG_PREFIX, ## args)
218#define sr_spew(s, args...) sr_spew("%s: " s, LOG_PREFIX, ## args)
219#define sr_dbg(s, args...) sr_dbg("%s: " s, LOG_PREFIX, ## args)
220#define sr_info(s, args...) sr_info("%s: " s, LOG_PREFIX, ## args)
221#define sr_warn(s, args...) sr_warn("%s: " s, LOG_PREFIX, ## args)
222#define sr_err(s, args...) sr_err("%s: " s, LOG_PREFIX, ## args)
223#endif
224
48a486cd
BV
225/*--- device.c --------------------------------------------------------------*/
226
f3ca73ed 227/** Values for the changes argument of sr_dev_driver.config_channel_set. */
2a854d71 228enum {
fca75cbb 229 /** The enabled state of the channel has been changed. */
3f239f08 230 SR_CHANNEL_SET_ENABLED = 1 << 0,
2a854d71
DE
231};
232
56d0d245 233SR_PRIV struct sr_channel *sr_channel_new(int index, int type,
48a486cd
BV
234 gboolean enabled, const char *name);
235
236/* Generic device instances */
237SR_PRIV struct sr_dev_inst *sr_dev_inst_new(int index, int status,
238 const char *vendor, const char *model, const char *version);
239SR_PRIV void sr_dev_inst_free(struct sr_dev_inst *sdi);
48a486cd 240
545f9786 241#ifdef HAVE_LIBUSB_1_0
69890f73 242/* USB-specific instances */
d68e2d1a 243SR_PRIV struct sr_usb_dev_inst *sr_usb_dev_inst_new(uint8_t bus,
69890f73 244 uint8_t address, struct libusb_device_handle *hdl);
d68e2d1a 245SR_PRIV void sr_usb_dev_inst_free(struct sr_usb_dev_inst *usb);
69890f73
UH
246#endif
247
c4f2dfd0 248#ifdef HAVE_LIBSERIALPORT
69890f73 249/* Serial-specific instances */
299bdb24
BV
250SR_PRIV struct sr_serial_dev_inst *sr_serial_dev_inst_new(const char *port,
251 const char *serialcomm);
d68e2d1a 252SR_PRIV void sr_serial_dev_inst_free(struct sr_serial_dev_inst *serial);
c4f2dfd0 253#endif
69890f73 254
ae67644f
ML
255/* USBTMC-specific instances */
256SR_PRIV struct sr_usbtmc_dev_inst *sr_usbtmc_dev_inst_new(const char *device);
257SR_PRIV void sr_usbtmc_dev_inst_free(struct sr_usbtmc_dev_inst *usbtmc);
b08024a8 258
c09f0b57 259/*--- hwdriver.c ------------------------------------------------------------*/
996b0c72 260
93a04e3b 261SR_PRIV void sr_hw_cleanup_all(void);
bc1c2f00 262SR_PRIV struct sr_config *sr_config_new(int key, GVariant *data);
722db131 263SR_PRIV void sr_config_free(struct sr_config *src);
48a486cd
BV
264SR_PRIV int sr_source_remove(int fd);
265SR_PRIV int sr_source_add(int fd, int events, int timeout,
144f6660 266 sr_receive_data_callback cb, void *cb_data);
996b0c72 267
a1645fcd
BV
268/*--- session.c -------------------------------------------------------------*/
269
e2b23821
UH
270struct sr_session {
271 /** List of struct sr_dev pointers. */
272 GSList *devs;
273 /** List of struct datafeed_callback pointers. */
274 GSList *datafeed_callbacks;
7b5e6d29 275 struct sr_trigger *trigger;
e2b23821
UH
276 GTimeVal starttime;
277 gboolean running;
278
279 unsigned int num_sources;
280
281 /*
282 * Both "sources" and "pollfds" are of the same size and contain pairs
283 * of descriptor and callback function. We can not embed the GPollFD
284 * into the source struct since we want to be able to pass the array
285 * of all poll descriptors to g_poll().
286 */
287 struct source *sources;
288 GPollFD *pollfds;
289 int source_timeout;
290
291 /*
292 * These are our synchronization primitives for stopping the session in
293 * an async fashion. We need to make sure the session is stopped from
294 * within the session thread itself.
295 */
98582bf5
BV
296 /** Mutex protecting access to abort_session. */
297 GMutex stop_mutex;
298 /** Abort current session. See sr_session_stop(). */
e2b23821
UH
299 gboolean abort_session;
300};
301
de4d3f99 302SR_PRIV int sr_session_send(const struct sr_dev_inst *sdi,
ae5859ff 303 const struct sr_datafeed_packet *packet);
33c6e4c5 304SR_PRIV int sr_session_stop_sync(void);
f438e0c9 305SR_PRIV int sr_sessionfile_check(const char *filename);
7b5e6d29 306SR_PRIV struct sr_trigger *sr_session_trigger_get(void);
a1645fcd 307
063e7aef
UH
308/*--- std.c -----------------------------------------------------------------*/
309
144f6660
UH
310typedef int (*dev_close_callback)(struct sr_dev_inst *sdi);
311typedef void (*std_dev_clear_callback)(void *priv);
cd2f0fe2 312
f6beaac5 313SR_PRIV int std_init(struct sr_context *sr_ctx, struct sr_dev_driver *di,
ae5859ff 314 const char *prefix);
c4f2dfd0 315#ifdef HAVE_LIBSERIALPORT
23dc6661 316SR_PRIV int std_serial_dev_open(struct sr_dev_inst *sdi);
d43b0908 317SR_PRIV int std_serial_dev_acquisition_stop(struct sr_dev_inst *sdi,
144f6660 318 void *cb_data, dev_close_callback dev_close_fn,
ae5859ff 319 struct sr_serial_dev_inst *serial, const char *prefix);
c4f2dfd0 320#endif
4afdfd46 321SR_PRIV int std_session_send_df_header(const struct sr_dev_inst *sdi,
ae5859ff
BV
322 const char *prefix);
323SR_PRIV int std_dev_clear(const struct sr_dev_driver *driver,
144f6660 324 std_dev_clear_callback clear_private);
043e899a 325SR_PRIV int std_serial_dev_close(struct sr_dev_inst *sdi);
4afdfd46 326
8d558c7a
UH
327/*--- strutil.c -------------------------------------------------------------*/
328
329SR_PRIV int sr_atol(const char *str, long *ret);
330SR_PRIV int sr_atoi(const char *str, int *ret);
331SR_PRIV int sr_atod(const char *str, double *ret);
332SR_PRIV int sr_atof(const char *str, float *ret);
9806c2d5 333SR_PRIV int sr_atof_ascii(const char *str, float *ret);
8d558c7a 334
ac136b57
BV
335/*--- soft-trigger.c --------------------------------------------------------*/
336
337struct soft_trigger_logic {
338 const struct sr_dev_inst *sdi;
339 const struct sr_trigger *trigger;
340 int count;
341 int unitsize;
342 int cur_stage;
343 uint8_t *prev_sample;
344};
345
346SR_PRIV struct soft_trigger_logic *soft_trigger_logic_new(
347 const struct sr_dev_inst *sdi, struct sr_trigger *trigger);
348SR_PRIV void soft_trigger_logic_free(struct soft_trigger_logic *st);
349SR_PRIV int soft_trigger_logic_check(struct soft_trigger_logic *st, uint8_t *buf,
350 int len);
351
058b7035
UH
352/*--- hardware/common/serial.c ----------------------------------------------*/
353
c4f2dfd0 354#ifdef HAVE_LIBSERIALPORT
a54dd31e
UH
355enum {
356 SERIAL_RDWR = 1,
357 SERIAL_RDONLY = 2,
358 SERIAL_NONBLOCK = 4,
359};
360
144f6660 361typedef gboolean (*packet_valid_callback)(const uint8_t *buf);
766456be 362
299bdb24
BV
363SR_PRIV int serial_open(struct sr_serial_dev_inst *serial, int flags);
364SR_PRIV int serial_close(struct sr_serial_dev_inst *serial);
365SR_PRIV int serial_flush(struct sr_serial_dev_inst *serial);
366SR_PRIV int serial_write(struct sr_serial_dev_inst *serial,
367 const void *buf, size_t count);
9a474211
ML
368SR_PRIV int serial_write_blocking(struct sr_serial_dev_inst *serial,
369 const void *buf, size_t count);
370SR_PRIV int serial_write_nonblocking(struct sr_serial_dev_inst *serial,
371 const void *buf, size_t count);
299bdb24
BV
372SR_PRIV int serial_read(struct sr_serial_dev_inst *serial, void *buf,
373 size_t count);
9a474211
ML
374SR_PRIV int serial_read_blocking(struct sr_serial_dev_inst *serial, void *buf,
375 size_t count);
376SR_PRIV int serial_read_nonblocking(struct sr_serial_dev_inst *serial, void *buf,
377 size_t count);
299bdb24 378SR_PRIV int serial_set_params(struct sr_serial_dev_inst *serial, int baudrate,
71caaad4 379 int bits, int parity, int stopbits, int flowcontrol, int rts, int dtr);
299bdb24
BV
380SR_PRIV int serial_set_paramstr(struct sr_serial_dev_inst *serial,
381 const char *paramstr);
382SR_PRIV int serial_readline(struct sr_serial_dev_inst *serial, char **buf,
383 int *buflen, gint64 timeout_ms);
766456be
UH
384SR_PRIV int serial_stream_detect(struct sr_serial_dev_inst *serial,
385 uint8_t *buf, size_t *buflen,
144f6660
UH
386 size_t packet_size,
387 packet_valid_callback is_valid,
766456be 388 uint64_t timeout_ms, int baudrate);
1bd9e678
DJ
389SR_PRIV int sr_serial_extract_options(GSList *options, const char **serial_device,
390 const char **serial_options);
abc4b335 391SR_PRIV int serial_source_add(struct sr_serial_dev_inst *serial, int events,
144f6660 392 int timeout, sr_receive_data_callback cb, void *cb_data);
7faa3e88 393SR_PRIV int serial_source_remove(struct sr_serial_dev_inst *serial);
b541f837 394SR_PRIV GSList *sr_serial_find_usb(uint16_t vendor_id, uint16_t product_id);
c4f2dfd0 395#endif
1483577e 396
058b7035
UH
397/*--- hardware/common/ezusb.c -----------------------------------------------*/
398
22b02383 399#ifdef HAVE_LIBUSB_1_0
1a081ca6
UH
400SR_PRIV int ezusb_reset(struct libusb_device_handle *hdl, int set_clear);
401SR_PRIV int ezusb_install_firmware(libusb_device_handle *hdl,
402 const char *filename);
403SR_PRIV int ezusb_upload_firmware(libusb_device *dev, int configuration,
404 const char *filename);
22b02383 405#endif
058b7035 406
0c632d36
UH
407/*--- hardware/common/usb.c -------------------------------------------------*/
408
409#ifdef HAVE_LIBUSB_1_0
7ae6a758 410SR_PRIV GSList *sr_usb_find(libusb_context *usb_ctx, const char *conn);
0c632d36 411SR_PRIV int sr_usb_open(libusb_context *usb_ctx, struct sr_usb_dev_inst *usb);
6c60facc 412SR_PRIV int usb_source_add(struct sr_context *ctx, int timeout,
144f6660 413 sr_receive_data_callback cb, void *cb_data);
6c60facc 414SR_PRIV int usb_source_remove(struct sr_context *ctx);
0c632d36
UH
415#endif
416
7b9d7320
DJ
417/*--- hardware/common/scpi.c ------------------------------------------------*/
418
7b9d7320
DJ
419#define SCPI_CMD_IDN "*IDN?"
420#define SCPI_CMD_OPC "*OPC?"
421
422enum {
423 SCPI_CMD_SET_TRIGGER_SOURCE,
424 SCPI_CMD_SET_TIMEBASE,
425 SCPI_CMD_SET_VERTICAL_DIV,
426 SCPI_CMD_SET_TRIGGER_SLOPE,
427 SCPI_CMD_SET_COUPLING,
428 SCPI_CMD_SET_HORIZ_TRIGGERPOS,
429 SCPI_CMD_GET_ANALOG_CHAN_STATE,
430 SCPI_CMD_GET_DIG_CHAN_STATE,
431 SCPI_CMD_GET_TIMEBASE,
432 SCPI_CMD_GET_VERTICAL_DIV,
433 SCPI_CMD_GET_VERTICAL_OFFSET,
434 SCPI_CMD_GET_TRIGGER_SOURCE,
435 SCPI_CMD_GET_HORIZ_TRIGGERPOS,
436 SCPI_CMD_GET_TRIGGER_SLOPE,
437 SCPI_CMD_GET_COUPLING,
438 SCPI_CMD_SET_ANALOG_CHAN_STATE,
439 SCPI_CMD_SET_DIG_CHAN_STATE,
440 SCPI_CMD_GET_DIG_POD_STATE,
441 SCPI_CMD_SET_DIG_POD_STATE,
442 SCPI_CMD_GET_ANALOG_DATA,
443 SCPI_CMD_GET_DIG_DATA,
c09392d0
DJ
444 SCPI_CMD_GET_SAMPLE_RATE,
445 SCPI_CMD_GET_SAMPLE_RATE_LIVE,
7b9d7320
DJ
446};
447
448struct sr_scpi_hw_info {
449 char *manufacturer;
450 char *model;
451 char *serial_number;
452 char *firmware_version;
453};
454
23f43dff 455struct sr_scpi_dev_inst {
f754c146
AJ
456 const char *name;
457 const char *prefix;
458 int priv_size;
b541f837 459 GSList *(*scan)(struct drv_context *drvc);
17bdda58
AJ
460 int (*dev_inst_new)(void *priv, struct drv_context *drvc,
461 const char *resource, char **params, const char *serialcomm);
23f43dff
ML
462 int (*open)(void *priv);
463 int (*source_add)(void *priv, int events,
144f6660 464 int timeout, sr_receive_data_callback cb, void *cb_data);
23f43dff
ML
465 int (*source_remove)(void *priv);
466 int (*send)(void *priv, const char *command);
05c644ea
ML
467 int (*read_begin)(void *priv);
468 int (*read_data)(void *priv, char *buf, int maxlen);
469 int (*read_complete)(void *priv);
23f43dff
ML
470 int (*close)(void *priv);
471 void (*free)(void *priv);
472 void *priv;
473};
474
b541f837
AJ
475SR_PRIV GSList *sr_scpi_scan(struct drv_context *drvc, GSList *options,
476 struct sr_dev_inst *(*probe_device)(struct sr_scpi_dev_inst *scpi));
17bdda58
AJ
477SR_PRIV struct sr_scpi_dev_inst *scpi_dev_inst_new(struct drv_context *drvc,
478 const char *resource, const char *serialcomm);
23f43dff
ML
479SR_PRIV int sr_scpi_open(struct sr_scpi_dev_inst *scpi);
480SR_PRIV int sr_scpi_source_add(struct sr_scpi_dev_inst *scpi, int events,
144f6660 481 int timeout, sr_receive_data_callback cb, void *cb_data);
23f43dff
ML
482SR_PRIV int sr_scpi_source_remove(struct sr_scpi_dev_inst *scpi);
483SR_PRIV int sr_scpi_send(struct sr_scpi_dev_inst *scpi,
504f40a5 484 const char *format, ...);
87c41083
ML
485SR_PRIV int sr_scpi_send_variadic(struct sr_scpi_dev_inst *scpi,
486 const char *format, va_list args);
05c644ea
ML
487SR_PRIV int sr_scpi_read_begin(struct sr_scpi_dev_inst *scpi);
488SR_PRIV int sr_scpi_read_data(struct sr_scpi_dev_inst *scpi, char *buf, int maxlen);
489SR_PRIV int sr_scpi_read_complete(struct sr_scpi_dev_inst *scpi);
23f43dff
ML
490SR_PRIV int sr_scpi_close(struct sr_scpi_dev_inst *scpi);
491SR_PRIV void sr_scpi_free(struct sr_scpi_dev_inst *scpi);
492
493SR_PRIV int sr_scpi_get_string(struct sr_scpi_dev_inst *scpi,
494 const char *command, char **scpi_response);
495SR_PRIV int sr_scpi_get_bool(struct sr_scpi_dev_inst *scpi,
496 const char *command, gboolean *scpi_response);
497SR_PRIV int sr_scpi_get_int(struct sr_scpi_dev_inst *scpi,
498 const char *command, int *scpi_response);
499SR_PRIV int sr_scpi_get_float(struct sr_scpi_dev_inst *scpi,
500 const char *command, float *scpi_response);
501SR_PRIV int sr_scpi_get_double(struct sr_scpi_dev_inst *scpi,
502 const char *command, double *scpi_response);
503SR_PRIV int sr_scpi_get_opc(struct sr_scpi_dev_inst *scpi);
504SR_PRIV int sr_scpi_get_floatv(struct sr_scpi_dev_inst *scpi,
505 const char *command, GArray **scpi_response);
506SR_PRIV int sr_scpi_get_uint8v(struct sr_scpi_dev_inst *scpi,
507 const char *command, GArray **scpi_response);
508SR_PRIV int sr_scpi_get_hw_id(struct sr_scpi_dev_inst *scpi,
509 struct sr_scpi_hw_info **scpi_response);
7b9d7320
DJ
510SR_PRIV void sr_scpi_hw_info_free(struct sr_scpi_hw_info *hw_info);
511
c01bdebc
AJ
512/*--- hardware/common/dmm/es519xx.c -----------------------------------------*/
513
bfb926c1
AJ
514/**
515 * All 11-byte es519xx chips repeat each block twice for each conversion cycle
516 * so always read 2 blocks at a time.
517 */
518#define ES519XX_11B_PACKET_SIZE (11 * 2)
72e1672f 519#define ES519XX_14B_PACKET_SIZE 14
c01bdebc
AJ
520
521struct es519xx_info {
522 gboolean is_judge, is_voltage, is_auto, is_micro, is_current;
523 gboolean is_milli, is_resistance, is_continuity, is_diode;
524 gboolean is_frequency, is_rpm, is_capacitance, is_duty_cycle;
525 gboolean is_temperature, is_celsius, is_fahrenheit;
526 gboolean is_adp0, is_adp1, is_adp2, is_adp3;
527 gboolean is_sign, is_batt, is_ol, is_pmax, is_pmin, is_apo;
528 gboolean is_dc, is_ac, is_vahz, is_min, is_max, is_rel, is_hold;
529 gboolean is_digit4, is_ul, is_vasel, is_vbar, is_lpf1, is_lpf0, is_rmr;
530 uint32_t baudrate;
531 int packet_size;
532 gboolean alt_functions, fivedigits, clampmeter, selectable_lpf;
533};
534
72e1672f
UH
535SR_PRIV gboolean sr_es519xx_2400_11b_packet_valid(const uint8_t *buf);
536SR_PRIV int sr_es519xx_2400_11b_parse(const uint8_t *buf, float *floatval,
537 struct sr_datafeed_analog *analog, void *info);
2588e50c
AJ
538SR_PRIV gboolean sr_es519xx_2400_11b_altfn_packet_valid(const uint8_t *buf);
539SR_PRIV int sr_es519xx_2400_11b_altfn_parse(const uint8_t *buf,
540 float *floatval, struct sr_datafeed_analog *analog, void *info);
72e1672f 541SR_PRIV gboolean sr_es519xx_19200_11b_5digits_packet_valid(const uint8_t *buf);
93d719cd 542SR_PRIV int sr_es519xx_19200_11b_5digits_parse(const uint8_t *buf,
72e1672f
UH
543 float *floatval, struct sr_datafeed_analog *analog, void *info);
544SR_PRIV gboolean sr_es519xx_19200_11b_clamp_packet_valid(const uint8_t *buf);
545SR_PRIV int sr_es519xx_19200_11b_clamp_parse(const uint8_t *buf,
546 float *floatval, struct sr_datafeed_analog *analog, void *info);
547SR_PRIV gboolean sr_es519xx_19200_11b_packet_valid(const uint8_t *buf);
548SR_PRIV int sr_es519xx_19200_11b_parse(const uint8_t *buf, float *floatval,
549 struct sr_datafeed_analog *analog, void *info);
550SR_PRIV gboolean sr_es519xx_19200_14b_packet_valid(const uint8_t *buf);
551SR_PRIV int sr_es519xx_19200_14b_parse(const uint8_t *buf, float *floatval,
552 struct sr_datafeed_analog *analog, void *info);
553SR_PRIV gboolean sr_es519xx_19200_14b_sel_lpf_packet_valid(const uint8_t *buf);
554SR_PRIV int sr_es519xx_19200_14b_sel_lpf_parse(const uint8_t *buf,
555 float *floatval, struct sr_datafeed_analog *analog, void *info);
c01bdebc 556
79081ec8
UH
557/*--- hardware/common/dmm/fs9922.c ------------------------------------------*/
558
913abe83
UH
559#define FS9922_PACKET_SIZE 14
560
561struct fs9922_info {
562 gboolean is_auto, is_dc, is_ac, is_rel, is_hold, is_bpn, is_z1, is_z2;
563 gboolean is_max, is_min, is_apo, is_bat, is_nano, is_z3, is_micro;
564 gboolean is_milli, is_kilo, is_mega, is_beep, is_diode, is_percent;
565 gboolean is_z4, is_volt, is_ampere, is_ohm, is_hfe, is_hertz, is_farad;
566 gboolean is_celsius, is_fahrenheit;
567 int bargraph_sign, bargraph_value;
568};
569
913abe83
UH
570SR_PRIV gboolean sr_fs9922_packet_valid(const uint8_t *buf);
571SR_PRIV int sr_fs9922_parse(const uint8_t *buf, float *floatval,
572 struct sr_datafeed_analog *analog, void *info);
e52bb9be 573SR_PRIV void sr_fs9922_z1_diode(struct sr_datafeed_analog *analog, void *info);
79081ec8 574
6c701476
UH
575/*--- hardware/common/dmm/fs9721.c ------------------------------------------*/
576
8c1adf37
UH
577#define FS9721_PACKET_SIZE 14
578
579struct fs9721_info {
580 gboolean is_ac, is_dc, is_auto, is_rs232, is_micro, is_nano, is_kilo;
581 gboolean is_diode, is_milli, is_percent, is_mega, is_beep, is_farad;
582 gboolean is_ohm, is_rel, is_hold, is_ampere, is_volt, is_hz, is_bat;
583 gboolean is_c2c1_11, is_c2c1_10, is_c2c1_01, is_c2c1_00, is_sign;
584};
585
8c1adf37
UH
586SR_PRIV gboolean sr_fs9721_packet_valid(const uint8_t *buf);
587SR_PRIV int sr_fs9721_parse(const uint8_t *buf, float *floatval,
93357bc3 588 struct sr_datafeed_analog *analog, void *info);
2451a20f
UH
589SR_PRIV void sr_fs9721_00_temp_c(struct sr_datafeed_analog *analog, void *info);
590SR_PRIV void sr_fs9721_01_temp_c(struct sr_datafeed_analog *analog, void *info);
591SR_PRIV void sr_fs9721_10_temp_c(struct sr_datafeed_analog *analog, void *info);
592SR_PRIV void sr_fs9721_01_10_temp_f_c(struct sr_datafeed_analog *analog, void *info);
d327972b 593SR_PRIV void sr_fs9721_max_c_min(struct sr_datafeed_analog *analog, void *info);
6c701476 594
825da8b2
MH
595/*--- hardware/common/dmm/m2110.c -----------------------------------------*/
596
597#define BBCGM_M2110_PACKET_SIZE 9
598
599SR_PRIV gboolean sr_m2110_packet_valid(const uint8_t *buf);
600SR_PRIV int sr_m2110_parse(const uint8_t *buf, float *floatval,
601 struct sr_datafeed_analog *analog, void *info);
602
ac913e5c
UH
603/*--- hardware/common/dmm/metex14.c -----------------------------------------*/
604
605#define METEX14_PACKET_SIZE 14
606
607struct metex14_info {
608 gboolean is_ac, is_dc, is_resistance, is_capacity, is_temperature;
609 gboolean is_diode, is_frequency, is_ampere, is_volt, is_farad;
c02dc3e2
UH
610 gboolean is_hertz, is_ohm, is_celsius, is_pico, is_nano, is_micro;
611 gboolean is_milli, is_kilo, is_mega, is_gain, is_decibel, is_hfe;
e83437ae 612 gboolean is_unitless, is_logic;
ac913e5c
UH
613};
614
c4f2dfd0 615#ifdef HAVE_LIBSERIALPORT
ce3777ad 616SR_PRIV int sr_metex14_packet_request(struct sr_serial_dev_inst *serial);
c4f2dfd0 617#endif
ac913e5c
UH
618SR_PRIV gboolean sr_metex14_packet_valid(const uint8_t *buf);
619SR_PRIV int sr_metex14_parse(const uint8_t *buf, float *floatval,
1fbab466 620 struct sr_datafeed_analog *analog, void *info);
ac913e5c 621
05f134ab
AG
622/*--- hardware/common/dmm/rs9lcd.c ------------------------------------------*/
623
21829e67 624#define RS9LCD_PACKET_SIZE 9
05f134ab 625
e7ed87a4 626/* Dummy info struct. The parser does not use it. */
bf6f8399 627struct rs9lcd_info { int dummy; };
e7ed87a4 628
05f134ab
AG
629SR_PRIV gboolean sr_rs9lcd_packet_valid(const uint8_t *buf);
630SR_PRIV int sr_rs9lcd_parse(const uint8_t *buf, float *floatval,
631 struct sr_datafeed_analog *analog, void *info);
632
1483577e 633#endif