搭配PC Windows系统使用

硬件连接

方式1：通过USB Type-C接口使用

方式2：通过USB 4PIN接口使用

软件设置

1. 下载Waveshare PC Monitor软件
2. 安装PCMonitor目录下的“K-Lite_Codec_Pack.exe”播放器驱动：

 ① 选择"Fresh install"

 ② 全部选择"Next"

 ③ 点击"Finsh"，驱动安装完成

3. 双击打开PCMonitor.exe软件，左上角显示“设备已连接”，右侧选择你喜欢的主题，点击“运行”即可显示。

Wallpaper动态壁纸（拓展应用）

1. 下载steam软件，安装Wallpaper Engine应用（应用需付费购买），打开Wallpaper Engine在“创意工坊”下载你喜欢的动态壁纸，右键选择“在资源管理器中打开”，在对应的文件夹中可以看到已下载的壁纸MP4文件。

2. 打开格式转换网址：https://video.online-convert.com/convert-to-mp4

①：导入已下载的壁纸MP4文件；
②：设置导出视频尺寸为480x480像素，设置调整大小处理为可拉伸；
③：点击开始，即可导出视频。

3. 将处理好的480x480分辨率视频，放置到PCMonitor\video\480x480这个文件路径下；
4. 打开PCMonitor.exe应用（如果已经开启，需重启生效）；
5. 点击“编辑主题”-> 添加“视频”控件 -> 导入“视频路径” -> 点击“保存主题”，命名为.theme文件格式；

6. 返回“首页”-> 点击“主题选择”-> 下拉框勾选对应的.theme文件 -> 点击“运行”即可显示。

自定义主题编辑

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

2. 设置“视频”控件：

第一次使用视频控件需要安装K-Lite驱动，参考#软件设置，只需要安装K-Lite驱动即可，其他操作如下：

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

3. 设置“图片”控件：

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

4. 设置“时钟”控件：

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

5. 设置“文字”控件：

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

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

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

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

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

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

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

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

9. 设置自定义数据：

注：此功能仅在RPi Monitor中才有。
程序中编写的自定义数据可以在上位机软件中交互，见下图（数据名称只能为ASCII字符，不能是中文）

搭配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)

获取系统硬盘使用率

资料

售后

联系人：陈工
EMAIL：2355742828@qq.com
电话：0755-83043099
QQ：2355742828
微信：扫下方二维码添加

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证

导航菜单

2.1inch-USB-Monitor

目录