+/* Message logging helpers with driver-specific prefix string. */
+#define DRIVER_LOG_DOMAIN "strutil: "
+#define sr_log(l, s, args...) sr_log(l, DRIVER_LOG_DOMAIN s, ## args)
+#define sr_spew(s, args...) sr_spew(DRIVER_LOG_DOMAIN s, ## args)
+#define sr_dbg(s, args...) sr_dbg(DRIVER_LOG_DOMAIN s, ## args)
+#define sr_info(s, args...) sr_info(DRIVER_LOG_DOMAIN s, ## args)
+#define sr_warn(s, args...) sr_warn(DRIVER_LOG_DOMAIN s, ## args)
+#define sr_err(s, args...) sr_err(DRIVER_LOG_DOMAIN s, ## args)
+
+/**
+ * @file
+ *
+ * Helper functions for handling or converting libsigrok-related strings.
+ */
+
+/**
+ * @defgroup grp_strutil String utilities
+ *
+ * Helper functions for handling or converting libsigrok-related strings.
+ *
+ * @{
+ */
+
+/**
+ * Convert a numeric value value to its "natural" string representation.
+ * in SI units
+ *
+ * E.g. a value of 3000000, with units set to "W", would be converted
+ * to "3 MW", 20000 to "20 kW", 31500 would become "31.5 kW".
+ *
+ * @param x The value to convert.
+ * @param unit The unit to append to the string, or NULL if the string
+ * has no units.
+ *
+ * @return A g_try_malloc()ed string representation of the samplerate value,
+ * or NULL upon errors. The caller is responsible to g_free() the
+ * memory.
+ */
+SR_API char *sr_si_string_u64(uint64_t x, const char *unit)
+{
+ if (unit == NULL)
+ unit = "";
+
+ if ((x >= SR_GHZ(1)) && (x % SR_GHZ(1) == 0)) {
+ return g_strdup_printf("%" PRIu64 " G%s", x / SR_GHZ(1), unit);
+ } else if ((x >= SR_GHZ(1)) && (x % SR_GHZ(1) != 0)) {
+ return g_strdup_printf("%" PRIu64 ".%" PRIu64 " G%s",
+ x / SR_GHZ(1), x % SR_GHZ(1), unit);
+ } else if ((x >= SR_MHZ(1)) && (x % SR_MHZ(1) == 0)) {
+ return g_strdup_printf("%" PRIu64 " M%s",
+ x / SR_MHZ(1), unit);
+ } else if ((x >= SR_MHZ(1)) && (x % SR_MHZ(1) != 0)) {
+ return g_strdup_printf("%" PRIu64 ".%" PRIu64 " M%s",
+ x / SR_MHZ(1), x % SR_MHZ(1), unit);
+ } else if ((x >= SR_KHZ(1)) && (x % SR_KHZ(1) == 0)) {
+ return g_strdup_printf("%" PRIu64 " k%s",
+ x / SR_KHZ(1), unit);
+ } else if ((x >= SR_KHZ(1)) && (x % SR_KHZ(1) != 0)) {
+ return g_strdup_printf("%" PRIu64 ".%" PRIu64 " k%s",
+ x / SR_KHZ(1), x % SR_KHZ(1), unit);
+ } else {
+ return g_strdup_printf("%" PRIu64 " %s", x, unit);
+ }
+
+ sr_err("%s: Error creating SI units string.", __func__);
+ return NULL;
+}
+