2 * This file is part of the libsigrok project.
4 * Copyright (C) 2014 Bert Vermeulen <bert@biot.com>
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.
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.
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/>.
23 SR_PRIV struct sr_dev_driver scpi_pps_driver_info;
24 extern unsigned int num_pps_profiles;
25 extern const struct scpi_pps pps_profiles[];
27 static const uint32_t scanopts[] = {
32 static const uint32_t drvopts[] = {
36 static const struct pps_channel_instance pci[] = {
37 { SR_MQ_VOLTAGE, SCPI_CMD_GET_MEAS_VOLTAGE, "V" },
38 { SR_MQ_CURRENT, SCPI_CMD_GET_MEAS_CURRENT, "I" },
39 { SR_MQ_POWER, SCPI_CMD_GET_MEAS_POWER, "P" },
42 static int init(struct sr_dev_driver *di, struct sr_context *sr_ctx)
44 return std_init(sr_ctx, di, LOG_PREFIX);
47 static struct sr_dev_inst *probe_device(struct sr_scpi_dev_inst *scpi)
49 struct dev_context *devc;
50 struct sr_dev_inst *sdi;
51 struct sr_scpi_hw_info *hw_info;
52 struct sr_channel_group *cg;
53 struct sr_channel *ch;
54 const struct scpi_pps *device;
55 struct pps_channel *pch;
56 struct channel_spec *channels;
57 struct channel_group_spec *channel_groups, *cgs;
58 struct pps_channel_group *pcg;
63 unsigned int num_channels, num_channel_groups, ch_num, ch_idx, i, j;
68 if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK) {
69 sr_info("Couldn't get IDN response.");
74 for (i = 0; i < num_pps_profiles; i++) {
75 vendor = get_vendor(hw_info->manufacturer);
76 if (strcasecmp(vendor, pps_profiles[i].vendor))
78 model_re = g_regex_new(pps_profiles[i].model, 0, 0, NULL);
79 if (g_regex_match(model_re, hw_info->model, 0, &model_mi))
80 device = &pps_profiles[i];
81 g_match_info_unref(model_mi);
82 g_regex_unref(model_re);
87 sr_scpi_hw_info_free(hw_info);
91 sdi = g_malloc0(sizeof(struct sr_dev_inst));
92 sdi->status = SR_ST_INACTIVE;
93 sdi->vendor = g_strdup(vendor);
94 sdi->model = g_strdup(hw_info->model);
95 sdi->version = g_strdup(hw_info->firmware_version);
97 sdi->driver = &scpi_pps_driver_info;
98 sdi->inst_type = SR_INST_SCPI;
99 sdi->serial_num = g_strdup(hw_info->serial_number);
101 devc = g_malloc0(sizeof(struct dev_context));
102 devc->device = device;
105 if (device->num_channels) {
106 /* Static channels and groups. */
107 channels = (struct channel_spec *)device->channels;
108 num_channels = device->num_channels;
109 channel_groups = (struct channel_group_spec *)device->channel_groups;
110 num_channel_groups = device->num_channel_groups;
112 /* Channels and groups need to be probed. */
113 ret = device->probe_channels(sdi, hw_info, &channels, &num_channels,
114 &channel_groups, &num_channel_groups);
116 sr_err("Failed to probe for channels.");
120 * Since these were dynamically allocated, we'll need to free them
123 devc->channels = channels;
124 devc->channel_groups = channel_groups;
128 for (ch_num = 0; ch_num < num_channels; ch_num++) {
129 /* Create one channel per measurable output unit. */
130 for (i = 0; i < ARRAY_SIZE(pci); i++) {
131 if (!scpi_cmd_get(sdi, pci[i].command))
133 g_snprintf(ch_name, 16, "%s%s", pci[i].prefix,
134 channels[ch_num].name);
135 ch = sr_channel_new(sdi, ch_idx++, SR_CHANNEL_ANALOG, TRUE,
137 pch = g_malloc0(sizeof(struct pps_channel));
138 pch->hw_output_idx = ch_num;
139 pch->hwname = channels[ch_num].name;
145 for (i = 0; i < num_channel_groups; i++) {
146 cgs = &channel_groups[i];
147 cg = g_malloc0(sizeof(struct sr_channel_group));
148 cg->name = g_strdup(cgs->name);
149 for (j = 0, mask = 1; j < 64; j++, mask <<= 1) {
150 if (cgs->channel_index_mask & mask) {
151 for (l = sdi->channels; l; l = l->next) {
154 if (pch->hw_output_idx == j)
155 cg->channels = g_slist_append(cg->channels, ch);
159 pcg = g_malloc0(sizeof(struct pps_channel_group));
160 pcg->features = cgs->features;
162 sdi->channel_groups = g_slist_append(sdi->channel_groups, cg);
165 sr_scpi_hw_info_free(hw_info);
168 scpi_cmd(sdi, SCPI_CMD_LOCAL);
174 static GSList *scan(struct sr_dev_driver *di, GSList *options)
176 return sr_scpi_scan(di->priv, options, probe_device);
179 static GSList *dev_list(const struct sr_dev_driver *di)
181 return ((struct drv_context *)(di->priv))->instances;
184 static int dev_clear(const struct sr_dev_driver *di)
186 return std_dev_clear(di, NULL);
189 static int dev_open(struct sr_dev_inst *sdi)
191 struct dev_context *devc;
192 struct sr_scpi_dev_inst *scpi;
195 if (sdi->status != SR_ST_INACTIVE)
199 if (sr_scpi_open(scpi) < 0)
202 sdi->status = SR_ST_ACTIVE;
204 scpi_cmd(sdi, SCPI_CMD_REMOTE);
206 devc->beeper_was_set = FALSE;
207 if (scpi_cmd_resp(sdi, &beeper, G_VARIANT_TYPE_BOOLEAN, SCPI_CMD_BEEPER) == SR_OK) {
208 if (g_variant_get_boolean(beeper)) {
209 devc->beeper_was_set = TRUE;
210 scpi_cmd(sdi, SCPI_CMD_BEEPER_DISABLE);
212 g_variant_unref(beeper);
218 static int dev_close(struct sr_dev_inst *sdi)
220 struct sr_scpi_dev_inst *scpi;
221 struct dev_context *devc;
223 if (sdi->status != SR_ST_ACTIVE)
224 return SR_ERR_DEV_CLOSED;
229 if (devc->beeper_was_set)
230 scpi_cmd(sdi, SCPI_CMD_BEEPER_ENABLE);
231 scpi_cmd(sdi, SCPI_CMD_LOCAL);
233 sdi->status = SR_ST_INACTIVE;
239 static void clear_helper(void *priv)
241 struct dev_context *devc;
244 g_free(devc->channels);
245 g_free(devc->channel_groups);
249 static int cleanup(const struct sr_dev_driver *di)
251 return std_dev_clear(di, clear_helper);
254 static int config_get(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
255 const struct sr_channel_group *cg)
257 struct dev_context *devc;
258 const GVariantType *gvtype;
269 * These options only apply to channel groups with a single
270 * channel -- they're per-channel settings for the device.
274 * Config keys are handled below depending on whether a channel
275 * group was provided by the frontend. However some of these
276 * take a CG on one PPS but not on others. Check the device's
277 * profile for that here, and NULL out the channel group as needed.
279 for (i = 0; i < devc->device->num_devopts; i++) {
280 if (devc->device->devopts[i] == key) {
290 case SR_CONF_OUTPUT_ENABLED:
291 gvtype = G_VARIANT_TYPE_BOOLEAN;
292 cmd = SCPI_CMD_GET_OUTPUT_ENABLED;
294 case SR_CONF_OUTPUT_VOLTAGE:
295 gvtype = G_VARIANT_TYPE_DOUBLE;
296 cmd = SCPI_CMD_GET_MEAS_VOLTAGE;
298 case SR_CONF_OUTPUT_VOLTAGE_TARGET:
299 gvtype = G_VARIANT_TYPE_DOUBLE;
300 cmd = SCPI_CMD_GET_VOLTAGE_TARGET;
302 case SR_CONF_OUTPUT_CURRENT:
303 gvtype = G_VARIANT_TYPE_DOUBLE;
304 cmd = SCPI_CMD_GET_MEAS_CURRENT;
306 case SR_CONF_OUTPUT_CURRENT_LIMIT:
307 gvtype = G_VARIANT_TYPE_DOUBLE;
308 cmd = SCPI_CMD_GET_CURRENT_LIMIT;
310 case SR_CONF_OVER_VOLTAGE_PROTECTION_ENABLED:
311 gvtype = G_VARIANT_TYPE_BOOLEAN;
312 cmd = SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ENABLED;
314 case SR_CONF_OVER_VOLTAGE_PROTECTION_ACTIVE:
315 gvtype = G_VARIANT_TYPE_BOOLEAN;
316 cmd = SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ACTIVE;
318 case SR_CONF_OVER_VOLTAGE_PROTECTION_THRESHOLD:
319 gvtype = G_VARIANT_TYPE_DOUBLE;
320 cmd = SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_THRESHOLD;
322 case SR_CONF_OVER_CURRENT_PROTECTION_ENABLED:
323 gvtype = G_VARIANT_TYPE_BOOLEAN;
324 cmd = SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ENABLED;
326 case SR_CONF_OVER_CURRENT_PROTECTION_ACTIVE:
327 gvtype = G_VARIANT_TYPE_BOOLEAN;
328 cmd = SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ACTIVE;
330 case SR_CONF_OVER_CURRENT_PROTECTION_THRESHOLD:
331 gvtype = G_VARIANT_TYPE_DOUBLE;
332 cmd = SCPI_CMD_GET_OVER_CURRENT_PROTECTION_THRESHOLD;
334 case SR_CONF_OVER_TEMPERATURE_PROTECTION:
335 gvtype = G_VARIANT_TYPE_BOOLEAN;
336 cmd = SCPI_CMD_GET_OVER_TEMPERATURE_PROTECTION;
338 case SR_CONF_OUTPUT_REGULATION:
339 gvtype = G_VARIANT_TYPE_STRING;
340 cmd = SCPI_CMD_GET_OUTPUT_REGULATION;
344 select_channel(sdi, cg->channels->data);
345 ret = scpi_cmd_resp(sdi, data, gvtype, cmd);
352 static int config_set(uint32_t key, GVariant *data, const struct sr_dev_inst *sdi,
353 const struct sr_channel_group *cg)
361 if (sdi->status != SR_ST_ACTIVE)
362 return SR_ERR_DEV_CLOSED;
365 /* Channel group specified. */
366 select_channel(sdi, cg->channels->data);
370 case SR_CONF_OUTPUT_ENABLED:
371 if (g_variant_get_boolean(data))
372 ret = scpi_cmd(sdi, SCPI_CMD_SET_OUTPUT_ENABLE);
374 ret = scpi_cmd(sdi, SCPI_CMD_SET_OUTPUT_DISABLE);
376 case SR_CONF_OUTPUT_VOLTAGE_TARGET:
377 d = g_variant_get_double(data);
378 ret = scpi_cmd(sdi, SCPI_CMD_SET_VOLTAGE_TARGET, d);
380 case SR_CONF_OUTPUT_CURRENT_LIMIT:
381 d = g_variant_get_double(data);
382 ret = scpi_cmd(sdi, SCPI_CMD_SET_CURRENT_LIMIT, d);
384 case SR_CONF_OVER_VOLTAGE_PROTECTION_ENABLED:
385 if (g_variant_get_boolean(data))
386 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_ENABLE);
388 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_DISABLE);
390 case SR_CONF_OVER_VOLTAGE_PROTECTION_THRESHOLD:
391 d = g_variant_get_double(data);
392 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_THRESHOLD, d);
394 case SR_CONF_OVER_CURRENT_PROTECTION_ENABLED:
395 if (g_variant_get_boolean(data))
396 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_CURRENT_PROTECTION_ENABLE);
398 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_CURRENT_PROTECTION_DISABLE);
400 case SR_CONF_OVER_CURRENT_PROTECTION_THRESHOLD:
401 d = g_variant_get_double(data);
402 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_CURRENT_PROTECTION_THRESHOLD, d);
404 case SR_CONF_OVER_TEMPERATURE_PROTECTION:
405 if (g_variant_get_boolean(data))
406 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_TEMPERATURE_PROTECTION_ENABLE);
408 ret = scpi_cmd(sdi, SCPI_CMD_SET_OVER_TEMPERATURE_PROTECTION_DISABLE);
417 static int config_list(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
418 const struct sr_channel_group *cg)
420 struct dev_context *devc;
421 struct sr_channel *ch;
422 const struct channel_spec *ch_spec;
428 /* Always available, even without sdi. */
429 if (key == SR_CONF_SCAN_OPTIONS) {
430 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
431 scanopts, ARRAY_SIZE(scanopts), sizeof(uint32_t));
433 } else if (key == SR_CONF_DEVICE_OPTIONS && !sdi) {
434 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
435 drvopts, ARRAY_SIZE(drvopts), sizeof(uint32_t));
445 /* No channel group: global options. */
447 case SR_CONF_DEVICE_OPTIONS:
448 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
449 devc->device->devopts, devc->device->num_devopts,
452 case SR_CONF_OUTPUT_CHANNEL_CONFIG:
455 if (devc->device->features & PPS_INDEPENDENT)
456 s[i++] = "Independent";
457 if (devc->device->features & PPS_SERIES)
459 if (devc->device->features & PPS_PARALLEL)
463 * Shouldn't happen: independent-only devices
464 * shouldn't advertise this option at all.
468 *data = g_variant_new_strv(s, i);
474 /* Channel group specified. */
476 * Per-channel-group options depending on a channel are actually
477 * done with the first channel. Channel groups in PPS can have
478 * more than one channel, but they will typically be of equal
479 * specification for use in series or parallel mode.
481 ch = cg->channels->data;
484 case SR_CONF_DEVICE_OPTIONS:
485 *data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
486 devc->device->devopts_cg, devc->device->num_devopts_cg,
489 case SR_CONF_OUTPUT_VOLTAGE_TARGET:
490 ch_spec = &(devc->device->channels[ch->index]);
491 g_variant_builder_init(&gvb, G_VARIANT_TYPE_ARRAY);
492 /* Min, max, write resolution. */
493 for (i = 0; i < 3; i++) {
494 gvar = g_variant_new_double(ch_spec->voltage[i]);
495 g_variant_builder_add_value(&gvb, gvar);
497 *data = g_variant_builder_end(&gvb);
499 case SR_CONF_OUTPUT_CURRENT_LIMIT:
500 g_variant_builder_init(&gvb, G_VARIANT_TYPE_ARRAY);
501 /* Min, max, step. */
502 for (i = 0; i < 3; i++) {
503 ch_spec = &(devc->device->channels[ch->index]);
504 gvar = g_variant_new_double(ch_spec->current[i]);
505 g_variant_builder_add_value(&gvb, gvar);
507 *data = g_variant_builder_end(&gvb);
517 static int dev_acquisition_start(const struct sr_dev_inst *sdi,
520 struct dev_context *devc;
521 struct sr_scpi_dev_inst *scpi;
522 struct sr_channel *ch;
523 struct pps_channel *pch;
526 if (sdi->status != SR_ST_ACTIVE)
527 return SR_ERR_DEV_CLOSED;
531 devc->cb_data = cb_data;
533 if ((ret = sr_scpi_source_add(sdi->session, scpi, G_IO_IN, 10,
534 scpi_pps_receive_data, (void *)sdi)) != SR_OK)
536 std_session_send_df_header(sdi, LOG_PREFIX);
538 /* Prime the pipe with the first channel's fetch. */
539 ch = next_enabled_channel(sdi, NULL);
541 if ((ret = select_channel(sdi, ch)) != SR_OK)
543 if (pch->mq == SR_MQ_VOLTAGE)
544 cmd = SCPI_CMD_GET_MEAS_VOLTAGE;
545 else if (pch->mq == SR_MQ_CURRENT)
546 cmd = SCPI_CMD_GET_MEAS_CURRENT;
547 else if (pch->mq == SR_MQ_POWER)
548 cmd = SCPI_CMD_GET_MEAS_POWER;
551 scpi_cmd(sdi, cmd, pch->hwname);
556 static int dev_acquisition_stop(struct sr_dev_inst *sdi, void *cb_data)
558 struct sr_datafeed_packet packet;
559 struct sr_scpi_dev_inst *scpi;
564 if (sdi->status != SR_ST_ACTIVE)
565 return SR_ERR_DEV_CLOSED;
570 * A requested value is certainly on the way. Retrieve it now,
571 * to avoid leaving the device in a state where it's not expecting
574 sr_scpi_get_float(scpi, NULL, &f);
575 sr_scpi_source_remove(sdi->session, scpi);
577 packet.type = SR_DF_END;
578 sr_session_send(sdi, &packet);
583 SR_PRIV struct sr_dev_driver scpi_pps_driver_info = {
585 .longname = "SCPI PPS",
590 .dev_list = dev_list,
591 .dev_clear = dev_clear,
592 .config_get = config_get,
593 .config_set = config_set,
594 .config_list = config_list,
595 .dev_open = dev_open,
596 .dev_close = dev_close,
597 .dev_acquisition_start = dev_acquisition_start,
598 .dev_acquisition_stop = dev_acquisition_stop,