[libsigrok.git] / src / output / analog.c

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

#define LOG_PREFIX "output/analog"

struct context {
	int num_enabled_channels;
	GPtrArray *channellist;
};

static int init(struct sr_output *o, GHashTable *options)
{
	struct context *ctx;
	struct sr_channel *ch;
	GSList *l;

	(void)options;

	if (!o || !o->sdi)
		return SR_ERR_ARG;

	if (!(ctx = g_try_malloc0(sizeof(struct context)))) {
		sr_err("Output module context malloc failed.");
		return SR_ERR_MALLOC;
	}
	o->priv = ctx;

	/* Get the number of channels and their names. */
	ctx->channellist = g_ptr_array_new();
	for (l = o->sdi->channels; l; l = l->next) {
		ch = l->data;
		if (!ch || !ch->enabled)
			continue;
		g_ptr_array_add(ctx->channellist, ch->name);
		ctx->num_enabled_channels++;
	}

	return SR_OK;
}

static void si_printf(float value, GString *out, char *unitstr)
{
	float v;

	if (signbit(value))
		v = -(value);
	else
		v = value;

	if (v < 1e-12 || v > 1e+12)
		g_string_append_printf(out, "%f %s", value, unitstr);
	else if (v > 1e+9)
		g_string_append_printf(out, "%f G%s", value / 1e+9, unitstr);
	else if (v > 1e+6)
		g_string_append_printf(out, "%f M%s", value / 1e+6, unitstr);
	else if (v > 1e+3)
		g_string_append_printf(out, "%f k%s", value / 1e+3, unitstr);
	else if (v < 1e-9)
		g_string_append_printf(out, "%f n%s", value * 1e+9, unitstr);
	else if (v < 1e-6)
		g_string_append_printf(out, "%f u%s", value * 1e+6, unitstr);
	else if (v < 1e-3)
		g_string_append_printf(out, "%f m%s", value * 1e+3, unitstr);
	else
		g_string_append_printf(out, "%f %s", value, unitstr);

}

static void fancyprint(int unit, int mqflags, float value, GString *out)
{
	switch (unit) {
	case SR_UNIT_VOLT:
		si_printf(value, out, "V");
		break;
	case SR_UNIT_AMPERE:
		si_printf(value, out, "A");
		break;
	case SR_UNIT_OHM:
		si_printf(value, out, "");
		g_string_append_unichar(out, 0x2126);
		break;
	case SR_UNIT_FARAD:
		si_printf(value, out, "F");
		break;
	case SR_UNIT_HENRY:
		si_printf(value, out, "H");
		break;
	case SR_UNIT_KELVIN:
		si_printf(value, out, "K");
		break;
	case SR_UNIT_CELSIUS:
		si_printf(value, out, "");
		g_string_append_unichar(out, 0x00b0);
		g_string_append_c(out, 'C');
		break;
	case SR_UNIT_FAHRENHEIT:
		si_printf(value, out, "");
		g_string_append_unichar(out, 0x00b0);
		g_string_append_c(out, 'F');
		break;
	case SR_UNIT_HERTZ:
		si_printf(value, out, "Hz");
		break;
	case SR_UNIT_PERCENTAGE:
		g_string_append_printf(out, "%f %%", value);
		break;
	case SR_UNIT_BOOLEAN:
		if (value > 0)
			g_string_append_printf(out, "TRUE");
		else
			g_string_append_printf(out, "FALSE");
		break;
	case SR_UNIT_SECOND:
		si_printf(value, out, "s");
		break;
	case SR_UNIT_SIEMENS:
		si_printf(value, out, "S");
		break;
	case SR_UNIT_DECIBEL_MW:
		si_printf(value, out, "dBu");
		break;
	case SR_UNIT_DECIBEL_VOLT:
		si_printf(value, out, "dBV");
		break;
	case SR_UNIT_DECIBEL_SPL:
		if (mqflags & SR_MQFLAG_SPL_FREQ_WEIGHT_A)
			si_printf(value, out, "dB(A)");
		else if (mqflags & SR_MQFLAG_SPL_FREQ_WEIGHT_C)
			si_printf(value, out, "dB(C)");
		else if (mqflags & SR_MQFLAG_SPL_FREQ_WEIGHT_Z)
			si_printf(value, out, "dB(Z)");
		else
			/* No frequency weighting, or non-standard "flat" */
			si_printf(value, out, "dB(SPL)");
		if (mqflags & SR_MQFLAG_SPL_TIME_WEIGHT_S)
			g_string_append(out, " S");
		else if (mqflags & SR_MQFLAG_SPL_TIME_WEIGHT_F)
			g_string_append(out, " F");
		if (mqflags & SR_MQFLAG_SPL_LAT)
			g_string_append(out, " LAT");
		else if (mqflags & SR_MQFLAG_SPL_PCT_OVER_ALARM)
			/* Not a standard function for SLMs, so this is
			 * a made-up notation. */
			g_string_append(out, " %oA");
		break;
	case SR_UNIT_CONCENTRATION:
		g_string_append_printf(out, "%f ppm", value * 1000000);
		break;
	case SR_UNIT_REVOLUTIONS_PER_MINUTE:
		si_printf(value, out, "RPM");
		break;
	case SR_UNIT_VOLT_AMPERE:
		si_printf(value, out, "VA");
		break;
	case SR_UNIT_WATT:
		si_printf(value, out, "W");
		break;
	case SR_UNIT_WATT_HOUR:
		si_printf(value, out, "Wh");
		break;
	case SR_UNIT_METER_SECOND:
		si_printf(value, out, "m/s");
		break;
	case SR_UNIT_HECTOPASCAL:
		si_printf(value, out, "hPa");
		break;
	case SR_UNIT_HUMIDITY_293K:
		si_printf(value, out, "%rF");
		break;
	case SR_UNIT_DEGREE:
		si_printf(value, out, "");
		g_string_append_unichar(out, 0x00b0);
		break;
	default:
		si_printf(value, out, "");
		break;
	}

	if (mqflags & SR_MQFLAG_AC)
		g_string_append_printf(out, " AC");
	if (mqflags & SR_MQFLAG_DC)
		g_string_append_printf(out, " DC");
	if (mqflags & SR_MQFLAG_RMS)
		g_string_append_printf(out, " RMS");
	if (mqflags & SR_MQFLAG_DIODE)
		g_string_append_printf(out, " DIODE");
	if (mqflags & SR_MQFLAG_HOLD)
		g_string_append_printf(out, " HOLD");
	if (mqflags & SR_MQFLAG_MAX)
		g_string_append_printf(out, " MAX");
	if (mqflags & SR_MQFLAG_MIN)
		g_string_append_printf(out, " MIN");
	if (mqflags & SR_MQFLAG_AUTORANGE)
		g_string_append_printf(out, " AUTO");
	if (mqflags & SR_MQFLAG_RELATIVE)
		g_string_append_printf(out, " REL");
	if (mqflags & SR_MQFLAG_AVG)
		g_string_append_printf(out, " AVG");
	if (mqflags & SR_MQFLAG_REFERENCE)
		g_string_append_printf(out, " REF");
	g_string_append_c(out, '\n');
}

static int receive(const struct sr_output *o, const struct sr_datafeed_packet *packet,
		GString **out)
{
	const struct sr_datafeed_analog *analog;
	struct sr_channel *ch;
	GSList *l;
	const float *fdata;
	int num_channels, i, c;

	*out = NULL;
	if (!o || !o->sdi)
		return SR_ERR_ARG;

	switch (packet->type) {
	case SR_DF_FRAME_BEGIN:
		*out = g_string_new("FRAME-BEGIN\n");
		break;
	case SR_DF_FRAME_END:
		*out = g_string_new("FRAME-END\n");
		break;
	case SR_DF_ANALOG:
		analog = packet->payload;
		fdata = (const float *)analog->data;
		*out = g_string_sized_new(512);
		num_channels = g_slist_length(analog->channels);
		for (i = 0; i < analog->num_samples; i++) {
			for (l = analog->channels, c = 0; l; l = l->next, c++) {
				ch = l->data;
				g_string_append_printf(*out, "%s: ", ch->name);
				fancyprint(analog->unit, analog->mqflags,
						fdata[i * num_channels + c], *out);
			}
		}
		break;
	}

	return SR_OK;
}

static int cleanup(struct sr_output *o)
{
	struct context *ctx;

	if (!o || !o->sdi)
		return SR_ERR_ARG;
	ctx = o->priv;

	g_ptr_array_free(ctx->channellist, 1);
	g_free(ctx);
	o->priv = NULL;

	return SR_OK;
}

SR_PRIV struct sr_output_module output_analog = {
	.id = "analog",
	.name = "Analog",
	.desc = "Analog data and types",
	.options = NULL,
	.init = init,
	.receive = receive,
	.cleanup = cleanup
};
Commit	Line	Data
	1	/*
	2	* This file is part of the libsigrok project.
	3	*
	4	* Copyright (C) 2012 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
	20	#include <stdlib.h>
	21	#include <string.h>
	22	#include <math.h>
	23	#include <glib.h>
	24	#include "libsigrok.h"
	25	#include "libsigrok-internal.h"
	26
	27	#define LOG_PREFIX "output/analog"
	28
	29	struct context {
	30	int num_enabled_channels;
	31	GPtrArray *channellist;
	32	};
	33
	34	static int init(struct sr_output o, GHashTable options)
	35	{
	36	struct context *ctx;
	37	struct sr_channel *ch;
	38	GSList *l;
	39
	40	(void)options;
	41
	42	if (!o \|\| !o->sdi)
	43	return SR_ERR_ARG;
	44
	45	if (!(ctx = g_try_malloc0(sizeof(struct context)))) {
	46	sr_err("Output module context malloc failed.");
	47	return SR_ERR_MALLOC;
	48	}
	49	o->priv = ctx;
	50
	51	/* Get the number of channels and their names. */
	52	ctx->channellist = g_ptr_array_new();
	53	for (l = o->sdi->channels; l; l = l->next) {
	54	ch = l->data;
	55	if (!ch \|\| !ch->enabled)
	56	continue;
	57	g_ptr_array_add(ctx->channellist, ch->name);
	58	ctx->num_enabled_channels++;
	59	}
	60
	61	return SR_OK;
	62	}
	63
	64	static void si_printf(float value, GString out, char unitstr)
	65	{
	66	float v;
	67
	68	if (signbit(value))
	69	v = -(value);
	70	else
	71	v = value;
	72
	73	if (v < 1e-12 \|\| v > 1e+12)
	74	g_string_append_printf(out, "%f %s", value, unitstr);
	75	else if (v > 1e+9)
	76	g_string_append_printf(out, "%f G%s", value / 1e+9, unitstr);
	77	else if (v > 1e+6)
	78	g_string_append_printf(out, "%f M%s", value / 1e+6, unitstr);
	79	else if (v > 1e+3)
	80	g_string_append_printf(out, "%f k%s", value / 1e+3, unitstr);
	81	else if (v < 1e-9)
	82	g_string_append_printf(out, "%f n%s", value * 1e+9, unitstr);
	83	else if (v < 1e-6)
	84	g_string_append_printf(out, "%f u%s", value * 1e+6, unitstr);
	85	else if (v < 1e-3)
	86	g_string_append_printf(out, "%f m%s", value * 1e+3, unitstr);
	87	else
	88	g_string_append_printf(out, "%f %s", value, unitstr);
	89
	90	}
	91
	92	static void fancyprint(int unit, int mqflags, float value, GString *out)
	93	{
	94	switch (unit) {
	95	case SR_UNIT_VOLT:
	96	si_printf(value, out, "V");
	97	break;
	98	case SR_UNIT_AMPERE:
	99	si_printf(value, out, "A");
	100	break;
	101	case SR_UNIT_OHM:
	102	si_printf(value, out, "");
	103	g_string_append_unichar(out, 0x2126);
	104	break;
	105	case SR_UNIT_FARAD:
	106	si_printf(value, out, "F");
	107	break;
	108	case SR_UNIT_HENRY:
	109	si_printf(value, out, "H");
	110	break;
	111	case SR_UNIT_KELVIN:
	112	si_printf(value, out, "K");
	113	break;
	114	case SR_UNIT_CELSIUS:
	115	si_printf(value, out, "");
	116	g_string_append_unichar(out, 0x00b0);
	117	g_string_append_c(out, 'C');
	118	break;
	119	case SR_UNIT_FAHRENHEIT:
	120	si_printf(value, out, "");
	121	g_string_append_unichar(out, 0x00b0);
	122	g_string_append_c(out, 'F');
	123	break;
	124	case SR_UNIT_HERTZ:
	125	si_printf(value, out, "Hz");
	126	break;
	127	case SR_UNIT_PERCENTAGE:
	128	g_string_append_printf(out, "%f %%", value);
	129	break;
	130	case SR_UNIT_BOOLEAN:
	131	if (value > 0)
	132	g_string_append_printf(out, "TRUE");
	133	else
	134	g_string_append_printf(out, "FALSE");
	135	break;
	136	case SR_UNIT_SECOND:
	137	si_printf(value, out, "s");
	138	break;
	139	case SR_UNIT_SIEMENS:
	140	si_printf(value, out, "S");
	141	break;
	142	case SR_UNIT_DECIBEL_MW:
	143	si_printf(value, out, "dBu");
	144	break;
	145	case SR_UNIT_DECIBEL_VOLT:
	146	si_printf(value, out, "dBV");
	147	break;
	148	case SR_UNIT_DECIBEL_SPL:
	149	if (mqflags & SR_MQFLAG_SPL_FREQ_WEIGHT_A)
	150	si_printf(value, out, "dB(A)");
	151	else if (mqflags & SR_MQFLAG_SPL_FREQ_WEIGHT_C)
	152	si_printf(value, out, "dB(C)");
	153	else if (mqflags & SR_MQFLAG_SPL_FREQ_WEIGHT_Z)
	154	si_printf(value, out, "dB(Z)");
	155	else
	156	/* No frequency weighting, or non-standard "flat" */
	157	si_printf(value, out, "dB(SPL)");
	158	if (mqflags & SR_MQFLAG_SPL_TIME_WEIGHT_S)
	159	g_string_append(out, " S");
	160	else if (mqflags & SR_MQFLAG_SPL_TIME_WEIGHT_F)
	161	g_string_append(out, " F");
	162	if (mqflags & SR_MQFLAG_SPL_LAT)
	163	g_string_append(out, " LAT");
	164	else if (mqflags & SR_MQFLAG_SPL_PCT_OVER_ALARM)
	165	/* Not a standard function for SLMs, so this is
	166	* a made-up notation. */
	167	g_string_append(out, " %oA");
	168	break;
	169	case SR_UNIT_CONCENTRATION:
	170	g_string_append_printf(out, "%f ppm", value * 1000000);
	171	break;
	172	case SR_UNIT_REVOLUTIONS_PER_MINUTE:
	173	si_printf(value, out, "RPM");
	174	break;
	175	case SR_UNIT_VOLT_AMPERE:
	176	si_printf(value, out, "VA");
	177	break;
	178	case SR_UNIT_WATT:
	179	si_printf(value, out, "W");
	180	break;
	181	case SR_UNIT_WATT_HOUR:
	182	si_printf(value, out, "Wh");
	183	break;
	184	case SR_UNIT_METER_SECOND:
	185	si_printf(value, out, "m/s");
	186	break;
	187	case SR_UNIT_HECTOPASCAL:
	188	si_printf(value, out, "hPa");
	189	break;
	190	case SR_UNIT_HUMIDITY_293K:
	191	si_printf(value, out, "%rF");
	192	break;
	193	case SR_UNIT_DEGREE:
	194	si_printf(value, out, "");
	195	g_string_append_unichar(out, 0x00b0);
	196	break;
	197	default:
	198	si_printf(value, out, "");
	199	break;
	200	}
	201
	202	if (mqflags & SR_MQFLAG_AC)
	203	g_string_append_printf(out, " AC");
	204	if (mqflags & SR_MQFLAG_DC)
	205	g_string_append_printf(out, " DC");
	206	if (mqflags & SR_MQFLAG_RMS)
	207	g_string_append_printf(out, " RMS");
	208	if (mqflags & SR_MQFLAG_DIODE)
	209	g_string_append_printf(out, " DIODE");
	210	if (mqflags & SR_MQFLAG_HOLD)
	211	g_string_append_printf(out, " HOLD");
	212	if (mqflags & SR_MQFLAG_MAX)
	213	g_string_append_printf(out, " MAX");
	214	if (mqflags & SR_MQFLAG_MIN)
	215	g_string_append_printf(out, " MIN");
	216	if (mqflags & SR_MQFLAG_AUTORANGE)
	217	g_string_append_printf(out, " AUTO");
	218	if (mqflags & SR_MQFLAG_RELATIVE)
	219	g_string_append_printf(out, " REL");
	220	if (mqflags & SR_MQFLAG_AVG)
	221	g_string_append_printf(out, " AVG");
	222	if (mqflags & SR_MQFLAG_REFERENCE)
	223	g_string_append_printf(out, " REF");
	224	g_string_append_c(out, '\n');
	225	}
	226
	227	static int receive(const struct sr_output o, const struct sr_datafeed_packet packet,
	228	GString **out)
	229	{
	230	const struct sr_datafeed_analog *analog;
	231	struct sr_channel *ch;
	232	GSList *l;
	233	const float *fdata;
	234	int num_channels, i, c;
	235
	236	*out = NULL;
	237	if (!o \|\| !o->sdi)
	238	return SR_ERR_ARG;
	239
	240	switch (packet->type) {
	241	case SR_DF_FRAME_BEGIN:
	242	*out = g_string_new("FRAME-BEGIN\n");
	243	break;
	244	case SR_DF_FRAME_END:
	245	*out = g_string_new("FRAME-END\n");
	246	break;
	247	case SR_DF_ANALOG:
	248	analog = packet->payload;
	249	fdata = (const float *)analog->data;
	250	*out = g_string_sized_new(512);
	251	num_channels = g_slist_length(analog->channels);
	252	for (i = 0; i < analog->num_samples; i++) {
	253	for (l = analog->channels, c = 0; l; l = l->next, c++) {
	254	ch = l->data;
	255	g_string_append_printf(*out, "%s: ", ch->name);
	256	fancyprint(analog->unit, analog->mqflags,
	257	fdata[i * num_channels + c], *out);
	258	}
	259	}
	260	break;
	261	}
	262
	263	return SR_OK;
	264	}
	265
	266	static int cleanup(struct sr_output *o)
	267	{
	268	struct context *ctx;
	269
	270	if (!o \|\| !o->sdi)
	271	return SR_ERR_ARG;
	272	ctx = o->priv;
	273
	274	g_ptr_array_free(ctx->channellist, 1);
	275	g_free(ctx);
	276	o->priv = NULL;
	277
	278	return SR_OK;
	279	}
	280
	281	SR_PRIV struct sr_output_module output_analog = {
	282	.id = "analog",
	283	.name = "Analog",
	284	.desc = "Analog data and types",
	285	.options = NULL,
	286	.init = init,
	287	.receive = receive,
	288	.cleanup = cleanup
	289	};