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/>.
20 #ifndef LIBSIGROK_HARDWARE_SCPI_PPS_PROTOCOL_H
21 #define LIBSIGROK_HARDWARE_SCPI_PPS_PROTOCOL_H
25 #include "libsigrok.h"
26 #include "libsigrok-internal.h"
28 #define LOG_PREFIX "scpi-pps"
34 SCPI_CMD_BEEPER_ENABLE,
35 SCPI_CMD_BEEPER_DISABLE,
36 SCPI_CMD_SELECT_CHANNEL,
37 SCPI_CMD_GET_MEAS_VOLTAGE,
38 SCPI_CMD_GET_MEAS_CURRENT,
39 SCPI_CMD_GET_MEAS_POWER,
40 SCPI_CMD_GET_VOLTAGE_TARGET,
41 SCPI_CMD_SET_VOLTAGE_TARGET,
42 SCPI_CMD_GET_CURRENT_LIMIT,
43 SCPI_CMD_SET_CURRENT_LIMIT,
44 SCPI_CMD_GET_OUTPUT_ENABLED,
45 SCPI_CMD_SET_OUTPUT_ENABLE,
46 SCPI_CMD_SET_OUTPUT_DISABLE,
47 SCPI_CMD_GET_OUTPUT_REGULATION,
48 SCPI_CMD_GET_OVER_TEMPERATURE_PROTECTION,
49 SCPI_CMD_SET_OVER_TEMPERATURE_PROTECTION_ENABLE,
50 SCPI_CMD_SET_OVER_TEMPERATURE_PROTECTION_DISABLE,
51 SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ENABLED,
52 SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_ENABLE,
53 SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_DISABLE,
54 SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ACTIVE,
55 SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_THRESHOLD,
56 SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_THRESHOLD,
57 SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ENABLED,
58 SCPI_CMD_SET_OVER_CURRENT_PROTECTION_ENABLE,
59 SCPI_CMD_SET_OVER_CURRENT_PROTECTION_DISABLE,
60 SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ACTIVE,
61 SCPI_CMD_GET_OVER_CURRENT_PROTECTION_THRESHOLD,
62 SCPI_CMD_SET_OVER_CURRENT_PROTECTION_THRESHOLD,
66 * These are bit values denoting features a device can have either globally,
67 * in scpi_pps.features, or on a per-channel-group basis in
68 * channel_group_spec.features.
74 PPS_INDEPENDENT = (1 << 3),
75 PPS_SERIES = (1 << 4),
76 PPS_PARALLEL = (1 << 5),
83 const uint32_t *devopts;
84 unsigned int num_devopts;
85 const uint32_t *devopts_cg;
86 unsigned int num_devopts_cg;
87 struct channel_spec *channels;
88 unsigned int num_channels;
89 struct channel_group_spec *channel_groups;
90 unsigned int num_channel_groups;
91 struct scpi_command *commands;
92 unsigned int num_commands;
93 int (*probe_channels) (struct sr_dev_inst *sdi, struct sr_scpi_hw_info *hwinfo,
94 struct channel_spec **channels, unsigned int *num_channels,
95 struct channel_group_spec **channel_groups, unsigned int *num_channel_groups);
100 /* Min, max, programming resolution. */
105 struct scpi_command {
110 struct channel_group_spec {
112 uint64_t channel_index_mask;
118 unsigned int hw_output_idx;
122 struct pps_channel_instance {
128 struct pps_channel_group {
138 /** Private, per-device-instance driver context. */
140 /* Model-specific information */
141 const struct scpi_pps *device;
143 /* Acquisition settings */
146 /* Operational state */
147 gboolean beeper_was_set;
148 struct channel_spec *channels;
149 struct channel_group_spec *channel_groups;
151 /* Temporary state across callbacks */
152 struct sr_channel *cur_channel;
155 const char *get_vendor(const char *raw_vendor);
156 SR_PRIV char *scpi_cmd_get(const struct sr_dev_inst *sdi, int command);
157 SR_PRIV int scpi_cmd(const struct sr_dev_inst *sdi, int command, ...);
158 SR_PRIV int scpi_cmd_resp(const struct sr_dev_inst *sdi, GVariant **gvar,
159 const GVariantType *gvtype, int command, ...);
160 SR_PRIV int select_channel(const struct sr_dev_inst *sdi, struct sr_channel *ch);
161 SR_PRIV struct sr_channel *next_enabled_channel(const struct sr_dev_inst *sdi,
162 struct sr_channel *cur_channel);
163 SR_PRIV int scpi_pps_receive_data(int fd, int revents, void *cb_data);