INTEGRACIJA UREĐAJA DL28 U THINGSBOARD IOT PLATFORMU
Ovaj tutorijal će vam detaljno pokazati kako da podesite i integrišete DL28 na ThingsBoard IoT platformu. Ovim Decode obeležava početak saradnje sa ThingsBoard-om kao njihov Silver Partner.
MQTT (laki protokol za razmenu poruka) je zasnovan na „objavi/pretplati se“ princip razmene poruka između klijenata preko brokera. Klijenti na daljinu su povezani sa brokerom korišćenjem TCP/IP protokola. Broker ima statičku IP adresus. Kklijenti mogu imati statičku ili dinamičku IP adresu. Podrazumevani port je 1883.
DL28podržava MQTT klijent, može slati-publišovati poruke na broker i primati-subscribovati se na poruke sa brokera.
TEXT i JSON formati porukasu podržani.
DL28 raspolaže internom MODBUS memorijskom mapom, koja se koristi za prikupljanje svih podataka sa povezanih uređaja, brojila i IO modula. Ovi podaci se mogu očitati na različite načine, a ovoga puta objašnjavamo MQTT način.
DL28 podešavanje
Povežite se na DL28 web server koristeći ili podrazumevane parametre ili adekvatne u slučaju da ste promenili podrazumevane parametre.
Podrazumevano podešavanje je | IP adresa: 192.168.0.67 | Username : admin | Password : admin |
Podesite sve uređaje, brojila, IO module koji su povezani na DL28. Nakon uspostavljanja uspešne komunikacije sa svakim, trebalo bi da imate sve relevantne podatke uskladištene u DL28 modbus mapi. Formirajte listu podataka koje želite da razmenjujete preko MQTT-a.
Procedura će biti objašnjena korišćenjem malog primera zasnovanog na podacima prikupljenim/čitanim sa GPRS rutera 343 i merača toplote korišćenjem modbus RTU i M-Bus protokola, respektivno. Ovo je prikazano na slikama ekrana ispod.
Podešavanje MQTT protokola na DL28 uređaju za komunikaciju sa ThingsBoards brokerom:
Pokreni: omogući/pokreni MQTTprotokol
Omogućen Debug: debugging preko konzole, moguće mu je pristupiti preko USB0 porta na DL28
Broker: link ili IP adresa brokera, demo.thingsboard.io u ovom slučaju
Port: podrazumevana vrednost je 1883
Reconnect: vremenski interval za ponovno povezivanje sa brokerom, podrazumevana vrednost je 10 sekundi
Keep Alive Interval: definiše vremenski interval za slanje PING paketa za održavanje TCP/IP veze aktivnom. U slučaju da nedostaje RESPONSE paket, veza se ponovo uspostavlja. Vrednost nula ga isključuje.
Clean Session: kaže brokeru da ne čuva informacije o klijentu i neisporučene poruke nakon prekida veze.
Client ID: je „Device ID“ dodeljena od strane ThingsBoard-a
Username: je „Access Token“ generisan od strane ThingsBoard-a
Password: podrazumevano prazno polje
Izaberite JSON za format podataka.
Sačuvajte podešavanja klikom na Save dugme.
Pošalji MQTT poruku
Otvori MQTT → MQTT Publish List stranicu.
Dodajte parametar/e sa liste podataka koje želite da pošaljete.
Za potrebe pisanja ovog dokumenta koristili smo stanje releja na GT-900-343 u režimu rutiranja. Stanje releja na modbus RTU uređaju se nalazi u Ulaznim registrima, adresa 52001. Stanja releja se šalju na temu „v1/devices/me/telemetri“, samo pri promeni vrednosti. (Publish->OnValueChange) za 1 (Period/Treshold).
Vrednost temperature, očitana sa M-Bus merača toplote, šalje se na temu „v1/uređaji/me/telemetrija“, periodično na svakih 300 sekundi.
Payload Value Prefix polje treba sadržati ključne reči za svaki podatak (exio_relay_1, gt900_relay_1, cal_return_temp). Ključne reči su proizvoljne i bira ih korisnik da na najbolji način odražavaju stvarno stanje opreme sa terena.
Sačuvajte podešavanja.
Primi MQTT poruku
Otvori MQTT Subscribe Liststranicu.
Dodajte parametar/e koje želite da dobijete.
Dodali smo parametar za uključivanje i isključivanje releja na modbus RTU uređaju, GT900-343.
Memorijska lokacija za relej se nalazi u okviru Input grupe internih modbus mapa, adresa 52000.
Stanje releja je promenjeno preko „v1/devices/me/rpc/request/+“ topic-a.
Payload Value Prefix polja su za ključne reči koje će predstavljati podatke (exio_relay_1, gt900_relay_1). Ključne reči su proizvoljne i bira ih korisnik.
Sačuvajte promene.
Nakon završetka podešavanja ponovo pokrenite aplikaciju pritiskom na Restart dugme koje se nalazi na Restart → Restart Application stranici.
MQTT broker
ThingsBoard broker, demo instalacija (https://demo.thingsboard.io), je obezbeđen ili besplatno kao ThingsBoard Community edition (CE) ili kao kommercijalni nalog – ThingsBoard Professional edition (PE), za ovu svrhu koristimo besplatni nalog.
Idite na stranicu za prijavu i napravite sopstveni nalog.
Username: „vaša e-mail adresa“
Password: „password“
Nakon prijave, kliknite na polje Devices u meniju, a zatim na znak + u donjem desnom uglu. Izaberite opciju Add New Device.Ubacite ime, tip i opis uređaja i kliknite na Add.
DL28 će se prikazati na listi uređaja. Kliknite na polje za DL28 uređaj.
COPY DEVICE ID, da se doda DL28 kao broj klijenta na DL28.
COPY ACCESS TOKEN,ubaciti kaoUsername na DL28 Settings stranici za MQTT.
Tab Attributes, sadrži dolazne podatke koje je DL28 poslao na temu „v1/devices/me/attributes“. Ova tema je rezervisana za prijem statičkih podataka kao što su verzija firmvera, serijski broj i slično.
Tab Latest Telemetry, sadrži podatke koje DL28 šalje na temu „v1/devices/me/telemetri“. Ova tema je namenjena za dinamičke podatke kao što su vrednost za temperaturu, pritisak, zapreminski protok i slično, takođe za komande kao što je uključivanje/isključivanje releja.
Kliknite na Dashboards polje u levom panelu menija, yatim kliknite na „+“ znak u donjem desnom uglu i izaberite Add novedashboard opcije. Upišite ime i opis za prikaz koji želite da kreirate i kliknite na Add.
Dashboard će biti kreiran pod datim imenom i klikom na njega otvorićete ga za dalje uređivanje. Da biste ušli u režim za uređivanje, kliknite na znak olovke prikazan u donjem desnom uglu. Sada bi trebalo da dodate neke odgovarajuće widget-e za vizuelizaciju podataka.
Add new widget → Create new widget.
Izaberite odgovarajući paket sa liste, u našem slučaju ćemo izabrati Control widgets a nakon toga ćemo izabrati Switch Control.
Kliknite na Entity alias i pritisnite ENTER.
Dodajte DL28 na listu Entity alias. Imajte na umu da ovo treba uraditi samo jednom za sve vidžete koji su vezani za ovaj određeni uređaj.
Advanced kartica vam daje mogućnost podešavanja vrednosti parametara podataka.
Gore je definisano da će se za uključenje { „gt900_relai_1“: 1 } poslati, a za isključenje { „gt900_relai_1“: 0 }. Podaci su poslati na temu „v1/devices/me/request+“.
Ista ključna reč, gt900_relay_1, je korišćena za LED indikator.
Moraćemo da dodamo vidžet za vizuelizaciju podataka o povratnoj temperaturi. Za ovaj primer izabrali smo Digital gauges → TEMP widget. Samo da vas podsetimo da su ovi podaci jedan u meniju koji se dobijaju od merača toplote preko MBus protokola.
Kada su sva podešavanja završena testirajte funkcionisanje releja klikom na prekidač „GT900 RL1“.
Nakon što su sva podešavanja završena, testirajte kako relej radi klikom na prekidač „GT900 RL1“.
Više detalja o korišćenim proizvodima dostupno je na njihovim stranicama i priručnicima koji se mogu preuzeti sa stranice za download.
Slobodno kontaktirajte Decode Team ako imate dodatnih pitanja.