想要一个低功耗、不刺眼且能实时显示加密货币价格的桌面摆件吗?通过树莓派(Raspberry Pi)和电子墨水屏(ePaper),你可以轻松构建一个个性化的行情显示器。该项目基于 Python 脚本运行,定期从 CoinGecko 获取数据并更新显示内容。
项目简介
这是一个运行在树莓派上的加密货币行情显示器项目,配合 Waveshare 2.7 英寸单色电子墨水屏使用。脚本默认每 5 分钟从 CoinGecko 获取一次数据,并将行情信息显示在电子墨水屏上。
你可以自定义需要监控的加密货币种类、计价货币单位以及使用的交易所数据。几分钟的设置就能让你拥有一个优雅而不突兀的桌面显示器,随时关注币价走势。
该项目支持 CoinGecko 平台上列出的所有加密货币、货币单位和交易所。
准备工作
在开始之前,请确保你的树莓派已连接到互联网,并已安装 pip 和 python3。本教程默认使用 Waveshare 2.7 英寸 ePaper V1 版本,如果你使用的是 V2 版本,请参考 btcticker.py 中的说明进行切换。
如果你使用无头模式运行树莓派,需要通过 ssh 连接到设备。
安装步骤
安装必要软件包
通过 SSH 连接到你的树莓派,更新并安装必要的软件包:
sudo apt-get update
sudo apt-get install -y python3-pip mc git libopenjp2-7
sudo apt-get install -y libatlas-base-dev python3-pil python3-numpy python3-matplotlib启用 SPI 接口
SPI 接口是连接电子墨水屏所必需的,使用以下命令启用(0=开启,1=关闭):
sudo raspi-config nonint do_spi 0克隆所需库
克隆 Waveshare 库和本项目代码:
cd ~
git clone https://github.com/waveshare/e-Paper
git clone https://github.com/veebch/btcticker.git配置项目
移动到 btcticker 目录,复制示例配置文件,并移动所需的 Waveshare 库文件:
cd btcticker
cp config_example.yaml config.yaml
cp -r ~/e-Paper/RaspberryPi_JetsonNano/python/lib/waveshare_epd .
rm -rf ~/e-Paper安装 Python 依赖
安装所需的 Python 模块:
python3 -m pip install -r requirements.txt设置开机自启动
为了让项目在树莓派启动时自动运行,需要设置 systemd 服务:
cat <
/etc/systemd/system/btcticker.service
[Unit]
Description=BTC Ticker
After=network.target
[Service]
ExecStart=/usr/bin/python3 /home/pi/btcticker/btcticker.py
WorkingDirectory=/home/pi/btcticker
StandardOutput=inherit
StandardError=inherit
Restart=always
User=pi
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl enable btcticker
sudo systemctl start btcticker个性化配置
编辑 config.yaml 文件来自定义你的显示器:
- coin: 设置要监控的加密货币(如:bitcoin、ethereum)
- currency: 设置计价货币(如:usd、eur、jpy)
- exchange: 指定数据来源的交易所
常见问题
电子墨水屏不显示内容怎么办?
首先检查 SPI 接口是否已正确启用,确认屏幕与树莓派的物理连接是否牢固。尝试重新运行安装步骤中的 SPI 启用命令,并重启设备。
如何更改数据刷新频率?
在 btcticker.py 文件中找到 sleep(300) 这行代码,将 300(5分钟)改为你想要的秒数。记得重启服务使更改生效。
支持哪些加密货币?
该项目支持 CoinGecko 平台上的所有加密货币,你可以在配置文件中指定任何在 CoinGecko 上列出的代币标识符。
显示内容出现乱码怎么办?
这通常是由于字体文件缺失或路径错误导致的。检查项目目录中的字体文件是否存在,并在配置文件中确认字体路径设置正确。
如何更换显示的语言?
默认显示英文内容,你可以在配置文件中修改显示文本,或者添加支持中文字体的配置来显示中文内容。
树莓派型号有要求吗?
该项目兼容树莓派 3、4 和 Zero 等常见型号,只要能够运行 Raspberry Pi OS 并具有足够的 GPIO 引脚来连接屏幕即可。
通过这个项目,你不仅可以实时关注加密货币行情,还能学习到树莓派编程、外设连接和自动化服务配置等有用技能。电子墨水屏的低功耗特性使得这个显示器可以长时间运行而不消耗太多电力,是数字资产爱好者的理想桌面伴侣。