避坑指南：在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-essential

2.2 获取WiringPi源码

官方仓库已经归档，我们需要使用最终发布的2.50版本：

git clone --branch final_official_2.50 https://github.com/WiringPi/WiringPi.git cd WiringPi

2.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 ldconfig

3.2 验证头文件位置

确认wiringPi.h确实存在于标准包含路径中：

find /usr -name wiringPi.h

4. 系统配置优化

为了确保长期稳定性，建议进行以下系统级配置：

4.1 固定WiringPi版本

防止后续系统更新覆盖手动安装的版本：

sudo apt-mark hold wiringpi

4.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版本信息

我在多个树莓派项目中使用这套解决方案，发现最关键的还是确保开发环境的一致性。建议团队开发时建立标准化的环境配置文档，避免每个成员都踩同样的坑。

避坑指南：在Ubuntu for Raspberry上安装OpenPLC运行时，搞定WiringPi.h报错