Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
usbir:gettingstarted [2016/11/05 21:18]
jdunn
usbir:gettingstarted [2017/04/06 12:21] (current)
bluey move to https images and links
Line 2: Line 2:
 ====== Getting Started with the Iguanaworks USB IR Transceiver (Linux) ====== ====== Getting Started with the Iguanaworks USB IR Transceiver (Linux) ======
  
-{{http://​www.iguanaworks.net/​wp-content/​uploads/​products/​usb-ir-transceiver/​USB-LED-300x113.jpg}}+{{https://​www.iguanaworks.net/​wp-content/​uploads/​products/​usb-ir-transceiver/​USB-LED-300x113.jpg}}
  
 Unlike our serial version of this product, to use and communicate with the USB device, a kernel driver or the igdaemon software must be used. The igclient program (or libiguanaIR.so library) communicates with our device through the igdaemon, but most people can use our devices with LIRC without installing our software. Unlike our serial version of this product, to use and communicate with the USB device, a kernel driver or the igdaemon software must be used. The igclient program (or libiguanaIR.so library) communicates with our device through the igdaemon, but most people can use our devices with LIRC without installing our software.
  
-This guide will help you install and configure the necessary software to use the USB IR Transceiver. If you've read through this and still have questions please submit a [[http://​iguanaworks.net/​projects/​IguanaIR/​newticket|Support Ticket]]+This guide will help you install and configure the necessary software to use the USB IR Transceiver. If you've read through this and still have questions please submit a [[https://www.iguanaworks.net/​projects/​IguanaIR/​newticket|Support Ticket]]
  
   - Installing the iguanaIR software (daemon and client).   - Installing the iguanaIR software (daemon and client).
Line 61: Line 61:
 ===== Step 2: Installing iguanaIR ===== ===== Step 2: Installing iguanaIR =====
  
-Install the iguanair software package. You can get the software and installation instructions at [[http://​iguanaworks.net/​downloads.php|downloads page]]. We provide rpm and deb software repositories in addition to direct links to the .deb and .rpm files. A source tarball is also available. We recommend adding our repository to your list of source repositories. Then you can get the iguanair package installed by running (as root or with sudo) the command:+Install the iguanair software package. You can get the software and installation instructions at [[https://​iguanaworks.net/​downloads.php|downloads page]]. We provide rpm and deb software repositories in addition to direct links to the .deb and .rpm files. A source tarball is also available. We recommend adding our repository to your list of source repositories. Then you can get the iguanair package installed by running (as root or with sudo) the command:
  
 ==== Debian-based Distros ==== ==== Debian-based Distros ====
Line 189: Line 189:
 and so on.  What we can see from this output is that the device was idle for around 0.4 seconds before a 6.4 millisecond header pulse was detected. ​ All the numbers printed above are times in microseconds. ​ This is not actually the raw data received from the USB device, but the daemon translates that rather odd format to microsecond pulses and spaces. ​ If this command fails, please check for the error on the TroubleShooting page. and so on.  What we can see from this output is that the device was idle for around 0.4 seconds before a 6.4 millisecond header pulse was detected. ​ All the numbers printed above are times in microseconds. ​ This is not actually the raw data received from the USB device, but the daemon translates that rather odd format to microsecond pulses and spaces. ​ If this command fails, please check for the error on the TroubleShooting page.
  
-===== Step 5: Installing and Testing LIRC =====+===== Step 4: Installing and Testing LIRC =====
  
 You have already installed the lirc package in step 2. However, LIRC needs a iguanair driver which you You have already installed the lirc package in step 2. However, LIRC needs a iguanair driver which you
Line 232: Line 232:
  
 ==== Debian and Ubuntu (lirc version 0.9.0) ==== ==== Debian and Ubuntu (lirc version 0.9.0) ====
-I will not go into the details of installing LIRC.  Please refer to http://​lirc.org for such details. ​ The one thing I will say about LIRC installation is that you **must** make sure that your version of LIRC supports the iguanaIR driver. ​ Most linux distros do not LIRC with support for our driver, altough newer versions of Fedora do.  Take a look at  [[http://​iguanaworks.net/​2012/​compile-lirc-on-fedora-rpm/​|here for rpm]] and [[http://​iguanaworks.net/​2012/​compile-lirc-into-deb-package/​|here for deb]] for compiling LIRC with our driver the easy way.  To check if you have our driver compiled into LIRC, run:+I will not go into the details of installing LIRC.  Please refer to http://​lirc.org for such details. ​ The one thing I will say about LIRC installation is that you **must** make sure that your version of LIRC supports the iguanaIR driver. ​ Most linux distros do not LIRC with support for our driver, altough newer versions of Fedora do.  Take a look at  [[https://www.iguanaworks.net/​2012/​compile-lirc-on-fedora-rpm/​|here for rpm]] and [[https://www.iguanaworks.net/​2012/​compile-lirc-into-deb-package/​|here for deb]] for compiling LIRC with our driver the easy way.  To check if you have our driver compiled into LIRC, run:
 <​code>​ <​code>​
 [[:​user@server|~]]$ lircd -H '?'​ | grep iguana [[:​user@server|~]]$ lircd -H '?'​ | grep iguana
Line 292: Line 292:
 Once lircd is tested with irsend command we can be certain that the igdaemon and lircd daemon are both working, and properly communicating. ​ Congratulations,​ the iguanaIR specific stuff is done. Once lircd is tested with irsend command we can be certain that the igdaemon and lircd daemon are both working, and properly communicating. ​ Congratulations,​ the iguanaIR specific stuff is done.
  
-===== Step 4: Getting a LIRC remote onfiguration =====+===== Step 5: Getting a LIRC remote onfiguration =====
  
 As stated above, I'd suggest downloading your lirc configuration from https://​sourceforge.net/​projects/​lirc-remotes/​. ​ Even if you can start with a configuration where only a few buttons work that is //far// preferable to starting from scratch. ​ But, assuming that you can't find such a configuration file check our page about [[:lirc]], and why I'm not real fond of it.  But it's not like we have another option. As stated above, I'd suggest downloading your lirc configuration from https://​sourceforge.net/​projects/​lirc-remotes/​. ​ Even if you can start with a configuration where only a few buttons work that is //far// preferable to starting from scratch. ​ But, assuming that you can't find such a configuration file check our page about [[:lirc]], and why I'm not real fond of it.  But it's not like we have another option.
  
-===== Step 5: Using it all =====+===== Step 6: Using it all =====
  
 So most likely you want your remote to work with mplayer, or mythtv. ​ This is not my department, but a little is said on the [[:lirc]] page. So most likely you want your remote to work with mplayer, or mythtv. ​ This is not my department, but a little is said on the [[:lirc]] page.