]> sigrok.org Git - libsigrok.git/blob - src/output/analog.c
analog output: convert binary to digital digits of precision.
[libsigrok.git] / src / output / analog.c
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 <config.h>
21 #include <stdlib.h>
22 #include <string.h>
23 #include <math.h>
24 #include <glib.h>
25 #include <libsigrok/libsigrok.h>
26 #include "libsigrok-internal.h"
27
28 #define LOG_PREFIX "output/analog"
29
30 #define BIN_TO_DEC_DIGITS (log(2) / log(10))
31
32 struct context {
33         int num_enabled_channels;
34         GPtrArray *channellist;
35         int digits;
36         float *fdata;
37 };
38
39 enum {
40         DIGITS_ALL,
41         DIGITS_SPEC,
42 };
43
44 static int init(struct sr_output *o, GHashTable *options)
45 {
46         struct context *ctx;
47         struct sr_channel *ch;
48         GSList *l;
49         const char *s;
50
51         if (!o || !o->sdi)
52                 return SR_ERR_ARG;
53
54         o->priv = ctx = g_malloc0(sizeof(struct context));
55         s = g_variant_get_string(g_hash_table_lookup(options, "digits"), NULL);
56         if (!strcmp(s, "all"))
57                 ctx->digits = DIGITS_ALL;
58         else
59                 ctx->digits = DIGITS_SPEC;
60
61         /* Get the number of channels and their names. */
62         ctx->channellist = g_ptr_array_new();
63         for (l = o->sdi->channels; l; l = l->next) {
64                 ch = l->data;
65                 if (!ch || !ch->enabled)
66                         continue;
67                 g_ptr_array_add(ctx->channellist, ch->name);
68                 ctx->num_enabled_channels++;
69         }
70         ctx->fdata = NULL;
71
72         return SR_OK;
73 }
74
75 static int receive(const struct sr_output *o, const struct sr_datafeed_packet *packet,
76                 GString **out)
77 {
78         struct context *ctx;
79         const struct sr_datafeed_analog *analog;
80         const struct sr_datafeed_meta *meta;
81         const struct sr_config *src;
82         const struct sr_key_info *srci;
83         struct sr_channel *ch;
84         GSList *l;
85         float *fdata;
86         unsigned int i;
87         int num_channels, c, ret, digits, actual_digits;
88         char *number, *suffix;
89
90         *out = NULL;
91         if (!o || !o->sdi)
92                 return SR_ERR_ARG;
93         ctx = o->priv;
94
95         switch (packet->type) {
96         case SR_DF_FRAME_BEGIN:
97                 *out = g_string_new("FRAME-BEGIN\n");
98                 break;
99         case SR_DF_FRAME_END:
100                 *out = g_string_new("FRAME-END\n");
101                 break;
102         case SR_DF_META:
103                 meta = packet->payload;
104                 for (l = meta->config; l; l = l->next) {
105                         src = l->data;
106                         if (!(srci = sr_key_info_get(SR_KEY_CONFIG, src->key)))
107                                 return SR_ERR;
108                         *out = g_string_sized_new(512);
109                         g_string_append(*out, "META ");
110                         g_string_append_printf(*out, "%s: ", srci->id);
111                         if (srci->datatype == SR_T_BOOL) {
112                                 g_string_append_printf(*out, "%u",
113                                         g_variant_get_boolean(src->data));
114                         } else if (srci->datatype == SR_T_FLOAT) {
115                                 g_string_append_printf(*out, "%f",
116                                         g_variant_get_double(src->data));
117                         } else if (srci->datatype == SR_T_UINT64) {
118                                 g_string_append_printf(*out, "%"
119                                         G_GUINT64_FORMAT,
120                                         g_variant_get_uint64(src->data));
121                         }
122                         g_string_append(*out, "\n");
123                 }
124                 break;
125         case SR_DF_ANALOG:
126                 analog = packet->payload;
127                 num_channels = g_slist_length(analog->meaning->channels);
128                 if (!(fdata = g_try_realloc(ctx->fdata,
129                                                 analog->num_samples * num_channels * sizeof(float))))
130                         return SR_ERR_MALLOC;
131                 ctx->fdata = fdata;
132                 if ((ret = sr_analog_to_float(analog, fdata)) != SR_OK)
133                         return ret;
134                 *out = g_string_sized_new(512);
135                 if (ctx->digits == DIGITS_ALL)
136                         digits = analog->encoding->digits;
137                 else
138                         digits = analog->spec->spec_digits;
139                 if (!analog->encoding->is_digits_decimal)
140                         digits = copysign(ceil(abs(digits) * BIN_TO_DEC_DIGITS), digits);
141                 gboolean si_friendly = sr_analog_si_prefix_friendly(analog->meaning->unit);
142                 sr_analog_unit_to_string(analog, &suffix);
143                 for (i = 0; i < analog->num_samples; i++) {
144                         for (l = analog->meaning->channels, c = 0; l; l = l->next, c++) {
145                                 float value = fdata[i * num_channels + c];
146                                 const char *prefix = "";
147                                 actual_digits = digits;
148                                 if (si_friendly)
149                                         prefix = sr_analog_si_prefix(&value, &actual_digits);
150                                 ch = l->data;
151                                 g_string_append_printf(*out, "%s: ", ch->name);
152                                 number = g_strdup_printf("%.*f", MAX(actual_digits, 0), value);
153                                 g_string_append(*out, number);
154                                 g_free(number);
155                                 g_string_append(*out, " ");
156                                 g_string_append(*out, prefix);
157                                 g_string_append(*out, suffix);
158                                 g_string_append(*out, "\n");
159                         }
160                 }
161                 g_free(suffix);
162                 break;
163         }
164
165         return SR_OK;
166 }
167
168 static struct sr_option options[] = {
169         { "digits", "Digits", "Digits to show", NULL, NULL },
170         ALL_ZERO
171 };
172
173 static const struct sr_option *get_options(void)
174 {
175         if (!options[0].def) {
176                 options[0].def = g_variant_ref_sink(g_variant_new_string("all"));
177                 options[0].values = g_slist_append(options[0].values,
178                                 g_variant_ref_sink(g_variant_new_string("all")));
179                 options[0].values = g_slist_append(options[0].values,
180                                 g_variant_ref_sink(g_variant_new_string("spec")));
181         }
182
183         return options;
184 }
185
186 static int cleanup(struct sr_output *o)
187 {
188         struct context *ctx;
189
190         if (!o || !o->sdi)
191                 return SR_ERR_ARG;
192         ctx = o->priv;
193
194         g_ptr_array_free(ctx->channellist, 1);
195         g_variant_unref(options[0].def);
196         g_slist_free_full(options[0].values, (GDestroyNotify)g_variant_unref);
197         g_free(ctx->fdata);
198         g_free(ctx);
199         o->priv = NULL;
200
201         return SR_OK;
202 }
203
204 SR_PRIV struct sr_output_module output_analog = {
205         .id = "analog",
206         .name = "Analog",
207         .desc = "ASCII analog data values and units",
208         .exts = NULL,
209         .flags = 0,
210         .options = get_options,
211         .init = init,
212         .receive = receive,
213         .cleanup = cleanup
214 };