2024-11-25 03:26:44 +01:00
|
|
|
USB drivers
|
|
|
|
===========
|
|
|
|
:compact-option:
|
|
|
|
|
2024-11-26 02:28:41 +01:00
|
|
|
_usb-drivers_ is a collection of utilities to control various hardware over USB.
|
|
|
|
|
|
|
|
Utility overview
|
|
|
|
----------------
|
|
|
|
|
|
|
|
eizoctl
|
|
|
|
~~~~~~~
|
|
|
|
_eizoctl_ controls elementary settings of EIZO computer monitors, which do not
|
|
|
|
support DDC/CI. Say no to oily stains on your monitor's frame!
|
|
|
|
|
|
|
|
$ eizoctl --brightness +0.5 --input USB-C
|
2024-11-25 03:26:44 +01:00
|
|
|
|
|
|
|
It is intended as a replacement for official EIZO software,
|
|
|
|
and may not run at the same time, as it would contend for device access.
|
|
|
|
|
2024-11-26 02:28:41 +01:00
|
|
|
eizoctltray
|
|
|
|
~~~~~~~~~~~
|
|
|
|
_eizoctltray_ is a derived Windows utility that can stay in the systray.
|
|
|
|
When holding the Shift or Control keys while switching singnal inputs,
|
|
|
|
it will also suspend or power off the system, respectively.
|
|
|
|
|
|
|
|
image::eizoctltray.png["eizoctltray with expanded context menu", 343, 229]
|
|
|
|
|
|
|
|
elksmart-comm
|
|
|
|
~~~~~~~~~~~~~
|
|
|
|
_elksmart-comm_ interfaces with ELK Smart infrared dongles EKX4S and EKX5S-T,
|
|
|
|
partially reimplementing the Ocrustar mobile app. It can both receive and send,
|
|
|
|
although the older dongle is extremely unreliable at receiving.
|
|
|
|
|
|
|
|
To mimic the Nikon ML-L3 infrared wireless remote control:
|
|
|
|
|
|
|
|
$ elksmart-comm 80ffffffffffffc71c5f1bda1bffffffffffffffffffffffffffffff3a7bffffffffffff99185f1bda1b03
|
|
|
|
|
|
|
|
While it does not build for Windows, this is incidental.
|
2024-11-25 03:26:44 +01:00
|
|
|
|
2024-11-26 02:28:41 +01:00
|
|
|
razer-bw-te-ctl
|
|
|
|
~~~~~~~~~~~~~~~
|
|
|
|
_razer-bw-te-ctl_ makes it possible to change the configuration of your Razer
|
|
|
|
BlackWidow Tournament Edition keybooard (the 2012 model).
|
2024-11-25 03:26:44 +01:00
|
|
|
|
2024-11-25 04:01:47 +01:00
|
|
|
Make sure to let the Windows Razer Synapse tool upgrade the firmware to the
|
|
|
|
newest version before running the program. There might be some issues otherwise
|
|
|
|
due to protocol changes, although I don't really deem it very probable.
|
|
|
|
|
2024-11-25 03:26:44 +01:00
|
|
|
Packages
|
|
|
|
--------
|
|
|
|
Regular releases are sporadic. git master should be stable enough.
|
|
|
|
|
2024-11-25 04:01:47 +01:00
|
|
|
You can get a package with the latest development version
|
|
|
|
as a https://git.janouch.name/p/nixexprs[Nix derivation].
|
|
|
|
|
2024-11-25 03:26:44 +01:00
|
|
|
Building
|
|
|
|
--------
|
2024-11-25 04:01:47 +01:00
|
|
|
Build dependencies:
|
|
|
|
CMake, pkg-config, liberty (included), help2man +
|
|
|
|
Runtime dependencies:
|
2024-11-25 13:47:06 +01:00
|
|
|
libusb-1.0 (elksmart-comm, razer-bw-te-ctl), hidapi >= 0.14 (eizoctl)
|
2024-11-25 03:26:44 +01:00
|
|
|
|
|
|
|
$ git clone --recursive https://git.janouch.name/p/usb-drivers.git
|
2024-11-25 09:52:22 +01:00
|
|
|
$ mkdir usb-drivers/build
|
|
|
|
$ cd usb-drivers/build
|
2024-11-25 03:26:44 +01:00
|
|
|
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
|
|
|
|
$ make
|
|
|
|
|
|
|
|
To install the applications, you can do either the usual:
|
|
|
|
|
|
|
|
# make install
|
|
|
|
|
|
|
|
Or you can try telling CMake to make a package for you. For Debian it is:
|
|
|
|
|
|
|
|
$ cpack -G DEB
|
|
|
|
# dpkg -i usb-drivers-*.deb
|
|
|
|
|
|
|
|
Contributing and Support
|
|
|
|
------------------------
|
2024-11-25 09:52:22 +01:00
|
|
|
Use https://git.janouch.name/p/usb-drivers to report bugs, request features,
|
2024-11-25 03:26:44 +01:00
|
|
|
or submit pull requests. `git send-email` is tolerated. If you want to discuss
|
|
|
|
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
|
|
|
|
|
|
|
|
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
|
|
|
|
|
|
|
|
License
|
|
|
|
-------
|
|
|
|
This software is released under the terms of the 0BSD license, the text of which
|
|
|
|
is included within the package along with the list of authors.
|