2.1inch-USB-Monitor-B

来自Waveshare Wiki
跳转至: 导航搜索
2.1inch-USB-Monitor-B
{{{name2}}}
{{{name3}}}
功能简介
特性 无特性,不解释
显示尺寸 2.1英寸
分辨率 480X480
' 无特性,不解释
' 无特性,不解释
接口 SPI

树莓派系统安装

目前此屏幕仅支持树莓派的Bookworm 64位系统。

请在树莓派官网下载最新版本的镜像。

1) 将压缩文件下载到PC上,并解压得到.img文件。
2) TF卡连接到PC,使用SDFormatter软件格式化TF卡。
3) 打开Win32DiskImager软件,选择第1步准备的系统镜像,点击write烧写系统镜像。
4) 烧写完成后,将TF卡插入树莓派。
5) 将2.1英寸屏幕通过type-C线连接到树莓派的USB接口。
6) 给树莓派上电,正常等待几秒后即可显示屏幕启动LOGO。

安装库

打开树莓派终端,输入以下指令安装对应的QT库

sudo apt-get install libqt5serialport5 
sudo apt-get install libqt5serialport5-dev -y

下载并运行例程

wget https://www.waveshare.net/w/upload/3/39/2.1inch_USB_Monitor_B.zip
unzip 2.1inch_USB_Monitor_B.zip
cd 2.1inch_USB_Monitor_B/Demo/
python main.py #如果需要使用sudo,注意需要在本地运行或VNC运行,无法在SSH运行

显示自定义界面

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

自定义主题编辑

1. 进入“编辑主题”界面:

2.8inch-USB-Monitor-02.png

2. 设置“视频”控件:

① 点击“+视频”,设定起始坐标(X,Y)和视频尺寸。
② 设定正确的视频路径,把制作好的视频文件放置到/video/480x480文件目录并选择。(PS:需要使用H264编码格式文件)
③ 点击保存,画布内会出现对应的视频预览效果。(如需修改,可以通过右键图层进行编辑)
例如,起始坐标设定为(0,0),视频尺寸设定为480x480,主题将呈现铺满效果。
2.8inch-USB-Monitor-03.png

3. 设置“图片”控件:

① 点击“+图片”,设定图片的中心坐标,默认设置值为居中摆放(240,240)。
② 设定正确的图片路径,需要把制作好的图片放置到/image/480x480文件目录并选择。
③ 点击保存,画布内会出现对应的图片预览效果。(如需修改,可以通过右键图层进行编辑)
2.8inch-USB-Monitor-04.png

4. 设置“时钟”控件:

① 点击“+时钟”,将“时”“分”“秒”对应的图片,放置到/image/480x480文件目录并选择。
② 设置好三个指针图片的坐标相对位置,围绕中心原点旋转。
③ 打开系统数据,分别设定为“时”“分”“秒”。
④ 系统数据最大值,“时”设为60,“分”和“秒”设定为60
2.8inch-USB-Monitor-05.png

5. 设置“文字”控件:

① 点击“+文字”,设定文字坐标位置(默认坐标为(240,240)中心放置,可通过鼠标任意拖动)
② 设置文字内容、前景色和字体,点击保存生效。
③ 勾选系统数据后,则显示对应的系统数据动态值。
2.8inch-USB-Monitor-06.png

6. 设置“圆形进度条”控件:

① 点击“+圆形进度条”,设定圆形的坐标、直径、圆弧宽度和圆弧间隔等基本参数。
② 设定颜色,支持三种渐变色展示。(也可显示同一颜色)
③ 设定圆弧起始和终止角度,控制展示方向和弧长。
④ 勾选系统数据并设置好数据上下限后,会将对应的系统数据换算为动态的圆环动态效果
2.8inch-USB-Monitor-07.png

7. 设置“矩形进度条”控件:

① 点击“+矩形进度条”,设定矩形的坐标、宽度、高度、圆角半径、边缘宽度等基本参数。
② 设定矩形边框、矩形背景色和内容前景色,支持前景渐变色展示。(不勾选则显示同一颜色)
③ ④ 勾选系统数据后,会将对应的系统数据换算为动态的矩形动态效果
2.8inch-USB-Monitor-08.png

8. 设置“音频圆形”控件:

① 点击“+音频圆形控件”,设定圆形坐标位置和直径基本参数。
② 音柱圆环宽度:所有音柱的载体,将显示在音频圆形的外环,
③ 音柱宽度:表示每个独立音柱的宽度值,建议值=7;
④ 音柱宽度间隔:表示每个独立音柱的间隔宽度值,建议值=2;
⑤ 音柱最大高度:表示每个独立音柱的显示最高值,建议值=50;
⑥ 显示方向:设定音柱圆环的转动方向,顺时针/逆时针可选;
⑦ 起始位置:设定音柱圆环的起始位置,上/下/左/右可选;
⑧ 音柱起始颜色:所有音柱颜色由渐变色产生,起始颜色代表首个独立音柱的渐变起始颜色;
⑨ 音柱结束颜色:所有音柱颜色由渐变色产生,结束颜色代表末尾独立音柱的渐变结束颜色;
⑩ 音柱圆环颜色:表示音频圆形的外环颜色;
⑪ 音频实线颜色:表示音频圆形的中间实线颜色;
⑫ 音频虚线颜色:表示音频圆形的内环实线颜色;
⑬ 起始频率:设定麦克风或者.wav文件频谱的起始频率;(频率范围1-20000)
⑭ 终止频率:设定麦克风或者.wav文件频谱的终止频率;(频率范围1-20000)
⑮ 麦克风增益:设定麦克风获取环境声输入信号的放大程度,控制对声音信号的灵敏度;(增益值范围0-31)
⑯ 音频路径:设定.wav音频文件的路径,仅在音频数据源为“wav file”时生效;
⑰ 音频数据源:设定圆形音频的声音信号数据来源

  • “randomNumbers”代表使用随机数据频谱
  • “audio mic”代表使用麦克风获取环境声频谱
  • “wav file”代表使用.wav音频文件频谱;

2.8inch-USB-Monitor-09.png

程序简介

  • 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,四选一即可)

#如果输入错误,将自动退出程序,请重新运行程序
  • 2. 需要手动设置的参数(默认参数只适用于Demo程序)
参数介绍
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:华氏度
File_num 循环显示的数量
  • 3. 设置开机自启动

在终端输入

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

函数接口介绍

Monitor.py
# rootDir 为所在目录
def SetRootDir(self,rootDir) #python环境需要设置脚本所在目录
# key:准备发送系统数据的名字
# buff:准备发送系统数据的值
# num:自定义数据的数量
def SendSystemData(self,key,buff,num)
# 删除指定资源
def Delete(self)
# 下载指定资源到屏幕中并显示
# files:文件所在路径
# num:文件总个数
# time:循环显示时间间隔
# rotate:显示角度,0°或180°
# backlight:屏幕背光 0~255
def Download(self,files,num,time,rotate,backlight)
#开定时器,用于发送系统参数
def start(self)
#定时器回调
def handle_interrupt(self)

Gain_Param.py
#看注释