+/**
+ * @file
+ *
+ * Handling and converting analog data.
+ */
+
+/**
+ * @defgroup grp_analog Analog data handling
+ *
+ * Handling and converting analog data.
+ *
+ * @{
+ */
+
+struct unit_mq_string {
+ uint64_t value;
+ const char *str;
+};
+
+/* Please use the same order as in enum sr_unit (libsigrok.h). */
+static struct unit_mq_string unit_strings[] = {
+ { SR_UNIT_VOLT, "V" },
+ { SR_UNIT_AMPERE, "A" },
+ { SR_UNIT_OHM, "\xe2\x84\xa6" },
+ { SR_UNIT_FARAD, "F" },
+ { SR_UNIT_KELVIN, "K" },
+ { SR_UNIT_CELSIUS, "\xc2\xb0""C" },
+ { SR_UNIT_FAHRENHEIT, "\xc2\xb0""F" },
+ { SR_UNIT_HERTZ, "Hz" },
+ { SR_UNIT_PERCENTAGE, "%" },
+ { SR_UNIT_BOOLEAN, "" },
+ { SR_UNIT_SECOND, "s" },
+ { SR_UNIT_SIEMENS, "S" },
+ { SR_UNIT_DECIBEL_MW, "dBm" },
+ { SR_UNIT_DECIBEL_VOLT, "dBV" },
+ { SR_UNIT_UNITLESS, "" },
+ { SR_UNIT_DECIBEL_SPL, "dB" },
+ { SR_UNIT_CONCENTRATION, "ppm" },
+ { SR_UNIT_REVOLUTIONS_PER_MINUTE, "RPM" },
+ { SR_UNIT_VOLT_AMPERE, "VA" },
+ { SR_UNIT_WATT, "W" },
+ { SR_UNIT_WATT_HOUR, "Wh" },
+ { SR_UNIT_METER_SECOND, "m/s" },
+ { SR_UNIT_HECTOPASCAL, "hPa" },
+ { SR_UNIT_HUMIDITY_293K, "%rF" },
+ { SR_UNIT_DEGREE, "\xc2\xb0" },
+ { SR_UNIT_HENRY, "H" },
+ { SR_UNIT_GRAM, "g" },
+ { SR_UNIT_CARAT, "ct" },
+ { SR_UNIT_OUNCE, "oz" },
+ { SR_UNIT_TROY_OUNCE, "oz t" },
+ { SR_UNIT_POUND, "lb" },
+ { SR_UNIT_PENNYWEIGHT, "dwt" },
+ { SR_UNIT_GRAIN, "gr" },
+ { SR_UNIT_TAEL, "tael" },
+ { SR_UNIT_MOMME, "momme" },
+ { SR_UNIT_TOLA, "tola" },
+ { SR_UNIT_PIECE, "pcs" },
+ { SR_UNIT_JOULE, "J" },
+ { SR_UNIT_COULOMB, "C" },
+ { SR_UNIT_AMPERE_HOUR, "Ah" },
+ ALL_ZERO
+};
+
+/* Please use the same order as in enum sr_mqflag (libsigrok.h). */
+static struct unit_mq_string mq_strings[] = {
+ { SR_MQFLAG_AC, " AC" },
+ { SR_MQFLAG_DC, " DC" },
+ { SR_MQFLAG_RMS, " RMS" },
+ { SR_MQFLAG_DIODE, " DIODE" },
+ { SR_MQFLAG_HOLD, " HOLD" },
+ { SR_MQFLAG_MAX, " MAX" },
+ { SR_MQFLAG_MIN, " MIN" },
+ { SR_MQFLAG_AUTORANGE, " AUTO" },
+ { SR_MQFLAG_RELATIVE, " REL" },
+ { SR_MQFLAG_SPL_FREQ_WEIGHT_A, "(A)" },
+ { SR_MQFLAG_SPL_FREQ_WEIGHT_C, "(C)" },
+ { SR_MQFLAG_SPL_FREQ_WEIGHT_Z, "(Z)" },
+ { SR_MQFLAG_SPL_FREQ_WEIGHT_FLAT, "(SPL)" },
+ { SR_MQFLAG_SPL_TIME_WEIGHT_S, " S" },
+ { SR_MQFLAG_SPL_TIME_WEIGHT_F, " F" },
+ { SR_MQFLAG_SPL_LAT, " LAT" },
+ /* Not a standard function for SLMs, so this is a made-up notation. */
+ { SR_MQFLAG_SPL_PCT_OVER_ALARM, "%oA" },
+ { SR_MQFLAG_DURATION, " DURATION" },
+ { SR_MQFLAG_AVG, " AVG" },
+ { SR_MQFLAG_REFERENCE, " REF" },
+ { SR_MQFLAG_UNSTABLE, " UNSTABLE" },
+ { SR_MQFLAG_FOUR_WIRE, " 4-WIRE" },
+ ALL_ZERO
+};
+
+/** @private */
+SR_PRIV int sr_analog_init(struct sr_datafeed_analog *analog,
+ struct sr_analog_encoding *encoding,
+ struct sr_analog_meaning *meaning,
+ struct sr_analog_spec *spec,
+ int digits)
+{
+ memset(analog, 0, sizeof(*analog));
+ memset(encoding, 0, sizeof(*encoding));
+ memset(meaning, 0, sizeof(*meaning));
+ memset(spec, 0, sizeof(*spec));
+
+ analog->encoding = encoding;
+ analog->meaning = meaning;
+ analog->spec = spec;
+
+ encoding->unitsize = sizeof(float);
+ encoding->is_float = TRUE;
+#ifdef WORDS_BIGENDIAN
+ encoding->is_bigendian = TRUE;
+#else
+ encoding->is_bigendian = FALSE;
+#endif
+ encoding->digits = digits;
+ encoding->is_digits_decimal = TRUE;
+ encoding->scale.p = 1;
+ encoding->scale.q = 1;
+ encoding->offset.p = 0;
+ encoding->offset.q = 1;
+
+ spec->spec_digits = digits;
+
+ return SR_OK;
+}
+
+/**
+ * Convert an analog datafeed payload to an array of floats.
+ *
+ * The caller must provide the #outbuf space for the conversion result,
+ * and is expected to free allocated space after use.
+ *
+ * @param[in] analog The analog payload to convert. Must not be NULL.
+ * analog->data, analog->meaning, and analog->encoding
+ * must not be NULL.
+ * @param[out] outbuf Memory where to store the result. Must not be NULL.
+ *
+ * @retval SR_OK Success.
+ * @retval SR_ERR Unsupported encoding.
+ * @retval SR_ERR_ARG Invalid argument.
+ *
+ * @since 0.4.0
+ */
+SR_API int sr_analog_to_float(const struct sr_datafeed_analog *analog,
+ float *outbuf)