3.8 Autonomní měřící systém (AMS)

Řešení AMS umožní automatický lokální odečet dat nejen z měřičů energií, jako jsou např. elektroměry, plynoměry či vodoměry, ale i z různých senzorů a čidel. Data z nich jsou následně vzdáleně sbírána a přenášena na centralizovaný software. Díky tomu má správce budovy nebo dodavatel energií k dispozici vždy detailní přehled o aktuální spotřebě, s kterým může dál pracovat dle svých potřeb (např. vyúčtování poskytnutých služeb). Pro komunikaci s měřiči se využívá protokol IEC 62056-21, resp. M-BUS aplikovaný na rozhraní RS 232, RS 485, resp. M-Bus. Je tak možné pravidelně data z měřiče vyčítat a ukládat do interní paměti 2N^® SmartCom PRO. Tato zachycená data je možné dále třídit a filtrovat. Integraci dalších komunikačních protokolů je možné řešit na základě potřeb zákazníka.

AMS se nastavuje pomocí AT rozhraní, jehož funkci si nyní popíšeme. Přihlaste se pomocí terminálu do 2N^® SmartCom PRO, jehož firmware podporuje AMS, a postupujte dle následujících příkazů. Jednotlivé měřiče se ukládají do tabulky, ve které je možné mít až 64 nezávislých měřičů. Velikost datového prostoru je potom dána verzí HW. Všechny záznamy se zapisují do kruhového bufferu. To znamená, že pokud bude naplněna maximální kapacita paměti, bude nejstarší zpráva smazána a nahrazena novou.

Nastavení zařízení AMS

Tyto příkazy slouží pro nastavení měřičů. 

AT^SCAMS=?

Vypíše seznam příkazů pro ovládání modulu AMS, seznam jejich parametrů a formát jednotlivých parametrů. 

Odpověď: 

^SCAMS: "ENABLE",0|1
^SCAMS: "RETRY",0-9
^SCAMS: "DEV_ADD",1-1000,"32"|1-1000,"32","3"
^SCAMS: "DEV_REMOVE",1-32
^SCAMS: "DEV_CLEAR"
^SCAMS: "DEV_INTERVAL","ALL"|1-32,"3"
^SCAMS: "DIRECT_READ",1-1000,"32"|1-1000,"32",110-230400,0|1
OK

AT^SCAMS?

Vypíše obsah tabulky zařízení obsluhovaných modulem AMS.

^SCAMS: NO DEVICE
OK

^SCAMS: 1> 2,"IEC62056-21","869551","1M"
^SCAMS: 2> 2,"IEC62056-21","869552","15M"
^SCAMS: 3> 128,"AIN_DIN","1/ADC/CAL","1M"
^SCAMS: 4> 128,"AIN_DIN","2/PULSE/ABS","1H"
OK

AT^SCAMS="ENABLE",<zapnuto>

^SCAMS: "ENABLE",1
OK

OK

ERROR

AT^SCAMS="RETRY"[<pocet_opakovani>]

^SCAMS: "RETRY",<aktualni_pocet_opakovani>
OK

AT^SCAMS="RETRY"

AT^SCAMS="RETRY",2

OK

ERROR

AT^SCAMS="DEV_ADD",<port>,<protokol>,<adresa>,<interval>

 — Příklady použití — 

Nastavení není jednoduchá záležitost, proto níže uvedeme několik vzorových příkazů, které Vám mohou sloužit jako vodítko k úspěšnému nastavení požadované funkce.

AT^SCAMS="DEV_ADD",2,"IEC62056-21","869551","3M"

AT^SCAMS="DEV_ADD",2,1,"869551","3M"

AT^SCAMS="DEV_ADD",2,"MBUS","128@2400","1H"

AT^SCAMS="DEV_ADD",2,"MBUS","128","1H"

AT^SCAMS="DEV_ADD",2,2,"128","1H"

AT^SCAMS="DEV_ADD",2,"MBUS","*01579411@2400","1H"

AT^SCAMS="DEV_ADD",2,"MBUS","*015794FF@2400","1H"

AT^SCAMS="DEV_ADD",128,"AIN_DIN","1/ADC/CAL","1H"

AT^SCAMS="DEV_ADD",128,"AIN_DIN","2/DIN","2H"

AT^SCAMS="DEV_ADD",128,128,"2/DIN","2H"

AT^SCAMS="DEV_ADD",128,"AIN_DIN","1/PULSE/ABS","2H"

OK

ERROR

AT^SCAMS="DEV_REMOVE",<index>

AT^SCAMS="DEV_REMOVE",4

Formát odpovědi – akce se zdařila:

OK

Formát odpovědi – akce se nezdařila:

ERROR

AT^SCAMS="DEV_CLEAR"

 Příkaz pro modul AMS – odstranění všech zařízení z tabulky zařízení.

Formát odpovědi – akce se zdařila:

OK

Formát odpovědi – akce se nezdařila:

ERROR

AT^SCAMS="DEV_INTERVAL",<index>,<interval>

Příkaz pro modul AMS – změna časového intervalu odečtu dat pro zařízení přítomné v tabulce zařízení.

• <index> – index zařízení (v tabulce zařízení), pro které se má změnit časový údaj
  • numerický formát (číslo) nebo symbolické jméno (textový řetězec)
    • pro číslo: index zařízení (v tabulce zařízení), pro které se má změnit časový údaj
    • pro textový řetězec: "ALL" – časový údaj se má změnit pro všechna zařízení uvedená v tabulce zařízení
• <interval> – textový řetězec symbolu časového intervalu (počet minut nebo hodin nebo dnů), možné hodnoty jsou:
  • "1M", "2M", "3M", "4M", "5M", "6M", "10M", "12M", "15M", "20M", "30M", "1H", "2H", "3H", "4H", "6H", "8H", "12H", "1D"

Příklad (pro zařízení s indexem 3 v tabulce zařízení změní časový interval odečtu na 1 hodinu): 

AT^SCAMS="DEV_INTERVAL",3,"1H"

Příklad (pro všechna zařízení uvedená v tabulce zařízení změní časový interval odečtu na 30 minut): 

AT^SCAMS="DEV_INTERVAL","ALL","30M"

Formát odpovědi – akce se zdařila:

OK

Formát odpovědi – akce se nezdařila:

ERROR

AT^SCAMS="DIRECT_READ",<port>,<protokol>,<adresa>,{<extra_parametr1>[<extra_parametr2>]}

Příkaz pro modul AMS – provede okamžitý odečet dat ze zařízení a poté provede výpis těchto dat.

• <port> – číslo fyzického portu, na které je dané zařízení připojeno – číslo
  • 1 – komunikační port RS232
    
  • 2 – komunikační port RS232/RS485/MBUS (konkrétní varianta dle HW provedení)
  • 128 – komunikační port pro komunikaci s interním modulem A/D vstupů (modul analogových/digitálních vstupů)
• <protokol> – jméno nebo číslo komunikačního protokolu, pomocí něhož se se zařízením komunikuje
  • pro číslo:
    
    • 1 – označuje protokol IEC 62056-21
    • 2 – označuje protokol M-BUS
    • 3 – označuje protokol MODBUS
      
    • 64 – označuje protokol pro komunikaci se zařízeními INMAT 51 a INMAT 66
    • 65 – označuje protokol pro komunikaci se zařízením LOTOS 301
    • 128 – označuje protokol pro čtení A/D vstupů (protokol pro čtení dat z modulu analogových/digitálních vstupů)
  • pro textový řetězec:
    • "IEC62056-21" – označuje protokol IEC 62056-21
    • "MBUS" – označuje protokol M-BUS
    • "MODBUS" – označuje protokol MODBUS
    • "INMAT" – označuje protokol pro komunikaci se zařízeními INMAT 51 a INMAT 66
    • "LOTOS" – označuje protokol pro komunikaci se zařízením LOTOS 301
    • "AIN_DIN" – označuje protokol A/D vstupů (protokol pro čtení dat z modulu analogových/digitálních vstupů)
• <adresa> – adresa zařízení – textový řetězec adresy zařízení
  • pro protokol IEC 62056-21 –  adresa tvořena textovým řetězcem  <adresa> [@ <default_baudrate>][% <switches>], kde:
    • <adresa> – je adresa zařízení (shodné jako původní adresa zařízení)
    • < default_baudrate > – je nepovinný parametr, číslo udávající výchozí rychlost komunikace v Baudech.
    • <switches> – je nepovinný parametr, pole přepínačů pro řízení procesu čtení dat, nyní je implementován pouze přepínač 'R' pro zamezení změny počáteční rychlosti komunikace.
  • pro protokol M-BUS – adresa tvořena textovým řetězcem ve formátu "<adresa>[@<rychlost>]"
    • <adresa> – adresa M-BUS zařízení (měřiče)
      
      • primární adresa – <adresa> je číslo v rozsahu 0 až 250 
      • sekundární adresa – <adresa> má formát *<adresa_8>, kde <adresa_8> je 8 znaků sekundární adresy zařízení, kde každý znak je:
        • číslice v rozsahu 0 až 9
        • znak 'F' pro wildcard (zástupný znak pro jakoukoliv numerickou hodnotu na dané pozici v rozsahu 0 až 9)
    • <rychlost> – komunikační rychlost, číslo udávající baudovou komunikační rychlost, není-li parametr uveden, bude použita výchozí rychlost možné hodnoty jsou 300, 600, 1200, 2400, 4800, 9600, 19200, 38400. Výchozí rychlost: 2400.
  • pro protokol MODBUS adresa tvořena textovým řetězcem <adresa> @ <default_baudrate> [<max_cmd_data_size>, <data_block_1>,...., <data_block_N>], kde:

• • • <adresa> – je adresa MODBUS zařízení 8-bit (povinný parametr) 
      
    • < default_baudrate > – je povinný parametr, číslo udávající výchozí rychlost komunikace v Baudech. Default = 9600
    • <max_cmd_data_size> – je nepovinný parametr, maximální velikost bloku dat, kterou může cílové zařízení najednou poskytnout. Default = 1.
    • <data_block_x> – je nepovinný parametr, skládá se z následujících částí <cmd>:<mem_addr>:<data_cnt> přičemž:
  • • • <cmd> – MODBUS command, 8-bit HEX
      • <mem_addr> – adresa v paměti cílového MODBUS zařízení, 16-bit HEX
      • <data_cnt> – objem dat, která mají být vyčtena z cílového MODBUS zařízení. Data začínají na <mem_addr>, 16-bit DEC

• 
  
  • pro protokol INMAT 51/66 adresa tvořena textovým řetězcem ve formátu "<adresa>[@<rychlost>]|<prikaz_1>,<prikaz_2>,....,<prikaz_N>
    • • <adresa> – adresa zařízení – číslo v rozsahu (0 až 63) 
        
      • <rychlost> – komunikační rychlost, číslo udávající baudovou komunikační rychlost. Není-li parametr uveden, bude použita výchozí rychlost: 9600
      • <prikaz_x> – textový řetězec ve formátu "<kod_prikazu>[:<parametr_1>[:<parametr_2>[:....[:<parametr_K>]]]]", který specifikuje jeden příkaz.
        • <kod_prikazu> – písmeno abecedy, které specifikuje konkrétní příkaz protokolu INMAT 51/66. Přiřazení písmen jednotlivým příkazům je následující:
          • • 'I' – čtení identifikace přístroje
            • 'S' – čtení jedné hodnoty
            • 'E' – čtení jedné hodnoty z matice hodnot
            • 'B' – čtení bloku hodnot z matice hodnot
            • 'M' – čtení paměti
        • <parametr_x> – textový řetězec jednoho parametru příkazu. Počet parametrů příkazu závisí na konkrétním příkazu. Počty a formáty parametrů pro jednotlivé příkazy jsou následující:
          • • příkaz 'I' (čtení identifikace přístroje): počet parametrů je nula (parametry nejsou potřeba)
            • příkaz 'S' (čtení jedné hodnoty): počet parametrů je 2
              
              • <parametr_1> – písmeno abecedy, které specifikuje typ žádané proměnné, přiřazení písmen jednotlivým typům je následující:
                • • 'I' – typ "INT", délka 2 byty
                  • 'L' – typ "LONG", délka 4 byty
                  • 'F' – typ "FLOAT", číslo s pohyblivou desetinnou čárkou (podle normy IEEE), délka 4 byty
                  • 'S' – typ "STRING", posloupnost ASCII znaků ukončených nulovým znakem, délka 1 až 246 bytů
              • <parametr_2> – index databázové proměnné v rámci stanice (INX). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FF
            • příkaz 'E' (čtení jedné hodnoty z matice hodnot): počet parametrů je 4
              • <parametr_1> – písmeno abecedy, které specifikuje typ žádané proměnné, přiřazení písmen jednotlivým typům je následující:
                
                • 'I' – typ "INT", délka 2 byty
                • 'L' – typ "LONG", délka 4 byty
                • 'F' – typ "FLOAT", číslo s pohyblivou desetinnou čárkou (podle normy IEEE), délka 4 byty
                • 'S' – typ "STRING", posloupnost ASCII znaků ukončených nulovým znakem, délka 1 až 246 bytů
              • <parametr_2> – index databázové proměnné v rámci stanice (INX). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FF
              • <parametr_3> – index řádku databázové proměnné typu matice (IY). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
              • <parametr_4> – index sloupce databázové proměnné typu matice (IX). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
            • příkaz 'B' (čtení bloku hodnot z matice hodnot): počet parametrů je 6
              
              • <parametr_1> – písmeno abecedy, které specifikuje typ žádané proměnné, přiřazení písmen jednotlivým typům je následující:
                
                • 'I' – typ "INT", délka 2 byty
                • 'L' – typ "LONG", délka 4 byty
                • 'F' – typ "FLOAT", číslo s pohyblivou desetinnou čárkou (podle normy IEEE), délka 4 byty
                • 'S' – typ "STRING", posloupnost ASCII znaků ukončených nulovým znakem, délka 1 až 246 bytů
              • <parametr_2> – index databázové proměnné v rámci stanice (INX). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FF
              • <parametr_3> – index řádku databázové proměnné typu matice (IY). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
              • <parametr_4> – index sloupce databázové proměnné typu matice (IX). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
              • <parametr_5> – index řádku databázové proměnné typu matice (NY). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
              • <parametr_6> – index sloupce databázové proměnné typu matice (NX). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
            • příkaz 'M' (čtení paměti): počet parametrů je 6
              
              • <parametr_1> – "offset", určuje posun v rámci daného segmentu (OFFS). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
              • <parametr_2> – "segment", určuje oblast paměťového prostoru (SEG). Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až FFFF
              • <parametr_3> – počet čtených bytů. Číslo v hexadecimálním tvaru (16-bit ASCII HEX), rozsah 0 až F5
  • pro protokol LOTOS 301 je adresa tvořena prázdným textovým řetězcem (tedy "")
  • pro protokol A/D vstupů – adresa tvořena textovým řetězcem ve formátu "<vstup>/<parametr>[/<varianta>]"
    
    • <vstup> – číslo vstupu, pro který se má provést odečet dat, hodnoty: 
      • 1 – vstup 1
      • 2 – vstup 2
      • 3 – vstup 3
    • <parametr> – textový řetězec se specifikací typu parametru, jehož data se mají odečíst, možné tvary:
      • ADC – měření analogového signálu na analogovém vstupu
      • DIN – čtení logické hodnoty na analogovém vstupu, rozsah hodnot výsledku je 0 až 1
      • PULSE – čtení čítače pulzů digitálního vstupu
    • <varianta> – textový řetězec se specifikací varianty parametru, možné tvary:
      • pro ADC:
        • CAL – výsledkem odečtu dat je kalibrovaná hodnota, rozsah hodnot výsledku je 0 až 100
        • ABS – výsledkem odečtu dat je hodnota získaná přímo z A/D převodníku, rozsah hodnot výsledku je 0 až 1023
      • pro DIN – pro tento parametr <varianta> není definována, a proto se neuvádí
      • pro PULSE:
        • ABS – výsledkem odečtu dat je aktuální počet pulzů načítaný v čítači pulzů vstupu, rozsah hodnot výsledku je 0 až (2^64 – 1)
        • REL – výsledkem odečtu dat je počet pulzů načítaný od posledního odečtu dat (nebo vymazání/nastavení stavu čítače pulzů), rozsah hodnot výsledku je 0 až (2^64 – 1)
• < extra_parametr1 > – nepovinný parametr, pro protokol
  
  • specifikuje hodnotu výchozí (default) baudové komunikační rychlosti protokolu
  • IEC 62056-21: číslo udávající požadovanou výchozí (default) baudovou rychlost protokolu; není-li parametr uveden, použije se standardní hodnota
  • M-BUS – nemá význam (ignorováno)
  • MODBUS – nemá význam (ignorováno)
  • INMAT 51/66 – nemá význam (ignorováno)
  • LOTOS 301 – nemá význam (ignorováno)
  • A/D vstupů – nemá význam (ignorováno)
• < extra_parametr2 > – nepovinný parametr, pro protokol
  • specifikuje, zda má protokol odmítnout, nebo přijmout nabídku vyšší komunikační rychlosti pro "Režim protokolu C"
  • IEC 62056-21: logická hodnota (není-li parametr uveden, použije se hodnota 0)
    • 0 – pro "Režim protokolu C" – protokol přijme nabídku vyšší komunikační rychlosti od zařízení
    • 1 – pro "Režim protokolu C" – protokol odmítne nabídku vyšší komunikační rychlosti od zařízení a komunikace bude pokračovat na výchozí rychlosti
  • M-BUS – nemá význam (ignorováno)
    
  • MODBUS – nemá význam (ignorováno)
  • INMAT 51/66 – nemá význam (ignorováno)
  • LOTOS 301 – nemá význam (ignorováno)
  • A/D vstupů – nemá význam (ignorováno)

Formát odpovědi:

^SCAMS: <chybovy_kod>,<identifikace_zarizeni>,<data>
OK

• <chybovy_kod> – kód chyby vrácený jako výsledek procesu vyčtení dat ze zařízení (hodnota 0 znamená výsledek bez chyby) – číslo
  • 32-bitové neznaménkové číslo v dekadickém formátu
• <identifikace_zarizeni> – textový řetězec vrácený zařízením jako jeho identifikace – textový řetězec
• <data> – surová data vyčtená ze zařízení – textový řetězec

— Příklady okamžitých odečtů — 

Příklad (provede okamžitý odečet a výpis odečtených data pro zařízení připojené na fyzický port číslo 2, komunikujícího pomocí protokolu IEC 62056-21, s adresou zařízení 947833):

AT^SCAMS="DIRECT_READ",2,1,"947833"

Příklad (stejné jako předchozí, ale použije komunikační rychlost 1200 Bd jako výchozí komunikační rychlost):

AT^SCAMS="DIRECT_READ",2,"IEC62056-21","947833",1200

Příklad (stejné jako předchozí, ale odmítne nabídku vyšší komunikační rychlosti od zařízení v případě "Režimu protokolu C"): 

AT^SCAMS="DIRECT_READ",2,1,"947833",1200,1

Příklad (provede okamžitý odečet a výpis odečtených dat pro zařízení připojené na port číslo 2, komunikujícího pomocí protokolu M-BUS, s primární adresou zařízení 128 a komunikační rychlostí 2400 Bd):

AT^SCAMS="DIRECT_READ",2,"MBUS","128@2400"

Příklad (stejné jako předchozí, ale komunikační rychlost není uvedena a bude tudíž použita výchozí rychlost 2400 Bd):

AT^SCAMS="DIRECT_READ",2,"MBUS","128"

Příklad (stejné jako předchozí, ale protokol je zadán v numerickém formátu):

AT^SCAMS="DIRECT_READ",2,2,"128"

Příklad (provede okamžitý odečet a výpis odečtených dat pro zařízení připojené na port číslo 2, komunikujícího pomocí protokolu M-BUS, se sekundární adresou zařízení 01579411 a komunikační rychlostí 2400 Bd):

AT^SCAMS="DIRECT_READ",2,"MBUS","*01579411@2400"

Příklad (provede okamžitý odečet a výpis odečtených dat pro zařízení připojené na port číslo 2, komunikujícího pomocí protokolu M-BUS, se sekundární adresou zařízení se dvěma wildcard pozicemi 015794FF a komunikační rychlostí 2400 Bd): 

AT^SCAMS="DIRECT_READ",2,"MBUS","*015794FF@2400"

Příklad (přes port A/D vstupů provede okamžitý odměr signálu pro analogový vstup 1, provede kalibraci výsledku a výsledek vypíše):

AT^SCAMS="DIRECT_READ",128,"AIN_DIN","1/ADC/CAL"

Příklad (přes port A/D vstupů provede okamžitý odměr signálu pro analogový vstup 2, výsledek převede na logickou interpretaci úrovně signálu a výsledek vypíše):

AT^SCAMS="DIRECT_READ",128,"AIN_DIN","2/DIN"

Příklad (přes port A/D vstupů vyčte okamžitou hodnotu čítače pulzů na digitálním vstupu 1 a výsledek vypíše):

AT^SCAMS="DIRECT_READ",128,"AIN_DIN","1/PULSE/ABS"

— Konec příkladů okamžitých odečtů — 

Automatické vyhledání měřičů

Příkaz pro automatické vyhledání zařízení na sběrnici.

AT^SCAMSADD=,<port>,<protokol>,<baudrate>,<interval>,<number_of_expected_devices>

Příkaz provede detekci zařízení na sběrnici, zapíše do tabulky zařízení AMS, zároveň vymaže data v datovém prostoru a vypíše výsledek s adresami detekovaných metrů.

• <port> – číslo fyzického portu, na které je dané zařízení připojeno – číslo
  • 1 – komunikační port RS232
    
  • 2 – komunikační port RS232/RS485/MBUS (konkrétní varianta dle HW provedení)
• <protokol> – jméno nebo číslo komunikačního protokolu, pomocí něhož se se zařízením komunikuje
  • pro číslo:
    
    • 2 – označuje protokol M-BUS
  pro textový řetězec:
  
  • • "MBUS" – označuje protokol M-BUS
• <baudrate> – komunikační rychlost, číslo udávající baudovou komunikační rychlost, není-li parametr uveden, bude použita výchozí rychlost

  • možné hodnoty jsou 300, 600, 1200, 2400. Výchozí rychlost (default): 2400.

• <interval> – textový řetězec symbolu časového intervalu (počet minut nebo hodin nebo dnů), možné hodnoty jsou:
  • "1M", "2M", "3M", "4M", "5M", "6M", "10M", "12M", "15M", "20M", "30M", "1H", "2H", "3H", "4H", "6H", "8H", "12H", "1D"
• <number_of_expected_devices> – počet očekávaných zařízení –  číslo udávající počet nově přidaných zařízení.
  • jedná se o počet zařízení, která jsou očekávána na sběrnici. Bude-li jejich počet naplněn, ukončí se automatická detekce. 
    

Formát odpovědi:

^SCAMSADD:<error_code>,<number_of_devices>,"<primary_address1>;<secondary_address1>;<primary_address2>;<secondary_address2>;....................."
OK

Příklady příkazů (detekce 3 metrů na MBUSu, na rychlosti 2400 Bd a intervalem vyčítání v AMS 2 hodiny) – stejný příkaz zapsaný různými způsoby:

AT^SCAMSADD=2,2,"default","2h",3

AT^SCAMSADD=2,2,"2400","2h",3

AT^SCAMSADD=2,mbus,"default","2h",3

AT^SCAMSADD=2,mbus,"2400","2h",3

Příklady odpovědi:

Bez chyby (detekce 3 metrů): 

^SCAMSADD: 0,3,"1,00660421;19,08780251;1,09801004"
OK

S chybou (detekován jiný počet metrů, než bylo uvedeno, zde 2 metry): 

^SCAMSADD: 65286,2,"1,00660421;19,08780251"
OK

S chybou (kolize sekundárních adres MBUS slave zařízení): 

^SCAMSADD: 131094,0,""
OK

Čtení záznamů typu AMS

AT rozhraní pro čtení uložených datových záznamů (typu AMS).

AT^SCDATA=?

^SCDATA: "MESS_CNT"
^SCDATA: "GET_SPACE"
^SCDATA: "GET_OLDEST"
^SCDATA: "GET_FILTERED","0-150"
^SCDATA: "DEL_OLDEST"
^SCDATA: "DEL_ALL"
OK

AT^SCDATA="MESS_CNT"

Příkaz pro modul čtení uložených datových záznamů vrátí počet uložených datových záznamů.

Formát odpovědi:

^SCDATA: "MESS_CNT",<pocet>
OK

Příklad odpovědi (paměť datových záznamů obsahuje 44 záznamů):

^SCDATA: "MESS_CNT",44
OK

AT^SCDATA="GET_SPACE"

Příkaz pro modul čtení uložených datových záznamů vrátí velikost dostupné paměti pro ukládání datových záznamů (v bytech).

Formát odpovědi:

^SCDATA: "GET_SPACE",<pocet>
OK

Příklad odpovědi (volná dostupná paměť je 7008089 B):

^SCDATA: "GET_SPACE",7008089
OK

AT^SCDATA="GET_OLDEST",<pocet>

Příkaz pro modul čtení uložených datových záznamů vrátí výpis nejstarších datových záznamů.

• <počet> – specifikuje počet nejstarších záznamů, pro který se má vrátit výpis – číslo

Formát odpovědi pro známý formát dat a význam jednotlivých parametrů v řádku:

AT^SCDATA: <typ_zaznamu>,<casova_znacka>,<sekvencni_cislo>,<protocol>,<index>,<chybovy_kod>,<identifikace_zarizeni>,<data>
OK

^SCDATA: "WMBUS",1452142010,36617,-14,70,"44A2057714005401377277140054A2050137E70000002F2F046D052707210167
60DFD11106563616B696E756D6F6B656C65544E320E138545030000002F2F2F2F2F2F2F2F2F"
OK

Formát odpovědi pro neznámý formát dat:

AT^SCDATA: <typ_zaznamu>,<casova_znacka>,<sekvencni_cislo>,"Unsupported record format"
OK

Filtrování záznamů typu AMS

AT^SCDATA="GET_FILTERED",<filtr>

AT^SCDATA: <typ_zaznamu>,<casova_znacka>,<sekvencni_cislo>,<protocol>,<index>,<chybovy_kod>,<identifikace_zarizeni>,<data>
OK

AT^SCDATA: <typ_zaznamu>,<casova_znacka>,<sekvencni_cislo>,"Unsupported record format"
OK

<parametr> je textový řetězec označující parametr podmínky. Podporované řetězce jsou:

• RECORD_TYPE – typ datového záznamu
• TIME – časová značka datového záznamu
• TABLE_ID – index zařízení v tabulce zařízení
• ERROR_CODE – chybový kód datového záznamu

<relace> je textový řetězec určující požadovanou relaci mezi parametrem podmínky a hodnotou podmínky. Podporované řetězce jsou:

AT^SCDATA="GET_FILTERED","RECORD_TYPE==WMBUS"

AT^SCDATA="GET_FILTERED","RECORD_TYPE==AMS;TIME>=1388665085;TIME<=1388668685"

AT^SCDATA="GET_FILTERED","RECORD_TYPE==AMS;TIME>1388665085;TABLE_ID==1"

AT^SCDATA="GET_FILTERED","ERROR_CODE!=0"

AT^SCDATA="GET_FILTERED","ERROR_CODE==0;RECORD_TYPE==AMS;TIME>1388668685"

AT^SCDATA="DEL_OLDEST",<pocet>

AT^SCDATA="DEL_OLDEST",5

OK

ERROR

AT^SCDATA="DEL_ALL"

OK

ERROR