[libsigrok.git] / src / hardware / scpi-pps / protocol.h

/*
 * This file is part of the libsigrok project.
 *
 * Copyright (C) 2014 Bert Vermeulen <bert@biot.com>
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef LIBSIGROK_HARDWARE_SCPI_PPS_PROTOCOL_H
#define LIBSIGROK_HARDWARE_SCPI_PPS_PROTOCOL_H

#include <stdint.h>
#include <glib.h>
#include "libsigrok.h"
#include "libsigrok-internal.h"

#define LOG_PREFIX "scpi-pps"

enum pps_scpi_cmds {
	SCPI_CMD_KEY_UNLOCK,
	SCPI_CMD_GET_MEAS_VOLTAGE,
	SCPI_CMD_GET_MEAS_CURRENT,
	SCPI_CMD_GET_MEAS_POWER,
	SCPI_CMD_GET_VOLTAGE_MAX,
	SCPI_CMD_SET_VOLTAGE_MAX,
	SCPI_CMD_GET_CURRENT_MAX,
	SCPI_CMD_SET_CURRENT_MAX,
	SCPI_CMD_GET_OUTPUT_ENABLED,
	SCPI_CMD_SET_OUTPUT_ENABLED,
	SCPI_CMD_GET_OUTPUT_REGULATION,
	SCPI_CMD_GET_OVER_TEMPERATURE_PROTECTION,
	SCPI_CMD_SET_OVER_TEMPERATURE_PROTECTION,
	SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ENABLED,
	SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_ENABLED,
	SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ACTIVE,
	SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_THRESHOLD,
	SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_THRESHOLD,
	SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ENABLED,
	SCPI_CMD_SET_OVER_CURRENT_PROTECTION_ENABLED,
	SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ACTIVE,
	SCPI_CMD_GET_OVER_CURRENT_PROTECTION_THRESHOLD,
	SCPI_CMD_SET_OVER_CURRENT_PROTECTION_THRESHOLD,
	SCPI_CMD_GET_OUTPUT_CHANNEL_CONFIG,
	SCPI_CMD_SET_OUTPUT_CHANNEL_CONFIG,
};

/*
 * These are bit values denoting features a device can have either globally,
 * in scpi_pps.features, or on a per-channel-group basis in
 * channel_group_spec.features.
 */
enum pps_features {
	PPS_OTP           = (1 << 0),
	PPS_OVP           = (1 << 1),
	PPS_OCP           = (1 << 2),
	PPS_INDEPENDENT   = (1 << 3),
	PPS_SERIES        = (1 << 4),
	PPS_PARALLEL      = (1 << 5),
};

struct scpi_pps {
	int vendor_id;
	char *vendor;
	char *idn_vendor;
	char *idn_model;
	uint64_t features;
	const int32_t *devopts;
	unsigned int num_devopts;
	const int32_t *devopts_cg;
	unsigned int num_devopts_cg;
	struct channel_spec *channels;
	unsigned int num_channels;
	struct channel_group_spec *channel_groups;
	unsigned int num_channel_groups;
	struct scpi_command *commands;
	unsigned int num_commands;
};

struct channel_spec {
	char *name;
	/* Min, max, programming resolution. */
	float voltage[3];
	float current[3];
};

struct scpi_command {
	int command;
	char *string;
};

struct channel_group_spec {
	char *name;
	uint64_t channel_index_mask;
	uint64_t features;
};

struct pps_channel_group {
	uint64_t features;
};

enum acq_states {
	STATE_VOLTAGE,
	STATE_CURRENT,
	STATE_STOP,
};

/** Private, per-device-instance driver context. */
struct dev_context {
	/* Model-specific information */
	const struct scpi_pps *device;

	/* Acquisition settings */
	void *cb_data;

	/* Operational state */

	/* Temporary state across callbacks */
	int state;
	struct sr_channel *cur_channel;
};

SR_PRIV int scpi_cmd(const struct sr_dev_inst *sdi, int command, ...);
SR_PRIV int scpi_pps_receive_data(int fd, int revents, void *cb_data);

#endif
Commit	Line	Data
ca1a7cb5 BV	1	/*
	2	* This file is part of the libsigrok project.
	3	*
	4	* Copyright (C) 2014 Bert Vermeulen <bert@biot.com>
	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	#ifndef LIBSIGROK_HARDWARE_SCPI_PPS_PROTOCOL_H
	21	#define LIBSIGROK_HARDWARE_SCPI_PPS_PROTOCOL_H
	22
	23	#include <stdint.h>
	24	#include <glib.h>
	25	#include "libsigrok.h"
	26	#include "libsigrok-internal.h"
	27
	28	#define LOG_PREFIX "scpi-pps"
	29
9e45cd41 BV	30	enum pps_scpi_cmds {
	31	SCPI_CMD_KEY_UNLOCK,
	32	SCPI_CMD_GET_MEAS_VOLTAGE,
	33	SCPI_CMD_GET_MEAS_CURRENT,
	34	SCPI_CMD_GET_MEAS_POWER,
	35	SCPI_CMD_GET_VOLTAGE_MAX,
	36	SCPI_CMD_SET_VOLTAGE_MAX,
	37	SCPI_CMD_GET_CURRENT_MAX,
	38	SCPI_CMD_SET_CURRENT_MAX,
	39	SCPI_CMD_GET_OUTPUT_ENABLED,
	40	SCPI_CMD_SET_OUTPUT_ENABLED,
	41	SCPI_CMD_GET_OUTPUT_REGULATION,
	42	SCPI_CMD_GET_OVER_TEMPERATURE_PROTECTION,
	43	SCPI_CMD_SET_OVER_TEMPERATURE_PROTECTION,
	44	SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ENABLED,
	45	SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_ENABLED,
	46	SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_ACTIVE,
	47	SCPI_CMD_GET_OVER_VOLTAGE_PROTECTION_THRESHOLD,
	48	SCPI_CMD_SET_OVER_VOLTAGE_PROTECTION_THRESHOLD,
	49	SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ENABLED,
	50	SCPI_CMD_SET_OVER_CURRENT_PROTECTION_ENABLED,
	51	SCPI_CMD_GET_OVER_CURRENT_PROTECTION_ACTIVE,
	52	SCPI_CMD_GET_OVER_CURRENT_PROTECTION_THRESHOLD,
	53	SCPI_CMD_SET_OVER_CURRENT_PROTECTION_THRESHOLD,
	54	SCPI_CMD_GET_OUTPUT_CHANNEL_CONFIG,
	55	SCPI_CMD_SET_OUTPUT_CHANNEL_CONFIG,
	56	};
	57
	58	/*
	59	* These are bit values denoting features a device can have either globally,
	60	* in scpi_pps.features, or on a per-channel-group basis in
	61	* channel_group_spec.features.
	62	*/
	63	enum pps_features {
	64	PPS_OTP = (1 << 0),
	65	PPS_OVP = (1 << 1),
	66	PPS_OCP = (1 << 2),
	67	PPS_INDEPENDENT = (1 << 3),
	68	PPS_SERIES = (1 << 4),
	69	PPS_PARALLEL = (1 << 5),
	70	};
	71
	72	struct scpi_pps {
	73	int vendor_id;
	74	char *vendor;
	75	char *idn_vendor;
	76	char *idn_model;
	77	uint64_t features;
	78	const int32_t *devopts;
	79	unsigned int num_devopts;
	80	const int32_t *devopts_cg;
	81	unsigned int num_devopts_cg;
	82	struct channel_spec *channels;
	83	unsigned int num_channels;
	84	struct channel_group_spec *channel_groups;
	85	unsigned int num_channel_groups;
	86	struct scpi_command *commands;
	87	unsigned int num_commands;
	88	};
	89
	90	struct channel_spec {
	91	char *name;
	92	/* Min, max, programming resolution. */
	93	float voltage[3];
94	float current[3];
95	};
96
97	struct scpi_command {
98	int command;
99	char *string;
100	};
101
102	struct channel_group_spec {
103	char *name;
104	uint64_t channel_index_mask;
105	uint64_t features;
106	};
107
108	struct pps_channel_group {
109	uint64_t features;
110	};
111
112	enum acq_states {
113	STATE_VOLTAGE,
114	STATE_CURRENT,
115	STATE_STOP,
116	};
117
ca1a7cb5 BV	118	/** Private, per-device-instance driver context. */
	119	struct dev_context {
	120	/* Model-specific information */
9e45cd41	121	const struct scpi_pps *device;
ca1a7cb5 BV	122
ca1a7cb5 BV	123	/* Acquisition settings */
9e45cd41	124	void *cb_data;
ca1a7cb5 BV	125
	126	/* Operational state */
	127
	128	/* Temporary state across callbacks */
9e45cd41 BV	129	int state;
9e45cd41 BV	130	struct sr_channel *cur_channel;
ca1a7cb5 BV	131	};
ca1a7cb5 BV	132
9e45cd41	133	SR_PRIV int scpi_cmd(const struct sr_dev_inst *sdi, int command, ...);
ca1a7cb5 BV	134	SR_PRIV int scpi_pps_receive_data(int fd, int revents, void *cb_data);
	135
	136	#endif