• 打开树莓派终端，输入以下指令进入配置界面：
  

sudo raspi-config

• 选择Interfacing Options -> SPI -> Yes 开启SPI接口

• 继续进入配置界面：
  

sudo raspi-config

• 选择Interfacing Options -> I2C -> Yes 开启I2C接口

• 重启树莓派
  

sudo reboot

• 检查 /boot/config.txt，可以看到'dtparam=i2c_arm=on' 和 'dtparam=spi=on' 已被写入
  

more  /boot/config.txt

• 为了确保 SPI 没有被占用，建议其他的驱动覆盖暂时先关闭。可以使用 ls /dev/spi* 来检查 SPI 占用情况，终端输出 /dev/spidev0.0 和 /dev/spidev0.1 表示 SPI 情况正常

ls /dev/spi* 

安装库文件

• 安装库

sudo apt-get update
sudo apt-get install python3-pip
sudo apt-get install python3-pil
sudo apt-get install python3-numpy
sudo apt-get install python3-spidev

示例操作

• 下载示例程序

cd
wget https://files.waveshare.net/wiki/1.47inch%20Touch%20LCD/1.47inch_Touch_LCD_Demo_Pi.zip

• （可选，使用过解压指令可跳过这一步）安装解压环境

sudo apt-get install unzip

• 进入文件位置，执行解压指令
  

unzip 1.47inch_Touch_LCD_Demo_Pi.zip -d ./1.47inch_Touch_LCD

• 进入 Python 文件夹中

cd 1.47inch_Touch_LCD/Python

• 运行示例程序即可在屏幕上显示3张图片，显示完即进入画板功能

sudo python 1.47inch_Touch_LCD.py 

安装库文件

• 安装库

git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v

• 运行gpio -v会出现版本，如果没有出现说明安装出错
• 下载示例文件
• 进入文件目录，运行程序

示例操作

• 下载示例程序

cd
wget https://files.waveshare.net/wiki/1.47inch%20Touch%20LCD/1.47inch_Touch_LCD_Demo_Pi.zip

• （可选，使用过解压指令可跳过这一步）安装解压环境

sudo apt-get install unzip

• 进入文件位置，执行解压指令
  

unzip 1.47inch_Touch_LCD_Demo_Pi.zip -d ./1.47inch_Touch_LCD

• 进入 C 文件夹中

cd 1.47inch_Touch_LCD/C

• 清除编译文件，重新编译

sudo make clean
sudo make -j

• 编译成功，运行示例即可在屏幕上进行RGB刷屏，显示完即进入画板功能

sudo ./main

• 下载示例程序

• 解压示例文件，打开 Thonny

• 打开示例文件，路径为：1.47inch_Touch_LCD_Demo_Pico/Python/1.47inch_Touch_LCD.py

• 运行程序即可在屏幕上实现画板功能

• 若需上电自动运行程序，请将文件名修改为 main.py

下载和安装 Arduino IDE

• 点击访问Arduino官网，选择对应的系统和系统位数下载。
  
  
• 运行安装程序，全部默认安装即可。

安装 Arduino-ESP32

• ESP32相关主板在Arduino IDE使用，须先安装“Arduino-ESP32板”库
• 国内部分区域安装，一般推荐“离线安装”， 若离线安装失败，则使用“在线安装”
• 安装 Arduino-ESP32教程，详见：Arduino 板管理教程

安装库

• 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。
  对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
• 库安装教程，详见：Arduino 库管理教程

运行第一个Arduino程序

• 点击访问运行第一个Arduino程序

示例程序

lvgl_example

i2c_bus_init();         // 初始化I2C总线
spi_bus_init();         // 初始化SPI总线
display_init();          // 初始化显示屏驱动
touch_init();           // 初始化触摸屏控制器

brightness_init();       // 初始化背光亮度控制模块
brightness_set_level(20); // 设置当前亮度为20%（取值范围0-100）

lv_port_init();          // 初始化LVGL图形库运行环境（绑定硬件显示驱动）

if (lvgl_lock(-1)) {     // 获取图形库互斥锁（防止多线程并发访问）
    lv_demo_widgets();    // 初始化lv_demo
    lvgl_unlock();         // 释放图形库互斥锁
}

环境搭建

• 点击访问IDF环境搭建

示例程序

• 下载示例程序,并解压

lvgl_exampla

    i2c_bus_init(); // 初始化I2C
    spi_bus_init(); // 初始化SPI
    display_init(); // 初始化显示屏
    touch_init();   // 初始化触摸屏驱动
    brightness_init(); // 初始化背光控制模块
    brightness_set_level(20); // 设置背光亮度为20%（支持0-100级调节）
    lv_port_init(); // 初始化LVGL
    if (lvgl_lock(-1)) // 获取LVGL线程锁（-1表示阻塞等待），确保多线程安全
    {
        // lv_demo_benchmark();
        // lv_demo_music();
        lv_demo_widgets();  // 启动LVGL的Demo
        lvgl_unlock();  // 释放LVGL线程锁
    }

lvgl_brightness

    i2c_bus_init(); // 初始化I2C
    spi_bus_init(); // 初始化SPI
    display_init(); // 初始化显示屏
    touch_init();   // 初始化触摸屏驱动
    brightness_init(); // 初始化背光控制模块
    brightness_set_level(20); // 设置背光亮度为20%（支持0-100级调节）
    lv_port_init(); // 初始化LVGL
    if (lvgl_lock(-1)) // 获取LVGL线程锁（-1表示阻塞等待），确保多线程安全
    {
        // lv_demo_benchmark();
        // lv_demo_music();
        // lv_demo_widgets();
        lvgl_brightness_ui_init(lv_scr_act()); // 初始化ui
        lvgl_unlock();  // 释放LVGL线程锁
    }

• 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。
  对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
• 库安装教程，详见：Arduino 库管理教程

• 下载示例程序,并解压
• 进入示例文件 1.47inch_Touch_LCD_Demo_Arduino/1.47inch_Touch_LCD.ino 中，双击 1.47inch_Touch_LCD.ino 打开示例

• 选择设备与端口，编译并烧录程序

• 烧录成功进入画板功能