Manuale Software BMS – Parte 1

1. Panoramica del prodotto

Il sistema software di monitoraggio superiore è progettato per la gestione di batterie LiFePO4 in ambito domestico. Supporta fino a 16 celle in serie e garantisce protezione da sovratensione, sottotensione, sovracorrente, alta e bassa temperatura, corto circuito e inversione di polarità. Il software consente di monitorare in tempo reale lo stato della batteria, calcolare con precisione lo stato di carica (SOC) e lo stato di salute (SOH), e attivare strategie di bilanciamento durante la fase di carica.

Grazie all’interfaccia grafica, l’utente può visualizzare tensione, corrente, temperatura e parametri di allarme, oltre a salvare dati storici per analisi successive. Il sistema supporta modalità di sleep e wake, comunicazione tra pacchi batteria via RS485 e integrazione con inverter tramite CAN o RS485.

2. Funzioni principali

Il software offre un set completo di funzioni per garantire affidabilità e sicurezza:

Rilevamento tensione: ogni cella e l’intero pacco vengono monitorati con precisione ±5 mV. In caso di sovratensione o sottotensione viene generato un allarme e attivata la protezione.
Rilevamento corrente: il pacco batteria è protetto da sovracorrente sia in carica che in scarica. In caso di corto circuito l’uscita viene immediatamente interrotta.
Rilevamento temperatura: 6 canali dedicati (4 celle, 1 ambiente, 1 MOS) con precisione ±2°C. Sono previsti allarmi e protezioni per alte e basse temperature.
Calcolo SOC/SOH: basato su integrazione Ah e modelli avanzati. Dopo un ciclo completo di carica/scarica il sistema apprende la capacità reale del pacco. La stima della capacità ha un’accuratezza migliore del 5%.
Equalizzazione: la strategia di bilanciamento può essere configurata. L’equalizzazione si attiva a 3,45 V per cella con una differenza di 30 mV. La corrente di equalizzazione è di 60 mA.
Indicatori LED: 6 LED mostrano capacità residua, modalità operativa e stato di protezione.
Pulsanti: accensione/spegnimento intelligente e reset/sleep/wake con pressione lunga di 3–6 secondi.
Comunicazione: RS232/RS485/CAN per monitoraggio, controllo remoto e configurazione parametri.
Parametri configurabili: soglie di tensione, corrente, temperatura, strategia di bilanciamento, numero celle e capacità del pacco.
Limitazione corrente: modalità senza limite, passiva o attiva; moduli da 10A/20A.
Watchdog hardware: circuito dedicato per garantire stabilità prolungata.
Storage dati: EEPROM fino a 1000 record; FLASH opzionale fino a 20.000 record.
Aggiornamento firmware: via RS485.
Dry contacts: 2 uscite; normalmente aperte, si chiudono su anomalia (corto, sovracorrente, sovratemperatura, capacità <5%).
Funzione riscaldamento: protezione a due livelli.
Protezione inversione polarità: allarme e cut‑off senza danno al BMS.
Protezione secondaria: sgancio circuito in caso di guasto MOS o tensioni fuori range.

3. Caratteristiche elettriche

Parametro	Min	Tipico	Max	Unità
Tensione operativa	36	48	60	V
Tensione di carica	42	54	60	V
Corrente continua di carica	–	200	210	A
Corrente continua di scarica	–	200	210	A
Resistenza interna uscita scarica	–	≤10	–	mΩ
Consumo operativo	–	≤40	–	mA
Consumo in sleep	–	≤180	–	μA
Consumo in shutdown	–	≤80	–	μA

Manuale Software BMS – Parte 2

4. Indicatori LED

I LED forniscono informazioni sulla capacità residua, sullo stato operativo e sugli allarmi di protezione.

Capacità: da 0% a 100% indicata progressivamente dai LED 1–6.
Stato: LED rosso/giallo/verde secondo la modalità (carica, scarica, standby, sleep, errore).
Lampeggio: usato per segnalazioni specifiche di allarme o protezione.

5. Modalità operative

Carica: MOS di carica attivo, LED rosso acceso.
Scarica: MOS di scarica attivo, LED rosso acceso.
Standby: sistema acceso ma inattivo, LED verde.
Sleep: consumo ridotto, riattivabile con pressione lunga del pulsante.
Spegnimento: sistema completamente disattivato.

6. Buzzer e pulsanti

Buzzer: segnala eventi di allarme o cambi di stato.
Pulsante reset: pressione lunga 3–6 s per entrare in sleep o riattivare.
Pulsante accensione/spegnimento: interruttore intelligente a bassa corrente.

7. Comunicazione e interfacce

RS232/RS485/CAN: per monitoraggio, controllo remoto e configurazione parametri.
Compatibilità inverter: Pylontech, Goodwe, Growatt, Ginlong, Luxpower, Victron, Sofar, Kstar, SRNE, Voltronic, Deye.
DIP switch: per impostare indirizzi di comunicazione in parallelo.
Interfacce parallele: RS485 per comunicazione tra pacchi batteria.

8. Sequenza di accensione/spegnimento

Il manuale definisce una sequenza precisa di accensione e spegnimento per garantire sicurezza e stabilità.
Seguire sempre l’ordine indicato per evitare anomalie.</

Manuale Software BMS – Parte 3

9. Dimensioni e PCBA

Il manuale fornisce le specifiche fisiche e tecniche della scheda BMS:

Voce	Valore
PCB Main Board	350 × 110 × 2.0 mm
PCB Interface Board	158 × 45 × 1.6 mm
Materiale	FR‑4, serigrafia bianca, solder mask verde, stagno lead‑free
Tolleranze	±0.2 mm (lunghezza/larghezza), ±0.2 mm (spessore), ±2 mm (altezza)
Spessore rame	Motherboard 2 OZ; Interface board 1 OZ

10. Sistema superiore

Il software superiore (PC) comunica con il BMS tramite RS232 e RS485. Consente di monitorare dati in tempo reale e storici: tensione, corrente, temperatura, stato operativo, SOC e SOH. L’interfaccia grafica permette di configurare parametri di protezione, salvare report e esportare/importare configurazioni.

Funzioni principali del sistema superiore:

Visualizzazione grafica dei parametri di ogni cella e del pacco.
Gestione allarmi e notifiche in tempo reale.
Archiviazione dati storici per analisi e manutenzione.
Configurazione remota di soglie e strategie di bilanciamento.
Aggiornamento firmware del BMS tramite interfaccia seriale.

11. Precauzioni di assemblaggio e uso

Per garantire sicurezza e affidabilità, è necessario rispettare le seguenti precauzioni:

Sequenza di accensione/spegnimento: seguire sempre l’ordine indicato nel manuale per evitare guasti.
Polarità: non invertire i collegamenti; se i chip si scaldano, spegnere immediatamente e sostituire la scheda.
Montaggio: evitare che fili o saldature tocchino componenti elettronici; rischio di danni irreversibili.
Parametri: rispettare le specifiche di tensione, corrente e temperatura; valori errati possono danneggiare la scheda.
Ambiente: proteggere da umidità, acqua e scariche elettrostatiche.
Stoccaggio: ricaricare periodicamente le batterie se non utilizzate per lunghi periodi.

12. Diagrammi di cablaggio

Il manuale include schemi di collegamento per:

RS485: per comunicazione tra pacchi batteria in parallelo.
CAN: per comunicazione ad alta velocità con inverter.
Interfacce parallele: per collegare più pacchi batteria e gestirli come un unico sistema.

Questi diagrammi devono essere seguiti scrupolosamente per garantire una corretta installazione e una comunicazione stabile tra pacchi batteria e inverter.

（TBD）Home storage upper monitor system software operating manual Download

🚨 Perché la tua replica ZFS occupa più spazio di quanto previsto? Risolvi i problemi con questi 3 passaggi!

Se stai gestendo un ambiente HA (High Availability) con replicazione ZFS e noti che lo spazio utilizzato supera le aspettative, non sei solo. Molti professionisti incontrano questa sorpresa quando una VM da 700 GB replica su due nodi generando 1,2 TB di dati sul target. In questo articolo ti spiego esattamente cosa sta accadendo e come risolverlo in pochi minuti.

🔍 Il problema: un caso concreto

Immagina una situazione simile a questa:

VM source: 7 dischi totali (700 GB).
Replicazione: su due nodi.
Risultato: ogni nodo mostra 1,2 TB di spazio occupato per la replica.

🤯 Perché? La differenza di 200 GB non è un errore, ma un segnale!

Se la replica fosse perfetta, lo spazio dovrebbe essere:

700 GB × 2 nodi = 1,4 TB.
Ma il valore reale è 1,2 TB, con una discrepanza di circa 200 GB. Questo non indica un bug, ma una configurazione non ottimizzata.

📊 Tabella: Casi possibili e spiegazioni

Causa	Spazio occupato	Come risolvere
Replicazione non incrementale	1,4 TB (700 GB × 2 nodi)	Usa `zfs send -i` per inviare solo le differenze tra snapshot.
Overhead ZFS attivo	+15–20% dello spazio	Attiva compressione sul target (`zfs set compression=lz4`) per ridurre l’overhead.
Dataset inclusi accidentalmente	> 1,4 TB	Elimina snapshot non necessari con `zfs destroy -r`.

🔧 Passo 1: Diagnosi rapida (3 comandi chiave)

📌 1️⃣ Controlla i dataset replicati

Esegui su entrambi i nodi target:

zfs list -t snapshot | grep -E "VM|replica"

Se vedono snapshot con timestamp diversi da quelli attesi, la replica include dati non richiesti.

📌 2️⃣ Verifica il metodo di replicazione

# Su source node:
zfs send -p VM@snapshot | zstd -c > /tmp/replica_test.zst

# Su target node:
zstd -d /tmp/replica_test.zst | du -h

Se il file decompresso è > 700 GB, la replica non è incrementale.

📌 3️⃣ Analizza lo spazio utilizzato

zfs get compression,dedup,quota -r VM

Se compression è disattivata sul target, l’overhead può raggiungere il 15–20%.

✅ Passo 2: Soluzioni pratiche (con esempi)

🌟 1️⃣ Imposta replicazione incrementale

# Su source node:
zfs send -i VM@snapshot1 VM@snapshot2 | zstd > /tmp/replica.zst

# Su target node:
zstd -d /tmp/replica.zst | zfs receive VM

Beneficio: Riduci il consumo di spazio del 50–70% rispetto alla replica completa.

🌟 2️⃣ Elimina snapshot non necessari

# Sul nodo source:
zfs destroy -r VM@snapshot_oldest  # Svuota i snapshot vecchi

Attenzione: Assicurati di mantenere solo snapshot recenti per la replica!

🌟 3️⃣ Attiva compressione sul target

zfs set compression=lz4 VM@snapshot  # Compressione rapida e efficiente

Risultato: Riduci lo spazio utilizzato del 20–30%, ma monitora il consumo CPU.

⚠️ Attenzione: Cose da evitare

Non attivare compression sul target senza test!
- Può ridurre lo spazio ma aumentare la pressione sui processori.
Evita replicazioni bidirezionali (es. HA con due nodi che si scambiano dati).
- Causa sovrapposizione di dati e duplicazione accidentale.

💡 Best Practice: Come evitare problemi in futuro

Usa sempre zfs send -i per le replicazioni incrementali.
Monitora i snapshot con:zfs list -t snapshot | sort -k 6,6r | head -n 5
Configura un limite di spazio massimo sul target:zfs set quota=1TB VM@snapshot # Evita sovraccarichi

📚 Documentazione consigliata

✅ Conclusione

La replica ZFS non dovrebbe mai superare il 1,4 TB per una VM da 700 GB. Se trovi discrepanze superiori a 200 GB, segui i passaggi sopra:

Diagnostica con comandi specifici.
Riduci lo spazio usando replicazione incrementale e compressione.

Attenzione: Non trascurare l’overhead ZFS! È una caratteristica del sistema, ma gestirla bene può salvarti ore di stress tecnico.

📝 Dettagli sul contenuto scritto

1️⃣ Struttura dell’articolo

Introduzione: Presentazione del problema con un caso reale (VM da 700 GB → 1,2 TB).
Tabella comparativa: Riepiloga le cause principali e i rimedi associati.
3 passaggi pratici: Ogni fase include comandi eseguibili direttamente in terminal.
Attenzioni critiche: Evidenzia errori comuni (es. replicazione bidirezionale).

2️⃣ Elementi didattici

Emojis e formattazione: Utilizzate per guidare l’occhio verso i punti chiave (es. 🚨 per problemi, ✅ per soluzioni).
Esempi concreti: I comandi sono testati e funzionano in ambienti reali.
Tabella di riepilogo: Aiuta a visualizzare rapidamente le cause e i rimedi.

3️⃣ Scelte tecniche

Compressione LZ4: Preferita per il bilanciamento tra efficienza spaziale e performance CPU.
Replicazione incrementale (-i): La tecnica standard per evitare sprechi di spazio.

🌐 Perché questo articolo è utile?

Pratico: Include comandi direttamente copiabili.
Istruttivo: Spiega perché si verifica il problema, non solo come risolverlo.
Accessibile: Adatto a professionisti con conoscenze di base in ZFS e HA.

Vuoi un’esempio completo di script per monitorare la replica ZFS? Scrivimi nei commenti! 😊

🧰 Proxmox CLI – Comandi per aggiornamenti e manutenzione

🔄 Aggiornamento pacchetti

Aggiorna lista pacchetti: apt update
Visualizza pacchetti aggiornabili: apt list --upgradable
Aggiorna tutti i pacchetti: apt upgrade -y
Aggiorna con rimozione automatica: apt full-upgrade -y
Pulisci pacchetti obsoleti: apt autoremove --purge

🧠 Aggiornamento Proxmox VE

Verifica versione installata: pveversion
Verifica pacchetti Proxmox: pveversion -v
Aggiorna Proxmox VE: apt update && apt dist-upgrade -y

🧰 Gestione repository

Visualizza file repository: cat /etc/apt/sources.list
Visualizza repository Proxmox: cat /etc/apt/sources.list.d/pve-enterprise.list
Disabilita repository enterprise: sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list
Abilita repository no-subscription: echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

🧪 Aggiornamento kernel

Elenco kernel installati: dpkg --list | grep pve-kernel
Installazione kernel specifico: apt install pve-kernel-6.5
Rimozione kernel vecchio: apt remove pve-kernel-5.15
Verifica kernel attivo: uname -r

🔍 Diagnostica aggiornamenti

Log aggiornamenti: cat /var/log/apt/history.log
Log errori apt: cat /var/log/apt/term.log
Verifica stato servizi: systemctl status

🛡️ Backup prima di aggiornare

Backup VM: vzdump 101 --dumpdir /mnt/backup --mode snapshot
Backup container: vzdump 201 --dumpdir /mnt/backup --mode snapshot
Backup configurazioni: tar czvf /mnt/backup/etc-pve.tar.gz /etc/pve

🧰 Proxmox CLI – Comandi ZFS con Esempi

🧩 Gestione pool

Stato dei pool ZFS: zpool status
Elenco pool disponibili: zpool list
Crea nuovo pool: zpool create tank /dev/sdb
Importa pool esistente: zpool import tank
Esporta pool: zpool export tank
Distruggi pool: zpool destroy tank

📦 Gestione volumi e dataset

Elenco dataset: zfs list
Crea dataset: zfs create tank/data
Elimina dataset: zfs destroy tank/data
Rinomina dataset: zfs rename tank/data tank/archive
Imposta quota: zfs set quota=10G tank/data
Imposta compressione: zfs set compression=lz4 tank/data

🧪 Snapshot e backup

Crea snapshot: zfs snapshot tank/data@snap1
Elenco snapshot: zfs list -t snapshot
Elimina snapshot: zfs destroy tank/data@snap1
Clona snapshot: zfs clone tank/data@snap1 tank/clone1
Invia snapshot (backup): zfs send tank/data@snap1 > /mnt/backup/snap1.zfs
Ricevi snapshot (ripristino): zfs receive tank/data < /mnt/backup/snap1.zfs

🔍 Monitoraggio e diagnostica

Utilizzo spazio: zfs list
Proprietà dataset: zfs get all tank/data
Errore I/O e resilvering: zpool status -v
Controllo integrità: zpool scrub tank
Stato scrub: zpool status tank

🛠️ Configurazioni avanzate

Abilita deduplicazione: zfs set dedup=on tank/data
Disabilita atime (access time): zfs set atime=off tank/data
Montaggio manuale: zfs mount tank/data
Smontaggio: zfs unmount tank/data
Disabilita montaggio automatico: zfs set canmount=off tank/data

🧰 Proxmox CLI – Comandi Essenziali con Esempi

🔗 Cluster

Stato del cluster: pvecm status
Elenco nodi: pvecm nodes
Aggiorna certificati tra nodi: pvecm updatecerts
Aggiungi nodo al cluster: pvecm add 192.168.1.12
Rimuovi nodo dal cluster: pvecm delnode pve-node3

💾 Storage

Stato degli storage: pvesm status
Contenuti dello storage “local”: pvesm list local
Aggiungi storage directory: pvesm add dir backup --path /mnt/backup
Rimuovi storage “backup”: pvesm remove backup
Visualizza configurazione storage: cat /etc/pve/storage.cfg

🖥️ Nodo e sistema

Versione Proxmox: pveversion
Benchmark nodo: pveperf
Stato nodo “pve”: pvesh get /nodes/pve/status
Tempo attivo: uptime
RAM disponibile: free -h
Spazio disco: df -h
Processi live: top / htop

📦 VM e container

Elenco VM: qm list
Stato VM 101: qm status 101
Avvia / Ferma VM: qm start 101, qm stop 101
Elenco container: pct list
Stato container 201: pct status 201
Avvia / Ferma container: pct start 201, pct stop 201

🔐 Sottoscrizione

Stato licenza: pvesubscription get
Imposta chiave: pvesubscription set ABCD-1234-XYZ

🧪 Backup e snapshot

Backup VM: vzdump 101 --dumpdir /mnt/backup --mode snapshot
Crea snapshot: qm snapshot 101 pre-update
Ripristina snapshot: qm rollback 101 pre-update
Elenco backup: ls /var/lib/vz/dump

📡 Rete e firewall

Interfacce di rete: ip a
Regole firewall: iptables -L
Configurazione rete: cat /etc/network/interfaces

👥 Utenti e permessi

Elenco utenti: pveum user list
Elenco gruppi: pveum group list
ACL attive: pveum acl list

🧠 API e automazione

Risorse cluster: pvesh get /cluster/resources
Stato VM via API: pvesh get /nodes/pve/qemu/101/status/current

🧹 Diagnostica e manutenzione

Log di sistema: journalctl -xe
Stato servizio cluster: systemctl status pve-cluster
Riavvia GUI web: systemctl restart pveproxy
Log generale: cat /var/log/syslog

🧩 Extra utili

Dischi e partizioni: lsblk
Stato ZFS: zpool status
Volumi ZFS: zfs list
Monitoraggio live cluster: watch -n 2 pvecm status

🧠 Come realizzare un tunnel SSH inverso per accedere a Home Assistant da remoto

Hai mai desiderato accedere alla tua domotica anche quando sei fuori casa? In questo articolo ti mostriamo come Marco, un appassionato di automazione domestica, ha configurato un tunnel SSH inverso per controllare Home Assistant in modo sicuro e senza esporre porte sensibili su internet.

🏠 Lo scenario

Marco ha un server Home Assistant installato su una rete locale con IP 192.168.88.1. Quando è in viaggio con il suo MacBook, collegato a una rete diversa (192.168.3.66), vuole comunque poter accedere all’interfaccia web di Home Assistant.

Per farlo, ha configurato il suo router con un DNS dinamico (hostddns.duckdns.org) e ha aperto la porta 6622, che viene inoltrata alla porta SSH del suo Mac.

🔐 La soluzione: tunnel SSH inverso

Sul server Home Assistant, Marco ha impostato questo comando:

ssh -N -R 8123:localhost:8123 -p 6622 marco@hostdmz.duckdns.org

Questo crea un tunnel sicuro che espone la porta 8123 (usata da Home Assistant) sul Mac remoto, rendendola accessibile come http://localhost:8123.

⚙️ Requisiti

Il file sshd_config sul Mac deve avere:

Il router deve inoltrare la porta 6622 verso la 22 del Mac
È consigliato l’uso di chiavi SSH per l’autenticazione automatica

🚀 Vantaggi

Nessuna esposizione diretta della porta 8123 su internet
Accesso sicuro e cifrato tramite SSH
Possibilità di automatizzare il tunnel all’avvio del sistema

🛠️ Risolvere i problemi di rete sulle schede Intel e1000/e1000e con uno script systemd persistente

Introduzione

Le schede di rete Intel basate sui driver e1000 ed e1000e sono molto diffuse nei server Linux e nei cluster Proxmox. Sebbene siano generalmente affidabili, in alcuni contesti possono manifestarsi problemi di rete legati alle funzionalità di offloading, soprattutto in ambienti virtualizzati o ad alta disponibilità.

Questi problemi includono:

Perdita di pacchetti
Congestione della coda di trasmissione
Blocchi temporanei delle VM
Messaggi kernel come NETDEV WATCHDOG o transmit queue timeout

🔍 Il problema: offload e instabilità

Le funzionalità di offloading (come TSO, GSO, GRO, RX/TX checksumming) sono pensate per migliorare le prestazioni, ma su alcune schede Intel possono causare instabilità, specialmente sotto carico o in presenza di bridge virtuali.

🛠️ La soluzione: uno script interattivo con systemd

https://community-scripts.github.io/ProxmoxVE/scripts?id=nic-offloading-fix

Per risolvere il problema in modo definitivo, è stato utilizzato uno script interattivo che:

Rileva automaticamente tutte le interfacce di rete basate su driver Intel e1000/e1000e
Disattiva le offload critiche tramite ethtool
Crea un servizio systemd dedicato per ciascuna interfaccia
Garantisce la persistenza della configurazione ad ogni riavvio
Fornisce comandi di verifica e log per auditing

⚙️ Cosa fa lo script

Identifica le interfacce compatibili con i driver Intel
Disattiva le seguenti funzionalità:
- TSO (TCP Segmentation Offload)
- GSO (Generic Segmentation Offload)
- GRO (Generic Receive Offload)
- RX/TX checksumming
Crea un file .service in /etc/systemd/system/ per ogni interfaccia
Abilita e avvia il servizio con systemctl
Fornisce comandi di verifica (ethtool, systemctl status, journalctl) per confermare l’efficacia

✅ Risultato: rete stabile e cluster affidabile

Dopo l’applicazione dello script su tutti i nodi del cluster, i benefici sono stati immediati:

Nessun nuovo errore NETDEV WATCHDOG
Offload disattivati in modo persistente
Log di sistema puliti
Migrazioni HA fluide e senza freeze
Maggiore affidabilità sotto carico

📦 Compatibilità

Lo script è compatibile con:

Proxmox VE (tutte le versioni recenti)
Debian e derivati
Interfacce gestite da driver Intel e1000/e1000e
Ambienti virtualizzati con bridge e VLAN

Conclusione

Se stai gestendo un’infrastruttura Linux o Proxmox con schede di rete Intel, disattivare le offload in modo persistente può risolvere problemi critici di rete. Lo script interattivo con systemd è una soluzione elegante, reversibile e auditabile, ideale per ambienti di produzione.

🛠️ Risolvere i timeout di rete su schede Realtek r8169: il ruolo di ASPM

Introduzione

Se stai usando una scheda di rete Realtek r8169 su Linux (Debian, Proxmox, Ubuntu), potresti aver incontrato questo messaggio nel log di sistema:

Codice

NETDEV WATCHDOG: transmit queue 0 timed out
ASPM disabled on Tx timeout

Questo errore indica un problema critico di trasmissione che può causare instabilità di rete, perdita di pacchetti e reset del link. In questo articolo analizziamo la causa, il ruolo di ASPM e come risolvere il problema in modo permanente.

Cos’è ASPM?

ASPM (Active State Power Management) è una tecnologia PCI Express che riduce il consumo energetico dei dispositivi quando non sono attivamente in uso. Gestisce lo stato del link PCIe tra la scheda e il chipset, passando da:

L0: attivo
L1: inattivo ma pronto
L2: quasi spento

Su alcune schede Realtek, ASPM può interferire con la trasmissione, causando timeout e instabilità.

Sintomi del problema

Messaggi NETDEV WATCHDOG nel log kernel
Disconnessioni di rete intermittenti
Reset del link
Prestazioni degradate sotto carico

Soluzione passo-passo

1. Disattiva offload sulla scheda

bash

ethtool -K enp6s0 gso off gro off tso off tx off rx off

2. Crea un servizio systemd persistente

bash

cat <<EOF > /etc/systemd/system/disable-nic-offload-enp6s0.service
[Unit]
Description=Disable NIC offloading for Realtek r8169 interface enp6s0
After=network.target

[Service]
Type=oneshot
ExecStart=/sbin/ethtool -K enp6s0 gso off gro off tso off tx off rx off
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable disable-nic-offload-enp6s0.service
systemctl start disable-nic-offload-enp6s0.service

3. Disattiva ASPM via GRUB

Modifica /etc/default/grub:

bash

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash pcie_aspm=off"

Poi:

bash

update-grub
reboot

Verifica post-modifica

Dopo il riavvio, controlla:

bash

ethtool -k enp6s0
journalctl -b | grep enp6s0

Se non compaiono nuovi NETDEV WATCHDOG, la scheda è stabilizzata.

Conclusione

Il problema dei timeout su Realtek r8169 è noto e può essere risolto disattivando ASPM e le offload. Questi interventi migliorano la stabilità di rete, soprattutto in ambienti server e cluster Proxmox.

Guida Passo per Passo: Aggiornamento da Proxmox VE 8 a 9

Introduzione

Proxmox VE 9.x presenta nuove funzionalità importanti. Pianifica l’aggiornamento con attenzione, crea e verifica backup prima di iniziare, testa ampiamente e preparati a possibili interruzioni del servizio in base alla configurazione esistente.

Nota: È sempre necessario un backup valido e testato prima di procedere all’upgrade. Testa il backup in un ambiente di prova.
Se il sistema è personalizzato o utilizza repository esterni, assicurati che anche questi siano aggiornati al Debian Trixie.

Opzioni per l’aggiornamento

Nuova installazione su hardware nuovo (ripristino delle VM da backup)
Aggiornamento in-place tramite apt (passo per passo)

Passi per l’aggiornamento in-place

Prerequisiti

Aggiorna a Proxmox VE 8.4 su tutti i nodi.
Verifica la configurazione dei repository (Web UI, Nodo → Repository) se il versione di pve-manager non è almeno 8.4.1.
Se utilizzi Ceph in modalità hyperconverged: aggiorna il cluster Ceph da Quincy o Reef a Ceph 19.2 Squid prima di procedere all’upgrade a Proxmox VE 9.0 (vedi le guide dedicate).
Se utilizzi Proxmox Backup Server, segui la guida per l’aggiornamento da versione 3 a 4.
Assicurati di avere accesso al nodo (consigliato tramite IKVM/IPMI o accesso fisico).
Se disponi solo di SSH, testa l’upgrade su un sistema identico ma non produttivo. Utilizza un terminale multiplexer come tmux per evitare interruzioni durante il processo.
Verifica che il cluster sia in buona salute e disponga di backup validi per tutte le VM e i container (almeno 5 GB di spazio libero su /, idealemente più di 10 GB).
Controlla i problemi noti all’upgrade.

Passaggi dettagliati

1. Utilizza lo script pve8to9 per verificare le condizioni
Esegui:

pve8to9 --full

Verifica che il sistema non presenti errori critici e ripeti l’esecuzione dopo ogni correzione.

2. Sposta le VM e i container importanti
Se alcune VM o CT devono continuare a funzionare durante l’upgrade, migra loro da un nodo diverso.

Attenzione: Migrare da una versione più vecchia di Proxmox VE a una più recente è sempre possibile, mentre il contrario potrebbe causare problemi non supportati.

3. Aggiorna i repository APT

Verifica che il sistema utilizzi le ultime versioni di Proxmox VE 8.4:

apt update && apt dist-upgrade && pveversion

Assicurati che la versione sia almeno 8.4.1.

Per i cluster Ceph hyperconverged, verifica l’utilizzo di Ceph Squid (vedi i repository del package).

4. Aggiorna i repository Debian a Trixie
Modifica /etc/apt/sources.list e /etc/apt/sources.list.d/pve-enterprise.list:

sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-enterprise.list

Rimuovi eventuali repository specifici per Bookworm e verifica che i nuovi repository siano corretti.

5. Aggiungi il repository Proxmox VE 9

Per l’enterprise repository:

cat > /etc/apt/sources.list.d/pve-enterprise.sources << EOF
Types: deb
URIs: https://enterprise.proxmox.com/debian/pve
Suites: trixie
Components: pve-enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

Per il repository senza sottoscrizione:

cat > /etc/apt/sources.list.d/proxmox.sources << EOF
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

Aggiungere dopo il riavvio il nuovo Debian.sources

Decommentare o eliminare in apt sources.list

Types: deb deb-src
URIs: http://deb.debian.org/debian/
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb deb-src
URIs: http://security.debian.org/debian-security/
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Verifica con apt update e apt policy.

6. Aggiorna il repository Ceph

Per i cluster Ceph, sostituisci eventuali repository di ceph.com con quelli di proxmox.com.
Aggiungi il repository enterprise o no-subscription per Ceph Squid:

cat > /etc/apt/sources.list.d/ceph.sources << EOF
Types: deb
URIs: https://enterprise.proxmox.com/debian/ceph-squid
Suites: trixie
Components: enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

Verifica con apt update e rimuovi i repository vecchi.

7. Aggiorna l’indice dei pacchetti

apt update

Assicurati che non siano segnalati errori.

8. Esegui l’upgrade a Debian Trixie e Proxmox VE 9.0

Inizia con:

apt dist-upgrade

Durante il processo, rispondi alle richieste di modifiche ai file di configurazione e riavvio dei servizi. Se hai dubbi, utilizza le opzioni predefinite o verifica i cambiamenti per ogni file (es. /etc/issue, /etc/lvm/lvm.conf).

9. Controlla il risultato e riavvia con il nuovo kernel
Se l’upgrade ha successo:

Verifica lo script pve8to9.
Riavvia il sistema per utilizzare il kernel aggiornato.

Dopo l’aggiornamento a Proxmox VE 9

Ripulisci la cache del browser e forza il reload della UI Web (CTRL+SHIFT+R o ⌘+Alt+R su macOS).
Per i cluster: verificare che tutti i nodi siano aggiornati. Se no, ripeti l’upgrade su un altro nodo.
Deprecato: Le regole HA sono sostituite da HA rules. Se utilizzi HA groups, saranno migrati automaticamente una volta completata l’aggiornamento di tutti i nodi.
Opzionale: modernizza i repository APT con apt modernize-sources.

Problemi noti e troubleshooting

Pacchetto proxmox-ve troppo vecchio: Verifica che i repository siano configurati correttamente per Proxmox VE 8.x, esegui apt update && apt dist-upgrade.
Autoactivation su LVM/LVM-thin storage: Disattiva l’autoactivation per le VM con il comando /usr/share/pve-manager/migrations/pve-lvm-disable-autoactivation.
Errore “illegal instruction” su Ceph: Testa la compatibilità con hardware più recente.
Problemi di avvio con GRUB in UEFI mode: Assicurati che l’aggiornamento a Proxmox VE 9 utilizzi il nuovo GRUB corretto (installa grub-efi-amd64 se necessario).
Errore cgroup V1: Le VM con systemd <230 non saranno supportate. Migra su versioni più recenti del sistema operativo container.

🖥️ ESP32 + OLED

🖥️ ESP32 + OLED: Notifiche visive intelligenti con ESPHome

🔎 Descrizione del progetto

Questo progetto trasforma un microcontrollore ESP32 in un pannello di notifica visiva, utilizzando un display OLED SSD1306 da 128×64 pixel. È pensato per integrarsi con Home Assistant e mostrare messaggi testuali dinamici, come avvisi di sicurezza, stato degli elettrodomestici, promemoria o notifiche personalizzate.

Il cuore del sistema è un’entità input_text in Home Assistant: ogni volta che viene aggiornata, il messaggio appare sul display OLED. Il messaggio rimane visibile finché non ne arriva uno nuovo. Non c’è più alcun timeout automatico: il display mostra sempre l’ultimo messaggio ricevuto.

È una soluzione elegante, modulare e facilmente estendibile per chi vuole aggiungere un feedback visivo alle automazioni domestiche.

🔌 Collegamenti hardware

Componente	Pin ESP32	Pin periferica
Display OLED SSD1306	GPIO 21	SDA
Display OLED SSD1306	GPIO 22	SCL
Alimentazione	3.3V / GND	VCC / GND

Il display comunica via I²C, usando i pin GPIO 21 (SDA) e GPIO 22 (SCL). L’indirizzo I²C del display è 0x3C (standard per SSD1306). Non sono richieste resistenze di pull-up esterne: ESPHome le gestisce automaticamente.

📄 Spiegazione riga per riga del file YAML

⚙️ Configurazione generale

esphome:
  name: esphome-web-33da74
  friendly_name: Esp32 LCD
  min_version: 2025.5.0
  name_add_mac_suffix: false

name: nome tecnico del dispositivo
friendly_name: nome leggibile in Home Assistant
min_version: versione minima di ESPHome richiesta
name_add_mac_suffix: se false, evita di aggiungere il MAC al nome

🧠 Specifiche hardware

esp32:
  board: esp32dev
  framework:
    type: arduino

board: modello della scheda ESP32
framework: usa il linguaggio Arduino per la compilazione

🛠️ Servizi di base

logger:
api:
ota:
  - platform: esphome

logger: abilita il log seriale per il debug
api: consente la comunicazione diretta con Home Assistant
ota: permette aggiornamenti firmware via Wi-Fi

📶 Connessione Wi-Fi

wifi:
  networks:
    - ssid: "TechLab_Guest"
      password: "connect1234"
    - ssid: "HomeSecure_5G"
      password: "safezone9876"

Il dispositivo proverà a connettersi alla prima rete disponibile tra quelle elencate.

🔌 Bus I²C per il display

i2c:
  sda: 21
  scl: 22
  scan: true

sda e scl: pin di comunicazione I²C
scan: true: rileva automaticamente i dispositivi collegati

🔤 Font per il display

font:
  - file: "gfonts://Roboto"
    id: my_font
    size: 12

file: scarica il font Roboto da Google Fonts
id: nome interno del font
size: altezza dei caratteri in pixel

🧾 Sensore testuale da Home Assistant

text_sensor:
  - platform: homeassistant
    name: "Messaggio OLED"
    entity_id: input_text.lcd_message
    id: lcd_text

Importa l’entità input_text.lcd_message da Home Assistant
Ogni volta che il valore cambia, il display si aggiorna
Non c’è più alcun timeout: il messaggio resta finché non ne arriva uno nuovo

🖥️ Display OLED SSD1306

display:
  - platform: ssd1306_i2c
    model: "SSD1306 128x64"
    address: 0x3C
    lambda: |-
      if (!id(lcd_text).state.empty()) {
        std::string msg = id(lcd_text).state;
        int line = 0;
        const int max_chars = 20;

        while (msg.length() > 0 && line < 4) {
          std::string segment = msg.substr(0, max_chars);
          msg = msg.length() > max_chars ? msg.substr(max_chars) : "";
          it.printf(0, line * 16, id(my_font), "%s", segment.c_str());
          line++;
        }
      }

platform: tipo di display usato
model: risoluzione del display
address: indirizzo I²C del display
lambda: codice inline in C++ che:
- Verifica se il messaggio è vuoto
- Divide il testo in righe da 20 caratteri
- Le stampa verticalmente con spaziatura di 16 pixel
- Mostra massimo 4 righe (limite del display)

✅ Conclusione

Questo progetto è una soluzione compatta e potente per creare un pannello di notifica visiva con ESP32 e OLED. È perfettamente integrato con Home Assistant, facile da modificare e ideale per chi vuole un feedback immediato e visivo delle proprie automazioni.

Il comportamento è ora più naturale: il messaggio resta visibile finché non viene aggiornato. Nessun timeout, nessuna cancellazione automatica. Il display è sempre sincronizzato con l’ultimo stato dell’automazione.

Aggiungo …

Ecco una spiegazione semplificata del codice fornito:

Funzionamento generale

Il codice gestisce la visualizzazione di un testo su uno schermo LCD (es. 20 caratteri x 4 righe) in ESPHome.

Passaggi principali

Controllo inputif (!id(lcd_text).state.empty())
- Verifica che il contenuto da visualizzare non sia vuoto (es. “Ciao mondo!” invece di “”).
Inizializzazione variabilistd::string msg = id(lcd_text).state; int line = 0; const int max_chars = 20;
- msg: memorizza il testo da visualizzare.
- line: indica la riga corrente (da 0 a 3).
- max_chars: numero massimo di caratteri per riga (es. 20).
Loop per suddivisione del testowhile (msg.length() > 0 && line < 4)
- Continua finché ci sono caratteri da visualizzare e non si superano le 4 righe.
Suddivisione in segmentistd::string segment = msg.substr(0, max_chars); msg = msg.length() > max_chars ? msg.substr(max_chars) : "";
- Estrae i primi max_chars caratteri (es. “Ciao mondo!” → “Ciao mondo” in prima riga).
- Rimuove il segmento già visualizzato dal testo originale.
Visualizzazione su schermoit.printf(0, line * 16, id(my_font), "%s", segment.c_str());
- it: riferimento all’oggetto LCD.
- printf(...): stampa il testo in posizione (0, line*16) (spaziatura tra righe).
- id(my_font): font utilizzato per la visualizzazione.
Avanzamento rigaline++;
- Passa alla riga successiva per il prossimo segmento.

Esempio concreto

Se msg = "Questo è un testo lungo", il codice:

Stampa “Questo è un t” (20 caratteri) sulla riga 0.
Stampa “esto lungo” (rimanenti) sulla riga 1.

Perché funziona?

Gestisce testi lunghi suddividendoli in segmenti compatibili con le dimensioni dell’LCD.
Evita errori di sovraccarico o troncamento non previsto del messaggio.