README.md

   1 usb-relay-hid
   2 =============
   3
   4 ![](http://vusb.wdfiles.com/local--files/project:driver-less-usb-relays-hid-interface/relay2.jpg)
   5
   6 The goal of this little project is to provide open-source API for low-cost USB HID relays
   7 (search on eBay for "5V USB Relay Programmable Computer Control For Smart Home").
   8
   9 The big advantage of HID-based interface is that no kernel drivers and no simulated COM-ports are needed. It is easy to detect and address the connected devices.
  10
  11 The vendors currently offer only an API library for Windows, and only in binary form.
  12
  13 We are not associated with the manufacturer(s) of these devices or author(s) of the original software offered by eBay sellers.
  14 Our intent is to make this device work on Linux, 64-bit Windows and other platforms where we need it.
  15
  16 The main project web page is on the [V-USB wiki](http://vusb.wikidot.com/project:driver-less-usb-relays-hid-interface "driver-less-usb-relays-hid-interface"). This is because the firmware of the device is based on [V-USB](http://www.obdev.at/products/vusb/index.html). V-USB enables amazingly simple and low-cost USB hardware solutions. This repository contains only the host side software.
  17
  18
  19
  20 License
  21 -------
  22
  23 Currently we reuse some code from other V-USB projects, which is dual-licensed: GPL + commercial. Until we remove this code, we cannot set any other license.
  24
  25 We could not locate any copyright information in the software package offered by the eBay sellers. No source code was reused from that package, besides of the C API header (the .h file).
  26
  27 Current state
  28 -------------
  29
  30 A simple command-line utility for Linux (x86 or x64), Apple OS X and Windows.
  31 This is enough for our own usage.
  32
  33 - Windows version builds with VC++ and WDK 7.1.
  34 - Linux version builds with gcc and libusb v. 0.1. Tested on RH and Ubuntu.
  35 - OS-X 10.9+ version builds with Xcode and plain IOKit libraries.
  36
  37
  38 TO-DOs, bugs and more
  39 ----------------------
  40
  41 This is in the wiki and issues in the [Github project](http://git.io/bGcxrQ).
  42
  43