Frequently Asked Questions

Getting Started Guide (Linux)
Last Updated 4 years ago

Unlike our serial version of this product, to use and communicate with the USB device, the igdaemon software must be installed and running. The igclient program (or libiguanaIR.so library) communicates with our device through the igdaemon.

This guide will help you install and configure the necessary software so use the USB IR Transceiver. If it does not, please create a  Support Ticket.

Step 1: Installing iguanair

Install the iguanair software package. You can get the software and installation instructions at 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:
  1. Add our package repository to your sources list by running one of the following three commands based on your computer architecture
  2. Update your package list and install our package by running
    sudo apt-get update
    sudo apt-get install iguanair
RPM-based Distros:
  1. Add "http://iguanaworks.net/downloads/${basearch}" to your package repository list.
  2. Install our software by running
    yum install iguanair
From Source:
For the source tarball, you will need to compile our software with the commands:
tar -xjf iguanaIR-0.24.tar.bz2
cd iguanaIR-0.24
make
make install

Step 2: Starting iguanair

Our packages have only been tested on Fedora and Ubuntu systems, but should be compatible with most rpm or deb-based distributions. If you have to make changes for your specific distribution, please let us know and we'll include the details in our packages. Once the software is installed, connect the device (or reconnect it if you plugged it in before) and start the igdaemon. This should be as simple as running as root the command:
sudo /etc/init.d/iguanaIR start
That's it. Now to test the daemon is running and communicating with the USB device, you can the following command (as a regular user, no need to run as root or use sudo):
igclient --get-version
and you should see something close to:
get version: success: version=0x0308
If you see what version of the device you have, you have the daemon installed and working properly.

Step 3: Testing iguanair

Try running:
igclient --receiver-on --sleep 100
This will cause the usb device to enable its receiver and start streaming data in the form of space and pulse timings to the client. The sleep tells the igclient to wait for 100 seconds before exiting, during which time it prints all received signals. The signals will not be translated in any way, and so should be an accurate description of what the igclient is seeing.

This is our equivalent to LIRC's mode2 program. The output is not as pretty, but is primarily used to ensure that the device is working, the basic configuration is correct and our IR receiver can see something from your remote.
When this igclient command is executed data will stream past in the terminal. It looks something like:
received 1 signal(s):
space: 152917
received 1 signal(s):
space: 152917
received 1 signal(s):
space: 114688
received 4 signal(s):
space: 6400
pulse: 3498
space: 1664
pulse: 426
received 7 signal(s):
space: 384
pulse: 448
space: 1237
pulse: 426
space: 405
pulse: 426
space: 362
received 7 signal(s):
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. 

Congratulations, you are successfully communicating with your Iguanaworks USB IR Transceiver. If you want to use the device with  LIRC, please go to step 3 in this guide.

Please Wait!

Please wait... it will take a second!