Mercurial Mercurial > beremiz / file revision
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
doc/svghmi/configuration.rst
author Edouard Tisserant <edouard@beremiz.fr>
Thu, 05 Dec 2024 13:56:59 +0100
changeset 4060 d2f5eb3c7d6e
parent 3936 129202e555e0
permissions -rw-r--r--
py_ext: fix CSV Writer

fix POU logic :
- SAVE is a BOOL
- invocation of py_eval on rising edge of SAVE
- remove save python argument

fix python:
- use no encoding for file open (python2)
- re-use detected dialect if any
- use no "rt+" and truncate since no need to re-sniff dialect for output file
- return "OK" instead of "#SUCCESS", preventing POU logic to ACK result
- support creating new line if writing just after last line
- support appending data on short rows

fix example:
- use a HMI:Button to trigger CSV write instead of HMI:Input +1
- reload CSVs on on each new CSV opened in file browser
- add display of CSV write output 
SVGHMI instances configuration
==============================

.. list-table::

    * - Multiple SVGHMI instances can be configured simultaneously in the same Beremiz  :doc:`../programming/configuration`, exposing different HMIs.

        .. image:: svghmi_multi.png

      - .. figure:: svghmi_configuration.png

        SVGHMI configuration panel

Ports, interfaces, path and MaxConnections
------------------------------------------

    Each SVGHMI instance must bind to different interface-port-path triplet. In case of conflict, a build error is issued.

    By default, interface is set to ``localhost``, port to ``8008`` and path is set to :doc:`../programming/configuration` Node's name: ``{name}``.
    As an example, in case SVGHMI instance is first node in :doc:`../programming/configuration`, default URL to reach HMI is ``http://localhost:8008/svghmi_0``

    Up to ``MaxConnections`` clients (i.e. web browser) can connect to the same SVGHMI instance simultaneously.
    This number has an influence on memory footprint of generated code.
    In case of repeated connection loss with long TCP `TTL <https://en.wikipedia.org/wiki/Time_to_live>`_, small ``MaxConnections`` number can lead to connection refusal.



About Security
^^^^^^^^^^^^^^

 ..
    TODO :


Watchdog
--------

    Purpose of SVGHMI watchdog is to detect if HMI is still functioning and connected to PLC.
    ``/HEARTBEAT`` variable is periodically updated by PLC and HMI to detect failure.
    
    When SVHGMI server doesn't receive HMI heartbeat in due time, watchdog is triggered, and ``OnWatchdog`` command is executed. 
    For example, ``OnWatchdog`` can be used to restart a new web browser in case it did crash.

    Only one single client can use watchdog at a time, and ``Watchdog`` configuration setting can be active on only one SVGHMI instance at a time.

    ``WatchdogInitial`` and ``WatchdogInterval`` define how long watchdog will accept to wait before receiving first heartbeat,
    and then how long it will wait in between heartbeats once first heartbeat has been received.


Starting and stopping browser
-----------------------------

    ``OnStart`` and ``OnStop`` configuration settings are commands meant control web browser execution when PLC is started or stopped.
    PID of commands are monitored, and the end of web browser process is awaited after command. 
    If web browser process isn't finished 3s after calling ``OnStop`` command, warning is logged.
beremiz