src/hardware/agilent-dmm/protocol.h

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2012 Bert Vermeulen <bert@biot.com>
   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
  20 #ifndef LIBSIGROK_HARDWARE_AGILENT_DMM_PROTOCOL_H
  21 #define LIBSIGROK_HARDWARE_AGILENT_DMM_PROTOCOL_H
  22
  23 #define LOG_PREFIX "agilent-dmm"
  24
  25 #define MAX_CHANNELS 3
  26 #define AGDMM_BUFSIZE 256
  27
  28 /* Always USB-serial, 1ms is plenty. */
  29 #define SERIAL_WRITE_TIMEOUT_MS 1
  30
  31 #define DEFAULT_DATA_SOURCE     DATA_SOURCE_LIVE
  32
  33 enum {
  34         DATA_SOURCE_LIVE,
  35         DATA_SOURCE_LOG_HAND,
  36         DATA_SOURCE_LOG_TRIG,
  37         DATA_SOURCE_LOG_AUTO,
  38         DATA_SOURCE_LOG_EXPO,
  39 };
  40
  41 /* Supported models */
  42 enum {
  43         AGILENT_U1231 = 1,
  44         AGILENT_U1232,
  45         AGILENT_U1233,
  46
  47         AGILENT_U1241,
  48         AGILENT_U1242,
  49
  50         KEYSIGHT_U1241C,
  51         KEYSIGHT_U1242C,
  52
  53         AGILENT_U1251,
  54         AGILENT_U1252,
  55         AGILENT_U1253,
  56
  57         KEYSIGHT_U1281,
  58         KEYSIGHT_U1282,
  59 };
  60
  61 /* Supported device profiles */
  62 struct agdmm_profile {
  63         int model;
  64         const char *modelname;
  65         int nb_channels;
  66         const struct agdmm_job *jobs_live;
  67         const struct agdmm_job *jobs_log;
  68         const struct agdmm_recv *recvs;
  69 };
  70
  71 /* Private, per-device-instance driver context. */
  72 struct dev_context {
  73         const struct agdmm_profile *profile;
  74         struct sr_sw_limits limits;
  75         int data_source;
  76
  77         /* Runtime. */
  78         const struct agdmm_job *jobs;
  79         int current_job;
  80         gboolean job_running;
  81         gboolean job_again;
  82         int64_t jobs_start[8];
  83         unsigned char buf[AGDMM_BUFSIZE];
  84         int buflen;
  85         uint64_t cur_samplerate;
  86         struct sr_channel *cur_channel;
  87         struct sr_channel *cur_conf;
  88         int cur_sample;
  89         int cur_mq[MAX_CHANNELS];
  90         int cur_unit[MAX_CHANNELS];
  91         int cur_mqflags[MAX_CHANNELS];
  92         int cur_digits[MAX_CHANNELS];
  93         int cur_encoding[MAX_CHANNELS];
  94         int cur_exponent[MAX_CHANNELS];
  95         int mode_tempaux;
  96         int mode_continuity;
  97         int mode_squarewave;
  98         int mode_dbm_dbv;
  99 };
 100
 101 enum job_type {
 102         JOB_AGAIN = 1,
 103         JOB_STOP,
 104         JOB_CONF,
 105         JOB_STAT,
 106         JOB_FETC,
 107         JOB_LOG,
 108 };
 109
 110 struct agdmm_job {
 111         enum job_type type;
 112         int interval;
 113         int (*send) (const struct sr_dev_inst *sdi);
 114 };
 115
 116 struct agdmm_recv {
 117         const char *recv_regex;
 118         int (*recv) (const struct sr_dev_inst *sdi, GMatchInfo *match);
 119 };
 120
 121 SR_PRIV int agdmm_receive_data(int fd, int revents, void *cb_data);
 122
 123 #endif