Skip to content

Commit 4b0d9a9

Browse files
committed
Update README for force_device module parameter
1 parent 9ad4f50 commit 4b0d9a9

File tree

1 file changed

+38
-6
lines changed

1 file changed

+38
-6
lines changed

README.md

Lines changed: 38 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,22 @@ On many systems, ASUSTOR uses a mix of IT87 and CPU GPIOs to control leds and bu
3838
- AS5402T, AS5404T
3939
- FS6706T (NOT TESTED!), FS6712X
4040
- .. possibly more, if they're similar enough.
41-
The following DMI system-manufacturer / system-product-name combinations are currently supported
42-
(see `sudo dmidecode -s system-manufacturer` and `sudo dmidecode -s system-product-name`):
43-
- "ASUSTOR Inc." / "AS-6xxT"
44-
- "Insyde" / "AS61xx"
45-
- "Insyde" / "GeminiLake"
46-
- "Intel Corporation" / "Jasper Lake Client Platform"
41+
42+
The following DMI system-manufacturer / system-product-name combinations are currently supported
43+
(see `sudo dmidecode -s system-manufacturer` and `sudo dmidecode -s system-product-name`):
44+
* "ASUSTOR Inc." / "AS-6xxT"
45+
- Identified by `asustor` kernel module as **"AS6xx"**
46+
* "Insyde" / "AS61xx"
47+
- Identified by `asustor` kernel module as **"AS61xx"**
48+
* "Insyde" / "GeminiLake"
49+
- These are the *Lockerstor* AS66xxT devices, like AS6604T
50+
- *maybe also others like Nimbustor AS520xT?*
51+
- Identified by `asustor` kernel module as **"AS66xx"**
52+
* "Intel Corporation" / "Jasper Lake Client Platform"
53+
- These are the *Lockerstor Gen2* AS67xxT (AS6702T etc), *Nimbustor Gen2* AS54xxT (AS5402T etc)
54+
and *Flashstor* FS6706T/FS6712X devices.
55+
- Identified by `asustor` kernel module as **"AS67xx"** for *Lockerstor Gen2* and *Nimbustor Gen2*
56+
- **_or_** identified as **"FS67xx"** if it's a *Flashstor* device
4757

4858
## Features
4959

@@ -142,6 +152,28 @@ Note that `it87` conflicts with `asustor-it87`, you may wish to add `it87` to th
142152

143153
~~You may want to use [`patches/001-ignore-pwm-polarity-it87.patch`](patches/001-ignore-pwm-polarity-it87.patch) for the `it87` kernel module if it complains about PWM polarity. In this case, it's possible to use `fix_pwm_polarity=1`, however, it may reverse the polarity which is unwanted (i.e. high is low, low is high). It works fine when left as configured by the firmware.~~
144154

155+
### Override detection of ASUSTOR device by `asustor` kernel module
156+
157+
If the `asustor` kernel module doesn't detect your device correctly, you can force it to treat your
158+
ASUSTOR device as one of the supported devices by setting the `force_device` module parameter.
159+
160+
can be used like:
161+
`$ sudo modprobe asustor force_device=AS66xx`
162+
or by creating an `/etc/modprobe.d/asustor.conf` text file with the following content:
163+
164+
```
165+
# override device detection of the asustor kernel module
166+
options asustor force_device=FS67xx
167+
```
168+
169+
Of course you should replace "FS67xx" with the device you want to try, see the [Compatiblity](#compatibility)
170+
section above for how the `asustor` kernel module identifies devices, or
171+
`$ sudo modinfo -p asustor`
172+
which will print a short usage info including the currently supported device names for `force_device`.
173+
174+
_**NOTE:** If you need to use the `force_device` parameter to make your device work, please open an issue
175+
so the detection logic in the `asustor` kernel module can be fixed to properly support it._
176+
145177
### Misc
146178

147179
- `blue:power` and `red:power` can be turned on simultaneously for a pink-ish tint

0 commit comments

Comments
 (0)