libGadget

This repository contains a Windows DLL and headers for interfacing with ETC Gadget products. Gadget II is a 2-port USB-to-DMX512 converter sold by ETC. It supports DMX, RDM and "Raw Mode" - sending and receiving arbitrary serial data on the DMX bus. All of these features can be accessed through this DLL interface. Legacy one-port Gadgets are also supported.

This is not official ETC software. For challenges using, integrating, compiling, or modifying this software, we encourage posting on the issues page of this project.

32- and 64-bit DLLs are provided. The DLLs are built with the MSVC 2017 toolchain. Currently, non-Windows platforms are not supported.

To include libGadget in a CMake project, you can use find_package():

if(CMAKE_SIZEOF_VOID_P STREQUAL 4)
  list(APPEND CMAKE_PREFIX_PATH ${PATH_TO_LIBGADGET}/libGadget/Win32)
else()
  list(APPEND CMAKE_PREFIX_PATH ${PATH_TO_LIBGADGET}/libGadget/x64)
endif()

find_package(GadgetDLL 2.1.0 REQUIRED)

Then link the export library:

target_link_libraries(YourApp PRIVATE GadgetDLL::GadgetDLL)

Additionally, it's convenient to add a post-build step to copy the DLL to the directory containing your executable:

get_target_property(GADGET_DLL_LOCATION GadgetDLL::GadgetDLL IMPORTED_LOCATION_RELEASE)
add_custom_command(
  TARGET YourApp
  POST_BUILD
  COMMAND ${CMAKE_COMMAND} -E copy ${GADGET_DLL_LOCATION} $<TARGET_FILE_DIR:YourApp>
  COMMENT "Copying Gadget DLL to executable directory..."
)

To include libGadget in a non-CMake project, you can add the relevant directories manually. The export library is located in lib/, the DLL is in bin/, and the headers are in include/.