[libsigrok.git] / session_driver.c

/*
 * This file is part of the sigrok project.
 *
 * Copyright (C) 2010-2012 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/>.
 */

#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <sys/time.h>
#include <zip.h>
#include "libsigrok.h"
#include "libsigrok-internal.h"

/* size of payloads sent across the session bus */
#define CHUNKSIZE (512 * 1024)

struct session_vdev {
	char *sessionfile;
	char *capturefile;
	struct zip *archive;
	struct zip_file *capfile;
	int bytes_read;
	uint64_t samplerate;
	int unitsize;
	int num_probes;
};

static GSList *dev_insts = NULL;
static const int hwcaps[] = {
	SR_HWCAP_CAPTUREFILE,
	SR_HWCAP_CAPTURE_UNITSIZE,
	0,
};

/**
 * TODO.
 *
 * @param dev_index TODO.
 */
static struct session_vdev *get_vdev_by_index(int dev_index)
{
	struct sr_dev_inst *sdi;
	struct session_vdev *vdev;

	/* TODO: Sanity checks on dev_index. */

	if (!(sdi = sr_dev_inst_get(dev_insts, dev_index))) {
		sr_err("session driver: %s: device instance with device "
		       "index %d was not found", __func__, dev_index);
		return NULL;
	}

	/* TODO: Is sdi->priv == NULL valid? */

	vdev = sdi->priv;

	return vdev;
}

/**
 * TODO.
 *
 * @param fd TODO.
 * @param revents TODO.
 * @param cb_data TODO.
 *
 * @return TODO.
 */
static int receive_data(int fd, int revents, void *cb_data)
{
	struct sr_dev_inst *sdi;
	struct session_vdev *vdev;
	struct sr_datafeed_packet packet;
	struct sr_datafeed_logic logic;
	GSList *l;
	void *buf;
	int ret, got_data;

	/* Avoid compiler warnings. */
	(void)fd;
	(void)revents;

	sr_dbg("session_driver: feed chunk");

	got_data = FALSE;
	for (l = dev_insts; l; l = l->next) {
		sdi = l->data;
		vdev = sdi->priv;
		if (!vdev)
			/* already done with this instance */
			continue;

		if (!(buf = g_try_malloc(CHUNKSIZE))) {
			sr_err("session driver: %s: buf malloc failed",
			       __func__);
			return FALSE; /* TODO: SR_ERR_MALLOC */
		}

		ret = zip_fread(vdev->capfile, buf, CHUNKSIZE);
		if (ret > 0) {
			got_data = TRUE;
			packet.type = SR_DF_LOGIC;
			packet.payload = &logic;
			logic.length = ret;
			logic.unitsize = vdev->unitsize;
			logic.data = buf;
			vdev->bytes_read += ret;
			sr_session_send(cb_data, &packet);
		} else {
			/* done with this capture file */
			zip_fclose(vdev->capfile);
			g_free(vdev->capturefile);
			g_free(vdev);
			sdi->priv = NULL;
		}
	}

	if (!got_data) {
		packet.type = SR_DF_END;
		sr_session_send(cb_data, &packet);
	}

	return TRUE;
}

/* driver callbacks */
static int hw_cleanup(void);

/**
 * TODO.
 *
 * @param devinfo TODO.
 *
 * @return TODO.
 */
static int hw_init(void)
{

	return SR_OK;
}

/**
 * TODO.
 */
static int hw_cleanup(void)
{
	GSList *l;

	for (l = dev_insts; l; l = l->next)
		sr_dev_inst_free(l->data);
	g_slist_free(dev_insts);
	dev_insts = NULL;

	sr_session_source_remove(-1);

	return SR_OK;
}

static int hw_dev_open(int dev_index)
{
	struct sr_dev_inst *sdi;

	sdi = sr_dev_inst_new(dev_index, SR_ST_INITIALIZING,
			      NULL, NULL, NULL);
	if (!sdi)
		return SR_ERR;

	if (!(sdi->priv = g_try_malloc0(sizeof(struct session_vdev)))) {
		sr_err("session driver: %s: sdi->priv malloc failed", __func__);
		return SR_ERR_MALLOC;
	}

	dev_insts = g_slist_append(dev_insts, sdi);

	return SR_OK;
}

static const void *hw_dev_info_get(int dev_index, int dev_info_id)
{
	struct session_vdev *vdev;
	void *info;

	if (dev_info_id != SR_DI_CUR_SAMPLERATE)
		return NULL;

	if (!(vdev = get_vdev_by_index(dev_index)))
		return NULL;

	info = &vdev->samplerate;

	return info;
}

static int hw_dev_status_get(int dev_index)
{
	/* Avoid compiler warnings. */
	(void)dev_index;

	if (sr_dev_list() != NULL)
		return SR_OK;
	else
		return SR_ERR;
}

/**
 * Get the list of hardware capabilities.
 *
 * @return A pointer to the (hardware) capabilities of this virtual session
 *         driver. This could be NULL, if no such capabilities exist.
 */
static const int *hw_hwcap_get_all(void)
{
	return hwcaps;
}

static int hw_dev_config_set(int dev_index, int hwcap, const void *value)
{
	struct session_vdev *vdev;
	const uint64_t *tmp_u64;

	if (!(vdev = get_vdev_by_index(dev_index)))
		return SR_ERR;

	switch (hwcap) {
	case SR_HWCAP_SAMPLERATE:
		tmp_u64 = value;
		vdev->samplerate = *tmp_u64;
		sr_info("session driver: setting samplerate to %" PRIu64,
		        vdev->samplerate);
		break;
	case SR_HWCAP_SESSIONFILE:
		vdev->sessionfile = g_strdup(value);
		sr_info("session driver: setting sessionfile to %s",
		        vdev->sessionfile);
		break;
	case SR_HWCAP_CAPTUREFILE:
		vdev->capturefile = g_strdup(value);
		sr_info("session driver: setting capturefile to %s",
		        vdev->capturefile);
		break;
	case SR_HWCAP_CAPTURE_UNITSIZE:
		tmp_u64 = value;
		vdev->unitsize = *tmp_u64;
		break;
	case SR_HWCAP_CAPTURE_NUM_PROBES:
		tmp_u64 = value;
		vdev->num_probes = *tmp_u64;
		break;
	default:
		sr_err("session driver: %s: unknown capability %d requested",
		       __func__, hwcap);
		return SR_ERR;
	}

	return SR_OK;
}

static int hw_dev_acquisition_start(int dev_index, void *cb_data)
{
	struct zip_stat zs;
	struct session_vdev *vdev;
	struct sr_datafeed_header *header;
	struct sr_datafeed_packet *packet;
	struct sr_datafeed_meta_logic meta;
	int ret;

	if (!(vdev = get_vdev_by_index(dev_index)))
		return SR_ERR;

	sr_info("session_driver: opening archive %s file %s", vdev->sessionfile,
		vdev->capturefile);

	if (!(vdev->archive = zip_open(vdev->sessionfile, 0, &ret))) {
		sr_err("session driver: Failed to open session file '%s': "
		       "zip error %d\n", vdev->sessionfile, ret);
		return SR_ERR;
	}

	if (zip_stat(vdev->archive, vdev->capturefile, 0, &zs) == -1) {
		sr_err("session driver: Failed to check capture file '%s' in "
		       "session file '%s'.", vdev->capturefile, vdev->sessionfile);
		return SR_ERR;
	}

	if (!(vdev->capfile = zip_fopen(vdev->archive, vdev->capturefile, 0))) {
		sr_err("session driver: Failed to open capture file '%s' in "
		       "session file '%s'.", vdev->capturefile, vdev->sessionfile);
		return SR_ERR;
	}

	/* freewheeling source */
	sr_session_source_add(-1, 0, 0, receive_data, cb_data);

	if (!(packet = g_try_malloc(sizeof(struct sr_datafeed_packet)))) {
		sr_err("session driver: %s: packet malloc failed", __func__);
		return SR_ERR_MALLOC;
	}

	if (!(header = g_try_malloc(sizeof(struct sr_datafeed_header)))) {
		sr_err("session driver: %s: header malloc failed", __func__);
		return SR_ERR_MALLOC;
	}

	/* Send header packet to the session bus. */
	packet->type = SR_DF_HEADER;
	packet->payload = (unsigned char *)header;
	header->feed_version = 1;
	gettimeofday(&header->starttime, NULL);
	sr_session_send(cb_data, packet);

	/* Send metadata about the SR_DF_LOGIC packets to come. */
	packet->type = SR_DF_META_LOGIC;
	packet->payload = &meta;
	meta.samplerate = vdev->samplerate;
	meta.num_probes = vdev->num_probes;
	sr_session_send(cb_data, packet);

	g_free(header);
	g_free(packet);

	return SR_OK;
}

SR_PRIV struct sr_dev_driver session_driver = {
	.name = "session",
	.longname = "Session-emulating driver",
	.api_version = 1,
	.init = hw_init,
	.cleanup = hw_cleanup,
	.dev_open = hw_dev_open,
	.dev_close = NULL,
	.dev_info_get = hw_dev_info_get,
	.dev_status_get = hw_dev_status_get,
	.hwcap_get_all = hw_hwcap_get_all,
	.dev_config_set = hw_dev_config_set,
	.dev_acquisition_start = hw_dev_acquisition_start,
	.dev_acquisition_stop = NULL,
};
Commit	Line	Data
	1	/*
	2	* This file is part of the sigrok project.
	3	*
	4	* Copyright (C) 2010-2012 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	#include <sys/types.h>
	21	#include <sys/stat.h>
	22	#include <fcntl.h>
	23	#include <unistd.h>
	24	#include <sys/time.h>
	25	#include <zip.h>
	26	#include "libsigrok.h"
	27	#include "libsigrok-internal.h"
	28
	29	/* size of payloads sent across the session bus */
	30	#define CHUNKSIZE (512 * 1024)
	31
	32	struct session_vdev {
	33	char *sessionfile;
	34	char *capturefile;
	35	struct zip *archive;
	36	struct zip_file *capfile;
	37	int bytes_read;
	38	uint64_t samplerate;
	39	int unitsize;
	40	int num_probes;
	41	};
	42
	43	static GSList *dev_insts = NULL;
	44	static const int hwcaps[] = {
	45	SR_HWCAP_CAPTUREFILE,
	46	SR_HWCAP_CAPTURE_UNITSIZE,
	47	0,
	48	};
	49
	50	/**
	51	* TODO.
	52	*
	53	* @param dev_index TODO.
	54	*/
	55	static struct session_vdev *get_vdev_by_index(int dev_index)
	56	{
	57	struct sr_dev_inst *sdi;
	58	struct session_vdev *vdev;
	59
	60	/* TODO: Sanity checks on dev_index. */
	61
	62	if (!(sdi = sr_dev_inst_get(dev_insts, dev_index))) {
	63	sr_err("session driver: %s: device instance with device "
	64	"index %d was not found", __func__, dev_index);
	65	return NULL;
	66	}
	67
	68	/* TODO: Is sdi->priv == NULL valid? */
	69
	70	vdev = sdi->priv;
	71
	72	return vdev;
	73	}
	74
	75	/**
	76	* TODO.
	77	*
	78	* @param fd TODO.
	79	* @param revents TODO.
	80	* @param cb_data TODO.
	81	*
	82	* @return TODO.
	83	*/
	84	static int receive_data(int fd, int revents, void *cb_data)
	85	{
	86	struct sr_dev_inst *sdi;
	87	struct session_vdev *vdev;
	88	struct sr_datafeed_packet packet;
	89	struct sr_datafeed_logic logic;
	90	GSList *l;
	91	void *buf;
	92	int ret, got_data;
	93
	94	/* Avoid compiler warnings. */
	95	(void)fd;
	96	(void)revents;
	97
	98	sr_dbg("session_driver: feed chunk");
	99
	100	got_data = FALSE;
	101	for (l = dev_insts; l; l = l->next) {
	102	sdi = l->data;
	103	vdev = sdi->priv;
	104	if (!vdev)
	105	/* already done with this instance */
	106	continue;
	107
	108	if (!(buf = g_try_malloc(CHUNKSIZE))) {
	109	sr_err("session driver: %s: buf malloc failed",
	110	__func__);
	111	return FALSE; /* TODO: SR_ERR_MALLOC */
	112	}
	113
	114	ret = zip_fread(vdev->capfile, buf, CHUNKSIZE);
	115	if (ret > 0) {
	116	got_data = TRUE;
	117	packet.type = SR_DF_LOGIC;
	118	packet.payload = &logic;
	119	logic.length = ret;
	120	logic.unitsize = vdev->unitsize;
	121	logic.data = buf;
	122	vdev->bytes_read += ret;
	123	sr_session_send(cb_data, &packet);
	124	} else {
	125	/* done with this capture file */
	126	zip_fclose(vdev->capfile);
	127	g_free(vdev->capturefile);
	128	g_free(vdev);
	129	sdi->priv = NULL;
	130	}
	131	}
	132
	133	if (!got_data) {
	134	packet.type = SR_DF_END;
	135	sr_session_send(cb_data, &packet);
	136	}
	137
	138	return TRUE;
	139	}
	140
	141	/* driver callbacks */
	142	static int hw_cleanup(void);
	143
	144	/**
	145	* TODO.
	146	*
	147	* @param devinfo TODO.
	148	*
	149	* @return TODO.
	150	*/
	151	static int hw_init(void)
	152	{
	153
	154	return SR_OK;
	155	}
	156
	157	/**
	158	* TODO.
	159	*/
	160	static int hw_cleanup(void)
	161	{
	162	GSList *l;
	163
	164	for (l = dev_insts; l; l = l->next)
	165	sr_dev_inst_free(l->data);
	166	g_slist_free(dev_insts);
	167	dev_insts = NULL;
	168
	169	sr_session_source_remove(-1);
	170
	171	return SR_OK;
	172	}
	173
	174	static int hw_dev_open(int dev_index)
	175	{
	176	struct sr_dev_inst *sdi;
	177
	178	sdi = sr_dev_inst_new(dev_index, SR_ST_INITIALIZING,
	179	NULL, NULL, NULL);
	180	if (!sdi)
	181	return SR_ERR;
	182
	183	if (!(sdi->priv = g_try_malloc0(sizeof(struct session_vdev)))) {
	184	sr_err("session driver: %s: sdi->priv malloc failed", __func__);
	185	return SR_ERR_MALLOC;
	186	}
	187
	188	dev_insts = g_slist_append(dev_insts, sdi);
	189
	190	return SR_OK;
	191	}
	192
	193	static const void *hw_dev_info_get(int dev_index, int dev_info_id)
	194	{
	195	struct session_vdev *vdev;
	196	void *info;
	197
	198	if (dev_info_id != SR_DI_CUR_SAMPLERATE)
	199	return NULL;
	200
	201	if (!(vdev = get_vdev_by_index(dev_index)))
	202	return NULL;
	203
	204	info = &vdev->samplerate;
	205
	206	return info;
	207	}
	208
	209	static int hw_dev_status_get(int dev_index)
	210	{
	211	/* Avoid compiler warnings. */
	212	(void)dev_index;
	213
	214	if (sr_dev_list() != NULL)
	215	return SR_OK;
	216	else
	217	return SR_ERR;
	218	}
	219
	220	/**
	221	* Get the list of hardware capabilities.
	222	*
	223	* @return A pointer to the (hardware) capabilities of this virtual session
	224	* driver. This could be NULL, if no such capabilities exist.
	225	*/
	226	static const int *hw_hwcap_get_all(void)
	227	{
	228	return hwcaps;
	229	}
	230
	231	static int hw_dev_config_set(int dev_index, int hwcap, const void *value)
	232	{
	233	struct session_vdev *vdev;
	234	const uint64_t *tmp_u64;
	235
	236	if (!(vdev = get_vdev_by_index(dev_index)))
	237	return SR_ERR;
	238
	239	switch (hwcap) {
	240	case SR_HWCAP_SAMPLERATE:
	241	tmp_u64 = value;
	242	vdev->samplerate = *tmp_u64;
	243	sr_info("session driver: setting samplerate to %" PRIu64,
	244	vdev->samplerate);
	245	break;
	246	case SR_HWCAP_SESSIONFILE:
	247	vdev->sessionfile = g_strdup(value);
	248	sr_info("session driver: setting sessionfile to %s",
	249	vdev->sessionfile);
	250	break;
	251	case SR_HWCAP_CAPTUREFILE:
	252	vdev->capturefile = g_strdup(value);
	253	sr_info("session driver: setting capturefile to %s",
	254	vdev->capturefile);
	255	break;
	256	case SR_HWCAP_CAPTURE_UNITSIZE:
	257	tmp_u64 = value;
	258	vdev->unitsize = *tmp_u64;
	259	break;
	260	case SR_HWCAP_CAPTURE_NUM_PROBES:
	261	tmp_u64 = value;
	262	vdev->num_probes = *tmp_u64;
	263	break;
	264	default:
	265	sr_err("session driver: %s: unknown capability %d requested",
	266	__func__, hwcap);
	267	return SR_ERR;
	268	}
	269
	270	return SR_OK;
	271	}
	272
	273	static int hw_dev_acquisition_start(int dev_index, void *cb_data)
	274	{
	275	struct zip_stat zs;
	276	struct session_vdev *vdev;
	277	struct sr_datafeed_header *header;
	278	struct sr_datafeed_packet *packet;
	279	struct sr_datafeed_meta_logic meta;
	280	int ret;
	281
	282	if (!(vdev = get_vdev_by_index(dev_index)))
	283	return SR_ERR;
	284
	285	sr_info("session_driver: opening archive %s file %s", vdev->sessionfile,
	286	vdev->capturefile);
	287
	288	if (!(vdev->archive = zip_open(vdev->sessionfile, 0, &ret))) {
	289	sr_err("session driver: Failed to open session file '%s': "
	290	"zip error %d\n", vdev->sessionfile, ret);
	291	return SR_ERR;
	292	}
	293
	294	if (zip_stat(vdev->archive, vdev->capturefile, 0, &zs) == -1) {
	295	sr_err("session driver: Failed to check capture file '%s' in "
	296	"session file '%s'.", vdev->capturefile, vdev->sessionfile);
	297	return SR_ERR;
	298	}
	299
	300	if (!(vdev->capfile = zip_fopen(vdev->archive, vdev->capturefile, 0))) {
	301	sr_err("session driver: Failed to open capture file '%s' in "
	302	"session file '%s'.", vdev->capturefile, vdev->sessionfile);
	303	return SR_ERR;
	304	}
	305
	306	/* freewheeling source */
	307	sr_session_source_add(-1, 0, 0, receive_data, cb_data);
	308
	309	if (!(packet = g_try_malloc(sizeof(struct sr_datafeed_packet)))) {
	310	sr_err("session driver: %s: packet malloc failed", __func__);
	311	return SR_ERR_MALLOC;
	312	}
	313
	314	if (!(header = g_try_malloc(sizeof(struct sr_datafeed_header)))) {
	315	sr_err("session driver: %s: header malloc failed", __func__);
	316	return SR_ERR_MALLOC;
	317	}
	318
	319	/* Send header packet to the session bus. */
	320	packet->type = SR_DF_HEADER;
	321	packet->payload = (unsigned char *)header;
	322	header->feed_version = 1;
	323	gettimeofday(&header->starttime, NULL);
	324	sr_session_send(cb_data, packet);
	325
	326	/* Send metadata about the SR_DF_LOGIC packets to come. */
	327	packet->type = SR_DF_META_LOGIC;
	328	packet->payload = &meta;
	329	meta.samplerate = vdev->samplerate;
	330	meta.num_probes = vdev->num_probes;
	331	sr_session_send(cb_data, packet);
	332
	333	g_free(header);
	334	g_free(packet);
	335
	336	return SR_OK;
	337	}
	338
	339	SR_PRIV struct sr_dev_driver session_driver = {
	340	.name = "session",
	341	.longname = "Session-emulating driver",
	342	.api_version = 1,
	343	.init = hw_init,
	344	.cleanup = hw_cleanup,
	345	.dev_open = hw_dev_open,
	346	.dev_close = NULL,
	347	.dev_info_get = hw_dev_info_get,
	348	.dev_status_get = hw_dev_status_get,
	349	.hwcap_get_all = hw_hwcap_get_all,
	350	.dev_config_set = hw_dev_config_set,
	351	.dev_acquisition_start = hw_dev_acquisition_start,
	352	.dev_acquisition_stop = NULL,
	353	};