src/hardware/motech-lps-30x/api.c

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2014 Matthias Heidbrink <m-sigrok@heidbrink.biz>
   5  * Copyright (C) 2014 Bert Vermeulen <bert@biot.com> (code from atten-pps3xxx)
   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 /** @file
  22  *  <em>Motech LPS-30x series</em> power supply driver
  23  *  @internal
  24  */
  25
  26 #include <config.h>
  27 #include <ctype.h>
  28 #include <math.h>
  29 #include <string.h>
  30 #include "protocol.h"
  31
  32 /* Forward declarations */
  33 SR_PRIV struct sr_dev_driver motech_lps_301_driver_info;
  34 SR_PRIV int lps_read_reply(struct sr_serial_dev_inst *serial, char **buf, int *buflen);
  35 SR_PRIV int lps_send_va(struct sr_serial_dev_inst *serial, const char *fmt, va_list args);
  36 SR_PRIV int lps_cmd_ok(struct sr_serial_dev_inst *serial, const char *fmt, ...);
  37 SR_PRIV int lps_cmd_reply(char *reply, struct sr_serial_dev_inst *serial, const char *fmt, ...);
  38 SR_PRIV int lps_query_status(struct sr_dev_inst *sdi);
  39
  40 /* Serial communication parameters */
  41 #define SERIALCOMM "2400/8n1/dtr=1/rts=1/flow=0"
  42
  43 #define VENDOR_MOTECH "Motech"
  44
  45 /** Driver capabilities generic. */
  46 static const uint32_t drvopts[] = {
  47         /* Device class */
  48         SR_CONF_POWER_SUPPLY,
  49 };
  50
  51 /** Driver scanning options. */
  52 static const uint32_t scanopts[] = {
  53         SR_CONF_CONN,
  54         SR_CONF_SERIALCOMM,
  55 };
  56
  57 /** Hardware capabilities generic. */
  58 static const uint32_t devopts[] = {
  59         /* Device class */
  60         SR_CONF_POWER_SUPPLY,
  61         /* Acquisition modes. */
  62         SR_CONF_CONTINUOUS,
  63         SR_CONF_LIMIT_SAMPLES | SR_CONF_GET | SR_CONF_SET,
  64         SR_CONF_LIMIT_MSEC | SR_CONF_GET | SR_CONF_SET,
  65         /* Device configuration */
  66         SR_CONF_CHANNEL_CONFIG | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
  67 };
  68
  69 /** Hardware capabilities channel 1, 2. */
  70 static const uint32_t devopts_ch12[] = {
  71         SR_CONF_VOLTAGE | SR_CONF_GET,
  72         SR_CONF_VOLTAGE_TARGET | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
  73         SR_CONF_CURRENT | SR_CONF_GET,
  74         SR_CONF_CURRENT_LIMIT | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
  75         SR_CONF_ENABLED | SR_CONF_GET | SR_CONF_SET,
  76 };
  77
  78 /** Hardware capabilities channel 3. (LPS-304/305 only). */
  79 static const uint32_t devopts_ch3[] = {
  80         SR_CONF_VOLTAGE | SR_CONF_GET,
  81         SR_CONF_ENABLED | SR_CONF_GET | SR_CONF_SET,
  82 };
  83
  84 static const char *channel_modes[] = {
  85         "Independent",
  86         "Track1",
  87         "Track2",
  88 };
  89
  90 static const struct lps_modelspec models[] = {
  91         { LPS_UNKNOWN, "Dummy", 0,
  92                 {
  93
  94                 }
  95         },
  96         { LPS_301, "LPS-301", 1,
  97                 {
  98                         /* Channel 1 */
  99                         { { 0, 32, 0.01 }, { 0.005, 2, 0.001 } },
 100                 },
 101         },
 102         { LPS_302, "LPS-302", 1,
 103                 {
 104                         /* Channel 1 */
 105                         { { 0, 32, 0.01 }, { 0.005, 3, 0.001 } },
 106                 },
 107         },
 108         { LPS_303, "LPS-303", 1,
 109                 {
 110                         /* Channel 1 */
 111                         { { 0, 32, 0.01 }, { 0.005, 3, 0.001 } },
 112                 },
 113         },
 114         { LPS_304, "LPS-304", 3,
 115                 {
 116                         /* Channel 1 */
 117                         { { 0, 32, 0.01 }, { 0.005, 3, 0.001 } },
 118                         /* Channel 2 */
 119                         { { 0, 32, 0.01 }, { 0.005, 3, 0.001 } },
 120                         /* Channel 3 */
 121                         { { 5, 5, 0.0 }, { 0.005, 3, 0.001 } },
 122                 },
 123         },
 124         { LPS_305, "LPS-305", 3,
 125                 {
 126                         /* Channel 1 */
 127                         { { 0, 32, 0.01 }, { 0.005, 3, 0.001 } },
 128                         /* Channel 2 */
 129                         { { 0, 32, 0.01 }, { 0.005, 3, 0.001 } },
 130                         /* Channel 3 */
 131                         { { 3.3, 5, 1.7 }, { 0.005, 3, 0.001 } },
 132                 },
 133         },
 134 };
 135
 136 static int init_lps301(struct sr_dev_driver *di, struct sr_context *sr_ctx)
 137 {
 138         return std_init(sr_ctx, di, LOG_PREFIX);
 139 }
 140
 141 /** Send command to device with va_list.
 142  */
 143 SR_PRIV int lps_send_va(struct sr_serial_dev_inst *serial, const char *fmt, va_list args)
 144 {
 145         int retc;
 146         char auxfmt[LINELEN_MAX];
 147         char buf[LINELEN_MAX];
 148
 149         snprintf(auxfmt, sizeof(auxfmt), "%s\r\n", fmt);
 150         vsnprintf(buf, sizeof(buf), auxfmt, args);
 151
 152         sr_spew("lps_send_va: \"%s\"", buf);
 153
 154         retc = serial_write_blocking(serial, buf, strlen(buf),
 155                         serial_timeout(serial, strlen(buf)));
 156
 157         if (retc < 0)
 158                 return SR_ERR;
 159
 160         return SR_OK;
 161 }
 162
 163 /** Send command to device.
 164  */
 165 SR_PRIV int lps_send_req(struct sr_serial_dev_inst *serial, const char *fmt, ...)
 166 {
 167         int retc;
 168         va_list args;
 169
 170         va_start(args, fmt);
 171         retc = lps_send_va(serial, fmt, args);
 172         va_end(args);
 173
 174         return retc;
 175 }
 176
 177 /** Send command and consume simple OK reply. */
 178 SR_PRIV int lps_cmd_ok(struct sr_serial_dev_inst *serial, const char *fmt, ...)
 179 {
 180         int retc;
 181         va_list args;
 182         char buf[LINELEN_MAX];
 183         char *bufptr;
 184         int  buflen;
 185
 186         /* Send command */
 187         va_start(args, fmt);
 188         retc = lps_send_va(serial, fmt, args);
 189         va_end(args);
 190
 191         if (retc != SR_OK)
 192                 return SR_ERR;
 193
 194         /* Read reply */
 195         buf[0] = '\0';
 196         bufptr = buf;
 197         buflen = sizeof(buf);
 198         retc = lps_read_reply(serial, &bufptr, &buflen);
 199         if ((retc == SR_OK) && (buflen == 0))
 200                 return SR_OK;
 201
 202         return SR_ERR;
 203 }
 204
 205 /** Send command and read reply string.
 206  *  @param reply Pointer to buffer of size LINELEN_MAX. Will be NUL-terminated.
 207  */
 208 SR_PRIV int lps_cmd_reply(char *reply, struct sr_serial_dev_inst *serial, const char *fmt, ...)
 209 {
 210         int retc;
 211         va_list args;
 212         char buf[LINELEN_MAX];
 213         char *bufptr;
 214         int  buflen;
 215
 216         reply[0] = '\0';
 217
 218         /* Send command */
 219         va_start(args, fmt);
 220         retc = lps_send_va(serial, fmt, args);
 221         va_end(args);
 222
 223         if (retc != SR_OK)
 224                 return SR_ERR;
 225
 226         /* Read reply */
 227         buf[0] = '\0';
 228         bufptr = buf;
 229         buflen = sizeof(buf);
 230         retc = lps_read_reply(serial, &bufptr, &buflen);
 231         if ((retc == SR_OK) && (buflen > 0)) {
 232                 strcpy(reply, buf);
 233                 return SR_OK;
 234         }
 235
 236         return SR_ERR;
 237 }
 238
 239 /** Process integer value returned by STATUS command. */
 240 SR_PRIV int lps_process_status(struct sr_dev_inst *sdi, int stat)
 241 {
 242         struct dev_context *devc;
 243         int tracking_mode;
 244
 245         devc = sdi->priv;
 246
 247         sr_spew("Status: %d", stat);
 248         devc->channel_status[0].cc_mode = (stat & 0x01) != 0;
 249         sr_spew("Channel 1 %s mode", devc->channel_status[0].cc_mode?"CC":"CV");
 250         if (devc->model->num_channels > 1) {
 251                 devc->channel_status[1].cc_mode = (stat & 0x02) != 0;
 252                 sr_spew("Channel 2 %s mode", devc->channel_status[1].cc_mode?"CC":"CV");
 253
 254                 tracking_mode = (stat & 0x0c) >> 2;
 255                 switch (tracking_mode) {
 256                 case 0: devc->tracking_mode = 0;
 257                         break;
 258                 case 2: devc->tracking_mode = 1;
 259                         break;
 260                 case 3: devc->tracking_mode = 2;
 261                         break;
 262                 default:
 263                         sr_err("Illegal channel tracking mode %d!", tracking_mode);
 264                         devc->tracking_mode = 0;
 265                         break;
 266                 }
 267
 268                 sr_spew("Channel tracking: %d", devc->tracking_mode);
 269         }
 270         devc->channel_status[0].output_enabled = devc->channel_status[1].output_enabled = stat&0x040?TRUE:FALSE;
 271         sr_spew("Channel 1%s output: %s", devc->model->num_channels > 1?"+2":"", devc->channel_status[0].output_enabled?"ON":"OFF");
 272         if (devc->model->num_channels > 2) {
 273                 devc->channel_status[2].output_enabled = stat&0x010?TRUE:FALSE;
 274                 devc->channel_status[2].output_voltage_last = stat&0x020?3.3:5;
 275                 sr_spew("Channel 3 output: %s, U=%02f V, overload=%d",
 276                         devc->channel_status[2].output_enabled?"ON":"OFF",
 277                         devc->channel_status[2].output_voltage_last,
 278                         stat&0x080?1:0);
 279         }
 280         sr_spew("Fan=%d, beep=%d, CC output compensated=%d", stat&0x0100?1:0, stat&0x0200?1:0, stat&0x0400?1:0);
 281
 282         return SR_OK;
 283 }
 284
 285 /** Send STATUS commend and process status string. */
 286 SR_PRIV int lps_query_status(struct sr_dev_inst *sdi)
 287 {
 288         char buf[LINELEN_MAX];
 289         int stat, ret;
 290         struct dev_context *devc;
 291
 292         devc = sdi->priv;
 293
 294         devc->req_sent_at = g_get_real_time();
 295
 296         if ((ret = lps_cmd_reply(buf, sdi->conn, "STATUS")) < 0) {
 297                 sr_err("%s: Failed to read status: %s.", __func__,
 298                         sr_strerror(ret));
 299                 return SR_ERR;
 300         }
 301
 302         if (sr_atoi(buf, &stat) != SR_OK)
 303                 return SR_ERR;
 304
 305         return lps_process_status(sdi, stat);
 306 }
 307
 308 static gint64 calc_timeout_ms(gint64 start_us)
 309 {
 310         gint64 result = REQ_TIMEOUT_MS - ((g_get_real_time() - start_us) / 1000);
 311
 312         if (result < 0)
 313                 return 0;
 314
 315         return result;
 316 }
 317
 318 /** Read message into buf until "OK" received.
 319  *  @retval SR_OK Msg received; buf and buflen contain result, if any except OK.
 320  *  @retval SR_ERR Error, including timeout.
 321 */
 322 SR_PRIV int lps_read_reply(struct sr_serial_dev_inst *serial, char **buf, int *buflen)
 323 {
 324         int retries;
 325         char buf2[LINELEN_MAX];
 326         char *buf2ptr;
 327         int buf2len;
 328         gint64 timeout_start;
 329
 330         *buf[0] = '\0';
 331
 332         /* Read one line. It is either a data message or "OK". */
 333         timeout_start = g_get_real_time();
 334         buf2len = *buflen;
 335         /* Up to 5 tries because serial_readline() will consume only one CR or LF per
 336          * call, but device sends up to 4 in a row. */
 337         for (retries = 0; retries < 5; retries++) {
 338                 *buflen = buf2len;
 339                 if (serial_readline(serial, buf, buflen, calc_timeout_ms(timeout_start)) != SR_OK)
 340                         return SR_ERR;
 341                 if (!strcmp(*buf, "OK")) { /* We got an OK! */
 342                         *buf[0] = '\0';
 343                         *buflen = 0;
 344                         return SR_OK;
 345                 }
 346                 if (*buflen > 0) /* We got a msg! */
 347                         break;
 348         }
 349
 350         /* A data msg is in buf (possibly ERROR), need to consume "OK". */
 351         buf2[0] = '\0';
 352         buf2ptr = buf2;
 353         for (retries = 0; retries < 5; retries++) {
 354                 buf2len = sizeof(buf2);
 355                 if (serial_readline(serial, &buf2ptr, &buf2len, calc_timeout_ms(timeout_start)) != SR_OK)
 356                         return SR_ERR;
 357
 358                 if (!strcmp(buf2ptr, "OK")) { /* We got an OK! */
 359                         if (!strcmp(*buf, "ERROR")) { /* OK came after msg ERROR! */
 360                                 sr_spew("ERROR found!");
 361                                 *buf[0] = '\0';
 362                                 *buflen = 0;
 363                                 return SR_ERR;
 364                         }
 365                         return SR_OK;
 366                 }
 367         }
 368
 369         return SR_ERR; /* Timeout! */
 370 }
 371
 372 /** Scan for LPS-300 series device.
 373  */
 374 static GSList *do_scan(lps_modelid modelid, struct sr_dev_driver *drv, GSList *options)
 375 {
 376         struct sr_dev_inst *sdi;
 377         struct drv_context *drvc;
 378         struct dev_context *devc;
 379         struct sr_serial_dev_inst *serial;
 380         struct sr_channel *ch;
 381         struct sr_channel_group *cg;
 382         GSList *devices;
 383         const char *conn, *serialcomm;
 384         int cnt, ret;
 385         gchar buf[LINELEN_MAX];
 386         gchar channel[10];
 387         char *verstr;
 388
 389         sdi = NULL;
 390         devc = NULL;
 391         conn = serialcomm = NULL;
 392         devices = NULL;
 393
 394         drvc = drv->context;
 395         drvc->instances = NULL;
 396
 397         sr_spew("scan() called!");
 398
 399         /* Process and check options. */
 400         if (sr_serial_extract_options(options, &conn, &serialcomm) != SR_OK)
 401                 return NULL;
 402         if (!serialcomm)
 403                 serialcomm = SERIALCOMM;
 404
 405         /* Init serial port. */
 406         serial = sr_serial_dev_inst_new(conn, serialcomm);
 407
 408         if (serial_open(serial, SERIAL_RDWR) != SR_OK)
 409                 goto exit_err;
 410
 411         /* Query and verify model string. */
 412         serial_flush(serial);
 413         if (lps_cmd_reply(buf, serial, "MODEL") != SR_OK)
 414                 return NULL;
 415
 416         /* Check model string. */
 417         if (strncmp(buf, "LPS-", 4)) {
 418                 sr_spew("Unknown model code \"%s\"!", buf);
 419                 return NULL;
 420         }
 421
 422         /* Bug in device FW 1.17, model number is empty, so this can't work with this FW! */
 423         if (modelid == LPS_UNKNOWN) {
 424                 g_strstrip(buf);
 425                 for (cnt = LPS_301; cnt <= LPS_305; cnt++) {
 426                         if (!strcmp(buf, models[cnt].modelstr)) {
 427                                 modelid = cnt;
 428                                 break;
 429                         }
 430                 }
 431                 if (modelid == LPS_UNKNOWN) {
 432                         sr_err("Unable to detect model from model string '%s'!", buf);
 433                         return NULL;
 434                 }
 435         }
 436
 437         /* Query version */
 438         verstr = NULL;
 439         if ((ret = lps_cmd_reply(buf, serial, "VERSION")) == SR_OK) {
 440                 if (strncmp(buf, "Ver-", 4)) {
 441                         sr_spew("Version string %s not recognized.", buf);
 442                         goto exit_err;
 443                 }
 444
 445                 g_strstrip(buf);
 446                 verstr = buf + 4;
 447         }
 448         else  /* Bug in device FW 1.17: Querying version string fails while output is active.
 449                 Therefore just print an error message, but do not exit with error. */
 450                 sr_err("Failed to query for hardware version: %s.",
 451                         sr_strerror(ret));
 452
 453         sdi = g_malloc0(sizeof(struct sr_dev_inst));
 454         sdi->status = SR_ST_INACTIVE;
 455         sdi->vendor = g_strdup(VENDOR_MOTECH);
 456         sdi->model = g_strdup(models[modelid].modelstr);
 457         sdi->version = g_strdup(verstr);
 458         sdi->driver = drv;
 459         sdi->inst_type = SR_INST_SERIAL;
 460         sdi->conn = serial;
 461
 462         devc = g_malloc0(sizeof(struct dev_context));
 463         devc->model = &models[modelid];
 464         devc->limit_samples = 0;
 465         devc->limit_msec = 0;
 466         devc->num_samples = 0;
 467         devc->elapsed_msec = g_timer_new();
 468
 469         sdi->priv = devc;
 470
 471         /* Setup channels and channel groups. */
 472         for (cnt = 0; cnt < models[modelid].num_channels; cnt++) {
 473                 snprintf(channel, sizeof(channel), "CH%d", cnt + 1);
 474                 ch = sr_channel_new(sdi, cnt, SR_CHANNEL_ANALOG, TRUE, channel);
 475
 476                 devc->channel_status[cnt].info = g_slist_append(NULL, ch);
 477
 478                 cg = g_malloc(sizeof(struct sr_channel_group));
 479                 snprintf(channel, sizeof(channel), "CG%d", cnt+1);
 480                 cg->name = g_strdup(channel);
 481                 cg->priv = NULL;
 482                 cg->channels = g_slist_append(NULL, ch);
 483
 484                 sdi->channel_groups = g_slist_append(sdi->channel_groups, cg);
 485         }
 486
 487         drvc->instances = g_slist_append(drvc->instances, sdi);
 488         devices = g_slist_append(devices, sdi);
 489
 490         /* Query status */
 491         if (lps_query_status(sdi) != SR_OK)
 492                 goto exit_err;
 493
 494         serial_close(serial);
 495         if (!devices)
 496                 sr_serial_dev_inst_free(serial);
 497
 498         return devices;
 499
 500 exit_err:
 501         sr_info("%s: Error!", __func__);
 502
 503         if (serial) {
 504                 serial_close(serial);
 505                 sr_serial_dev_inst_free(serial);
 506         }
 507         g_free(devc);
 508         if (sdi)
 509                 sr_dev_inst_free(sdi);
 510
 511         return NULL;
 512 }
 513
 514 /** Scan for LPS-301 device. */
 515 static GSList *scan_lps301(struct sr_dev_driver *di, GSList *options)
 516 {
 517         return do_scan(LPS_301, di, options);
 518 }
 519
 520 static GSList *dev_list_lps301(const struct sr_dev_driver *di)
 521 {
 522         return ((struct drv_context *)(di->context))->instances;
 523 }
 524
 525 static void dev_clear_private(struct dev_context *devc)
 526 {
 527         int ch_idx;
 528
 529         /* Free channel_status.info (list only, data owned by sdi). */
 530         for (ch_idx = 0; ch_idx < devc->model->num_channels; ch_idx++)
 531                 g_slist_free(devc->channel_status[ch_idx].info);
 532
 533         g_timer_destroy(devc->elapsed_msec);
 534 }
 535
 536 static int dev_clear_lps301(const struct sr_dev_driver *di)
 537 {
 538         return std_dev_clear(di, (std_dev_clear_callback)dev_clear_private);
 539 }
 540
 541 static int config_get(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
 542                 const struct sr_channel_group *cg)
 543 {
 544         struct dev_context *devc;
 545         struct sr_channel *ch;
 546         int ch_idx;
 547
 548         if (!sdi)
 549                 return SR_ERR_ARG;
 550
 551         devc = sdi->priv;
 552
 553         if (!cg) {
 554                 /* No channel group: global options. */
 555                 switch (key) {
 556                 case SR_CONF_LIMIT_SAMPLES:
 557                         *data = g_variant_new_uint64(devc->limit_samples);
 558                         break;
 559                 case SR_CONF_LIMIT_MSEC:
 560                         *data = g_variant_new_uint64(devc->limit_msec);
 561                         break;
 562                 case SR_CONF_CHANNEL_CONFIG:
 563                         *data = g_variant_new_string(channel_modes[devc->tracking_mode]);
 564                         break;
 565                 default:
 566                         return SR_ERR_NA;
 567                 }
 568         } else {
 569                 /* We only ever have one channel per channel group in this driver. */
 570                 ch = cg->channels->data;
 571                 ch_idx = ch->index;
 572                 switch (key) {
 573                 case SR_CONF_VOLTAGE:
 574                         *data = g_variant_new_double(devc->channel_status[ch_idx].output_voltage_last);
 575                         break;
 576                 case SR_CONF_VOLTAGE_TARGET:
 577                         *data = g_variant_new_double(devc->channel_status[ch_idx].output_voltage_max);
 578                         break;
 579                 case SR_CONF_CURRENT:
 580                         *data = g_variant_new_double(devc->channel_status[ch_idx].output_current_last);
 581                         break;
 582                 case SR_CONF_CURRENT_LIMIT:
 583                         *data = g_variant_new_double(devc->channel_status[ch_idx].output_current_max);
 584                         break;
 585                 case SR_CONF_ENABLED:
 586                         *data = g_variant_new_boolean(devc->channel_status[ch_idx].output_enabled);
 587                         break;
 588                 default:
 589                         return SR_ERR_NA;
 590                 }
 591         }
 592
 593         return SR_OK;
 594 }
 595
 596 static int config_set(uint32_t key, GVariant *data, const struct sr_dev_inst *sdi,
 597                 const struct sr_channel_group *cg)
 598 {
 599         struct dev_context *devc;
 600         struct sr_channel *ch;
 601         gdouble dval;
 602         int ch_idx;
 603         const char *sval;
 604         gboolean bval;
 605         int idx;
 606         gboolean found;
 607
 608         if (sdi->status != SR_ST_ACTIVE)
 609                 return SR_ERR_DEV_CLOSED;
 610
 611         devc = sdi->priv;
 612
 613         /* Cannot change settings while acquisition active, would cause a mess with commands.
 614          * Changing this would be possible, but tricky. */
 615         if (devc->acq_running)
 616                 return SR_ERR_NA;
 617
 618         if (!cg) {
 619                 /* No channel group: global options. */
 620                 switch (key) {
 621                 case SR_CONF_LIMIT_MSEC:
 622                         devc->limit_msec = g_variant_get_uint64(data);
 623                         break;
 624                 case SR_CONF_LIMIT_SAMPLES:
 625                         devc->limit_samples = g_variant_get_uint64(data);
 626                         break;
 627                 case SR_CONF_CHANNEL_CONFIG:
 628                         sval = g_variant_get_string(data, NULL);
 629                         found = FALSE;
 630                         for (idx = 0; idx < (int)ARRAY_SIZE(channel_modes); idx++) {
 631                                 if (!strcmp(sval, channel_modes[idx])) {
 632                                         found = TRUE;
 633                                         if (devc->tracking_mode == idx)
 634                                                 break;  /* Nothing to do! */
 635                                         devc->tracking_mode = idx;
 636                                         if (devc->model->modelid >= LPS_304) /* No use to set anything in the smaller models. */
 637                                                 return lps_cmd_ok(sdi->conn, "TRACK%1d", devc->tracking_mode);
 638                                 }
 639                                 if (devc->model->modelid <= LPS_303) /* Only first setting possible for smaller models. */
 640                                         break;
 641                         }
 642                         if (!found)
 643                                 return SR_ERR_ARG;
 644                         break;
 645                 default:
 646                         return SR_ERR_NA;
 647                 }
 648         } else {
 649                 /* Channel group specified: per-channel options. */
 650                 /* We only ever have one channel per channel group in this driver. */
 651                 ch = cg->channels->data;
 652                 ch_idx = ch->index;
 653
 654                 switch (key) {
 655                 case SR_CONF_VOLTAGE_TARGET:
 656                         dval = g_variant_get_double(data);
 657                         if (dval < 0 || dval > devc->model->channels[ch_idx].voltage[1])
 658                                 return SR_ERR_ARG;
 659                         if (ch_idx == 2) {
 660                                 if (devc->model->modelid < LPS_304)
 661                                         return SR_ERR_ARG;
 662
 663                                 if (fabs(dval - 5.000) <= 0.001)
 664                                         dval = 5.0;
 665                                 else if ((devc->model->modelid >= LPS_305) && (fabs(dval - 3.300) <= 0.001))
 666                                         dval = 3.3;
 667                                 else return SR_ERR_ARG;
 668                         }
 669
 670                         devc->channel_status[ch_idx].output_voltage_max = dval;
 671                         if (ch_idx == 2)
 672                                 return lps_cmd_ok(sdi->conn, "VDD%1.0f", trunc(dval));
 673                         else
 674                                 return lps_cmd_ok(sdi->conn, "VSET%d %05.3f", ch_idx+1, dval);
 675                         break;
 676                 case SR_CONF_CURRENT_LIMIT:
 677                         dval = g_variant_get_double(data);
 678                         if (dval < 0 || dval > devc->model->channels[ch_idx].current[1])
 679                                 return SR_ERR_ARG;
 680                         if (ch_idx == 2) /* No current setting for CH3. */
 681                                 return SR_ERR_NA;
 682                         devc->channel_status[ch_idx].output_current_max = dval;
 683                         return lps_cmd_ok(sdi->conn, "ISET%d %05.4f", ch_idx+1, dval);
 684                         break;
 685                 case SR_CONF_ENABLED:
 686                         bval = g_variant_get_boolean(data);
 687                         if (bval == devc->channel_status[ch_idx].output_enabled) /* Nothing to do. */
 688                                 break;
 689                         devc->channel_status[ch_idx].output_enabled = bval;
 690                         if (ch_idx != 2) { /* Channels 1,2 can be set only together. */
 691                                 devc->channel_status[ch_idx^1].output_enabled = bval;
 692                                 return lps_cmd_ok(sdi->conn, "OUT%1d", (int)bval);
 693                         } else { /* Channel 3: No command to disable output, set voltage to 0 instead. */
 694                                 if (bval)
 695                                         return lps_cmd_ok(sdi->conn, "VDD%1.0f", devc->channel_status[ch_idx].output_voltage_max);
 696                                 else
 697                                         return lps_cmd_ok(sdi->conn, "VDD0");
 698                         }
 699                         break;
 700                 default:
 701                         return SR_ERR_NA;
 702                 }
 703         }
 704
 705         return SR_OK;
 706 }
 707
 708 static int config_list(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
 709                 const struct sr_channel_group *cg)
 710 {
 711         struct dev_context *devc;
 712         struct sr_channel *ch;
 713         int ch_idx, i;
 714         GVariant *gvar;
 715         GVariantBuilder gvb;
 716
 717         /* Driver options, no device instance necessary. */
 718         switch (key) {
 719         case SR_CONF_SCAN_OPTIONS:
 720                 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
 721                         scanopts, ARRAY_SIZE(scanopts), sizeof(uint32_t));
 722                 return SR_OK;
 723         case SR_CONF_DEVICE_OPTIONS:
 724                 if (sdi != NULL)
 725                         break;
 726                 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
 727                         drvopts, ARRAY_SIZE(drvopts), sizeof(uint32_t));
 728                 return SR_OK;
 729         default:
 730                 if (!sdi)
 731                         return SR_ERR_ARG;
 732                 devc = sdi->priv;
 733                 break;
 734         }
 735
 736         /* Device options, independent from channel groups. */
 737         if (!cg) {
 738                 switch (key) {
 739                 case SR_CONF_DEVICE_OPTIONS:
 740                         *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
 741                                         devopts, ARRAY_SIZE(devopts), sizeof(uint32_t));
 742                         return SR_OK;
 743                 case SR_CONF_CHANNEL_CONFIG:
 744                         if (devc->model->modelid <= LPS_303) {
 745                                 /* The 1-channel models. */
 746                                 *data = g_variant_new_strv(channel_modes, 1);
 747                         } else {
 748                                 /* The other models support all modes. */
 749                                 *data = g_variant_new_strv(channel_modes, ARRAY_SIZE(channel_modes));
 750                         }
 751                         return SR_OK;
 752                 default:
 753                         return SR_ERR_NA;
 754                 }
 755         }
 756
 757         /* Device options, depending on channel groups. */
 758         ch = cg->channels->data;
 759         ch_idx = ch->index;
 760         switch (key) {
 761         case SR_CONF_DEVICE_OPTIONS:
 762                 if ((ch_idx == 0) || (ch_idx == 1)) /* CH1, CH2 */
 763                         *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
 764                                   devopts_ch12, ARRAY_SIZE(devopts_ch12), sizeof(uint32_t));
 765                 else /* Must be CH3 */
 766                         *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
 767                                   devopts_ch3, ARRAY_SIZE(devopts_ch3), sizeof(uint32_t));
 768                 break;
 769         case SR_CONF_VOLTAGE_TARGET:
 770                 g_variant_builder_init(&gvb, G_VARIANT_TYPE_ARRAY);
 771                 /* Min, max, step. */
 772                 for (i = 0; i < 3; i++) {
 773                         gvar = g_variant_new_double(devc->model->channels[ch_idx].voltage[i]);
 774                         g_variant_builder_add_value(&gvb, gvar);
 775                 }
 776                 *data = g_variant_builder_end(&gvb);
 777                 break;
 778         case SR_CONF_CURRENT_LIMIT:
 779                 g_variant_builder_init(&gvb, G_VARIANT_TYPE_ARRAY);
 780                 /* Min, max, step. */
 781                 for (i = 0; i < 3; i++) {
 782                         gvar = g_variant_new_double(devc->model->channels[ch_idx].current[i]);
 783                         g_variant_builder_add_value(&gvb, gvar);
 784                 }
 785                 *data = g_variant_builder_end(&gvb);
 786                 break;
 787         default:
 788                 return SR_ERR_NA;
 789         }
 790
 791         return SR_OK;
 792 }
 793
 794 static int dev_acquisition_start(const struct sr_dev_inst *sdi)
 795 {
 796         struct dev_context *devc;
 797         struct sr_serial_dev_inst *serial;
 798
 799         if (sdi->status != SR_ST_ACTIVE)
 800                 return SR_ERR_DEV_CLOSED;
 801
 802         devc = sdi->priv;
 803
 804         devc->acq_running = TRUE;
 805
 806         serial = sdi->conn;
 807         serial_source_add(sdi->session, serial, G_IO_IN, 50,
 808                         motech_lps_30x_receive_data, (void *)sdi);
 809         std_session_send_df_header(sdi, LOG_PREFIX);
 810
 811         /* Start timer, if required. */
 812         if (devc->limit_msec)
 813                 g_timer_start(devc->elapsed_msec);
 814
 815         devc->acq_req = AQ_NONE;
 816         /* Do not start polling device here, the read function will do it in 50 ms. */
 817
 818         return SR_OK;
 819 }
 820
 821 static int dev_acquisition_stop(struct sr_dev_inst *sdi)
 822 {
 823         struct dev_context *devc;
 824
 825         /* Stop timer, if required. */
 826         if (sdi && (devc = sdi->priv) && devc->limit_msec)
 827                 g_timer_stop(devc->elapsed_msec);
 828
 829         return std_serial_dev_acquisition_stop(sdi, std_serial_dev_close,
 830                         sdi->conn, LOG_PREFIX);
 831 }
 832
 833 SR_PRIV struct sr_dev_driver motech_lps_301_driver_info = {
 834         .name = "motech-lps-301",
 835         .longname = "Motech LPS-301",
 836         .api_version = 1,
 837         .init = init_lps301,
 838         .cleanup = std_cleanup,
 839         .scan = scan_lps301,
 840         .dev_list = dev_list_lps301,
 841         .dev_clear = dev_clear_lps301,
 842         .config_get = config_get,
 843         .config_set = config_set,
 844         .config_list = config_list,
 845         .dev_open = std_serial_dev_open,
 846         .dev_close = std_serial_dev_close,
 847         .dev_acquisition_start = dev_acquisition_start,
 848         .dev_acquisition_stop = dev_acquisition_stop,
 849         .context = NULL,
 850 };