X-Git-Url: https://sigrok.org/gitweb/?a=blobdiff_plain;f=src%2Fbackend.c;h=82ad42f7ee6b7b2e442a78a7af93c06433dd4c3f;hb=dedaeacad0ef889506b79a8bed634140da28aa72;hp=49ea9cd52088708e3a02a014f4bdb6fdc98953a6;hpb=187cfc604e51ee534fef8dc33278caa8eb1ff66d;p=libsigrok.git

diff --git a/src/backend.c b/src/backend.c
index 49ea9cd5..82ad42f7 100644
--- a/src/backend.c
+++ b/src/backend.c
@@ -18,10 +18,14 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+#include <config.h>
 #include <glib.h>
-#include "config.h" /* Needed for HAVE_LIBUSB_1_0 and others. */
-#include "libsigrok.h"
+#ifdef _WIN32
+#include <winsock2.h>
+#endif
+#include <libsigrok/libsigrok.h>
 #include "libsigrok-internal.h"
+#include "minilzo/minilzo.h"
 
 /** @cond PRIVATE */
 #define LOG_PREFIX "backend"
@@ -60,8 +64,8 @@
  * @section sec_irc IRC
  *
  * You can find the sigrok developers in the
- * <a href="irc://chat.freenode.net/sigrok">\#sigrok</a>
- * IRC channel on Freenode.
+ * <a href="ircs://irc.libera.chat/#sigrok">\#sigrok</a>
+ * IRC channel on Libera.Chat.
  *
  * @section sec_website Website
  *
@@ -79,10 +83,10 @@
  *
  * Initializing and shutting down libsigrok.
  *
- * Before using any of the libsigrok functionality (except
- * sr_log_loglevel_set() and sr_log_opts_set()), sr_init() must
- * be called to initialize the library, which will return a struct sr_context
- * when the initialization was successful.
+ * Before using any of the libsigrok functionality (except for
+ * sr_log_loglevel_set()), sr_init() must be called to initialize the
+ * library, which will return a struct sr_context when the initialization
+ * was successful.
  *
  * When libsigrok functionality is no longer needed, sr_exit() should be
  * called, which will (among other things) free the struct sr_context.
@@ -119,21 +123,194 @@
  * @{
  */
 
+SR_API GSList *sr_buildinfo_libs_get(void)
+{
+	GSList *l = NULL, *m = NULL;
+#if defined(HAVE_LIBUSB_1_0) && !defined(__FreeBSD__)
+	const struct libusb_version *lv;
+#endif
+
+	m = g_slist_append(NULL, g_strdup("glib"));
+	m = g_slist_append(m, g_strdup_printf("%d.%d.%d (rt: %d.%d.%d/%d:%d)",
+		GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION, GLIB_MICRO_VERSION,
+		glib_major_version, glib_minor_version, glib_micro_version,
+		glib_binary_age, glib_interface_age));
+	l = g_slist_append(l, m);
+
+	m = g_slist_append(NULL, g_strdup("zlib"));
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_ZLIB_VERSION));
+	l = g_slist_append(l, m);
+
+	m = g_slist_append(NULL, g_strdup("libzip"));
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_LIBZIP_VERSION));
+	l = g_slist_append(l, m);
+
+	m = g_slist_append(NULL, g_strdup("minilzo"));
+	m = g_slist_append(m, g_strdup_printf("%s", lzo_version_string()));
+	l = g_slist_append(l, m);
+
+#ifdef HAVE_LIBSERIALPORT
+	m = g_slist_append(NULL, g_strdup("libserialport"));
+	m = g_slist_append(m, g_strdup_printf("%s/%s (rt: %s/%s)",
+		SP_PACKAGE_VERSION_STRING, SP_LIB_VERSION_STRING,
+		sp_get_package_version_string(), sp_get_lib_version_string()));
+	l = g_slist_append(l, m);
+#endif
+#ifdef HAVE_LIBUSB_1_0
+	m = g_slist_append(NULL, g_strdup("libusb-1.0"));
+#ifdef __FreeBSD__
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_LIBUSB_1_0_VERSION));
+#else
+	lv = libusb_get_version();
+	m = g_slist_append(m, g_strdup_printf("%d.%d.%d.%d%s API 0x%08x",
+		lv->major, lv->minor, lv->micro, lv->nano, lv->rc,
+#if defined(LIBUSB_API_VERSION)
+		LIBUSB_API_VERSION
+#elif defined(LIBUSBX_API_VERSION)
+		LIBUSBX_API_VERSION
+#endif
+		));
+#endif
+	l = g_slist_append(l, m);
+#endif
+#ifdef HAVE_LIBHIDAPI
+	m = g_slist_append(NULL, g_strdup("hidapi"));
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_LIBHIDAPI_VERSION));
+	l = g_slist_append(l, m);
+#endif
+#ifdef HAVE_LIBBLUEZ
+	m = g_slist_append(NULL, g_strdup("bluez"));
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_LIBBLUEZ_VERSION));
+	l = g_slist_append(l, m);
+#endif
+#ifdef HAVE_LIBFTDI
+	m = g_slist_append(NULL, g_strdup("libftdi"));
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_LIBFTDI_VERSION));
+	l = g_slist_append(l, m);
+#endif
+#ifdef HAVE_LIBGPIB
+	m = g_slist_append(NULL, g_strdup("libgpib"));
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_LIBGPIB_VERSION));
+	l = g_slist_append(l, m);
+#endif
+#ifdef HAVE_LIBREVISA
+	m = g_slist_append(NULL, g_strdup("librevisa"));
+	m = g_slist_append(m, g_strdup_printf("%s", CONF_LIBREVISA_VERSION));
+	l = g_slist_append(l, m);
+#endif
+
+	return l;
+}
+
+SR_API char *sr_buildinfo_host_get(void)
+{
+	return g_strdup_printf("%s, %s-endian", CONF_HOST,
+#ifdef WORDS_BIGENDIAN
+	"big"
+#else
+	"little"
+#endif
+	);
+}
+
+SR_API char *sr_buildinfo_scpi_backends_get(void)
+{
+	GString *s;
+	char *str;
+
+	s = g_string_sized_new(200);
+
+	g_string_append_printf(s, "TCP, ");
+#if HAVE_RPC
+	g_string_append_printf(s, "RPC, ");
+#endif
+#ifdef HAVE_SERIAL_COMM
+	g_string_append_printf(s, "serial, ");
+#endif
+#ifdef HAVE_LIBREVISA
+	g_string_append_printf(s, "VISA, ");
+#endif
+#ifdef HAVE_LIBGPIB
+	g_string_append_printf(s, "GPIB, ");
+#endif
+#ifdef HAVE_LIBUSB_1_0
+	g_string_append_printf(s, "USBTMC, ");
+#endif
+	s->str[s->len - 2] = '\0';
+
+	str = g_strdup(s->str);
+	g_string_free(s, TRUE);
+
+	return str;
+}
+
+static void print_versions(void)
+{
+	GString *s;
+	GSList *l, *l_orig, *m;
+	char *str;
+	const char *lib, *version;
+
+	sr_dbg("libsigrok %s/%s.",
+		sr_package_version_string_get(), sr_lib_version_string_get());
+
+	s = g_string_sized_new(200);
+	g_string_append(s, "Libs: ");
+	l_orig = sr_buildinfo_libs_get();
+	for (l = l_orig; l; l = l->next) {
+		m = l->data;
+		lib = m->data;
+		version = m->next->data;
+		g_string_append_printf(s, "%s %s, ", lib, version);
+		g_slist_free_full(m, g_free);
+	}
+	g_slist_free(l_orig);
+	s->str[s->len - 2] = '.';
+	s->str[s->len - 1] = '\0';
+	sr_dbg("%s", s->str);
+	g_string_free(s, TRUE);
+
+	str = sr_buildinfo_host_get();
+	sr_dbg("Host: %s.", str);
+	g_free(str);
+
+	str = sr_buildinfo_scpi_backends_get();
+	sr_dbg("SCPI backends: %s.", str);
+	g_free(str);
+}
+
+static void print_resourcepaths(void)
+{
+	GSList *l, *l_orig;
+
+	sr_dbg("Firmware search paths:");
+	l_orig = sr_resourcepaths_get(SR_RESOURCE_FIRMWARE);
+	for (l = l_orig; l; l = l->next)
+		sr_dbg(" - %s", (const char *)l->data);
+	g_slist_free_full(l_orig, g_free);
+}
+
 /**
  * Sanity-check all libsigrok drivers.
  *
+ * @param[in] ctx Pointer to a libsigrok context struct. Must not be NULL.
+ *
  * @retval SR_OK All drivers are OK
  * @retval SR_ERR One or more drivers have issues.
+ * @retval SR_ERR_ARG Invalid argument.
  */
-static int sanity_check_all_drivers(void)
+static int sanity_check_all_drivers(const struct sr_context *ctx)
 {
 	int i, errors, ret = SR_OK;
 	struct sr_dev_driver **drivers;
 	const char *d;
 
+	if (!ctx)
+		return SR_ERR_ARG;
+
 	sr_spew("Sanity-checking all drivers.");
 
-	drivers = sr_driver_list();
+	drivers = sr_driver_list(ctx);
 	for (i = 0; drivers[i]; i++) {
 		errors = 0;
 
@@ -167,11 +344,17 @@ static int sanity_check_all_drivers(void)
 			sr_err("No dev_list in driver %d ('%s').", i, d);
 			errors++;
 		}
+		if (!drivers[i]->dev_clear) {
+			sr_err("No dev_clear in driver %d ('%s').", i, d);
+			errors++;
+		}
 		/* Note: config_get() is optional. */
 		if (!drivers[i]->config_set) {
 			sr_err("No config_set in driver %d ('%s').", i, d);
 			errors++;
 		}
+		/* Note: config_channel_set() is optional. */
+		/* Note: config_commit() is optional. */
 		if (!drivers[i]->config_list) {
 			sr_err("No config_list in driver %d ('%s').", i, d);
 			errors++;
@@ -375,34 +558,58 @@ SR_API int sr_init(struct sr_context **ctx)
 {
 	int ret = SR_ERR;
 	struct sr_context *context;
+#ifdef _WIN32
+	WSADATA wsadata;
+#endif
+
+	print_versions();
+
+	print_resourcepaths();
 
 	if (!ctx) {
 		sr_err("%s(): libsigrok context was NULL.", __func__);
 		return SR_ERR;
 	}
 
-	if (sanity_check_all_drivers() < 0) {
+	context = g_malloc0(sizeof(struct sr_context));
+
+	sr_drivers_init(context);
+
+	if (sanity_check_all_drivers(context) < 0) {
 		sr_err("Internal driver error(s), aborting.");
-		return ret;
+		goto done;
 	}
 
 	if (sanity_check_all_input_modules() < 0) {
 		sr_err("Internal input module error(s), aborting.");
-		return ret;
+		goto done;
 	}
 
 	if (sanity_check_all_output_modules() < 0) {
 		sr_err("Internal output module error(s), aborting.");
-		return ret;
+		goto done;
 	}
 
 	if (sanity_check_all_transform_modules() < 0) {
 		sr_err("Internal transform module error(s), aborting.");
-		return ret;
+		goto done;
 	}
 
-	/* + 1 to handle when struct sr_context has no members. */
-	context = g_malloc0(sizeof(struct sr_context) + 1);
+#ifdef _WIN32
+	if ((ret = WSAStartup(MAKEWORD(2, 2), &wsadata)) != 0) {
+		sr_err("WSAStartup failed with error code %d.", ret);
+		ret = SR_ERR;
+		goto done;
+	}
+#endif
+
+	if ((ret = lzo_init()) != LZO_E_OK) {
+		sr_err("lzo_init() failed with return code %d.", ret);
+		sr_err("This usually indicates a compiler bug. Recompile without");
+		sr_err("optimizations, and enable '-DLZO_DEBUG' for diagnostics.");
+		ret = SR_ERR;
+		goto done;
+	}
 
 #ifdef HAVE_LIBUSB_1_0
 	ret = libusb_init(&context->libusb_ctx);
@@ -412,14 +619,28 @@ SR_API int sr_init(struct sr_context **ctx)
 		goto done;
 	}
 #endif
+#ifdef HAVE_LIBHIDAPI
+	/*
+	 * According to <hidapi.h>, the hid_init() routine just returns
+	 * zero or non-zero, and hid_error() appears to relate to calls
+	 * for a specific device after hid_open(). Which means that there
+	 * is no more detailled information available beyond success/fail
+	 * at this point in time.
+	 */
+	if (hid_init() != 0) {
+		sr_err("HIDAPI hid_init() failed.");
+		ret = SR_ERR;
+		goto done;
+	}
+#endif
+	sr_resource_set_hooks(context, NULL, NULL, NULL, NULL);
 
 	*ctx = context;
 	context = NULL;
 	ret = SR_OK;
 
 done:
-	if (context)
-		g_free(context);
+	g_free(context);
 	return ret;
 }
 
@@ -440,12 +661,20 @@ SR_API int sr_exit(struct sr_context *ctx)
 		return SR_ERR;
 	}
 
-	sr_hw_cleanup_all();
+	sr_hw_cleanup_all(ctx);
+
+#ifdef _WIN32
+	WSACleanup();
+#endif
 
+#ifdef HAVE_LIBHIDAPI
+	hid_exit();
+#endif
 #ifdef HAVE_LIBUSB_1_0
 	libusb_exit(ctx->libusb_ctx);
 #endif
 
+	g_free(sr_driver_list(ctx));
 	g_free(ctx);
 
 	return SR_OK;