Differences

This shows you the differences between two versions of the page.

--- ezeio2:scriptref:start [2020-11-12 22:53] – johpar
+++ ezeio2:scriptref:start [2024-03-01 17:24] (current) – andreh
@@ Line 1: / Line 1: @@
 ===== Script reference =====
-{{indexmenu_n>900}}
+{{indexmenu_n>1000}}
 === ezeio script programming - the PAWN language ===
@@ Line 12: / Line 12: @@
 We strongly recommend reading the following documents to get introduced to the PAWN language:
-[[https://github.com/compuphase/pawn/raw/master/doc/Pawn_Getting_Started.pdf|Introduction to PAWN]]
+[[https://doc.eze.io/_media/ezeio2/pawn_getting_started.pdf|Introduction to PAWN]]
-[[https://github.com/compuphase/pawn/raw/master/doc/Pawn_Language_Guide.pdf|PAWN language guide]]
+[[https://doc.eze.io/_media/ezeio2/pawn_language_guide.pdf|PAWN language guide]]
@@ Line 44: / Line 44: @@
 | ''@Key'' | Called when a button is pressed on a connected terminal device |
 | ''@Scan'' | Called when a code is received from a scanner device |
+=== Some examples ===
+The program below will print out "Hello" on the debug console.
+<code javascript>
+main()
+{
+    PDebug("Hello");
+}
+</code>
+The following example adds the values of field 1 and field 2 together, and writes the result to field 3.
+<code javascript>
+// This example adds the value of field 1 and 2 and writes the sum to field 3
+// The value of field 3 is updated every 500ms (twice per second)
+main()
+{
+    SetTickInterval(500);       // Make sure the @Tick function is called twice per second
+}
+@Tick(uptime)
+{
+    new f1, f2;             // declare local variables
+    f1 = GetField(1);       // set f1 to the value of field 1
+    f2 = GetField(2);       // set f2 to the value of field 2
+    SetField(3, f1+f2);     // set the value of field 3 with the sum of f1 and f2
+}
+</code>
+The example below illustrates the use of a global variable, the use of the main() function to initialize the values, and the @Tick(uptime) call. The program will use field number 1, and count from 100 down to 50, and then starting over.
+<code javascript>
+// A simple demo program, counting down from 100 to 50, and then starts over
+new myCounter;                  // Declare a 'global' variable
+main()                          // The main() function will run on startup, once
+{
+    SetTickInterval(1000);      // Make sure the @Tick function is called once every 1000ms (1s)
+    myCounter = 100;            // Initialize the counter with value 100
+}
+@Tick(uptime)                   // The @Tick function will be called once per second
+{
+    myCounter = myCounter - 1;  // Count down the counter with 1
+    if(myCounter <= 50) {       // If we reached 50 (or lower)
+        myCounter = 100         // ..then set it back to 100
+    }
+    SetField(1, myCounter);     // Update field 1 with the counter value
+}
+</code>
+The example below will run a 3-speed fan based on the input from a temperature sensor on field 1.
+Output 1 is used for low speed, output 2 is medium speed, and output 3 is high speed.
+The speed is selected based on how much the temperature exceeds a given setpoint (here set to 20.5 degrees C)
+<code javascript>
+main()
+{
+    SetTickInterval(5000);  // Update every 5s (5000ms)
+}
+@Tick(uptime)
+{
+    new Float:temp, Float:diff; // Declare "float" variables to handle fractions
+    temp = GetFieldFloat(1);    // Fetch the current temperature from Field 1
+    diff = temp - 20.5;         // 20.5 is our setpoint. diff is the differece
+    if(diff > 0.0)              // Over setpoint?
+        SetOutput(1, 100);      // ..yes, so enable low speed
+    else
+        SetOutput(1, 0);        // ..no, so shut off
+    if(diff > 2.0)              // 2 degrees or more over setpoint?
+        SetOutput(2, 100);      //..yes, so enable mid-speed
+    else
+        SetOutput(2, 0);
+    if(diff > 6.0)              // 6 degrees or more over setpoint?
+        SetOutput(3, 100);      //..yes, so run full speed
+    else
+        SetOutput(3, 0);
+}
+</code>
 === State machines ===