LIQUIDCTL(8) System Manager's Manual LIQUIDCTL(8)

liquidctl - پایش و کنترل خنک‌کننده‌های مایع و سایر دستگاه‌ها

liquidctl [گزینه‌ها] list
liquidctl [گزینه‌ها] initialize [all]
liquidctl [گزینه‌ها] status
liquidctl [گزینه‌ها] set channel speed (temperature percentage) ...
liquidctl [گزینه‌ها] set channel speed percentage
liquidctl [گزینه‌ها] set channel color mode [color ...]
liquidctl --version
liquidctl --help

برنامه liquidctl ابزاری برای نظارت و کنترل برخی دستگاه‌های پایش سخت‌افزاری است که هنوز در سطح هسته (کرنل) پشتیبانی نمی‌شوند. از آن‌جا که liquidctl مستقیماً به دستگاه‌های سخت‌افزاری دسترسی پیدا می‌کند، به‌طور کلی دسترسی‌های کاربر ارشد (root) مورد نیاز است؛ هرچند می‌توان با تنظیم قوانین مناسب udev از این نیاز صرف‌نظر کرد.

دستور liquidctl list تمام دستگاه‌های سازگار یافت‌شده در سیستم را نمایش می‌دهد. در صورتی که بیش از یک دستگاه یافت شود، دستگاه مورد نظر را می‌توان برای فراخوانی‌های بعدی با گزینه --match=زیر‌رشته انتخاب کرد، که در آن زیر‌رشته بخشی از توضیحات دستگاه مورد نظر را با مقایسه بدون حساسیت به حروف بزرگ و کوچک تطبیق می‌دهد.

اجرای liquidctl list --verbose نمایش شناسه‌ها و آدرس‌های اضافی را فعال می‌کند که می‌توان از آن‌ها نیز برای انتخاب دستگاه‌های خاص استفاده کرد. این موارد برای کاربردهای خاص مانند اسکریپت‌های غیرتعاملی مناسب‌تر هستند.

دستور liquidctl initialize دستگاه را برای دستورات بعدی آماده می‌کند؛ بیشتر دستگاه‌ها پس از هر بار بوت یا هنگام بازگشت از حالت تعلیق (suspend) باید مقداردهی اولیه شوند. مگر این‌که کنترل دقیق‌تری لازم باشد، می‌توان تمام دستگاه‌ها را هم‌زمان با دستور liquidctl initialize all مقداردهی اولیه کرد. برخی دستگاه‌ها ممکن است در این مرحله اطلاعاتی را در خروجی نمایش دهند.

دستور liquidctl status وضعیت تمام دستگاه‌هایی را که با گزینه‌های فیلتر ارائه‌شده مطابقت دارند نمایش می‌دهد.

دستور liquidctl set channel speed به کاربر اجازه می‌دهد سرعت فن و پمپ را تنظیم کند. این مقادیر، بسته به نوع دستگاه، می‌توانند روی مقادیر چرخه کاری (duty) ثابت، منحنی‌های متغیر دما\[u2013]چرخه کاری یا هر دو تنظیم شوند.

دستور liquidctl set channel color به کاربر امکان می‌دهد حالت‌های نورپردازی را پیکربندی و تنظیم کند. حالت‌های نورپردازی پشتیبانی‌شده و گزینه‌های اضافی بسته به نوع دستگاه متفاوت هستند و در بخش‌های بعدی این راهنما فهرست شده‌اند. هر رنگ را می‌توان به یکی از روش‌های زیر مشخص کرد:

  • مقدار هگزادسیمال RGB با یا بدون پیشوند '0x': مانند ff7f3f؛
  • سه‌تایی ده‌دهی RGB، با بازه R,G,B ∊ [0, 255]: مانند rgb(255,127,63)؛
  • سه‌تایی HSV (فام-اشباع-مقدار)، با بازه H ∊ [0, 360] و S,V ∊ [0, 100]: مانند hsv(20,75,100)؛
  • سه‌تایی HSL (فام-اشباع-روشنایی)، با بازه H ∊ [0, 360] و S,L ∊ [0, 100]: مانند hsl(20,100,62).

دستور liquidctl set channel screen به کاربر اجازه می‌دهد صفحه‌نمایش LCD تعبیه‌شده در برخی مدل‌های خنک‌کننده AIO را پیکربندی کند.

برنامه liquidctl به‌طور خودکار اتصال یک درایور هسته به دستگاه را تشخیص داده و هر زمان که ممکن باشد، به‌جای دسترسی مستقیم به دستگاه از آن استفاده می‌کند. در غیر این صورت، می‌توان با گزینه --direct-access دسترسی مستقیم به دستگاه را تحمیل کرد.

دستگاه‌ها را می‌توان با استفاده از یک یا چند مقدار به‌دست‌آمده از list --verbose انتخاب کرد.

فیلتر کردن دستگاه‌ها بر اساس زیر‌رشته‌ای از توضیحات دستگاه بدون حساسیت به حروف بزرگ و کوچک.
انتخاب یکی از میان چندین نتیجه برای یک فیلتر مشخص.
فیلتر کردن دستگاه‌ها بر اساس شناسه سازنده (vendor id) به صورت هگزادسیمال.
فیلتر کردن دستگاه‌ها بر اساس شناسه محصول (product id) به صورت هگزادسیمال.
فیلتر کردن دستگاه‌ها بر اساس شماره نسخه عرضه (release number) به صورت هگزادسیمال.
فیلتر کردن دستگاه‌ها بر اساس شماره سریال.
فیلتر کردن دستگاه‌ها بر اساس گذرگاه (bus).
فیلتر کردن دستگاه‌ها بر اساس آدرس در گذرگاه.
فیلتر کردن دستگاه‌ها بر اساس پورت USB در گذرگاه.
(منسوخ‌شده)، انتخاب دستگاه بر اساس نمایه (index) در فهرست.

برخی دستگاه‌ها و حالت‌های پویانمایی از گزینه‌های اضافی پشتیبانی می‌کنند.

سرعت انتزاعی پویانمایی (مختص دستگاه یا حالت).
زمان مکث روی هر رنگ (به ثانیه).
زمان خاموش ماندن LED (به ثانیه).
آستانه دما برای هشدار بصری (به درجه سانتی‌گراد).
رنگ مورد استفاده برای هشدار بصری دمای بالا.
مشخص می‌کند که الگو باید به جلو حرکت کند یا به عقب.
نخستین LED که افکت باید از آن شروع شود.
تعداد LEDهایی که افکت باید روی آن‌ها اعمال شود.

تنظیم حالت‌های فن.
فعال‌سازی مدار محافظ جریان بیش‌ازحد (OCP) تک‌ریل ۱۲+ ولت.
تنظیم حالت پمپ.
شماره حسگر دما برای Commander Pro.
استفاده از Asetek 690LC در حالت قدیمی (دستگاه‌های قدیمی Kraken).
ذخیره‌سازی روی حافظه پایدار (غیرفرار) کنترلر.
دسترسی مستقیم به دستگاه با وجود درایورهای هسته.
ویژگی‌های آزمایشی و ناپایدار (bleeding-edge) جداشده با کاما جهت فعال‌سازی.
نمایش اطلاعات تکمیلی در خروجی.
نمایش اطلاعات اشکال‌زدایی در stderr.
تولید خروجی ماشین‌خوان در قالب JSON. تنها برای دستورات list، initialize و status پشتیبانی می‌شود.
نمایش شماره نسخه برنامه.
نمایش راهنمای داخلی برنامه.

در صورت بروز خطا ۱، و در غیر این صورت ۰.

اگر LANG روی C تنظیم شده باشد، نویسه‌های غیر ASCII در خروجی --json اسکیپ (escape) می‌شوند.

$XDG_RUNTIME_DIR/liquidctl/*, /var/run/liquidctl/*, /tmp/liquidctl/*
داده‌های داخلی مورد استفاده توسط برخی درایورها.

liquidctl list --verbose
liquidctl initialize all
liquidctl --match kraken set pump speed 90
liquidctl --product 170e set led color fading 350017 ff2608
liquidctl status

کانال‌های خنک‌کننده: (در D5 Next:) fan، pump؛ (در Octo:) fan[1-8]؛ (در Quadro:) fan[1-4]؛ (در Farbwerk/Farbwerk 360:) پشتیبانی نمی‌شود (غیرقابل اعمال).

کانال‌های نورپردازی: هنوز پشتیبانی نمی‌شوند.

کانال‌های خنک‌کننده: pump، fans، pump-fan، external-fans.

کانال‌های خنک‌کننده: pump، pump-fan.

صفحه‌نمایش: هنوز پشتیبانی نمی‌شود.

کانال‌های خنک‌کننده: fans، fan. تنها یک کانال فن واحد وجود دارد.

کانال‌های خنک‌کننده: fans، fan[1-6]؛ (تنها در مدل‌های غیر XT/Elite Capellix:) pump.

کانال‌های نورپردازی: هنوز پشتیبانی نمی‌شوند.

کانال‌های خنک‌کننده (تنها در Commander Pro و Obsidian 1000D): sync، fan[1-6].

که در آن نوع اتصال فن را می‌توان با گزینه --fan-mode=channel:mode[,...], تنظیم کرد؛ حالت‌های مجاز عبارتند از: off، dc، pwm.

کانال‌های نورپردازی: (تنها در Lighting Node Core:) led؛ (تنها در Commander Pro و Lighting Node Pro:) sync، led[1-2].

حالت تعداد رنگ‌ها
clear 0
off 0
fixed 1
color_shift 2
color_pulse 2
color_wave 2
visor 2
blink 2
marquee 1
sequential 1
rainbow 0
rainbow2 0

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: fast، medium، slow.

جهت پویانمایی را می‌توان با گزینه --direction=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: forward یا backward. --start-led=number, نخستین LED که افکت نورپردازی باید برای آن اعمال شود. --start-led=number, نخستین LED که افکت نورپردازی باید برای آن اعمال شود. --maximum-led=number, تعداد LEDهایی که افکت نورپردازی باید روی آن‌ها اعمال شود. --temperature-sensor=number, حسگر دمایی که باید برای کنترل منحنی‌های فن استفاده شود؛ به‌طور پیش‌فرض probe 1 است.

کانال‌های خنک‌کننده: fan1، fan2.

حالت پمپ (initialize --pump-mode mode): quiet (پیش‌فرض)، extreme.

کانال‌های نورپردازی: هنوز پشتیبانی نمی‌شوند.

کانال‌های خنک‌کننده: pump، fan.

کانال‌های نورپردازی: logo.

حالت تعداد رنگ‌ها یادداشت‌ها
rainbow 0 تنها در خنک‌کننده‌های EVGA موجود است
fading 2
blinking 1
fixed 1
blackout 0 فاقد هشدار دمای بالا

سرعت حالت rainbow را می‌توان با گزینه --speed=[1–6]. پیکربندی کرد. در مقابل، سرعت سایر حالت‌ها با گزینه‌های --time-per-color (در fading و blinking) و --time-off (تنهادر blinking) تنظیم می‌شود.

تمام حالت‌ها به جز blackout از یک هشدار بصری دمای بالا پشتیبانی می‌کنند که با گزینه‌های --alert-threshold و --alert-color پیکربندی می‌شود.

تمام تنظیمات جاری را می‌توان با ارسال گزینه --non-volatile به هر دستور نوشتن، روی حافظه پایدار روی برد ذخیره کرد. با این حال، از آن‌جا که چرخه‌های نوشتن محدود هستند، این گزینه باید با احتیاط و به ندرت استفاده شود.

کانال‌های خنک‌کننده: fan، fan[1–2]؛ (تنها در H150i Pro:) fan3.

حالت پمپ (initialize --pump-mode mode): quiet، balanced (پیش‌فرض)، performance.

کانال نورپردازی: logo.

حالت تعداد رنگ‌ها
alert 3
shift 2–4
pulse 1–4
blinking 1–4
fixed 1

کانال‌های خنک‌کننده: fan، fan[1–2]؛ (تنها در H150i Pro XT/Elite RGB:) fan3.

حالت پمپ (initialize --pump-mode mode): quiet، balanced (پیش‌فرض)، extreme.

کانال‌های نورپردازی: sync، led.

کانال حالت تعداد رنگ‌ها (Platinum) تعداد رنگ‌ها (Pro XT/Elite RGB) تعداد رنگ‌ها (Platinum SE)
led off 0 0 0
led fixed 1 1 1
led super-fixed 24 16 48

کانال‌های خنک‌کننده: fan[1–4].

کانال‌های نورپردازی: ندارد.

کانال‌های خنک‌کننده: fan1، fan2، fan3، fans، waterblock-fan، pump.

کانال‌های نورپردازی: sync.

صفحه‌نمایش‌های LCD: lcd.

حالت تعداد رنگ‌ها
disable 0
steady 1
blink 0
breathing 1
clock 2
color pulse 0
color ring 0
color ring double flashing 0
color ring flashing 0
color shift 0
color wave 2
corsair ique 0
disable2 0
double flashing 1
double meteor 0
energy 0
fan control 0
fire 2
flashing 1
jazz 0
jrainbow 0
lava 0
lightning 1
marquee 1
meteor 1–2
movie 0
msi marquee 1
msi rainbow 0
planetary 0
play 0
pop 0
rainbow 0
rainbow double flashing 0
rainbow flashing 0
rainbow wave 0
random 0
rap 0
stack 1
visor 2
water drop 1

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: 0، 1 و 2. تنظیمات صفحه‌نمایش LCD را می‌توان با فلگ settings کنترل کرد، که نیازمند آرگومان‌های "brightness;direction" است؛ به‌طوری‌که روشنایی مجاز عددی صحیح در بازه 0-100 است، و جهت‌های 0-3 به‌ترتیب با جهت‌های بالا، راست، پایین و چپ مطابقت دارند.

از همان حالت‌ها و گزینه‌های مشابه Corsair Hydro H80i GT پشتیبانی می‌کند، اما مستلزم این است که گزینه --legacy-690lc در تمام فراخوانی‌ها ارسال شود.

کانال‌های خنک‌کننده (تنها در X42، X52، X62، X72): pump، fan.

کانال‌های نورپردازی: logo، ring، sync.

حالت لوگو حلقه تعداد رنگ‌ها
off بله بله 0
fixed بله بله 1
super-fixed بله بله 1–9
fading بله بله 2–8
alternating خیر بله 2
breathing بله بله 1–8
super-breathing بله بله 1–9
pulse بله بله 1–8
tai-chi خیر بله 2
water-cooler خیر بله 0
loading خیر بله 1
wings خیر بله 1

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: slowest، slower، normal، faster، fastest. جهت پویانمایی را می‌توان با گزینه --direction=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: forward یا backward.

کانال‌های خنک‌کننده: pump.

کانال‌های نورپردازی: external، ring، logo، sync.

کانال‌های خنک‌کننده: pump، fan.

کانال‌های نورپردازی: external.

صفحه‌نمایش‌های LCD: lcd.

کانال‌های خنک‌کننده: pump، fan.

کانال‌های نورپردازی: ندارد.

صفحه‌نمایش‌های LCD: lcd.

حالت تعداد رنگ‌ها
off 0
fixed 1
fading 2–8
super-fixed 1–40
alternating-[3-6] 1–2
pulse 1–8
breathing 1–8
super-breathing 1–40
candle 1
starry-night 1
loading 1
tai-chi 1–2
water-cooler 2
wings 1

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: slowest، slower، normal، faster، fastest. جهت پویانمایی را می‌توان با گزینه --direction=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: forward یا backward.

کانال‌های خنک‌کننده: fan.

کانال‌های نورپردازی: ندارد.

تنظیم سرعت ثابت برای فن، حالت فن را به کنترل نرم‌افزاری تغییر می‌دهد. برای بازگشت به کنترل سخت‌افزاری، دستور initialize را دوباره اجرا کنید.

(ویژگی آزمایشی) ریل‌های ۱۲+ ولت به‌طور معمول در حالت چندریلی کار می‌کنند. حالت تک‌ریلی را می‌توان با ارسال گزینه --single-12v-ocp به initialize انتخاب کرد. برای بازگشت به حالت چندریلی، دستور initialize را مجدداً بدون این فلگ اجرا کنید.

کانال‌های خنک‌کننده: ندارد (این ویژگی هنوز پشتیبانی نمی‌شود).

کانال‌های نورپردازی: ندارد.

کانال‌های خنک‌کننده: fan[1–6]، sync.

کانال‌های نورپردازی: ندارد.

کانال‌های خنک‌کننده: fan[1–3]، sync.

کانال‌های نورپردازی: led.

حالت تعداد رنگ‌ها
off 0
fixed 1
super-fixed 1–40
fading 2–8
alternating 2
breathing 1–8
super-breathing 1–40
pulse 1–8
candle 1
wings 1

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: slowest، slower، normal، faster، fastest. جهت پویانمایی را می‌توان با گزینه --direction=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: forward یا backward.

کانال‌های خنک‌کننده (تنها در Smart Device V2، H1 V2 و RGB & Fan Controllers): fan[1–3].

کانال‌های نورپردازی (تمام مدل‌ها به‌جز H1 V2): led[1–6]، sync.

حالت تعداد رنگ‌ها
off 0
fixed 1
super-fixed 1–40
fading 2–8
alternating-[3-6] 2
pulse 1–8
breathing 1–8
super-breathing 1–40
candle 1
starry-night 1
wings 1

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: slowest، slower، normal، faster، fastest. جهت پویانمایی را می‌توان با گزینه --direction=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: forward یا backward.

کانال‌های خنک‌کننده: ندارد.

کانال‌های نورپردازی: led.

حالت تعداد رنگ‌ها
off 0
fixed 1
flash 1
breathing 1
rainbow 0

کانال‌های خنک‌کننده: ندارد.

کانال‌های نورپردازی: led.

حالت تعداد رنگ‌ها
off 0
fixed 1
breathing 1–7
fading 2–7

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: slowest، slower، normal، faster، fastest.

کانال‌های خنک‌کننده: ندارد.

کانال‌های نورپردازی: led[1–4]، sync.

حالت تعداد رنگ‌ها
off 0
static 1
breathing 1
flashing 1
spectrum_cycle 0
rainbow 0
spectrum_cycle_breathing 0
chase_fade 1
spectrum_cycle_chase_fade 0
chase 1
spectrum_cycle_chase 0
spectrum_cycle_wave 0
chase_rainbow_pulse 0
rainbow_flicker 0
gentle_transition 0
wave_propagation 0
wave_propagation_pause 0
red_pulse 0

کانال‌های خنک‌کننده: ندارد.

کانال‌های نورپردازی: led[1–8]، sync.

حالت تعداد رنگ‌ها
off 0
fixed 1
pulse 1
(double-)?flash 1
color-cycle 0

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: slowest، slower، normal، faster، fastest، ludicrous.

کانال‌های خنک‌کننده: ندارد.

کانال‌های نورپردازی: led.

حالت تعداد رنگ‌ها
off 0
fixed 1
breathing 1
rainbow 0

کانال‌های خنک‌کننده: pump، fan.

این دستگاه از پروفایل‌های سرعت برای هیچ‌یک از کانال‌ها پشتیبانی نمی‌کند؛ فقط سرعت‌های ثابت پشتیبانی می‌شوند.

کانال‌های نورپردازی: pump، fan.

حالت پمپ فن تعداد رنگ‌ها
rainbow بله بله 0
rainbow-morph بله بله 0
static بله بله 1
breathing بله بله 1
runway بله بله 2
meteor بله بله 4
ticker-tape بله خیر 4
fluctuation بله خیر 4
transmit بله خیر 2
colorful-starry-night بله خیر 0
static-starry-night بله خیر 1
big-bang بله خیر 4
burst بله خیر 1
color-morph بله خیر 0
bounce بله خیر 4

در صورت کاربرد، سرعت پویانمایی را می‌توان با گزینه --speed=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: slowest، slower، normal، faster، fastest. جهت پویانمایی را می‌توان با گزینه --direction=value, تنظیم کرد، که مقادیر مجاز آن عبارتند از: forward یا backward.

مستندات کامل در سورس‌های پروژه و صفحه اصلی در دسترس است.

2026-03-03 liquidctl