T3000 Webview

This repository stores the webview components used in the T3000 software. There are two primary components:

T3000 HVAC Drawer: This web-based tool allows users to create and visualize HVAC system drawings for buildings.
Modbus Register Tool: This tool enables users to add, edit, and manage Modbus register lists for Modbus devices. Additionally, it includes a Rust-based API for managing Modbus register data interaction with the SQLite database. The tool can also synchronize the local SQLite database data with the T3 User Library API, if the user enables data syncing in their settings.

Install the dependencies

yarn
# or
npm install

Start the app in development mode (hot-code reloading, error reporting, etc.)

npm run dev

Unit test

We utilize Vitest for unit testing, with all test files located within the test directory.

Tests are automatically executed by GitHub Actions upon the creation of a pull request or when new changes are pushed to the repository.

To manually run the unit tests, execute one of the following commands:

yarn test:unit
# or
npm run test:unit

Lint the files

yarn lint
# or
npm run lint

Format the files

yarn format
# or
npm run format

Build the app for production

npm run build

Customize Quasar configuration

See Configuring quasar.config.js.

T3000 Cpp integration

This repository is used as a sub-module inside the T3000_Building_Automation_System repository with the T3000 software's C++ code, allowing us to utilize data obtained from T3000 devices for rendering animated drawings. Furthermore, the T3000 software can now exert control over the drawing's status; for instance, if a fan is in the "On" state, it can trigger motion in the corresponding fan object.

To facilitate communication, the JavaScript side communicates with the C++ webview through the window.chrome.webview.postMessage function. Here's an example of how to send a message from the C++ side back to our JavaScript component:

String input_data = L"{\"SetInput\":{\"id\":\"IN1\",\"value\":\"On\"}}");
webview->PostWebMessageAsJson(input_data);

To learn more about webview communication between JS and C++, check this Interop of native-side and web-side code

temcocontrols/T3000Webview