避坑指南：在Ubuntu for Raspberry上安装OpenPLC运行时，搞定WiringPi.h报错
避坑指南：在Ubuntu for Raspberry上安装OpenPLC运行时，搞定WiringPi.h报错
树莓派爱好者们常常喜欢尝试不同的操作系统，Ubuntu for Raspberry Pi凭借其稳定性和丰富的软件生态成为不少开发者的选择。然而，当你在树莓派上运行Ubuntu系统并尝试安装OpenPLC运行时，可能会遇到一个令人头疼的问题——编译过程中提示"WiringPi.h头文件缺失"。这个问题看似简单，却让不少开发者耗费数小时排查。本文将带你深入分析问题根源，并提供一套经过验证的解决方案。
1. 问题背景与诊断
OpenPLC作为一个开源PLC解决方案，其运行时环境需要与硬件底层交互，而WiringPi库正是实现树莓派GPIO控制的关键组件。当你在Raspberry Pi OS上安装OpenPLC时，一切都很顺利，因为官方系统对硬件支持最为完善。但在Ubuntu系统上，情况就变得复杂起来。
执行安装命令后，系统报错通常如下：
fatal error: wiringPi.h: No such file or directory这个错误的本质在于：
- Ubuntu的wiringpi软件包只包含运行时组件，不包含开发所需的头文件和静态库
- OpenPLC的编译过程需要完整的开发环境支持
- 官方安装脚本
background_installer.sh假设系统会安装完整的wiringpi开发包
提示：这个问题不仅影响OpenPLC，任何需要访问树莓派GPIO的开发项目在Ubuntu系统上都可能遇到类似情况
2. 解决方案：手动编译安装WiringPi
既然系统仓库提供的软件包不完整，我们就需要从源码构建WiringPi。以下是经过验证的完整步骤：
2.1 准备工作
首先确保系统已安装必要的构建工具：
sudo apt update sudo apt install git build-essential2.2 获取WiringPi源码
官方仓库已经归档，我们需要使用最终发布的2.50版本：
git clone --branch final_official_2.50 https://github.com/WiringPi/WiringPi.git cd WiringPi2.3 编译与安装
WiringPi提供了简单的构建脚本：
./build编译完成后，验证安装是否成功：
gpio -v如果看到版本信息输出，说明安装成功。此时系统中应该已经包含以下关键文件：
/usr/local/include/wiringPi.h/usr/local/lib/libwiringPi.so
3. 解决OpenPLC编译问题
完成WiringPi安装后，回到OpenPLC的安装目录，重新运行安装脚本：
cd ~/OpenPLC_v3 ./install.sh rpi这次编译应该能够顺利完成。如果仍然遇到问题，可以尝试以下额外步骤：
3.1 检查链接库路径
确保系统能够找到新安装的库：
sudo ldconfig3.2 验证头文件位置
确认wiringPi.h确实存在于标准包含路径中：
find /usr -name wiringPi.h4. 系统配置优化
为了确保长期稳定性，建议进行以下系统级配置：
4.1 固定WiringPi版本
防止后续系统更新覆盖手动安装的版本：
sudo apt-mark hold wiringpi4.2 环境变量设置
在某些情况下，可能需要明确指定库路径：
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH可以将这行添加到~/.bashrc文件中实现永久生效。
5. 替代方案评估
如果手动编译WiringPi仍然无法解决问题，可以考虑以下替代方案：
5.1 使用pigpio库
pigpio是另一个流行的GPIO访问库，OpenPLC也支持：
sudo apt install pigpio然后在OpenPLC硬件设置中选择"Raspberry Pi (pigpio)"选项。
5.2 容器化部署
考虑使用Docker容器来隔离环境依赖：
docker run -d --privileged --name openplc -p 8080:8080 thiagoralves/openplc-raspberry这种方法避免了系统库冲突问题，但牺牲了一些性能。
6. 深度技术解析
理解这个问题的本质有助于预防类似情况。Ubuntu for Raspberry Pi与Raspberry Pi OS的主要差异在于：
| 特性 | Raspberry Pi OS | Ubuntu for Raspberry Pi |
|---|---|---|
| 内核优化 | 专为树莓派优化 | 通用ARM优化 |
| 硬件支持 | 完整GPIO支持 | 基础GPIO支持 |
| 软件仓库 | 包含树莓派专用包 | 标准Ubuntu仓库 |
| 更新策略 | 跟随树莓派硬件 | 跟随Ubuntu发布周期 |
这种差异导致了一些树莓派专用软件在Ubuntu上需要额外配置才能正常工作。
7. 实际应用测试
完成安装后，建议运行一个简单的测试程序验证功能是否正常：
- 在OpenPLC Editor中创建一个新项目
- 添加一个简单的梯形图逻辑，例如：
- 当输入0.0为高电平时，输出0.0也为高电平
- 将程序上传到运行时
- 使用GPIO命令手动控制输入引脚：
gpio mode 0 in gpio mode 2 out gpio write 2 1 # 模拟输入信号 - 观察输出引脚状态变化
这种端到端的验证可以确保整个软件栈工作正常。
8. 性能调优建议
在Ubuntu系统上运行OpenPLC可能会遇到性能问题，以下调优措施值得尝试：
关闭不必要的系统服务：
sudo systemctl disable --now snapd.service sudo systemctl disable --now apt-daily-upgrade.timer调整CPU调度策略：
echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor增加交换空间（针对内存不足情况）：
sudo fallocate -l 1G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile
9. 长期维护策略
为了确保系统长期稳定运行，建议：
定期检查WiringPi库更新
备份关键配置文件：
sudo tar czvf openplc_backup.tar.gz /usr/local/lib/libwiring* /usr/local/include/wiring*监控系统日志中的GPIO相关错误：
journalctl -u openplc -f
10. 社区资源利用
遇到难以解决的问题时，可以求助于以下资源：
- OpenPLC官方论坛：https://openplc.discussion.community/
- WiringPi GitHub仓库的Issues页面
- 树莓派Ubuntu社区论坛
在寻求帮助时，提供以下信息会大大提高解决效率：
- 完整的错误日志
gpio -v输出uname -a输出- OpenPLC版本信息
我在多个树莓派项目中使用这套解决方案，发现最关键的还是确保开发环境的一致性。建议团队开发时建立标准化的环境配置文档，避免每个成员都踩同样的坑。