• sales

    +86-0755-88291180

RPi Tutorial Series: Infrared Remote Control User Guide

In this lesson, you will learn how to control your Raspberry Pi using a IR controller. You may have learned how to add a device to the device tree in Linux, and we are also going to add an IR receiver to the device tree.

sudo vi /boot/config.txt

and append

dtoverlay=lirc-rpi

This causes the file /boot/overlays/lirc-rpi-overlay.dtb to be loaded. By default it will use GPIOs 17 (out) and 18 (in). (Quote from /boot/overlay/README) Then please place the output pin of an IR receiver to the 18 pin (BCM numbering, use this command to check: gpio readall). Or if you are using the expension board Pioneer600, the output pin of IR receiver is connected to the 18 pin (input pin on Pi) by default. You can specify a pin on your Pi as IR input using DT (Device Tree) parameters, just append gpio_in_pin, followed by the pin number, to the dtoverlay=lirc-rpi line:

dtoverlay=lirc-rpi,gpio_in_pin=18

Just an example, gpio_in_pin=18 is a verbose declaration because the GPIO 18 has set to input by default already. Then install the lirc software:

sudo apt-get install lirc

and you will find the lirc_rpi device with lsmod command.

lsmod | grep lirc

You get:


If everything works, you can use the mode2 command to check the IR waveform:

sudo mode2 -d /dev/lirc0

Press the button on a remote controller aiming the IR receiver, and a certain pulse signals will be printed in the terminal, like:

space ...
pulse ...
...

The pulse signal from the infrared remote controller complies with the NEC standard. The infrared remote receiver outputs the pulse to the Pin 18 of the BCM after relative signal received. Then, the Raspberry Pi reads the pulse from the Pin 18 and decodes it.

Infrared NEC protocol coding description




Data format: Address, ~(Address), Command, ~(Command)

~(Address): bit-wise complement of Address. ~(Command): bit-wise complement of Command

Both address and command are in a format of 8 bits, so a complete signal is in 32 bits.

Start signal is composed with a 9 ms leading space and a 4.5 ms pulse and it is followed by 4 bytes, they are

  1. an 8-bit ADDRESS for receiving
  2. an 8-bit logical inverse of the ADDRESS
  3. an 8-bit COMMAND
  4. an 8-bit logical inverse of the COMMAND

The Logic '0' and '1' are expressed as:

  • Logic '0' == 0.56 ms LOW and 0.56 ms HIGH
  • Logic '1' == 0.56 ms LOW and 0.169 ms HIGH

The controller sends data only once and then only repeat pulse will be sent. Therefore, if you want to send data again, you should release the button and press it again, rather than keep pressing the button.

Demo Code

Python

#!/usr/bin/python
# -*- coding:utf-8 -*-
import RPi.GPIO as GPIO
import time
ERROR = 0xFE
PIN = 18
GPIO.setmode(GPIO.BCM)
GPIO.setup(PIN, GPIO.IN, GPIO.PUD_UP)

def getKey():
    byte = [0, 0, 0, 0];
    if IRStart() == False:
        time.sleep(0.11);        # One message frame lasts 108 ms.
        return ERROR;
    else:
        for i in range(0, 4):
                byte[i] = getByte();
        # Start signal is followed by 4 bytes:
        # byte[0] is an 8-bit ADDRESS for receiving
        # byte[1] is an 8-bit logical inverse of the ADDRESS
        # byte[2] is an 8-bit COMMAND
        # byte[3] is an 8-bit logical inverse of the COMMAND
        if byte[0] + byte[1] == 0xff and byte[2] + byte[3] == 0xff:
            return byte[2];
        else:
            return ERROR;
def IRStart():
    timeFallingEdge = [0, 0];
    timeRisingEdge = 0;
    timeSpan = [0, 0];
    GPIO.wait_for_edge(PIN, GPIO.FALLING);
    timeFallingEdge[0] = time.time();
    GPIO.wait_for_edge(PIN, GPIO.RISING);
    timeRisingEdge = time.time();
    GPIO.wait_for_edge(PIN, GPIO.FALLING);
    timeFallingEdge[1] = time.time();
    timeSpan[0] = timeRisingEdge - timeFallingEdge[0];
    timeSpan[1] = timeFallingEdge[1] - timeRisingEdge;
    # Start signal is composed with a 9 ms leading space and a 4.5 ms pulse.
    if timeSpan[0] > 0.0085 and \
       timeSpan[0] < 0.0095 and \
       timeSpan[1] > 0.004 and \
       timeSpan[1] < 0.005:
        return True;
    else:
        return False;
def getByte():
    byte = 0;
    timeRisingEdge = 0;
    timeFallingEdge = 0;
    timeSpan = 0;
    # Logic '0' == 0.56 ms LOW and 0.56 ms HIGH
    # Logic '1' == 0.56 ms LOW and 0.169 ms HIGH
    for i in range(0, 8):
        GPIO.wait_for_edge(PIN, GPIO.RISING);
        timeRisingEdge = time.time();
        GPIO.wait_for_edge(PIN, GPIO.FALLING);
        timeFallingEdge = time.time();
        timeSpan = timeFallingEdge - timeRisingEdge;
        if timeSpan > 0.0016 and timeSpan < 0.0018:
            byte |= 1 << i;
    return byte;
print('IRM Test Start ...')
try:
    while True:
        key = getKey();
        if(key != ERROR):
            print("Get the key: 0x%02x" %key)
except KeyboardInterrupt:
    GPIO.cleanup();

Save the code as "irm.py" and run with:

sudo python irm.py
TAG: 15.6 inch Dual LCD Computer PC Monitor Display Double Secondary Screen Type C Mini HDMI 1080P For Windows/MacOS Raspberry Pi AI Camera Official Original 12MP IMX500 Intelligent visual Sensor On-Board RP2040 Raspberry Pi Pico 2 RP2350 1.28 inch Round LCD TouchScreen Development Board 240x240 Display QMI8658 6-Axis $17.9 Raspberry Pi PICO 0.96inch RGB OLED Industrial Isolated RS485 TO ETH (C) RJ45 Converter Wall/Rail-Mount For Modbus ADXL356BEZ ESP32-S3 AI Electronic Eye Development Doard DualEye TouchEye 1.28 inch TouchScreen LCD Round Display N16R8 Toy Doll Robot Jetson Nano Development Kit JETSON-NANO-DEV-KIT Replace For Jetson-Nano-Developer-Kit-B01 Raspberry Pi Autofocus Camera PCB800099 Screen FT232RNL USB TO TTL Industrial UART Can For Raspberry Pi 5 Terminal Debug RS232 to RJ45 ESP32 IR Thermal Imaging Camera Changeable Photo i5-1135G7 STM32 0.96inch RGB OLED Modbus-Protocol-Specification User Guide CH340 driver