Differences

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

--- code:dqmh:hse-application-template:overview [2019/09/13 09:18] – joerg.hampel
+++ code:dqmh:hse-application-template:overview [2024/07/17 10:31] (current) – ↷ Links adapted because of a move operation manuel.sebald
@@ Line 1: / Line 1: @@
-====== 10 Overview ======
+====== 01 Overview ======
-This application template serves as the basis for HSE Windows LabVIEW applications. The template helps us with
+This application template showcases our //UI framework// for applications with graphical user interfaces. We use this template as a container which **loads the project-specific DQMH modules dynamically** from a configuration file.
-  * loading DQMH modules dynamically (from a list of names)
+{{:code:dqmh:hse-application-template:pasted:20210305-110517.png}}
-  * a fancy splash screen
+===== UI Framework =====
-  * a reusable User Interface module
-  * dynamically populated Runtime Menu
-  * an event log
+The //UI framework// helps us with:
-===== Modules =====
+  * reusing UI management code
+  * project-specific UI layouts
+  * displaying a fancy splash screen
+  * populating the Runtime Menu dynamically
+  * populating a navigation module dynamically
+  * generating an event log for debugging
-  * [[code:dqmh:hse-application-template:event-manager|Event Manager]]
+...and much more!
-  * [[code:dqmh:hse-application-template:ui-manager|UI Manager]]
-  * Navigation
-  * Header
+The //UI framework// is built on top of the [[code:open-source:hse-libraries|HSE Libraries]] and consists of a collection of DQMH modules and a few helper VIs.
-===== Startup VI =====
+==== Framework Modules ====
-  * Loads a list of modules
+These DQMH modules are designed to be reused, hence they are generic and not part of the project-specific code of an application:
-    * defined on block diagram
-	* no static linkage
-  * configures the ''User Interface.vi'' module
-	* show dynamically loaded modules in Run-Time Menu
-	* register for broadcast events of dynamically loaded modules
-  * displays the front panel of the ''User Interface.vi'' module as primary application GUI
+  * [[code:open-source:hse-framework:event-manager|Event Manager]]
+  * [[code:open-source:hse-framework:ui-manager|UI Manager]]
+  * [[code:open-source:hse-framework:navigation|Navigation]]
+==== Framework VIs ====
+In order to dynamically load DQMH modules and to achieve some of the //UI framework// functionality, the following VIs are part of the framework, too:
+=== Startup VI ===
+The ''/startup.vi'' is used to run the application. It...
+  * shows a splash screen
+  * reads the main configuration (containing the list of modules to load)
+  * loads the UI Manager and the Event Manager modules
+  * loads a list of project modules (no static linkage)
+  * calls the "configure" requests of all the modules
+  * displays the front panel of the ''UI Manager'' module
+=== Project VIs ===
+These are project-related or project-specific VIs that are supplied by the //UI Framework// but can or have to be modified for each project.
+  * ''/Project/Project.lvlib'': Contains the project-specific VIs
+  * ''/Project/PROJECT_InitLogging.vi'': Starts the hse-logger
+  * ''/Project/PROJECT_Name--constant.vi'': Name of the project
+  * ''/Project/PROJECT_RunTimeMenu.rtm'': Run-Time Menu for the application
+  * ''/Project/PROJECT_SplashScreen.vi'': Splash Screen
+  * ''/Project/PROJECT_StartupSteps.ctl'': List of steps for the startup.vi to execute
+  * ''/Project/PROJECT_UserCredentials.vi'': List of users for the built-in login feature
+===== Project-Specific DQMH Modules =====
+In order for DQMH modules to be compatible with our application template, these modules need to implement our [[kb:labview-frameworks:dqmh:hse-flavour|HSE DQMH flavour]].