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