User Tools

Site Tools


doc:appunti:hardware:ugreen_dxp2800

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
doc:appunti:hardware:ugreen_dxp2800 [2025/12/16 09:44] – [Gli script di supporto] niccolodoc:appunti:hardware:ugreen_dxp2800 [2025/12/16 09:53] (current) – [Attivazione dei servizi e configurazione] niccolo
Line 401: Line 401:
 ==== Gli script di supporto ==== ==== Gli script di supporto ====
  
-Il pacchetto **led-ugreen-utils** fornisce gli script per impostare il normale funzionamento dei LED. Si tratta principalmente di due **script Bash** che gireranno in background, uno si occupa del LED **netdev** e l'altro dei LED **disk[12]**. Per ragioni di efficienza lo script che gestisce i LED dei dischi si appoggia a due programmi esterni scritti in C++ e compilati, questo perché il lampeggiamento a seguito di attività disco richiede il polling continuo e molto frequente di uno pseudofile in ''/sys/devices/'', che è sconsigliabile effettuare con uno shell script.+Il pacchetto **led-ugreen-utils** fornisce gli script per impostare il normale funzionamento dei LED. Si tratta principalmente di due **script Bash** che gireranno in background, uno si occupa del LED **netdev** e l'altro dei LED **disk[12]**. Per ragioni di efficienza lo script che gestisce i LED dei dischi si appoggia a due programmi esterni scritti in C++ e compilati, questo perché il lampeggiamento a seguito di attività disco richiede il polling continuo e molto frequente di uno pseudofile in ''/sys/devices/'', che è sconsigliabile effettuare con uno shell script. Anche il monitoraggio dello stato di stand-by dei dischi è preferibile effettuarlo con un progamma esterno in C++ compilato, per gli stessi motivi di efficienza.
  
 ^ Comandi contenuti nel pacchetto led-ugreen-utils  ^^ ^ Comandi contenuti nel pacchetto led-ugreen-utils  ^^
 ^ ugreen-probe-leds  | Script shell per inizializzare il bus I2C. Carica i moduli kernel **i2c-dev** e **led-ugreen** e cerca di individuare il **SMBus I801 adapter**. In caso di successo lo attiva come //new_device// e quindi troveremo un nodo del tipo **/sys/bus/i2c/devices/0-003a/name** che contiene la stringa ''led-ugreen''. A seguito di questa attivazione appariranno i nodi **/sys/class/leds/{disk1|disk2|netdev|power}**.  | ^ ugreen-probe-leds  | Script shell per inizializzare il bus I2C. Carica i moduli kernel **i2c-dev** e **led-ugreen** e cerca di individuare il **SMBus I801 adapter**. In caso di successo lo attiva come //new_device// e quindi troveremo un nodo del tipo **/sys/bus/i2c/devices/0-003a/name** che contiene la stringa ''led-ugreen''. A seguito di questa attivazione appariranno i nodi **/sys/class/leds/{disk1|disk2|netdev|power}**.  |
-^ ugreen-netdevmon  | Script Bash in loop infinito. Imposta il colore del LED netdev in base alla velocità del link e in base alla raggiungibilità del gateway. Legge la configurazione da ''/etc/ugreen-leds.conf''+^ ugreen-netdevmon  | Script Bash da eseguire in loop infinito. Imposta il colore del LED netdev in base alla velocità del link e in base alla raggiungibilità del gateway. Legge la configurazione da ''/etc/ugreen-leds.conf''
-^ ugreen-diskiomon  | Script Bash in loop infinito. Imposta la configurazione inziale dei LED dei dischi quindi aggiorna periodicamente il colore in base allo stato di salute S.M.A.R.T., allo stato on-line e allo stato di stand-by. Sempre in loop infinito invia un impulso al led se rileva attività del disco. Legge la configurazione da ''/etc/ugreen-leds.conf'' |+^ ugreen-diskiomon  | Script Bash da eseguire in loop infinito. Imposta la configurazione inziale dei LED dei dischi quindi aggiorna periodicamente il colore in base allo stato di salute S.M.A.R.T., allo stato on-line e allo stato di stand-by. Sempre in loop infinito invia un impulso al led se rileva attività del disco. Legge la configurazione da ''/etc/ugreen-leds.conf'' |
 ^ ugreen-blink-disk  | Eseguibile compilato, gira in loop infinito. Provvede a far lampeggiare i LED dei dischi se rileva attività di lettura o scrittura. Questo eseguibile, se esiste, viene usato dallo script ''ugreen-diskiomon'' invece di usare equivalenti istruzioni shell.  | ^ ugreen-blink-disk  | Eseguibile compilato, gira in loop infinito. Provvede a far lampeggiare i LED dei dischi se rileva attività di lettura o scrittura. Questo eseguibile, se esiste, viene usato dallo script ''ugreen-diskiomon'' invece di usare equivalenti istruzioni shell.  |
 ^ ugreen-check-standby  | **NOTA**: Non è incluso nel pacchetto Debian, va compilato dal sorgente ''scripts/check-standby.cpp''. Gira in loop infinito: cambia il colore dei LED dei dischi da COLOR_DISK_HEALTH a COLOR_DISK_STANDBY e viceversa quando il disco entra o esce dalla modalità stand-by. Se il LED ha colorazioni diverse, non le modifica. Questo eseguibile, se esiste, viene usato dallo script ''ugreen-diskiomon'' | ^ ugreen-check-standby  | **NOTA**: Non è incluso nel pacchetto Debian, va compilato dal sorgente ''scripts/check-standby.cpp''. Gira in loop infinito: cambia il colore dei LED dei dischi da COLOR_DISK_HEALTH a COLOR_DISK_STANDBY e viceversa quando il disco entra o esce dalla modalità stand-by. Se il LED ha colorazioni diverse, non le modifica. Questo eseguibile, se esiste, viene usato dallo script ''ugreen-diskiomon'' |
Line 438: Line 438:
 === Monitoraggio dischi === === Monitoraggio dischi ===
  
-Il servizio **ugreen-diskiomon.service**, se attivato, mette in bacground lo script **/usr/bin/ugreen-diskiomon**. Tale script molto complesso si occupa di monitorare lo stato dei dischi tramite le funzioni SMART, lo stato di stand-by, l'eventuale messa off-line per guasto e riflettere le varie condizioni con i colori configurati in **/etc/ugreen-leds.conf**. Lo script a sua volta mette in background il programma **/usr/bin/ugreen-blink-disk** che monitora l'attività dei dischi ed eventualmente manda segnali al ''/sys/class/leds/disk{1|2}/shot'' Per questo viene caricato il modulo kernel ''ledtrig-oneshot''.+Il servizio **ugreen-diskiomon.service**, se attivato, esegue in background lo script **/usr/bin/ugreen-diskiomon**
 + 
 +<code> 
 +systemctl enable --now ugreen-diskiomon.service 
 +</code> 
 + 
 +Tale script molto complesso si occupa di monitorare lo stato dei dischi tramite le funzioni SMART, lo stato di stand-by, l'eventuale messa off-line per guasto e riflettere le varie condizioni con i colori configurati in **/etc/ugreen-leds.conf**. Lo script a sua volta esegue in background il programma **/usr/bin/ugreen-blink-disk** che monitora l'attività dei dischi ed eventualmente manda segnali al ''/sys/class/leds/disk{1|2}/shot'' Per questo viene caricato il modulo kernel ''ledtrig-oneshot''. Anche il programma **/usr/bin/ugreen-check-stanby** viene eventualmente eseguito in background, per riflettere lo stato di stand-by dei dischi nel colore dei LED.
  
 === Monitoraggio scheda di rete === === Monitoraggio scheda di rete ===
  
-Il servizio **ugreen-netdevmon@enp1s0.service**, se attivato, mette in bacground lo script **/usr/bin/ugreen-netdevmon**. Il LED viene inizializzato per eseguire la funzione di base di lampeggiamento in caso di attività di rete, per questo viene caricato il modulo kernel ''ledtrig-netdev''. Questa funzione di base non ha bisogno dell'esecuzione di altri programmi in background, ma lo script resta in esecuzione per monitorare la raggiungibilità del gateway (tramite ping) le velocità del link. Eventuali anomalie sono segnalate con gli opportuni colori, configurati a loro volta in **/etc/ugreen-leds.conf**.+Il servizio **ugreen-netdevmon@enp1s0.service**, se attivato, esegue in background lo script **/usr/bin/ugreen-netdevmon** (Verificare che il nome della scheda di rete sia effettivamente **enp1s0**): 
 + 
 +<code> 
 +systemctl enable --now ugreen-netdevmon@enp1s0.service 
 +</code> 
 + 
 +Il LED viene inizializzato per eseguire la funzione di base di lampeggiamento in caso di attività di rete, per questo viene caricato il modulo kernel ''ledtrig-netdev''. Questa funzione di base non ha bisogno dell'esecuzione di altri programmi in background, ma lo script resta in esecuzione per monitorare la raggiungibilità del gateway (tramite ping) e la velocità del link. Eventuali anomalie sono segnalate con gli opportuni colori, configurati a loro volta in **/etc/ugreen-leds.conf**.
  
 ===== Web References ===== ===== Web References =====
doc/appunti/hardware/ugreen_dxp2800.1765874681.txt.gz · Last modified: by niccolo