• sales

    +86-0755-88291180

Raspberry Pi Relay Board (B) User Guide

Introduction

We provide Raspberry Pi and Jetson Nano demo for this module

Interface introduce

The correspondence between relay channels and Pi pins:

Channel numberRPi pin numberwiringPiBCMDescription
Channel label29P215Channel 1
Channel label31P226Channel 2
Channel label33P2313Channel 3
Channel label36P2716Channel 4
Channel label35P2419Channel 5
Channel label38P2820Channel 6
Channel label40P2921Channel 7
Channel label37P2526Channel 8

【Note】The silk screen marking on the PCB corresponds to the BCM code.

The use of yellow jumpers

Relay_JMP is the relay control pin selection jumpers. When the jumpers are connected, the Raspberry Pi can be used to control the relays.

Using with Raspberry Pi

Install library

PS: If you are using the system of the Bullseye branch, you need to change "apt-get" to "apt", the system of the Bullseye branch only supports Python3.

BCM2835

# Open the Raspberry Pi terminal and run the following commands
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.68.tar.gz
tar zxvf bcm2835-1.68.tar.gz
cd bcm2835-1.68/
sudo ./configure && sudo make && sudo make check && sudo make install
# For more information, please refer to the official website: http://www.airspayce.com/mikem/bcm2835/

WiringPi

# Open the Raspberry Pi terminal and run the following commands
sudo apt-get install wiringpi
#For Raspberry Pi systems after May 2019 (If your system is earlier than this before, you may not need to execute), you may need to upgrade:
wget https://project-downloads.drogon.net/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb
gpio -v
# Run gpio -v and version 2.52 will appear. If it does not appear, the installation is wrong

# Bullseye branch system use the following command:
git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v
# Run gpio -v and version 2.60 will appear. If it does not appear, it means that there is an installation error

Python

# python2
sudo apt-get update
sudo apt-get install python-pip
sudo pip install RPi.GPIO
# python3
sudo apt-get update
sudo apt-get install python3-pip
sudo pip3 install RPi.GPIO

Test demo

Execute the following commands on the terminal, download the demo and extract it to the specified directory

wget https://www.waveshare.com/w/upload/b/b4/RPi_Relay_Board_B.zip
unzip -o RPi_Relay_Board_B.zip -d ./RPi_Relay_Board_B
sudo chmod 777 -R RPi_Relay_Board_B
cd RPi_Relay_Board_B/RaspberryPi/

BCM2835 demo

Enter the Linux terminal and execute the following command in the terminal:

cd bcm2835
make
sudo ./Relay_demo

Expected result: The relays on the module are closed in turn, and then disconnected in turn. Each relay has a corresponding indicator light, which can be known by observing the status of the indicator light. When the user wants to stop running the program, press Ctrl+C to stop the running of the program

WiringPi demo

Enter the Linux terminal and execute the following command in the terminal:

cd wiringPi
make
sudo ./Relay_demo

Expected result: The relays on the module are closed in turn, and then disconnected in turn. Each relay has a corresponding indicator light, which can be known by observing the status of the indicator light. When the user wants to stop running the program, press Ctrl+C to stop the running of the program

Python demo

Enter the Linux terminal and execute the following command in the terminal:

cd python
sudo python Relay_demo.py

Expected result: The relays on the module are closed in turn, and then disconnected in turn. Each relay has a corresponding indicator light, which can be known by observing the status of the indicator light. When the user wants to stop running the program, press Ctrl+C to stop the running of the program

Web control

The web page control of this demo is based on the python web framework to control the relay.
Enter the Linux terminal and execute the following command in the terminal:

sudo apt-get install python-bottle
cd python-bottle
sudo python main.py

Enter the IP address of the Raspberry Pi in the address bar of Google Chrome (other browsers may not be compatible), port number 8080

Using with Jetson nano

Install library

sudo apt-get update
sudo apt-get install python3-pip
sudo pip3 install Jetson.GPIO
sudo groupadd -f -r gpio
sudo usermod -a -G gpio your_user_name
sudo cp /opt/nvidia/jetson-gpio/etc/99-gpio.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

Test demo

Download the program and enter the specified directory

sudo apt-get install p7zip
wget https://www.waveshare.com/w/upload/c/c2/RPi_Relay_Board_B.7z
7zr x RPi_Relay_Board_B.7z -r -o./RPi_Relay_Board_B
sudo chmod 777 -R RPi_Relay_Board_B
cd RPi_Relay_Board_B/JetsonNano/

C demo

Enter the Linux terminal and execute the following command in the terminal:

cd C
make
sudo ./main

Expected result: The relays on the module are closed in turn, and then disconnected in turn. Each relay has a corresponding indicator light, which can be known by observing the status of the indicator light. When the user wants to stop running the program, press Ctrl+C to stop the running of the program

Python demo

Enter the Linux terminal and execute the following command in the terminal:

cd python
sudo python relay_demo.py

Expected result: The relays on the module are closed in turn, and then disconnected in turn. Each relay has a corresponding indicator light, which can be known by observing the status of the indicator light. When the user wants to stop running the program, press Ctrl+C to stop the running of the program

Web control

The web page control of this demo is based on the python web framework to control the relay.
Enter the Linux terminal and execute the following command in the terminal:

sudo apt-get install python-bottle
cd python-bottle
sudo python main.py

Enter the IP address of the Raspberry Pi in the address bar of Google Chrome (other browsers may not be compatible), port number 8080

TAG: Pi5 Case Modbus POE ETH Relay MQTT User Guide Raspberry Pi 5 Raspberry-Pi-Pico-W-webserver Raspberry Pi 5 5V5A DeepSeek XiaoZhi AI Voice Chat Robot BOX ESP32-S3 Development Board 1.28 inch Round LCD 1.28inch TouchScreen N16R8 ESP32-S3 AI 1.54-inch e-Paper Ink Screen 1.54inch Display AIoT Development Board Deepseek Raspberry Pi Game Allwinner UGV Rover PT Kit AI OpenCV Robot Car MediaPipe For Jetson Orin EVAL-ADXL354CZ Raspberry Pi 5 27W Raspberry Pi 10.1 inch DSI LCD TouchScreen Display 800x1280 Also For RK3576/RK3506/ESP32-P4 Raspberry Pi Pico 2 W RP2350 Pico2W ARM Cortex-M33 And RISC-V Hazard3 Wi-Fi4 Bluetooth5.2 CYW43439 Raspberry Pi Starlight Camera IR-CUT IMX462 (A) Sensor 2MP 90 Degree ADXL356BEZ Raspberry Pi Prism ESP32-S3 7inch LCD Display 7 inch TouchScreen 7B 1024×600 N16R8 CAN RS485 Sensor DeepSeek AI Voice Chat ESP32 S3 Development Board 1.8 inch AMOLED Display 368×448 1.8inch TouchScreen Programmable Watch QMI8658 /MIC /Audio /Battery Install Espressif IDF Plugin Tutorial User Guide