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)
获取系统硬盘使用率