Skip to content

Latest commit

 

History

History
122 lines (92 loc) · 5.11 KB

README-ZH.md

File metadata and controls

122 lines (92 loc) · 5.11 KB

FLY-TFT

English

这是FLY-TFT-V2的RPI驱动仓库

收到用户反馈，遇到电容触摸不可用的情况，请按照 FAQ 排查问题

1. 介绍

FLY-TFT-V2是一款基于st7796的TFT液晶屏，支持电容触摸与电阻触摸两种，分辨率320x480，使用SPI接口

支持设备：Raspberry Pi zreo 2、Raspberry Pi zreo 2W, Raspberry Pi 3B、Raspberry Pi 3B+、Raspberry Pi 4B、Raspberry Pi 5、Raspberry Pi CM4IO

  • Raspberry Pi zreo 2测试正常，Raspberry Pi zreo未测试

2. 系统安装

注意：树莓派使用的系统内核版本必须大于5.17.x, 执行命令uname -r查看内核版本

  • 使用 Raspberry Imager 安装最新的 MainsailOS
    1. 下载并安装 Raspberry Imager
    2. 打开Raspberry Imager
    3. 点击CHOOSE DEVICE
    4. 根据你的设备选择对应型号
    5. 点击CHOOSE OS
    6. 选择Other specific-purpose OS
    7. 选择3D printing
    8. 选择Mainsail OS
    9. 选择最新的版本。如果你的设置支持64位系统则选择rpi64
    10. 点击CHOOSE STORAGE
    11. 选择你的存储设备，比如SD卡
    12. 点击NEXT，等待安装完成

3. 驱动安装

  1. 安装FLY-TFT-V2驱动 
    git clone https://github.com/kluoyun/FLY-TFT.git
cd FLY-TFT
sudo chmod +x ./scripts/install.sh
./scripts/install.sh

4. 启用TFT显示

触摸需要启用I2C支持，对应配置为dtparam=i2c_arm=on

  1. 安装驱动后需要在config.txt文件中添加了 dtoverlay=fly-tft-v2 的覆盖层支持
  2. 打开 /boot/config.txt (bookworm系统为/boot/firmware/config.txt) 
    sudo nano /boot/config.txt
  3. 在文件末尾添加下面的配置 
     dtoverlay=fly-tft-v2
    • 默认屏幕为90度横屏显示，如果需要旋转屏幕请使用下面的配置
     dtoverlay=fly-tft-v2,r90  # 与默认方向一致，横向
 dtoverlay=fly-tft-v2,r270 # 270度横屏，横向(翻转)
 dtoverlay=fly-tft-v2,r0   # 0度竖屏，纵向
 dtoverlay=fly-tft-v2,r180 # 180度竖屏，纵向(翻转)
    • 只能添加任意一个配置，不能添加多个
    • 正常情况下，TFT的触摸方向会自动旋转跟随显示方向，无需修改系统内的触摸配置
  4. 添加到文件末尾后，执行命令 sudo reboot 重启系统

5. 使用TFT

  • 请确保硬件连接正确
  • 安装了驱动
  • 在/boot/config.txt (bookworm系统为/boot/firmware/config.txt)文件中添加了dtoverlay=fly-tft-v2 的覆盖层支持
  • 部分系统可能存在默认的fb0设备，FLY-TFT会被分配到fb1设备，需要修改配置文件使能fb1设备
  • 执行命令ls /dev/fb*查看设备，如果出现两个设备fb0和fb1，请执行下面的命令将fb1设备使能（默认是fb0）
  • 执行下面的命令修改默认配置为fb1设备 
    sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf

6. 使用KlipperScreen

  • MainsailOS默认没有安装KlipperScreen，需要手动安装
  • 请参考KlipperScreen或使用kiauh安装
  • 如果成功安装了KlipperScreen，且第5步骤已正确完成，此时应该已经显示了KlipperScreen界面

7. 所有可用配置

  • speed [需要参数]：设置TFT的最大SPI时钟频率，单位为Hz，默认96000000(如果出现严重花屏请适当降低该值)

    • 示例：dtoverlay=fly-tft-v2,speed=80000000

  • r0/r90/r180/r270 [可选][无需参数]：设置TFT的显示和触摸方向，默认为90度，可选值为0,90,180,270,(只能添加一个配置)

    • 示例：dtoverlay=fly-tft-v2,r90或dtoverlay=fly-tft-v2,r180

  • disable_touch [无需参数]：禁用TFT的触摸功能，默认为启用

    • 示例：dtoverlay=fly-tft-v2,disable_touch

  • invx,invy [无需参数]：设置TFT的触摸方向，invx为X方向翻转，invy为Y方向翻转

    • 示例：dtoverlay=fly-tft-v2,invx或dtoverlay=fly-tft-v2,invy或dtoverlay=fly-tft-v2,invx,invy

  • swapxy [无需参数]：设置TFT的触摸方向，X轴与Y轴互换，即横屏

    • 示例：dtoverlay=fly-tft-v2,swapxy

注意： 所有参数可以同时设置(可选参数只能选择一个设置)，多个参数之间用逗号隔开，多个参数只能在同一行

警告： 正常情况只有r0,r90,r180,r270四个参数使用，其他参数仅在特殊情况下使用，尤其是invx,invy,swapxy

  • 示例：dtoverlay=fly-tft-v2,speed=80000000,r270

8. 反馈

我们在最新的MainsailOS系统上测试通过，如果有问题欢迎通过Github Issues反馈。