hardware/uni-t-dmm/protocol.h

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2012-2013 Uwe Hermann <uwe@hermann-uwe.de>
   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 2 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, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
  19  */
  20
  21 #ifndef LIBSIGROK_HARDWARE_UNI_T_DMM_PROTOCOL_H
  22 #define LIBSIGROK_HARDWARE_UNI_T_DMM_PROTOCOL_H
  23
  24 #include <stdint.h>
  25 #include <glib.h>
  26 #include <libusb.h>
  27 #include "libsigrok.h"
  28 #include "libsigrok-internal.h"
  29
  30 /* Message logging helpers with driver-specific prefix string. */
  31 #define DRIVER_LOG_DOMAIN "uni-t-dmm: "
  32 #define sr_log(l, s, args...) sr_log(l, DRIVER_LOG_DOMAIN s, ## args)
  33 #define sr_spew(s, args...) sr_spew(DRIVER_LOG_DOMAIN s, ## args)
  34 #define sr_dbg(s, args...) sr_dbg(DRIVER_LOG_DOMAIN s, ## args)
  35 #define sr_info(s, args...) sr_info(DRIVER_LOG_DOMAIN s, ## args)
  36 #define sr_warn(s, args...) sr_warn(DRIVER_LOG_DOMAIN s, ## args)
  37 #define sr_err(s, args...) sr_err(DRIVER_LOG_DOMAIN s, ## args)
  38
  39 /* Note: When adding entries here, don't forget to update DMM_COUNT. */
  40 enum {
  41         UNI_T_UT61D,
  42         UNI_T_UT61E,
  43         VOLTCRAFT_VC820,
  44         VOLTCRAFT_VC840,
  45 };
  46
  47 #define DMM_COUNT 4
  48
  49 struct dmm_info {
  50         char *vendor;
  51         char *device;
  52         uint32_t baudrate;
  53         int packet_size;
  54         int (*packet_request)(struct sr_serial_dev_inst *);
  55         gboolean (*packet_valid)(const uint8_t *);
  56         int (*packet_parse)(const uint8_t *, float *,
  57                             struct sr_datafeed_analog *, void *);
  58         void (*dmm_details)(struct sr_datafeed_analog *, void *);
  59         struct sr_dev_driver *di;
  60         int (*receive_data)(int, int, void *);
  61 };
  62
  63 extern SR_PRIV struct dmm_info udmms[DMM_COUNT];
  64
  65 #define CHUNK_SIZE              8
  66
  67 #define DMM_BUFSIZE             256
  68
  69 /** Private, per-device-instance driver context. */
  70 struct dev_context {
  71         /** The current sampling limit (in number of samples). */
  72         uint64_t limit_samples;
  73
  74         /** The current sampling limit (in ms). */
  75         uint64_t limit_msec;
  76
  77         /** Opaque pointer passed in by the frontend. */
  78         void *cb_data;
  79
  80         /** The current number of already received samples. */
  81         uint64_t num_samples;
  82
  83         gboolean first_run;
  84
  85         uint8_t protocol_buf[DMM_BUFSIZE];
  86         uint8_t bufoffset;
  87         uint8_t buflen;
  88 };
  89
  90 SR_PRIV int receive_data_UNI_T_UT61D(int fd, int revents, void *cb_data);
  91 SR_PRIV int receive_data_UNI_T_UT61E(int fd, int revents, void *cb_data);
  92 SR_PRIV int receive_data_VOLTCRAFT_VC820(int fd, int revents, void *cb_data);
  93 SR_PRIV int receive_data_VOLTCRAFT_VC840(int fd, int revents, void *cb_data);
  94
  95 #endif