[libsigrok.git] / src / hardware / sysclk-lwla / protocol.h

/*
 * 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/>.
 */

#ifndef LIBSIGROK_HARDWARE_SYSCLK_LWLA_PROTOCOL_H
#define LIBSIGROK_HARDWARE_SYSCLK_LWLA_PROTOCOL_H

#define LOG_PREFIX "sysclk-lwla"

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

/* For now, only the LWLA1034 is supported.
 */
#define VENDOR_NAME	"SysClk"
#define MODEL_NAME	"LWLA1034"

#define USB_VID_PID	"2961.6689"
#define USB_INTERFACE	0
#define USB_TIMEOUT_MS	3000

#define NUM_CHANNELS	34

/* Bit mask covering all 34 channels.
 */
#define ALL_CHANNELS_MASK (((uint64_t)1 << NUM_CHANNELS) - 1)

/** Unit and packet size for the sigrok logic datafeed.
 */
#define UNIT_SIZE	((NUM_CHANNELS + 7) / 8)
#define PACKET_LENGTH	(10 * 1000)	/* units */

/** Size of the acquisition buffer in device memory units.
 */
#define MEMORY_DEPTH	(256 * 1024)	/* 256k x 36 bit */

/** Number of device memory units (36 bit) to read at a time.  Slices of 8
 * consecutive 36-bit words are mapped to 9 32-bit words each, so the chunk
 * length should be a multiple of 8 to ensure alignment to slice boundaries.
 *
 * Experimentation has shown that reading chunks larger than about 1024 bytes
 * is unreliable.  The threshold seems to relate to the buffer size on the FX2
 * USB chip:  The configured endpoint buffer size is 512, and with double or
 * triple buffering enabled a multiple of 512 bytes can be kept in fly.
 *
 * The vendor software limits reads to 120 words (15 slices, 540 bytes) at
 * a time.  So far, it appears safe to increase this to 224 words (28 slices,
 * 1008 bytes), thus making the most of two 512 byte buffers.
 */
#define READ_CHUNK_LEN	(28 * 8)

/** Calculate the required buffer size in 32-bit units for reading a given
 * number of device memory words.  Rounded to a multiple of 8 device words.
 */
#define LWLA1034_MEMBUF_LEN(count) (((count) + 7) / 8 * 9)

/** Maximum number of 16-bit words sent at a time during acquisition.
 * Used for allocating the libusb transfer buffer.
 */
#define MAX_ACQ_SEND_WORDS	8 /* 5 for memory read request plus stuffing */

/** Maximum number of 32-bit words received at a time during acquisition.
 * Round to the next multiple of the endpoint buffer size to avoid nasty
 * transfer overflow conditions on hiccups.
 */
#define MAX_ACQ_RECV_LEN	((READ_CHUNK_LEN / 8 * 9 + 127) / 128 * 128)

/** Maximum length of a register write sequence.
 */
#define MAX_REG_WRITE_SEQ_LEN   5

/** Default configured samplerate.
 */
#define DEFAULT_SAMPLERATE	SR_MHZ(125)

/** Maximum configurable sample count limit.
 */
#define MAX_LIMIT_SAMPLES	(UINT64_C(1) << 48)

/** Maximum configurable capture duration in milliseconds.
 */
#define MAX_LIMIT_MSEC		(UINT64_C(1) << 32)

/** LWLA1034 FPGA clock configurations.
 */
enum clock_config {
	CONF_CLOCK_NONE,
	CONF_CLOCK_INT,
	CONF_CLOCK_EXT_RISE,
	CONF_CLOCK_EXT_FALL,
};

/** Available clock sources.
 */
enum clock_source {
	CLOCK_INTERNAL,
	CLOCK_EXT_CLK,
};

/** Available trigger sources.
 */
enum trigger_source {
	TRIGGER_CHANNELS = 0,
	TRIGGER_EXT_TRG,
};

/** Available edge choices for the external clock and trigger inputs.
 */
enum signal_edge {
	EDGE_POSITIVE = 0,
	EDGE_NEGATIVE,
};

/** LWLA device states.
 */
enum device_state {
	STATE_IDLE = 0,

	STATE_START_CAPTURE,

	STATE_STATUS_WAIT,
	STATE_STATUS_REQUEST,
	STATE_STATUS_RESPONSE,

	STATE_STOP_CAPTURE,

	STATE_LENGTH_REQUEST,
	STATE_LENGTH_RESPONSE,

	STATE_READ_PREPARE,
	STATE_READ_REQUEST,
	STATE_READ_RESPONSE,
	STATE_READ_END,
};

/** LWLA run-length encoding states.
 */
enum rle_state {
	RLE_STATE_DATA,
	RLE_STATE_LEN
};

/** LWLA sample acquisition and decompression state.
 */
struct acquisition_state {
	uint64_t sample;
	uint64_t run_len;

	/** Maximum number of samples to process. */
	uint64_t samples_max;
	/** Number of samples sent to the session bus. */
	uint64_t samples_done;

	/** Maximum duration of capture, in milliseconds. */
	uint64_t duration_max;
	/** Running capture duration since trigger event. */
	uint64_t duration_now;

	/** Capture memory fill level. */
	size_t mem_addr_fill;

	size_t mem_addr_done;
	size_t mem_addr_next;
	size_t mem_addr_stop;

	size_t out_index;

	struct libusb_transfer *xfer_in;
	struct libusb_transfer *xfer_out;

	unsigned int capture_flags;

	enum rle_state rle;

	/** Whether to bypass the clock divider. */
	gboolean bypass_clockdiv;

	/* Payload data buffers for incoming and outgoing transfers. */
	uint32_t xfer_buf_in[MAX_ACQ_RECV_LEN];
	uint16_t xfer_buf_out[MAX_ACQ_SEND_WORDS];

	/* Payload buffer for sigrok logic packets. */
	uint8_t out_packet[PACKET_LENGTH * UNIT_SIZE];
};

/** Private, per-device-instance driver context.
 */
struct dev_context {
	/** The samplerate selected by the user. */
	uint64_t samplerate;

	/** The maximum sampling duration, in milliseconds. */
	uint64_t limit_msec;

	/** The maximum number of samples to acquire. */
	uint64_t limit_samples;

	/** Channels to use. */
	uint64_t channel_mask;

	uint64_t trigger_mask;
	uint64_t trigger_edge_mask;
	uint64_t trigger_values;

	struct acquisition_state *acquisition;

	struct regval_pair reg_write_seq[MAX_REG_WRITE_SEQ_LEN];
	int reg_write_pos;
	int reg_write_len;

	enum device_state state;

	/** The currently active clock configuration of the device. */
	enum clock_config cur_clock_config;

	/** Clock source configuration setting. */
	enum clock_source cfg_clock_source;
	/** Clock edge configuration setting. */
	enum signal_edge cfg_clock_edge;

	/** Trigger source configuration setting. */
	enum trigger_source cfg_trigger_source;
	/** Trigger slope configuration setting. */
	enum signal_edge cfg_trigger_slope;

	/* Indicates that stopping the acquisition is currently in progress. */
	gboolean stopping_in_progress;

	/* Indicates whether a transfer failed. */
	gboolean transfer_error;
};

SR_PRIV struct acquisition_state *lwla_alloc_acquisition_state(void);
SR_PRIV void lwla_free_acquisition_state(struct acquisition_state *acq);

SR_PRIV int lwla_init_device(const struct sr_dev_inst *sdi);
SR_PRIV int lwla_convert_trigger(const struct sr_dev_inst *sdi);
SR_PRIV int lwla_set_clock_config(const struct sr_dev_inst *sdi);
SR_PRIV int lwla_setup_acquisition(const struct sr_dev_inst *sdi);
SR_PRIV int lwla_start_acquisition(const struct sr_dev_inst *sdi);
SR_PRIV int lwla_abort_acquisition(const struct sr_dev_inst *sdi);

SR_PRIV int lwla_receive_data(int fd, int revents, void *cb_data);

#endif
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
	20	#ifndef LIBSIGROK_HARDWARE_SYSCLK_LWLA_PROTOCOL_H
	21	#define LIBSIGROK_HARDWARE_SYSCLK_LWLA_PROTOCOL_H
	22
5874e88d DE	23	#define LOG_PREFIX "sysclk-lwla"
5874e88d DE	24
5874e88d DE	25	#include <stdint.h>
5874e88d DE	26	#include <glib.h>
c1aae900	27	#include <libsigrok/libsigrok.h>
515ab088 UH	28	#include "libsigrok-internal.h"
515ab088 UH	29	#include "lwla.h"
aeaad0b0	30
5874e88d DE	31	/* For now, only the LWLA1034 is supported.
	32	*/
	33	#define VENDOR_NAME "SysClk"
	34	#define MODEL_NAME "LWLA1034"
	35
	36	#define USB_VID_PID "2961.6689"
	37	#define USB_INTERFACE 0
1a46cc62	38	#define USB_TIMEOUT_MS 3000
5874e88d	39
3f239f08	40	#define NUM_CHANNELS 34
5874e88d	41
43db3436 DE	42	/* Bit mask covering all 34 channels.
43db3436 DE	43	*/
3f239f08	44	#define ALL_CHANNELS_MASK (((uint64_t)1 << NUM_CHANNELS) - 1)
43db3436	45
5874e88d DE	46	/** Unit and packet size for the sigrok logic datafeed.
5874e88d DE	47	*/
3f239f08	48	#define UNIT_SIZE ((NUM_CHANNELS + 7) / 8)
1a46cc62	49	#define PACKET_LENGTH (10 * 1000) /* units */
5874e88d DE	50
	51	/** Size of the acquisition buffer in device memory units.
	52	*/
	53	#define MEMORY_DEPTH (256 * 1024) /* 256k x 36 bit */
	54
	55	/** Number of device memory units (36 bit) to read at a time. Slices of 8
	56	* consecutive 36-bit words are mapped to 9 32-bit words each, so the chunk
	57	* length should be a multiple of 8 to ensure alignment to slice boundaries.
	58	*
	59	* Experimentation has shown that reading chunks larger than about 1024 bytes
	60	* is unreliable. The threshold seems to relate to the buffer size on the FX2
	61	* USB chip: The configured endpoint buffer size is 512, and with double or
	62	* triple buffering enabled a multiple of 512 bytes can be kept in fly.
	63	*
	64	* The vendor software limits reads to 120 words (15 slices, 540 bytes) at
	65	* a time. So far, it appears safe to increase this to 224 words (28 slices,
	66	* 1008 bytes), thus making the most of two 512 byte buffers.
	67	*/
	68	#define READ_CHUNK_LEN (28 * 8)
	69
e0df15d4	70	/** Calculate the required buffer size in 32-bit units for reading a given
5874e88d DE	71	* number of device memory words. Rounded to a multiple of 8 device words.
5874e88d DE	72	*/
e0df15d4	73	#define LWLA1034_MEMBUF_LEN(count) (((count) + 7) / 8 * 9)
5874e88d DE	74
	75	/** Maximum number of 16-bit words sent at a time during acquisition.
	76	* Used for allocating the libusb transfer buffer.
	77	*/
	78	#define MAX_ACQ_SEND_WORDS 8 /* 5 for memory read request plus stuffing */
	79
e0df15d4	80	/** Maximum number of 32-bit words received at a time during acquisition.
5874e88d DE	81	* Round to the next multiple of the endpoint buffer size to avoid nasty
	82	* transfer overflow conditions on hiccups.
	83	*/
e0df15d4	84	#define MAX_ACQ_RECV_LEN ((READ_CHUNK_LEN / 8 * 9 + 127) / 128 * 128)
5874e88d DE	85
	86	/** Maximum length of a register write sequence.
	87	*/
	88	#define MAX_REG_WRITE_SEQ_LEN 5
	89
	90	/** Default configured samplerate.
	91	*/
	92	#define DEFAULT_SAMPLERATE SR_MHZ(125)
	93
29d58767 DE	94	/** Maximum configurable sample count limit.
	95	*/
	96	#define MAX_LIMIT_SAMPLES (UINT64_C(1) << 48)
	97
	98	/** Maximum configurable capture duration in milliseconds.
	99	*/
	100	#define MAX_LIMIT_MSEC (UINT64_C(1) << 32)
	101
6358f0a9 DE	102	/** LWLA1034 FPGA clock configurations.
	103	*/
	104	enum clock_config {
	105	CONF_CLOCK_NONE,
	106	CONF_CLOCK_INT,
	107	CONF_CLOCK_EXT_RISE,
	108	CONF_CLOCK_EXT_FALL,
	109	};
	110
	111	/** Available clock sources.
5874e88d DE	112	*/
5874e88d DE	113	enum clock_source {
6358f0a9 DE	114	CLOCK_INTERNAL,
6358f0a9 DE	115	CLOCK_EXT_CLK,
5874e88d DE	116	};
5874e88d DE	117
e6e54bd2 DE	118	/** Available trigger sources.
	119	*/
	120	enum trigger_source {
	121	TRIGGER_CHANNELS = 0,
	122	TRIGGER_EXT_TRG,
	123	};
	124
6358f0a9	125	/** Available edge choices for the external clock and trigger inputs.
e6e54bd2	126	*/
6358f0a9 DE	127	enum signal_edge {
	128	EDGE_POSITIVE = 0,
	129	EDGE_NEGATIVE,
e6e54bd2 DE	130	};
e6e54bd2 DE	131
5874e88d DE	132	/** LWLA device states.
	133	*/
	134	enum device_state {
	135	STATE_IDLE = 0,
	136
	137	STATE_START_CAPTURE,
	138
	139	STATE_STATUS_WAIT,
	140	STATE_STATUS_REQUEST,
	141	STATE_STATUS_RESPONSE,
	142
	143	STATE_STOP_CAPTURE,
	144
	145	STATE_LENGTH_REQUEST,
	146	STATE_LENGTH_RESPONSE,
	147
	148	STATE_READ_PREPARE,
	149	STATE_READ_REQUEST,
	150	STATE_READ_RESPONSE,
	151	STATE_READ_END,
	152	};
	153
	154	/** LWLA run-length encoding states.
	155	*/
	156	enum rle_state {
	157	RLE_STATE_DATA,
	158	RLE_STATE_LEN
	159	};
	160
	161	/** LWLA sample acquisition and decompression state.
	162	*/
	163	struct acquisition_state {
	164	uint64_t sample;
	165	uint64_t run_len;
	166
29d58767 DE	167	/** Maximum number of samples to process. */
29d58767 DE	168	uint64_t samples_max;
5874e88d	169	/** Number of samples sent to the session bus. */
29d58767 DE	170	uint64_t samples_done;
	171
	172	/** Maximum duration of capture, in milliseconds. */
	173	uint64_t duration_max;
	174	/** Running capture duration since trigger event. */
	175	uint64_t duration_now;
5874e88d DE	176
	177	/** Capture memory fill level. */
	178	size_t mem_addr_fill;
aeaad0b0	179
5874e88d DE	180	size_t mem_addr_done;
	181	size_t mem_addr_next;
	182	size_t mem_addr_stop;
	183
2cfd16a3	184	size_t out_index;
5874e88d DE	185
	186	struct libusb_transfer *xfer_in;
	187	struct libusb_transfer *xfer_out;
	188
	189	unsigned int capture_flags;
	190
	191	enum rle_state rle;
	192
29d58767 DE	193	/** Whether to bypass the clock divider. */
	194	gboolean bypass_clockdiv;
	195
e0df15d4 DE	196	/* Payload data buffers for incoming and outgoing transfers. */
e0df15d4 DE	197	uint32_t xfer_buf_in[MAX_ACQ_RECV_LEN];
5874e88d	198	uint16_t xfer_buf_out[MAX_ACQ_SEND_WORDS];
5874e88d DE	199
5874e88d DE	200	/* Payload buffer for sigrok logic packets. */
2cfd16a3	201	uint8_t out_packet[PACKET_LENGTH * UNIT_SIZE];
5874e88d DE	202	};
	203
	204	/** Private, per-device-instance driver context.
	205	*/
aeaad0b0	206	struct dev_context {
5874e88d DE	207	/** The samplerate selected by the user. */
	208	uint64_t samplerate;
	209
f3f19d11	210	/** The maximum sampling duration, in milliseconds. */
29d58767 DE	211	uint64_t limit_msec;
29d58767 DE	212
f3f19d11	213	/** The maximum number of samples to acquire. */
5874e88d DE	214	uint64_t limit_samples;
	215
	216	/** Channels to use. */
	217	uint64_t channel_mask;
	218
	219	uint64_t trigger_mask;
	220	uint64_t trigger_edge_mask;
	221	uint64_t trigger_values;
aeaad0b0	222
5874e88d	223	struct acquisition_state *acquisition;
aeaad0b0	224
5874e88d DE	225	struct regval_pair reg_write_seq[MAX_REG_WRITE_SEQ_LEN];
	226	int reg_write_pos;
	227	int reg_write_len;
aeaad0b0	228
5874e88d	229	enum device_state state;
aeaad0b0	230
6358f0a9 DE	231	/** The currently active clock configuration of the device. */
	232	enum clock_config cur_clock_config;
	233
	234	/** Clock source configuration setting. */
	235	enum clock_source cfg_clock_source;
	236	/** Clock edge configuration setting. */
	237	enum signal_edge cfg_clock_edge;
5874e88d	238
e6e54bd2 DE	239	/** Trigger source configuration setting. */
	240	enum trigger_source cfg_trigger_source;
	241	/** Trigger slope configuration setting. */
6358f0a9	242	enum signal_edge cfg_trigger_slope;
e6e54bd2	243
5874e88d DE	244	/* Indicates that stopping the acquisition is currently in progress. */
	245	gboolean stopping_in_progress;
	246
	247	/* Indicates whether a transfer failed. */
	248	gboolean transfer_error;
aeaad0b0 DE	249	};
aeaad0b0 DE	250
5874e88d DE	251	SR_PRIV struct acquisition_state *lwla_alloc_acquisition_state(void);
	252	SR_PRIV void lwla_free_acquisition_state(struct acquisition_state *acq);
	253
	254	SR_PRIV int lwla_init_device(const struct sr_dev_inst *sdi);
bbe7e48a	255	SR_PRIV int lwla_convert_trigger(const struct sr_dev_inst *sdi);
6358f0a9	256	SR_PRIV int lwla_set_clock_config(const struct sr_dev_inst *sdi);
5874e88d DE	257	SR_PRIV int lwla_setup_acquisition(const struct sr_dev_inst *sdi);
	258	SR_PRIV int lwla_start_acquisition(const struct sr_dev_inst *sdi);
	259	SR_PRIV int lwla_abort_acquisition(const struct sr_dev_inst *sdi);
	260
	261	SR_PRIV int lwla_receive_data(int fd, int revents, void *cb_data);
aeaad0b0	262
db24496a	263	#endif