[libsigrok.git] / src / hardware / sysclk-lwla / api.c

/*
 * This file is part of the libsigrok project.
 *
 * Copyright (C) 2014 Daniel Elstner <daniel.kitta@gmail.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 <config.h>
#include <glib.h>
#include <libusb.h>
#include <stdlib.h>
#include <string.h>
#include <libsigrok/libsigrok.h>
#include "libsigrok-internal.h"
#include "protocol.h"

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

static const uint32_t devopts[] = {
	SR_CONF_LOGIC_ANALYZER,
	SR_CONF_LIMIT_SAMPLES | SR_CONF_GET | SR_CONF_SET,
	SR_CONF_LIMIT_MSEC | SR_CONF_GET | SR_CONF_SET,
	SR_CONF_SAMPLERATE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
	SR_CONF_EXTERNAL_CLOCK | SR_CONF_GET | SR_CONF_SET,
	SR_CONF_CLOCK_EDGE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
	SR_CONF_TRIGGER_MATCH | SR_CONF_LIST,
	SR_CONF_TRIGGER_SOURCE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
	SR_CONF_TRIGGER_SLOPE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
};

static const int32_t trigger_matches[] = {
	SR_TRIGGER_ZERO,
	SR_TRIGGER_ONE,
	SR_TRIGGER_RISING,
	SR_TRIGGER_FALLING,
};

/* The hardware supports more samplerates than these, but these are the
 * options hardcoded into the vendor's Windows GUI.
 */
static const uint64_t samplerates[] = {
	SR_MHZ(125), SR_MHZ(100),
	SR_MHZ(50),  SR_MHZ(20),  SR_MHZ(10),
	SR_MHZ(5),   SR_MHZ(2),   SR_MHZ(1),
	SR_KHZ(500), SR_KHZ(200), SR_KHZ(100),
	SR_KHZ(50),  SR_KHZ(20),  SR_KHZ(10),
	SR_KHZ(5),   SR_KHZ(2),   SR_KHZ(1),
	SR_HZ(500),  SR_HZ(200),  SR_HZ(100),
};

/* Names assigned to available trigger sources.  Indices must match
 * trigger_source enum values.
 */
static const char *const trigger_source_names[] = { "CH", "TRG" };

/* Names assigned to available trigger slope choices.  Indices must
 * match the signal_edge enum values.
 */
static const char *const signal_edge_names[] = { "r", "f" };

static int init(struct sr_dev_driver *di, struct sr_context *sr_ctx)
{
	return std_init(sr_ctx, di, LOG_PREFIX);
}

static struct sr_dev_inst *dev_inst_new(void)
{
	struct sr_dev_inst *sdi;
	struct dev_context *devc;
	int i;
	char name[8];

	/* Allocate memory for our private driver context. */
	devc = g_malloc0(sizeof(struct dev_context));

	/* Register the device with libsigrok. */
	sdi = g_malloc0(sizeof(struct sr_dev_inst));
	sdi->status = SR_ST_INACTIVE;
	sdi->vendor = g_strdup(VENDOR_NAME);
	sdi->model = g_strdup(MODEL_NAME);

	/* Enable all channels to match the default channel configuration. */
	devc->channel_mask = ALL_CHANNELS_MASK;
	devc->samplerate = DEFAULT_SAMPLERATE;

	sdi->priv = devc;
	for (i = 0; i < NUM_CHANNELS; ++i) {
		/* The LWLA series simply number channels from CH1 to CHxx. */
		g_snprintf(name, sizeof(name), "CH%d", i + 1);
		sr_channel_new(sdi, i, SR_CHANNEL_LOGIC, TRUE, name);
	}

	return sdi;
}

static GSList *scan(struct sr_dev_driver *di, GSList *options)
{
	GSList *usb_devices, *devices, *node;
	struct drv_context *drvc;
	struct sr_dev_inst *sdi;
	struct sr_usb_dev_inst *usb;
	struct sr_config *src;
	const char *conn;

	drvc = di->context;
	conn = USB_VID_PID;

	for (node = options; node != NULL; node = node->next) {
		src = node->data;
		if (src->key == SR_CONF_CONN) {
			conn = g_variant_get_string(src->data, NULL);
			break;
		}
	}
	usb_devices = sr_usb_find(drvc->sr_ctx->libusb_ctx, conn);
	devices = NULL;

	for (node = usb_devices; node != NULL; node = node->next) {
		usb = node->data;

		/* Create sigrok device instance. */
		sdi = dev_inst_new();
		if (!sdi) {
			sr_usb_dev_inst_free(usb);
			continue;
		}
		sdi->driver = di;
		sdi->inst_type = SR_INST_USB;
		sdi->conn = usb;

		/* Register device instance with driver. */
		drvc->instances = g_slist_append(drvc->instances, sdi);
		devices = g_slist_append(devices, sdi);
	}

	g_slist_free(usb_devices);

	return devices;
}

static GSList *dev_list(const struct sr_dev_driver *di)
{
	struct drv_context *drvc;

	drvc = di->context;

	return drvc->instances;
}

static void clear_dev_context(void *priv)
{
	struct dev_context *devc;

	devc = priv;

	sr_dbg("Device context cleared.");

	lwla_free_acquisition_state(devc->acquisition);
	g_free(devc);
}

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

static int dev_open(struct sr_dev_inst *sdi)
{
	struct drv_context *drvc;
	struct sr_usb_dev_inst *usb;
	int ret;

	drvc = sdi->driver->context;

	if (!drvc) {
		sr_err("Driver was not initialized.");
		return SR_ERR;
	}
	if (sdi->status != SR_ST_INACTIVE) {
		sr_err("Device already open.");
		return SR_ERR;
	}
	usb = sdi->conn;

	ret = sr_usb_open(drvc->sr_ctx->libusb_ctx, usb);
	if (ret != SR_OK)
		return ret;

	/* Set the configuration twice to trigger a lightweight reset.
	 */
	ret = libusb_set_configuration(usb->devhdl, USB_CONFIG);
	if (ret == 0)
		ret = libusb_set_configuration(usb->devhdl, USB_CONFIG);
	if (ret != 0) {
		sr_err("Failed to set USB configuration: %s.",
			libusb_error_name(ret));
		sr_usb_close(usb);
		return SR_ERR;
	}

	ret = libusb_claim_interface(usb->devhdl, USB_INTERFACE);
	if (ret < 0) {
		sr_err("Failed to claim interface: %s.",
			libusb_error_name(ret));
		sr_usb_close(usb);
		return SR_ERR;
	}
	sdi->status = SR_ST_ACTIVE;

	ret = lwla_init_device(sdi);
	if (ret != SR_OK) {
		sr_usb_close(usb);
		sdi->status = SR_ST_INACTIVE;
	}
	return ret;
}

static int dev_close(struct sr_dev_inst *sdi)
{
	struct sr_usb_dev_inst *usb;
	struct dev_context *devc;
	int ret;

	if (!sdi->driver->context) {
		sr_err("Driver was not initialized.");
		return SR_ERR;
	}
	usb = sdi->conn;
	devc = sdi->priv;

	if (sdi->status == SR_ST_INACTIVE)
		return SR_OK;

	if (devc && devc->acquisition) {
		sr_err("Attempt to close device during acquisition.");
		return SR_ERR;
	}
	sdi->status = SR_ST_INACTIVE;

	/* Trigger download of the shutdown bitstream. */
	ret = lwla_set_clock_config(sdi);
	if (ret != SR_OK)
		sr_err("Unable to shut down device.");

	libusb_release_interface(usb->devhdl, USB_INTERFACE);
	sr_usb_close(usb);

	return ret;
}

static int cleanup(const struct sr_dev_driver *di)
{
	return dev_clear(di);
}

static int config_get(uint32_t key, GVariant **data, const struct sr_dev_inst *sdi,
		      const struct sr_channel_group *cg)
{
	struct dev_context *devc;
	size_t idx;

	(void)cg;

	if (!sdi)
		return SR_ERR_ARG;

	devc = sdi->priv;

	switch (key) {
	case SR_CONF_SAMPLERATE:
		*data = g_variant_new_uint64(devc->samplerate);
		break;
	case SR_CONF_LIMIT_MSEC:
		*data = g_variant_new_uint64(devc->limit_msec);
		break;
	case SR_CONF_LIMIT_SAMPLES:
		*data = g_variant_new_uint64(devc->limit_samples);
		break;
	case SR_CONF_EXTERNAL_CLOCK:
		*data = g_variant_new_boolean(devc->cfg_clock_source
						== CLOCK_EXT_CLK);
		break;
	case SR_CONF_CLOCK_EDGE:
		idx = devc->cfg_clock_edge;
		if (idx >= ARRAY_SIZE(signal_edge_names))
			return SR_ERR_BUG;
		*data = g_variant_new_string(signal_edge_names[idx]);
		break;
	case SR_CONF_TRIGGER_SOURCE:
		idx = devc->cfg_trigger_source;
		if (idx >= ARRAY_SIZE(trigger_source_names))
			return SR_ERR_BUG;
		*data = g_variant_new_string(trigger_source_names[idx]);
		break;
	case SR_CONF_TRIGGER_SLOPE:
		idx = devc->cfg_trigger_slope;
		if (idx >= ARRAY_SIZE(signal_edge_names))
			return SR_ERR_BUG;
		*data = g_variant_new_string(signal_edge_names[idx]);
		break;
	default:
		return SR_ERR_NA;
	}

	return SR_OK;
}

/* Helper for mapping a string-typed configuration value to an index
 * within a table of possible values.
 */
static int lookup_index(GVariant *value, const char *const *table, int len)
{
	const char *entry;
	int i;

	entry = g_variant_get_string(value, NULL);
	if (!entry)
		return -1;

	/* Linear search is fine for very small tables. */
	for (i = 0; i < len; ++i) {
		if (strcmp(entry, table[i]) == 0)
			return i;
	}
	return -1;
}

static int config_set(uint32_t key, GVariant *data, const struct sr_dev_inst *sdi,
		      const struct sr_channel_group *cg)
{
	uint64_t value;
	struct dev_context *devc;
	int idx;

	(void)cg;

	devc = sdi->priv;
	if (!devc)
		return SR_ERR_DEV_CLOSED;

	switch (key) {
	case SR_CONF_SAMPLERATE:
		value = g_variant_get_uint64(data);
		if (value < samplerates[ARRAY_SIZE(samplerates) - 1]
				|| value > samplerates[0])
			return SR_ERR_SAMPLERATE;
		devc->samplerate = value;
		break;
	case SR_CONF_LIMIT_MSEC:
		value = g_variant_get_uint64(data);
		if (value > MAX_LIMIT_MSEC)
			return SR_ERR_ARG;
		devc->limit_msec = value;
		break;
	case SR_CONF_LIMIT_SAMPLES:
		value = g_variant_get_uint64(data);
		if (value > MAX_LIMIT_SAMPLES)
			return SR_ERR_ARG;
		devc->limit_samples = value;
		break;
	case SR_CONF_EXTERNAL_CLOCK:
		devc->cfg_clock_source = (g_variant_get_boolean(data))
			? CLOCK_EXT_CLK : CLOCK_INTERNAL;
		break;
	case SR_CONF_CLOCK_EDGE:
		idx = lookup_index(data, signal_edge_names,
				   ARRAY_SIZE(signal_edge_names));
		if (idx < 0)
			return SR_ERR_ARG;
		devc->cfg_clock_edge = idx;
		break;
	case SR_CONF_TRIGGER_SOURCE:
		idx = lookup_index(data, trigger_source_names,
				   ARRAY_SIZE(trigger_source_names));
		if (idx < 0)
			return SR_ERR_ARG;
		devc->cfg_trigger_source = idx;
		break;
	case SR_CONF_TRIGGER_SLOPE:
		idx = lookup_index(data, signal_edge_names,
				   ARRAY_SIZE(signal_edge_names));
		if (idx < 0)
			return SR_ERR_ARG;
		devc->cfg_trigger_slope = idx;
		break;
	default:
		return SR_ERR_NA;
	}

	return SR_OK;
}

static int config_channel_set(const struct sr_dev_inst *sdi,
		struct sr_channel *ch, unsigned int changes)
{
	uint64_t channel_bit;
	struct dev_context *devc;

	devc = sdi->priv;
	if (!devc)
		return SR_ERR_DEV_CLOSED;

	if (ch->index < 0 || ch->index >= NUM_CHANNELS) {
		sr_err("Channel index %d out of range.", ch->index);
		return SR_ERR_BUG;
	}
	channel_bit = (uint64_t)1 << ch->index;

	if ((changes & SR_CHANNEL_SET_ENABLED) != 0) {
		/* Enable or disable input channel for this channel. */
		if (ch->enabled)
			devc->channel_mask |= channel_bit;
		else
			devc->channel_mask &= ~channel_bit;
	}

	return SR_OK;
}

static int prepare_trigger_masks(const struct sr_dev_inst *sdi)
{
	uint64_t trigger_mask;
	uint64_t trigger_values;
	uint64_t trigger_edge_mask;
	uint64_t channel_bit;
	struct dev_context *devc;
	struct sr_trigger *trigger;
	struct sr_trigger_stage *stage;
	struct sr_trigger_match *match;
	const GSList *node;

	devc = sdi->priv;

	trigger = sr_session_trigger_get(sdi->session);
	if (!trigger || !trigger->stages)
		return SR_OK;

	if (trigger->stages->next) {
		sr_err("This device only supports 1 trigger stage.");
		return SR_ERR_ARG;
	}
	stage = trigger->stages->data;

	trigger_mask = 0;
	trigger_values = 0;
	trigger_edge_mask = 0;

	for (node = stage->matches; node; node = node->next) {
		match = node->data;

		if (!match->channel->enabled)
			continue; /* ignore disabled channel */

		channel_bit = (uint64_t)1 << match->channel->index;
		trigger_mask |= channel_bit;

		switch (match->match) {
		case SR_TRIGGER_ZERO:
			break;
		case SR_TRIGGER_ONE:
			trigger_values |= channel_bit;
			break;
		case SR_TRIGGER_RISING:
			trigger_values |= channel_bit;
			/* Fall through for edge mask. */
		case SR_TRIGGER_FALLING:
			trigger_edge_mask |= channel_bit;
			break;
		default:
			sr_err("Unsupported trigger match for CH%d.",
				match->channel->index + 1);
			return SR_ERR_ARG;
		}
	}
	devc->trigger_mask = trigger_mask;
	devc->trigger_values = trigger_values;
	devc->trigger_edge_mask = trigger_edge_mask;

	return SR_OK;
}

static int config_commit(const struct sr_dev_inst *sdi)
{
	struct dev_context *devc;
	int rc;

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

	devc = sdi->priv;
	if (devc->acquisition) {
		sr_err("Acquisition still in progress?");
		return SR_ERR;
	}
	rc = prepare_trigger_masks(sdi);
	if (rc != SR_OK)
		return rc;

	return lwla_set_clock_config(sdi);
}

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

	(void)sdi;
	(void)cg;

	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;
	case SR_CONF_SAMPLERATE:
		g_variant_builder_init(&gvb, G_VARIANT_TYPE("a{sv}"));
		gvar = g_variant_new_fixed_array(G_VARIANT_TYPE("t"),
				samplerates, ARRAY_SIZE(samplerates),
				sizeof(uint64_t));
		g_variant_builder_add(&gvb, "{sv}", "samplerates", gvar);
		*data = g_variant_builder_end(&gvb);
		break;
	case SR_CONF_TRIGGER_MATCH:
		*data = g_variant_new_fixed_array(G_VARIANT_TYPE_INT32,
				trigger_matches, ARRAY_SIZE(trigger_matches),
				sizeof(int32_t));
		break;
	case SR_CONF_TRIGGER_SOURCE:
		*data = g_variant_new_strv(trigger_source_names,
					   ARRAY_SIZE(trigger_source_names));
		break;
	case SR_CONF_TRIGGER_SLOPE:
	case SR_CONF_CLOCK_EDGE:
		*data = g_variant_new_strv(signal_edge_names,
					   ARRAY_SIZE(signal_edge_names));
		break;
	default:
		return SR_ERR_NA;
	}

	return SR_OK;
}

static int dev_acquisition_start(const struct sr_dev_inst *sdi, void *cb_data)
{
	struct drv_context *drvc;
	struct dev_context *devc;
	struct acquisition_state *acq;
	int ret;

	(void)cb_data;

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

	devc = sdi->priv;
	drvc = sdi->driver->context;

	if (devc->acquisition) {
		sr_err("Acquisition still in progress?");
		return SR_ERR;
	}
	acq = lwla_alloc_acquisition_state();
	if (!acq)
		return SR_ERR_MALLOC;

	devc->cancel_requested = FALSE;
	devc->stopping_in_progress = FALSE;
	devc->transfer_error = FALSE;

	sr_info("Starting acquisition.");

	devc->acquisition = acq;
	ret = lwla_setup_acquisition(sdi);
	if (ret != SR_OK) {
		sr_err("Failed to set up acquisition.");
		devc->acquisition = NULL;
		lwla_free_acquisition_state(acq);
		return ret;
	}

	ret = lwla_start_acquisition(sdi);
	if (ret != SR_OK) {
		sr_err("Failed to start acquisition.");
		devc->acquisition = NULL;
		lwla_free_acquisition_state(acq);
		return ret;
	}
	usb_source_add(sdi->session, drvc->sr_ctx, 100, &lwla_receive_data,
		       (struct sr_dev_inst *)sdi);

	sr_info("Waiting for data.");

	/* Send header packet to the session bus. */
	std_session_send_df_header(sdi, LOG_PREFIX);

	return SR_OK;
}

static int dev_acquisition_stop(struct sr_dev_inst *sdi, void *cb_data)
{
	struct dev_context *devc;

	(void)cb_data;
	devc = sdi->priv;

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

	if (devc->acquisition && !devc->cancel_requested) {
		devc->cancel_requested = TRUE;
		sr_dbg("Stopping acquisition.");
	}
	return SR_OK;
}

SR_PRIV struct sr_dev_driver sysclk_lwla_driver_info = {
	.name = "sysclk-lwla",
	.longname = "SysClk LWLA series",
	.api_version = 1,
	.init = init,
	.cleanup = cleanup,
	.scan = scan,
	.dev_list = dev_list,
	.dev_clear = dev_clear,
	.config_get = config_get,
	.config_set = config_set,
	.config_channel_set = config_channel_set,
	.config_commit = config_commit,
	.config_list = config_list,
	.dev_open = dev_open,
	.dev_close = dev_close,
	.dev_acquisition_start = dev_acquisition_start,
	.dev_acquisition_stop = dev_acquisition_stop,
	.context = NULL,
};
Commit	Line	Data
aeaad0b0 DE	1	/*
	2	* This file is part of the libsigrok project.
	3	*
	4	* Copyright (C) 2014 Daniel Elstner <daniel.kitta@gmail.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
6ec6c43b	20	#include <config.h>
5874e88d DE	21	#include <glib.h>
	22	#include <libusb.h>
	23	#include <stdlib.h>
	24	#include <string.h>
c1aae900	25	#include <libsigrok/libsigrok.h>
515ab088 UH	26	#include "libsigrok-internal.h"
515ab088 UH	27	#include "protocol.h"
5874e88d	28
a0e0bb41	29	static const uint32_t scanopts[] = {
99c76642 DE	30	SR_CONF_CONN,
	31	};
	32
f254bc4b	33	static const uint32_t devopts[] = {
5874e88d	34	SR_CONF_LOGIC_ANALYZER,
5827f61b BV	35	SR_CONF_LIMIT_SAMPLES \| SR_CONF_GET \| SR_CONF_SET,
	36	SR_CONF_LIMIT_MSEC \| SR_CONF_GET \| SR_CONF_SET,
	37	SR_CONF_SAMPLERATE \| SR_CONF_GET \| SR_CONF_SET \| SR_CONF_LIST,
	38	SR_CONF_EXTERNAL_CLOCK \| SR_CONF_GET \| SR_CONF_SET,
	39	SR_CONF_CLOCK_EDGE \| SR_CONF_GET \| SR_CONF_SET \| SR_CONF_LIST,
	40	SR_CONF_TRIGGER_MATCH \| SR_CONF_LIST,
	41	SR_CONF_TRIGGER_SOURCE \| SR_CONF_GET \| SR_CONF_SET \| SR_CONF_LIST,
	42	SR_CONF_TRIGGER_SLOPE \| SR_CONF_GET \| SR_CONF_SET \| SR_CONF_LIST,
5874e88d DE	43	};
5874e88d DE	44
bbe7e48a BV	45	static const int32_t trigger_matches[] = {
	46	SR_TRIGGER_ZERO,
	47	SR_TRIGGER_ONE,
	48	SR_TRIGGER_RISING,
	49	SR_TRIGGER_FALLING,
	50	};
	51
5874e88d DE	52	/* The hardware supports more samplerates than these, but these are the
	53	* options hardcoded into the vendor's Windows GUI.
	54	*/
	55	static const uint64_t samplerates[] = {
	56	SR_MHZ(125), SR_MHZ(100),
	57	SR_MHZ(50), SR_MHZ(20), SR_MHZ(10),
	58	SR_MHZ(5), SR_MHZ(2), SR_MHZ(1),
	59	SR_KHZ(500), SR_KHZ(200), SR_KHZ(100),
	60	SR_KHZ(50), SR_KHZ(20), SR_KHZ(10),
	61	SR_KHZ(5), SR_KHZ(2), SR_KHZ(1),
	62	SR_HZ(500), SR_HZ(200), SR_HZ(100),
	63	};
aeaad0b0	64
e6e54bd2 DE	65	/* Names assigned to available trigger sources. Indices must match
	66	* trigger_source enum values.
	67	*/
	68	static const char *const trigger_source_names[] = { "CH", "TRG" };
	69
	70	/* Names assigned to available trigger slope choices. Indices must
6358f0a9	71	* match the signal_edge enum values.
e6e54bd2	72	*/
6358f0a9	73	static const char *const signal_edge_names[] = { "r", "f" };
e6e54bd2	74
4f840ce9	75	static int init(struct sr_dev_driver di, struct sr_context sr_ctx)
aeaad0b0 DE	76	{
	77	return std_init(sr_ctx, di, LOG_PREFIX);
	78	}
	79
0af636be	80	static struct sr_dev_inst *dev_inst_new(void)
43db3436 DE	81	{
	82	struct sr_dev_inst *sdi;
	83	struct dev_context *devc;
5e23fcab ML	84	int i;
5e23fcab ML	85	char name[8];
43db3436 DE	86
43db3436 DE	87	/* Allocate memory for our private driver context. */
f57d8ffe	88	devc = g_malloc0(sizeof(struct dev_context));
43db3436 DE	89
43db3436 DE	90	/* Register the device with libsigrok. */
aac29cc1	91	sdi = g_malloc0(sizeof(struct sr_dev_inst));
0af636be UH	92	sdi->status = SR_ST_INACTIVE;
	93	sdi->vendor = g_strdup(VENDOR_NAME);
	94	sdi->model = g_strdup(MODEL_NAME);
43db3436	95
ba7dd8bb	96	/* Enable all channels to match the default channel configuration. */
43db3436 DE	97	devc->channel_mask = ALL_CHANNELS_MASK;
	98	devc->samplerate = DEFAULT_SAMPLERATE;
	99
	100	sdi->priv = devc;
fe473123	101	for (i = 0; i < NUM_CHANNELS; ++i) {
5e23fcab	102	/* The LWLA series simply number channels from CH1 to CHxx. */
fe473123 DE	103	g_snprintf(name, sizeof(name), "CH%d", i + 1);
fe473123 DE	104	sr_channel_new(sdi, i, SR_CHANNEL_LOGIC, TRUE, name);
5e23fcab	105	}
43db3436 DE	106
	107	return sdi;
	108	}
	109
4f840ce9	110	static GSList scan(struct sr_dev_driver di, GSList *options)
aeaad0b0	111	{
5874e88d	112	GSList usb_devices, devices, *node;
aeaad0b0	113	struct drv_context *drvc;
5874e88d	114	struct sr_dev_inst *sdi;
5874e88d	115	struct sr_usb_dev_inst *usb;
7ebe9b9e DE	116	struct sr_config *src;
7ebe9b9e DE	117	const char *conn;
aeaad0b0	118
41812aca	119	drvc = di->context;
7ebe9b9e	120	conn = USB_VID_PID;
5874e88d	121
7ebe9b9e DE	122	for (node = options; node != NULL; node = node->next) {
	123	src = node->data;
	124	if (src->key == SR_CONF_CONN) {
	125	conn = g_variant_get_string(src->data, NULL);
	126	break;
	127	}
	128	}
	129	usb_devices = sr_usb_find(drvc->sr_ctx->libusb_ctx, conn);
	130	devices = NULL;
5874e88d DE	131
	132	for (node = usb_devices; node != NULL; node = node->next) {
	133	usb = node->data;
	134
43db3436	135	/* Create sigrok device instance. */
c79d4444	136	sdi = dev_inst_new();
5874e88d	137	if (!sdi) {
5874e88d DE	138	sr_usb_dev_inst_free(usb);
	139	continue;
	140	}
	141	sdi->driver = di;
5874e88d DE	142	sdi->inst_type = SR_INST_USB;
5874e88d DE	143	sdi->conn = usb;
5874e88d	144
43db3436	145	/* Register device instance with driver. */
5874e88d DE	146	drvc->instances = g_slist_append(drvc->instances, sdi);
	147	devices = g_slist_append(devices, sdi);
	148	}
aeaad0b0	149
5874e88d	150	g_slist_free(usb_devices);
aeaad0b0 DE	151
	152	return devices;
	153	}
	154
4f840ce9	155	static GSList dev_list(const struct sr_dev_driver di)
aeaad0b0	156	{
5874e88d DE	157	struct drv_context *drvc;
5874e88d DE	158
41812aca	159	drvc = di->context;
5874e88d DE	160
	161	return drvc->instances;
	162	}
	163
	164	static void clear_dev_context(void *priv)
	165	{
	166	struct dev_context *devc;
	167
	168	devc = priv;
	169
	170	sr_dbg("Device context cleared.");
	171
	172	lwla_free_acquisition_state(devc->acquisition);
	173	g_free(devc);
aeaad0b0 DE	174	}
aeaad0b0 DE	175
4f840ce9	176	static int dev_clear(const struct sr_dev_driver *di)
aeaad0b0	177	{
5874e88d	178	return std_dev_clear(di, &clear_dev_context);
aeaad0b0 DE	179	}
	180
	181	static int dev_open(struct sr_dev_inst *sdi)
	182	{
5874e88d	183	struct drv_context *drvc;
5874e88d DE	184	struct sr_usb_dev_inst *usb;
5874e88d DE	185	int ret;
aeaad0b0	186
ce19d4c6	187	drvc = sdi->driver->context;
aeaad0b0	188
5874e88d DE	189	if (!drvc) {
	190	sr_err("Driver was not initialized.");
	191	return SR_ERR;
	192	}
c81069b3 DE	193	if (sdi->status != SR_ST_INACTIVE) {
	194	sr_err("Device already open.");
	195	return SR_ERR;
	196	}
43db3436	197	usb = sdi->conn;
5874e88d DE	198
	199	ret = sr_usb_open(drvc->sr_ctx->libusb_ctx, usb);
	200	if (ret != SR_OK)
	201	return ret;
	202
ad6181e2 DE	203	/* Set the configuration twice to trigger a lightweight reset.
	204	*/
	205	ret = libusb_set_configuration(usb->devhdl, USB_CONFIG);
	206	if (ret == 0)
	207	ret = libusb_set_configuration(usb->devhdl, USB_CONFIG);
	208	if (ret != 0) {
	209	sr_err("Failed to set USB configuration: %s.",
	210	libusb_error_name(ret));
	211	sr_usb_close(usb);
	212	return SR_ERR;
	213	}
	214
5874e88d DE	215	ret = libusb_claim_interface(usb->devhdl, USB_INTERFACE);
	216	if (ret < 0) {
	217	sr_err("Failed to claim interface: %s.",
	218	libusb_error_name(ret));
c81069b3	219	sr_usb_close(usb);
5874e88d DE	220	return SR_ERR;
5874e88d DE	221	}
c81069b3	222	sdi->status = SR_ST_ACTIVE;
5874e88d	223
5874e88d	224	ret = lwla_init_device(sdi);
c81069b3 DE	225	if (ret != SR_OK) {
	226	sr_usb_close(usb);
	227	sdi->status = SR_ST_INACTIVE;
	228	}
5874e88d	229	return ret;
aeaad0b0 DE	230	}
	231
	232	static int dev_close(struct sr_dev_inst *sdi)
	233	{
5874e88d	234	struct sr_usb_dev_inst *usb;
c81069b3 DE	235	struct dev_context *devc;
c81069b3 DE	236	int ret;
5874e88d	237
ce19d4c6	238	if (!sdi->driver->context) {
5874e88d DE	239	sr_err("Driver was not initialized.");
	240	return SR_ERR;
	241	}
6358f0a9	242	usb = sdi->conn;
c81069b3 DE	243	devc = sdi->priv;
	244
	245	if (sdi->status == SR_ST_INACTIVE)
5874e88d	246	return SR_OK;
aeaad0b0	247
c81069b3 DE	248	if (devc && devc->acquisition) {
	249	sr_err("Attempt to close device during acquisition.");
	250	return SR_ERR;
	251	}
6358f0a9	252	sdi->status = SR_ST_INACTIVE;
5874e88d	253
6358f0a9	254	/* Trigger download of the shutdown bitstream. */
c81069b3 DE	255	ret = lwla_set_clock_config(sdi);
c81069b3 DE	256	if (ret != SR_OK)
5874e88d DE	257	sr_err("Unable to shut down device.");
	258
	259	libusb_release_interface(usb->devhdl, USB_INTERFACE);
c81069b3	260	sr_usb_close(usb);
5874e88d	261
c81069b3	262	return ret;
aeaad0b0 DE	263	}
aeaad0b0 DE	264
4f840ce9	265	static int cleanup(const struct sr_dev_driver *di)
aeaad0b0	266	{
4f840ce9	267	return dev_clear(di);
aeaad0b0 DE	268	}
aeaad0b0 DE	269
584560f1	270	static int config_get(uint32_t key, GVariant *data, const struct sr_dev_inst sdi,
53b4680f	271	const struct sr_channel_group *cg)
aeaad0b0	272	{
5874e88d	273	struct dev_context *devc;
e6e54bd2	274	size_t idx;
aeaad0b0	275
53b4680f	276	(void)cg;
aeaad0b0	277
5874e88d DE	278	if (!sdi)
	279	return SR_ERR_ARG;
	280
	281	devc = sdi->priv;
	282
aeaad0b0	283	switch (key) {
5874e88d DE	284	case SR_CONF_SAMPLERATE:
	285	*data = g_variant_new_uint64(devc->samplerate);
	286	break;
29d58767 DE	287	case SR_CONF_LIMIT_MSEC:
	288	*data = g_variant_new_uint64(devc->limit_msec);
	289	break;
5874e88d DE	290	case SR_CONF_LIMIT_SAMPLES:
	291	*data = g_variant_new_uint64(devc->limit_samples);
	292	break;
	293	case SR_CONF_EXTERNAL_CLOCK:
6358f0a9 DE	294	*data = g_variant_new_boolean(devc->cfg_clock_source
	295	== CLOCK_EXT_CLK);
	296	break;
	297	case SR_CONF_CLOCK_EDGE:
	298	idx = devc->cfg_clock_edge;
ce3ecb70	299	if (idx >= ARRAY_SIZE(signal_edge_names))
6358f0a9 DE	300	return SR_ERR_BUG;
6358f0a9 DE	301	*data = g_variant_new_string(signal_edge_names[idx]);
5874e88d	302	break;
e6e54bd2 DE	303	case SR_CONF_TRIGGER_SOURCE:
e6e54bd2 DE	304	idx = devc->cfg_trigger_source;
ce3ecb70	305	if (idx >= ARRAY_SIZE(trigger_source_names))
e6e54bd2 DE	306	return SR_ERR_BUG;
	307	*data = g_variant_new_string(trigger_source_names[idx]);
	308	break;
	309	case SR_CONF_TRIGGER_SLOPE:
	310	idx = devc->cfg_trigger_slope;
ce3ecb70	311	if (idx >= ARRAY_SIZE(signal_edge_names))
e6e54bd2	312	return SR_ERR_BUG;
6358f0a9	313	*data = g_variant_new_string(signal_edge_names[idx]);
e6e54bd2	314	break;
aeaad0b0 DE	315	default:
	316	return SR_ERR_NA;
	317	}
	318
5874e88d	319	return SR_OK;
aeaad0b0 DE	320	}
aeaad0b0 DE	321
e6e54bd2 DE	322	/* Helper for mapping a string-typed configuration value to an index
	323	* within a table of possible values.
	324	*/
	325	static int lookup_index(GVariant value, const char const *table, int len)
	326	{
	327	const char *entry;
	328	int i;
	329
	330	entry = g_variant_get_string(value, NULL);
	331	if (!entry)
	332	return -1;
	333
	334	/* Linear search is fine for very small tables. */
	335	for (i = 0; i < len; ++i) {
	336	if (strcmp(entry, table[i]) == 0)
	337	return i;
	338	}
	339	return -1;
	340	}
	341
584560f1	342	static int config_set(uint32_t key, GVariant data, const struct sr_dev_inst sdi,
53b4680f	343	const struct sr_channel_group *cg)
aeaad0b0	344	{
29d58767	345	uint64_t value;
5874e88d	346	struct dev_context *devc;
e6e54bd2	347	int idx;
aeaad0b0	348
53b4680f	349	(void)cg;
aeaad0b0	350
5874e88d DE	351	devc = sdi->priv;
5874e88d DE	352	if (!devc)
aeaad0b0 DE	353	return SR_ERR_DEV_CLOSED;
aeaad0b0 DE	354
aeaad0b0	355	switch (key) {
5874e88d	356	case SR_CONF_SAMPLERATE:
29d58767	357	value = g_variant_get_uint64(data);
ce3ecb70	358	if (value < samplerates[ARRAY_SIZE(samplerates) - 1]
29d58767	359	\|\| value > samplerates[0])
5874e88d	360	return SR_ERR_SAMPLERATE;
29d58767 DE	361	devc->samplerate = value;
	362	break;
	363	case SR_CONF_LIMIT_MSEC:
	364	value = g_variant_get_uint64(data);
	365	if (value > MAX_LIMIT_MSEC)
	366	return SR_ERR_ARG;
	367	devc->limit_msec = value;
5874e88d DE	368	break;
5874e88d DE	369	case SR_CONF_LIMIT_SAMPLES:
29d58767 DE	370	value = g_variant_get_uint64(data);
	371	if (value > MAX_LIMIT_SAMPLES)
	372	return SR_ERR_ARG;
	373	devc->limit_samples = value;
5874e88d DE	374	break;
5874e88d DE	375	case SR_CONF_EXTERNAL_CLOCK:
6358f0a9 DE	376	devc->cfg_clock_source = (g_variant_get_boolean(data))
	377	? CLOCK_EXT_CLK : CLOCK_INTERNAL;
	378	break;
	379	case SR_CONF_CLOCK_EDGE:
	380	idx = lookup_index(data, signal_edge_names,
ce3ecb70	381	ARRAY_SIZE(signal_edge_names));
6358f0a9 DE	382	if (idx < 0)
	383	return SR_ERR_ARG;
	384	devc->cfg_clock_edge = idx;
5874e88d	385	break;
e6e54bd2 DE	386	case SR_CONF_TRIGGER_SOURCE:
e6e54bd2 DE	387	idx = lookup_index(data, trigger_source_names,
ce3ecb70	388	ARRAY_SIZE(trigger_source_names));
e6e54bd2 DE	389	if (idx < 0)
	390	return SR_ERR_ARG;
	391	devc->cfg_trigger_source = idx;
	392	break;
	393	case SR_CONF_TRIGGER_SLOPE:
6358f0a9	394	idx = lookup_index(data, signal_edge_names,
ce3ecb70	395	ARRAY_SIZE(signal_edge_names));
e6e54bd2 DE	396	if (idx < 0)
	397	return SR_ERR_ARG;
	398	devc->cfg_trigger_slope = idx;
	399	break;
aeaad0b0	400	default:
5874e88d	401	return SR_ERR_NA;
aeaad0b0 DE	402	}
aeaad0b0 DE	403
5874e88d	404	return SR_OK;
aeaad0b0 DE	405	}
aeaad0b0 DE	406
f3ca73ed	407	static int config_channel_set(const struct sr_dev_inst *sdi,
bbe7e48a	408	struct sr_channel *ch, unsigned int changes)
43db3436	409	{
ba7dd8bb	410	uint64_t channel_bit;
43db3436 DE	411	struct dev_context *devc;
	412
	413	devc = sdi->priv;
	414	if (!devc)
	415	return SR_ERR_DEV_CLOSED;
	416
3f239f08	417	if (ch->index < 0 \|\| ch->index >= NUM_CHANNELS) {
ba7dd8bb	418	sr_err("Channel index %d out of range.", ch->index);
43db3436 DE	419	return SR_ERR_BUG;
43db3436 DE	420	}
ba7dd8bb	421	channel_bit = (uint64_t)1 << ch->index;
43db3436	422
3f239f08	423	if ((changes & SR_CHANNEL_SET_ENABLED) != 0) {
ba7dd8bb UH	424	/* Enable or disable input channel for this channel. */
	425	if (ch->enabled)
	426	devc->channel_mask \|= channel_bit;
43db3436	427	else
ba7dd8bb	428	devc->channel_mask &= ~channel_bit;
43db3436 DE	429	}
43db3436 DE	430
43db3436 DE	431	return SR_OK;
	432	}
	433
225d3cb0 DE	434	static int prepare_trigger_masks(const struct sr_dev_inst *sdi)
	435	{
	436	uint64_t trigger_mask;
	437	uint64_t trigger_values;
	438	uint64_t trigger_edge_mask;
	439	uint64_t channel_bit;
	440	struct dev_context *devc;
	441	struct sr_trigger *trigger;
	442	struct sr_trigger_stage *stage;
	443	struct sr_trigger_match *match;
	444	const GSList *node;
	445
	446	devc = sdi->priv;
	447
	448	trigger = sr_session_trigger_get(sdi->session);
	449	if (!trigger \|\| !trigger->stages)
	450	return SR_OK;
	451
	452	if (trigger->stages->next) {
	453	sr_err("This device only supports 1 trigger stage.");
	454	return SR_ERR_ARG;
	455	}
	456	stage = trigger->stages->data;
	457
	458	trigger_mask = 0;
	459	trigger_values = 0;
	460	trigger_edge_mask = 0;
	461
	462	for (node = stage->matches; node; node = node->next) {
	463	match = node->data;
	464
	465	if (!match->channel->enabled)
	466	continue; /* ignore disabled channel */
	467
	468	channel_bit = (uint64_t)1 << match->channel->index;
	469	trigger_mask \|= channel_bit;
	470
	471	switch (match->match) {
	472	case SR_TRIGGER_ZERO:
	473	break;
	474	case SR_TRIGGER_ONE:
	475	trigger_values \|= channel_bit;
	476	break;
	477	case SR_TRIGGER_RISING:
	478	trigger_values \|= channel_bit;
	479	/* Fall through for edge mask. */
	480	case SR_TRIGGER_FALLING:
	481	trigger_edge_mask \|= channel_bit;
	482	break;
	483	default:
	484	sr_err("Unsupported trigger match for CH%d.",
	485	match->channel->index + 1);
	486	return SR_ERR_ARG;
	487	}
	488	}
	489	devc->trigger_mask = trigger_mask;
	490	devc->trigger_values = trigger_values;
	491	devc->trigger_edge_mask = trigger_edge_mask;
	492
	493	return SR_OK;
	494	}
	495
ee38c8ba DE	496	static int config_commit(const struct sr_dev_inst *sdi)
ee38c8ba DE	497	{
225d3cb0 DE	498	struct dev_context *devc;
	499	int rc;
	500
	501	if (sdi->status != SR_ST_ACTIVE)
	502	return SR_ERR_DEV_CLOSED;
	503
	504	devc = sdi->priv;
	505	if (devc->acquisition) {
	506	sr_err("Acquisition still in progress?");
ee38c8ba DE	507	return SR_ERR;
ee38c8ba DE	508	}
225d3cb0 DE	509	rc = prepare_trigger_masks(sdi);
	510	if (rc != SR_OK)
	511	return rc;
ee38c8ba	512
6358f0a9	513	return lwla_set_clock_config(sdi);
ee38c8ba DE	514	}
ee38c8ba DE	515
584560f1	516	static int config_list(uint32_t key, GVariant *data, const struct sr_dev_inst sdi,
53b4680f	517	const struct sr_channel_group *cg)
aeaad0b0	518	{
5874e88d DE	519	GVariant *gvar;
5874e88d DE	520	GVariantBuilder gvb;
aeaad0b0 DE	521
aeaad0b0 DE	522	(void)sdi;
53b4680f	523	(void)cg;
aeaad0b0	524
aeaad0b0	525	switch (key) {
99c76642	526	case SR_CONF_SCAN_OPTIONS:
584560f1	527	*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
a0e0bb41	528	scanopts, ARRAY_SIZE(scanopts), sizeof(uint32_t));
99c76642	529	break;
5874e88d	530	case SR_CONF_DEVICE_OPTIONS:
584560f1	531	*data = g_variant_new_fixed_array(G_VARIANT_TYPE_UINT32,
ce3ecb70	532	devopts, ARRAY_SIZE(devopts), sizeof(uint32_t));
5874e88d DE	533	break;
	534	case SR_CONF_SAMPLERATE:
	535	g_variant_builder_init(&gvb, G_VARIANT_TYPE("a{sv}"));
	536	gvar = g_variant_new_fixed_array(G_VARIANT_TYPE("t"),
ce3ecb70	537	samplerates, ARRAY_SIZE(samplerates),
5874e88d DE	538	sizeof(uint64_t));
	539	g_variant_builder_add(&gvb, "{sv}", "samplerates", gvar);
	540	*data = g_variant_builder_end(&gvb);
	541	break;
bbe7e48a BV	542	case SR_CONF_TRIGGER_MATCH:
	543	*data = g_variant_new_fixed_array(G_VARIANT_TYPE_INT32,
	544	trigger_matches, ARRAY_SIZE(trigger_matches),
	545	sizeof(int32_t));
5874e88d	546	break;
e6e54bd2 DE	547	case SR_CONF_TRIGGER_SOURCE:
e6e54bd2 DE	548	*data = g_variant_new_strv(trigger_source_names,
ce3ecb70	549	ARRAY_SIZE(trigger_source_names));
e6e54bd2 DE	550	break;
e6e54bd2 DE	551	case SR_CONF_TRIGGER_SLOPE:
6358f0a9 DE	552	case SR_CONF_CLOCK_EDGE:
6358f0a9 DE	553	*data = g_variant_new_strv(signal_edge_names,
ce3ecb70	554	ARRAY_SIZE(signal_edge_names));
e6e54bd2	555	break;
aeaad0b0 DE	556	default:
	557	return SR_ERR_NA;
	558	}
	559
5874e88d	560	return SR_OK;
aeaad0b0 DE	561	}
aeaad0b0 DE	562
5874e88d DE	563	static int dev_acquisition_start(const struct sr_dev_inst sdi, void cb_data)
	564	{
	565	struct drv_context *drvc;
	566	struct dev_context *devc;
	567	struct acquisition_state *acq;
	568	int ret;
	569
aeaad0b0 DE	570	(void)cb_data;
	571
	572	if (sdi->status != SR_ST_ACTIVE)
	573	return SR_ERR_DEV_CLOSED;
	574
5874e88d	575	devc = sdi->priv;
ce19d4c6	576	drvc = sdi->driver->context;
5874e88d DE	577
	578	if (devc->acquisition) {
	579	sr_err("Acquisition still in progress?");
	580	return SR_ERR;
	581	}
	582	acq = lwla_alloc_acquisition_state();
	583	if (!acq)
	584	return SR_ERR_MALLOC;
	585
c81069b3	586	devc->cancel_requested = FALSE;
5874e88d DE	587	devc->stopping_in_progress = FALSE;
	588	devc->transfer_error = FALSE;
	589
5874e88d DE	590	sr_info("Starting acquisition.");
	591
	592	devc->acquisition = acq;
	593	ret = lwla_setup_acquisition(sdi);
	594	if (ret != SR_OK) {
a84f6ad3	595	sr_err("Failed to set up acquisition.");
5874e88d DE	596	devc->acquisition = NULL;
	597	lwla_free_acquisition_state(acq);
	598	return ret;
	599	}
	600
	601	ret = lwla_start_acquisition(sdi);
	602	if (ret != SR_OK) {
a84f6ad3	603	sr_err("Failed to start acquisition.");
5874e88d DE	604	devc->acquisition = NULL;
	605	lwla_free_acquisition_state(acq);
	606	return ret;
	607	}
102f1239	608	usb_source_add(sdi->session, drvc->sr_ctx, 100, &lwla_receive_data,
5874e88d DE	609	(struct sr_dev_inst *)sdi);
	610
	611	sr_info("Waiting for data.");
	612
	613	/* Send header packet to the session bus. */
	614	std_session_send_df_header(sdi, LOG_PREFIX);
aeaad0b0 DE	615
	616	return SR_OK;
	617	}
	618
	619	static int dev_acquisition_stop(struct sr_dev_inst sdi, void cb_data)
	620	{
c81069b3 DE	621	struct dev_context *devc;
c81069b3 DE	622
aeaad0b0	623	(void)cb_data;
c81069b3	624	devc = sdi->priv;
aeaad0b0 DE	625
	626	if (sdi->status != SR_ST_ACTIVE)
	627	return SR_ERR_DEV_CLOSED;
	628
c81069b3 DE	629	if (devc->acquisition && !devc->cancel_requested) {
	630	devc->cancel_requested = TRUE;
	631	sr_dbg("Stopping acquisition.");
	632	}
aeaad0b0 DE	633	return SR_OK;
	634	}
	635
	636	SR_PRIV struct sr_dev_driver sysclk_lwla_driver_info = {
	637	.name = "sysclk-lwla",
5874e88d	638	.longname = "SysClk LWLA series",
aeaad0b0 DE	639	.api_version = 1,
	640	.init = init,
	641	.cleanup = cleanup,
	642	.scan = scan,
	643	.dev_list = dev_list,
	644	.dev_clear = dev_clear,
	645	.config_get = config_get,
	646	.config_set = config_set,
f3ca73ed	647	.config_channel_set = config_channel_set,
ee38c8ba	648	.config_commit = config_commit,
aeaad0b0 DE	649	.config_list = config_list,
	650	.dev_open = dev_open,
	651	.dev_close = dev_close,
	652	.dev_acquisition_start = dev_acquisition_start,
	653	.dev_acquisition_stop = dev_acquisition_stop,
41812aca	654	.context = NULL,
aeaad0b0	655	};