Bjorn项目RDP连接器与显示模块故障排查指南

问题背景

在部署Bjorn项目时，用户遇到了两个关键问题：一是RDP连接器无法创建必要的CSV文件，二是Waveshare V2显示屏无法正常工作。这些问题直接影响到了项目的核心功能实现。

RDP连接器文件创建失败分析

系统日志显示，Python脚本尝试在/home/bjorn/Bjorn/data/output/crackedpwd/目录下创建rdp.csv文件时失败，报错"FileNotFoundError"。这通常表明目标目录结构不存在。

根本原因

项目初始化时未能自动创建完整的数据目录结构，特别是/output/crackedpwd/子目录缺失。这是项目早期版本的一个已知配置问题，开发者后来通过添加.gitkeep文件来确保空目录的正确创建。

解决方案

1. 手动创建目录结构：

mkdir -p /home/bjorn/Bjorn/data/output/crackedpwd
mkdir -p /home/bjorn/Bjorn/data/logs

2. 权限设置： 确保Bjorn服务运行用户(bjorn)对数据目录有写权限：

chown -R bjorn:bjorn /home/bjorn/Bjorn/data

3. 自动修复： 更新到最新项目版本，其中已包含完整的目录结构和.gitkeep占位文件。

显示屏驱动问题排查

用户报告Waveshare V2显示屏不工作，同时手动运行时出现GPIO占用错误。

问题诊断

1. GPIO冲突：系统服务已在后台运行，占用了GPIO资源
2. 显示驱动配置错误：默认配置可能针对不同型号的显示屏

解决方案

1. 检查服务状态：

sudo systemctl status bjorn.service

2. 修改显示配置： 编辑配置文件/home/bjorn/Bjorn/config/shared_config.json，将显示类型改为对应型号：

"epd_type": "epd2in13_V2"

3. 重启服务：

sudo systemctl restart bjorn.service

4. 解决GPIO冲突： 确保没有其他进程占用GPIO，必要时重启设备。

最佳实践建议

1. 部署前检查：

• 验证所有依赖目录是否存在
• 确认硬件型号与配置匹配

2. 日志监控： 定期检查系统日志和服务日志，可帮助早期发现问题：

journalctl -u bjorn.service -f

3. 测试流程：

• 先手动运行验证基本功能
• 确认无误后再部署为系统服务

4. 硬件兼容性： 对于不同型号的Waveshare显示屏，务必在配置文件中指定正确的驱动类型。常见选项包括：

• epd2in13_V2
• epd2in13_V3
• epd2in13_V4

总结

Bjorn项目在部署过程中遇到的这些问题主要源于初始配置不完整和硬件适配问题。通过创建缺失的目录结构和正确配置显示驱动，可以顺利解决这些问题。建议用户在部署前仔细阅读硬件要求，并在遇到问题时首先检查日志输出，这通常能提供明确的错误线索。