[libsigrok.git] / 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

/* Message logging helpers with subsystem-specific prefix string. */
#define LOG_PREFIX "sysclk-lwla"

#include "lwla.h"
#include "libsigrok.h"
#include "libsigrok-internal.h"
#include <stdint.h>
#include <glib.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	3000 /* ms */

#define NUM_PROBES	34
#define TRIGGER_TYPES	"01fr"

/** Unit and packet size for the sigrok logic datafeed.
 */
#define UNIT_SIZE	((NUM_PROBES + 7) / 8)
#define PACKET_SIZE	(10000 * UNIT_SIZE)	/* bytes */

/** 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 16-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 * 18)

/** 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 16-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_WORDS	((READ_CHUNK_LEN / 4 * 9 + 255) / 256 * 256)

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

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

/** LWLA clock sources.
 */
enum clock_source {
	CLOCK_SOURCE_NONE,
	CLOCK_SOURCE_INT,
	CLOCK_SOURCE_EXT_RISE,
	CLOCK_SOURCE_EXT_FALL,
};

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

	/** Number of samples acquired so far. */
	uint64_t captured_samples;
	/** Number of samples sent to the session bus. */
	uint64_t transferred_samples;

	/** 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_offset;

	struct libusb_transfer *xfer_in;
	struct libusb_transfer *xfer_out;

	unsigned int capture_flags;

	enum rle_state rle;

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

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

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

	/** The maximimum 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;
	enum device_state next_state;

	/** The currently configured clock source of the device. */
	enum clock_source cur_clock_source;
	/** The clock source selected by the user. */
	enum clock_source selected_clock_source;

	/* 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_set_clock_source(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 /* !LIBSIGROK_HARDWARE_SYSCLK_LWLA_PROTOCOL_H */
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	/* Message logging helpers with subsystem-specific prefix string. */
	24	#define LOG_PREFIX "sysclk-lwla"
	25
	26	#include "lwla.h"
aeaad0b0 DE	27	#include "libsigrok.h"
aeaad0b0 DE	28	#include "libsigrok-internal.h"
5874e88d DE	29	#include <stdint.h>
5874e88d DE	30	#include <glib.h>
aeaad0b0	31
5874e88d DE	32	/* For now, only the LWLA1034 is supported.
	33	*/
	34	#define VENDOR_NAME "SysClk"
	35	#define MODEL_NAME "LWLA1034"
	36
	37	#define USB_VID_PID "2961.6689"
	38	#define USB_INTERFACE 0
	39	#define USB_TIMEOUT 3000 /* ms */
	40
	41	#define NUM_PROBES 34
	42	#define TRIGGER_TYPES "01fr"
	43
	44	/** Unit and packet size for the sigrok logic datafeed.
	45	*/
	46	#define UNIT_SIZE ((NUM_PROBES + 7) / 8)
	47	#define PACKET_SIZE (10000 * UNIT_SIZE) /* bytes */
	48
	49	/** Size of the acquisition buffer in device memory units.
	50	*/
	51	#define MEMORY_DEPTH (256 * 1024) /* 256k x 36 bit */
	52
	53	/** Number of device memory units (36 bit) to read at a time. Slices of 8
	54	* consecutive 36-bit words are mapped to 9 32-bit words each, so the chunk
	55	* length should be a multiple of 8 to ensure alignment to slice boundaries.
	56	*
	57	* Experimentation has shown that reading chunks larger than about 1024 bytes
	58	* is unreliable. The threshold seems to relate to the buffer size on the FX2
	59	* USB chip: The configured endpoint buffer size is 512, and with double or
	60	* triple buffering enabled a multiple of 512 bytes can be kept in fly.
	61	*
	62	* The vendor software limits reads to 120 words (15 slices, 540 bytes) at
	63	* a time. So far, it appears safe to increase this to 224 words (28 slices,
	64	* 1008 bytes), thus making the most of two 512 byte buffers.
	65	*/
	66	#define READ_CHUNK_LEN (28 * 8)
	67
	68	/** Calculate the required buffer size in 16-bit units for reading a given
	69	* number of device memory words. Rounded to a multiple of 8 device words.
	70	*/
	71	#define LWLA1034_MEMBUF_LEN(count) (((count) + 7) / 8 * 18)
	72
	73	/** Maximum number of 16-bit words sent at a time during acquisition.
	74	* Used for allocating the libusb transfer buffer.
	75	*/
	76	#define MAX_ACQ_SEND_WORDS 8 /* 5 for memory read request plus stuffing */
	77
	78	/** Maximum number of 16-bit words received at a time during acquisition.
	79	* Round to the next multiple of the endpoint buffer size to avoid nasty
	80	* transfer overflow conditions on hiccups.
	81	*/
	82	#define MAX_ACQ_RECV_WORDS ((READ_CHUNK_LEN / 4 * 9 + 255) / 256 * 256)
	83
	84	/** Maximum length of a register write sequence.
	85	*/
	86	#define MAX_REG_WRITE_SEQ_LEN 5
	87
	88	/** Default configured samplerate.
	89	*/
	90	#define DEFAULT_SAMPLERATE SR_MHZ(125)
	91
	92	/** LWLA clock sources.
	93	*/
	94	enum clock_source {
	95	CLOCK_SOURCE_NONE,
96	CLOCK_SOURCE_INT,
97	CLOCK_SOURCE_EXT_RISE,
98	CLOCK_SOURCE_EXT_FALL,
99	};
100
101	/** LWLA device states.
102	*/
103	enum device_state {
104	STATE_IDLE = 0,
105
106	STATE_START_CAPTURE,
107
108	STATE_STATUS_WAIT,
109	STATE_STATUS_REQUEST,
110	STATE_STATUS_RESPONSE,
111
112	STATE_STOP_CAPTURE,
113
114	STATE_LENGTH_REQUEST,
115	STATE_LENGTH_RESPONSE,
116
117	STATE_READ_PREPARE,
118	STATE_READ_REQUEST,
119	STATE_READ_RESPONSE,
120	STATE_READ_END,
121	};
122
123	/** LWLA run-length encoding states.
124	*/
125	enum rle_state {
126	RLE_STATE_DATA,
127	RLE_STATE_LEN
128	};
129
130	/** LWLA sample acquisition and decompression state.
131	*/
132	struct acquisition_state {
133	uint64_t sample;
134	uint64_t run_len;
135
136	/** Number of samples acquired so far. */
137	uint64_t captured_samples;
138	/** Number of samples sent to the session bus. */
139	uint64_t transferred_samples;
140
141	/** Capture memory fill level. */
142	size_t mem_addr_fill;
aeaad0b0	143
5874e88d DE	144	size_t mem_addr_done;
	145	size_t mem_addr_next;
	146	size_t mem_addr_stop;
	147
	148	size_t out_offset;
	149
	150	struct libusb_transfer *xfer_in;
	151	struct libusb_transfer *xfer_out;
	152
	153	unsigned int capture_flags;
	154
	155	enum rle_state rle;
	156
	157	/* Payload data buffers for outgoing and incoming transfers. */
	158	uint16_t xfer_buf_out[MAX_ACQ_SEND_WORDS];
	159	uint16_t xfer_buf_in[MAX_ACQ_RECV_WORDS];
	160
	161	/* Payload buffer for sigrok logic packets. */
	162	uint8_t out_packet[PACKET_SIZE];
	163	};
	164
	165	/** Private, per-device-instance driver context.
	166	*/
aeaad0b0	167	struct dev_context {
5874e88d DE	168	/** The samplerate selected by the user. */
	169	uint64_t samplerate;
	170
	171	/** The maximimum number of samples to acquire. */
	172	uint64_t limit_samples;
	173
	174	/** Channels to use. */
	175	uint64_t channel_mask;
	176
	177	uint64_t trigger_mask;
	178	uint64_t trigger_edge_mask;
	179	uint64_t trigger_values;
aeaad0b0	180
5874e88d	181	struct acquisition_state *acquisition;
aeaad0b0	182
5874e88d DE	183	struct regval_pair reg_write_seq[MAX_REG_WRITE_SEQ_LEN];
	184	int reg_write_pos;
	185	int reg_write_len;
aeaad0b0	186
5874e88d DE	187	enum device_state state;
5874e88d DE	188	enum device_state next_state;
aeaad0b0	189
5874e88d DE	190	/** The currently configured clock source of the device. */
	191	enum clock_source cur_clock_source;
	192	/** The clock source selected by the user. */
	193	enum clock_source selected_clock_source;
	194
	195	/* Indicates that stopping the acquisition is currently in progress. */
	196	gboolean stopping_in_progress;
	197
	198	/* Indicates whether a transfer failed. */
	199	gboolean transfer_error;
aeaad0b0 DE	200	};
aeaad0b0 DE	201
5874e88d DE	202	SR_PRIV struct acquisition_state *lwla_alloc_acquisition_state(void);
	203	SR_PRIV void lwla_free_acquisition_state(struct acquisition_state *acq);
	204
	205	SR_PRIV int lwla_init_device(const struct sr_dev_inst *sdi);
	206	SR_PRIV int lwla_set_clock_source(const struct sr_dev_inst *sdi);
	207	SR_PRIV int lwla_setup_acquisition(const struct sr_dev_inst *sdi);
	208	SR_PRIV int lwla_start_acquisition(const struct sr_dev_inst *sdi);
	209	SR_PRIV int lwla_abort_acquisition(const struct sr_dev_inst *sdi);
	210
	211	SR_PRIV int lwla_receive_data(int fd, int revents, void *cb_data);
aeaad0b0	212
5874e88d	213	#endif /* !LIBSIGROK_HARDWARE_SYSCLK_LWLA_PROTOCOL_H */