Rename: Sense API => Stim Buff API

smocore/include/stimBuffApis/stimBuffApiLib.h

@@ -0,0 +1,90 @@
+#ifndef SENSE_API_PROVIDER_DESC_H
+#define SENSE_API_PROVIDER_DESC_H
+
+#include <string>
+#include <memory>
+#include <atomic>
+#include <vector>
+#include <dlfcn.h>
+#include <functional>
+#include <user/senseApiDesc.h>
+#include <qutex.h>
+
+namespace smo {
+namespace stim_buff {
+
+class StimBuffApiLib
+{
+private:
+	friend class StimBuffApiManager;
+	struct DlCloser
+	{
+		void operator()(void* handle) const
+		{
+			if (handle) {
+				dlclose(handle);
+			}
+		}
+	};
+
+public:
+	StimBuffApiLib(
+		const std::string& path, void *_dlopen_handle,
+		SMO_GET_STIM_BUFF_API_DESC_FN_TYPEDEF *descFn)
+	: libraryPath(path), qutex("StimBuffApiLib-" + path),
+	isBeingDestroyed(false),
+	dlopen_handle(_dlopen_handle, DlCloser()),
+	SMO_GET_STIM_BUFF_API_DESC_FN_NAME(descFn)
+	{}
+
+	void setStimBuffApiDesc(const StimBuffApiDesc &desc)
+	{
+		if (!StimBuffApiDesc::sanityCheck(desc))
+		{
+			throw std::runtime_error(
+				std::string(__func__) + ": Sanity check failed for stim buff API "
+				"descriptor in library '" + libraryPath + "'");
+		}
+
+		stimBuffApiDesc = desc;
+	}
+
+public:
+	std::string libraryPath;
+	Qutex qutex;
+	std::atomic<bool> isBeingDestroyed;
+	std::unique_ptr<void, DlCloser> dlopen_handle;
+	/* UNIMPLEMENTED: API-specific cmdline options. These affect this specific
+	 * stim buff api lib's behaviour globally.
+	 */
+	std::vector<std::string> options;
+
+	/**
+	 * @brief Each stim buff API library must provide a function returning a
+	 * StimBuffApiDesc. This struct specifies which API the library uses to
+	 * connect Salmanoff to its supported stim buff provider.
+	 *
+	 * This getter function should be visible to dlsym() so that Salmanoff can
+	 * find it in the lib after loading it, and call it.
+	 */
+	std::function<SMO_GET_STIM_BUFF_API_DESC_FN_TYPEDEF>
+		SMO_GET_STIM_BUFF_API_DESC_FN_NAME;
+
+	/**
+	 * @brief Salmanoff will call the `SMO_GET_STIM_BUFF_API_DESC_FN_NAME` getter
+	 * function and use the data it provides in order to fill out this
+	 * descriptor.
+	 */
+	StimBuffApiDesc stimBuffApiDesc;
+
+	std::string stringify() const {
+		std::string result = "Library Path: " + libraryPath + "\n";
+		result += "Stim Buff API Descriptor: " + stimBuffApiDesc.stringify() + "\n";
+		return result;
+	}
+};
+
+} // namespace stim_buff
+} // namespace smo
+
+#endif // SENSE_API_PROVIDER_DESC_H

smocore/include/stimBuffApis/stimBuffApiManager.h

@@ -0,0 +1,78 @@
+#ifndef SENSE_API_MANAGER_H
+#define SENSE_API_MANAGER_H
+
+#include <config.h>
+#include <memory>
+#include <vector>
+#include <string>
+#include <optional>
+#include <functional>
+#include <componentThread.h>
+#include <asynchronousLoop.h>
+#include <stimBuffApis/stimBuffApiLib.h>
+#include <user/deviceAttachmentSpec.h>
+#include <callback.h>
+#include <qutex.h>
+
+namespace smo {
+namespace stim_buff {
+
+class StimBuffApiManager
+{
+public:
+	static StimBuffApiManager& getInstance()
+	{
+		static StimBuffApiManager instance;
+		return instance;
+	}
+
+	void initialize(void)
+	{};
+	void finalize(void)
+	{};
+
+	StimBuffApiLib& loadStimBuffApiLib(
+		const std::string& libraryPath,
+		const std::shared_ptr<ComponentThread>& componentThread);
+
+	std::optional<std::shared_ptr<StimBuffApiLib>> getStimBuffApiLib(
+		const std::string& libraryPath);
+	std::optional<std::shared_ptr<StimBuffApiLib>> getStimBuffApiLibByApiName(
+		const std::string& apiName);
+	void unloadStimBuffApiLib(const std::string& libraryPath);
+
+	void initializeStimBuffApiLib(StimBuffApiLib& lib);
+	void finalizeStimBuffApiLib(StimBuffApiLib& lib);
+
+	void loadAllStimBuffApiLibsFromOptions(
+		const std::shared_ptr<ComponentThread>& componentThread);
+
+	void unloadAllStimBuffApiLibs(void);
+	void initializeAllStimBuffApiLibs(void);
+	void finalizeAllStimBuffApiLibs(void);
+
+	std::string stringifyLibs() const;
+
+private:
+	StimBuffApiManager()
+	: qutex("StimBuffApiManager")
+	{}
+	~StimBuffApiManager() = default;
+
+	StimBuffApiManager(const StimBuffApiManager&) = delete;
+	StimBuffApiManager& operator=(const StimBuffApiManager&) = delete;
+
+	std::vector<std::shared_ptr<StimBuffApiLib>> stimBuffApiLibs;
+
+public:
+	Qutex qutex;
+
+public:
+	static std::optional<std::string> searchForLibInSmoSearchPaths(
+		const std::string& libraryPath);
+};
+
+} // namespace stim_buff
+} // namespace smo
+
+#endif // SENSE_API_MANAGER_H