#led #sysfs #command-line #alienware

应用 alienware_cli

用于控制 Alienware Alpha R1/R2 机器上的灯的命令行应用

17 个版本 (稳定版)

1.0.12 2024年2月25日
1.0.10 2023年10月3日
1.0.9 2023年2月11日
1.0.2 2022年4月14日
0.1.4 2022年2月25日

#191硬件支持

Apache-2.0

36KB
690

alienware-cli

Crates.io Crates.io Build Status dependency status snapcraft.io

alienware-cli 应用控制 Alienware Alpha 台式机上的 LED 和 HDMI 输入输出端口。该 API 基于 alienware_wmi_control.sh 脚本,该脚本曾随 Alienware 机器的 SteamOS Linux 发行版提供。

您还可以查看一个用于控制相同灯的 Python 项目 AlienFX

安装

第一种方法:如果您的 root 用户具有正确的工具链的 cargo

sudo cargo install alienware_cli --root /usr/local

第二种方法:使用 cargo 为自己安装,然后将其复制到所有用户路径中的位置

cargo install alienware-cli
sudo cp ~/.cargo/bin/alienware-cli /usr/local/bin

第三种方法:从 发布页面 获取最新版本

curl -OL https://github.com/a1ecbr0wn/alienware-wmi/releases/download/latest/alienware-cli && chmod 775 alienware-cli

使用

要查看命令行参数的说明,请使用 -h 参数

$ alienware-cli -h
Command Line app to control the lights on an Alienware Alpha R1/R2

Usage: alienware-cli [OPTIONS]

Options:
  -c, --connector      State of the HDMI ports
  -l, --led-state      State of the LEDs
  -H, --head <HEAD>    Set the LED state of the head button
  -L, --left <LEFT>    Set the LED state of the left LEDs
  -R, --right <RIGHT>  Set the LED state of the right LEDs
  -j, --json           Output in JSON format for machine readability (combined with -c or -l)
  -V, --version        Print version information
  -h, --help           Print help

-c-l 参数分别显示 HDMI 连接和 LED 的信息,这两个参数可以一起或单独使用,也可以与 -j 参数一起使用,该参数将响应格式化为机器可读的 JSON 格式

$ alienware-cli -lc
HDMI passthrough state: present
    Input HDMI is unconnected
    Output HDMI is connected to gpu

LED state: present
    head:
        red: 15
        green: 0
        blue: 15
    left:
        red: 0
        green: 15
        blue: 15
$ alienware-cli -jlc
{"hdmi":{"hdmi":{"exists":true,"input":"unconnected","output":"gpu"}},"leds":{"exists":true,"left":{"red":0,"green":15,"blue":15},"head":{"red":15,"green":0,"blue":15}}}

可以使用 -H-L-R 参数分别设置头部、左侧和右侧 LED 群的颜色。颜色可以用颜色名称或 RGB 值设置,其中每种颜色的值为 0-15。由于这些命令正在更改 sysfs 中的文件值,因此应使用 root 权限运行命令

以下两个示例都将头部按钮设置为青色

sudo alienware-cli -H cyan
sudo alienware-cli -H "0 15 15"

免责声明和许可

如果您使用此软件,则您自行承担风险使用。

此软件受 Apache-2.0 许可证的许可。

依赖关系

~3.5-5MB
~91K SLoC