[libsigrok.git] / src / hardware / rohde-schwarz-sme-0x / api.c

/*
 * This file is part of the libsigrok project.
 *
 * Copyright (C) 2016 Vlad Ivanov <vlad.ivanov@lab-systems.ru>
 *
 * 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/>.
 */

#include <config.h>
#include <libserialport.h>
#include <scpi.h>
#include <string.h>

#include "protocol.h"

SR_PRIV struct sr_dev_driver rohde_schwarz_sme_0x_driver_info;

static const char *manufacturer = "Rohde&Schwarz";

static const struct rs_device_model device_models[] = {
	{
		.model_str = "SME02",
		.freq_max = SR_GHZ(1.5),
		.freq_min = SR_KHZ(5),
		.power_max = 16,
		.power_min = -144,
	},
	{
		.model_str = "SME03E",
		.freq_max = SR_GHZ(2.2),
		.freq_min = SR_KHZ(5),
		.power_max = 16,
		.power_min = -144,
	},
	{
		.model_str = "SME03A",
		.freq_max = SR_GHZ(3),
		.freq_min = SR_KHZ(5),
		.power_max = 16,
		.power_min = -144,
	},
	{
		.model_str = "SME03",
		.freq_max = SR_GHZ(3),
		.freq_min = SR_KHZ(5),
		.power_max = 16,
		.power_min = -144,
	},
	{
		.model_str = "SME06",
		.freq_max = SR_GHZ(1.5),
		.freq_min = SR_KHZ(5),
		.power_max = 16,
		.power_min = -144,
	}
};

static const uint32_t scanopts[] = {
	SR_CONF_CONN,
	SR_CONF_SERIALCOMM,
};

static const uint32_t drvopts[] = {
        SR_CONF_SIGNAL_GENERATOR,
};

static const uint32_t devopts[] = {
	SR_CONF_OUTPUT_FREQUENCY | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
	SR_CONF_AMPLITUDE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
};

static int rs_init_device(struct sr_dev_inst *sdi)
{
	struct dev_context *devc;
	uint8_t model_found;

	devc = sdi->priv;
	model_found = 0;

	for (size_t i = 0; i < ARRAY_SIZE(device_models); i++) {
		if (!strcmp(device_models[i].model_str, sdi->model)) {
			model_found = 1;
			devc->model_config = &device_models[i];
			break;
		}
	}

	if (!model_found) {
		sr_dbg("Device %s %s is not supported by this driver.",
			manufacturer, sdi->model);
		return SR_ERR_NA;
	}

	return SR_OK;
}

static struct sr_dev_inst *rs_probe_serial_device(struct sr_scpi_dev_inst *scpi)
{
	struct sr_dev_inst *sdi;
	struct dev_context *devc;
	struct sr_scpi_hw_info *hw_info;

	sdi = NULL;
	devc = NULL;
	hw_info = NULL;

	rs_sme0x_mode_remote(scpi);

	if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK)
		goto fail;

	if (strcmp(hw_info->manufacturer, manufacturer) != 0)
		goto fail;

	sdi = g_malloc0(sizeof(struct sr_dev_inst));
	sdi->vendor = g_strdup(hw_info->manufacturer);
	sdi->model = g_strdup(hw_info->model);
	sdi->version = g_strdup(hw_info->firmware_version);
	sdi->serial_num = g_strdup(hw_info->serial_number);
	sdi->driver = &rohde_schwarz_sme_0x_driver_info;
	sdi->inst_type = SR_INST_SCPI;
	sdi->conn = scpi;

	sr_scpi_hw_info_free(hw_info);
	hw_info = NULL;

	devc = g_malloc0(sizeof(struct dev_context));
	sdi->priv = devc;

	if (rs_init_device(sdi) != SR_OK)
		goto fail;

	return sdi;

fail:
	sr_scpi_hw_info_free(hw_info);
	sr_dev_inst_free(sdi);
	g_free(devc);
	return NULL;
}

static GSList *scan(struct sr_dev_driver *di, GSList *options)
{
	return sr_scpi_scan(di->context, options, rs_probe_serial_device);
}

static int dev_clear(const struct sr_dev_driver *di)
{
	return std_dev_clear(di, NULL);
}

static int dev_open(struct sr_dev_inst *sdi)
{
	if ((sdi->status != SR_ST_ACTIVE) && (sr_scpi_open(sdi->conn) != SR_OK))
		return SR_ERR;

	sdi->status = SR_ST_ACTIVE;

	return SR_OK;
}

static int dev_close(struct sr_dev_inst *sdi)
{
	if (sdi->status == SR_ST_INACTIVE)
		return SR_OK;

	sr_scpi_close(sdi->conn);

	sdi->status = SR_ST_INACTIVE;

	return SR_OK;
}

static int config_get(uint32_t key, GVariant **data,
	const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
{
	double value_f;

	(void) cg;

	switch (key) {
	case SR_CONF_OUTPUT_FREQUENCY:
		rs_sme0x_get_freq(sdi, &value_f);
		*data = g_variant_new_double(value_f);
		break;
	case SR_CONF_AMPLITUDE:
		rs_sme0x_get_power(sdi, &value_f);
		*data = g_variant_new_double(value_f);
		break;
	default:
		return SR_ERR_NA;
	}

	return SR_OK;
}

static int config_set(uint32_t key, GVariant *data,
	const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
{
	double value_f;

	(void)cg;

	if (!sdi)
		return SR_ERR_ARG;

	if (sdi->status != SR_ST_ACTIVE)
		return SR_ERR_DEV_CLOSED;

	switch (key) {
	case SR_CONF_OUTPUT_FREQUENCY:
		value_f = g_variant_get_double(data);
		rs_sme0x_set_freq(sdi, value_f);
		break;
	case SR_CONF_AMPLITUDE:
		value_f = g_variant_get_double(data);
		rs_sme0x_set_power(sdi, value_f);
		break;
	default:
		return SR_ERR_NA;
	}

	return SR_OK;
}

static int config_list(uint32_t key, GVariant **data,
	const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
{
	(void)sdi;
	(void)cg;

	/* Return drvopts without sdi (and devopts with sdi, see below). */
	if (key == SR_CONF_DEVICE_OPTIONS && !sdi) {
		*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
				drvopts, ARRAY_SIZE(drvopts), sizeof(uint32_t));
		return SR_OK;
	}

	switch (key) {
	case SR_CONF_SCAN_OPTIONS:
		*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
			scanopts, ARRAY_SIZE(scanopts), sizeof(uint32_t));
		break;
	case SR_CONF_DEVICE_OPTIONS:
		*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
			devopts, ARRAY_SIZE(devopts), sizeof(uint32_t));
		break;
	default:
		return SR_ERR_NA;
	}

	return SR_OK;
}

static int dev_acquisition_start(const struct sr_dev_inst *sdi)
{
	if (sdi->status != SR_ST_ACTIVE)
		return SR_ERR_DEV_CLOSED;

	return SR_OK;
}

SR_PRIV struct sr_dev_driver rohde_schwarz_sme_0x_driver_info = {
	.name = "rohde-schwarz-sme-0x",
	.longname = "Rohde&Schwarz SME-0x",
	.api_version = 1,
	.init = std_init,
	.cleanup = std_cleanup,
	.scan = scan,
	.dev_list = std_dev_list,
	.dev_clear = dev_clear,
	.config_get = config_get,
	.config_set = config_set,
	.config_list = config_list,
	.dev_open = dev_open,
	.dev_close = dev_close,
	.dev_acquisition_start = dev_acquisition_start,
	.dev_acquisition_stop = std_serial_dev_acquisition_stop,
	.context = NULL,
};

SR_REGISTER_DEV_DRIVER(rohde_schwarz_sme_0x_driver_info);
Commit	Line	Data
	1	/*
	2	* This file is part of the libsigrok project.
	3	*
	4	* Copyright (C) 2016 Vlad Ivanov <vlad.ivanov@lab-systems.ru>
	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	#include <config.h>
	21	#include <libserialport.h>
	22	#include <scpi.h>
	23	#include <string.h>
	24
	25	#include "protocol.h"
	26
	27	SR_PRIV struct sr_dev_driver rohde_schwarz_sme_0x_driver_info;
	28
	29	static const char *manufacturer = "Rohde&Schwarz";
	30
	31	static const struct rs_device_model device_models[] = {
	32	{
	33	.model_str = "SME02",
	34	.freq_max = SR_GHZ(1.5),
	35	.freq_min = SR_KHZ(5),
	36	.power_max = 16,
	37	.power_min = -144,
	38	},
	39	{
	40	.model_str = "SME03E",
	41	.freq_max = SR_GHZ(2.2),
	42	.freq_min = SR_KHZ(5),
	43	.power_max = 16,
	44	.power_min = -144,
	45	},
	46	{
	47	.model_str = "SME03A",
	48	.freq_max = SR_GHZ(3),
	49	.freq_min = SR_KHZ(5),
	50	.power_max = 16,
	51	.power_min = -144,
	52	},
	53	{
	54	.model_str = "SME03",
	55	.freq_max = SR_GHZ(3),
	56	.freq_min = SR_KHZ(5),
	57	.power_max = 16,
	58	.power_min = -144,
	59	},
	60	{
	61	.model_str = "SME06",
	62	.freq_max = SR_GHZ(1.5),
	63	.freq_min = SR_KHZ(5),
	64	.power_max = 16,
	65	.power_min = -144,
	66	}
	67	};
	68
	69	static const uint32_t scanopts[] = {
	70	SR_CONF_CONN,
	71	SR_CONF_SERIALCOMM,
	72	};
	73
	74	static const uint32_t drvopts[] = {
	75	SR_CONF_SIGNAL_GENERATOR,
	76	};
	77
	78	static const uint32_t devopts[] = {
	79	SR_CONF_OUTPUT_FREQUENCY \| SR_CONF_GET \| SR_CONF_SET \| SR_CONF_LIST,
	80	SR_CONF_AMPLITUDE \| SR_CONF_GET \| SR_CONF_SET \| SR_CONF_LIST,
	81	};
	82
	83	static int rs_init_device(struct sr_dev_inst *sdi)
	84	{
	85	struct dev_context *devc;
	86	uint8_t model_found;
	87
	88	devc = sdi->priv;
	89	model_found = 0;
	90
	91	for (size_t i = 0; i < ARRAY_SIZE(device_models); i++) {
	92	if (!strcmp(device_models[i].model_str, sdi->model)) {
	93	model_found = 1;
	94	devc->model_config = &device_models[i];
	95	break;
	96	}
	97	}
	98
	99	if (!model_found) {
	100	sr_dbg("Device %s %s is not supported by this driver.",
	101	manufacturer, sdi->model);
	102	return SR_ERR_NA;
	103	}
	104
	105	return SR_OK;
	106	}
	107
	108	static struct sr_dev_inst rs_probe_serial_device(struct sr_scpi_dev_inst scpi)
	109	{
	110	struct sr_dev_inst *sdi;
	111	struct dev_context *devc;
	112	struct sr_scpi_hw_info *hw_info;
	113
	114	sdi = NULL;
	115	devc = NULL;
	116	hw_info = NULL;
	117
	118	rs_sme0x_mode_remote(scpi);
	119
	120	if (sr_scpi_get_hw_id(scpi, &hw_info) != SR_OK)
	121	goto fail;
	122
	123	if (strcmp(hw_info->manufacturer, manufacturer) != 0)
	124	goto fail;
	125
	126	sdi = g_malloc0(sizeof(struct sr_dev_inst));
	127	sdi->vendor = g_strdup(hw_info->manufacturer);
	128	sdi->model = g_strdup(hw_info->model);
	129	sdi->version = g_strdup(hw_info->firmware_version);
	130	sdi->serial_num = g_strdup(hw_info->serial_number);
	131	sdi->driver = &rohde_schwarz_sme_0x_driver_info;
	132	sdi->inst_type = SR_INST_SCPI;
	133	sdi->conn = scpi;
	134
	135	sr_scpi_hw_info_free(hw_info);
	136	hw_info = NULL;
	137
	138	devc = g_malloc0(sizeof(struct dev_context));
	139	sdi->priv = devc;
	140
	141	if (rs_init_device(sdi) != SR_OK)
	142	goto fail;
	143
	144	return sdi;
	145
	146	fail:
	147	sr_scpi_hw_info_free(hw_info);
	148	sr_dev_inst_free(sdi);
	149	g_free(devc);
	150	return NULL;
	151	}
	152
	153	static GSList scan(struct sr_dev_driver di, GSList *options)
	154	{
	155	return sr_scpi_scan(di->context, options, rs_probe_serial_device);
	156	}
	157
	158	static int dev_clear(const struct sr_dev_driver *di)
	159	{
	160	return std_dev_clear(di, NULL);
	161	}
	162
	163	static int dev_open(struct sr_dev_inst *sdi)
	164	{
	165	if ((sdi->status != SR_ST_ACTIVE) && (sr_scpi_open(sdi->conn) != SR_OK))
	166	return SR_ERR;
	167
	168	sdi->status = SR_ST_ACTIVE;
	169
	170	return SR_OK;
	171	}
	172
	173	static int dev_close(struct sr_dev_inst *sdi)
	174	{
	175	if (sdi->status == SR_ST_INACTIVE)
	176	return SR_OK;
	177
	178	sr_scpi_close(sdi->conn);
	179
	180	sdi->status = SR_ST_INACTIVE;
	181
	182	return SR_OK;
	183	}
	184
	185	static int config_get(uint32_t key, GVariant **data,
	186	const struct sr_dev_inst sdi, const struct sr_channel_group cg)
	187	{
	188	double value_f;
	189
	190	(void) cg;
	191
	192	switch (key) {
	193	case SR_CONF_OUTPUT_FREQUENCY:
	194	rs_sme0x_get_freq(sdi, &value_f);
	195	*data = g_variant_new_double(value_f);
	196	break;
	197	case SR_CONF_AMPLITUDE:
	198	rs_sme0x_get_power(sdi, &value_f);
	199	*data = g_variant_new_double(value_f);
	200	break;
	201	default:
	202	return SR_ERR_NA;
	203	}
	204
	205	return SR_OK;
	206	}
	207
	208	static int config_set(uint32_t key, GVariant *data,
	209	const struct sr_dev_inst sdi, const struct sr_channel_group cg)
	210	{
	211	double value_f;
	212
	213	(void)cg;
	214
	215	if (!sdi)
	216	return SR_ERR_ARG;
	217
	218	if (sdi->status != SR_ST_ACTIVE)
	219	return SR_ERR_DEV_CLOSED;
	220
	221	switch (key) {
	222	case SR_CONF_OUTPUT_FREQUENCY:
	223	value_f = g_variant_get_double(data);
	224	rs_sme0x_set_freq(sdi, value_f);
	225	break;
	226	case SR_CONF_AMPLITUDE:
	227	value_f = g_variant_get_double(data);
	228	rs_sme0x_set_power(sdi, value_f);
	229	break;
	230	default:
	231	return SR_ERR_NA;
	232	}
	233
	234	return SR_OK;
	235	}
	236
	237	static int config_list(uint32_t key, GVariant **data,
	238	const struct sr_dev_inst sdi, const struct sr_channel_group cg)
	239	{
	240	(void)sdi;
	241	(void)cg;
	242
	243	/* Return drvopts without sdi (and devopts with sdi, see below). */
	244	if (key == SR_CONF_DEVICE_OPTIONS && !sdi) {
	245	*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
	246	drvopts, ARRAY_SIZE(drvopts), sizeof(uint32_t));
	247	return SR_OK;
	248	}
	249
	250	switch (key) {
	251	case SR_CONF_SCAN_OPTIONS:
	252	*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
	253	scanopts, ARRAY_SIZE(scanopts), sizeof(uint32_t));
	254	break;
	255	case SR_CONF_DEVICE_OPTIONS:
	256	*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
	257	devopts, ARRAY_SIZE(devopts), sizeof(uint32_t));
	258	break;
	259	default:
	260	return SR_ERR_NA;
	261	}
	262
	263	return SR_OK;
	264	}
	265
	266	static int dev_acquisition_start(const struct sr_dev_inst *sdi)
	267	{
	268	if (sdi->status != SR_ST_ACTIVE)
	269	return SR_ERR_DEV_CLOSED;
	270
	271	return SR_OK;
	272	}
	273
	274	SR_PRIV struct sr_dev_driver rohde_schwarz_sme_0x_driver_info = {
	275	.name = "rohde-schwarz-sme-0x",
	276	.longname = "Rohde&Schwarz SME-0x",
	277	.api_version = 1,
	278	.init = std_init,
	279	.cleanup = std_cleanup,
	280	.scan = scan,
	281	.dev_list = std_dev_list,
	282	.dev_clear = dev_clear,
	283	.config_get = config_get,
	284	.config_set = config_set,
	285	.config_list = config_list,
	286	.dev_open = dev_open,
	287	.dev_close = dev_close,
	288	.dev_acquisition_start = dev_acquisition_start,
	289	.dev_acquisition_stop = std_serial_dev_acquisition_stop,
	290	.context = NULL,
	291	};
	292
	293	SR_REGISTER_DEV_DRIVER(rohde_schwarz_sme_0x_driver_info);