[libsigrok.git] / src / hardware / uni-t-ut32x / protocol.c

/*
 * This file is part of the libsigrok project.
 *
 * Copyright (C) 2013 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 <config.h>
#include <string.h>
#include <math.h>
#include "protocol.h"

#define SEP	"\r\n"
#define BLANK	':'
#define NEG	';'

/*
 * Get a temperature value from a four-character buffer. The value is
 * encoded in ASCII and the unit is deci-degrees (tenths of degrees).
 */
static float parse_temperature(unsigned char *buf)
{
	float temp;
	int i;
	gboolean negative;

	negative = FALSE;
	temp = 0.0;
	for (i = 0; i < 4; i++) {
		if (buf[i] == BLANK)
			continue;
		if (buf[i] == NEG) {
			if (negative) {
				sr_dbg("Double negative sign!");
				return NAN;
			}
			negative = TRUE;
			continue;
		}
		if (buf[i] < '0' || buf[i] > '9') {
			sr_dbg("Invalid digit '%.2x'!", buf[i]);
			return NAN;
		}
		temp *= 10;
		temp += buf[i] - '0';
	}
	temp /= 10;
	if (negative)
		temp = -temp;

	return temp;
}

static void process_packet(struct sr_dev_inst *sdi, uint8_t *pkt, size_t len)
{
	struct dev_context *devc;
	struct sr_datafeed_packet packet;
	struct sr_datafeed_analog analog;
	struct sr_analog_encoding encoding;
	struct sr_analog_meaning meaning;
	struct sr_analog_spec spec;
	GString *spew;
	float temp;
	gboolean is_valid;

	if (sr_log_loglevel_get() >= SR_LOG_SPEW) {
		spew = sr_hexdump_new(pkt, len);
		sr_spew("Got a packet, len %zu, bytes%s", len, spew->str);
		sr_hexdump_free(spew);
	}
	if (len != PACKET_SIZE)
		return;
	if (pkt[17] != SEP[0] || pkt[18] != SEP[1])
		return;
	if (pkt[8] != '0' || pkt[16] != '1')
		return;
	sr_dbg("Processing 19-byte packet.");

	is_valid = TRUE;
	if (pkt[1] == NEG && pkt[2] == NEG && pkt[3] == NEG && pkt[4] == NEG)
		/* No measurement: missing channel, empty storage location, ... */
		is_valid = FALSE;

	temp = parse_temperature(&pkt[1]);
	if (isnan(temp))
		is_valid = FALSE;

	if (is_valid) {
		memset(&packet, 0, sizeof(packet));
		sr_analog_init(&analog, &encoding, &meaning, &spec, 1);
		analog.meaning->mq = SR_MQ_TEMPERATURE;
		analog.meaning->mqflags = 0;
		switch (pkt[5] - '0') {
		case 1:
			analog.meaning->unit = SR_UNIT_CELSIUS;
			break;
		case 2:
			analog.meaning->unit = SR_UNIT_FAHRENHEIT;
			break;
		case 3:
			analog.meaning->unit = SR_UNIT_KELVIN;
			break;
		default:
			/* We can still pass on the measurement, whatever it is. */
			sr_dbg("Unknown unit 0x%.2x.", pkt[5]);
		}
		switch (pkt[13] - '0') {
		case 0:
			/* Channel T1. */
			analog.meaning->channels = g_slist_append(NULL, g_slist_nth_data(sdi->channels, 0));
			break;
		case 1:
			/* Channel T2. */
			analog.meaning->channels = g_slist_append(NULL, g_slist_nth_data(sdi->channels, 1));
			break;
		case 2:
		case 3:
			/* Channel T1-T2. */
			analog.meaning->channels = g_slist_append(NULL, g_slist_nth_data(sdi->channels, 2));
			analog.meaning->mqflags |= SR_MQFLAG_RELATIVE;
			break;
		default:
			sr_err("Unknown channel 0x%.2x.", pkt[13]);
			is_valid = FALSE;
		}
		if (is_valid) {
			analog.num_samples = 1;
			analog.data = &temp;
			packet.type = SR_DF_ANALOG;
			packet.payload = &analog;
			sr_session_send(sdi, &packet);
			g_slist_free(analog.meaning->channels);
		}
	}

	/*
	 * We count packets even if the measurement was invalid. This way
	 * a sample limit on "Memory" data source still works: Unused
	 * memory slots come through as "----" measurements.
	 */
	devc = sdi->priv;
	sr_sw_limits_update_samples_read(&devc->limits, 1);
	if (sr_sw_limits_check(&devc->limits))
		sr_dev_acquisition_stop(sdi);
}

static int process_buffer(struct sr_dev_inst *sdi)
{
	struct dev_context *devc;
	uint8_t *pkt;
	size_t remain, idx;

	/*
	 * Specifically do not insist on finding the packet boundary at
	 * the end of the most recently received data chunk. Serial
	 * ports might involve hardware buffers (FIFO). We want to sync
	 * as fast as possible.
	 *
	 * Handle the synchronized situation first. Process complete
	 * packets that reside at the start of the buffer. Then fallback
	 * to incomplete or unaligned packets if the receive buffer
	 * still contains data bytes. (Depending on the bitrate and the
	 * poll interval, we may always end up in the manual search. But
	 * considering the update rate - two or three packets per second
	 * - this is not an issue.)
	 */
	devc = sdi->priv;
	pkt = &devc->packet[0];
	while (devc->packet_len >= PACKET_SIZE &&
			pkt[PACKET_SIZE - 2] == SEP[0] &&
			pkt[PACKET_SIZE - 1] == SEP[1]) {
		process_packet(sdi, &pkt[0], PACKET_SIZE);
		remain = devc->packet_len - PACKET_SIZE;
		if (remain)
			memmove(&pkt[0], &pkt[PACKET_SIZE], remain);
		devc->packet_len -= PACKET_SIZE;
	}

	/*
	 * The 'for' loop and the increment upon re-iteration after
	 * setting the loop var to zero is not an issue. The marker has
	 * two bytes, so effectively starting the search at offset 1 is
	 * fine for the specific packet layout.
	 */
	for (idx = 0; idx < devc->packet_len; idx++) {
		if (idx < 1)
			continue;
		if (pkt[idx - 1] != SEP[0] || pkt[idx] != SEP[1])
			continue;
		/* Found a packet that spans up to and including 'idx'. */
		idx++;
		process_packet(sdi, &pkt[0], idx);
		remain = devc->packet_len - idx;
		if (remain)
			memmove(&pkt[0], &pkt[idx], remain);
		devc->packet_len -= idx;
		idx = 0;
	}

	return 0;
}

SR_PRIV void LIBUSB_CALL uni_t_ut32x_receive_transfer(struct libusb_transfer *transfer)
{
	struct dev_context *devc;
	struct sr_dev_inst *sdi;
	int hid_payload_len, ret;

	sdi = transfer->user_data;
	devc = sdi->priv;
	if (transfer->actual_length == 8) {
		/* CH9325 encodes length in low nibble of first byte, with
		 * bytes 1-7 being the (padded) payload. */
		hid_payload_len = transfer->buffer[0] & 0x0f;
		memcpy(devc->packet + devc->packet_len, transfer->buffer + 1,
				hid_payload_len);
		devc->packet_len += hid_payload_len;
		/*
		 * Discard receive data when the buffer is exhausted. This shall
		 * allow to (re-)synchronize to the data stream when we find it
		 * in an arbitrary state. Check the receive buffer for packets.
		 */
		if (devc->packet_len == sizeof(devc->packet)) {
			process_packet(sdi, &devc->packet[0], devc->packet_len);
			devc->packet_len = 0;
		}
		process_buffer(sdi);
	}

	/* Get the next transfer (unless we're shutting down). */
	if (sdi->status != SR_ST_STOPPING) {
		if ((ret = libusb_submit_transfer(devc->xfer)) != 0) {
			sr_dbg("Failed to resubmit transfer: %s", libusb_error_name(ret));
			sdi->status = SR_ST_STOPPING;
			libusb_free_transfer(devc->xfer);
		}
	} else
		libusb_free_transfer(devc->xfer);

}

SR_PRIV int uni_t_ut32x_handle_events(int fd, int revents, void *cb_data)
{
	struct drv_context *drvc;
	struct dev_context *devc;
	struct sr_dev_driver *di;
	struct sr_dev_inst *sdi;
	struct sr_usb_dev_inst *usb;
	struct timeval tv;
	int len, ret;
	unsigned char cmd[2];

	(void)fd;
	(void)revents;

	if (!(sdi = cb_data))
		return TRUE;

	di = sdi->driver;
	drvc = di->context;

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

	memset(&tv, 0, sizeof(struct timeval));
	libusb_handle_events_timeout_completed(drvc->sr_ctx->libusb_ctx, &tv,
			NULL);

	if (sdi->status == SR_ST_STOPPING) {
		usb_source_remove(sdi->session, drvc->sr_ctx);
		std_session_send_df_end(sdi);

		/* Tell the device to stop sending USB packets. */
		usb = sdi->conn;
		cmd[0] = 0x01;
		cmd[1] = CMD_STOP;
		ret = libusb_bulk_transfer(usb->devhdl, EP_OUT, cmd, 2, &len, 5);
		if (ret != 0 || len != 2) {
			/* Warning only, doesn't matter. */
			sr_dbg("Failed to send stop command: %s", libusb_error_name(ret));
		}

		sdi->status = SR_ST_ACTIVE;
		return TRUE;
	}

	return TRUE;
}
Commit	Line	Data
3877dde4 BV	1	/*
	2	* This file is part of the libsigrok project.
	3	*
	4	* Copyright (C) 2013 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
6ec6c43b	20	#include <config.h>
d6ff054a BV	21	#include <string.h>
d6ff054a BV	22	#include <math.h>
515ab088	23	#include "protocol.h"
d6ff054a	24
4b319782 GS	25	#define SEP "\r\n"
	26	#define BLANK ':'
	27	#define NEG ';'
	28
	29	/*
	30	* Get a temperature value from a four-character buffer. The value is
	31	* encoded in ASCII and the unit is deci-degrees (tenths of degrees).
	32	*/
d6ff054a	33	static float parse_temperature(unsigned char *buf)
3877dde4	34	{
d6ff054a BV	35	float temp;
	36	int i;
	37	gboolean negative;
	38
	39	negative = FALSE;
	40	temp = 0.0;
	41	for (i = 0; i < 4; i++) {
4b319782	42	if (buf[i] == BLANK)
d6ff054a	43	continue;
4b319782	44	if (buf[i] == NEG) {
d6ff054a BV	45	if (negative) {
	46	sr_dbg("Double negative sign!");
	47	return NAN;
d6ff054a	48	}
4b319782 GS	49	negative = TRUE;
4b319782 GS	50	continue;
d6ff054a	51	}
4b319782	52	if (buf[i] < '0' \|\| buf[i] > '9') {
d6ff054a BV	53	sr_dbg("Invalid digit '%.2x'!", buf[i]);
	54	return NAN;
	55	}
	56	temp *= 10;
4b319782	57	temp += buf[i] - '0';
d6ff054a BV	58	}
	59	temp /= 10;
	60	if (negative)
	61	temp = -temp;
3877dde4	62
d6ff054a BV	63	return temp;
	64	}
	65
a0ba75bd	66	static void process_packet(struct sr_dev_inst sdi, uint8_t pkt, size_t len)
d6ff054a	67	{
3877dde4	68	struct dev_context *devc;
d6ff054a	69	struct sr_datafeed_packet packet;
16544b38 UH	70	struct sr_datafeed_analog analog;
	71	struct sr_analog_encoding encoding;
	72	struct sr_analog_meaning meaning;
	73	struct sr_analog_spec spec;
d6ff054a BV	74	GString *spew;
d6ff054a BV	75	float temp;
d6ff054a	76	gboolean is_valid;
3877dde4	77
d6ff054a	78	if (sr_log_loglevel_get() >= SR_LOG_SPEW) {
a0ba75bd GS	79	spew = sr_hexdump_new(pkt, len);
	80	sr_spew("Got a packet, len %zu, bytes%s", len, spew->str);
	81	sr_hexdump_free(spew);
d6ff054a	82	}
a0ba75bd GS	83	if (len != PACKET_SIZE)
	84	return;
	85	if (pkt[17] != SEP[0] \|\| pkt[18] != SEP[1])
	86	return;
	87	if (pkt[8] != '0' \|\| pkt[16] != '1')
	88	return;
	89	sr_dbg("Processing 19-byte packet.");
3877dde4	90
d6ff054a	91	is_valid = TRUE;
a0ba75bd	92	if (pkt[1] == NEG && pkt[2] == NEG && pkt[3] == NEG && pkt[4] == NEG)
ba7dd8bb	93	/* No measurement: missing channel, empty storage location, ... */
d6ff054a	94	is_valid = FALSE;
3877dde4	95
a0ba75bd	96	temp = parse_temperature(&pkt[1]);
d6ff054a BV	97	if (isnan(temp))
	98	is_valid = FALSE;
	99
	100	if (is_valid) {
a0ba75bd	101	memset(&packet, 0, sizeof(packet));
1db537c3	102	sr_analog_init(&analog, &encoding, &meaning, &spec, 1);
16544b38 UH	103	analog.meaning->mq = SR_MQ_TEMPERATURE;
16544b38 UH	104	analog.meaning->mqflags = 0;
a0ba75bd	105	switch (pkt[5] - '0') {
d6ff054a	106	case 1:
16544b38	107	analog.meaning->unit = SR_UNIT_CELSIUS;
d6ff054a BV	108	break;
d6ff054a BV	109	case 2:
16544b38	110	analog.meaning->unit = SR_UNIT_FAHRENHEIT;
d6ff054a BV	111	break;
d6ff054a BV	112	case 3:
16544b38	113	analog.meaning->unit = SR_UNIT_KELVIN;
d6ff054a BV	114	break;
	115	default:
	116	/* We can still pass on the measurement, whatever it is. */
a0ba75bd	117	sr_dbg("Unknown unit 0x%.2x.", pkt[5]);
d6ff054a	118	}
a0ba75bd	119	switch (pkt[13] - '0') {
d6ff054a	120	case 0:
ba7dd8bb	121	/* Channel T1. */
16544b38	122	analog.meaning->channels = g_slist_append(NULL, g_slist_nth_data(sdi->channels, 0));
d6ff054a BV	123	break;
d6ff054a BV	124	case 1:
ba7dd8bb	125	/* Channel T2. */
16544b38	126	analog.meaning->channels = g_slist_append(NULL, g_slist_nth_data(sdi->channels, 1));
d6ff054a BV	127	break;
	128	case 2:
	129	case 3:
ba7dd8bb	130	/* Channel T1-T2. */
16544b38 UH	131	analog.meaning->channels = g_slist_append(NULL, g_slist_nth_data(sdi->channels, 2));
16544b38 UH	132	analog.meaning->mqflags \|= SR_MQFLAG_RELATIVE;
d6ff054a BV	133	break;
d6ff054a BV	134	default:
a0ba75bd	135	sr_err("Unknown channel 0x%.2x.", pkt[13]);
d6ff054a BV	136	is_valid = FALSE;
	137	}
	138	if (is_valid) {
	139	analog.num_samples = 1;
	140	analog.data = &temp;
16544b38	141	packet.type = SR_DF_ANALOG;
d6ff054a	142	packet.payload = &analog;
695dc859	143	sr_session_send(sdi, &packet);
16544b38	144	g_slist_free(analog.meaning->channels);
d6ff054a BV	145	}
	146	}
	147
9e111972 GS	148	/*
	149	* We count packets even if the measurement was invalid. This way
	150	* a sample limit on "Memory" data source still works: Unused
	151	* memory slots come through as "----" measurements.
	152	*/
a0ba75bd	153	devc = sdi->priv;
9e111972 GS	154	sr_sw_limits_update_samples_read(&devc->limits, 1);
9e111972 GS	155	if (sr_sw_limits_check(&devc->limits))
d2f7c417	156	sr_dev_acquisition_stop(sdi);
3877dde4	157	}
6513f97f	158
f0e6b41f GS	159	static int process_buffer(struct sr_dev_inst *sdi)
	160	{
	161	struct dev_context *devc;
	162	uint8_t *pkt;
	163	size_t remain, idx;
	164
	165	/*
	166	* Specifically do not insist on finding the packet boundary at
	167	* the end of the most recently received data chunk. Serial
	168	* ports might involve hardware buffers (FIFO). We want to sync
	169	* as fast as possible.
	170	*
	171	* Handle the synchronized situation first. Process complete
	172	* packets that reside at the start of the buffer. Then fallback
	173	* to incomplete or unaligned packets if the receive buffer
	174	* still contains data bytes. (Depending on the bitrate and the
	175	* poll interval, we may always end up in the manual search. But
	176	* considering the update rate - two or three packets per second
	177	* - this is not an issue.)
	178	*/
	179	devc = sdi->priv;
	180	pkt = &devc->packet[0];
	181	while (devc->packet_len >= PACKET_SIZE &&
	182	pkt[PACKET_SIZE - 2] == SEP[0] &&
	183	pkt[PACKET_SIZE - 1] == SEP[1]) {
	184	process_packet(sdi, &pkt[0], PACKET_SIZE);
	185	remain = devc->packet_len - PACKET_SIZE;
	186	if (remain)
	187	memmove(&pkt[0], &pkt[PACKET_SIZE], remain);
	188	devc->packet_len -= PACKET_SIZE;
	189	}
	190
	191	/*
	192	* The 'for' loop and the increment upon re-iteration after
	193	* setting the loop var to zero is not an issue. The marker has
	194	* two bytes, so effectively starting the search at offset 1 is
	195	* fine for the specific packet layout.
	196	*/
	197	for (idx = 0; idx < devc->packet_len; idx++) {
	198	if (idx < 1)
	199	continue;
	200	if (pkt[idx - 1] != SEP[0] \|\| pkt[idx] != SEP[1])
	201	continue;
	202	/* Found a packet that spans up to and including 'idx'. */
	203	idx++;
	204	process_packet(sdi, &pkt[0], idx);
	205	remain = devc->packet_len - idx;
	206	if (remain)
	207	memmove(&pkt[0], &pkt[idx], remain);
	208	devc->packet_len -= idx;
	209	idx = 0;
	210	}
	211
	212	return 0;
	213	}
	214
55462b8b	215	SR_PRIV void LIBUSB_CALL uni_t_ut32x_receive_transfer(struct libusb_transfer *transfer)
6513f97f	216	{
d6ff054a BV	217	struct dev_context *devc;
	218	struct sr_dev_inst *sdi;
	219	int hid_payload_len, ret;
	220
	221	sdi = transfer->user_data;
	222	devc = sdi->priv;
	223	if (transfer->actual_length == 8) {
	224	/* CH9325 encodes length in low nibble of first byte, with
	225	* bytes 1-7 being the (padded) payload. */
	226	hid_payload_len = transfer->buffer[0] & 0x0f;
	227	memcpy(devc->packet + devc->packet_len, transfer->buffer + 1,
	228	hid_payload_len);
	229	devc->packet_len += hid_payload_len;
f0e6b41f GS	230	/*
	231	* Discard receive data when the buffer is exhausted. This shall
	232	* allow to (re-)synchronize to the data stream when we find it
	233	* in an arbitrary state. Check the receive buffer for packets.
	234	*/
	235	if (devc->packet_len == sizeof(devc->packet)) {
	236	process_packet(sdi, &devc->packet[0], devc->packet_len);
d6ff054a BV	237	devc->packet_len = 0;
d6ff054a BV	238	}
f0e6b41f	239	process_buffer(sdi);
d6ff054a BV	240	}
	241
	242	/* Get the next transfer (unless we're shutting down). */
	243	if (sdi->status != SR_ST_STOPPING) {
	244	if ((ret = libusb_submit_transfer(devc->xfer)) != 0) {
	245	sr_dbg("Failed to resubmit transfer: %s", libusb_error_name(ret));
	246	sdi->status = SR_ST_STOPPING;
	247	libusb_free_transfer(devc->xfer);
	248	}
	249	} else
	250	libusb_free_transfer(devc->xfer);
6513f97f BV	251
	252	}
	253
d6ff054a BV	254	SR_PRIV int uni_t_ut32x_handle_events(int fd, int revents, void *cb_data)
	255	{
	256	struct drv_context *drvc;
	257	struct dev_context *devc;
4f840ce9	258	struct sr_dev_driver *di;
d6ff054a	259	struct sr_dev_inst *sdi;
d6ff054a BV	260	struct sr_usb_dev_inst *usb;
d6ff054a BV	261	struct timeval tv;
6c60facc	262	int len, ret;
d6ff054a BV	263	unsigned char cmd[2];
	264
	265	(void)fd;
	266	(void)revents;
8bd3daa4	267
d6ff054a BV	268	if (!(sdi = cb_data))
	269	return TRUE;
	270
4f840ce9	271	di = sdi->driver;
41812aca	272	drvc = di->context;
4f840ce9	273
d6ff054a BV	274	if (!(devc = sdi->priv))
	275	return TRUE;
	276
	277	memset(&tv, 0, sizeof(struct timeval));
	278	libusb_handle_events_timeout_completed(drvc->sr_ctx->libusb_ctx, &tv,
	279	NULL);
	280
	281	if (sdi->status == SR_ST_STOPPING) {
102f1239	282	usb_source_remove(sdi->session, drvc->sr_ctx);
bee2b016	283	std_session_send_df_end(sdi);
d6ff054a BV	284
	285	/* Tell the device to stop sending USB packets. */
	286	usb = sdi->conn;
	287	cmd[0] = 0x01;
	288	cmd[1] = CMD_STOP;
	289	ret = libusb_bulk_transfer(usb->devhdl, EP_OUT, cmd, 2, &len, 5);
	290	if (ret != 0 \|\| len != 2) {
	291	/* Warning only, doesn't matter. */
	292	sr_dbg("Failed to send stop command: %s", libusb_error_name(ret));
	293	}
	294
	295	sdi->status = SR_ST_ACTIVE;
	296	return TRUE;
	297	}
	298
	299	return TRUE;
	300	}