Symbol and connections

Open

These blocks can be programmed to your liking. On the top side connections all inputs can be connected, on the bottom sides, all the outputs can be connected. The coding languange that is compatible with the programable controlers is Javascript. However, Hysopt evaluates the writen code in these programmable controllers every simulation step. This results that not all off the functionalities of Javascript are possible to be implemented. For instance:

• While and with statements.

• String inputs or outputs

• ….

There are 3 options:

1. Controller with 8 in/outputs

2. Controller with 16 in/outputs

3. Controller with 32 in/outputs

Writing code

Controller syntax

In these controllers, code can be written to translate certain controls.

this can include things like:

• assignment statements

• if and if-else statements

• switch statements

• comments : single line (//) and multiline (/*...*/)

• operators :

  • increment operators (++ and --)

  • unary operators (- and !) 

  • binary operators : power (^), multiply (*), modulo (%), divide (/), sum (+), min (-)

  • ternary operator (a = x ? b : x)  see https://www.freecodecamp.org/news/c-ternary-operator/

  • conditional operators (|| and &&)

  • comparison (<=', >=, >, <, ==, '!=)

  • mathematical functions :  exp, ln, sin, cos, sqrt, min(x1, x2), max(x1, x2)

Initialisation

When using a variable that has not been defined before, the controller will equal the new variable to 0. This functionality can be used for initialisation purposes with the following topology:

Open

Implemenation of an initialisation step

Built-in simulation variables

The following built-in variables can be used in the code withour prior assignment in the programmeable controller:

• time : the time variable of the simulation

• timestep: the timestep of the simulation

Example code

here is an example with code : example.txt

Note that the inspiration library is filled with written code like this, so be sure to look here for inspiration.