Pre diagnostiku a prípadne zmenu nastavení bežiacej SGCom inštancie je možné použiť príkazy odoslané zo systémovej konzoly D2000 subsystémom Runtime intercom. Aby dostupné rozhranie pre zadávanie príkazov, je potrebné spustiť systémovú konzolu s parametrom z príkazového riadku /ARTICommands sent from the D2000 system console by the Runtime intercom subsystem can be used to diagnose and possibly change the settings of a running SGCom instance. To make the command line interface available, it is necessary to start the system console with the /ARTI command line parameter.
sysconsole.exe /ARTI
Rozhranie sa otvára z kontextovej ponuky k danému procesu
V rozhraní je nutné vybrať príkaz v tvare The interface is opened from the context menu of the given process
A command in the form JAPI::<instanceName>(HOBJ) must be selected in the interface.
Do parametra príkazu sa píše úloha, ktorú má vybraná inštancia SGCom-u vykonať. O výsledku príkazu sa cez rozhranie nedozviete. Výsledok je zapísaný jedine do LOG-u.
Príkaz SetLogLevel – zmena úrovne podrobnosti LOG-u
Umožňuje zmeniť úroveň podrobnosti zaznamenávania správ do LOG-u počas behu aplikácie, pretože zo súboru z nastaveniami sa načítajú iba raz pri štarte. Príkaz má tvar:
SETLOGLEVEL <subsystem> <level>
The task to be performed by the selected SGCom instance is written into the command parameter. You will not be informed about the result of the command through the interface. The result is recorded only in the LOG.
SetLogLevel command - change the LOG detail level
Allows you to change the level of detail of logging messages into the LOG while the application is running, since they are loaded from the settings file only once at startup. The command has the form:
SETLOGLEVEL <subsystem> <level>
The following is an example command that sets the INFO level to the Nasleduje príklad príkazu, ktorým sa nastaví úroveň INFO do subsystému sk.ipesoft.sgcom.hdlc subsystem.
SETLOGLEVEL sk.ipesoft.sgcom.hdlc INFO
...
Show
...
command – comprehensive configuration analysis
Allows you to get a clear listing of the selected part of the configuration. Currently, the listing of the configuration for a logical device by its ID is supported.
The command in the given example causes a listing for device
Umožňuje získať prehľadný výpis o zvolenej časti konfigurácii. Aktuálne je podporené zobrazenie konfigurácie pre logické zariadenie podľa jeho ID.
Príkaz v uvedenom príklade spôsobí výpis pre zariadenie 3.
SHOW CONFIG LD 3
Nahradením ID za kľúčové slovo ALL spôsobí výpis konfigurácie všetkých zariadení do súboru v adresári LOG. PríkladSubstituting ID for the keyword ALL will cause the configuration of all devices to be written to a file in the LOG directory. Example:
SHOW CONFIG LD ALL
Výpis obsahuje konfiguráciu entity LogicalDevice ako aj príslušných PhysicalDevice a Connector a hierarchicky tiež súvisiacich DataPointSet-ov a do nich zaradených DataPoint-ov, aj s ich plánovanými zbermi a odovzdávaniami.
Príkaz DUMP CONFIG - kompletný výpis obsahu konfiguračnej databázy do súboru
The listing contains the configuration of the LogicalDevice entity as well as the corresponding PhysicalDevice and Connector and the hierarchically related DataPointSets and the DataPoints included in them, including their scheduled collections and transfers.
DUMP CONFIG command - complete dump of the contents of the configuration database to a file
Allows you to get a snapshot of the database content to a file in the LOG directory. ExampleUmožňuje získať snapshot obsahu databázy do súboru v adresári LOG. Príklad:
DUMP CONFIG
...
IMMEDIATE READ ANY
...
command - immediate reading of any value from the electricity meter
The command has the formPríkaz má tvar IMMEDIATE READ ANY conversionType deviceId obis classId attributeIdattributed
- converstionType = definuje typ konverzie prečítanej hodnoty. Môže byť jeden zconversionType = defines the conversion type of the read value. It can be one of:
- bool - logická hodnotalogical value
- integer - celočíselná hodnota integer value (aj also enum)
- real - hodnota s plávajúcou čiarkoufloating point value
- text - textový reťazectext string
- raw - hodnota bez konverzie - vhodné pre štruktúrované hodnotyvalue without conversion - suitable for structured values
- CosemDateTime - textual interpretation of a value of type CosemDateTime - textová interpretácia hodnoty typu CosemDateTime
- deviceId - číselné ID logického zariadenia podľa konfigurácienumerical ID of the logical device according to the configuration
- obis - OBIS kód čítaného COSEM objektucode of the read COSEM object
- classID - číselné numerical ID COSEM triedy čítaného objektuof the COSEM class of the read object
- attributeID - číselné numerical ID COSEM atribútu čítaného objektuof the COSEM attribute of the read object
Example: reading the unique identifier of a meter that is configured as a logical device with Príklad: čítanie jednoznačného identifikátora merača, ktorý je v konfigurácii ako logické zariadenie s ID = 10.
IMMEDIATE READ ANY text 10 0.0.42.0.0.255 1 2
Príklad: čítanie stĺpcov v Example: reading columns in LoadProfile 1 (obis=1.0.99.1.0.255, classId = 7, attributeId = 3) z logického zariadenia from logical device 10
IMMEDIATE READ ANY raw 10 1.0.99.1.0.255 7 3
Príklad: čítanie aktuálneho stavu systémových hodín Example: reading the current state of the system clock (obis 0.0...0.0.255, classId = 8, attributeId = 2) z logického zariadenia from logical device 10
IMMEDIATE READ ANY CosemDateTime 10 0.0.1.0.0.255 8 2
...
IMMEDIATE READ PROFILE
...
command - immediate reading from the profile
The command has the form Príkaz má tvar IMMEDIATE READ PROFILE deviceId datapointId beginTime endTime
deviceId -
číselné ID logického zariadenia podľa konfigurácienumerical ID of the logical device according to the configuration
datapointId -
číselnénumeric ID
entity DataPoint, ktorá definuje čítaný objektof the DataPoint entity that defines the object being read
beginTime - beginning of the read interval in UTC format
beginTime - začiatok čítaného intervalu v UTC tvareyyyy-mm-ddThh:mi:ss.s1000Z (
napr.eg 2007-12-03T10:15:30.00Z)
endTime -
koniec čítaného intervalu.
Pozn. ktorá z hraníc beginTime, endTime je súčasťou čítaného intervalu závisí od implementácie konkrétneho elektromera.
the end of the read interval.
Note: which of the boundaries beginTime, endTime is part of the read interval, depends on the implementation of a particular electricity meter.
Example of reading from logical device Príklad čítania z logického zariadenia 10, datapointId -178148
IMMEDIATE READ PROFILE 31 -148 2018-08-25T00:00:00.000Z 2018-08-25T12:00:00.000Z
...
IMMEDIATE READ R1, R5,
...
R6 command - reading of specific data via the IEC21 protocol
It is a set of universal reading commands for the IEC21 protocol.
The command has the format
Je to sada univerzálnych čítacích príkazov pre protokol IEC21.
Príkaz má formát IMMEDIATE READ Rx deviceId requestText
Príklad čítania hlavičky profilu Example of reading the P.01 z logického zariadenia profile header from logical device 31
IMMEDIATE READ R6 31 P.01(;;1)
...
IMMEDIATE READ READOUT
...
command - reading of data listings via the IEC21 protocol
It is a universal read command for the IEC21 protocol, which reads the data listings of the electricity meter. These are used to access registry values and the Billing profile.
The command has the format IMMEDIATE READ READOUT deviceId
Example of reading from logical device
Je to univerzálny čítací príkaz pre protokol IEC21, ktorým sa prečítajú dátové výpisy elektromera. Tie sa používajú na prístup k hodnotám registrov a Billing profile.
Príkaz má formát IMMEDIATE READ READOUT deviceId
Príklad čítania z logického zariadenia 13
IMMEDIATE READ READOUT 13
...