Navodila za uporabo – Šolski Zvonec

📖

Uvod – kaj je Šolski Zvonec?

Šolski Zvonec je avtomatski sistem za upravljanje zvonenja v šoli. Deluje na majhnem računalniku Raspberry Pi, ki je priključen na zvočnik ali razglasni sistem šole. Sistem samodejno predvaja melodije ob nastavljenih urah — brez posredovanja učitelja ali hišnika.

✅ Zmogljivosti sistema

●Zvoni ob točno določenih urah
●Različne melodije za različne zvonce
●Nastavljivi dnevi v tednu za vsak zvonec posebej
●Samodejni preklop med počitnicami
●SOS alarm za izredne situacije
●Upravljanje prek spleta (telefon ali računalnik)
●Dostop od doma prek storitve Tailscale

👤 Kdo uporablja sistem

●Skrbnik – vklop in izklop zvoncev, nastavitev počitniškega načina, urejanje urnikov, nalaganje melodij
●Ravnatelj – sprožitev SOS alarma, pregled urnika

🔐

Prijava v sistem

1

Odprite spletni brskalnik

Sistem deluje v vsakem sodobnem brskalniku: Chrome, Firefox, Edge, Safari. Posebna aplikacija ni potrebna.
2

Vnesite spletni naslov

🏠 V šolskem omrežju (brezžično ali kabelsko):
http://192.168.x.x:3000
Točen naslov je viden na prijavni strani sistema.

🌍 Od doma ali od kjerkoli:
https://zvonec-raspberrypi.tail….ts.net
Naslov Tailscale Funnel – deluje brez šolskega omrežja.
3

Vnesite e-poštni naslov in geslo

Prijavne podatke vam posreduje skrbnik sistema.
4

Kliknite 🔓 Prijava

💡 Pozabljeno geslo?

Na prijavni strani kliknite Pozabljeno geslo? in sledite navodilom za ponastavitev gesla prek e-pošte.

⚙️ Prva namestitev

Če sistema še nihče ni nastavil, se na prijavni strani prikaže gumb Ustvari skrbniški račun. Ta korak opravite samo enkrat ob prvem zagonu.

🏠

Glavna stran

Po prijavi se odpre glavna stran, ki je namenjena vsakodnevnemu pregledu stanja sistema.

🕐

Ura in datum

Velik prikaz trenutnega časa, ki se posodablja vsako sekundo.

⏰

Naslednji zvonec – odštevalnik

Prikazuje ime in čas naslednjega zvonca ter odštevalnik. Barva kartice se spreminja glede na bližino naslednjega zvonca:

🟢 Zelena
Več kot 15 min

🟡 Rumena
5–15 min

🔴 Rdeča
Pod 5 min

🌙 Vijolična
Jutri zjutraj

📅

Tedenski pregled

Tabela prikazuje vse zvonce po dnevih in urah. Današnji dan je označen z indigo barvo.

Začetek ure Konec ure 🎵 Drugačna melodija Prečrtano= izključen zvonec

📊

Status sistema in zadnji zvonec

Prikazuje, ali je sistem aktiven, ter kdaj je nazadnje zazvonilo.

🚨

SOS alarm

⚠️ Namen SOS alarma

SOS alarm je namenjen izrednim situacijam, kot so evakuacija, nevarnost ali splošni alarm. Ko ga aktivirate, sistem takoj prične predvajati datoteko sos.mp3 ter blokira vse redne zvonce, dokler ga ne izklopite.

🔴 Aktivacija SOS alarma

1
Na glavni strani pritisnite rdeči gumb 🚨 Sproži SOS.
2
Sistem takoj začne predvajati SOS melodijo prek razglasnega sistema.
3
Na vrhu strani se prikaže rdeče utripajoče opozorilo.

✅ Izklop SOS alarma

1
Pritisnite zeleni gumb ✅ Končaj SOS.
2
Sistem zaustavi predvajanje in se vrne v normalno delovanje.
3
Redni urnik se nadaljuje ob naslednjem zvoncu.

🔒 Zaščita datoteke sos.mp3

Datoteka sos.mp3 je sistemsko zaščitena – ne morete je izbrisati ali nastaviti kot privzeto melodijo. Z njo se vedno predvaja SOS alarm.

⚙️

Admin panel – pregled

Admin panel je nadzorna plošča za upravljanje celotnega sistema. Dostopate do njega s klikom na gumb ⚙️ Admin v zgornjem desnem kotu glavne strani.

➕ Hiter vnos

Dodajte nov zvonec hitro z obrazcem

📋 Urnik – uredi zvonce

Pregled in urejanje vseh zvoncev

📅 Vikendi

Vklop ali izklop zvoncev ob vikendih

🏖️ Počitniški način

Datumska obdobja brez zvonenja

🎵 MP3 melodije

Nalaganje in upravljanje zvočnih datotek

🔌 Nastavitve

Ojačevalec, vklop in izklop sistema

➕

Dodajanje zvoncev

Za dodajanje novega zvonca uporabite razdelek Hiter vnos – Dodaj celotno uro v admin panelu. Z enim klikom dodate hkrati začetek in konec ure.

1

Izberite vrsto zvonca

🟢 Začetek ure 🔵 Konec ure
2

Vnesite čas začetka ure

Na primer 08:00. Čas vnesite v obliki UU:MM. Čas konca se izračuna samodejno glede na trajanje ure.
3

Vnesite številko ure

Vnesite samo zaporedno številko z piko, na primer 1., 2., 3. — sistem samodejno doda besedo »ura«, tako da bo prikazano Začetek 1. ure oziroma Konec 1. ure.
4

Izberite melodijo (MP3)

Iz spustnega menija izberite naloženo zvočno datoteko.
5

Nastavite trajanje zvonca

Določite, koliko sekund se predvaja melodija (npr. 10 sekund).
6

Izberite dneve v tednu

Privzeto so izbrani vsi dnevi. Podrobnosti najdete v razdelku Dnevi v tednu.
7

Kliknite ➕ Dodaj uro

Sistem doda oba zvonca (začetek in konec ure) ter posodobi urnik.

💡 Hitra množična urejanja

Pod obrazcem so gumbi za hkratno spremembo vseh zvoncev (trajanje, melodija za vse začetke ali vse konce). To je priročno pri spremembi celotnega urnika.

📆

Dnevi v tednu

Vsak zvonec ima nastavitev, za katere dni v tednu velja. S tem lahko ustvarite različen urnik za različne dneve – na primer krajše ure v sredo ali drugačne melodije za posamezne dneve in ure.

🗓️ Kako nastaviti dneve

V obrazcu za dodajanje ali urejanje zvonca so potrditvena polja za vsak dan v tednu:

Pon Tor Sre Čet Pet Sob Ned

📌 Gumb »Vsi dnevi«

S klikom na Vsi dnevi označite vse dni – zvonec bo veljal vsak dan v tednu. Kadar so označeni vsi dnevi ali noben, sistem to obravnava kot »vsak dan«.

✅ Primer: krajše ure v sredo in drugačna melodija

Dodajte zvonec ob 08:00 za Pon, Tor, Čet, Pet z melodijo zvonec.mp3 (trajanje 45 min)
Dodajte zvonec ob 08:00 za Sre z melodijo kratki.mp3 (trajanje 40 min = konec ob 08:40)
V tedenski tabeli bo sreda ob 08:00 označena z oranžno barvo, ker ima drugačno melodijo ali trajanje kot ostali dnevi

ℹ️ Zvonec z nastavljenimi dnevi ne upošteva globalne nastavitve vikendov

Kadar zvonec nima nastavljenih posebnih dni, velja zanj globalna nastavitev »Vikendi: VKLOPLJENI / IZKLOPLJENI«. Kadar pa so dnevi izrecno nastavljeni (npr. samo sobota), se zvonec predvaja ne glede na globalno nastavitev vikendov — upravljate ga izključno prek izbranih dni.

✏️

Urejanje urnika

V razdelku Urnik – uredi zvonce je seznam vseh nastavljenih zvoncev. Za vsakega so na voljo naslednji gumbi:

✏️ Uredi

Urejanje vseh podatkov zvonca

Spremenite čas, ime, melodijo, trajanje in dneve v tednu. Spremembe potrdite s klikom na Shrani.

📋 Kopiraj

Ustvarjanje kopije zvonca

Doda nov zvonec z enakimi nastavitvami, ki ga nato uredite. Koristno za podobne ure.

⏸️ Izključi

Začasna izključitev zvonca

Zvonec se ne predvaja, a ostane v sistemu. S klikom na ▶️ Vključi ga kadar koli znova aktivirate.

▶️ Play

Takojšnji preizkus zvonca

Melodija tega zvonca se predvaja takoj – koristno za preverjanje, ali zvočnik deluje pravilno.

🗑️ Briši

Trajno brisanje zvonca

Zvonec se dokončno odstrani iz sistema. To dejanje je nepopravljivo!

📅

Vikendi

Z enim klikom vklopite ali izklopite zvonenje ob vikendih (sobota in nedelja).

🔘 Gumb za upravljanje vikendov

Vikendi: IZKLOPLJENI → kliknite za vklop → Vikendi: VKLOPLJENI

Privzeto stanje

Privzeto so vikendi IZKLOPLJENI – zvonci ob sobotah in nedeljah ne zvonijo. Za večino šol je to najprimernejša nastavitev.

ℹ️ Kdaj nastavitev ne velja

Zvonci, ki imajo posebej nastavljene dneve v tednu (npr. samo sobota), se bodo predvajali ne glede na to nastavitev. Globalna nastavitev velja le za zvonce brez posebej nastavljenih dni.

🏖️

Počitniški način

Počitniški način vam omogoča, da vnaprej nastavite datumska obdobja, ko zvonci samodejno ne bodo zvoneli. Ni treba ročno izklopiti sistema – med počitnicami se samodejno umiri.

1

Odprite razdelek Počitniški način

V admin panelu poiščite razdelek 🏖️ Počitniški način na dnu strani.
2

Vnesite ime počitnic

Na primer Zimske počitnice, Velikonočne počitnice.
3

Nastavite datum od – do

Izberite prvi in zadnji dan počitnic. Zvonci ne bodo zvoneli v celotnem tem obdobju.
4

Kliknite Dodaj počitnice

⏸️ Začasna izključitev

Vsak vnos v seznam lahko začasno izklopite, ne da bi ga izbrisali – na primer, kadar je šola odprta med prazničnim tednom.

🗑️ Brisanje

Pretekla počitniška obdobja lahko izbrišete iz seznama, da ostane pregleden.

✅ Primer: šolski praznični termini

Zimske počitnice: 17. 2. – 21. 2.
Prvomajski praznik: 1. 5. – 2. 5.
Letne počitnice: 25. 6. – 31. 8.

Vnesete jih vnaprej – sistem bo med temi dnevi samodejno preskočil zvonila.

🎵

MP3 melodije

Sistem podpira predvajanje poljubnih zvočnih datotek MP3. Vsak zvonec ima lahko svojo melodijo.

📤 Nalaganje novih datotek MP3

1V admin panelu poiščite razdelek MP3 datoteke.
2Kliknite Izberi datoteko in izberite datoteko MP3 iz računalnika.
3Kliknite Naloži. Datoteka se prikaže v seznamu.

▶️ Preizkus melodije

Gumb Play predvaja melodijo takoj prek zvočnika – preverite, ali zveni pravilno.

⭐ Privzeta melodija

Gumb Privzet nastavi melodijo kot privzeto za zvonce, ki nimajo posebej nastavljene datoteke.

🗑️ Brisanje

Neuporabljene datoteke lahko izbrišete. Datoteke sos.mp3 ni mogoče izbrisati.

🔒 sos.mp3 – zaščitena datoteka

Te datoteke ni mogoče izbrisati ali nastaviti kot privzete. Vedno se uporablja za SOS alarm.

💡 Hitra množična zamenjava melodij

V razdelku Hitra množična urejanja zamenjate melodijo z enim klikom – vsem zvoncem hkrati, samo začetkom ur ali samo koncem ur.

🔌

Nastavitve ojačevalca

Kadar je razglasni sistem priključen prek ojačevalca, ki se mora prižgati pred predvajanjem, sistem to podpira z nastavitvijo Zamik ojačevalca.

⏱️ Zamik ojačevalca (v sekundah)

Privzeto: 5 sekund. Sistem vklopi ojačevalec X sekund pred zvoncem, da ima čas za pripravo.

Primer: Zvonec je nastavljen ob 08:00. Z zamikom 5 sekund se ojačevalec vklopi ob 07:59:55, melodija pa se predvaja točno ob 08:00:00.

🔁 Vklop in izklop sistema

V nastavitvah lahko izklopite celoten sistem zvonenja – noben zvonec se ne bo predvajal, ne glede na urnik. To je koristno med daljšimi prireditvami ali posebnimi dogodki.

⚠️ Ročni način ojačevalca

Kadar nekdo fizično pritisne stikalo ojačevalca med delovanjem sistema, ta preide v ročni način. Na glavni strani se prikaže oranžno opozorilo. Za vrnitev v normalno delovanje pritisnite stikalo znova.

🌐

Dostop od doma – Tailscale

Sistem je dostopen od kjerkoli prek storitve Tailscale Funnel – brez potrebe po navideznem zasebnem omrežju (VPN) ali posebnih omrežnih nastavitvah.

🔗 Dva načina dostopa

🏠

Lokalni dostop (v šoli)

Ko ste v šolskem brezžičnem ali kabelskem omrežju. Najhitrejši dostop.

http://192.168.x.x:3000

🌍

Oddaljeni dostop (od doma ali od kjerkoli)

Deluje z vsako internetno povezavo, brez šolskega omrežja.

https://zvonec-raspberrypi.tail….ts.net

📧 Pošiljanje navodil po e-pošti

Na prijavni strani je gumb 📧 Pošlji. Z njim pošljete navodila s spletnimi naslovi nekomu prek e-pošte – na primer ravnatelju ali delavcu, ki bo sistem upravljal od doma.

ℹ️ Kaj je Tailscale Funnel?

Tailscale Funnel je varna storitev, ki napravo Raspberry Pi naredi dostopno iz interneta brez odpiranja vrat na usmerjevalniku. Sistem jo nastavi samodejno med namestitvijo.

🔧 Vezava hardware (GPIO)

Fizična vezava releja, SOS gumba in signalnega izhoda na Raspberry Pi. Pinout je enak za RPi 3 in RPi 4.

📌 Kateri pini se uporabljajo

GPIO	Fizični pin	Funkcija	Smer
GPIO 17	Pin 11	Ojačevalec — relay IN signal	OUTPUT
GPIO 23	Pin 16	Signal izhod	OUTPUT
GPIO 24	Pin 18	SOS gumb — vhod	INPUT
—	Pin 2 ali 4	Napajanje relay modula (5V)	5V PWR
—	Pin 6 ali 20	Masa (GND) — relay in/ali gumb	GND

🔌 Relay modul (ojačevalec)

Pin 2 (5V) → Relay VCC

Pin 6 (GND) → Relay GND

Pin 11 (GPIO17) → Relay IN

Relay kontakti → ojačevalec:

COM → napajanje ojačevalca

NO → + napajanje (active-HIGH)

⚠️ VCC mora biti 5V (Pin 2/4) — na 3.3V relay ne dobi dovolj moči!

🚨 SOS gumb (fizični)

Pin 1 (3.3V) → Gumb priključek 1

Pin 18 (GPIO24) → Gumb priključek 2

Sproščen: GPIO24 = LOW (0)

Pritisnjen: GPIO24 = HIGH (1) ← zaznan!

ℹ️ Gumb veže GPIO24 na 3.3V ob pritisku. Sistem zazna spremembo in aktivira SOS.

⚡ Signal izhod

Pin 16 (GPIO23) → Signal IN

GND → Signal GND

Max 3.3V / 16mA na GPIO pin.

Za večje bremene: dodaj relay ali tranzistor.

⛔ Ne smeš storiti

• GPIO pinov ne poveži na 5V — uničiš Raspberry Pi!
• Relay VCC ne sme biti na 3.3V — relay ne bo kliknil
• Ne pusti GPIO pinov nepovezanih (floating) — dodaj upor ali pull

🔍 Diagnostika

gpioinfo --chip 0 | grep "17:\|23:\|24:"
journalctl -u zvonec -f
ps aux | grep gpioset
systemctl status zvonec