DDC/CI 控制软件使用与技术文档

本文档将详细介绍如何安装、使用以及操作 DDC/CI 控制软件，帮助用户全面了解该软件的功能和应用。

1. 安装指南

DDC/CI 控制软件提供了多种安装方式，用户可以根据自己的操作系统选择最合适的安装方法。

1.1 使用官方软件包安装

最简便的安装方法是使用官方软件仓库中的软件包。以下是一些常见操作系统的安装命令：

• Ubuntu/Debian 系统中：

  sudo apt install ddccontrol gddccontrol ddccontrol-db i2c-tools
  

• Fedora 系统中：

  sudo dnf install ddccontrol ddccontrol-gtk
  

• openSUSE 系统中：

  sudo zypper in ddccontrol
  

安装 i2c-tools 后，可能需要重启系统。

1.2 从源代码安装

从源代码安装更加复杂，但可以获得最新版本和更多显示器配置文件。

• 安装构建依赖项（以下以 Ubuntu 系统为例）：

  sudo apt install intltool i2c-tools libxml2-dev libpci-dev libgtk2.0-dev liblzma-dev
  

• 克隆、构建和安装：

  git clone https://github.com/ddccontrol/ddccontrol.git
  cd ddccontrol
  ./autogen.sh
  ./configure --prefix=/usr/local/ --sysconfdir=/etc --libexecdir=/usr/local/lib
  make
  sudo make install
  

显示器数据库是软件正常运行所必需的，请参考 ddccontrol-db 安装指南。

2. 使用说明

DDC/CI 控制软件包括两个主要工具：命令行工具 ddccontrol 和图形界面工具 gddccontrol。

2.1 使用图形界面工具 gddccontrol

gddccontrol 是一个图形界面工具，用于配置显示器参数。在应用程序列表中，它被称为 Monitor Settings。

为了允许非 root 用户使用 gddccontrol，需要进行以下配置：

sudo adduser $USER i2c
sudo /bin/sh -c 'echo i2c-dev >> /etc/modules'

可以直接从命令行启动该工具：

sudo gddccontrol

2.2 使用命令行工具 ddccontrol

ddccontrol 允许用户直接从命令行配置显示器参数。以下是一些基本命令：

• 探测 I2C 设备以找到显示器总线：

  sudo ddccontrol -p
  

• 读取设备 dev:/dev/i2c-4 上控制 0x10（VESA 标准显示器亮度）的值：

  sudo ddccontrol -r 0x10 dev:/dev/i2c-4
  

• 将设备 dev:/dev/i2c-4 上控制 0x10 的值设置为 75：

  sudo ddccontrol -r 0x10 -w 75 dev:/dev/i2c-4
  

更多帮助信息可以通过命令 ddccontrol -h 获取。

3. 项目API使用文档

本项目目前不提供专门的 API 文档。用户可以通过阅读源代码和项目文档来了解如何贡献代码和扩展功能。

4. 项目安装方式

请参考本文档中的 "1. 安装指南" 部分，了解项目的安装方式。

---

本文档受 GNU General Public License v2.0 许可保护。