Customer Portal
Customer Portal
Breadcrumbs

Vytvořit konfiguraci

Vytvořit konfigurace

Chcete-li vytvořit novou konfiguraci, postupujte takto:

  1. Přihlaste se do Zákaznického portálu.

  2. Přepněte se do sekce Produkty → Collector Mobile Client → Konfigurace.

  3. Klikněte na Vytvořit konfiguraci. cp11_CZ.png

  4. Zadejte jméno pro konfiguraci a vložte její specifikaci.

  5. Klikněte na Vytvořit konfiguraci.

Po vytvoření organizace naleznete v sekci Konfigurace vzorový konfigurační soubor, který můžete použít jako referenci při vytváření vlastních konfigurací.

Definice konfigurace

Konfigurační soubory jsou založeny na formátu INI a obsahují sekce s dvojicemi klíč-hodnota.

  • Komentáře přidávejte pomocí znaku #.
    Mezery na konci řádků se ignorují.
    Názvy sekcí musí být psány vždy velkými písmeny.
    Názvy klíčů musí být psány vždy malými písmeny.
    Logické (boolean) hodnoty mohou mít pro hodnotu TRUE také varianty 1, Y, a YES.

Konfigurace CMC má čtyři sekce, které jsou podrobně popsány níže.

Sekce GLOBAL

Tato sekce obsahuje nastavení a parametry, které platí pro celou aplikaci.

Konkrétní obsah sekce závisí na požadavcích a funkčnosti aplikace.

Sekce může obsahovat informace o cestách ke složkám s daty, toleranci synchronizace času, obecné parametry akcí, licenční klíč, komunikační nastavení REST, a podobně.

Klíč

Hodnota

synctime_high_threshold

Určuje práh rozdílu času v sekundách, po jehož překročení se ukončí synchronizace a akce končí chybou.

Číslo musí být kladné nebo 0 (nula).

Příklad: 600

synctime_low_threshold

Určuje práh rozdílu času v sekundách, před jehož dosažením není zahájena synchronizace a čas se považuje jako synchronizovaný.

Číslo musí být kladné nebo 0 (nula).

Příklad: 5

force_set_time_default

Určuje, zda je ve výchozím nastavení povolena možnost vynucené synchronizace času, při které jsou ignorovány prahové hodnoty synchronizace a čas je nastaven.

Příklad: Y

Výchozí hodnota: N

registry_default

Obsahuje výchozí seznam odečítaných registrů, oddělený čárkami.

G pro generické registry

H pro fakturační registry

Příklad: G,H

profile_default

Obsahuje výchozí seznam čísel profilů, oddělený čárkami, které jsou předvybrané v aplikaci při manuálním vytváření nových pracovních příkazů.

Čísla musí být 1 nebo 2.

Příklad: 1,2

profile_length

Obsahuje výchozí počet dní zpětně od aktuálního času, které budou vyčteny.

Tento počet dní se použije v nových pracovních příkazech pro Čtení profilů a Čtení záznamníku událostí.

Example: 40

meter_password_preshared_key_enabled

Obsahuje informaci, zda se má pro dešifrování zašifrovaných hesel použít pre-shared klíč.

Pro aktivaci klíče zadejte jednu z těchto hodnot: yes, y, true, nebo 1.

meter_password_preshared_key

Obsahuje název souboru s pre-shared klíčem.

Soubor se při startu aplikace nachází ve složce Cert.

cache_validity_days

Určuje dobu platnosti ve dnech, po kterou budou data uložena v paměti ovladače (asociační objekty).

Hodnota musí být 1 a více.

Příklad: 360

voltage_warn_min

Určuje minimální platnou úroveň napětí ve voltech pro akci Test měřiče. Pro oddělení desetinných míst použijte . (tečku).

Hodnota se porovnává s aktuální úrovní napětí.

Příklad: 208.0

voltage_warn_max

Určuje maximální platnou úroveň napětí ve voltech pro akci Test měřiče. Pro oddělení desetinných míst použijte . (tečku).

Hodnota se porovnává s aktuální úrovní napětí.

Příklad: 253.0

current_max_zero

Určuje maximální absolutní hodnotu v ampérech považovanou za 0 (nulu) pro akci Test měřiče. Pro oddělení desetinných míst použijte . (tečku).

Hodnota se porovnává s aktuální úrovní proudu.

Příklad: 0.5

cms_connect_string

Obsahuje adresu, ke které se aplikace může připojit pro automatickou synchronizaci dat.

Řetězec může mít předponu  ://, http://, nebo https://.

Příklad: https://api-test.company.com/cms/v1

cms_certificate

Obsahuje jméno souboru s příponou .pfx (bez cesty) ve složce Cert s autorizačním klientským certifikátem.

Certifikát se použije, pokud adresa v connect_string vyžaduje ověření klientským certifikátem.

Soubor je lokalizován při spuštění aplikace a poté uložen do bezpečného úložiště zařízení. Po načtení aplikace se soubor smaže.

cms_certificate_password

Obsahuje šifrované heslo pro načítání certifikátu z cms_certificate.

cms_certificate_source

Obsahuje umístění autorizačního certifikátu pro připojení ke Collector Mobile Serveru.

Hodnota může být nastavena na:

  • android - systém zobrazí upozornění, že certifikát byl vydán Androidem

  • documents/<folder> - certifikát se načítá ze specifikované podsložky ve složce documents.

Hodnota, kterou uživatel vybere, se uloží a aplikace bude používat tento certifikát po celou dobu jeho platnosti.

Pokud je hodnota android, aplikace bude ignorovat nastavení v položkách cms_certifate a cms_certificate_password.

cms_enables

Obsahuje informaci, zda data budou synchronizována se Zákaznickým portálem cybros labs nebo jiným systémem CMS.

Výchozí hodnota: true

wo_cleanup_time

Určuje minimální počet hodin, po které jsou po synchronizaci pracovní příkazy uchovávány v zařízení, než se smažou.

hide_action_mtr_check_disconnector

Obsahuje informaci, zda se má v uživatelském rozhraní aplikace zobrazit tlačítko pro testování odpojovačů.

Pro schování tlačítka zadejte jednu z hodnot yes, y, true, nebo 1.

check_sound_period

Určuje interval zvukového signálu (v milisekundách) v akci Kontrola zapojení a test měřiče.

Výchozí hodnota: 5000

Sekce AUTH

Tato sekce obsahuje seznam jednotlivých uživatelů včetně hesel, povolených akcí a skupin oprávnění.

Výchozí uživatel, který se použije pro přihlášení do aplikace Collector Mobile Client, má následující formát:

0=n<username>|p<password>|l<userPermissionLevel>

Pro přidání dalších uživatelů použijte stejný formát.

Hodnota <userPermissionLevel> musí být kladné číslo a má následující parametry:

  • p<userPermissionLevel> – Seznam předdefinovaných akcí oddělených čárkou (viz níže)

  • r<userPermissionLevel> – Určuje, zda uživatel může spravovat pracovní příkazy (read-only).

  • a<userPermissionLevel> – Seznam přístupu s mapováním akcí na úroveň přístupu. Hodnoty mají formát: action@L<accesslevels>. Úrovně přístupu (accesslevels) se liší podle druhu měřiče. Detaily naleznete v Sekce: <DRIVER_NAME> níže.

Dostupné akce jsou:

  • MRT_CHECK – Test měřiče

  • UPDATE_PASSWORD – Aktualizace heslo

  • MDM_INIT – Inicializace modulu

  • TOU_LOAD – Nahrávání TOU

  • DISPLAY_CFG – Zobrazení konfigurace

  • LMTR_SET – Nastavení limiteru

  • LP_RDT – Čtení profilů

  • DLP_RDT – Čtení denních profilů

  • EVL_RDT – Čtení záznamníku událostí

  • BATT_RESET – Reset časovače stáří baterie

  • BILLING_RESET – Nulování fakturačních hodnot

  • ALARM_RST – Reset příznaku otevřené svorkovnice

  • SYNC_TIME – Synchronizace hodin

  • BV_RDT – Čtení fakturačních hodnot

  • RELAY_SET – Ruční nastavení relé

Příklad:

0=nAdmin|pSecretPass|l1
1=nTechnician|pTechPass|l2
p1=BV_RDT,LP_RDT,EVL_RDT
a1=MRT_CHECK@L2,EVL_RDT@L1,TOU_LOAD@L2,BV_RDT@L1,LP_RDT@L1
r1=n
p2=BV_RDT
a2=MRT_CHECK@L1,BV_RDT@L1
r2=y

Sekce <DRIVER_NAME>

Tato sekce obsahuje nastavení a parametry pro jednotlivé druhy ovladačů.

Některá nastavení jsou shodná pro všechny druhy ovladačů, některá jsou specifická pouze pro určitý druh ovladačů.

Tato specifická nastavení jsou v tabulce uvozena názvem typu ovladače.

Obecná nastavení ovladačů

Klíč

Hodnota

password_l<level>

Obsahuje hodnoty hesel.

<level> určuje úroveň, ke které se heslo vztahuje.

Můžete nastavit více hesel a použít je v různých kombinacích pro různé operace.

Příklad:

password_l1=00000000 

password_l2=1234567 

password_lg=123456678 

password_l<level>_encoding

Určuje typ kódování hodnot z password_l<level>.

Možnosti kódování jsou:

Plain

  • Hesla jsou v běžně čitelném formátu. Tento parametr můžete vynechat.

  • Příklad:
    password_l1=1234567
    password_encoding=plain

Hex

  • Hesla jsou hexadecimální řetězce.

  • Příklad:
    password_l1=31323334335363738
    password_encoding=hex

aes/gcm/noppading

  • Hesla jsou dešifrována pomocí pre-shared klíče s využitím AES-GCM-256, 12-byte IV, 256-bit HMAC.

  • Hodnoty musí mít kódování base-64 a musí obsahovat šifrovaná binární data.

  • Příklad:
    password_l1=nDTlhGrR74AYXln8gWB79dvl8F58DKOLyvj7fPsUeKE3XXTJssylUwdQVH4=
    password_encoding=aes/gcm/noppading

aes/cbc/pkcs5padding

  • Hesla jsou dešifrována pomocí pre-shared klíče s využitím AES-CBC-128, 4-byte IV, 128-bit TAG.

  • Hodnoty musí mít kódování base-64 a musí obsahovat šifrovaná binární data.

  • Příklad:
    password_l1=nDTlhGrR74AYXln8gWB79dvl8F58DKOLyvj7fPsUeKE3XXTJssylUwdQVH4=
    password_encoding=aes/cbc/pkcs5padding

accesslevels

Určuje úroveň přístupu ovladače pro konkrétního uživatele.

Příklad:

accesslevels=L1=2;L2=2

reglist_generic

Obsahuje seznam DLMS definic, oddělených středníkem, které se mají číst.

reglist_historical

Obsahuje seznam DLMS definic, oddělených středníkem, které se mají číst, pokud jsou vyžádány Fakturační registry.

ACE_SL7000

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: lowest

ADDGRUP_NP7X

Key

Value

profile_timeout

Určuje maximální dobu v sekundách, po kterou aplikace čeká na profilová data.

Výchozí hodnota: 30

limit_profile_days

Určuje maximální počet dní, které je možné číst před dnešním dnem.

Výchozí hodnota: 60

LGZ_E350

Key

Value

w1_password

Obsahuje heslo pro příkaz W1.

LGZ_E360

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: lowest

relay_<relay_id>_<action_name>_script

Obsahuje klíče pro nastavení akcí relé.

Hodnoty jsou reprezentovány čísly skriptů podle parametrů měřičů.

Příklad:

relay_1_connect_script=5

relay_2_disconnect=4

modem_phase1_command

Obsahuje příkaz modem phase-1, který používá akce MDM_INIT.

Výchozí hodnota: +CMEE=1

modem_phase1_response

Obsahuje platnou odpověď na příkaz modem phase-1.

Výchozí hodnota: OK

modem_phase1_delay

Obsahuje hodnotu zpoždění příkazu modem phase-1 v milisekundách.

Výchozí hodnota: 100

modem_phase2_command

Obsahuje příkaz modem phase-2, který používá akce MDM_INIT.

Výchozí hodnota: +COPS=0

modem_phase2_response

Obsahuje platnou odpověď na příkaz modem phase-2.

Výchozí hodnota: OK

modem_phase2_delay

Obsahuje hodnotu zpoždění příkazu modem phase-2 v milisekundách.

Výchozí hodnota: 100

LGZ_E450

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: lowest

relay_<relay_id>_<action_name>_script

Obsahuje klíče pro nastavení akcí relé.

Hodnoty jsou reprezentovány čísly skriptů podle parametrů měřičů.

Příklad:

relay_1_connect_script=5

relay_2_disconnect=4

LGZ_E550

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: lowest

LGZ_E570

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: lowest

LG_E650

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: lowest

inputs_relay<relay_id>_on

Obsahuje vstupní hodnotu, která přepíná relé s uvedeným <relay_id> do stavu ZAP (dle parametrů meřiče).

Příklady:

inputs_relay1_on=10******

inputs_relay2_on=**10****

inputs_relay<relay_id>_off

Obsahuje vstupní hodnotu, která přepíná relé s uvedeným <relay_id> do stavu VYP (dle parametrů meřiče).

Příklady:

inputs_relay1_off=01******

inputs_relay2_off=**01****

inputs_relay<relay_id>_ext1

Obsahuje vstupní hodnotu, která přepíná relé s uvedeným <relay_id> do stavu určeného externím výstupem ext-1 (dle parametrů meřiče).

Příklady:

inputs_relay1_ext1=00******

inputs_relay2_ext1=**00****

profile_backoff_minutes

Určuje počet minut před nastaveným časem (time-from).

Toto je způsobeno vadným firmwarem, který někdy nevrací požadovaná data, pokud se začne číst přímo v čase from.

Výchozí hodnota: 30

LGZ_E850

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: lowest

profile_backoff_minutes

Určuje počet minut před nastaveným časem (time-from).

Toto je způsobeno vadným firmwarem, který někdy nevrací požadovaná data, pokud se začne číst přímo v čase from.

Výchozí hodnota: 30

use_mode_e

Určuje, zda je jako výchozí protokol IEC mode-E. Pokud je možnost zakázaná, použije se protokol DLMS.

AEM_ENERLUX

Key

Value

w1_password

Obsahuje heslo pro příkaz W1.

profile_timeout

Určuje maximální dobu v sekundách, po kterou aplikace čeká na profilová data.

Výchozí hodnota: 30

limit_profile_days

Určuje maximální počet dní, které je možné číst před dnešním dnem.

Výchozí hodnota: 60

IEC61107

Key

Value



clock_time_format

Určuje formát parsování času v C#.



clock_date_format

Určuje formát parsování data v C#.



serial_obis

Obsahuje seznam OBIS kódů, oddělených středníky, které jsou kontrolovány v určeném pořadí, zda obsahují sériové číslo měřiče.

Znak + (plus) spojuje dva OBIS kódy.

Výchozí hodnota: C.1.0+C.1.1;0.0;0.0.0



clock_time_register

Obsahuje OBIS kód registru, který obsahuje aktuální hodnotu času.

Výchozí hodnota: 0.9.1



clock_date_register

Obsahuje OBIS kód registru, který obsahuje aktuální hodnotu datumu.

Výchozí hodnota: 0.9.2



dc3_ignore_time_in_profile_request

Určuje, zda se v požadavku na profilová data používá časová složka.

Ve výchozím nastavení ovladače čtou měřiče typu DC3 a DB3 každý den (v čase mezi 00:00 a 00:00 následujícího dne). V případě chybného firmwaru se mohou vrátit chybná data, pokud je čas from a to nenulový.

Chcete-lil toto chování vypnout, nastavte hodnotu na yes, y, true, nebo 1.

Výchozí hodnota: false



r6_blocksize

Určuje délku požadavku pro příkaz R6. Vysoké hodnoty mohou vést k vyšší míře selhání čtení, nízké hodnoty mohou vést k pomalému čtení.

Výchozí hodnota: 100



w5_password

Obsahuje heslo pro příkaz W5.



EMH_LZQJ

Key

Value

w1_password

Obsahuje heslo pro příkaz W1.

w5_password

Obsahuje heslo pro příkaz W5.

ZPA_AMX75

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: low

ZPA_ZEX16

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: low

obis_dlp

Obsahuje OBIS kód denního profilu v měřiči.

Kód musí mít úplný formát, například A-B:C.D.E.F.

Pokud kód není definován, ovladač se pokusí načíst profil s hodnotou 86400.

Výchozí hodnota: N/A

METERCONTROL_ST402D

Key

Value

relay_<relay_id>_<action_name>_script

Obsahuje klíče pro nastavení akcí relé.

Hodnoty jsou čísla OBIS kódů podle parametrů měřičů.

Příklady:

relay_1_connect_script=0-0.10.0.103.255|3

relay_1_disconnect_script=0-0.10.0.103.255|4

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: low

use_mode_e

Určuje, zda je jako výchozí protokol IEC mode-E. Pokud je možnost zakázaná, použije se protokol DLMS.

METCOM_MCS301

Key

Value

security_mechanism_l<level>

Určuje bezpečnostní mechanismus DLMS, který se použije pro autentizaci.

Možné hodnoty:

lowest

low

high

high-md5

high-sha1

high-gmac

high-sha256

Výchozí hodnota: low

password_l<level>_ak

Obsahuje autentizační klíč v případě, že hodnota bezpečnostního mechanismus security_mechanism_l je nastavena na high-gmac.

password_l<level>_ek

Obsahuje šifrovací klíč v případě, že hodnota bezpečnostního mechanismus security_mechanism_l je nastavena na high-gmac.

relay_reset

Obsahuje objekt ve formátu JSON, kde kllíče představují OBIS kódy a hodnoty obsahují nastavované parametry.

Z bezpečnostních důvodů jsou povoleny pouze OBIS kódy související s konfigurací relé. Jiné kódy jsou ignorovány.

Příklad:

{"0-0:130.2.17.255": [1,0],"0-1:130.2.17.255": [1,0],"0-2:130.2.17.255": [3,0],"0-3:130.2.17.255": [0,0],"0-4:130.2.17.255": [0,0],"0-5:130.2.17.255": [0,0],"0-6:130.2.17.255": [2,0],"0-7:130.2.17.255": [2,0],"0-0:130.3.0.255": 0,"0-1:130.3.0.255": 0,"0-2:130.3.0.255": 0,"0-3:130.3.0.255": 0,"0-4:130.3.0.255": 0,"0-5:130.3.0.255": 0,"0-6:130.3.0.255": 0,"0-7:130.3.0.255": 0,"1-0:129.3.2.255": 0,"1-0:129.3.3.255": 0,"1-0:129.3.4.255": 0,"1-0:129.3.5.255": 16,"1-0:129.3.6.255": 1,"1-0:129.3.7.255": 2}

Section PASSWORD_SECTION_x

Obsahuje výchozí hesla, která aplikace CMC použije, pokud je volána přes API.

Jména sekcí mají format format PASSWORD_SECTION_x, kde x je alfanumerický řetězec znaků.

Tato sekce se použije, pokud hodnota klíče meter_password_section v API volání se rovná hodnotě x.