PlcTool

PlcTool je samostatný nástroj příkazové řádky, který umožňuje vykonávat většinu funkcí dostupných v prostředí Mervis IDE.

Hlavní výhodou PlcTool oproti IDE je možnost automatizace pomocí skriptů nebo externích programů. Je ideální pro hromadnou správu řídicích jednotek (PLC).

Stáhněte si odpovídající verzi podle vašeho operačního systému a architektury:

• Windows (x64): Stáhnout pro Windows x64
• Linux (x64): Stáhnout pro Linux x64
• Linux (ARM): Stáhnout pro Linux ARM
• Linux (ARM64): Stáhnout pro Linux ARM64

PlcTool umožňuje následující operace s PLC s nainstalovaným Mervis RT:

• Scan: Vyhledání PLC v síti.
• Info: Získání informací o stavu PLC.
• Upload: Nahrání zkompilovaného projektu (RT image) a HMI (webového rozhraní).
• Update: Aktualizace Mervis RT.
• License: Aktivace nebo kontrola licence.
• Configuration: Stažení nebo nahrání konfigurace RT (ve formátu XML).
• Control: Restartování běhu aplikace.

Nástroj je dodáván jako archiv, který je potřeba rozbalit.

• Požadavky: Windows x64. Pokud se objeví problémy, ujistěte se, že máte aktuální verzi .NET Framework.
• Spuštění:
  1. Stiskněte `Win + R`, napište `cmd.exe` a potvrďte.
  2. Přejděte do složky s rozbaleným nástrojem.
  3. Spusťte příkaz pro zobrazení nápovědy:

.\PlcTool.exe --help

• Podporované architektury: x64, ARM, ARM64 (AArch64).
• Postup:
  1. Přeneste nástroj na PLC (např. pomocí SCP nebo WinSCP).
  2. Umožněte spouštění souboru: `chmod +x PlcTool`.
  3. Závislosti: Nainstalujte potřebné balíčky:

sudo apt install icu-devtools libssl-dev libssl1.1

1. Proměnné prostředí: V případě potřeby exportujte následující proměnné:

export DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 
export DOTNET_BUNDLE_EXTRACT_BASE_DIR=/tmp/

• Spuštění:

./PlcTool --help

Poznámka: Většina příkazů (kromě `scan`) podporuje mDNS názvy, proxy adresy nebo doménová jména namísto IP adres.

• Lokální sken: Bez parametrů prohledá loopback rozhraní.

./PlcTool scan

• Sken konkrétní sítě: Pomocí parametru `-ia` (adresa rozhraní).
  • Pozn.: Na Linuxu nelze použít síťovou nebo broadcast adresu – použijte např. `192.168.2.1`

./PlcTool scan -ia 192.168.2.1

Ověří dostupnost PLC, verzi RT a stav licence.

./PlcTool wait -h <adresa_PLC> -u admin -p rw-lok

Nahraje licenční kód do PLC. Použijte `-up`, pokud byla licence již použita.

./PlcTool license -h <adresa_PLC> -u admin -p rw -l <LICENČNÍ_KLÍČ> -up

Nahraje zkompilovaný projekt (`.exs` soubor z adresáře `bin`).

./PlcTool upload-image -h <adresa_PLC> -u admin -p rw -f <GUID_projektu>

• Volitelné přepínače:
  • `-cf` : Vymazání flash proměnných
  • `-cr` : Cold Restart

Nahraje webové rozhraní. Po nahrání je nutné PLC restartovat.

./PlcTool upload-web -h <adresa_PLC> -u admin -p rw -w <složka_webu>/
./PlcTool reboot -h <adresa_PLC> -u admin -p rw

Konfigurace je ve formátu XML. Lze ji stáhnout, upravit a nahrát zpět.

# Stažení
./PlcTool download-config -h <adresa_PLC> -u admin -p rw -f ./config.xml
 
# Nahrání
./PlcTool upload-config -h <adresa_PLC> -u admin -p rw -f ./config.xml

PlcTool je vhodný pro automatické spouštění ve skriptech. Příklad Bash skriptu, který provede scan a uloží výstup do textového souboru:

#!/bin/bash
 
# Přechod do složky se skriptem
cd "$(dirname "$0")"
 
# Nastavení proměnných prostředí
export DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 DOTNET_BUNDLE_EXTRACT_BASE_DIR=/tmp/
 
# Spuštění scan a uložení výstupu do souboru
script -q -c "./PlcTool scan -o text | tee PlcTool.txt"