@City IoT Cloudová platforma




iSys - Inteligentné systémy IoT Riešenia









IoE. Systémy

Obsah

1. Úvod. 5

1.1 Podporované typy zariadení. 5

1.2. Podporované typy výrobkov. 5

1.3. Podporované komunikačné protokoly 5

1.4. Podporovaná komunikačná technológia zariadení 6

1.5. @City Cloud Server 6

1.5.1. Serverové a komunikačné brány 7

1.5.2 Integrácia protokolu HTTP LoRaWAN 7

1.5.3. Front-end rozhranie 8

1.5.3. Prístupové práva na server 8

1.6. Inteligentné zariadenia 9

1.6.1. CIoT - zariadenia GSM 9

1.6.3. BAS, BMS, IoT - zariadenia Ethernet a WiFi 9

1.6.2. Devices -LoRaWAN zariadenia 9

1.7. Možnosti Business to Business (B2B) 9

2. @City IoT Funkčnosť platformy 10

3. Hlavná stránka 11

4. Hlavné tlačivo 11

4.1. Hlavička 12

4.1.1. Domovský odkaz - (otvorí sa tabuľka skutočných výsledkov) 12

4.1.2. Začiarkavacie políčko „X“ - otvára / zatvára formulár 12 dopytov

4.1.3. Začiarkavacie políčko „V“ - otvára / zatvára polia formulára 12

4.1.4. Grafické ikony - odkazy na výsledky vizualizácie (upraviteľné) 12

4.2. Forma: 12

4.2.1. Začiarkavacie políčko „X“ - otvára / zatvára celý dotazový formulár 12

4.2.2. CSS - Vyberte tému vizualizácie 12

4.2.3. Zaškrtávacie políčko Viditeľné polia - zobrazí / skryje zoznam filtrov polí 12

4.2.4. Karta: Názov karty, ktorý chcete pridať alebo odstrániť 12

4.2.5. Tlačidlá Pridať / Odstrániť - Pridať alebo odstrániť karty s názvom v poli Tab 12

4.2.6. Vyberte tlačidlo Core 12

4.2.7. Zrušiť výber všetkých tlačidiel 12

4.2.7. Tlačidlo Vybrať všetko 12

4.2.8. Skryť filter - skryť celý formulár 12

4.2.9. Tlačidlo Execute - Zmena nastavení parametrov 13

4.2.10. Začiarkavacie políčko „V“ - zobraziť / vysoko filtrovať polia. 13

4.3. Karty 13

4.4. Obsah tabuľky 13

4.4.1. Spustiť - zobraziť výsledok typu 13

4.4.2. Kópia (+/- odkazy) 13

4.4.3. Odkazy na bunky v tabuľke 13

4.5. Poradie údajov 13

4.6. Príklad 13

5. Mapy 15

5.1. Inicializácia mapy 15

5.2. Voliteľné nastavenia pre dopyt 15

5.2.1. Úprava mierky MAP (Úroveň zväčšenia) 16

5.2.2. IMEI (výber poľa zariadenia) 16

5.2.3. Zemepisná dĺžka, šírka (súradnicové polia zemepisná dĺžka, šírka) 16

5.2.4. Upravte štýl MAP (téma) 16

5.2.5. KDE klauzula 16

5.2.6. Execute (Run Query Button) 16

5.2.7. Zrušiť výber všetkých (Odstrániť všetky polia z dotazu) 17

5.2.8. Začiarkavacie políčko „V“ (formulár na otvorenie / zatvorenie poľa)

5.2.9. Začiarkavacie políčko „X“ (Zobraziť / skryť dotazový formulár) 17

5.3. Príklad 17

6. Zobraziť výsledky v tabuľke 18

6.1. Inicializácia tabuľky 18

6.2. Voliteľné nastavenia pre dopyt 19

6.2.1. Zoradiť - zoradiť pole a zoradiť vzostupne / zostupne 19

6.2.2. DB / IMEI - vyberte zariadenie 19

6.2.3. CSS - výber štýlu (vizualizačná téma) 20

6.2.4. Viditeľné polia - Zobraziť / skryť polia Formulár 20

6.2.5. Odstrániť prázdne - nezobrazovať prázdne stĺpce 20

6.2.6. Začiarkavacie políčko „X“ (Zobraziť / skryť dotazový formulár) 20

6.2.7. Doložka Where (pre obmedzenie údajov) 20

6.2.8. Vyberte tlačidlo Core (Povoliť najbežnejšie polia) 20

6.2.9. 20. Tlačidlo Zrušiť výber (Odstrániť všetky polia z dotazu)

6.2.10. Execute (Run Query Button) 20

6.2.11. Začiarkavacie políčko „V“ (formulár poľa Otvoriť / Zavrieť) 20

7. Pruhové grafy. 21

8. Historické tabuľky. 22

8.1. Inicializácia historických máp 22

8.2. Voliteľné nastavenia historických máp 23

8.2.1. IMEI - (výberom zariadenia zobrazíte historické údaje) 23.

8.2.2. Min - minimálna minimálna hodnota prvého poľa 23

8.2.3. Max - obmedziť maximálnu hodnotu prvého poľa 23

8.2.4. „V“ - formulár na zobrazenie / skrytie polí 23. formulár

8.2.5. Od: nastavenie minimálneho dátumu a času (*) 23

8.2.6. Komu: nastavenie maximálneho dátumu, dátumu a času (*) 23

8.2.7. Začiarkavacie políčko „X“ (Zobraziť / skryť dotazový formulár) 23.

8.2.8. "Kde" Bod 23

8.2.9. Tlačidlo Zrušiť výber všetkých (Odstrániť všetky polia z dotazu) 23

8.2.10. Execute (Run Query Button) 23

8.2.11. Začiarkavacie políčko „V“ (formulár na otvorenie / zatvorenie poľa) 24

8.3. Variant pruhov: (zobrazuje iba dostupné údaje) 24

8.4. Nepretržitý variant (s rovnakými údajmi): 24

9. Kompatibilita webového prehliadača 25

10. Prispôsobenie motívov 26

11. Aktualizácia algoritmov 27

12. Štruktúra databázy 28

12.1. Štruktúra tabuliek „ithings_“ a „*“ 29

12.2. Tabuľka frontov príkazov (udalostí) zariadenia "* _c" - štruktúra 30

12.3. Prístup k výsledkom z databáz - stredná úroveň (čítanie údajov) 30

12.3.1. Získajte aktuálne stavy všetkých zariadení 30

12.3.2. Získajte historické údaje o zariadení 31

12.3.3. Získajte zoznam zariadení - jedno pole z aktuálnych stavov s obmedzením 32


1. Úvod.

@City IoT Cloudová platforma je venovaná "mikrooblak" systém pre jednotlivých zákazníkov. Platformu nie je možné zdieľať a iba jeden zákazník má prístup k fyzickému alebo virtuálnemu serveru (VPS alebo dedikované servery). Zákazník si môže zvoliť jedno z desiatok dátových centier v Európe alebo na svete.

1.1 Podporované typy zariadení.

Platforma @City IoT sa venuje nasledujúcim produktom iSys.PL



1.2. Podporované typy výrobkov.

@City (eCity) Cloud IoT Platforma je systém rôznych veľkostí pre produkty IP ((nazývané spoločne ako @City Hardware alebo Zariadenia CioT ):


1.3. Podporované komunikačné protokoly

Platforma @City IoT podporuje nasledujúce protokoly pre komunikáciu:

Dáta odosielané z radiča na cloudový server a naopak sú šifrované v jedinečnom binárnom formáte pre najmenšiu veľkosť dát a zvýšenie bezpečnosti. Každý partner dostane svoj vlastný jedinečný šifrovací kľúč na autorizáciu zariadenia, kontrolu platnosti dát atď.


Pre zariadenia iné ako eHouse / eCity môžeme dodať jednotlivé šifrovacie algoritmy ( "C" zdrojový kód) pre každého partnera pre mikroprocesor na ochranu údajov pred komunikáciou.

V takom prípade sú údaje pri obojsmernej komunikácii prostredníctvom verejných komunikačných médií (internet, vzduch, atď.) Úplne zabezpečené. ).


1.4. Podporovaná komunikačná technológia zariadení

Platforma @City supports podporuje:


@City IoT Platforma je určená pre zariadenia / uzly:


1.5. @City Cloud Server

Softvér @City pracuje na systéme Linux založenom na VPS (Virtual Private Server) alebo vyhradenom serveri na internete, v závislosti od požadovaného výkonu servera. Server (nazývaný neskôr Server):


Existuje niekoľko variantov VPS v závislosti od:


Desiatky dedikovaného servera existujú v závislosti od:


Platforma @City IoT je určená pre jedného zákazníka:


Pretože to nie je zdieľateľný server medzi zákazníkmi, zjednodušuje to prístup k bezpečnosti a problémy s výkonom. Z tohto dôvodu je za efektívnu bezpečnosť, stabilitu, efektívnosť, dátovú priepustnosť a podobne zodpovedný iba zákazník. V prípade nedostatočného výkonu si zákazník môže kúpiť vyšší plán (VPS alebo dedikovaný server), optimálnejší pre očakávanú funkčnosť a výkon.

V osobitných prípadoch "Cloud to cloud" môže byť implementovaná komunikácia na globalizáciu a centralizáciu dát do väčších oblastí namiesto cloudu pre viacerých zákazníkov.

1.5.1. Serverové a komunikačné brány

Komunikácia servera @City Server sa realizuje na základe nízkoúrovňovej aplikácie pre maximalizáciu výkonu.

Hlavné vlastnosti aplikácie @City Server sú:

Softvér @City Server je pre každého používateľa rovnaký a nemožno ho prispôsobiť pre rôznych zákazníkov.

1.5.2 Integrácia protokolu HTTP LoRaWAN

Ovládače LoRaWAN sú integrované do cloudu @City cez rozhranie HTTP (webhooks) dostupné na sieťovom / aplikačnom serveri LoRaWAN.

Podporovaných je niekoľko typov sieťových / aplikačných serverov:

TTN (obmedzený čas "Vo vzduchu" a maximálny počet príkazov odoslaných do ovládača a nepodporujú aktualizáciu firmvéru)

LoraWAN-Stack (Vyžaduje sa hosťovanie na fyzickom zariadení s prístupom na internet).

LoraServer.Io (Vyžaduje hosťovanie na fyzickom zariadení s prístupom na internet - iba odosielanie údajov na server a nepodporuje aktualizáciu firmvéru)



Cloud @City Cloud pre radiče LoRaWAN je rozdelený rovnakým spôsobom ako pre ostatné rozhrania. Je to rozobraté v predchádzajúcej kapitole.

1.5.3. Front-end rozhranie

Front-end rozhranie je realizované pomocou skriptov PHP na extrakciu prispôsobených údajov z cloudovej databázy @City. Používa veľmi pružný vyhľadávací mechanizmus založený na pôvodných dotazoch SQL na obmedzenie požadovaných údajov. Rozhranie dodáva výsledky dotazov vo formáte JSON na ďalšie dekódovanie a spracovanie application front-end webovou „aplikáciou“.

Originálne klientske rozhranie je rovnaké pre každého používateľa a nemožno ho prispôsobiť pre rôznych zákazníkov.

Prekrytie rozhrania môžu vytvoriť naši pracovníci alebo v spolupráci, aby sa zabezpečilo prispôsobenie zákazníka.

1.5.3. Prístupové práva na server

Prístupové práva zákazníka (k fyzickému serveru) sú obmedzené.

Prístup k súborom iba pre adresár „šablón“ (natívne textové súbory - .txt, .js, .css, .html):

Ďalšie prístupové práva:


Pracovníci spoločnosti iSys - Intelligent Systems - majú neobmedzený prístup k celému serveru vrátane účtu root a úplného prístupu k databáze kvôli údržbe.

Za určitých okolností môže spoločnosť iSys poskytnúť zákazníkovi ďalšie obmedzené práva (skripty PHP, súbory) po kontrole zdrojového kódu, vykonaní testov, ak to neovplyvní celkovú bezpečnosť, stabilitu a výkon systému.


1.6. Inteligentné zariadenia

1.6.1. CIoT - zariadenia GSM

Naše zariadenia obsahujú mikrokontrolér a modul GSM / GPS / GNSS (2G..4G, NBIoT, CATM1) na komunikáciu. Mikrokontrolér obsahuje šifrovaný bootloader pre bezpečnú aktualizáciu firmvéru OTA. To umožňuje vytvárať veľa systémových variantov založených na tých istých "Inteligentné zariadenie CIoT".


1.6.3. BAS, BMS, IoT - zariadenia Ethernet a WiFi


Radiče Ethernet a WiFi umožňujú komunikáciu na základe protokolu IP do systému (bez poplatkov za prenos dát operátorovi GSM). Toto zariadenie má tiež šifrovaný bootloader a zariadenia je možné aktualizovať prostredníctvom jeho natívneho rozhrania. Pre WiFi má OTA firmware upgrade z hlavného servera


1.6.2. IoT - zariadenia LoRaWAN

LoRaWAN umožňuje prenos dát na veľmi veľké vzdialenosti (do cca. 15km). Tento rozsah závisí od rýchlosti prenosu údajov, množstva údajov, urbanizácie oblasti a účinnosti rádiových trás zariadení.

Naše zariadenia obsahujú mikrokontrolér a modul LoRaWAN na komunikáciu. Mikrokontrolér obsahuje šifrovaný bootloader pre bezpečnú aktualizáciu softvéru OTA. To vám umožní vytvoriť viac systémových variantov založených na rovnakom "IoT smart device". Zariadenia pracujú v otvorenom pásme ISM bez ďalších poplatkov za predplatné. Je potrebné použiť LoRaWAN Gateway na pokrytie celej oblasti prístupom k internetu. V prípade existujúcich brán LoRaWAN v dosahu zariadení (nakonfigurovaných pre server TTN) je možné cez ne posielať informácie. Aktualizácia firmvéru vyžaduje vlastnú sieť / aplikáciu LoRaWAN server a dobrý dosah pre komunikáciu.

1.7. Možnosti medzi podnikmi (B2B)


Existuje niekoľko možností pre obchod a spoluprácu:

2. @City IoT Funkčnosť platformy

Platforma @City podporuje prispôsobiteľnú šablónu front-end pre vizualizáciu údajov, dopytovanie, obmedzenie a spracovanie (aktuálne / historické údaje):


Front-end používateľa je prístupný cez statickú adresu IP alebo doménu / subdoménu / súbor na presmerovanie DNS, ak sú k dispozícii.


Príkladná a ukážková inštalácia (Je povolená iba pre potenciálnych zákazníkov).

Ak to chcete vyskúšať, informujte nás - aby sme umožnili verejný prístup k platforme.

Môže to vyžadovať statickú adresu IP vzdialeného počítača, aby sa umožnila komunikácia s platformou @City.


3. Hlavná stránka

Hlavná stránka je zámerne ponechaná prázdna z bezpečnostných dôvodov: http: //% YourIP% / IoT /

Môže byť individuálne povolený a upravený a obsahovať odkazy na všetky dostupné služby webu @City IoT platforma ak sa to vyžaduje


4. Hlavný formulár

Hlavný formulár je určený na vytvorenie nových predvolieb a kariet: http: //%IP%/IoT/que.php

Toto je počiatočná forma na vytváranie výsledkov, zobrazení a kariet pre každú konfiguráciu




Popisy (zhora a zľava doprava)

4.1. Hlavička

4.1.1. Domovský odkaz - (otvorí tabuľku skutočných výsledkov)

4.1.2. "X" začiarkavacie políčko - otvára / zatvára formulár dotazu

4.1.3. „V“ začiarkavacie políčko - otvára / zatvára formulár poľa

4.1.4. Grafické ikony - odkazy na výsledky vizualizácie (editovateľné)


4.2. Forma:

4.2.1. "X" začiarkavacie políčko - otvorí / zatvorí celý dotazový formulár

4.2.2. CSS - Vyberte Téma vizualizácie

Súbor CSS úpravy témy vizualizácie musí existovať v doméne "šablóny / css /" adresár - uvedený automaticky.

4.2.3. Viditeľné polia začiarkavacie políčko - zobrazí / skryje zoznam filtrov polí

4.2.4. Záložka: Názov karty, ktorý chcete pridať alebo odstrániť

4.2.5. Pridať / Odstrániť Tlačidlá - Pridanie alebo odstránenie kariet s menom v Tab lúka

4.2.6. Vyberte Core Tlačidlo

Vyberte hlavné polia viditeľné na tabuľke. To je aktualizovaný automaticky.

4.2.7. Odznačiť všetko Tlačidlo

Zrušte výber všetkých polí (musí nasledovať manuálny výber niektorých z nich)

4.2.7. Vybrať všetko Tlačidlo

Vyberte všetky polia (musí byť nasledované zrušením výberu niektorých z nich ručne)

4.2.8. Skryť filter - Skryť celý formulár

Toto je ekvivalent všetkých začiarkavacích políčok (X)

4.2.9. Vykonať Tlačidlo - Zmena nastavení parametrov

4.2.10. „V“ začiarkavacie políčko - zobraziť / vysoko filtrovať polia.


4.3. Záložky

Jednotlivo vytvorené karty s menami a predvoľbami (uložené v priečinku cfg / tabs.cfg spis).

Súbor v skutočnosti obsahuje meno a adresu URL (oddelené znakom tabulátora).


4.4. Obsah tabuľky

Zobrazí všetky polia obmedzené filtrom polí.


Polia v tabuľke:

4.4.1. Spustiť - počet výsledkov zobrazenia

mapa- výsledky mapovania na mape (je možné zvoliť jedno alebo viac polí)

história - historické mapy (možno zvoliť jedno alebo viac polí)

tab - zobrazí tabuľku (je možné zvoliť ľubovoľnú kombináciu polí)

bar - na stĺpcovom grafe je zobrazené iba jedno pole

Po stlačení jednej z jeho hodnôt sa otvoria nové výsledky s vybranými poľami (pre aktuálny riadok).


4.4.2. Kopírovať (+/- odkazy)

Pridanie / odstránenie karty s názvom nastaveným v Tab lúka. Používa iba polia vybrané v rovnakom riadku tabuľky.


4.4.3. Odkazy na bunky tabuľky

Stlačením ľubovoľného iného názvu poľa sa spustí vizualizácia údajov vybraného poľa pre vybraný riadok.


4.5. Objednávka údajov


Poradie zobrazených polí je rovnaké ako ich poradie vo forme polí (avšak tm pole sa vždy pošle na koniec textu). Toto poradie je možné zmeniť iba priamou úpravou parametrov URL (časť objednávky polí).


4.6. Príklad

Napríklad: Nastavenie karty s Sledovanie majetku názov a obsahuje mapu s časom a rýchlosťou na mape

Celý popis odkazujúci na riadok kde "Map" text je v "Bež" stĺpec.

  1. Zadaj meno "Sledovanie majetku" v Tab pole (bez úvodzoviek)

  2. Zaistite, aby neboli v riadku vybrané všetky stĺpce

  3. vyberte tm, gps_speed_km iba v rade

  4. stlačte + tlačidlo kde v rade






5. Mapy

Mapy je možné spúšťať z MainForm s predkonfiguráciou


5.1. Inicializácia mapy

Inicializácia mapy sa vykonáva ručne, ak je vykonaná priamo pomocou odkazu: > http: //%IP%/IoT/maps.php


  1. Užívateľ by mal zrušiť výber všetkých polí (stlačte Zrušiť výber Tlačidlo)

  2. Stlačte niektoré začiarkavacie políčka pre zobrazené polia (napr. Ain5 (pre hladinu smogu) a tm (pre dátum / čas merania)

  3. stlačte „V“ začiarkavacie políčko na skrytie formulára polí

  4. stlačte Vykonať tlačidlo na spustenie dotazu DB a zobrazenie aktuálnych informácií zo všetkých senzorov / zariadení

  5. Mapa s údajmi sa aktualizuje po 30 alebo viac sekundách.


5.2. Voliteľné nastavenia pre dopyt

Nastavenia sú popísané zľava doprava (na snímke vyššie).

5.2.1. Úprava mierky MAP (Úroveň zväčšenia)

  1. Úroveň zväčšenia je možné upraviť pomocou tlačidiel (+/-) na zmenu mierky (current_scale * 2 alebo current_scale / 2). Stlačením jedného z týchto tlačidiel sa mierka automaticky upraví.

  2. Ďalším spôsobom je výber úrovne zväčšenia Zväčšiť Pole so zoznamom a stlačte Vykonať tlačidlo. V takom prípade sa celý View / Map znovu načíta a obnoví (počas inicializácie to chvíľu trvá).

5.2.2. IMEI (Vyberte pole zariadenia)

IMEIpole obsahuje jedinečné ID zariadenia alebo jedinečný alias zariadenia. Predvolené nastavenie je * (hviezdička), ktorá zobrazuje najnovšie hodnoty a geolokáciu pre každé zariadenie.

Nastavením IMEI na inú hodnotu zobrazíte historické údaje vybraného zariadenia. Má zmysel iba pre mobilné a pohyblivé senzory, inak sa výsledky na mape prekrývajú v rovnakej polohe.


5.2.3. Lon, Lat (Polia súradníc zemepisná dĺžka, šírka)

Nastavte strednú polohu mapy. Toto pole je nastavené na pozíciu kurzora pri stlačení tlačidla myši na mape.


5.2.4. Upraviť štýl MAP (téma)

Štýl / tému mapy je možné zvoliť z Map Pole ComboBox (napr. Tmavá, šedá, topografická).

Rôzne motívy máp môžu mať rôzne maximálne úrovne zväčšenia, aby bolo možné vynútiť správnu tému na zväčšenie mierky mapy.


5.2.5. KDE Doložka

Kde sa klauzula používa pre ďalší reťazec dotazu {WHERE part} pre MySQL / MariaDB.

Táto klauzula sa berie do úvahy pri zostavení úplného reťazca QUERY pre výsledok databázy. Môže to obmedziť údaje, čas a akékoľvek ďalšie hodnoty obmedzením počtu výsledkov. V tomto poli musia byť použité pôvodné názvy polí tabuľky (nie alias). Napr.

  1. gps_speed_km> 10 // rýchlosť je viac ako 10 km / h

  2. ain5> 3 // ain5 je väčší ako 3 (drží počet častíc 2,5 um - úroveň smogu)

  3. gps_speed_km> 10 a ain6> 5 // rýchlosť je viac ako 10 km / ha ain6 je vyššia ako 5 (drží počet častíc 10 um - úroveň smogu)


5.2.6. Vykonať (Tlačidlo Spustiť dopyt)

Stlačenie tohto tlačidla je potrebné na zmenu akýchkoľvek nastavení, parametrov (okrem stlačenia +/- tlačidlá).

Mapa je od začiatku načítaná s novými predvoľbami.

Mapa sa vôbec nenačíta, keď pre aktuálny dopyt nie sú k dispozícii žiadne údaje.

5.2.7. Odznačiť všetko (Odstrániť všetky polia z dotazu)

Po stlačení tohto tlačidla musí byť aspoň jedno pole vybrané manuálne, aby sa výsledky zobrazili na mape.


5.2.8. „V“ Začiarkavacie políčko (formulár poľa Otvoriť / Zavrieť)

Toto začiarkavacie políčko sa používa na zobrazenie / skrytie výberu polí, ktoré sa majú zobraziť.


5.2.9. "X" Začiarkavacie políčko (Zobraziť / skryť dotazový formulár)

Toto začiarkavacie políčko umožňuje skryť celý formulár okrem ( +/- tlačidlá)


Výsledky na mape sa neustále obnovujú a aktualizujú o nové hodnoty

5.3. Príklad

Napr. Výsledky smogu (senzor nainštalovaný vo vozidle): úroveň smogu 2,5 μm (Ain5), rýchlosť (gps_speed_km), dátum / čas (tm), mapa (2 - topografická), úroveň priblíženia 16,

Klauzula kde:

"gps_fix = 3 a tm> „2019-02-18 00:00:00“ a tm <„2019-02-19 00:00:00“ a gps_speed_km> 0".

// GPS = platné 3D výsledky a dátum = 2019-02-18 a rýchlosť> 0 km / h



6. Zobraziť výsledky v tabuľke

Zobraziť výsledky v tabuľke.

On "Hlavný formulár" stlačte "stôl" položka, po výbere niektorých polí na zobrazenie predkonfigurovanej tabuľky




6.1. Inicializácia tabuľky

Keď je tabuľka otvorená z odkazu http: //%IP%/IoT/que.php? func = karty vyžaduje to predchádzajúcu inicializáciu nastavení.

Viditeľné polia môžete zvoliť (stlačením "Viditeľné polia" ) začiarkavacie políčko.



  1. Pre zobrazené polia stlačte všetky povinné začiarkavacie políčka

  2. Stlačte začiarkavacie políčko "Viditeľné polia" skryť formulár poľa

  3. Stlačením tlačidla Execute spustíte DB dotaz a zobrazíte tabuľku


6.2. Voliteľné nastavenia pre dopyt

Nastavenia sú popísané zľava doprava (na snímke obrazovky).

6.2.1. Triediť - zoradiť pole a zoradiť vzostupne / zostupne

Pole na zoradenie je ekvivalentné stlačeniu hlavičky stĺpca.

6.2.2. DB / IMEI - Vyberte zariadenie

IMEIpole obsahuje jedinečné ID zariadenia alebo jedinečný alias zariadenia. S prázdnou hodnotou zobrazuje tabuľku najnovších hodnôt.

Nastavením IMEI na inú hodnotu zobrazíte historické údaje vybraného zariadenia.


6.2.3. CSS - vyberte štýl (Téma vizualizácie)

6.2.4. Viditeľné polia - Zobraziť / skryť formulár polí

6.2.5. Odstrániť prázdne - Nezobrazovať prázdne stĺpce

6.2.6. "X" Začiarkavacie políčko (Zobraziť / skryť dotazový formulár)

6.2.7. Kde Doložka (pre obmedzenie údajov)

Toto je prípona pre dodatočný reťazec dotazu MySQL / MariaDB {WHERE part}

Táto klauzula sa berie do úvahy pri zostavovaní úplného reťazca QUERY pre výsledok databázy. Môže to obmedziť údaje, čas a akékoľvek ďalšie hodnoty obmedzením počtu výsledkov. V tomto poli musia byť použité pôvodné názvy polí tabuľky (nie alias). Napr.

  1. gps_speed_km> 10 // rýchlosť je viac ako 10 km / h

  2. ain5> 3 // ain5 je väčší ako 3 (drží počet častíc 2,5 um - úroveň smogu)

  3. gps_speed_km> 10 a ain6> 5 // rýchlosť je viac ako 10 km / ha ain6 je vyššia ako 5 (drží počet častíc 10 um - úroveň smogu)


6.2.8. Vyberte Core Tlačidlo (Povoliť najbežnejšie polia)


6.2.9. Odznačiť všetko Tlačidlo (Odstrániť všetky polia z dotazu)

Po stlačení tohto tlačidla musí byť aspoň jedno pole vybrané manuálne, aby sa výsledky zobrazili na mape.


6.2.10. Vykonať (Tlačidlo Spustiť dopyt)

Stlačenie tohto tlačidla je potrebné na zmenu akýchkoľvek nastavení, parametrov (okrem stlačenia +/- tlačidlá).

Tabuľka sa načíta od začiatku s novými predvoľbami.



6.2.11. „V“ Začiarkavacie políčko (formulár poľa Otvoriť / Zavrieť)

Toto začiarkavacie políčko sa používa na zobrazenie / skrytie výberu polí, ktoré sa majú zobraziť.



Výsledky v tabuľke sú zoradené podľa Triediť poľné nastavenie. Poradie triedenia je možné zmeniť stlačením hlavičky riadku (raz pre jeden smer dvakrát pre iný smer).

Niektoré výsledky v stĺpcoch odkazujú na ďalšie vizualizačné obrazovky (napevno).


Pri zobrazovaní historických údajov pre zariadenie by malo byť obmedzené, aby sa nezobrazili celé informácie o histórii, pretože by to mohlo viesť k výkonu alebo problémom s nedostatkom pamäte.


7. Pruhové grafy.

Stĺpcové grafy by sa mali vykonávať z hlavného formulára stlačením jedného poľa v riadku „Bar“.

Zobrazuje zoradené pruhy normalizované na maximálnu hodnotu, ktoré sa zobrazujú od najvyššieho po najnižší.

Je to užitočné na rýchlu kontrolu extrémnych výsledkov a vykonanie niektorých akcií.





Mouse Over event zobrazí ďalšie informácie o zariadení.


8. Historické tabuľky.

Historické mapy je možné inicializovať z formulára MainForm po stlačení vybratého stĺpca v riadku „History“ (pre jedno pole).

Pre viac polí v riadku „História“ musia byť začiarknuté požadované polia a musí byť stlačený odkaz „História“ v stĺpci „Spustiť“.

Historické výsledky sú obmedzené na posledných 24 hodín + ďalších 24 hodín (pre prípadné obnovovacie mapy), keď neboli stanovené žiadne limity.

8.1. Inicializácia historických máp


Historické mapy pri otvorení z hlavného odkazu si vyžadujú inicializáciu ako ďalšie výsledky, keď sú otvorené z odkazu bez parametrov preferencií.

Na zobrazenie rôznych položiek je možné zvoliť viac polí. Môže byť tiež nastavený vo formulári poľného filtra.




  1. Pre zobrazené polia stlačte všetky povinné začiarkavacie políčka

  2. Stlačte začiarkavacie políčko "Viditeľné polia" skryť formulár poľa

  3. Stlačením tlačidla Execute spustíte DB dotaz a zobrazíte tabuľku


8.2. Voliteľné nastavenia historických máp

Položky popísané zhora a zľava doprava (na snímke obrazovky).

8.2.1. IMEI - (Vyberte zariadenie na zobrazenie historických údajov)

IMEIpole obsahuje jedinečné ID zariadenia alebo jedinečný alias zariadenia. S hodnotou * (asterix) zobrazuje tabuľku najnovších hodnôt, ktorá nemá zmysel.

Nastavením IMEI na inú hodnotu zobrazíte historické údaje vybraného zariadenia.

8.2.2. Min. - obmedziť minimálnu hodnotu prvého poľa

8.2.3. Max - obmedziť maximálnu hodnotu prvého poľa

8.2.4. „V“ - Zobraziť / skryť formulár polí

8.2.5. Od: nastaviť minimálny dátum / čas (*)

8.2.6. To: nastavenie maximálneho dátumu, dátumu a času (*)

8.2.7. "X" Začiarkavacie políčko (Zobraziť / skryť dotazový formulár)

8.2.8. "Kde" Doložka

Doložka o obmedzení výsledkov údajov Dodatočný reťazec dotazu MySQL / MariaDB {WHERE part}.

Táto klauzula sa berie do úvahy pri zostavení úplného reťazca QUERY pre výsledok databázy. Môže to obmedziť údaje, čas a akékoľvek ďalšie hodnoty obmedzením počtu výsledkov. V tomto poli musia byť použité pôvodné názvy polí tabuľky (nie alias) a platná syntax SQL. Napr.

  1. gps_speed_km> 10 // rýchlosť je viac ako 10 km / h

  2. ain5> 3 // ain5 je väčší ako 3 (drží počet častíc 2,5 um - úroveň smogu)

  3. gps_speed_km> 10 a ain6> 5 // rýchlosť je viac ako 10 km / ha ain6 je vyššia ako 5 (drží počet častíc 10 um - úroveň smogu)


8.2.9. Odznačiť všetko Tlačidlo (Odstrániť všetky polia z dotazu)

Po stlačení tohto tlačidla musí byť minimálne jedno pole vybrané manuálne, aby sa zobrazili historické výsledky.


8.2.10. Vykonať (Tlačidlo Spustiť dopyt)

Stlačenie tohto tlačidla je potrebné na zmenu akýchkoľvek nastavení, parametrov (okrem zobrazovacích polí alebo panela dotazov). Tabuľka sa načíta od začiatku s novými predvoľbami.

8.2.11. „V“ Začiarkavacie políčko (formulár poľa Otvoriť / Zavrieť)

Toto začiarkavacie políčko sa používa na zobrazenie / skrytie výberu polí, ktoré sa majú zobraziť.


8.3. Bary Variant: (zobrazuje iba dostupné údaje)



8.4. Kontinuálne variant (s rovnakými údajmi):



Ukazovateľ myši zobrazuje hodnoty meraní a dátum / čas.

9. Kompatibilita s webovým prehliadačom


Funkcia / WWW prehliadač

Chrome 72

FireFox 65

Hrana

Opera 58

Mapy

+

+

+

+

Historický

+

+ (*)

+

+

Bary

+

+

+

+

Záložky

+

+

+

+


* - Firefox nepodporuje výber dátumu a času (textové pole musí byť manuálne upravené v správnom formáte dátumu a času).

Internet Explorer nie je podporovaný (použitie Hrana namiesto toho)

Ostatné webové prehľadávače neboli testované.



10. Prispôsobenie motívov

Webové stránky sú založené na súbore všeobecných šablón umiestnenom na adrese „šablóny“ adresár "* .template".

Každý typ stránky navyše obsahuje:

  1. Súbor „* .head“, ktorý ukladá hlavičku stránky (odkazy, importované CSS, JavaScript súbory atď.) )

  2. Súbory „* .foot“, ktoré ukladajú pätu stránky (odkazy atď.) )


Téma vizualizácie sa dá zmeniť podľa preferencií používateľa vyrovnaním a úpravou súborov CSS. Súbory CSS sa nachádzajú v priečinku „šablóny / css“ adresár. Na vytvorenie optimalizovaných pre napr. tlač, šablóny SmartPhones, PAD.


Table pohľady - majú voliteľné pole pre výber CSS súboru pre úplnú úpravu témy (uložené v „šablóny / css / karty“ adresár).




Map názory - všeobecná téma je vybratá používateľom "mapa" rozbaľovací zoznam typu. Ďalej je tu predvolený súbor CSS „templates / css / map.css“ ktorý obsahuje niektoré ďalšie funkcie, ako je skrytie / vyfarbenie výsledkov na základe jeho hodnôt. Zvyšok tohto súboru CSS sa prakticky obmedzuje na formuláre dotazov a polí.


Väčšina z @ Mestská platforma Súbory PHP na vizualizáciu akceptujú cssparameter s hodnotou názvu súboru pre tému (bez prípony). Súbor musí byť umiestnený v adresári „templates / css“ a v jeho názve sa rozlišujú malé a veľké písmená.


Niektoré prvky zobrazenia témy sú umiestnené priamo v súbore located umiestnenom v priečinku „template / js“ adresár.

Hlavný @Mesto scenár„@ City.js“ sa nachádza v hornom adresári. V tomto nie je možnosť úpravy umiestnenie, skript však možno skopírovať do „šablóny / js“ adresár a upravený tam. Použitie individuálneho skriptu vyžaduje aktualizáciu všetkých hlavičkových súborov.

11. Aktualizácia algoritmov


Niektoré jedinečné snímače môžu vyžadovať vyhradené výpočtové funkcie.

Nie je možné aktualizovať a udržiavať viac variantov @City Serverový softvér, Front-endové rozhranie PHP, čo by spôsobilo veľa problémov, verzií, chýb.

Najlepším a najjednoduchším spôsobom, ako to dosiahnuť, je aktualizácia „overlay“ súborov na správne zobrazenie hodnoty / popisu.

Originálne skripty JS sú otvorený textový súbor a môžu sa prispôsobiť potrebám zákazníka. Ako je uvedené v predchádzajúcej kapitole, musia byť skopírované „šablóny / js“ adresár, kde má zákazník prístupové práva na úpravy.


Technický aspekt programovania @Mesto tento systém nie je predmetom tohto dokumentu, avšak webový vývojár so základnými znalosťami HTML a JS môže prispôsobiť front-end webovú aplikáciu podľa individuálnych potrieb zákazníka.


12. Štruktúra databázy


@ Mestská databáza s menom „IoT“ alebo „* IoT“ je rozdelený do tabuliek (kde asterix je predpona v závislosti od hostiteľského servera - ak je to potrebné). DataBase sa dá pozorovať v PHPAdmin (webová aplikácia) na odkaze http: //% IP% / phpmyadmin




Nastavené tabuľky pre každé zariadenie (kde * {asterix} je adresa IMEI - jedinečné ID):

Ostatné tabuľky:



12.1. Štruktúra tabuliek „ithings_“ a „*“

12.2. Štruktúra tabuľky frontu príkazov (udalostí) zariadenia "* _c"


Táto tabuľka je frontom udalostí / príkazov pre každé zariadenie a má nasledujúcu štruktúru:



12.3. Prístup k výsledkom z databáz - stredná úroveň (čítanie údajov)


Dáta môžu byť prístupné bez webovej aplikácie Front-end. Systém @City obsahuje skript s funkciami na strednej úrovni. Výsledky sa vracajú vo formáte JSON.


12.3.1. Získajte aktuálne stavy všetkých zariadení

http: //%IP%/IoT/que.php? func = devsjson


Dopyt sa vráti celý „_ithings“ tabuľka (aktuálne stavy všetkých zariadení) vo formáte JSON:

[{ "krajina":"", "mesto":"", "kontinent":"", "krajina":"", "regiónu":"", "podoblasť":"", "subregión":"", "mesto":"", "okres":"", "ulica":"", "ulica_č":"", "item_nr":"", „gps_lat“:"0000,0000N", „gps_long“:"00000,0000E", „tm“:"2019-02-10 12:56:23", „tvorba“:"2019-02-09 18:12:38", „posledný“:"0000-00-00 00:00:00", "diania":"", "používateľ":"", "prejsť":"", „imei“:"351580051067110", "sn":"", "postavenie":"73000200000f360033026800240000002c002c002dffffffffffffffff5b63000001c1000001c20000000000000009250a4f0a760a7a0a750a780a7e0000031d032205fc34029b025c025600460eb305320000", "hash_code":"", "addr":"", "fwnr":"", "postihnutý":"", "gsm_nr":"", "predajca":"", "časové pásmo":"", "dst":"", „rssi“:"91", „rsrp“:"99", „gps_lat“:"0000,0000N", „gps_long“:"00000,0000E", „gps_hdop“:"", „gps_alt“:"", „gps_fix“:"4", „gps_cog“:"", „gps_speed_km“:"", „gps_sat“:"", "diania":"", „out1“:"0", "out2":"0", "out3":"0", "out4":"0", "von5":"0", "out6":"0", "von7":"0", "von8":"0", "out9":"0", "out10":"1", "out11":"0", "out12":"0", "out13":"0", "out14":"0", "out15":"0", „out16“:"0", „in1“:"0", "in2":"0", "v3":"0", "in4":"0", "v5":"0", "v6":"0", "v7":"0", "v8":"0", "v9":"0", "v10":"0", "v11":"0", "v12":"0", "v13":"0", "v14":"0", "v15":"0", „v16“:"0", „ain1“:"3894", "ain2":"51", "ain3":"616", "ain4":"36", "av5":"0", "ain6":"44", "ain7":"44", „ain8“:"45", "sens1":"0", "sens2":"0", "sens3":"0", "sens4":"0", "sens5":"0", "sens6":"0", "sens7":"0", "sens8":"0", „dimm1“:"255", "dimm2":"255", "dimm3":"255", "dimm4":"255", "dimm5":"255", "dimm6":"255", "dimm7":"255", „dimm8“:"255", „int1“:"-16776767", "int2":"450", "int3":"", "int4":"", "int5":"", „int6“:"0", „text1“:"", "text2":"", "text3":"", "text4":"", "text5":"", „text6“:"" }]

12.3.2. Získajte historické údaje o zariadení

Dotaz na historické údaje jedného zariadenia podľa čísla IMEI:

http: //%IP%/IoT/que.php? func = imeijson & imei = 356345080018095


Pretože celá tabuľka môže obsahovať milióny riadkov, mala by byť obmedzená klauzulou WHERE, aby nedošlo k zaveseniu servera.

Ďalšie parametre parametre adresy URL:

func - imeijson

imei - IMEI zariadenia

lúka - polia, ktoré sa majú zobraziť vo výsledkoch (zoznam oddelený kómou)

min - minimálna hodnota pre prvé pole v zozname

max - maximálna hodnota pre prvé pole v zozname

salebot - pole pre triedenie

tm - pole sa automaticky pridá k výsledkom.

where - kde klauzula na obmedzenie údajov -


Príklad:

Chceme získať nasledujúci výsledok

pre zariadenie s imei=356345080018095

zobraziť polia: ain5, ain6, gps_lat, gps_long

a limit av5 v dosahu ( 1, 10 000 ) - musí byť prvým poľom v zozname

a GPS mať platné údaje (gps_fix = 3)

a dátum / čas (tm) from2019-02-14 23:00:19 to 2019-02-15 00:00:00


Vytvorený reťazec adresy URL:

http: //%IP%/IoT/que.php? func =imeijson& imei =356345080018095& pole =av5, ain6, gps_lat, gps_long& min =1& max =1 000& kde =gps_fix = 3 a tm> „2019-02-14 23:00:19“ a tm <„2019-02-15 00:00:00“


Výsledky dopytu:

[{ "av5":"66","ain6":"68",„gps_lat“:"5202,7326N",„gps_long“:"02115,8073E",„tm“:"2019-02-14 23:04:31" }, { "av5":"67","ain6":"76",„gps_lat“:"5202,7328N",„gps_long“:"02115,8075E",„tm“:"2019-02-14 23:05:42" }, { "av5":"63","ain6":"77",„gps_lat“:"5202,7328N",„gps_long“:"02115.8074E",„tm“:"2019-02-14 23:06:05" }, { "av5":"58","ain6":"77",„gps_lat“:"5202,7328N",„gps_long“:"02115,8075E",„tm“:"2019-02-14 23:06:32" }, { "av5":"58","ain6":"68",„gps_lat“:"5202,7328N",„gps_long“:"02115,8076E",„tm“:"2019-02-14 23:06:55" }]

12.3.3. Získajte zoznam zariadení - jedno pole z aktuálnych stavov s obmedzením

Táto funkcia vracia obmedzené údaje z tabuľky „_ithings“


http: //%IP%/IoT/que.php? func = fieldjson & field = ain5 & min = 13 & max = 5 000



Parametre:

func - fieldjson

lúka - pole, ktoré sa má zobraziť vo výsledkoch - imei a tm sa automaticky pridajú

min - minimálna hodnota pre pole

max - maximálna hodnota pre pole


Pre vyššie uvedený reťazec dotazu sa vráti výsledky z ain5, imei, tm polia:

ak av5 je v dosahu (13 5 000)


Výsledky dopytu:

[{„imei“:"353080090069142", „tm“:"2019-03-14 11:51:01", "av5":"14" },

{„imei“:"356345080018095", „tm“:"2019-02-20 09:13:04", "av5":"115" },

{„imei“:"karczew", „tm“:"07.03.2019 13:08:22", "av5":"103" }]