Hoe kunnen we helpen?

Print

CommandHMI: C-scripts importeren, exporteren, compileren en uitvoeren

Overzicht

Een C-script draait pas op de HMI als het succesvol is gecompileerd en er een uitvoeringsmodus aan is toegewezen.

De werkwijze is altijd dezelfde:

  • de Script Editor openen
  • het script aanmaken of importeren
  • het compileren
  • het toewijzen als Global-, Init- of Trigger-script
Uitvoeringsmodus Wanneer het draait Waar in te stellen Limiet
Cyclisch (Global Script) Continu, met een ingestelde frequentie, optioneel gestuurd door een bit Setting > Global Script 64 scripts, uitgevoerd in lijstvolgorde
Cyclisch (Timer-object) Met een ingestelde frequentie, altijd of zolang een bit ON is Timer-object op een scherm geplaatst 0,1 s tot 60 s
Init Script Eenmalig, bij het opstarten van de HMI, onafhankelijk van de schermen Setting > Init Script 64 scripts, uitgevoerd in lijstvolgorde
Trigger Script Wanneer een bit van toestand verandert, of een scherm wordt geopend/gesloten Setting > Trigger Script —

 

Elk nieuw script begint met dit sjabloon. Behoud de spelling MarcoInit precies zoals weergegeven: het is de macronaam die in het headerbestand van de editor is gedefinieerd.

#include "MacroInit.h"
//#include "subFun1.c" //Example: sub script
void Macro_main(IN *p)
{
	MarcoInit
	//ToDo
}

Stap 1 – De Script Editor openen

Open uw project in CommandHMI en open vervolgens de Script Editor

Het editorvenster heeft 3 hoofdgebieden:

  • Scriptlijst (links) – scripts gesorteerd op status:
    • Success (succesvol gecompileerd)
    • Fail (compileerfouten)
    • Not compiled (niet gecompileerd)
    • Not saved (niet opgeslagen).
  • Script-bewerkingsvenster – de C-broncode
  • Instellings- en uitvoervenster (onderaan) – het tabblad Variable Setting en het tabblad Compile information output.

 

Stap 2 – Een script aanmaken, plakken of importeren

Een nieuw script aanmaken of een ander script plakken

  1. Klik op het pictogram New en geef een naam op: het nieuwe script verschijnt in de lijst unsave
  2. Plak of schrijf de code in het bewerkingsvenster.
  3. Dubbelklik in het tabblad Variable Setting (of rechtsklik > New Variable) om de variabelen te declareren die aan HMI-adressen zijn gekoppeld: naam, gegevenstype, lezen/schrijven, adres. Variabelen die hier zijn gedeclareerd, of uit een adresbibliotheek komen, hoeven niet opnieuw in de code te worden gedeclareerd. Interne scriptvariabelen worden zoals gebruikelijk in de code gedeclareerd.
  4. Klik op Save.

Een bestaand script importeren

  1. Klik op het pictogram Import/Open
  2. Selecteer het scriptbestand dat eerder uit een ander project is geëxporteerd (zie stap 3).
  3. Controleer de code en het tabblad Variable Setting: de adressen moeten overeenkomen met het huidige project.
  4. Als het script subscripts aanroept met #include "subXxx.c", zorg er dan voor dat die subscripts ook in het project aanwezig zijn.

Stap 3 – Een script exporteren

Exporteer een script om het in een ander project te hergebruiken of als back-up te bewaren.

  1. Selecteer het script in de scriptlijst
  2. Rechtsklik Export script
  3. Kies de map en bevestig met OK. Het script wordt opgeslagen als *.csv-bestand.

Dit is het bestand dat u later selecteert met Import.

Stap 4 – Het script compileren

  1. Selecteer het script en klik op Compile in de werkbalk van het bewerkingsvenster. De editor slaat het script in één stap op, compileert, linkt en controleert het.
  2. Lees het tabblad Compile information output:
    • “0 errors! Compile successfully” – het script gaat naar de lijst Success en kan nu een uitvoeringsmodus krijgen.
    • Fouten weergegeven – het script gaat naar de lijst Fail. Corrigeer de gemelde regels en compileer opnieuw.

Alleen scripts in de lijst Success verschijnen in de dialoogvensters Global, Init en Trigger script.

 

Stap 5 – Het script uitvoeren

Kies per toepassing één uitvoeringsmodus: Init, Cyclisch, Timer, Trigger… Een script dat gecompileerd maar niet toegewezen is, wordt nooit uitgevoerd.

5.1 Cyclische uitvoering – Global Script

Gebruik dit voor logica die altijd moet draaien, ongeacht het weergegeven scherm (50 ms of meer).

  1. Open Setting > Global Script.
  2. Selecteer het gecompileerde script in de lijst.
  3. Stel de uitvoeringsfrequentie in.
  4. Optioneel: schakel bitsturing in en voer een bitadres in (bijv. LB100). Het script draait dan alleen zolang deze bit ON is.
  5. Klik op OK. Er kunnen tot 64 globale scripts worden toegevoegd; ze worden uitgevoerd in de volgorde van de lijst.

5.2 Cyclische uitvoering – Timer-object (alternatief)

Gebruik dit wanneer het script alleen moet draaien zolang een bepaald scherm geopend is.

  1. Plaats een Timer-object op het scherm (het is tijdens runtime niet zichtbaar).
  2. Execution mode: Always Execute, of Address Triggered (draait zolang de bit ON is).
  3. Frequency: 0,1 s tot 60 s.
  4. Execution Times: 0 = onbeperkt, anders het aantal uitvoeringen.
  5. Function type: Macro, selecteer daarna de Name van het script.

5.3 Eenmalig uitvoeren bij opstarten – Init Script

Gebruik dit om waarden te initialiseren wanneer de HMI wordt ingeschakeld.

  1. Open Setting > Init Script.
  2. Selecteer het gecompileerde script in de lijst.
  3. Klik op OK. Het script draait eenmalig bij het opstarten, onafhankelijk van de schermen. Tot 64 init-scripts, uitgevoerd in lijstvolgorde.

5.4 Uitvoeren bij een gebeurtenis – Trigger Script

  1. Open Setting > Trigger Script en klik op New.
  2. Selecteer het gecompileerde script.
  3. Kies het triggertype:
    • Address trigger – voer een bitadres en een modus in: OFF→ON, ON→OFF, OFF↔ON (elke wijziging), of Immediate execute when ON.
    • Screen trigger – selecteer een scherm en een modus: Open Screen of Close Screen.
  4. Klik op OK. Gebruik Alter of Delete om de triggerlijst te beheren.

Downloaden naar de HMI

Compileer het hele project met Download > Compile, test het daarna met Off-line Simulation of verstuur het met Download > USB/Ethernet download.

 

Tips en veelgemaakte fouten

  • Behoud de spelling MarcoInit in elk script. MacroInit veroorzaakt een compileerfout.
  • Houd cyclische scripts kort. Geen blokkerende lussen of lange DELAY()-aanroepen: die vertragen de HMI.
  • Reset bij een door een bit getriggerd script de triggerbit in het script als het opnieuw moet afgaan.
  • Bits LB50000–LB51999 en woorden LW50000–LW51999 behouden hun waarde na een stroomonderbreking. Gebruik ze voor tellers of instellingen die een herstart moeten overleven.
  • Compileer het script na een import opnieuw: een geïmporteerd script staat pas in de lijst Success als het in het nieuwe project is gecompileerd.