FUXA Documentation
repository·master·Indexed 26 days ago
https://github.com/frangoteam/fuxaA web-based SCADA/HMI/Dashboard platform for industrial automation, IoT, and real-time process visualization. FUXA supports connectivity via Modbus, OPC-UA, MQTT, and Siemens S7. It can be deployed via Docker, installed from source using Node.js 18, or run as a standalone Electron desktop application. The platform features a customizable Angular frontend with support for SVG widgets, bar and pie graphs, and multiple UI themes.
What's inside FUXA
- FUXA is a web-based software platform used to rapidly build and deploy scalable SCADA, HMI, Dashboard, or IIoT systems. It allows for the creation of modern process visualizations with custom designs for real-time data display and the control of automated industrial plant instruments. The system operates on a Node.js runtime, which is accessed via a web browser to use the editor or to run visualizations as a client.
Use Editor Keyboard Shortcuts
masterThe FUXA editor supports several keyboard shortcuts to accelerate item manipulation, navigation, and view control:
Item Manipulation
- Rotate:
Ctrl + Left / Right(small step) orCtrl + Shift + Left / Right(large step). - Move:
Shift + Up / Down / Left / Right. - Duplicate:
Ctrl + D. - Cut:
Ctrl + X. - Copy / Paste:
Ctrl + C/Ctrl + V. - Group / Ungroup:
Ctrl + G. - Select All:
Ctrl + A. - Lock Dimensions:
Shift + [mouse resize](hold Shift while resizing with the mouse to lock width or height). - Line Gradients:
Shift + [Draw line](applies horizontal, vertical, or 45° diagonal gradients).
Selection & Navigation
- Next / Previous Item:
Shift + O / PorTab / Shift + Tab.
View & History
- Zoom:
Ctrl + Up / Down(central zoom in/out) orShift + [SCROLLER](zoom relative to mouse position). - Undo / Redo:
Ctrl + Z/Ctrl + Y.
- Rotate:
Use FUXA Contrib Nodes in Node-RED
masterThefuxa-contribpackage provides specialized nodes for SCADA integration. Note: This package is designed to work exclusively with the FUXA Node-RED Integration and will not function in a standalone Node-RED installation.Configure General Layout Settings
masterAccess the Layout settings within the FUXA editor to configure the global behavior of the user interface. In the General tab, you can manage the following settings:
- Start View: Defines the initial view (home) displayed when a user navigates to the application URL (e.g.,
http://localhost:1881). - Zoom: When enabled, allows users to zoom the view using the Mouse Scroll Wheel and pan the view using the Mouse Left Button.
- Dialog Mode of input field: When enabled, input value controls will trigger a dialog box for value entry.
- Show Navigation: Toggles the visibility of the Header bar and the navigation Menu.
- Hide the development button: Hides the button used to switch between 'Edit' and 'Home' modes.
- Start View: Defines the initial view (home) displayed when a user navigates to the application URL (e.g.,
Understand the FUXA User Interface views
masterFUXA provides two distinct views for managing your projects:
- FUXA-editor: The environment used to design and edit your SCADA, HMI, or Dashboard projects.
- FUXA-view: The client-side view used to display and run the resulting visualization products.
Trigger scripts via Events in the GUI
masterOnce a script is defined, you can execute it by configuring it within the Events section of the FUXA GUI. This allows you to link specific system or user events to the execution of your custom JavaScript logic.Configure UI Layout and Alarms
masterFUXA allows for advanced UI customization and monitoring:
- UI Layout: Configure how elements are positioned and organized within the interface.
- Alarms: Define thresholds for data values to trigger automated alarms and notifications.
Bind a Slider Control to a Device Tag
masterTo control a device value using a slider, bind a Slider control to a Device Tag (Variable). In the FUXA editor, select your View and configure the Slider control to be linked to the specific Device Tag.Build a standalone Electron application
masterTo create your own Electron application from the source, you must have Node.js 18 installed. Follow these steps in order:
1. Build Server and Client:
cd ./server npm install cd ../client npm install npm run build2. Package the Application:
cd ./app npm install npm run packageThe resulting standalone Electron application will be located in the
./appdirectory.cd ./server npm install cd ../client npm install npm run build cd ../app npm install npm run packageOpen a project from a JSON file
masterYou can restore or load a project by importing an exported JSON file (e.g.,MyProject.json) using the project opening feature.Configure the Header Navigation Bar
masterIn the Layout settings editor, use the Header Navigation Bar tab to manage the top navigation bar. This includes defining how and if Alarm notification items are displayed, as well as configuring different style attributes for the header.Create a new project
masterTo start a new project, use the project creation feature. Note that creating a new project will overwrite the current project with a void project containing only a voidMainView.