Earthsoft PT3 驱动程序技术文档

1. 安装指南

Earthsoft PT3 驱动程序遵循 GPLv3 许可。在开始安装之前，请确保阅读并理解 COPYING 文件中的许可内容。

安装步骤

• 确保您的系统具有编译内核模块所需的开发工具和头文件。
• 从源代码目录执行 make 命令编译驱动程序。
• 使用 sudo make install 命令安装编译好的驱动模块。

注意事项

• 如果系统内核版本发生变化，可能需要重新安装 PT3 �动程序。可以使用 DKMS (Dynamic Kernel Module Support)来自动化这一过程。本项目包含了 dkms.install 脚本以简化 DKMS 的配置。
• 如果您希望停用 DKMS，本项目也提供了 dkms.uninstall 脚本。

2. 项目使用说明

本驱动程序提供了几个参数以调整其行为。

• lnb 参数用于指定 LNB 的默认值：

  • 0: 关闭（默认）
  • 1: 11V
  • 2: 15V

• lnb_force 参数决定是否始终使用 lnb 参数指定的值：

  • 0: 无效（默认）
  • 1: 有效。在此模式下，无法通过 ioctrl 进行控制。

• debug 参数用于控制调试信息的显示：

  • 0: 尽可能不显示（默认）
  • 1: 显示与 pt1 相同级别的信息
  • 7: 显示完整的调试信息

调试信息也可以通过 /sys/module/pt3_drv/parameters/debug 进行调整，例如：echo 7 > /sys/module/pt3_drv/parameters/debug。

3. 项目API使用文档

本项目不直接提供 API 文档，因为它是一个内核模块，通常通过系统调用和特定的接口与用户空间程序交互。用户需要根据模块提供的接口和功能，在用户空间程序中调用相应的系统调用或读写特定的设备文件来实现与内核模块的交互。

4. 项目安装方式

DKMS的启用

要启用 DKMS，请首先执行 sudo make install 命令安装驱动程序，然后在 shell 环境中运行 dkms.install 脚本。例如：

sudo ${SHELL} ./dkms.install

DKMS的停用

要停用 DKMS，请在 shell 环境中运行 dkms.uninstall 脚本。

sudo ${SHELL} ./dkms.uninstall

故障排除

如果在 RaspberryPi 等设备上遇到 "fail create dma." 错误，无法加载驱动程序，请尝试在启动参数中将 coherent_pool 修改为大约 32MB。