RPi-USB-Monitor

来自Waveshare Wiki
跳转至: 导航搜索

搭配Raspberry Pi Bookworm系统使用

支持树莓派最新的Raspberry Pi Bookworm 64位系统使用:
由于默认出货是Windows PC使用的镜像文件,需按以下操作进行烧录RPi专用镜像!

RPi-USB-Monitor镜像烧录

1. 点击并下载2.1inch-USB-Monitor-RPi镜像
2. 将压缩文件下载到PC上,并解压得到.img文件
3. 将屏幕卡槽内的TF卡取出,连接到PC,使用SDFormatter软件格式化TF卡
4. 打开Win32DiskImager软件,选择第1步准备的系统镜像,点击write烧写系统镜像
5. 烧写完成后,将TF卡插入屏幕卡槽内
6. 使用USB线材,将屏幕的Type-C接口连接到树莓派的USB接口
7. 给树莓派上电,正常等待几秒后即可看到屏幕亮起LOGO图案,代表镜像烧录成功

运行Python例程

  • 安装函数库
sudo apt-get install libqt5serialport5 
sudo apt-get install libqt5serialport5-dev -y
  • 运行示例程序
wget https://www.waveshare.net/w/upload/2/27/2.1inch_USB_Monitor_RPi.zip
unzip 2.1inch_USB_Monitor_RPi.zip
cd 2.1inch_USB_Monitor_RPi/Demo/
sudo python main.py

设置自启动

sudo mkdir .config/autostart
sudo nano .config/autostart/local.desktop
#在文件中加入以下内容
[Desktop Entry]
Type=Application
Exec=python /home/pi/2.1inch_USB_Monitor_RPi/Demo/main.py t
# /home/pi/2.1inch_USB_Monitor_RPi/Demo/是绝对路径,需要改成自己存放的位置,否则将无法自启动

显示自定义界面

  • 1. 下载Waveshare RPi Monitor软件
  • 2. 制作主题/视频/图片,上位机的具体使用见 #自定义主题编辑
  • 3. 将main.py里初始化变量修改成上位机的软件设置。有关代码的更多介绍请#例程功能解析
  • 4. 将制作好的主题/视频/图片,复制到程序对应的文件夹中,比如:制作好的主题必须放置在2.1inch_USB_Monitor_B\Demo\theme\480x480路径下,如果不放在此路径,将无法读取。
  • 5. 在终端运行程序

例程功能解析

  • 1. 我们提供的Demo内设置了5种功能,分别是:
#显示主题
python main.py x    (x可以是t/T/theme/THEME,四选一即可)
#显示视频
python main.py x    (x可以是m/M/mp4/MP4,四选一即可)
#显示图片
python main.py x    (x可以是p/P/png/PNG,四选一即可)
#显示主题、视频和图片
python main.py x    (x可以是a/A/all/ALL,四选一即可)
#删除指定文件
python main.py x    (x可以是d/D/del/DEL,四选一即可)

#如果输入错误,将自动退出程序,请重新运行程序

主函数参数介绍

参数 功能
System_path 设置用户路径
NETWORK 设置测速网卡
GET_SYSTEM_DATA 是否获取系统数据,True获取,Flase不获取
ROTATE 设置屏幕翻转 1:翻转180度 0:不翻转
BACKLIGHT 设置亮度,0为最暗,255为最亮
Monitor_Is12hour 0:24小时制 1:12小时制
Monitor_Language 0:中文 1:英文(这里的语言设置需要跟上位机制作主题时使用的一致,否则会显示异常)
Monitor_WeatherTempUnit 0:摄氏度 1:华氏度
Project_path 存放位置的绝对路径
File_num 循环显示的数量

函数库介绍

Monitor.py

变量介绍

  • Custom_data_num 自定义数据的数量
  • Custom_data 创建文件指针的数量,用来保存自定义数据的名称(不能为中文,只能为ASCII字符)

接口介绍

  • def __init__(self,SYSTEM_PATH,NETWORK,GET_SYSTEM_DATA,IS12HOUR,LANGUAGE,WEATHERTEMPUNIT)

初始化

SYSTEM_PATH 设置用户路径 
NETWORK 设置测速网卡
GET_SYSTEM_DATA 是否获取系统数据 
IS12HOUR 设置时间表示法(0:24小时制 1:12小时制)
LANGUAGE 设置中英文(0:中文 1:英文,语言设置需要跟上位机制作主题时使用的一致,否则会显示异常)
WEATHERTEMPUNIT 设置温度表示法(0:摄氏度 1:华氏度)
  • def SetRootDir(self,rootDir)

python环境需要设置脚本所在目录

 rootDir 为所在目录
  • def SendSystemData(self,key,buff,num)

发送自定义数据给屏幕

key 准备发送系统数据的名字
buff 准备发送系统数据的值
num 自定义数据的数量
  • def Delete(self)

删除指定资源

  • def Download(self,files,num,time,rotate,backlight)

下载指定资源到屏幕中并显示

files:文件所在路径
num:文件总个数
time:循环显示时间间隔
rotate:显示角度,0°或180°
r:屏幕背光 0~255
  • def start(self)

开定时器,用于发送系统参数

  • def handle_interrupt(self)

定时器回调

Gain_Param.py

  • def GET_IP(self)

获取IP

  • def GET_Temp(self)

获取温度

  • def net_speed(self,interface, is_download)

获取网速

  • def RX_speed(self,network)

获取当前下载速度

  • def TX_speed(self,network)

获取当前上传速度

  • def GET_CPU_Used(self)

获取CPU使用率

  • def GET_Memory_Percentage(self)

获取运行内存

  • def GET_System_Disk_Used(self)

获取系统硬盘使用率