This project provides a simple driver to use sainsmart 4/8 channel USB relay based on FTDI chip in Linux system. This application is based on C program.
This software is based on C program and requires gcc to compile the program from source.
-
Installing dependencies This program requires FTDI library to interact with the relay and it can be installed using the following command in Debian based system.
sudo apt-get install libftdi1 libftdi-dev libusb-dev -
Compiling the code
git clone https://github.com/labbots/SainsmartUsbRelay.git cd sainsmart-usb-relay make sudo make install
The "make install" command copies the binary to /usr/local/bin. So the command can be utilized anywhere from the system.
- The following works for both a Raspberry Pi (Debian Wheezy) and Ubuntu 16.04, getting ordinary users (e.g. ‘pi’ on the RPi) access to the FTDI device without needing root permissions:
Create a file /etc/udev/rules.d/53-libftdi.rules. You will need sudo access to create this file. Put the following in the file:
SUBSYSTEMS=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", GROUP="dialout", MODE="0660"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6014", GROUP="dialout", MODE="0660"
Some FTDI devices may use other USB PIDs. You could try removing the match on idProduct altogether, just matching on the FTDI vendor ID. Or Use lsusb or similar to determine the exact values to use (or try checking dmesg output on device insertion / removal).
See udev/53-ftdi.rules for example
This project provides a simple command to interact with the USB relay.
To turn on the USB relay
sudo sainsmartrelay --on RELAY_NUMBER
For example to turn on the relay 1 we can use
sudo sainsmartrelay --on 1
To run on all the relays
sudo sainsmartrelay --on all
To turn off the USB relay 1
sudo sainsmartrelay --off 1
To run on all the relays
sudo sainsmartrelay --off all
To get the status of the relays
sudo sainsmartrelay --status
To get more help information
sudo sainsmartrelay --help
The Sainsmart card uses the FTDI FT245RL chip. This chip is controlled directly through the open source libFTDI library. No Kernel driver is needed. However on most Linux distributions, the ftdi_sio serial driver is automatically loaded when the FT245RL chip is detected. In order to grant the sainsmart software access to the card, the default driver needs to be unloaded:
rmmod ftdi_sio
To prevent automatic loading of the driver, add the following line to /etc/modprobe.d/blacklist.conf:
blacklist ftdi_sio
Both 4 and 8 channel versions are supported. However, there seems to be no way to automatically detect which version of the card is used. Therefore the number of relay channles can be configured in the configuration file.