====== Příklady ======

===== Modbus TCP klient pomocí CloudAccess =====

{{:en:mervis-scada:70-generator:modbus_excel.png?direct&800|}}

  * Je potřeba vytvořit správně naformátovaný soubor s mapováním.
    * Stáhnout příklad: {{ :en:mervis-scada:70-generator:ca_modbus.xlsx |}}
    * **Důležité**
      * Používejte unikátní GUID.
        * Online generátor: https://guidgenerator.com/online-guid-generator.aspx
      * Když rozšiřujete tento příklad o Driver a DriverChannelParameters, nepoužívejte veřejnou IP adresu pro komunikaci. Místo toho použijte službu [[cs:mervis-cloudaccess:|CloudAccess]].
  * Přejděte na https://generator.mervis.info, vyberte mapovací soubor a vložte parametry (nebo vyberte .txt soubor).
    * **Důležité**
      * Pro nový projekt použijte unikátní GUID.
      * Použijte správné informace k Mervis DB:
        * Funkční URL databáze
        * Uživatelské jméno a heslo
        * Unikátní klíč „Root“ pro každý projekt

==== Modbus ====

=== Podporované datové typy ===

| Bit        |
| UInt8      |
| SInt8      |
| UInt16     |
| SInt16     |
| UInt32     |
| SInt32     |
| Float32    |
| Float64    |
| SInt48     |
| UInt48     |
| SInt64     |
| UInt64     |

=== Podporované Modbus funkce ===

^ Funkce               ^ Kód ^
| ReadCoils            | 1   |
| ReadDiscreteInputs   | 2   |
| ReadHoldingRegister  | 3   |
| ReadInputRegister    | 4   |

^ Funkce                  ^ Kód ^
| WriteSingleCoil         | 5   |
| WriteMultipleCoils      | 15  |
| WriteSingleRegister     | 6   |
| WriteMultipleRegisters  | 16  |

==== Parametry generátoru ====

<code txt modbus-params.txt>
 --sourceType MervisDb 
 --projId ecd6fa5d-78c1-4120-9b11-23521bee7688
 --projName "AnyNameWouldDoModbus" 
 --projTimeZone "Europe/Prague" 
 --mdbConnStr "rcwaredb://uuuuuser:ppppasword@db.mervis.info:443/?protocol=https,endpoint=RcWareDbHttpsAccess,uriaccess=db/imports5/RcWareDbAccess" 
 --mdbDpNameKey {FixedName}
 --mdbSourceKeys "(Root|ahoj|true)"
 --mdbTreeLevelKeys Level1/Level2
 --outputDirectory ecd6fa5d-78c1-4120-9b11-23521bee7688
 --useDbV2
 --mdbUnitKey Unit 
 --mdbExportOnlyIdKeys 

 --dbWriteModeOn
 --dbWriteModeSamplingInterval 180
 --dbEnableWriteFromDriver
 --dbWriteModeDecimals 2
 --notSortDataPoints
 --dpVisualDecimals 2
 --mdbReadGroupUpdateInterval 10
</code>

===== Projekt MervisDB s Datapoint Transformacemi a Alarmy =====

  * Je potřeba vytvořit správně naformátovaný soubor s mapováním.
    * Stáhnout příklad: {{ :en:mervis-scada:70-generator:mervisdb_example.xlsx |}}
    * **Důležité**
      * Používejte unikátní GUID.
        * Online generátor: https://guidgenerator.com/online-guid-generator.aspx
      * Nepoužívejte veřejnou IP adresu pro komunikaci. Místo toho použijte službu [[cs:mervis-cloudaccess:|CloudAccess]].
  * Přejděte na https://generator.mervis.info, vyberte mapovací soubor a vložte parametry (nebo vyberte .txt soubor).
    * **Důležité**
      * Pro nový projekt použijte unikátní GUID.
      * Použijte správné informace k Mervis DB:
        * Funkční URL databáze
        * Uživatelské jméno a heslo
        * Unikátní klíč „Root“ pro každý projekt

==== Parametry generátoru ====

<code txt params.txt>
 --sourceType MervisDb 
 --projId e519e6ab-3971-4504-ba2a-9db81c723c1e
 --projName "ExampleMervisDb"
 --projTimeZone "Europe/Prague" 

 --mdbConnStr "rcwaredb://uuuuuser:ppppasword@db.mervis.info:443/?protocol=https,endpoint=RcWareDbHttpsAccess,uriaccess=db/imports5/RcWareDbAccess" 
 --mdbDpNameKey {FixedName}
 --mdbSourceKeys "(Root|ahoj|true)"
 --mdbTreeLevelKeys Level1/Level2
 --outputDirectory e519e6ab-3971-4504-ba2a-9db81c723c1e
 --useDbV2
 --mdbUnitKey Unit 
 --mdbExportOnlyIdKeys

 --dbWriteModeOn
 --dbEnableWriteFromDriver
 --dbWriteModeDecimals 4
 --dpVisualDecimals 3
</code>

===== SSCP klient s komunikací PLC =====

  * Je potřeba vytvořit správně naformátovaný soubor s mapováním.
    * Stáhnout příklad: {{ :en:mervis-scada:70-generator:sscp_plc_example.xlsx |}}
    * **Důležité**
      * Používejte unikátní GUID.
        * Online generátor: https://guidgenerator.com/online-guid-generator.aspx
  * Přejděte na https://generator.mervis.info, vyberte mapovací soubor a vložte parametry (nebo vyberte .txt soubor).
    * **Důležité**
      * Pro nový projekt použijte unikátní GUID.
      * Použijte správné informace k Mervis DB:
        * Funkční URL databáze
        * Uživatelské jméno a heslo
        * Unikátní klíč „Root“ pro každý projekt

==== SSCP ====

Informace týkající se definování sloupců ovladače SSCP v mapovacím souboru: [[https://kb.mervis.info/doku.php/cs:mervis-scada:70-generator:20-help?tns#sloupce_pro_sscp_driver_pouziva_se_s_driversscp|Sloupce pro SSCP driver (používá se s Driver: SSCP)]]

==== Parametry generátoru ====

<code txt sscp-params.txt>
 --sourceType MervisDb 
 --projId ed18bc18-972a-457a-bc4b-fa96f3a14fb9
 --projName "ExampleSSCP"
 --projTimeZone "Europe/Prague" 

 --mdbConnStr "rcwaredb://uuuuuser:ppppasword@db.mervis.info:443/?protocol=https,endpoint=RcWareDbHttpsAccess,uriaccess=db/imports5/RcWareDbAccess" 
 --mdbDpNameKey {FixedName}
 --mdbSourceKeys "(Root|ahoj|true)" # Je nepoužitý
 --mdbTreeLevelKeys Level1/Level2
 --outputDirectory ed18bc18-972a-457a-bc4b-fa96f3a14fb9
 --useDbV2
 --mdbUnitKey Unit 
 --mdbExportOnlyIdKeys 

 --dbWriteModeOn
 --dbEnableWriteFromDriver
 --dbWriteModeDecimals 4
 --dpVisualDecimals 3
</code>

===== Klient s komunikací PLC přes Proxy s využitím metadat =====
  * Project Generator se připojuje k PLC přes proxy. Projekt je generován pomocí metadat stažených z PLC.
  * Přejděte na https://generator.mervis.info, vložte parametry (nebo vyberte .txt soubor).
    * **Důležité**
      * Pro nový projekt použijte unikátní GUID.

==== Parametry generátoru ====

<code txt plc-params.txt>
--sourceType SharkPlc 
--projId f6f6cfdd-7b7e-4fef-94ad-1cc573c4919f 
--projName "ExamplePLC" 
--projTimeZone Europe/Prague 
--connectionType Proxy 
--proxyId iiiiiii
--host proxy.mervis.info 
--port 12349 
--ssl true 
--plcUser uuuuuuu 
--plcPassword ppppppp
--mdbDpNameKey {VariableName} 
--mdbUnitKey Unit 
--outputDirectory f6f6cfdd-7b7e-4fef-94ad-1cc573c4919f
</code>