跳到主要内容

树莓派开发

请注意

本教程以 Raspberry Pi 4 为例,介绍模块的硬件连接,以及 Python 和 C 示例的运行方法。

硬件连接​

使用 15PIN 杜邦线按照下表连接模块与树莓派:

LCD 引脚树莓派(BCM)
VCCNC
3V33V3
GNDGND
MISOGPIO 9
MOSIGPIO 10
SCLKGPIO 11
LCD_CSGPIO 8
SD_CSNC
LCD_DCGPIO 25
LCD_RSTGPIO 27
LCD_BLGPIO 18
TP_SDAGPIO 2
TP_SCLGPIO 3
TP_INTGPIO 4
TP_RSTGPIO 17

开启 SPI 和 I2C 接口​

  1. 在终端中运行配置工具:

    sudo raspi-config

    在配置界面中选择 "Interface Options":

    树莓派配置界面的 Interface Options 选项

  2. 选择 "SPI",然后选择 "Yes" 开启 SPI 接口:

    树莓派配置界面的 SPI 选项

    确认开启树莓派 SPI 接口

  3. 再次进入 "Interface Options",选择 "I2C",然后选择 "Yes" 开启 I2C 接口:

    树莓派配置界面的 I2C 选项

    确认开启树莓派 I2C 接口

    不同 Raspberry Pi OS 版本中的菜单名称可能略有不同。

  4. 重启树莓派:

    sudo reboot
  5. 重启后检查配置:

    more /boot/config.txt

    正常情况下,可看到 dtparam=spi=on 和 dtparam=i2c_arm=on:

    树莓派 SPI 和 I2C 接口配置检查结果

    /dev/spidev0.0 和 /dev/spidev0.1 表示 SPI 设备节点已生成:

    树莓派 SPI 设备节点检查结果

Python 示例​

  1. 安装运行环境:

    sudo apt update
    sudo apt install -y python3-pip python3-pil python3-numpy python3-spidev unzip
  2. 下载并解压示例程序:

    cd ~
    wget https://www.waveshare.net/w/upload/a/af/2inch_Capacitive_Touch_LCD_Demo_Pi.zip
    unzip 2inch_Capacitive_Touch_LCD_Demo_Pi.zip -d 2inch_Capacitive_Touch_LCD
  3. 运行示例:

    cd ~/2inch_Capacitive_Touch_LCD/Python
    python3 2inch_Capacitive_Touch_LCD.py

程序会依次显示 3 张图片,随后进入触控画板界面。

C 示例​

  1. 安装 WiringPi:

    git clone https://github.com/WiringPi/WiringPi
    cd WiringPi
    ./build
    gpio -v
  2. 如果尚未下载示例程序,请按照 Python 示例 中的下载步骤获取程序包。

  3. 编译并运行示例:

    cd ~/2inch_Capacitive_Touch_LCD/C
    sudo make clean
    sudo make -j
    sudo ./main

程序会进行 RGB 颜色循环测试,随后进入触控画板界面。