Skip to content

Latest commit

 

History

History
133 lines (95 loc) · 5.73 KB

读我DúWǒ.md

File metadata and controls

133 lines (95 loc) · 5.73 KB
Raw

DoxBox - ⚡️比特币闪电网络照片盒

DoxBox 通过其 LNbits 钱包接收比特币闪电支付来打印捕获的照片。 你可以在任何婚礼、会议、聚会或节日上设置它。我们以模块化的方式构建它，以便你可以轻松地随身携带。

硬件要求

  • Raspberry Pi 4 运行基于 Debian 的操作系统 可从 Raspberry Pi 官方软件页面获取。
  • DSLR 相机：Canon EOS 450D，至少需要 1GB 的 SD 卡。如果使用其他相机，请确保在官网上与 gphoto2 兼容。
  • 显示器：Waveshare 10.4 英寸 QLED 量子点电容显示屏（1600 x 720）。
  • 打印机：Xiaomi Instant Photo Printer 1S，支持 CUPS 打印系统，6 英寸照片纸。
  • LED：4 通道 RGB LED 条，包括面包板、连接电缆和 4 个 Mosfets 控制器。
  • 建筑材料：三块 80x80cm 的胶合板；如果可能，使用激光切割器会更好。
  • 组装硬件：20 套角落磁铁（每套 2 个），40 个 4mm 直径的螺丝和 120 个 4mm 直径的螺帽来固定组件。
  • 喷涂颜色：1 罐底漆，4 罐实际颜色。

示例程序流程：

设置说明

关键组件

  • main.py：作为应用程序的入口点，根据操作模式协调各个组件的执行。
  • app.py：管理应用程序的图形用户界面 (GUI)，促进用户互动和信息显示。
  • switch.py：处理外部 API 交互并基于接收到的数据执行特定操作，如触发其他应用程序组件。
  • img_capture.py：与相机交互以捕获图像，下载图像并管理文件存储，利用 gphoto2。
  • print.py (进行中)：使用 CUPS 与打印机接口打印图像，具有选择打印机和管理打印任务的功能。
  • config.py：包含整个应用程序使用的配置设置，如 API 密钥、设备名称和文件路径。

安装

  1. 克隆仓库：首先克隆此仓库。

    git clone https://github.com/j0sh21/DoxBox.git

  2. 安装依赖：确保系统上安装了 Python，安装所需的 Python 包。

    pip install -r requirements.txt

    注意：某些组件可能需要额外的系统级依赖（例如，gphoto2, CUPS）。

    • 如果你想自动安装额外的系统级依赖，请运行 install.sh： 
      cd DoxBox/install
chmod u+x install.sh
./install.sh

  3. 配置：查看并更新 config/cfg.ini 中的特定设置，例如设备名称、API 密钥和文件路径。

    nano cfg.ini

使用方法

要运行应用程序，请导航到项目目录并执行 main.py：

python3 main.py

对于特定功能，例如捕获图像或打印，你可以运行相应的脚本（例如，对于图像捕获运行 python img_capture.py）。 示例用法

捕获图像 确保你的相机已连接并被系统识别，然后运行：

python3 img_capture.py

打印图像：使用打印机的名称和图像文件路径更新 print.py，然后执行：

python print.py

DoxBox 项目更新日志

版本 0.1，2024年2月25日发布

功能

  • 更新了 app.py 以使用新框架和新 GIF。
  • 集成了来自 @arbadacarbaYK 的新 GIF，去除了空白背景框架和水印。倒计时 GIF 现在在数字之间有一致的时间间隔。
  • 添加了 self.isreplay 来仅一次重置 GIF 循环计数。
  • 将 switch.py 中的新错误代码引入了英语、德语和葡萄牙语文档。
  • 实现了新的状态 3.5：第一个笑脸 GIF 完成后过渡到 img_capture.py。
  • 实现了新的状态 3.9：照片成功从相机传输，开始准备打印。
  • 提前触发状态 4：在照片从相机删除之前开始打印。
  • 在 img_capture.py 中重构了特定于相机的错误处理。
  • 引入了针对相机相关错误的最大重试次数和可变等待时间。

改进

  • 在轮询 LNbits API 之前增加了网络连接检查。
  • 增强并清理了控制台输出样式。
  • 为了更清洁的用户界面隐藏了鼠标光标。
  • 改善了日志消息的清晰度和细节。
  • 删除了损坏的文件并进行了一般清理。
  • 调整了 LED 效果以获得更好的视觉反馈。

修复

  • 更正了 def kill_process() 以确保适当的进程终止。
  • 修复了同时显示多个笑脸 GIF 的问题。
  • 解决了状态 204 在打印作业失败检查上可能无限挂起的问题。

基础设施

  • 为打印作业创建了一个输出文件夹。待办事项： 使用 os.mkdir 自动创建文件夹，而不是在仓库中包含一个空文件夹。
  • 待办事项： 微调 check_print_job_status 功能。

贡献

欢迎为项目做出贡献！请参阅贡献指南，了解如何提交拉取请求、报告问题或建议改进。

许可证

该项目根据 MIT 许可证授权 - 详情见 LICENSE 文件。 欢迎为该项目做出贡献！

致谢

特别感谢 Ben Arc 的 LNbits 以及本项目中也使用的所有外部库和工具的维护者。

⚡️ 如果你喜欢 DoxBox，请 打赏该项目 ⚡️