IRUSB Linux Platform setup:

Thank you for your IRUSB purchase!

 

Which hardware platform are you using?

(please select)

Setup using Video Storm disk image

First VERIFY you have a Raspberry PI0 W (this image is specific to the hardware)

1. Write image to your uSD card (skip this if you purchased our pre-built card)
 - Obtain a 8GB or larger uSD card (we strongly recommend SANDISK brand)
 - Download the IrUSB PI0 W disk image file Disk image
 - Unzip the file (unzipped file extension should be .img)
 - Install Win32 imager (or other disk imaging software) Win32 imager
 - Use the disk imager software to write the unzipped image file to the uSD card (be sure you write to the uSD card, not other hard drives)

2. Setup the wifi connection
 - You will need to edit the /etc/wpa_supplicant/wpa_supplicant.conf file on the Linux partition.
 - If you have a Linux computer, this can easily be done by mounting the card and editing the file.
 - If not, you should connect a keyboard and monitor to the PI0 before booting.
 - Once booted, login using user name pi, password raspberry
 - Now you can edit the file using "sudo vi /etc/wpa_supplicant/wpa_supplicant.conf" or nano
 - Modify the "network" section for your network SSID and password.
 - Shutdown the device after saving the file "sudo halt"
 - Remove power before the next step
 - There are many guides on the internet if you need additional help

2. Connect one or more IrUSBs
 - If using one IrUSB, we suggest a micro USB adapter Amazon link
 - If using more than one, we suggest a micro USB hub Amazon link

3. Power up the device and wait 3 minutes

4. Find the IP address
 - Using an IP scanner app is the easiest method.
 - You can also see the IP address on-screen if still connected to a HDMI monitor

5. Configure your device using the Web interface at http://device_ip_address
 - Configuration of Cloud account, saved TX codes, and saved RX codes is only necessary in some use cases. Please refer to the top level setup instructions.
 - Firmware updates can be performed from the Web interface using the "Manual Control" link.

Setup using self install method

First VERIFY you have a supported platform. IrUSB is currently compiled for ARM6, ARM7, and x86 architectures.

NOTE: NetPlay Manager has IrUSB PRE-INSTALLED. Just connect the cable and reboot.

These instructions assume you already have a working Linux distribution running.

1. Download the IrUSB Linux driver package Disk image
 - Unzip the driver package to a new directory
 - The README.txt file in the root directory gives descriptions of the package contents

2. Review the Dependencies section of the README.txt file
 - Install or update any packages you do not currently have
 - Recommended packages should be installed if you need the features that require them
 - There are many guides on the internet if you need additional help

3. Install and configure a web server to access the web configuration gui
 - We recommend lighttpd with PHP support
 - Here are example instructions
 - Set your web root directory to the driver install directory /html (and make sure execute and read permissions are set for all)
 - You should also set read/write/execute open to all on the /data directory
 - Edit the path/html/include.php file for the path you have installed the driver package in
 - There are many guides on the internet if you need additional help

4. Add the irusb app to your startup script
 - The executable is located at path/bin/ARCH/irusb (ARCH corresponding to your platform)
 - Your startup script should run this file at boot (with the working directory being the same path/bin/ARCH/ directory)
 - irusb must run as root or with sudo privledges
 - There is an example rc.local file in the path/updates directory
 - There are many guides on the internet if you need additional help

5. Connect one or more IrUSBs
 - If using one IrUSB, we suggest a micro USB adapter Amazon link
 - If using more than one, we suggest a micro USB hub Amazon link
 - IrUSB hardware is hot pluggable on most platform. However, irusb application only detects new devices when it is started. Thus you must kill and restart the app if adding IrUSB hardware.

6. Configure your device using the Web interface at http://device_ip_address
 - Configuration of Cloud account, saved TX codes, and saved RX codes is only necessary in some use cases. Please refer to the top level setup instructions.
 - You may also perform configuration by directly editing the XML files in the data directory (if you do not want to setup a web server)  - Firmware updates can be performed from the Web interface using the "Manual Control" link or the path/bin/updater.pl script