1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
|
# NVIDIA graphics cards
_Driver API and source code available in [`liquidctl.driver.nvidia`](../liquidctl/driver/nvidia.py)._
Support for these cards in only available on Linux. Other requirements must
also be met:
- `i2c-dev` kernel module has been loaded
- r/w permissions to card-specific `/dev/i2c-*` devices
- specific unsafe features have been opted in
Jump to the appropriate section for a supported card:
* _Series 10/Pascal:_
- [ASUS Strix GTX 1050 OC][asus-gtx-rtx]
- [ASUS Strix GTX 1050 Ti OC][asus-gtx-rtx]
- [ASUS Strix GTX 1060 6GB][asus-gtx-rtx]
- [ASUS Strix GTX 1060 OC 6GB][asus-gtx-rtx]
- [ASUS Strix GTX 1070 OC][asus-gtx-rtx]
- [ASUS Strix GTX 1070 Ti Advanced][asus-gtx-rtx]
- [ASUS Strix GTX 1070 Ti][asus-gtx-rtx]
- [ASUS Strix GTX 1070][asus-gtx-rtx]
- [ASUS Strix GTX 1080 Advanced][asus-gtx-rtx]
- [ASUS Strix GTX 1080 OC][asus-gtx-rtx]
- [ASUS Strix GTX 1080 Ti OC][asus-gtx-rtx]
- [ASUS Strix GTX 1080 Ti][asus-gtx-rtx]
- [ASUS Strix GTX 1080][asus-gtx-rtx]
- [EVGA GTX 1070 FTW DT Gaming][evga-gp104]
- [EVGA GTX 1070 FTW Hybrid][evga-gp104]
- [EVGA GTX 1070 FTW][evga-gp104]
- [EVGA GTX 1070 Ti FTW2][evga-gp104]
- [EVGA GTX 1080 FTW][evga-gp104]
* _Series 16/Turing:_
- [ASUS Strix GTX 1650 Super OC][asus-gtx-rtx]
- [ASUS Strix GTX 1660 Super OC][asus-gtx-rtx]
- [ASUS Strix GTX 1660 Ti OC][asus-gtx-rtx]
* _Series 20/Turing:_
- [ASUS Strix RTX 2060 Evo OC][asus-gtx-rtx]
- [ASUS Strix RTX 2060 Evo][asus-gtx-rtx]
- [ASUS Strix RTX 2060 OC][asus-gtx-rtx]
- [ASUS Strix RTX 2060 Super Advanced][asus-gtx-rtx]
- [ASUS Strix RTX 2060 Super Evo Advanced][asus-gtx-rtx]
- [ASUS Strix RTX 2060 Super OC][asus-gtx-rtx]
- [ASUS Strix RTX 2060 Super][asus-gtx-rtx]
- [ASUS Strix RTX 2070 Advanced][asus-gtx-rtx]
- [ASUS Strix RTX 2070 OC][asus-gtx-rtx]
- [ASUS Strix RTX 2070 Super Advanced][asus-gtx-rtx]
- [ASUS Strix RTX 2070 Super OC][asus-gtx-rtx]
- [ASUS Strix RTX 2070][asus-gtx-rtx]
- [ASUS Strix RTX 2080 OC][asus-gtx-rtx]
- [ASUS Strix RTX 2080 Super Advanced][asus-gtx-rtx]
- [ASUS Strix RTX 2080 Super OC][asus-gtx-rtx]
- [ASUS Strix RTX 2080 Ti OC][asus-gtx-rtx]
- [ASUS Strix RTX 2080 Ti][asus-gtx-rtx]
* _Series 30/Ampere:_
- [ASUS TUF RTX 3060 Ti OC][asus-gtx-rtx]
* _[Inherent unsafeness of I²C]_
## EVGA GTX 1070, 1070 Ti and 1080
[evga-gp104]: #evga-gtx-1070-1070-ti-and-1080
Only RGB lighting supported.
Unsafe features:
- `smbus`: see [Inherent unsafeness of I²C]
- `experimental_evga_gpu`: enable new/experimental devices
### Initialization
Not required for this device.
### Retrieving the current RGB lighting mode and color
In verbose mode `status` reports the current RGB lighting settings.
```
# liquidctl status --verbose --unsafe=smbus
EVGA GTX 1080 FTW
├── Mode Fixed
└── Color 2aff00
```
### Controlling the LED
This GPU only has one led that can be set. The table bellow summarizes the
available channels, modes and their associated number of required colors.
| Channel | Mode | Colors |
| ---------- | ----------- | -----: |
| `led` | `off` | 0 |
| `led` | `fixed` | 1 |
| `led` | `breathing` | 1 |
| `led` | `rainbow` | 0 |
```
# liquidctl set led color off --unsafe=smbus
# liquidctl set led color rainbow --unsafe=smbus
# liquidctl set led color fixed ff8000 --unsafe=smbus
# liquidctl set led color breathing "hsv(90,85,70)" --unsafe=smbus
^^^ ^^^^^^^^^ ^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^
channel mode color unsafe features
```
The LED color can be specified using any of the
[supported formats](../README.md#supported-color-specification-formats).
The settings configured on the device are normally volatile, and are cleared
whenever the graphics card is powered down (OS and UEFI power saving settings
can affect when this happens).
It is possible to store them in non-volatile controller memory by
passing `--non-volatile`. But as this memory has some unknown yet
limited maximum number of write cycles, volatile settings are
preferable, if the use case allows for them.
```
# liquidctl set led color fixed 00ff00 --non-volatile --unsafe=smbus
```
## ASUS Strix GTX and RTX
[asus-gtx-rtx]: #asus-strix-gtx-and-rtx
Only RGB lighting supported.
Unsafe features:
- `smbus`: see [Inherent unsafeness of I²C]
- `experimental_asus_gpu`: enable new/experimental devices
### Initialization
Not required for this device.
### Retrieving the current color mode and LED color
In verbose mode `status` reports the current RGB lighting settings.
```
# liquidctl status --verbose --unsafe=smbus
ASUS Strix RTX 2080 Ti OC
├── Mode Fixed
└── Color ff0000
```
### Controlling the LED
This GPU only has one led that can be set. The table bellow summarizes the
available channels, modes, and their associated maximum number of colors for
each device family.
| Channel | Mode | Colors |
| ---------- | ------------- | -----: |
| `led` | `off` | 0 |
| `led` | `fixed` | 1 |
| `led` | `flash` | 1 |
| `led` | `breathing` | 1 |
| `led` | `rainbow` | 0 |
```
# liquidctl set led color off --unsafe=smbus
# liquidctl set led color rainbow --unsafe=smbus
# liquidctl set led color fixed ff8000 --unsafe=smbus
# liquidctl set led color flash ff8000 --unsafe=smbus
# liquidctl set led color breathing "hsv(90,85,70)" --unsafe=smbus
^^^ ^^^^^^^^^ ^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^
channel mode color unsafe features
```
The LED color can be specified using any of the
[supported formats](../README.md#supported-color-specification-formats).
The settings configured on the device are normally volatile, and are cleared
whenever the graphics card is powered down (OS and UEFI power saving settings
can affect when this happens).
It is possible to store them in non-volatile controller memory by passing
`--non-volatile`. But as this memory has some unknown yet limited maximum
number of write cycles, volatile settings are preferable, if the use case
allows for them.
```
# liquidctl set led color fixed 00ff00 --non-volatile --unsafe=smbus
```
Note: The `off` mode is simply an alias for `fixed 000000`.
## Inherent unsafeness of I2C
[Inherent unsafeness of I²C]: #inherent-unsafeness-of-i2c
Reading and writing to I²C buses is inherently more risky than dealing with,
for example, USB devices. On typical desktop and workstation systems many
important chips are connected to these buses, and they may not tolerate writes
or reads they do not expect.
It is necessary to rely on certain devices being know to use a specific
address, or being documented/specified to do so; but there is always some risk
that another, unexpected, device is using that same address.
On top of this, accessing I²C buses concurrently, from multiple threads or
processes, may also result in undesirable or unpredictable behavior.
Unsurprisingly, users or programs dealing with I²C devices have occasionally
crashed systems and even bricked boards or peripherals. In some cases this is
reversible, but not always.
For all of these reasons liquidctl requires users to *opt into* accessing I²C
and SMBus devices, both of which can be done by enabling the `smbus` unsafe
feature. Other unsafe features may also be required for the use of specific
devices, based on other *know* risks specific to a particular device.
Note that a feature not being labeled unsafe, or a device not requiring the use
of additional unsafe features, does in no way assure that it is safe. This is
especially true when dealing with I²C/SMBus devices.
Finally, liquidctl may list some I²C/SMBus devices even if `smbus` has not been
enabled, but only if it is able to discover them without communicating with the
bus or the devices.
|
