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

2024-12-20 11:46:52作者：盛欣凯Ernestine

本文档将详细介绍如何安装、使用以及操作 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
```