Volumio 3/4 zásuvný modul pre podsvietenie LCD
Návštevy: 479
Zásuvný modul pre Volumio 3 pre automatické ovládanie podsvietenia LCD na základe úrovne okolitého osvetlenia pomocou svetelného senzora VEML7700.

Tento zásuvný modul automaticky upravuje jas LCD displejov s ovládaním podsvietenia na základe podmienok okolitého osvetlenia. Používa senzor okolitého osvetlenia VEML7700 na meranie úrovne luxov a dynamicky upravuje jas displeja pre optimálne zobrazenie v akomkoľvek svetelnom prostredí.
Funkcie
- Automatická kontrola jasu: Upravuje podsvietenie LCD na základe údajov zo senzora VEML7700
- Zvýšenie jasu počas prehrávania: Počas prehrávania hudby zvýši jas a podrží ho nastavený čas po zastavení
- Konfigurovateľný rozsah jasu: Nastavte minimálne a maximálne úrovne jasu podľa vašich preferencií
- Plynulé prechody: Nastaviteľný faktor vyhladenia pre postupné zmeny jasu
- Prispôsobiteľná kalibrácia senzora: Dolaďte odozvu senzora pomocou multiplikátora luxov
- Flexibilný interval merania: Konfigurujte, ako často senzor číta okolité osvetlenie (0,1 - 10 sekúnd)
- Zisťovanie prehrávania v reálnom čase: Zmeny stavu prehrávania posiela priamo Volumio, API sa nepýta opakovane
- Zmena nastavení za behu: Zmenené nastavenia sa použijú hneď, bez reštartu služby
- Plný jas po vypnutí: Po vypnutí alebo odinštalovaní zásuvného modulu sa displej nastaví na plný jas
- Volumio 3 aj Volumio 4: Rovnaký zdrojový kód beží na Volumio 3 (buster) aj Volumio 4 (bookworm)
- Podpora viacerých jazykov: Zahŕňa angličtinu a všetky preklady podporované systémom Volumio (de, fr, pl, cz, ...)
Hardvérové komponenty
| Komponent | Model/Typ | Popis |
| Hlavná jednotka |
Raspberry Pi 3B+ |
Riadiaca jednotka |
| Displej |
7" LCD DPI (OFI009) |
Dotykový displej pripojený cez DPI rozhranie |
| Enkodér |
KY-040 |
Otočný enkodér na ovládanie hlasitosti |
| Svetelný senzor |
VEML7700 (BH-014PA) |
16-bit I2C senzor okolitého osvetlenia |
Schéma zapojenia
I2C zbernica (senzor VEML7700)
Raspberry Pi 3B+ VEML7700 (WL7700)
───────────────── ──────────────────
Pin 1 (3.3V) ──────── Pin 5 (+3.3V)
Pin 3 (GPIO 2) ──────── Pin 2 (SDA)
Pin 5 (GPIO 3) ──────── Pin 1 (SCL)
Pin 6 (GND) ──────── Pin 4 (GND)
Referencia GPIO pinov
+-----+-----+---------+------+---+---Pi 3B+-+---+------+---------+-----+-----+
| BCM | wPi | Name | Mode | V | Physical | V | Mode | Name | wPi | BCM |
+-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
| | | 3.3v | | | 1 || 2 | | | 5v | | |
| 2 | 8 | SDA.1 | ALT0 | 1 | 3 || 4 | | | 5v | | |
| 3 | 9 | SCL.1 | ALT0 | 1 | 5 || 6 | | | 0v | | |
| 4 | 7 | GPIO. 7 | IN | 1 | 7 || 8 | 1 | IN | TxD | 15 | 14 |
+-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
Otočný enkodér (KY-040)
- CLK: GPIO pin (BCM číslovanie z
gpio readall)
- DT: GPIO pin (BCM číslovanie)
- SW: GPIO pin (tlačidlo)
- +: 3.3V
- GND: Zem
Poznámka: Nakonfigurujte piny enkodéra vo Volumio zásuvnom module Rotary Encoder pomocou BCM čísel pinov.
Pre správne fungovanie zásuvného modulu nie je potrebné pripojenie KY-040 otočného enkodéra.
Pripojenie displeja
- Napájanie: +5V a GND z konektora X1
- DPI signály: Pripojené podľa konfigurácie DPI v
/boot/config.txt
Inštalácia
I²C musí byť povolené (napr. dtparam=i2c_arm=on v /boot/userconfig.txt) a senzor musí byť viditeľný príkazom sudo i2cdetect -y 1 na adrese 0x10.
- Inštalácia cez webové rozhranie Volumia (až po schválení zásuvného modulu do katalógu Volumio, žiadosť čaká na posúdenie):
- Prejdite na Zásuvné moduly → Hľadať zásuvné moduly
- Vyhľadajte „LCD Backlight control“ a nainštalujte ho
- Zapnite ho v Zásuvné moduly → Nainštalované zásuvné moduly
- Manuálna inštalácia zo zdrojového kódu, spustite na zariadení s Volumio ako používateľ
volumio (nie root, bez sudo):
git clone https://github.com/lubomirkarlik/volumio-plugins-sources-bookworm.git --depth=1 -b lcd_backlight
cd volumio-plugins-sources-bookworm/lcd_backlight
volumio plugin install
- Zdrojový kód nájdete na GitHub-e, alebo ako lcd_backlight.zip v sekcii na stiahnutie (po rozbalení spustite
volumio plugin install v adresári lcd_backlight).
- Zásuvný modul sa objaví medzi nainštalovanými zásuvnými modulmi, kde ho zapnete.
- Rovnaký zdrojový kód funguje na Volumio 3 (buster, Node 14, Python 3.7) aj Volumio 4 (bookworm, Node 20, Python 3.11).
- Skript
install.sh nespúšťajte ručne, zásuvný modul do Volumia zaregistruje iba volumio plugin install.

Inštalačný skript vykoná:
- Inštaláciu Python závislosti (
python3-smbus), iba ak ešte nie je nainštalovaná
- Prepojenie Python ovládacieho skriptu do
/usr/local/bin/
- Vytvorenie konfiguračného adresára
/etc/lcd_backlight/
- Inštaláciu systemd služby (spúšťa a zastavuje ju zásuvný modul, nie štart systému)
- Nastavenie príslušných oprávnení
Konfigurácia
Prístup k nastaveniam zásuvného modulu cez webové rozhranie Volumia pod Zásuvné moduly → Nainštalované zásuvné moduly → LCD Backlight control → Settings.
Dostupné nastavenia
Interval merania
- Rozsah: 0,1 - 10 sekúnd
- Predvolené: 1 sekunda
- Popis: Čas medzi meraniami svetelného senzora. Nižšie hodnoty poskytujú citlivejšie zmeny jasu, ale môžu zvýšiť využitie CPU.
Minimálny jas
- Rozsah: 0 - 255
- Predvolené: 12
- Popis: Najnižšia úroveň jasu, ktorú displej dosiahne. Zabraňuje prílišnému stmaveniu alebo úplnému vypnutiu obrazovky. Nesmie byť väčší ako maximálny jas.
Maximálny jas
- Rozsah: 0 - 255 (obmedzené na
max_brightness zariadenia podsvietenia)
- Predvolené: 255
- Popis: Najvyššia úroveň jasu, ktorú displej dosiahne. Môže byť znížená na úsporu energie alebo obmedzenie maximálneho jasu.
Lux multiplikátor
- Rozsah: 0,01 - 10
- Predvolené: 0,75
- Popis: Kalibračný multiplikátor pre senzor VEML7700. Zvýšte pre svetlejšiu odozvu na okolité osvetlenie, znížte pre tmavšiu odozvu. Použite na doladenie citlivosti senzora na vaše prostredie.
Faktor vyhladenia
- Rozsah: 0,05 - 1,0
- Predvolené: 0,3
- Popis: Ovláda rýchlosť prechodov jasu. Nižšie hodnoty vytvárajú pomalšie, plynulejšie prechody. Vyššie hodnoty robia zmeny jasu okamžitejšími a citlivejšími.
Zvýšenie jasu prehrávania
- Rozsah: 0 – 255
- Predvolené: 0
- Popis: Dodatočný jas pripočítaný k vypočítanej úrovni jasu počas prehrávania hudby. Zabezpečuje lepšiu viditeľnosť obrazovky pri aktívnom používaní prehrávača. Nastavte na 0 pre vypnutie tejto funkcie.
Trvanie zvýšenia po prehrávaní
- Rozsah: 0 – 300 sekúnd
- Predvolené: 30 sekúnd
- Popis: Ako dlho sa má udržať zvýšený jas po zastavení prehrávania. Poskytuje oneskorovaciu dobu pred tým, ako sa jas vráti na úroveň založenú na okolitom osvetlení. Užitočné na udržanie jasnej obrazovky pri prechode medzi skladbami.
Ako to funguje
Kontrola okolitého osvetlenia
- Plugin v pravidelných intervaloch číta úroveň okolitého svetla zo senzora VEML7700.
- Hodnota zo senzora sa vynásobí nastaveným multiplikátorom luxov pre kalibráciu.
- Hodnota jasu sa vypočíta pomocou logaritmickej krivky a je obmedzená v rámci rozsahu min./max.
- Ak senzor nemožno prečítať, jas sa nemení.
Systém zvýšenia pri prehrávaní
- Zásuvný modul dostáva od Volumia každú zmenu stavu (
volumioPushState) a stav prehrávania zapíše do súboru /etc/lcd_backlight/lcd_playing (1 = prehráva). Súbor sa zapíše iba pri spustení alebo zastavení prehrávania, API Volumia sa opakovane nepýta.
- Pri zmene stavu prehrávania na „play“:
- K vypočítanému jasu z okolia sa pridá nastavené zvýšenie jasu.
- Zvýšenie zostáva aktívne počas celého prehrávania.
- Pri zastavení prehrávania:
- Spustí sa odpočítavací časovač na nastavenú dobu trvania zvýšenia.
- Zvýšenie zostáva aktívne počas tohto obdobia.
- Po vypršaní časovača sa jas vráti na riadenie len podľa okolitého svetla.
- Algoritmus vyhladzovania plynule upravuje podsvietenie, aby sa predišlo náhlym zmenám.
Výpočet konečného jasu
Final Brightness = min(MAX_BACKLIGHT, Ambient_Brightness + Playback_Boost)
Technické detaily
Štruktúra súborov
lcd_backlight/
├── index.js # Hlavný ovládač pluginu
├── backlight_control.py # Python skript pre hardvérové ovládanie
├── lcd_backlight.service # Systemd služba
├── install.sh # Inštalačný skript
├── uninstall.sh # Odinštalačný skript
├── UIConfig.json # Konfigurácia webového rozhrania
├── config.json # Predvolené nastavenia
├── package.json # Metadáta pluginu
├── i18n/ # Preklady (en, sk, de, fr, ...)
└── images/ # Obrázky
/usr/local/bin/
└── backlight_control.py # Odkaz (symlink) na Python skript v adresári pluginu
Konfiguračné súbory
Zásuvný modul ukladá konfiguráciu na dvoch miestach:
1. Trvalá konfigurácia
/data/configuration/system_hardware/lcd_backlight/config.json
- Ukladá všetky nastavenia zásuvného modulu
- Spravovaná konfiguračným systémom Volumia
2. Konfigurácia pre beh
/etc/lcd_backlight/
- Individuálne súbory pre každé nastavenie (napr.
lcd_enabled, lcd_int_time, lcd_playback_boost)
- Zapisuje ich zásuvný modul, číta Python ovládací skript
- Zmeny sa použijú bez reštartovania služby
Správa služieb
Zásuvný modul používa systemd službu (lcd_backlight.service), ktorá:
- Spúšťa Python ovládací skript ako démon
- Spustí sa po zapnutí zásuvného modulu a zastaví sa po jeho vypnutí
- Po zastavení nastaví displej na plný jas
- Automaticky sa reštartuje pri zlyhaní (napr. senzor ešte nie je pripravený)
- Zaznamenáva do systemd denníka
- Číta stav prehrávania zapísaný zásuvným modulom
Príklad výstupu logov
Pre účely ladenia odkomentujte dva riadky na konci metódy _update_brightness() v backlight_control.py:
# Uncomment for debugging:
# boost_indicator = " [BOOST]" if self.playback_boost_active and self.playback_boost > 0 else ""
# log(f"Lux: {lux:8.1f} | Brightness: {brightness:3d}/{self.max_backlight}{boost_indicator}")
Výstup v journalctl -u lcd_backlight.service -f bude:
[12:34:56] Lux: 245.3 | Brightness: 145/255
[12:34:57] Lux: 248.1 | Brightness: 147/255
[12:35:12] Playback STARTED - activating boost (+50)
[12:35:13] Lux: 251.7 | Brightness: 199/255 [BOOST]
[12:37:45] Playback STOPPED - boost active for 30s
[12:38:15] Boost period EXPIRED - deactivating
[12:38:16] Lux: 249.2 | Brightness: 148/255
Riešenie problémov
Zásuvný modul sa nezobrazí medzi nainštalovanými
- Nespúšťajte
install.sh ručne. Inštaluje iba systémové súbory, do Volumia zásuvný modul zaregistruje volumio plugin install.
volumio plugin install spúšťajte ako používateľ volumio (nie root, bez sudo). Príkaz whoami musí vypísať volumio.
Inštalácia sa zasekne na „Downloading plugin“
Ak log Volumia (sudo journalctl -f) hlási /bin/mv: cannot move '/tmp/plugins/lcd_backlight.zip' to '/tmp/downloaded_plugin.zip': Permission denied, volumio plugin install bol predtým spustený ako root a zanechal dočasné súbory vlastnené rootom. Odstráňte ich a nainštalujte znova ako používateľ volumio:
sudo rm -rf /tmp/plugins /tmp/downloaded_plugin.zip
cd volumio-plugins-sources-bookworm/lcd_backlight
volumio plugin install
Po preinštalovaní alebo aktualizácii sa zásuvný modul správa po starom
Volumio si pri preinštalovaní ponechá v pamäti predtým načítaný index.js. Po každom preinštalovaní alebo aktualizácii zásuvného modulu reštartujte Volumio:
volumio vrestart
Zásuvný modul sa nespustí
- Skontrolujte, či je senzor VEML7700 správne pripojený cez I²C
- Overte, či je I²C povolený vo vašom systéme (
sudo i2cdetect -y 1)
- Skontrolujte stav systemd služby:
systemctl status lcd_backlight.service
- Skontrolujte logy:
journalctl -u lcd_backlight.service -f
Jas sa nemení
- Overte existenciu zariadenia podsvietenia:
ls /sys/class/backlight/
- Skontrolujte konfiguračné súbory v
/etc/lcd_backlight/
- Uistite sa, že
lcd_enabled je nastavené na 1
- Otestujte merania senzora manuálne
Zvýšenie jasu pri prehrávaní nefunguje
- Skontrolujte, či je Zvýšenie jasu prehrávania väčšie ako 0
- Počas prehrávania musí
cat /etc/lcd_backlight/lcd_playing vypísať 1
- Skontrolujte logy:
journalctl -u lcd_backlight.service -f (hlásenie „Playback STARTED“)
Jas sa mení príliš rýchlo/pomaly
- Upravte nastavenie Faktor vyhladenia
- Nižšie hodnoty = pomalšie prechody
- Vyššie hodnoty = rýchlejšie prechody
Displej príliš svetlý/tmavý
- Upravte Lux multiplikátor pre kalibráciu odozvy senzora
- Upravte rozsahy Minimálny jas a Maximálny jas
- Dolaďte Zvýšenie jasu prehrávania
- Otestujte v rôznych svetelných podmienkach
Odinštalovanie
Zásuvný modul je možné odinštalovať cez webové rozhranie Volumia. Proces odinštalovania:
- Zastaví systemd službu (displej sa nastaví na plný jas)
- Odstráni súbor služby a odkaz na Python skript
- Odstráni konfiguračný adresár
/etc/lcd_backlight