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         AGILENT_U1251,
  51         AGILENT_U1252,
  52         AGILENT_U1253,
  53
  54         KEYSIGHT_U1281,
  55         KEYSIGHT_U1282,
  56 };
  57
  58 /* Supported device profiles */
  59 struct agdmm_profile {
  60         int model;
  61         const char *modelname;
  62         int nb_channels;
  63         const struct agdmm_job *jobs_live;
  64         const struct agdmm_job *jobs_log;
  65         const struct agdmm_recv *recvs;
  66 };
  67
  68 /* Private, per-device-instance driver context. */
  69 struct dev_context {
  70         const struct agdmm_profile *profile;
  71         struct sr_sw_limits limits;
  72         int data_source;
  73
  74         /* Runtime. */
  75         const struct agdmm_job *jobs;
  76         int current_job;
  77         gboolean job_running;
  78         gboolean job_again;
  79         int64_t jobs_start[8];
  80         unsigned char buf[AGDMM_BUFSIZE];
  81         int buflen;
  82         uint64_t cur_samplerate;
  83         struct sr_channel *cur_channel;
  84         struct sr_channel *cur_conf;
  85         int cur_sample;
  86         int cur_mq[MAX_CHANNELS];
  87         int cur_unit[MAX_CHANNELS];
  88         int cur_mqflags[MAX_CHANNELS];
  89         int cur_digits[MAX_CHANNELS];
  90         int cur_encoding[MAX_CHANNELS];
  91         int cur_exponent[MAX_CHANNELS];
  92         int mode_tempaux;
  93         int mode_continuity;
  94         int mode_squarewave;
  95         int mode_dbm_dbv;
  96 };
  97
  98 enum job_type {
  99         JOB_AGAIN = 1,
 100         JOB_STOP,
 101         JOB_CONF,
 102         JOB_STAT,
 103         JOB_FETC,
 104         JOB_LOG,
 105 };
 106
 107 struct agdmm_job {
 108         enum job_type type;
 109         int interval;
 110         int (*send) (const struct sr_dev_inst *sdi);
 111 };
 112
 113 struct agdmm_recv {
 114         const char *recv_regex;
 115         int (*recv) (const struct sr_dev_inst *sdi, GMatchInfo *match);
 116 };
 117
 118 SR_PRIV int agdmm_receive_data(int fd, int revents, void *cb_data);
 119
 120 #endif