[libsigrok.git] / src / hardware / teleinfo / protocol.c

/*
 * This file is part of the libsigrok project.
 *
 * Copyright (C) 2013 Aurelien Jacobs <aurel@gnuage.org>
 *
 * 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 <stdlib.h>
#include <string.h>
#include <glib.h>
#include "protocol.h"

#define STX  0x02
#define ETX  0x03
#define EOT  0x04
#define LF   0x0A
#define CR   0x0D

static gboolean teleinfo_control_check(char *label, char *data, char control)
{
	int sum = 0;
	while (*label)
		sum += *label++;
	sum += ' ';
	while (*data)
		sum += *data++;
	return ((sum & 0x3F) + ' ') == control;
}

static gint teleinfo_channel_compare(gconstpointer a, gconstpointer b)
{
	const struct sr_channel *ch = a;
	const char *name = b;
	return strcmp(ch->name, name);
}

static struct sr_channel *teleinfo_find_channel(struct sr_dev_inst *sdi,
                                            const char *name)
{
	GSList *elem = g_slist_find_custom(sdi->channels, name,
	                                   teleinfo_channel_compare);
	return elem ? elem->data : NULL;
}

static void teleinfo_send_value(struct sr_dev_inst *sdi, const char *channel_name,
                                float value, enum sr_mq mq, enum sr_unit unit)
{
	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;
	struct sr_channel *ch;

	ch = teleinfo_find_channel(sdi, channel_name);

	if (!ch || !ch->enabled)
		return;

	/* Note: digits/spec_digits is actually really 0 for this device! */
	sr_analog_init(&analog, &encoding, &meaning, &spec, 0);
	analog.meaning->channels = g_slist_append(analog.meaning->channels, ch);
	analog.num_samples = 1;
	analog.meaning->mq = mq;
	analog.meaning->unit = unit;
	analog.data = &value;

	packet.type = SR_DF_ANALOG;
	packet.payload = &analog;
	sr_session_send(sdi, &packet);
	g_slist_free(analog.meaning->channels);
}

static void teleinfo_handle_measurement(struct sr_dev_inst *sdi,
		const char *label, const char *data, char *optarif)
{
	struct dev_context *devc;
	int v = atoi(data);

	if (!sdi || !(devc = sdi->priv)) {
		if (optarif && !strcmp(label, "OPTARIF"))
			strcpy(optarif, data);
		return;
	}

	if (!strcmp(label, "ADCO"))
		sr_sw_limits_update_samples_read(&devc->sw_limits, 1);
	else if (!strcmp(label, "BASE"))
		teleinfo_send_value(sdi, "BASE", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "HCHP"))
		teleinfo_send_value(sdi, "HP"  , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "HCHC"))
		teleinfo_send_value(sdi, "HC"  , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "EJPHN"))
		teleinfo_send_value(sdi, "HN"  , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "EJPHPM"))
		teleinfo_send_value(sdi, "HPM" , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "BBRHPJB"))
		teleinfo_send_value(sdi, "HPJB", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "BBRHPJW"))
		teleinfo_send_value(sdi, "HPJW", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "BBRHPJR"))
		teleinfo_send_value(sdi, "HPJR", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "BBRHCJB"))
		teleinfo_send_value(sdi, "HCJB", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "BBRHCJW"))
		teleinfo_send_value(sdi, "HCJW", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "BBRHCJR"))
		teleinfo_send_value(sdi, "HCJR", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	else if (!strcmp(label, "IINST"))
		teleinfo_send_value(sdi, "IINST", v, SR_MQ_CURRENT, SR_UNIT_AMPERE);
	else if (!strcmp(label, "PAPP"))
		teleinfo_send_value(sdi, "PAPP", v, SR_MQ_POWER, SR_UNIT_VOLT_AMPERE);
}

static gboolean teleinfo_parse_group(struct sr_dev_inst *sdi,
                                     const uint8_t *group, char *optarif)
{
	char label[9], data[13], control, cr;
	const char *str = (const char *)group;
	if (sscanf(str, "\x0A%8s %13s %c%c", label, data, &control, &cr) != 4
	    || cr != CR)
		return FALSE;
	if (!teleinfo_control_check(label, data, control))
		return FALSE;
	teleinfo_handle_measurement(sdi, label, data, optarif);
	return TRUE;
}

static const uint8_t *teleinfo_parse_data(struct sr_dev_inst *sdi,
                                          const uint8_t *buf, int len,
                                          char *optarif)
{
	const uint8_t *group_start, *group_end;

	group_start = memchr(buf, LF, len);
	if (!group_start)
		return NULL;

	group_end = memchr(group_start, CR, len - (group_start - buf));
	if (!group_end)
		return NULL;

	teleinfo_parse_group(sdi, group_start, optarif);
	return group_end + 1;
}

SR_PRIV int teleinfo_get_optarif(const uint8_t *buf)
{
	const uint8_t *ptr = buf;
	char optarif[5] = { 0 };

	while ((ptr = teleinfo_parse_data(NULL, ptr, 292-(ptr-buf), optarif)));
	if (!strcmp(optarif, "BASE"))
		return OPTARIF_BASE;
	else if (!strcmp(optarif, "HC.."))
		return OPTARIF_HC;
	else if (!strcmp(optarif, "EJP."))
		return OPTARIF_EJP;
	else if (!strncmp(optarif, "BBR", 3))
		return OPTARIF_BBR;
	return OPTARIF_NONE;
}

SR_PRIV gboolean teleinfo_packet_valid(const uint8_t *buf)
{
	return !!teleinfo_get_optarif(buf);
}

SR_PRIV int teleinfo_receive_data(int fd, int revents, void *cb_data)
{
	struct sr_dev_inst *sdi;
	struct dev_context *devc;
	struct sr_serial_dev_inst *serial;
	const uint8_t *ptr, *next_ptr, *end_ptr;
	int len;

	(void)fd;

	if (!(sdi = cb_data) || !(devc = sdi->priv) || revents != G_IO_IN)
		return TRUE;
	serial = sdi->conn;

	/* Try to get as much data as the buffer can hold. */
	len = TELEINFO_BUF_SIZE - devc->buf_len;
	len = serial_read_nonblocking(serial, devc->buf + devc->buf_len, len);
	if (len < 1) {
		sr_err("Serial port read error: %d.", len);
		return FALSE;
	}
	devc->buf_len += len;

	/* Now look for packets in that data. */
	ptr = devc->buf;
	end_ptr = ptr + devc->buf_len;
	while ((next_ptr = teleinfo_parse_data(sdi, ptr, end_ptr - ptr, NULL)))
		ptr = next_ptr;

	/* If we have any data left, move it to the beginning of our buffer. */
	memmove(devc->buf, ptr, end_ptr - ptr);
	devc->buf_len -= ptr - devc->buf;

	/* If buffer is full and no valid packet was found, wipe buffer. */
	if (devc->buf_len >= TELEINFO_BUF_SIZE) {
		devc->buf_len = 0;
		return FALSE;
	}

	if (sr_sw_limits_check(&devc->sw_limits))
		sr_dev_acquisition_stop(sdi);

	return TRUE;
}
Commit	Line	Data
	1	/*
	2	* This file is part of the libsigrok project.
	3	*
	4	* Copyright (C) 2013 Aurelien Jacobs <aurel@gnuage.org>
	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	#include <config.h>
	21	#include <stdlib.h>
	22	#include <string.h>
	23	#include <glib.h>
	24	#include "protocol.h"
	25
	26	#define STX 0x02
	27	#define ETX 0x03
	28	#define EOT 0x04
	29	#define LF 0x0A
	30	#define CR 0x0D
	31
	32	static gboolean teleinfo_control_check(char label, char data, char control)
	33	{
	34	int sum = 0;
	35	while (*label)
	36	sum += *label++;
	37	sum += ' ';
	38	while (*data)
	39	sum += *data++;
	40	return ((sum & 0x3F) + ' ') == control;
	41	}
	42
	43	static gint teleinfo_channel_compare(gconstpointer a, gconstpointer b)
	44	{
	45	const struct sr_channel *ch = a;
	46	const char *name = b;
	47	return strcmp(ch->name, name);
	48	}
	49
	50	static struct sr_channel teleinfo_find_channel(struct sr_dev_inst sdi,
	51	const char *name)
	52	{
	53	GSList *elem = g_slist_find_custom(sdi->channels, name,
	54	teleinfo_channel_compare);
	55	return elem ? elem->data : NULL;
	56	}
	57
	58	static void teleinfo_send_value(struct sr_dev_inst sdi, const char channel_name,
	59	float value, enum sr_mq mq, enum sr_unit unit)
	60	{
	61	struct sr_datafeed_packet packet;
	62	struct sr_datafeed_analog analog;
	63	struct sr_analog_encoding encoding;
	64	struct sr_analog_meaning meaning;
	65	struct sr_analog_spec spec;
	66	struct sr_channel *ch;
	67
	68	ch = teleinfo_find_channel(sdi, channel_name);
	69
	70	if (!ch \|\| !ch->enabled)
	71	return;
	72
	73	/* Note: digits/spec_digits is actually really 0 for this device! */
	74	sr_analog_init(&analog, &encoding, &meaning, &spec, 0);
	75	analog.meaning->channels = g_slist_append(analog.meaning->channels, ch);
	76	analog.num_samples = 1;
	77	analog.meaning->mq = mq;
	78	analog.meaning->unit = unit;
	79	analog.data = &value;
	80
	81	packet.type = SR_DF_ANALOG;
	82	packet.payload = &analog;
	83	sr_session_send(sdi, &packet);
	84	g_slist_free(analog.meaning->channels);
	85	}
	86
	87	static void teleinfo_handle_measurement(struct sr_dev_inst *sdi,
	88	const char label, const char data, char *optarif)
	89	{
	90	struct dev_context *devc;
	91	int v = atoi(data);
	92
	93	if (!sdi \|\| !(devc = sdi->priv)) {
	94	if (optarif && !strcmp(label, "OPTARIF"))
	95	strcpy(optarif, data);
	96	return;
	97	}
	98
	99	if (!strcmp(label, "ADCO"))
	100	sr_sw_limits_update_samples_read(&devc->sw_limits, 1);
	101	else if (!strcmp(label, "BASE"))
	102	teleinfo_send_value(sdi, "BASE", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	103	else if (!strcmp(label, "HCHP"))
	104	teleinfo_send_value(sdi, "HP" , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	105	else if (!strcmp(label, "HCHC"))
	106	teleinfo_send_value(sdi, "HC" , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	107	else if (!strcmp(label, "EJPHN"))
	108	teleinfo_send_value(sdi, "HN" , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	109	else if (!strcmp(label, "EJPHPM"))
	110	teleinfo_send_value(sdi, "HPM" , v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	111	else if (!strcmp(label, "BBRHPJB"))
	112	teleinfo_send_value(sdi, "HPJB", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	113	else if (!strcmp(label, "BBRHPJW"))
	114	teleinfo_send_value(sdi, "HPJW", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	115	else if (!strcmp(label, "BBRHPJR"))
	116	teleinfo_send_value(sdi, "HPJR", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	117	else if (!strcmp(label, "BBRHCJB"))
	118	teleinfo_send_value(sdi, "HCJB", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	119	else if (!strcmp(label, "BBRHCJW"))
	120	teleinfo_send_value(sdi, "HCJW", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	121	else if (!strcmp(label, "BBRHCJR"))
	122	teleinfo_send_value(sdi, "HCJR", v, SR_MQ_POWER, SR_UNIT_WATT_HOUR);
	123	else if (!strcmp(label, "IINST"))
	124	teleinfo_send_value(sdi, "IINST", v, SR_MQ_CURRENT, SR_UNIT_AMPERE);
	125	else if (!strcmp(label, "PAPP"))
	126	teleinfo_send_value(sdi, "PAPP", v, SR_MQ_POWER, SR_UNIT_VOLT_AMPERE);
	127	}
	128
	129	static gboolean teleinfo_parse_group(struct sr_dev_inst *sdi,
	130	const uint8_t group, char optarif)
	131	{
	132	char label[9], data[13], control, cr;
	133	const char str = (const char )group;
	134	if (sscanf(str, "\x0A%8s %13s %c%c", label, data, &control, &cr) != 4
	135	\|\| cr != CR)
	136	return FALSE;
	137	if (!teleinfo_control_check(label, data, control))
	138	return FALSE;
	139	teleinfo_handle_measurement(sdi, label, data, optarif);
	140	return TRUE;
	141	}
	142
	143	static const uint8_t teleinfo_parse_data(struct sr_dev_inst sdi,
	144	const uint8_t *buf, int len,
	145	char *optarif)
	146	{
	147	const uint8_t group_start, group_end;
	148
	149	group_start = memchr(buf, LF, len);
	150	if (!group_start)
	151	return NULL;
	152
	153	group_end = memchr(group_start, CR, len - (group_start - buf));
	154	if (!group_end)
	155	return NULL;
	156
	157	teleinfo_parse_group(sdi, group_start, optarif);
	158	return group_end + 1;
	159	}
	160
	161	SR_PRIV int teleinfo_get_optarif(const uint8_t *buf)
	162	{
	163	const uint8_t *ptr = buf;
	164	char optarif[5] = { 0 };
	165
	166	while ((ptr = teleinfo_parse_data(NULL, ptr, 292-(ptr-buf), optarif)));
	167	if (!strcmp(optarif, "BASE"))
	168	return OPTARIF_BASE;
	169	else if (!strcmp(optarif, "HC.."))
	170	return OPTARIF_HC;
	171	else if (!strcmp(optarif, "EJP."))
	172	return OPTARIF_EJP;
	173	else if (!strncmp(optarif, "BBR", 3))
	174	return OPTARIF_BBR;
	175	return OPTARIF_NONE;
	176	}
	177
	178	SR_PRIV gboolean teleinfo_packet_valid(const uint8_t *buf)
	179	{
	180	return !!teleinfo_get_optarif(buf);
	181	}
	182
	183	SR_PRIV int teleinfo_receive_data(int fd, int revents, void *cb_data)
	184	{
	185	struct sr_dev_inst *sdi;
	186	struct dev_context *devc;
	187	struct sr_serial_dev_inst *serial;
	188	const uint8_t ptr, next_ptr, *end_ptr;
	189	int len;
	190
	191	(void)fd;
	192
	193	if (!(sdi = cb_data) \|\| !(devc = sdi->priv) \|\| revents != G_IO_IN)
	194	return TRUE;
	195	serial = sdi->conn;
	196
	197	/* Try to get as much data as the buffer can hold. */
	198	len = TELEINFO_BUF_SIZE - devc->buf_len;
	199	len = serial_read_nonblocking(serial, devc->buf + devc->buf_len, len);
	200	if (len < 1) {
	201	sr_err("Serial port read error: %d.", len);
	202	return FALSE;
	203	}
	204	devc->buf_len += len;
	205
	206	/* Now look for packets in that data. */
	207	ptr = devc->buf;
	208	end_ptr = ptr + devc->buf_len;
	209	while ((next_ptr = teleinfo_parse_data(sdi, ptr, end_ptr - ptr, NULL)))
	210	ptr = next_ptr;
	211
	212	/* If we have any data left, move it to the beginning of our buffer. */
	213	memmove(devc->buf, ptr, end_ptr - ptr);
	214	devc->buf_len -= ptr - devc->buf;
	215
	216	/* If buffer is full and no valid packet was found, wipe buffer. */
	217	if (devc->buf_len >= TELEINFO_BUF_SIZE) {
	218	devc->buf_len = 0;
	219	return FALSE;
	220	}
	221
	222	if (sr_sw_limits_check(&devc->sw_limits))
	223	sr_dev_acquisition_stop(sdi);
	224
	225	return TRUE;
	226	}