LAN modulis

Modulis skirtas prijungti valdiklį prie lokalaus ethernet tinklo. 
Montuojamas ant DIN bėgelio. 
Jungiamas su visais DIN3 serijos valdikliais.
Priklausomai nuo konfigūracijos ir naudojamos programinės įrangos, Lan modulis gali atlikti šias funkcijas:
  • Perduoti operatyvinius valdiklio duomenis į nutolusį serverį term.lt, kur jie kaupiami ir toliau naudojami schemos bei grafikų piešimui
  • Nenaudojant serverio stebėti ir dalinai valdyti sistemą 

Specifikacija:

  • Procesorius - Qualcomm/Atheros AR9331;
  • FLASHo dydis - 16 MB;
  • RAMo dydis - 64MB DDR2;
  • Maitinimas - 8... 20V DC;
  • Ethernet prievadų kiekis - 1 arba 2;
  • RS232 prievadų kiekis - 1;
  • Operacinė sistema - Linux OpenWrt distribucija;





Modulio tinklas ir ryšys su term.lt (nuo 2026-11)

Carambola modulis prie šildymo valdiklio pats prisijungia prie term.lt per kliento internetą — nereikia statinio IP, portų peradresavimo ar routerio nustatymų. Modulis prisitaiko prie bet kokio kliento tinklo: adresą gauna iš routerio, o aptarnavimui visada turi pastovius adresus.

Pirma dalis skirta vartotojui (klientui), antra — instaliuotojui. Valdiklio naudojimas čia neaprašomas.

Turinys

Vartotojui

Kaip pasiekti modulį

Modulio puslapis atsidaro naršyklėje, kai kompiuteris ar telefonas yra tame pačiame tinkle (prie to paties routerio). Adresas sudarytas iš jūsų tinklo pradžios ir galo .222. Pavyzdžiui, jei routeris dalina adresus 192.168.1.x, modulis bus http://192.168.1.222/.

                   
Bandykite eilės tvarkaPavyzdys tinkle 192.168.1.xKada
x.x.x.222http://192.168.1.222/įprastai
x.x.x.232http://192.168.1.232/jei .222 jau užimtas kito įrenginio
x.x.x.242http://192.168.1.242/jei užimti ir .222, ir .232
10.0.0.175http://10.0.0.175/avarinis, kompiuteriui reikia statinio 10.0.0.x adreso (žr. instaliuotojo dalį)

Savo tinklo pradžią sužinosite telefone ar kompiuteryje, WiFi tinklo informacijoje (IP adresas, pvz. 192.168.1.37 → tinklas 192.168.1.x).

Pakeitus routerį ar interneto tiekėją nieko daryti nereikia. Modulis pats gauna naują adresą, per kelias sekundes vėl užsideda .222 (ar .232/.242) naujame tinkle ir vėl prisijungia prie term.lt. Jei modulis jungiamas per WiFi, o pasikeitė WiFi pavadinimas ar slaptažodis — žr. kitą skyrių.

WiFi

Modulis gali būti jungiamas laidu arba per WiFi. Kai jungtas laidu, WiFi nereikia.

Prijungti prie namų WiFi (arba pakeisti WiFi tinklą ar slaptažodį): atidarykite modulio puslapį, spauskite WiFi, tada Ieškoti tinklų, pasirinkite savo tinklą, įveskite slaptažodį ir spauskite Prisijungti.

Kai modulis neturi jokio ryšio (laidas neprijungtas ir WiFi neprisijungia ilgiau nei 1 min.), jis pats įjungia savo aptarnavimo WiFi tinklą Din3-XXXX (XXXX — 4 simboliai, kiekvienam moduliui skirtingi). Tada:

       
  1. Telefonu prisijunkite prie tinklo Din3-XXXX (slaptažodis – ant modulio lipduko).
  2.    
  3. Naršyklėje atidarykite http://10.0.0.175/ ir WiFi puslapyje nurodykite naują namų WiFi tinklą.
  4.    
  5. Modulis prisijungia prie namų WiFi, o Din3-XXXX tinklas išsijungia. Jei prisijungti nepavyksta per 1,5 min., Din3-XXXX vėl įsijungia.

Kol įjungtas Din3-XXXX, modulis kas 2 min. ieško įprasto WiFi tinklo ir, jį radęs, prisijungia pats — pvz., kai routeris įsijungia po elektros dingimo.

    Modulio WiFi puslapis: tinklų paieška, slaptažodis, papildomas AP   
Modulio WiFi puslapis: tinklų paieška, slaptažodis, papildomas AP.

Kai dingsta ryšys

Modulis ryšį atstato pats — jo išjunginėti nereikia. Jei dingo tik internetas, o routeris veikia, modulis tinklo neperkrauna ir tiesiog laukia, kol internetas atsiras.

Jei modulis nepasiekia ir routerio (pvz., routeris buvo perkrautas ar ilgiau kėlėsi po elektros dingimo), modulis iš eilės bando:

               
Po kiek laiko be ryšioKą daro modulis
10 min.iš naujo prašo adreso iš routerio, iš naujo jungiasi prie WiFi
20 min.perkrauna visą savo tinklą (toliau kartoja kas 30 min.)
40 min.persikrauna visas modulis (ne dažniau kaip kartą per valandą)

Kreipkitės į instaliuotoją, jei valdiklis term.lt nepasiekiamas ilgiau nei valandą, nors routeris ir internetas namie veikia.

Kiti įrenginiai (Modbus)

Per tą patį modulį term.lt gali stebėti ir kitus jūsų tinklo įrenginius: šilumos siurblį, elektros skaitiklius, rekuperatorių, inverterį. Rekuperatorių galima ir valdyti. Port forward, statinio IP ar papildomo maršrutizatoriaus nustatymo nereikia, todėl tai veikia ir per mobilųjį internetą ar Starlink.

Tokie įrenginiai turi turėti pastovų adresą jūsų tinkle. Jei keičiate maršrutizatorių ar jo nustatymus, praneškite instaliuotojui: pasikeitus įrenginio adresui, term.lt jo duomenų nebegaus.

Instaliuotojui

IP adresai

Modulio laidiniame tinkle (br-lan) vienu metu yra keli adresai, kiekvienas skirtas kitam tikslui. Juos pridėti ar keisti rankomis nereikia.

                   
AdresasIš kurPaskirtis
10.0.0.175/24statinis, interfeisas lanavarinis aptarnavimas, visada; be gateway
DHCP adresas (pvz. 192.168.1.144)kliento routeris, interfeisas lan_dhcpinternetas, DNS, ryšys su term.lt
x.x.x.222 (.232, .242)modulis prideda patspastovus adresas kliento tinkle, kad nereikėtų ieškoti DHCP adreso
senas statinis (pvz. 192.168.1.4)tik migruotuose moduliuoselieka, kad veiktų senas SCADA kelias per forwardą

Kaip parenkamas .222. Gavęs DHCP adresą modulis paima tinklo pradžią ir patikrina, ar x.x.x.222 laisvas (ping + ARP, todėl randa ir įrenginius, kurie neatsako į ping). Užimtas → tikrina .232, paskui .242. Tinklas turi būti /24 ar didesnis. Tikrinama po kiekvieno DHCP atnaujinimo ir kas 5 min. (cron), tad pakeitus routerį adresas atsiranda naujame tinkle savaime. Logas: logread -e fixed-ip.

Avarinis 10.0.0.175 visada lieka. Jei kas nors LuCI'e perjungia lan į DHCP ar ištrina adresą, modulis po kelių sekundžių (vėliausiai per 5 min.) prideda 10.0.0.175 atgal. Prisijungti: kompiuteriui laidu nustatykite statinį 10.0.0.x (pvz. 10.0.0.10/24) ir atidarykite http://10.0.0.175/ (LuCI — http://10.0.0.175:88/).

Maršrutų prioritetas (mažesnis metric laimi): laidinis DHCP 10, WiFi klientas 20, senas statinis gateway 30. Senas gateway lieka tik kaip atsarginis tinklui be DHCP serverio.

LuCI'e lan interfeiso nekeiskite ir netrinkite. Jo DHCP ar gateway nustatymai nereikalingi: tam yra lan_dhcp ir wwan. Atnaujinus modulį su keep settings, lan automatiškai sugrąžinamas į statinį 10.0.0.175.

Tinklo sargas (watchdog)

Tinklo sargas (netwatch, cron kas 2 min.) atstato ryšį tik tada, kai modulis nepasiekia ir routerio. Jei routeris atsako, bet interneto nėra, kaltas ne modulis: jis nieko nekeičia, tik rašo į logą.

Ryšys laikomas esančiu, jei agentas per paskutines 10 min. susikalbėjo su term.lt arba atsako ping į 1.1.1.1 ar 8.8.8.8.

               
Be ryšio, routeris neatsakoVeiksmas
10 min.ifup lan_dhcp ir wwan, wifi reload (jei yra WiFi klientas)
20 min./etc/init.d/network restart; kartojama kas 30 min.
40 min.reboot, tik jei uptime > 1 val. (t. y. ne dažniau kaip kartą per valandą)

Kai įjungtas aptarnavimo AP (Din3-XXXX), sargas tinklo neperkrauna, kad nenutrauktų telefonu prisijungusio technikos.

Atskirai kas 5 min. veikia adresų patikra (95-fixed-ip check): atstato 10.0.0.175 ir .222, o jei netifd nuvalė DHCP adresą, bet interfeisas liko „up“ — daro ifup.

Logai: logread -e netwatch, logread -e fixed-ip. Bandymas be veiksmų: DRY=1 sh /usr/share/heat-agent/netwatch.sh.

WiFi galimybės

Modulis turi vieną radiją, todėl vienu metu veikia tik vienas iš trijų WiFi režimų. Visi nustatomi modulio puslapyje WiFi (http://<modulis>/wifi/), LuCI nereikia.

               
RežimasKada naudotiKaip įjungiamas
WiFi klientas (wwan)laido iki routerio nėraWiFi puslapyje: Ieškoti tinklų → tinklas → slaptažodis → Prisijungti
Papildomas AP (lan_ap)modulis jungtas laidu, o katilinėje silpnas kliento WiFiWiFi puslapyje: Įjungti AP. Veikia tik su laidu; įrenginiai gauna adresus iš kliento routerio
Aptarnavimo AP (setup_ap)nėra nei laido, nei WiFi ryšio ilgiau nei 60 sautomatiškai (heat-wifi servisas)

Abiejų AP pavadinimas Din3-XXXX (radijo MAC pabaiga), slaptažodis – ant modulio lipduko.

Aptarnavimo AP eiga. Įjungiamas AP + DHCP serveris 10.0.0.100–149, telefonu jungiamės į http://10.0.0.175/. Sukonfigūruotas WiFi klientas laikinai išjungiamas. Kas 2 min. per AP skenuojama: pamatęs kliento tinklą, modulis bando jungtis (duodama 90 s), nepavykęs grįžta į AP. Prijungus laidą arba WiFi klientui gavus adresą, AP ir DHCP serveris išjungiami. Logas: logread -e wifi-fallback.

WiFi klientas gauna savo MAC (lokaliai administruojamą, iš radijo MAC), kad routeris laidui ir WiFi neduotų to paties adreso. Pastovus .222 adresas pridedamas ir per WiFi.

Modulio atnaujinimas

Modulis atnaujinamas per LuCI failu heat-carambola2-sysupgrade-<data>.bin, išsaugant nustatymus. Tai galima daryti ir iš telefono naršyklės. Agento ryšys su term.lt, WiFi nustatymai ir vietinio web nustatymai lieka.

       
  1. Atidarykite LuCI: http://<modulis>:88/ (pvz. http://192.168.1.222:88/ arba http://10.0.0.175:88/).
  2.    
  3. System → Backup / Flash Firmware → Flash image…, pasirinkite .bin failą.
  4.    
  5. Palikite pažymėtą Keep settings ir spauskite Continue.
  6.    
  7. Palaukite apie 3 min., kol modulis persikraus. Nelieskite maitinimo.

Po atnaujinimo modulis pats sutvarko tinklo nustatymus (10.0.0.175, lan_dhcp, .222), o root slaptažodis tampa numatytuoju (tokiu pačiu kaip naujuose moduliuose). Ar viskas pavyko, matyti cat /root/heat-setup.log (image'ai iki 2026-11-13 – /tmp/heat-setup.log, dingsta perkrovus).

Seni moduliai (sena OpenWrt, PHP 7, senoviškas LuCI meniu) – atnaujinti BE Keep settings. Senas konfigas naujai sistemai netinka: lieka seni tinklo ir konsolės nustatymai, modulis gali nepasiekti valdiklio ar interneto. Be Keep settings modulis paleidžiamas švariai ir pats susikonfigūruoja: 10.0.0.175 + DHCP + .222 (.232/.242), root slaptažodis numatytasis.

       
  • Flashinant atžymėkite Keep settings ir pažymėkite Force upgrade (skiriasi platformos pavadinimas).
  •    
  • Prarandami home pavadinimai (/www/home/names.txt, config.php). Jei reikia, nusikopijuokite juos prieš atnaujinimą per SSH ar WinSCP (seniems moduliams agento puslapio nėra).
  •    
  • Jei modulis jungtas per WiFi klientą, o ne laidu, WiFi tinklą po atnaujinimo reikės suvesti iš naujo (per aptarnavimo AP, slaptažodis ant lipduko).
  •    
  • Kliento routeris turi dalinti DHCP. Be DHCP modulis liks pasiekiamas tik 10.0.0.175 adresu ir agentas neprisijungs.
  •    
  • Senas SCADA kelias (forwardintas portas 9000 į .222) veikia toliau, jei .222 kliento tinkle laisvas.

Naujus modulius (įrašytus 2026-11 image'ais) atnaujinkite su Keep settings, kaip aprašyta aukščiau.

Home pavadinimai naujuose moduliuose (image nuo 20261113-2218): agento puslapyje http://<modulis>/agent/ skiltyje Home pavadinimai yra Atsisiųsti pavadinimus ir Įkelti. Prieš atnaujinant be Keep settings ar keičiant modulį pavadinimus atsisiųskite, po to įkelkite atgal. Įkeliant senas failas išsaugomas kaip names.txt.bak.

Susiejimas su term.lt

Modulis susiejamas su kliento subdomenu dviem žingsniais: modulyje įrašomas subdomenas, o SCADA sukuriamas kontroleris agent://<ID> be tokeno. Tokenas susiejamas automatiškai, kai modulis pirmą kartą prisijungia.

       
  1. Patikrinkite subdomeną. Kliento subdomene turi būti agent.php: naršyklėje https://<klientas>.term.lt/agent.php turi atsakyti 405 (Method Not Allowed). Jei 404 — failo nėra, įkelkite agent.php stubą šalia config.php.
  2.    
  3. Modulyje atidarykite http://<modulis>/agent/, įrašykite kliento subdomeną (pvz. tadas) ir spauskite Išsaugoti. Modulio ID palikite tuščią (ID = subdomenas). Jei viename subdomene keli moduliai, kiekvienam įrašykite skirtingą ID (pvz. tadas-katiline, tadas-namas).
  4.    
  5. SCADA sukurkite kontrolerį: adresas agent://<ID>, adreso parametrai tušti (arba tik address=N). Tokeno neveskite. Nurodykite teisingą valdiklio versiją (pvz. 1.9) — nuo jos priklauso, kokio ilgio komandas siunčia konfigūratorius.
  6.    
  7. Per kelias sekundes modulio puslapyje būsena tampa žalia „Prisijungęs prie serverio“, o SCADA kontrolerio parametruose atsiranda token=… — susieta.
    Agento puslapis /agent/: subdomenas, modulio ID, modulio adresai ir agento logas   
Stendo pavyzdys prieš susiejimą: subdomenas dar neįrašytas, Modulio adresai rodo 10.0.0.175, DHCP adresą ir .232 (.222 šiame tinkle užimtas).

Nuo šiol serveris priima tik šį modulį su šiuo tokenu (užklausos pasirašomos HMAC). Kontrolerio duomenyse matyti modulio adresai: AgIp (viešas), AgLan (vietinis), AgGw (routeris), AgMac, AgVer.

Modulio pakeitimas ar įrašymas iš naujo be keep settings sukuria naują tokeną, todėl senasis jau netinka. SCADA kontrolerio parametruose ištrinkite token=… — naujas modulis susies vėl. Atnaujinant su keep settings tokenas lieka, nieko daryti nereikia.

Modbus įrenginiai per modulį

Modulis perduoda Modbus TCP/UDP paketus tarp term.lt ir įrenginių kliento tinkle, todėl jų portai į internetą nebeforwardinami. Modulis paketų nenagrinėja, tik juos perneša, todėl tinka ir grynas Modbus TCP, ir RTU per TCP/UDP šliuzą.

Reikalavimai:

       
  • Modulio image nuo heat-carambola2-sysupgrade-20261112-1735 (agentas 1.4 ar naujesnis). Versija matosi /agent/ puslapyje ir SCADA lauke AgVer.
  •    
  • Įrenginys turi pastovų IP tame pačiame tinkle kaip modulis: statinį arba rezervuotą maršrutizatoriaus DHCP.
  •    
  • Leidžiami tik privatūs adresai: 10.x.x.x, 172.16–31.x.x, 192.168.x.x. Į internetą modulis paketų neperduoda.

SCADA kontrolerio nustatymai (tipas, versija, sąsaja ir .def failas — kaip ir anksčiau):

               
LaukasReikšmė
data_srcagent://<modulio ID> (tas pats kaip to objekto DIN3)
data_src_parammodbus&target=192.168.1.50:502
UDP įrenginiuipridėti &proto=udp

Tokeno rašyti nereikia: susiejant serveris jį įrašo visiems to modulio kontroleriams. repeat=1 su agentu nieko neduoda, jį galima praleisti.

Kaip veikia:

       
  • Nuskaitymas: modulis įrenginius apklausia pats kas 10–20 s, term.lt ima paskutinį atsakymą. Pirmos reikšmės naujam kontroleriui atsiranda po ~20–40 s.
  •    
  • Valdymas (pvz. rekuperatoriaus nustatymai): komanda įvykdoma per ~1 s, po jos modulis iškart perskaito būseną ir ji matosi SCADA. Mygtukas „Išsaugoti“ tampa aktyvus po ~2–3 s.
  •    
  • Neatsakantis įrenginys kitų nestabdo: jo apklausa praleidžiama vis ilgesniam laikui, iki 5 min.

Svarbu: kai kurie įrenginiai (pvz. Huawei inverterio dongle) priima tik vieną Modbus ryšį. Jei jį dar apklausia kita sistema (vietinis serveris, gamintojo programa), atsakymai gali dingti.

Gedimų paieška

                                       
PožymisPriežastisKą daryti
Agento loge „Could not resolve“modulis neturi DHCP (nėra lan_dhcp) — senų versijų modulis su gateway lan'eatnaujinkite modulį sysupgrade image su keep settings
Neatsako nei .222, nei .232, nei .242nėra DHCP adreso arba tinklas mažesnis nei /24junkitės per 10.0.0.175, žiūrėkite logread -e fixed-ip
Nepasiekiamas ir 10.0.0.175kompiuteris ne 10.0.0.x tinkle arba ne tame pačiame laide/switch'ekompiuteriui statinis 10.0.0.10/24, jungtis tiesiai į modulio lizdą
Modulis prisijungęs, bet SCADA „unpaired“ / nėra tokennėra agent.php subdomene arba ID nesutampapatikrinkite /agent.php (405) ir ID abiejose pusėse
Buvo susietas, po modulio pakeitimo nebeveikianaujas tokenasSCADA ištrinkite token=…
Konfigūratorius rašo Err 4 (neteisingas parametrų kiekis)SCADA kontrolerio versija per sena (pvz. 1.6 vietoj 1.9) — siunčiama trumpesnė komandakontrolerio nustatymuose nurodykite teisingą versiją
Home puslapyje nėra valdiklio duomenų, nors valdiklis prijungtasserial konsolė ant valdiklio linijos (senas modulis atnaujintas su keep settings)atnaujinkite naujausiu image arba be keep settings
Modbus įrenginys be duomenų, DIN3 veikianeteisingas target IP/portas, įrenginio IP pasikeitė arba jį apklausia kita sistemapatikrinkite target; agento debug=1 ir logread -e heat-agent rodo poll … FAIL / OK
Modbus komandos vykdomos lėtai (~20 s)senas agentas (iki 1.4): neatsakantis įrenginys stabdo kitusatnaujinkite modulį į 20261112-1735 ar naujesnį image

Naudingos komandos (SSH arba LuCI → System → Custom commands):

ip -4 addr show br-lan          # visi adresai: 10.0.0.175, DHCP, .222ip route                        # default per DHCP (metric 10)logread -e fixed-ip             # .222/.232/.242 parinkimaslogread -e netwatch             # tinklo sargaslogread -e heat-agent           # ryšys su term.ltlogread -e wifi-fallback        # aptarnavimo APcat /root/heat-setup.log        # kas pakeista po atnaujinimo (+ heat-setup-network-*.txt)cat /usr/share/heat-agent/BUILD # image data ir variantas