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



===== Modbus TCP Client pomocí CloudAccess =====

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


  * Je nutné vytvořit správně naformátovaný mapovací soubor
    * Stáhnout příklad: {{ :en:mervis-scada:70-generator:ca_modbus.xlsx |}}
    * **Důležité**
      * Použijte unikátní GUIDy
        * Online generátor: https://guidgenerator.com/online-guid-generator.aspx
      * Pro komunikaci NEPOUŽÍVEJTE veřejnou IP adresu. Použijte [[cs:mervis-proxy:cloudaccess|CloudAccess]]
  * Přejděte na https://generator.mervis.info, vyberte mapovací soubor a vložte parametry (nebo vyberte soubor .txt)
    * **Důležité**
      * Pro nový projekt použijte unikátní GUID
      * Použijte správné údaje Mervis DB
        * Funkční URL DB
        * Uživatelské jméno, 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é funkce Modbus ===


^ 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 transformacemi datových bodů a alarmy =====

  * Je nutné vytvořit správně naformátovaný mapovací soubor
    * Stáhnout příklad: {{ :en:mervis-scada:70-generator:mervisdb_example.xlsx |}}
    * **Důležité**
      * Použijte unikátní GUIDy
        * Online generátor: https://guidgenerator.com/online-guid-generator.aspx
      * Pokud tento příklad rozšíříte o Driver a DriverChannelParameters, NEPOUŽÍVEJTE pro komunikaci veřejnou IP adresu. Použijte [[cs:mervis-proxy:cloudaccess|CloudAccess]]
  * Přejděte na https://generator.mervis.info, vyberte mapovací soubor a vložte parametry (nebo vyberte soubor .txt)
    * **Důležité**
      * Pro nový projekt použijte unikátní GUID
      * Použijte správné údaje Mervis DB
        * Funkční URL DB
        * Uživatelské jméno, 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 Client s komunikací s PLC =====

  * Je nutné vytvořit správně naformátovaný mapovací soubor
    * Stáhnout příklad: {{ :en:mervis-scada:70-generator:sscp_plc_example.xlsx |}}
    * **Důležité**
      * Použijte unikátní GUIDy
        * 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 soubor .txt)
    * **Důležité**
      * Pro nový projekt použijte unikátní GUID
      * Použijte správné údaje Mervis DB
        * Funkční URL DB
        * Uživatelské jméno, heslo
        * Unikátní klíč „Root“ pro každý projekt

==== SSCP ====

Informace týkající se definice sloupců SSCP Driver v mapovacím souboru: [[https://kb.mervis.info/doku.php/cs:mervis-scada:70-generator:20-help?tns#sscp_driver_columns_used_with_driversscp|Sloupce SSCP Driver (používané 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)" # is ignored
 --mdbTreeLevelKeys Level1/Level2
 --outputDirectory ed18bc18-972a-457a-bc4b-fa96f3a14fb9
 --useDbV2
 --mdbUnitKey Unit 
 --mdbExportOnlyIdKeys 

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

===== Client připojující se k PLC přes Proxy pomocí metadat =====
  * Generátor projektu se připojuje k PLC prostřednictvím proxy. Projekt je generován pomocí metadat stažených z PLC.
  * Přejděte na https://generator.mervis.info a zadejte parametry (nebo vyberte soubor .txt).
    * **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>




===== Amit WebSocket – integrace =====
  * Kromě použití DB-net prostřednictvím služby Mervis [[cs:mervis-proxy:db-net|Amit Proxy]] nyní Amit nabízí také nativní podporu technologie [[cs:mervis-proxy:cloudaccess#amit|Mervis CloudAccess]] a vlastního protokolu **WebSocket** přímo v nejnovějších řídicích jednotkách.
  * **Projekt Mervis SCADA** se generuje výhradně pomocí mapovacího souboru Excel ''XLSX'', který musí obsahovat všechna potřebná data pro vytvoření všech datových bodů.
  * **Mapovací soubor** můžete vygenerovat pomocí pomocné aplikace ''AmitWebSocketUtil.exe'' přímo z projektu nahraného do PLC
    * Příklad mapovacího souboru ke stažení: [[https://drive.google.com/open?id=1090Oc1m3f8P97I7t-ls9uPD-w7iagSHc&usp=drive_fs|mapping-amit.xlsx]]

  * **Postup**
    * Nakonfigurujte komunikaci s CloudAccess serverem v PLC: [[cs:mervis-proxy:cloudaccess#amit|DetStudio – konfigurace CloudAccess]]
    * Vygenerujte soubor CSV podle níže uvedeného příkladu a uložte jej jako XLSX
      * Soubor můžete případně upravit podle svých potřeb
    * Přejděte na https://generator.mervis.info, zadejte parametry (nebo vyberte soubor .txt) a nahrajte mapovací soubor XLSX

==== AmitWebSocketUtil ====
  * Ke stažení: [[https://drive.google.com/open?id=1090Oc1m3f8P97I7t-ls9uPD-w7iagSHc&usp=drive_fs|AmitWebSocketUtil.exe a mapping-amit.xlsx]]

<code bat run.bat>
.\AmitWebSocketUtil.exe ^
--host cloudaccess.mervis.info ^
--port 23000 ^
--use-cloud-access true ^
--ca-channel iiiii^
--ca-user uuuuu ^
--ca-password ppppp ^
--output-file amit_websocket_variables.csv ^
--hash-string AmitWSTest ^
--comm-params "{\"host\": \"cloudaccess.mervis.info\", \"port\": 80, \"useCloudAccess\": \"true\", \"cloudAccess\": {\"host\": \"cloudaccess.mervis.info\",   \"port\": 23000,   \"ssl\": \"true\",   \"channelId\": \"iiiii\",   \"user\": \"uuuuu\",   \"password\": \"ppppp\"}"
</code>

==== Parametry generátoru ====
  * Použijte náhodně vygenerované ID projektu (generátor: https://guidgenerator.com/online-guid-generator.aspx)
  * Zadejte platný ChannelID, uživatelské jméno a heslo pro připojení ke službě CloudAccess
  * Zadejte správné uživatelské jméno a heslo pro Mervis DB

<code txt plc-params-amit.txt>
 --sourceType MervisDb 
 --projId f481fd8d-fb10-443f-9747-62458e42aaa 
 --projName "amit-ws-test" 
 --projTimeZone "Europe/Prague" 
 --mdbConnStr "rcwaredb://amit_ws_example:amit_password@db.mervis.info:443/?protocol=https,endpoint=RcWareDbHttpsAccess,uriaccess=db/imports4/RcWareDbAccess" 
 --mdbDpNameKey {FixedName}
 --mdbSourceKeys "(Foo|bar|false)"
 --mdbTreeLevelKeys {FixedLevel1}
 
 --mdbExportOnlyIdKeys 
 --outputDirectory f481fd8d-fb10-443f-9747-62458e424aaa
 --useDbV2
 --mdbCommErrorIntervalMultiple 2000
 --dbWriteModeOn
 --dbWriteModeSamplingInterval 180
 --dbWriteModeDecimals 2
</code>