README.md

   1 # IguanaIR software / firmware project
   2
   3 This project provides the software and firmware used with the
   4 IguanaWorks usbir hardware.  This hardware is used to communicate via
   5 infrared signals between remote controls, computer systems, and
   6 consumer electronics.  The hardware is most commonly used along side
   7 LIRC or WinLirc by individuals building customized media centers or
   8 similar projects, but people have also controlled glowing juggling
   9 balls or used these devices in university projects.
  10
  11 This code currently supports multiple Linux distributions on PCs or
  12 embeded platforms, such as the Raspberry Pi, along with Windows 7
  13 through Windows 10.  Windows XP and Vista should also work, but are
  14 not explicitly supported at this time.  This software includes
  15 firmware update tools, command line testing tools, and Python (version
  16 2 or 3) and C programming APIs for people who want to write their own
  17 code to interact with devices controlled by infrared signals.
  18
  19 Alternatively, a Linux kernel driver also supports the IguanaWorks
  20 usbir hardware and does not require or use the software provided here.
  21
  22 With either this software, or the kernel driver, Linux users commonly
  23 rely on LIRC to decode the infrared signals into a more user-friendly
  24 format such as "TV Power" or "Heater On":
  25
  26  * http://www.lirc.org/
  27
  28 Windows users usually rely on WinLIRC for signal decoding and coupled
  29 with plugins for frameworks such as Girder or EventGhost these
  30 configurations can tie infrared signals into home automation:
  31
  32  * http://winlirc.sourceforge.net/
  33  * https://www.promixis.com/girder.php
  34  * http://www.eventghost.org/
  35
  36 The hardware can be purchased from our website and bulk discounts are
  37 available:
  38
  39  * http://www.iguanaworks.net
  40
  41 The IguanaWorks website also provides Windows binaries, frequently
  42 asked questions, and a support site to contact the developers with
  43 questions, issues, or descriptions of interesting projects.
  44
  45 Thank you for your interest.
  46
  47 -The IguanaWorks Team