[libsigrok.git] / input / chronovu_la8.c

/*
 * This file is part of the sigrok project.
 *
 * Copyright (C) 2011 Uwe Hermann <uwe@hermann-uwe.de>
 *
 * 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 2 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, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 */

#include <stdlib.h>
#include <fcntl.h>
#include <unistd.h>
#include <sys/stat.h>
#include "libsigrok.h"
#include "libsigrok-internal.h"

/* Message logging helpers with driver-specific prefix string. */
#define DRIVER_LOG_DOMAIN "input/chronovu-la8: "
#define sr_log(l, s, args...) sr_log(l, DRIVER_LOG_DOMAIN s, ## args)
#define sr_spew(s, args...) sr_spew(DRIVER_LOG_DOMAIN s, ## args)
#define sr_dbg(s, args...) sr_dbg(DRIVER_LOG_DOMAIN s, ## args)
#define sr_info(s, args...) sr_info(DRIVER_LOG_DOMAIN s, ## args)
#define sr_warn(s, args...) sr_warn(DRIVER_LOG_DOMAIN s, ## args)
#define sr_err(s, args...) sr_err(DRIVER_LOG_DOMAIN s, ## args)

#define NUM_PACKETS		2048
#define PACKET_SIZE		4096
#define DEFAULT_NUM_PROBES	8

/**
 * Convert the LA8 'divcount' value to the respective samplerate (in Hz).
 *
 * LA8 hardware: sample period = (divcount + 1) * 10ns.
 * Min. value for divcount: 0x00 (10ns sample period, 100MHz samplerate).
 * Max. value for divcount: 0xfe (2550ns sample period, 392.15kHz samplerate).
 *
 * @param divcount The divcount value as needed by the hardware.
 *
 * @return The samplerate in Hz, or 0xffffffffffffffff upon errors.
 */
static uint64_t divcount_to_samplerate(uint8_t divcount)
{
	if (divcount == 0xff)
		return 0xffffffffffffffffULL;

	return SR_MHZ(100) / (divcount + 1);
}

static int format_match(const char *filename)
{
	struct stat stat_buf;
	int ret;

	if (!filename) {
		sr_err("%s: filename was NULL", __func__);
		// return SR_ERR; /* FIXME */
		return FALSE;
	}

	if (!g_file_test(filename, G_FILE_TEST_EXISTS)) {
		sr_err("%s: input file '%s' does not exist",
		       __func__, filename);
		// return SR_ERR; /* FIXME */
		return FALSE;
	}

	if (!g_file_test(filename, G_FILE_TEST_IS_REGULAR)) {
		sr_err("%s: input file '%s' not a regular file",
		       __func__, filename);
		// return SR_ERR; /* FIXME */
		return FALSE;
	}

	/* Only accept files of length 8MB + 5 bytes. */
	ret = stat(filename, &stat_buf);
	if (ret != 0) {
		sr_err("%s: Error getting file size of '%s'",
		       __func__, filename);
		return FALSE;
	}
	if (stat_buf.st_size != (8 * 1024 * 1024 + 5)) {
		sr_dbg("%s: File size must be exactly 8388613 bytes ("
		       "it actually is %d bytes in size), so this is not a "
		       "ChronoVu LA8 file.", __func__, stat_buf.st_size);
		return FALSE;
	}

	/* TODO: Check for divcount != 0xff. */

	return TRUE;
}

static int init(struct sr_input *in, const char *filename)
{
	struct sr_probe *probe;
	int num_probes, i;
	char name[SR_MAX_PROBENAME_LEN + 1];
	char *param;

	(void)filename;

	num_probes = DEFAULT_NUM_PROBES;

	if (in->param) {
		param = g_hash_table_lookup(in->param, "numprobes");
		if (param) {
			num_probes = strtoul(param, NULL, 10);
			if (num_probes < 1) {
				sr_err("%s: strtoul failed", __func__);
				return SR_ERR;
			}
		}
	}

	/* Create a virtual device. */
	in->sdi = sr_dev_inst_new(0, SR_ST_ACTIVE, NULL, NULL, NULL);

	for (i = 0; i < num_probes; i++) {
		snprintf(name, SR_MAX_PROBENAME_LEN, "%d", i);
		/* TODO: Check return value. */
		if (!(probe = sr_probe_new(i, SR_PROBE_LOGIC, TRUE, name)))
			return SR_ERR;
		in->sdi->probes = g_slist_append(in->sdi->probes, probe);
	}

	return SR_OK;
}

static int loadfile(struct sr_input *in, const char *filename)
{
	struct sr_datafeed_packet packet;
	struct sr_datafeed_meta meta;
	struct sr_datafeed_logic logic;
	struct sr_config *src;
	uint8_t buf[PACKET_SIZE], divcount;
	int i, fd, size, num_probes;
	uint64_t samplerate;

	/* TODO: Use glib functions! GIOChannel, g_fopen, etc. */
	if ((fd = open(filename, O_RDONLY)) == -1) {
		sr_err("%s: file open failed", __func__);
		return SR_ERR;
	}

	num_probes = g_slist_length(in->sdi->probes);

	/* Seek to the end of the file, and read the divcount byte. */
	divcount = 0x00; /* TODO: Don't hardcode! */

	/* Convert the divcount value to a samplerate. */
	samplerate = divcount_to_samplerate(divcount);
	if (samplerate == 0xffffffffffffffffULL) {
		close(fd); /* FIXME */
		return SR_ERR;
	}
	sr_dbg("%s: samplerate is %" PRIu64, __func__, samplerate);

	/* Send header packet to the session bus. */
	std_session_send_df_header(in->sdi, DRIVER_LOG_DOMAIN);

	/* Send metadata about the SR_DF_LOGIC packets to come. */
	packet.type = SR_DF_META;
	packet.payload = &meta;
	src = sr_config_new(SR_CONF_SAMPLERATE, (const void *)&samplerate);
	meta.config = g_slist_append(NULL, src);
	sr_session_send(in->sdi, &packet);

	/* TODO: Handle trigger point. */

	/* Send data packets to the session bus. */
	sr_dbg("%s: sending SR_DF_LOGIC data packets", __func__);
	packet.type = SR_DF_LOGIC;
	packet.payload = &logic;
	logic.unitsize = (num_probes + 7) / 8;
	logic.data = buf;

	/* Send 8MB of total data to the session bus in small chunks. */
	for (i = 0; i < NUM_PACKETS; i++) {
		/* TODO: Handle errors, handle incomplete reads. */
		size = read(fd, buf, PACKET_SIZE);
		logic.length = size;
		sr_session_send(in->sdi, &packet);
	}
	close(fd); /* FIXME */

	/* Send end packet to the session bus. */
	sr_dbg("%s: sending SR_DF_END", __func__);
	packet.type = SR_DF_END;
	packet.payload = NULL;
	sr_session_send(in->sdi, &packet);

	return SR_OK;
}

SR_PRIV struct sr_input_format input_chronovu_la8 = {
	.id = "chronovu-la8",
	.description = "ChronoVu LA8",
	.format_match = format_match,
	.init = init,
	.loadfile = loadfile,
};
Commit	Line	Data
	1	/*
	2	* This file is part of the sigrok project.
	3	*
	4	* Copyright (C) 2011 Uwe Hermann <uwe@hermann-uwe.de>
	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 2 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, write to the Free Software
	18	* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
	19	*/
	20
	21	#include <stdlib.h>
	22	#include <fcntl.h>
	23	#include <unistd.h>
	24	#include <sys/stat.h>
	25	#include "libsigrok.h"
	26	#include "libsigrok-internal.h"
	27
	28	/* Message logging helpers with driver-specific prefix string. */
	29	#define DRIVER_LOG_DOMAIN "input/chronovu-la8: "
	30	#define sr_log(l, s, args...) sr_log(l, DRIVER_LOG_DOMAIN s, ## args)
	31	#define sr_spew(s, args...) sr_spew(DRIVER_LOG_DOMAIN s, ## args)
	32	#define sr_dbg(s, args...) sr_dbg(DRIVER_LOG_DOMAIN s, ## args)
	33	#define sr_info(s, args...) sr_info(DRIVER_LOG_DOMAIN s, ## args)
	34	#define sr_warn(s, args...) sr_warn(DRIVER_LOG_DOMAIN s, ## args)
	35	#define sr_err(s, args...) sr_err(DRIVER_LOG_DOMAIN s, ## args)
	36
	37	#define NUM_PACKETS 2048
	38	#define PACKET_SIZE 4096
	39	#define DEFAULT_NUM_PROBES 8
	40
	41	/**
	42	* Convert the LA8 'divcount' value to the respective samplerate (in Hz).
	43	*
	44	* LA8 hardware: sample period = (divcount + 1) * 10ns.
	45	* Min. value for divcount: 0x00 (10ns sample period, 100MHz samplerate).
	46	* Max. value for divcount: 0xfe (2550ns sample period, 392.15kHz samplerate).
	47	*
	48	* @param divcount The divcount value as needed by the hardware.
	49	*
	50	* @return The samplerate in Hz, or 0xffffffffffffffff upon errors.
	51	*/
	52	static uint64_t divcount_to_samplerate(uint8_t divcount)
	53	{
	54	if (divcount == 0xff)
	55	return 0xffffffffffffffffULL;
	56
	57	return SR_MHZ(100) / (divcount + 1);
	58	}
	59
	60	static int format_match(const char *filename)
	61	{
	62	struct stat stat_buf;
	63	int ret;
	64
	65	if (!filename) {
	66	sr_err("%s: filename was NULL", __func__);
	67	// return SR_ERR; /* FIXME */
	68	return FALSE;
	69	}
	70
	71	if (!g_file_test(filename, G_FILE_TEST_EXISTS)) {
	72	sr_err("%s: input file '%s' does not exist",
	73	__func__, filename);
	74	// return SR_ERR; /* FIXME */
	75	return FALSE;
	76	}
	77
	78	if (!g_file_test(filename, G_FILE_TEST_IS_REGULAR)) {
	79	sr_err("%s: input file '%s' not a regular file",
	80	__func__, filename);
	81	// return SR_ERR; /* FIXME */
	82	return FALSE;
	83	}
	84
	85	/* Only accept files of length 8MB + 5 bytes. */
	86	ret = stat(filename, &stat_buf);
	87	if (ret != 0) {
	88	sr_err("%s: Error getting file size of '%s'",
	89	__func__, filename);
	90	return FALSE;
	91	}
	92	if (stat_buf.st_size != (8 * 1024 * 1024 + 5)) {
	93	sr_dbg("%s: File size must be exactly 8388613 bytes ("
	94	"it actually is %d bytes in size), so this is not a "
	95	"ChronoVu LA8 file.", __func__, stat_buf.st_size);
	96	return FALSE;
	97	}
	98
	99	/* TODO: Check for divcount != 0xff. */
	100
	101	return TRUE;
	102	}
	103
	104	static int init(struct sr_input in, const char filename)
	105	{
	106	struct sr_probe *probe;
	107	int num_probes, i;
	108	char name[SR_MAX_PROBENAME_LEN + 1];
	109	char *param;
	110
	111	(void)filename;
	112
	113	num_probes = DEFAULT_NUM_PROBES;
	114
	115	if (in->param) {
	116	param = g_hash_table_lookup(in->param, "numprobes");
	117	if (param) {
	118	num_probes = strtoul(param, NULL, 10);
	119	if (num_probes < 1) {
	120	sr_err("%s: strtoul failed", __func__);
	121	return SR_ERR;
	122	}
	123	}
	124	}
	125
	126	/* Create a virtual device. */
	127	in->sdi = sr_dev_inst_new(0, SR_ST_ACTIVE, NULL, NULL, NULL);
	128
	129	for (i = 0; i < num_probes; i++) {
	130	snprintf(name, SR_MAX_PROBENAME_LEN, "%d", i);
	131	/* TODO: Check return value. */
	132	if (!(probe = sr_probe_new(i, SR_PROBE_LOGIC, TRUE, name)))
	133	return SR_ERR;
	134	in->sdi->probes = g_slist_append(in->sdi->probes, probe);
	135	}
	136
	137	return SR_OK;
	138	}
	139
	140	static int loadfile(struct sr_input in, const char filename)
	141	{
	142	struct sr_datafeed_packet packet;
	143	struct sr_datafeed_meta meta;
	144	struct sr_datafeed_logic logic;
	145	struct sr_config *src;
	146	uint8_t buf[PACKET_SIZE], divcount;
	147	int i, fd, size, num_probes;
	148	uint64_t samplerate;
	149
	150	/* TODO: Use glib functions! GIOChannel, g_fopen, etc. */
	151	if ((fd = open(filename, O_RDONLY)) == -1) {
	152	sr_err("%s: file open failed", __func__);
	153	return SR_ERR;
	154	}
	155
	156	num_probes = g_slist_length(in->sdi->probes);
	157
	158	/* Seek to the end of the file, and read the divcount byte. */
	159	divcount = 0x00; /* TODO: Don't hardcode! */
	160
	161	/* Convert the divcount value to a samplerate. */
	162	samplerate = divcount_to_samplerate(divcount);
	163	if (samplerate == 0xffffffffffffffffULL) {
	164	close(fd); /* FIXME */
	165	return SR_ERR;
	166	}
	167	sr_dbg("%s: samplerate is %" PRIu64, __func__, samplerate);
	168
	169	/* Send header packet to the session bus. */
	170	std_session_send_df_header(in->sdi, DRIVER_LOG_DOMAIN);
	171
	172	/* Send metadata about the SR_DF_LOGIC packets to come. */
	173	packet.type = SR_DF_META;
	174	packet.payload = &meta;
	175	src = sr_config_new(SR_CONF_SAMPLERATE, (const void *)&samplerate);
	176	meta.config = g_slist_append(NULL, src);
	177	sr_session_send(in->sdi, &packet);
	178
	179	/* TODO: Handle trigger point. */
	180
	181	/* Send data packets to the session bus. */
	182	sr_dbg("%s: sending SR_DF_LOGIC data packets", __func__);
	183	packet.type = SR_DF_LOGIC;
	184	packet.payload = &logic;
	185	logic.unitsize = (num_probes + 7) / 8;
	186	logic.data = buf;
	187
	188	/* Send 8MB of total data to the session bus in small chunks. */
	189	for (i = 0; i < NUM_PACKETS; i++) {
	190	/* TODO: Handle errors, handle incomplete reads. */
	191	size = read(fd, buf, PACKET_SIZE);
	192	logic.length = size;
	193	sr_session_send(in->sdi, &packet);
	194	}
	195	close(fd); /* FIXME */
	196
	197	/* Send end packet to the session bus. */
	198	sr_dbg("%s: sending SR_DF_END", __func__);
	199	packet.type = SR_DF_END;
	200	packet.payload = NULL;
	201	sr_session_send(in->sdi, &packet);
	202
	203	return SR_OK;
	204	}
	205
	206	SR_PRIV struct sr_input_format input_chronovu_la8 = {
	207	.id = "chronovu-la8",
	208	.description = "ChronoVu LA8",
	209	.format_match = format_match,
	210	.init = init,
	211	.loadfile = loadfile,
	212	};