hardware/rigol-ds1xx2/api.c

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2012 Martin Ling <martin-git@earth.li>
   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 #include <fcntl.h>
  21 #include <unistd.h>
  22 #include <stdlib.h>
  23 #include <string.h>
  24 #include <glib.h>
  25 #include "libsigrok.h"
  26 #include "libsigrok-internal.h"
  27 #include "protocol.h"
  28
  29 static const int hwcaps[] = {
  30         SR_CONF_OSCILLOSCOPE,
  31         SR_CONF_LIMIT_SAMPLES,
  32         SR_CONF_TIMEBASE,
  33         SR_CONF_TRIGGER_SOURCE,
  34         SR_CONF_TRIGGER_SLOPE,
  35         SR_CONF_HORIZ_TRIGGERPOS,
  36         SR_CONF_VDIV,
  37         SR_CONF_COUPLING,
  38         0,
  39 };
  40
  41 static const struct sr_rational timebases[] = {
  42         /* nanoseconds */
  43         { 2, 1000000000 },
  44         { 5, 1000000000 },
  45         { 10, 1000000000 },
  46         { 20, 1000000000 },
  47         { 50, 1000000000 },
  48         { 100, 1000000000 },
  49         { 500, 1000000000 },
  50         /* microseconds */
  51         { 1, 1000000 },
  52         { 2, 1000000 },
  53         { 5, 1000000 },
  54         { 10, 1000000 },
  55         { 20, 1000000 },
  56         { 50, 1000000 },
  57         { 100, 1000000 },
  58         { 200, 1000000 },
  59         { 500, 1000000 },
  60         /* milliseconds */
  61         { 1, 1000 },
  62         { 2, 1000 },
  63         { 5, 1000 },
  64         { 10, 1000 },
  65         { 20, 1000 },
  66         { 50, 1000 },
  67         { 100, 1000 },
  68         { 200, 1000 },
  69         { 500, 1000 },
  70         /* seconds */
  71         { 1, 1 },
  72         { 2, 1 },
  73         { 5, 1 },
  74         { 10, 1 },
  75         { 20, 1 },
  76         { 50, 1 },
  77         { 0, 0},
  78 };
  79
  80 static const struct sr_rational vdivs[] = {
  81         /* millivolts */
  82         { 2, 1000 },
  83         { 5, 1000 },
  84         { 10, 1000 },
  85         { 20, 1000 },
  86         { 50, 1000 },
  87         { 100, 1000 },
  88         { 200, 1000 },
  89         { 500, 1000 },
  90         /* volts */
  91         { 1, 1 },
  92         { 2, 1 },
  93         { 5, 1 },
  94         { 10, 1 },
  95         { 0, 0 },
  96 };
  97
  98 static const char *trigger_sources[] = {
  99         "CH1",
 100         "CH2",
 101         "EXT",
 102         "AC Line",
 103         NULL,
 104 };
 105
 106 static const char *coupling[] = {
 107         "AC",
 108         "DC",
 109         "GND",
 110         NULL,
 111 };
 112
 113 static const char *supported_models[] = {
 114         "DS1052E",
 115         "DS1102E",
 116         "DS1052D",
 117         "DS1102D"
 118 };
 119
 120 SR_PRIV struct sr_dev_driver rigol_ds1xx2_driver_info;
 121 static struct sr_dev_driver *di = &rigol_ds1xx2_driver_info;
 122
 123 /* Properly close and free all devices. */
 124 static int clear_instances(void)
 125 {
 126         struct sr_dev_inst *sdi;
 127         struct drv_context *drvc;
 128         struct dev_context *devc;
 129         GSList *l;
 130
 131         if (!(drvc = di->priv))
 132                 return SR_OK;
 133
 134         for (l = drvc->instances; l; l = l->next) {
 135                 if (!(sdi = l->data))
 136                         continue;
 137                 if (!(devc = sdi->priv))
 138                         continue;
 139
 140                 g_free(devc->device);
 141                 g_slist_free(devc->enabled_probes);
 142                 close(devc->fd);
 143
 144                 sr_dev_inst_free(sdi);
 145         }
 146
 147         g_slist_free(drvc->instances);
 148         drvc->instances = NULL;
 149
 150         return SR_OK;
 151 }
 152
 153 static int hw_init(struct sr_context *sr_ctx)
 154 {
 155         struct drv_context *drvc;
 156         (void)sr_ctx;
 157
 158         if (!(drvc = g_try_malloc0(sizeof(struct drv_context)))) {
 159                 sr_err("Driver context malloc failed.");
 160                 return SR_ERR_MALLOC;
 161         }
 162
 163         di->priv = drvc;
 164
 165         return SR_OK;
 166 }
 167
 168 static GSList *hw_scan(GSList *options)
 169 {
 170         struct drv_context *drvc;
 171         struct sr_dev_inst *sdi;
 172         struct dev_context *devc;
 173         struct sr_probe *probe;
 174         GSList *devices;
 175         GDir *dir;
 176         const gchar *dev_name;
 177         const gchar *dev_dir = "/dev/";
 178         const gchar *prefix = "usbtmc";
 179         gchar *device;
 180         const gchar *idn_query = "*IDN?";
 181         int len, num_tokens, fd, i;
 182         const gchar *delimiter = ",";
 183         gchar **tokens;
 184         const char *manufacturer, *model, *version;
 185         int num_models;
 186         gboolean matched = FALSE;
 187         char buf[256];
 188
 189         (void)options;
 190
 191         devices = NULL;
 192         drvc = di->priv;
 193         drvc->instances = NULL;
 194
 195         dir = g_dir_open("/sys/class/usb/", 0, NULL);
 196
 197         if (dir == NULL)
 198                 return NULL;
 199
 200         while ((dev_name = g_dir_read_name(dir)) != NULL) {
 201                 if (strncmp(dev_name, prefix, strlen(prefix)))
 202                         continue;
 203
 204                 device = g_strconcat(dev_dir, dev_name, NULL);
 205
 206                 fd = open(device, O_RDWR);
 207                 len = write(fd, idn_query, strlen(idn_query));
 208                 len = read(fd, buf, sizeof(buf));
 209                 close(fd);
 210                 if (len == 0) {
 211                         g_free(device);
 212                         return NULL;
 213                 }
 214
 215                 buf[len] = 0;
 216                 tokens = g_strsplit(buf, delimiter, 0);
 217                 close(fd);
 218                 sr_dbg("response: %s %d [%s]", device, len, buf);
 219
 220                 for (num_tokens = 0; tokens[num_tokens] != NULL; num_tokens++);
 221
 222                 if (num_tokens < 4) {
 223                         g_strfreev(tokens);
 224                         g_free(device);
 225                         return NULL;
 226                 }
 227
 228                 manufacturer = tokens[0];
 229                 model = tokens[1];
 230                 version = tokens[3];
 231
 232                 if (strcmp(manufacturer, "Rigol Technologies")) {
 233                         g_strfreev(tokens);
 234                         g_free(device);
 235                         return NULL;
 236                 }
 237
 238                 num_models = sizeof(supported_models) / sizeof(supported_models[0]);
 239
 240                 for (i = 0; i < num_models; i++) {
 241                         if (!strcmp(model, supported_models[i])) {
 242                                 matched = 1;
 243                                 break;
 244                         }
 245                 }
 246
 247                 if (!matched || !(sdi = sr_dev_inst_new(0, SR_ST_ACTIVE,
 248                         manufacturer, model, version))) {
 249                         g_strfreev(tokens);
 250                         g_free(device);
 251                         return NULL;
 252                 }
 253
 254                 g_strfreev(tokens);
 255
 256                 if (!(devc = g_try_malloc0(sizeof(struct dev_context)))) {
 257                         sr_err("Device context malloc failed.");
 258                         g_free(device);
 259                         return NULL;
 260                 }
 261
 262                 devc->device = device;
 263
 264                 sdi->priv = devc;
 265                 sdi->driver = di;
 266
 267                 for (i = 0; i < 2; i++) {
 268                         if (!(probe = sr_probe_new(0, SR_PROBE_ANALOG, TRUE,
 269                             i == 0 ? "CH1" : "CH2")))
 270                                 return NULL;
 271                         sdi->probes = g_slist_append(sdi->probes, probe);
 272                 }
 273
 274                 drvc->instances = g_slist_append(drvc->instances, sdi);
 275                 devices = g_slist_append(devices, sdi);
 276         }
 277
 278         g_dir_close(dir);
 279
 280         return devices;
 281 }
 282
 283 static GSList *hw_dev_list(void)
 284 {
 285         struct drv_context *drvc;
 286
 287         drvc = di->priv;
 288
 289         return drvc->instances;
 290 }
 291
 292 static int hw_dev_open(struct sr_dev_inst *sdi)
 293 {
 294         struct dev_context *devc;
 295         int fd;
 296
 297         devc = sdi->priv;
 298
 299         if ((fd = open(devc->device, O_RDWR)) == -1)
 300                 return SR_ERR;
 301
 302         devc->fd = fd;
 303
 304         devc->scale = 1;
 305
 306         return SR_OK;
 307 }
 308
 309 static int hw_dev_close(struct sr_dev_inst *sdi)
 310 {
 311         struct dev_context *devc;
 312
 313         devc = sdi->priv;
 314
 315         close(devc->fd);
 316
 317         return SR_OK;
 318 }
 319
 320 static int hw_cleanup(void)
 321 {
 322         clear_instances();
 323
 324         return SR_OK;
 325 }
 326
 327 static int hw_info_get(int info_id, const void **data,
 328                        const struct sr_dev_inst *sdi)
 329 {
 330         (void)sdi;
 331
 332         switch (info_id) {
 333         case SR_DI_HWCAPS:
 334                 *data = hwcaps;
 335                 break;
 336         case SR_DI_TIMEBASES:
 337                 *data = timebases;
 338                 break;
 339         case SR_DI_TRIGGER_SOURCES:
 340                 *data = trigger_sources;
 341                 break;
 342         case SR_DI_VDIVS:
 343                 *data = vdivs;
 344                 break;
 345         case SR_DI_COUPLING:
 346                 *data = coupling;
 347                 break;
 348         default:
 349                 return SR_ERR_ARG;
 350         }
 351
 352         return SR_OK;
 353 }
 354
 355 static int hw_dev_config_set(const struct sr_dev_inst *sdi, int hwcap,
 356                              const void *value)
 357 {
 358         struct dev_context *devc;
 359         uint64_t tmp_u64;
 360         float tmp_float;
 361         struct sr_rational tmp_rat;
 362         int ret, i, j;
 363         char *channel;
 364
 365         devc = sdi->priv;
 366
 367         if (sdi->status != SR_ST_ACTIVE) {
 368                 sr_err("Device inactive, can't set config options.");
 369                 return SR_ERR;
 370         }
 371
 372         ret = SR_OK;
 373         switch (hwcap) {
 374         case SR_CONF_LIMIT_FRAMES:
 375                 devc->limit_frames = *(const uint64_t *)value;
 376                 break;
 377         case SR_CONF_TRIGGER_SLOPE:
 378                 tmp_u64 = *(const int *)value;
 379                 rigol_ds1xx2_send_data(devc->fd, ":TRIG:EDGE:SLOP %s\n",
 380                                        tmp_u64 ? "POS" : "NEG");
 381                 break;
 382         case SR_CONF_HORIZ_TRIGGERPOS:
 383                 tmp_float = *(const float *)value;
 384                 rigol_ds1xx2_send_data(devc->fd, ":TIM:OFFS %.9f\n", tmp_float);
 385                 break;
 386         case SR_CONF_TIMEBASE:
 387                 tmp_rat = *(const struct sr_rational *)value;
 388                 rigol_ds1xx2_send_data(devc->fd, ":TIM:SCAL %.9f\n",
 389                                        (float)tmp_rat.p / tmp_rat.q);
 390                 break;
 391         case SR_CONF_TRIGGER_SOURCE:
 392                 if (!strcmp(value, "CH1"))
 393                         channel = "CHAN1";
 394                 else if (!strcmp(value, "CH2"))
 395                         channel = "CHAN2";
 396                 else if (!strcmp(value, "EXT"))
 397                         channel = "EXT";
 398                 else if (!strcmp(value, "AC Line"))
 399                         channel = "ACL";
 400                 else {
 401                         ret = SR_ERR_ARG;
 402                         break;
 403                 }
 404                 rigol_ds1xx2_send_data(devc->fd, ":TRIG:EDGE:SOUR %s\n", channel);
 405                 break;
 406         case SR_CONF_VDIV:
 407                 /* TODO: Not supporting vdiv per channel yet. */
 408                 tmp_rat = *(const struct sr_rational *)value;
 409                 for (i = 0; vdivs[i].p && vdivs[i].q; i++) {
 410                         if (vdivs[i].p == tmp_rat.p
 411                                         && vdivs[i].q == tmp_rat.q) {
 412                                 devc->scale = (float)tmp_rat.p / tmp_rat.q;
 413                                 for (j = 0; j < 2; j++)
 414                                         rigol_ds1xx2_send_data(devc->fd,
 415                                          ":CHAN%d:SCAL %.3f\n", j, devc->scale);
 416                                 break;
 417                         }
 418                 }
 419                 if (vdivs[i].p == 0 && vdivs[i].q == 0)
 420                         ret = SR_ERR_ARG;
 421                 break;
 422         case SR_CONF_COUPLING:
 423                 /* TODO: Not supporting coupling per channel yet. */
 424                 for (i = 0; coupling[i]; i++) {
 425                         if (!strcmp(value, coupling[i])) {
 426                                 for (j = 0; j < 2; j++)
 427                                         rigol_ds1xx2_send_data(devc->fd,
 428                                           ":CHAN%d:COUP %s\n", j, coupling[i]);
 429                                 break;
 430                         }
 431                 }
 432                 if (coupling[i] == 0)
 433                         ret = SR_ERR_ARG;
 434                 break;
 435         default:
 436                 sr_err("Unknown hardware capability: %d.", hwcap);
 437                 ret = SR_ERR_ARG;
 438                 break;
 439         }
 440
 441         return ret;
 442 }
 443
 444 static int hw_dev_acquisition_start(const struct sr_dev_inst *sdi,
 445                                     void *cb_data)
 446 {
 447         struct dev_context *devc;
 448         struct sr_datafeed_packet packet;
 449         struct sr_datafeed_header header;
 450         char buf[256];
 451         int len;
 452
 453         (void)cb_data;
 454
 455         devc = sdi->priv;
 456
 457         devc->num_frames = 0;
 458
 459         sr_source_add(devc->fd, G_IO_IN, 50, rigol_ds1xx2_receive_data, (void *)sdi);
 460
 461         /* Send header packet to the session bus. */
 462         packet.type = SR_DF_HEADER;
 463         packet.payload = (unsigned char *)&header;
 464         header.feed_version = 1;
 465         gettimeofday(&header.starttime, NULL);
 466         sr_session_send(cb_data, &packet);
 467
 468         /* Hardcoded to CH1 only. */
 469         devc->enabled_probes = g_slist_append(NULL, sdi->probes->data);
 470         rigol_ds1xx2_send_data(devc->fd, ":CHAN1:SCAL?\n");
 471         len = read(devc->fd, buf, sizeof(buf));
 472         buf[len] = 0;
 473         devc->scale = atof(buf);
 474         sr_dbg("Scale is %.3f.", devc->scale);
 475         rigol_ds1xx2_send_data(devc->fd, ":CHAN1:OFFS?\n");
 476         len = read(devc->fd, buf, sizeof(buf));
 477         buf[len] = 0;
 478         devc->offset = atof(buf);
 479         sr_dbg("Offset is %.6f.", devc->offset);
 480         rigol_ds1xx2_send_data(devc->fd, ":WAV:DATA?\n");
 481
 482         return SR_OK;
 483 }
 484
 485 static int hw_dev_acquisition_stop(struct sr_dev_inst *sdi, void *cb_data)
 486 {
 487         struct dev_context *devc;
 488
 489         (void)cb_data;
 490
 491         devc = sdi->priv;
 492
 493         if (sdi->status != SR_ST_ACTIVE) {
 494                 sr_err("Device inactive, can't stop acquisition.");
 495                 return SR_ERR;
 496         }
 497
 498         sr_source_remove(devc->fd);
 499
 500         return SR_OK;
 501 }
 502
 503 SR_PRIV struct sr_dev_driver rigol_ds1xx2_driver_info = {
 504         .name = "rigol-ds1xx2",
 505         .longname = "Rigol DS1xx2",
 506         .api_version = 1,
 507         .init = hw_init,
 508         .cleanup = hw_cleanup,
 509         .scan = hw_scan,
 510         .dev_list = hw_dev_list,
 511         .dev_clear = clear_instances,
 512         .dev_open = hw_dev_open,
 513         .dev_close = hw_dev_close,
 514         .info_get = hw_info_get,
 515         .dev_config_set = hw_dev_config_set,
 516         .dev_acquisition_start = hw_dev_acquisition_start,
 517         .dev_acquisition_stop = hw_dev_acquisition_stop,
 518         .priv = NULL,
 519 };