Sintaxa senzorilor

Intrările din secțiunea sensors: pot specifica controlorii hwmon, thinkpad_acpi, NVML sau atasmart, unde ultimele două trebuie activate la compilare. Poate exista orice număr (mai mare decât zero) și orice combinație de intrări hwmon, tpacpi, nvml și atasmart. Cu toate acestea, poate exista cel mult o singură instanță a intrării tpacpi.

sensors:
  - hwmon: ruta-hwmon
    name: nume-hwmon
    indices: listă-index
    correction: listă-corecție
    optional: permite-erori_boolean
- tpacpi: /proc/acpi/ibm/thermal
    indices: list--index
    correction: listă-corecție
    optional: permite-erori_boolean
  - nvml: id-magistrală-nvml
    correction: listă-corecție
    optional: permite-erori_boolean
  - atasmart: fișier-dispozitiv-disc
    correction: listă-corecție
    optional: permite-erori_boolean
  - ...

Sintaxa ventilatoarelor

În prezent, «thinkfan» permite doar un singur ventilator, astfel încât poate exista o singură intrare în listă. Suportul pentru mai multe ventilatoare este în curs de dezvoltare și este planificat pentru o versiune viitoare. Ventilatorul este fie un ventilator hwmon:

fans:
  - hwmon: ruta-hwmon
    name: nume-hwmon
    indices: listă-index

sau un ventilator tpacpi:

fans:
- tpacpi: /proc/acpi/ibm/fan

Valori

ruta-hwmon

Există trei moduri de a specifica ventilatoare sau senzori hwmon:

1)

O rută completă a unui fișier „temp*_input” sau „pwm*”, cum ar fi „/sys/class/hwmon/hwmon/hwmon0/pwm1” sau „/sys/class/hwmon/hwmon/hwmon0/temp1_input”. În acest caz, intrările „indices: listă-index” și „name: nume-hwmon” nu sunt necesare, deoarece ruta identifică în mod unic un ventilator sau un senzor specific.

Rețineți că această metodă poate duce la probleme atunci când ordinea de încărcare a controlorilor se schimbă în timpul pornirii, deoarece în numele dosarului „hwmonX”, X corespunde de fapt ordinii de încărcare. Utilizați metoda 2) sau 3) pentru a evita această problemă.

2)

Un director care conține un controlor hwmon specific, de exemplu „/sys/devices/platform/nct6775.2592”. Rețineți că această rută nu conține directorul „hwmonX”, care depinde de ordinea de încărcare. Atâta timp cât conține doar un singur controlor/interfață hwmon, este suficient să specificați intrarea „indices: listă-index” pentru a-i indica lui «thinkfan» ce senzori specifici să utilizeze din acea interfață. Intrarea „name: nume-hwmon” nu este necesară.

3)

Un director care conține mai multe sau toți controlorii hwmon, de exemplu „/sys/class/hwmon”. Aici, atât intrările „name: nume-hwmon”, cât și „indices: listă-index” sunt necesare pentru a-i indica lui «thinkfan» ce interfață să selecteze sub această rută și ce senzori sau ce ventilator să folosească din acea interfață.

nume-hwmon

Numele unei interfețe hwmon, care se găsește de obicei într-un fișier numit „nume”. Acesta trebuie specificat dacă ruta-hwmon este o rută de bază care conține mai multe hwmons. Această metodă de specificare a senzorilor este deosebit de utilă în cazul în care ruta completă către un anumit hwmon continuă să se schimbe între porniri, de exemplu, din cauza schimbării ordinii de încărcare a modulelor de control.

listă-index

O listă YAML [ X1, X2, ... ] care specifică ce senzori, respectiv ce ventilator trebuie să utilizeze de la o anumită interfață. Atât /proc/acpi/ibm/thermal, cât și multe interfețe hwmon conțin mai mulți senzori și nu toți dintre aceștia pot fi relevanți pentru controlul ventilatorului.

•

Pentru intrările hwmon, acest lucru este necesar în cazul în care ruta-hwmon nu se referă direct la un singur fișier „tempXi_input”, ci la un dosar care conține unul sau mai multe. În acest caz, listă-index specifică Xi pentru fișierele „tempXi_input”care trebuie utilizate. O interfață hwmon poate conține, de asemenea, mai multe comenzi PWM pentru ventilatoare, deci, în acest caz, listă-index trebuie să conțină exact o singură intrare.

•

Pentru senzorii tpacpi, această intrare este opțională. Dacă este omisă, se vor utiliza toate temperaturile găsite în /proc/acpi/ibm/thermal.

id-magistrală-nvml

NOTĂ: disponibilă numai dacă «thinkfan» a fost compilat cu opțiunea USE_NVML activată.

ID-ul de magistrală PCI al unei plăci grafice nVidia care rulează cu controlorul proprietar nVidia. Poate fi obținut, de exemplu, cu «lspci | grep -i vga». De obicei, plăcile nVidia vor folosi controlorul „open source” nouveau, care ar trebui să accepte în schimb senzorii hwmon.

fișier-dispozitiv-disc

NOTĂ: disponibilă numai dacă «thinkfan» a fost compilat cu opțiunea USE_ATASMART activată.

Ruta completă către un fișier de dispozitiv pentru un disc dur care suportă S.M.A.R.T. A se vedea, de asemenea, opțiunea -d din thinkfan(1) care împiedică «thinkfan» să trezească discurile adormite (mecanice) pentru a le citi temperatura.

listă-corecție (întotdeauna opțională)

O listă YAML care specifică decalajele de temperatură pentru fiecare senzor utilizat de către controlorul dat. Folosiți această opțiune dacă doriți să utilizați sintaxa de nivel „simplu”, dar trebuie să compensați pentru dispozitive cu o toleranță termică mai mică. Rețineți totuși că sintaxa de nivel detaliat este de obicei alegerea mai bună (adică un reglaj mai fin).

permite-erori_boolean (întotdeauna opțional, false în mod implicit)

O valoare de adevăr (yes/no/true/false) care specifică dacă «thinkfan» trebuie să accepte erori atunci când citește de la acest senzor. În mod normal, «thinkfan» va ieși cu un mesaj de eroare dacă citirea temperaturii de la orice senzor configurat eșuează. Marcarea unui senzor ca fiind opțional poate fi utilă pentru hardware-ul detașabil sau pentru dispozitivele care pot fi oprite complet pentru a economisi energie.

Sintaxa simplă

În forma simplificată, se specifică doar o singură temperatură ca limită superioară/inferioară pentru o anumită turație a ventilatorului. În acest caz, limita-inferioară și limita-superioară sunt comparate numai cu cea mai mare temperatură găsită printre toți senzorii configurați. Toate celelalte temperaturi sunt ignorate. Acest mod este potrivit pentru sistemele mici (cum ar fi laptopurile) în cazul în care există un singur dispozitiv (de exemplu, CPU) a cărui temperatură trebuie controlată sau în cazul în care comportamentul necesar al ventilatorului este suficient de similar pentru toate dispozitivele care generează căldură.

levels:
  - [ viteza-ventilatorului, limita-inferioară, limita-superioară ]
  - ...

Sintaxa detaliată

Acest mod este potrivit pentru sisteme mai complexe, cu dispozitive care au temperaturi nominale diferite. De exemplu, multe CPU-uri și GPU-uri moderne pot face față zilnic la temperaturi de peste 80°C, în timp ce un disc dur va muri rapid dacă atinge astfel de temperaturi. În modul detaliat, limitele superioare și inferioare de temperatură sunt specificate pentru fiecare senzor în parte:

levels:
  - speed: viteza-ventilatorului
    lower_limit: [ l1, l2, ... ]
    upper_limit: [ u1, u2, ... ]
  - ...

Valori

viteza-ventilatorului

Valorile posibile ale turației sunt diferite în funcție de controlorul de ventilator utilizat.

Pentru un ventilator hwmon, viteza-ventilatorului este o valoare numerică cuprinsă între 0 și 255, care corespunde valorilor PWM acceptate de diverși controlori ai nucleului.

Pentru un ventilator tpacpi de pe Lenovo/IBM ThinkPad și alte câteva laptopuri Lenovo (a se vedea CONTROLORI PENTRU SENZORI ȘI VENTILATOARE de mai sus), se pot utiliza valori numerice și șiruri de caractere. Valorile numerice variază de la 0 la 7. Valorile de tip șir de caractere au forma „level lvl-id”, unde lvl-id poate fi o valoare de la 0 la 7, auto, full-speed sau disengaged. Valorile numerice de la 0 la 7 corespund vitezelor obișnuite ale ventilatorului utilizate de firmware, deși multe firmware-uri nici măcar nu utilizează nivelul 7. Valoarea „level auto” redă controlul firmware-ului, ceea ce poate fi util în cazul în care comportamentul ventilatorului trebuie modificat doar pentru anumite intervale specifice de temperatură (de obicei, la capetele de temperatură ridicată și scăzută ale intervalului). Valorile „evel full-speed” și „level disengaged” iau controlul vitezei ventilatorului de la firmware, determinând ventilatorul să urce încet până la un maxim absolut care poate fi atins în limitele electrice. Rețineți că acest lucru va scoate ventilatorul din specificații și va cauza o uzură crescută, deși poate fi util pentru a combate blocarea termică.

l1, l2, ...

u1, u2, ...

Limitele inferioare și superioare se referă la senzori în aceeași ordine în care au fost găsiți la procesarea secțiunii senzors: (a se vedea secțiunea CONTROLORI PENTRU SENZORI ȘI VENTILATOARE de mai sus). Pentru prima intrare de nivel, lower_limit poate fi omisă, iar pentru ultima, upper_limit poate fi omisă. Pentru toate nivelurile intermediare, limitele inferioare trebuie să se suprapună cu limitele superioare ale nivelului anterior, pentru a se asigura că este acoperit întregul interval de temperatură și că există o anumită histerezis între nivelurile de viteză.