init

the readme is a ramble and there's no functionality (yet). couldn't ask
for a better start.

deps/labjack/exodriver/90-labjack.rules

@@ -0,0 +1,6 @@
+SUBSYSTEM!="usb_device", ACTION!="add", GOTO="labjack_rules_end"
+
+# LabJack Vendor ID
+ATTRS{idVendor}=="0cd5", MODE="0666", GROUP="adm"
+
+LABEL="labjack_rules_end"

deps/labjack/exodriver/README

@@ -0,0 +1,64 @@
+Exodriver: Linux (kernel 2.6+) and Mac OS X low-level LabJack U12, U3, U6, UE9,
+Digit, T4, and T7 USB library 2.07 and C examples
+01/17/2022
+support@labjack.com
+
+This package contains the liblabjackusb 2.07 USB library for low-level U3, U6,
+UE9, Digit, T4, and T7 USB communications and C examples for select LabJack
+devices.
+
+Refer to the INSTALL.Linux or INSTALL.MacOSX file for library requirements,
+installation instructions, and compiling information (library and examples).
+Note that the Exodriver requires the libusb-1.0 library.
+
+Library source code files are located in the liblabjackusb directory.
+
+C examples are provided for the LabJack U12, U3, U6, and UE9 in the examples
+directory. They demonstrate basic open/write/read/close operations using
+the liblabjackusb library and low-level function command-response. Low-level
+function documentation can be found in Section 5 of the LabJack U12, U3, U6,
+and UE9 User Guides. The u3.h/u6.h/ue9.h, and u3.c/u6.h/ue9.c files contain
+helpful functions for opening/closing USB connections, calculate checksums,
+retrieving device analog calibration information, etc. There are 5 "easy"
+functions (eAIN, eDAC, eDI, eDO, eTCConfig and eTCValues) that are similar to
+our Windows LabJackUD driver's "easy" functions. All other .c files are
+examples.
+
+USB command-response times for the U3, U6 and UE9 can be found in section 3.1
+of their User's Guide and were tested with the Feedback low-level function. USB
+Stream times are in Section 3.2. These times were measured in Windows and are
+similar in Linux and Mac OS X.
+
+Examples are not provided for Digit, T4, or T7 devices in this package.
+Please refer to the LJM library package and documentation for their API.
+
+The U12 also has a high-level library, which requires this library
+(liblabjackusb), that provides the same API as the U12 Windows driver. It can
+be downloaded here:
+
+http://labjack.com/support/u12/ljacklm
+
+
+LICENSE
+
+All exodriver library and example source code are licensed under MIT X11.
+
+  Copyright (c) 2009 LabJack Corporation <support@labjack.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+  THE SOFTWARE.

deps/labjack/exodriver/build.zig

@@ -0,0 +1,35 @@
+const std = @import("std");
+
+pub fn build(b: *std.Build) !void {
+    const target = b.standardTargetOptions(.{});
+    const optimize = b.standardOptimizeOption(.{});
+
+    const use_udev = b.option(
+        bool,
+        "use_udev",
+        "link and use udev (Linux only. Default: false)",
+    ) orelse false;
+
+    const liblabjackusb = b.addStaticLibrary(.{
+        .name = "labjackusb",
+        .target = target,
+        .optimize = optimize,
+        .link_libc = true,
+    });
+
+    liblabjackusb.addCSourceFile(.{ .file = b.path("liblabjackusb/labjackusb.c") });
+    liblabjackusb.installHeader(b.path("liblabjackusb/labjackusb.h"), "labjackusb.h");
+
+    // udev rules should be installed to /lib/udev/rules.d or /etc/udev/rules.d
+    // udevadm control --reload-rules
+    // /etc/init.d/udev-post reload
+    // udevstart
+
+    const usb_dep = b.dependency(
+        "usb",
+        .{ .target = target, .optimize = optimize, .use_udev = use_udev },
+    );
+    liblabjackusb.linkLibrary(usb_dep.artifact("usb"));
+
+    b.installArtifact(liblabjackusb);
+}

deps/labjack/exodriver/build.zig.zon

@@ -0,0 +1,14 @@
+.{
+    .name = "labjackusb",
+    .version = "2.7.0",
+    .dependencies = .{
+        .usb = .{ .path = "../../libusb" },
+    },
+    .paths = .{
+        "build.zig",
+        "build.zig.zon",
+        "liblabjackusb/",
+        "README",
+        "90-labjack.rules",
+    },
+}

deps/labjack/exodriver/liblabjackusb/labjackusb.h

@@ -0,0 +1,338 @@
+//-----------------------------------------------------------------------------
+//
+//  labjackusb.h
+//
+//  Header file for the labjackusb library.
+//
+//  support@labjack.com
+//
+//-----------------------------------------------------------------------------
+//
+//  Version History
+//
+//  0.90 - Initial release (LJUSB_AbortPipe not supported)
+//
+//  1.00 - Added LJUSB_SetBulkReadTimeout
+//
+//  1.10 - Changed the HANDLE to a void * (previously int)
+//       - Added LJUSB_GetLibraryVersion
+//       - Removed UE9_PIPE_EP2_OUT
+//       - Changed the values of the pipes (incremented by 1)
+//       - Removed function LJUSB_SetBulkReadTimeout
+//       - Changed LJUSB_LINUX_DRIVER_VERSION define name to
+//         LJUSB_LINUX_LIBRARY_VERSION
+//
+//  2.00 - Re-implemented library using libusb 1.0.  No longer requires LabJack
+//         kernel module.
+//       - Replaced define names U3_PIPE_EP1_IN and U3_PIPE_EP2_IN with
+//         U3_PIPE_EP2_IN and U3_PIPE_EP3_IN
+//       - Added U6 support
+//
+//  2.01 - Added U12 support
+//       - Added Wireless Bridge support
+//
+//  2.02 - Buxfix release
+//
+//  2.03 - Don't print libusb timeout errors on interupt transfers
+//
+//  2.04 - Removed exit calls
+//       - Now using unique a libusb session instead of the default
+//       - Setting errno more often when libusb errors occur
+//       - Changed guard define to LABJACKUSB_H_
+//       - Changed LJUSB_GetDevCount return data type to unsigned int
+//       - Moved LJ_VENDOR_ID to the header file so it's public
+//
+//  2.05 - Updated Wireless bridge support for bulk transfers
+//       - Updated Wireless bridge product ID to 1000
+//       - Fixed some compiler warnings
+//       - Renamed LJUSB_LINUX_LIBRARY_VERSION define to LJUSB_LIBRARY_VERSION
+//       - Changed LJUSB_Write/Read/Stream to return 0 on error instead of -1
+//       - Changed LJUSB_GetDevCounts return data type unsigned int
+//       - Changed LJUSB_GetDevCounts to return all products counted instead
+//         of 0
+//       - Added LJUSB_WriteTO, LJUSB_ReadTO and LJUSB_StreamTO functions
+//       - Added LJUSB_GetDeviceDescriptorReleaseNumber function
+//       - Added LJUSB_GetHIDReportDescriptor function for U12
+//       - Now using minor versions properly in LJUSB_LIBRARY_VERSION define
+//       - Renamed DEBUG define to LJ_DEBUG in source
+//       - Made global variables static
+//       - Replaced LJUSB_IsHandleValid checks with LJUSB_isNullHandle to
+//         improve LJUSB_Write/Read/Stream speeds
+//       - Initial T7 support
+//       - Initial Digit support
+//       - Added LJUSB_ResetConnection function.
+//  2.0503 - Fixed open calls to not steal handles from other processes on
+//           Linux.
+//         - libusb error prints are silenced when LJ_DEBUG is not enabled.
+//         - Added revision number to library version number. The float version
+//           number 2.0503 is equivalent to 2.5.3 (major.minor.revision).
+//  2.0600 - Initial T4 and T5 support
+//  2.0700 - Added new function LJUSB_OpenAllDevicesOfProductId
+//         - Bug fixes, spelling corrections and code cleanup
+//-----------------------------------------------------------------------------
+//
+
+#ifndef LABJACKUSB_H_
+#define LABJACKUSB_H_
+
+#define LJUSB_LIBRARY_VERSION 2.0700f
+
+#include <stdbool.h>
+
+typedef void * HANDLE;
+typedef unsigned int UINT;
+typedef unsigned char BYTE;
+
+//Vendor ID
+#define LJ_VENDOR_ID            0x0cd5
+
+//Product IDs
+#define UE9_PRODUCT_ID         9
+#define U3_PRODUCT_ID          3
+#define U6_PRODUCT_ID          6
+#define U12_PRODUCT_ID         1
+#define BRIDGE_PRODUCT_ID      1000
+#define T4_PRODUCT_ID          4
+#define T5_PRODUCT_ID          5 // Pending future development
+#define T7_PRODUCT_ID          7
+#define DIGIT_PRODUCT_ID       200
+#define UNUSED_PRODUCT_ID      -1
+
+//UE9 pipes to read/write through
+#define UE9_PIPE_EP1_OUT       1
+#define UE9_PIPE_EP1_IN        0x81
+#define UE9_PIPE_EP2_IN        0x82  //Stream Endpoint
+
+//U3 pipes to read/write through
+#define U3_PIPE_EP1_OUT        1
+#define U3_PIPE_EP2_IN         0x82
+#define U3_PIPE_EP3_IN         0x83  //Stream Endpoint
+
+//U6 pipes to read/write through
+#define U6_PIPE_EP1_OUT        1
+#define U6_PIPE_EP2_IN         0x82
+#define U6_PIPE_EP3_IN         0x83  //Stream Endpoint
+
+//U12 pipes to read/write through
+#define U12_PIPE_EP1_IN        0x81
+#define U12_PIPE_EP2_OUT       2
+#define U12_PIPE_EP0           0     //Control endpoint
+
+//Wireless bridge pipes to read/write through
+#define BRIDGE_PIPE_EP1_OUT    1
+#define BRIDGE_PIPE_EP2_IN     0x82
+#define BRIDGE_PIPE_EP3_IN     0x83  //Spontaneous Endpoint
+
+//T4 pipes to read/write through
+#define T4_PIPE_EP1_OUT        1
+#define T4_PIPE_EP2_IN         0x82
+#define T4_PIPE_EP3_IN         0x83  //Stream Endpoint
+
+//T5 pipes to read/write through
+#define T5_PIPE_EP1_OUT        1
+#define T5_PIPE_EP2_IN         0x82
+#define T5_PIPE_EP3_IN         0x83  //Stream Endpoint
+
+//T7 pipes to read/write through
+#define T7_PIPE_EP1_OUT        1
+#define T7_PIPE_EP2_IN         0x82
+#define T7_PIPE_EP3_IN         0x83  //Stream Endpoint
+
+//Digit pipes to read/write through
+#define DIGIT_PIPE_EP1_OUT     1
+#define DIGIT_PIPE_EP2_IN      0x82
+
+
+#ifdef __cplusplus
+extern "C"{
+#endif
+
+
+float LJUSB_GetLibraryVersion(void);
+//Returns the labjackusb library version number.
+
+unsigned int LJUSB_GetDevCount(unsigned long ProductID);
+// Returns the total number of LabJack USB devices connected.
+// ProductID = The product ID of the devices you want to get the count of.
+
+unsigned int LJUSB_GetDevCounts(UINT *productCounts, UINT * productIds, UINT n);
+// Returns the count for n products.
+// productCounts = Array of size n that holds the count
+// productIds = Array of size n which holds the product IDs.
+// n = The size of the arrays.
+// For example
+//   uint productCounts[10], productIds[10];
+//   r = LJUSB_GetDevCounts(productCounts, productIds, 10);
+// would return arrays that may look like
+//   {1, 2, 3, 4,    5, 6,   7, 8, 9, 0}
+//   {3, 6, 9, 1, 1000, 7, 200, 4, 5, 0}
+// which means there are
+//   1 U3
+//   2 U6s
+//   3 UE9s
+//   4 U12s
+//   5 SkyMote Bridges
+//   6 T7s
+//   7 Digits
+//   8 T4s
+//   9 T5s
+// connected.
+
+int LJUSB_OpenAllDevices(HANDLE* devHandles, UINT* productIds, UINT maxDevices);
+// Opens all LabJack devices up to a maximum of maxDevices.
+// devHandles = An array of handles with a size of maxDevices
+// productIds = An array of product IDs with a size of maxDevices
+// maxDevices = Maximum number of devices to open.
+// Returns the number of devices actually opened, or -1 if a tragically bad
+// error occurs. The structure of the arrays is similar to that of
+// LJUSB_GetDevCounts above. A simple example would be:
+//   {2341234, 55343, 0, 0, ...}
+//   {3, 1000, 0, 0, ...}
+// where the return value is 2. 2341234 is the handle for a U3, and 55343 is the
+// handle for a SkyMote Bridge.
+
+int LJUSB_OpenAllDevicesOfProductId(UINT productId, HANDLE **devHandles);
+// Attempts to find and open all LabJack devices of the given productId.
+// Use the special value 0 to allow all LabJack productIds.
+// Returns the number of devices actually opened, or -1 if a tragically bad
+// error occurs. Returns by reference an array of HANDLEs for each successfully
+// opened device. You must call free() on this list when you are done with it.
+// Example usage:
+// HANDLE *handles = NULL;
+// int count = LJUSB_OpenAllDevicesOfProductId(U3_PRODUCT_ID, &handles);
+// free(handles);
+
+HANDLE LJUSB_OpenDevice(UINT DevNum, unsigned int dwReserved, unsigned long ProductID);
+// Obtains a handle for a LabJack USB device.  Returns NULL if there is an
+// error.
+// If the device is already open, NULL is returned and errno is set to EBUSY.
+// DevNum = The device number of the LabJack USB device you want to open.  For
+//          example, if there is one device connected, set DevNum = 1.  If you
+//          have two devices connected, then set DevNum = 1, or DevNum = 2.
+// dwReserved = Not used, set to 0.
+// ProductID = The product ID of the LabJack USB device.
+
+bool LJUSB_ResetConnection(HANDLE hDevice);
+// Performs a USB port reset to reinitialize a device.
+// Returns true on success, or false on error and errno is set.
+// Note that this function is experimental and currently may not work.
+// If this function fails, hDevice is no longer valid (you should close it)
+// and you should re-open the device.
+// hDevice = The handle for your device
+
+unsigned long LJUSB_Write(HANDLE hDevice, const BYTE *pBuff, unsigned long count);
+// Writes to a device with a 1 second timeout.  If the timeout time elapses and
+// no data is transferred the USB request is aborted and the call returns.
+// Returns the number of bytes written, or 0 on error and errno is set.
+// hDevice = The handle for your device
+// pBuff = The buffer to be written to the device.
+// count = The number of bytes to write.
+// This function replaces the deprecated LJUSB_BulkWrite, which required the
+// endpoint.
+
+unsigned long LJUSB_Read(HANDLE hDevice, BYTE *pBuff, unsigned long count);
+// Reads from a device with a 1 second timeout. If the timeout time elapses and
+// no data is transferred the USB request is aborted and the call returns.
+// Returns the number of bytes read, or 0 on error and errno is set.
+// hDevice = The handle for your device
+// pBuff = The buffer to be filled in with bytes from the device.
+// count = The number of bytes expected to be read.
+// This function replaces the deprecated LJUSB_BulkRead, which required the
+// endpoint.
+
+unsigned long LJUSB_Stream(HANDLE hDevice, BYTE *pBuff, unsigned long count);
+// Reads from a device's stream interface with a 1 second timeout.  If the
+// timeout time elapses and no data is transferred the USB request is aborted
+// and the call returns.  Returns the number of bytes written, or 0 on error and
+// errno is set.
+// hDevice = The handle for your device
+// pBuff = The buffer to be filled in with bytes from the device.
+// count = The number of bytes expected to be read.
+// This function replaces the deprecated LJUSB_BulkRead, which required the
+// (stream) endpoint.
+
+unsigned long LJUSB_WriteTO(HANDLE hDevice, const BYTE *pBuff, unsigned long count, unsigned int timeout);
+// Writes to a device with a specified timeout.  If the timeout time elapses and
+// no data is transferred the USB request is aborted and the call returns.
+// Returns the number of bytes written, or 0 on error and errno is set.
+// hDevice = The handle for your device
+// pBuff = The buffer to be written to the device.
+// count = The number of bytes to write.
+// timeout = The USB communication timeout value in milliseconds.  Pass 0 for
+//           an unlimited timeout.
+
+unsigned long LJUSB_ReadTO(HANDLE hDevice, BYTE *pBuff, unsigned long count, unsigned int timeout);
+// Reads from a device with a specified timeout. If the timeout time elapses and
+// no data is transferred the USB request is aborted and the call returns.
+// Returns the number of bytes read, or 0 on error and errno is set.
+// hDevice = The handle for your device
+// pBuff = The buffer to be filled in with bytes from the device.
+// count = The number of bytes expected to be read.
+// timeout = The USB communication timeout value in milliseconds.  Pass 0 for
+//           an unlimited timeout.
+
+unsigned long LJUSB_StreamTO(HANDLE hDevice, BYTE *pBuff, unsigned long count, unsigned int timeout);
+// Reads from a device's stream interface with a specified timeout.  If the
+// timeout time elapses and no data is transferred the USB request is aborted
+// and the call returns.  Returns the number of bytes read, or 0 on error and
+// errno is set.
+// hDevice = The handle for your device
+// pBuff = The buffer to be filled in with bytes from the device.
+// count = The number of bytes expected to be read.
+// timeout = The USB communication timeout value in milliseconds.  Pass 0 for
+//           an unlimited timeout.
+
+void LJUSB_CloseDevice(HANDLE hDevice);
+// Closes the handle of a LabJack USB device.
+
+bool LJUSB_IsHandleValid(HANDLE hDevice);
+// Returns true if the handle is valid; this is, it is still connected to a
+// device on the system.
+
+unsigned short LJUSB_GetDeviceDescriptorReleaseNumber(HANDLE hDevice);
+// Returns the device's release number (binary-coded decimal) stored in the
+// device descriptor.
+// hDevice = The handle for your device.
+
+unsigned long LJUSB_GetHIDReportDescriptor(HANDLE hDevice, BYTE *pBuff, unsigned long count);
+// Reads the HID report descriptor bytes from a device with a 1 second timeout.
+// If the timeout time elapses and no data is transferred the USB request is
+// aborted and the call returns.  Returns the number of bytes read, or 0 on
+// error and errno is set.  Only supports the U12.
+// hDevice = The handle for your device.
+// pBuff = The buffer to filled in with the bytes of the report descriptor.
+// count = The number of bytes expected to be read.
+
+
+//Note:  For all function errors, use errno to retrieve system error numbers.
+
+/* --------------- DEPRECATED Functions --------------- */
+
+unsigned long LJUSB_BulkRead(HANDLE hDevice, unsigned char endpoint, BYTE *pBuff, unsigned long count);
+// Reads from a bulk endpoint.  Returns the count of the number of bytes read,
+// or 0 on error (and sets errno).  If there is no response within a certain
+// amount of time (LJ_LIBUSB_TIMEOUT in labjackusb.c), the read will timeout.
+// hDevice = Handle of the LabJack USB device.
+// endpoint = The pipe you want to read your data through (xxx_PIPE_xxx_IN).
+// *pBuff = Pointer a buffer that will be read from the device.
+// count = The size of the buffer to be read from the device.
+
+
+unsigned long LJUSB_BulkWrite(HANDLE hDevice, unsigned char endpoint, BYTE *pBuff, unsigned long count);
+// Writes to a bulk endpoint.  Returns the count of the number of bytes wrote,
+// or 0 on error and sets errno.
+// hDevice = Handle of the LabJack USB device.
+// endpoint = The pipe you want to write your data through (xxx_PIPE_xxx_OUT).
+// *pBuff = Pointer to the buffer that will be written to the device.
+// count = The size of the buffer to be written to the device.
+
+bool LJUSB_AbortPipe(HANDLE hDevice, unsigned long Pipe);
+// No longer supported and will return false.
+// Pipes will timeout after LJ_LIBUSB_TIMEOUT, which is set by default to 1
+// second.
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // LABJACKUSB_H_