src/hardware/fluke-45/api.c

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2012 Bert Vermeulen <bert@biot.com>
   5  * Copyright (C) 2017 John Chajecki <subs@qcontinuum.plus.com>
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation, either version 3 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19  */
  20
  21 #include <config.h>
  22 #include <glib.h>
  23 #include <sys/types.h>
  24 #include <sys/stat.h>
  25 #include <fcntl.h>
  26 #include <string.h>
  27 #include <stdint.h>
  28 #include <stdbool.h>
  29 #include <libsigrok/libsigrok.h>
  30 #include "libsigrok-internal.h"
  31 #include "scpi.h"
  32 #include "protocol.h"
  33
  34 /*
  35  * This test violates the SCPI protocol, and confuses other devices.
  36  * Disable it for now, until a better location was found.
  37  */
  38 #define ECHO_TEST 0
  39
  40 static const uint32_t scanopts[] = {
  41         SR_CONF_CONN,
  42         SR_CONF_SERIALCOMM,
  43 };
  44
  45 static const uint32_t drvopts[] = {
  46         SR_CONF_MULTIMETER,
  47 };
  48
  49 static const uint32_t devopts[] = {
  50         SR_CONF_CONTINUOUS,
  51         SR_CONF_LIMIT_SAMPLES | SR_CONF_SET,
  52         SR_CONF_LIMIT_MSEC | SR_CONF_SET,
  53 };
  54
  55 /* Vendor, model, number of channels, poll period */
  56 static const struct fluke_scpi_dmm_model supported_models[] = {
  57         { "FLUKE", "45", 2, 0 },
  58 };
  59
  60 static struct sr_dev_driver fluke_45_driver_info;
  61
  62 static struct sr_dev_inst *probe_device(struct sr_scpi_dev_inst *scpi)
  63 {
  64         struct dev_context *devc;
  65         struct sr_dev_inst *sdi;
  66         struct sr_scpi_hw_info *hw_info;
  67         const struct scpi_command *cmdset = fluke_45_cmdset;
  68         unsigned int i;
  69         const struct fluke_scpi_dmm_model *model = NULL;
  70         gchar *channel_name;
  71 #if ECHO_TEST
  72         char *response;
  73 #endif
  74
  75 #if ECHO_TEST
  76         /* Test for serial port ECHO enabled. */
  77         response = NULL;
  78         sr_scpi_get_string(scpi, "ECHO-TEST", &response);
  79         if (response && strcmp(response, "ECHO-TEST") == 0) {
  80                 sr_err("Serial port ECHO is ON. Please turn it OFF!");
  81                 return NULL;
  82         }
  83 #endif
  84
  85         /* Get device IDN. */
  86         if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK) {
  87                 sr_info("Couldn't get IDN response, retrying.");
  88                 sr_scpi_close(scpi);
  89                 sr_scpi_open(scpi);
  90                 if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK) {
  91                         sr_info("Couldn't get IDN response.");
  92                         return NULL;
  93                 }
  94         }
  95
  96         /* Check IDN. */
  97         for (i = 0; i < ARRAY_SIZE(supported_models); i++) {
  98                 if (!g_ascii_strcasecmp(hw_info->manufacturer,
  99                                         supported_models[i].vendor) &&
 100                                 !strcmp(hw_info->model, supported_models[i].model)) {
 101                         model = &supported_models[i];
 102                         break;
 103                 }
 104         }
 105         if (!model) {
 106                 sr_scpi_hw_info_free(hw_info);
 107                 return NULL;
 108         }
 109
 110         /* Set up device parameters. */
 111         sdi = g_malloc0(sizeof(struct sr_dev_inst));
 112         sdi->vendor = g_strdup(model->vendor);
 113         sdi->model = g_strdup(model->model);
 114         sdi->version = g_strdup(hw_info->firmware_version);
 115         sdi->serial_num = g_strdup(hw_info->serial_number);
 116         sdi->conn = scpi;
 117         sdi->driver = &fluke_45_driver_info;
 118         sdi->inst_type = SR_INST_SCPI;
 119         sr_scpi_hw_info_free(hw_info);
 120
 121         devc = g_malloc0(sizeof(struct dev_context));
 122         devc->num_channels = model->num_channels;
 123         devc->cmdset = cmdset;
 124         sdi->priv = devc;
 125
 126         /* Create channels. */
 127         for (i = 0; i < devc->num_channels; i++) {
 128                 channel_name = g_strdup_printf("P%d", i + 1);
 129                 sr_channel_new(sdi, 0, SR_CHANNEL_ANALOG, TRUE, channel_name);
 130         }
 131
 132         return sdi;
 133 }
 134
 135 static GSList *scan(struct sr_dev_driver *di, GSList *options)
 136 {
 137         return sr_scpi_scan(di->context, options, probe_device);
 138 }
 139
 140 static int dev_open(struct sr_dev_inst *sdi)
 141 {
 142         struct sr_scpi_dev_inst *scpi;
 143         int ret;
 144
 145         scpi = sdi->conn;
 146
 147         if ((ret = sr_scpi_open(scpi) < 0)) {
 148                 sr_err("Failed to open SCPI device: %s.", sr_strerror(ret));
 149                 return SR_ERR;
 150         }
 151
 152         return SR_OK;
 153 }
 154
 155 static int dev_close(struct sr_dev_inst *sdi)
 156 {
 157         struct sr_scpi_dev_inst *scpi;
 158
 159         scpi = sdi->conn;
 160
 161         if (!scpi)
 162                 return SR_ERR_BUG;
 163
 164         return sr_scpi_close(scpi);
 165 }
 166
 167 static int config_set(uint32_t key, GVariant *data,
 168         const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
 169 {
 170         struct dev_context *devc;
 171
 172         (void)cg;
 173
 174         devc = sdi->priv;
 175
 176         return sr_sw_limits_config_set(&devc->limits, key, data);
 177 }
 178
 179 static int config_list(uint32_t key, GVariant **data,
 180         const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
 181 {
 182         return STD_CONFIG_LIST(key, data, sdi, cg, scanopts, drvopts, devopts);
 183 }
 184
 185 static int config_get(uint32_t key, GVariant **data,
 186         const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
 187 {
 188         struct dev_context *devc = sdi->priv;
 189
 190         (void)cg;
 191
 192         return sr_sw_limits_config_get(&devc->limits, key, data);
 193 }
 194
 195 static int dev_acquisition_start(const struct sr_dev_inst *sdi)
 196 {
 197         struct sr_scpi_dev_inst *scpi;
 198         struct dev_context *devc;
 199         int ret;
 200
 201         scpi = sdi->conn;
 202         devc = sdi->priv;
 203
 204         sr_sw_limits_acquisition_start(&devc->limits);
 205         std_session_send_df_header(sdi);
 206
 207         if ((ret = sr_scpi_source_add(sdi->session, scpi, G_IO_IN, 10,
 208                         fl45_scpi_receive_data, (void *)sdi)) != SR_OK)
 209                 return ret;
 210
 211         return SR_OK;
 212 }
 213
 214 static int dev_acquisition_stop(struct sr_dev_inst *sdi)
 215 {
 216         struct sr_scpi_dev_inst *scpi;
 217         double d;
 218
 219         scpi = sdi->conn;
 220
 221         /*
 222          * A requested value is certainly on the way. Retrieve it now,
 223          * to avoid leaving the device in a state where it's not expecting
 224          * commands.
 225          */
 226         sr_scpi_get_double(scpi, NULL, &d);
 227         sr_scpi_source_remove(sdi->session, scpi);
 228
 229         std_session_send_df_end(sdi);
 230
 231         return SR_OK;
 232 }
 233
 234 static struct sr_dev_driver fluke_45_driver_info = {
 235         .name = "fluke-45",
 236         .longname = "Fluke 45",
 237         .api_version = 1,
 238         .init = std_init,
 239         .cleanup = std_cleanup,
 240         .scan = scan,
 241         .dev_list = std_dev_list,
 242         .dev_clear = std_dev_clear,
 243         .config_get = config_get,
 244         .config_set = config_set,
 245         .config_list = config_list,
 246         .dev_open = dev_open,
 247         .dev_close = dev_close,
 248         .dev_acquisition_start = dev_acquisition_start,
 249         .dev_acquisition_stop = dev_acquisition_stop,
 250         .context = NULL,
 251 };
 252 SR_REGISTER_DEV_DRIVER(fluke_45_driver_info);