Table of Contents

Siwenoid v2 Operation Manual

Logging In

When SIWENOID v2 Client is launched, it connects to the server automatically. Once the connection is established, the login dialog appears. Enter your username and password, then click Login. The bottom of the dialog shows the name of the server you are connected to.

Login dialog

The Main Screen

The main screen is the software's primary working area. It is divided into panels — by default the Signal Log, Datapoint Hierarchy, and Event Log are open as tabs. A + button next to the tabs allows you to open additional panels such as extra maps, subtrees, forced actions, or additional event logs.

The title bar at the very top shows the software name, version number, and the currently logged-in user.

Every event is separated by category colour and icon. From each signal log line it is possible to open a map, send a command, write a comment, or navigate to the Datapoint Hierarchy.

Main screen overview

The title bar shows the software name, version, and the logged-in user. Directly below it is the menu bar containing the File and Windows menus. Next to them is a small server status indicator — green means the server is communicating normally, red means communication has been lost.

File menu

Under File you can find: Settings, Switch User, Logout, and Exit.

To switch to a different user without closing the application, go to File → Switch User. Enter the new user's credentials. The application reloads with the permissions of the new user. This is useful when a supervisor needs to temporarily access a restricted feature, or when a shift handover happens.

Windows menu

Under Windows you can save the position of all open windows, or close all of them with one click.

Category Bar

Category bar

The category bar runs across the top of the screen, below the menu bar. It displays all configured event categories — by default: Alarm, Prealarm, Warning, Fault, Exclusion, Disorder, and Information. Each category has its own colour and name. Priority order runs from left to right — Alarm has the highest priority.

Below each category name is a counter showing unacknowledged events versus total active events in that category. For example, 2/5 means 2 unacknowledged events out of 5 total. Next to the counter is an ACK button — clicking it acknowledges every event in that category with a single click.

Filtering the Signal Log by Category

Signal log filtered by Exclusion category

Clicking a category name in the category bar filters the Signal Log to show only events belonging to that category. The active filter is highlighted. In the example above, the Exclusion category is selected — only Exclusion events are shown in the signal log, while events from all other categories are temporarily hidden from view.

To remove the filter and return to the full signal log, click the active category name again to deselect it.

Important: The Alarm category cannot be filtered out. Alarm events are always visible in the signal log regardless of any active category filter. This is a deliberate safety measure — critical alarm events must never be hidden from the operator.

Signal Log

The signal log is the main information source during daily operation. Every active event appears here. An alarm event is highlighted in red (the category colour) and plays the alarm sound when it first arrives.

A blinking new event can be acknowledged by clicking on it. Each event line shows, from left to right: date and time, logical location, datapoint name, technical text, event status (for example ALARM), and whether the event is new or acknowledged.

If an event has been acknowledged but the signal has not yet cleared (returned to normal), the line background changes to black with strikethrough text.

Signal log

After each event line there are five action buttons, from left to right:

1 — Send default command — sends the most appropriate command for that datapoint. Hovering shows a tooltip with the command name. The button icon matches the command type. Right-clicking shows all available commands for that datapoint.

2 — Show map — opens the map associated with the signalling datapoint and highlights it on the map. If no map is assigned, the button is inactive.

3 — Show intervention text — opens the intervention text assigned to the datapoint. The button is red if a text is assigned, grey if not.

4 — Add note — opens a notes dialog where you can type a note and click Send. Multiple notes can be added to the same event. Each note is saved with a timestamp and the username of the author. Once a note has been added, the button icon turns blue to indicate notes are attached.

5 — Show in Datapoint Hierarchy — highlights the signalling datapoint in the Datapoint Hierarchy panel.

Adding a Note to an Event

Click the note button (4th button) on any event line. A Notes dialog opens showing the event details at the top and any existing notes. Type your note in the text field and click Send. The note icon turns blue to confirm the note was saved.

Notes dialog

You can add further notes to the same event by clicking the button again. All previous notes remain visible in the dialog with their timestamps.

Sending Commands from the Signal Log

To send the default command, left-click the first (leftmost) button on the event line. To choose from all available commands, right-click that same button. A menu appears listing all commands that can be sent to that datapoint — for example: ON, OFF, RESET, ACKNOWLEDGE.

Command menu from signal log

Alarm Handling Workflow

When an alarm occurs, it appears in the Signal Log highlighted in red. The Alarm counter in the category bar increments and the alarm sound plays. The correct handling procedure is as follows:

Step 1 — Acknowledge
Click the blinking event line to acknowledge it, or click the ACK button in the Alarm section of the category bar to acknowledge all alarms at once. Acknowledging registers that you have seen the event. The event stops blinking but remains in the log.

Step 2 — Investigate
Use the map button (2nd button) on the event line to open the floor plan and see exactly where the alarm originated. The datapoint is highlighted on the map. You can also click the Datapoint Hierarchy button (5th button) to locate it in the tree.

Step 3 — Reset
Once the physical situation has been resolved, send a RESET command using the command button (1st button) on the event line. Right-click to find RESET in the command list. The datapoint returns to Normal status and the event leaves the Signal Log.

Alarm handling workflow

Datapoint Hierarchy

Datapoint Hierarchy panel

The Datapoint Hierarchy displays all datapoints in a tree structure. Expand any node by clicking the arrow next to it or by double-clicking the row. Selected items are highlighted with a blue background.

Red container icons indicate logical containers — user-defined groupings of datapoints. Sensor icons represent individual datapoints such as zones, detectors, or outputs.

On the right side of each row, small icons indicate whether a map or intervention text is assigned to that datapoint. The right-side information panel shows the selected datapoint's name, technical text, map and intervention text links, all possible treatment statuses (with the current active status highlighted), available commands, and a 24-hour event log for that datapoint.

Opening a Map from the Datapoint Hierarchy

Select a datapoint that has a map icon visible on the right side of its row. The same icon appears in the information panel. Click it to open the associated map — the datapoint will be highlighted when the map opens.

Map icon in Datapoint Hierarchy

Sending Commands from the Datapoint Hierarchy

Select a datapoint in the tree. The Commands section appears in the right panel. Click the icon next to a command name to send it to the datapoint. Available commands depend on the datapoint type and the logged-in user's permissions.

Multi-selection in the Datapoint Hierarchy

Hold Ctrl and click to select multiple individual datapoints, or hold Shift to select a continuous range. Once multiple items are selected, the Commands panel shows commands that can be sent to all selected datapoints simultaneously. This is useful for switching multiple detectors on or off in a single action.

Multi-selection in Datapoint Hierarchy

Searching in the Datapoint Hierarchy

A search bar is located at the lower left of the Datapoint Hierarchy panel. Search by datapoint name or technical text. Press Enter or click the search icon to filter the tree. Click the reset button next to the search icon to clear the search and restore the full tree.

Datapoint Hierarchy search

Right-click Menu in the Datapoint Hierarchy

Right-clicking any node opens a context menu with options including: Sorting, Show in physical hierarchy, New Subtree, Datapoint suspension, and Copy to clipboard. Use New Subtree to create a shortcut panel to that branch of the tree.

Right-click context menu

Event Log

The Event Log contains a complete record of every event, command, acknowledgement, comment, user login, and server connection change. It is the full audit trail of the system.

Each row has four columns: date and time, category or type, datapoint name (and comment if one was added), and the status or command name (plus username if a comment was involved). The Event Log refreshes automatically and is sorted by time.

Event log

Filtering the Event Log

At the bottom of the Event Log there are filter fields. Filter by date range using the From and To fields. Filter by category by checking or unchecking category names in the dropdown. Type a name or location into the text search field to narrow results further.

Event log filter controls

Saving and Recalling Filters

After setting filter criteria, click the Save icon (floppy disk) at the bottom to save the filter with a name. Saved filters appear in the Saved Filters dropdown at the bottom left — select a name to instantly reapply that filter.

Saved filters

Exporting the Event Log

Click the export button (to the left of the printer icon at the bottom right) to export the currently filtered log. Available formats are CSV, HTML, and XLSX. The Refresh button resets all active filters and shows the full unfiltered log.

Opening Additional Panels

The + button in the tab bar opens a menu to add additional panels to the workspace:

Add panel menu

Subtrees

A subtree is a shortcut to a specific portion of the Datapoint Hierarchy. Instead of navigating the full tree every time, a subtree opens just the relevant branch in its own dedicated tab. This is useful for operators who only need to monitor a specific building, floor, or system type.

Creating a Subtree

Right-click any node in the Datapoint Hierarchy and select New Subtree from the context menu. A dialog appears — give the subtree a name and save it. The subtree is now available from the + tab menu.

Creating a subtree

Opening a Subtree

Click + in the tab bar and choose Subtrees. A submenu lists all defined subtrees. Click the name of the subtree to open it in a new tab showing only that branch of the hierarchy.

You can pin a subtree tab by right-clicking it and choosing Pin Tab so it stays open permanently and cannot be accidentally closed.

Opening a subtree

Map

Map panel

Maps are typically floor plans of buildings or sites. Each map can have sensor icons and map link icons placed on it.

Sensor icons appear at the positions of their associated datapoints. Hovering over an icon shows a tooltip with the datapoint name and current status. Right-clicking a sensor icon opens a command menu for sending commands directly from the map.

If a datapoint has an active status, its icon is highlighted in the event's category colour. If the event has not yet been acknowledged, the icon blinks.

Active datapoint icons on map

The map is zoomable using the mouse wheel. Drag with the left mouse button to pan. A mini-map in the upper right corner shows your current position. A zoom reset button below the mini-map returns the map to its default view.

Map navigation controls

At the bottom of the map panel you can see the current map name, the Print button, and the Editable checkbox. Enabling Editable (with sufficient permissions) allows map layout changes.

Map bottom bar

Multi-selection on a Map

Hold Ctrl and click multiple sensor icons to select more than one datapoint at once. A popup shows the names of all selected datapoints and a Commands menu. Use this to send a command such as ON or OFF to all selected datapoints simultaneously.

Multi-selection on map

Map link icons are placed on a map and open another map when clicked, allowing free navigation between maps. For example, a campus overview map can have link icons for each building — clicking one opens that building's floor plan.

The back arrow button at the bottom left of the map panel steps back to the previously viewed map. The grid icon next to it returns to the default start map.

Pinning a Map Tab

Right-click any map tab and select Pin Tab to prevent it from being closed. A pinned tab has no close button and remains open permanently. Use this for your main overview map.

Pinned map tab

Signal Log Controls

On the right side of the screen, a vertical toolbar controls Signal Log display and behaviour. From top to bottom:

Signal log right-side controls

Workspace Division

The workspace can be divided into multiple panes, allowing you to open additional views — such as a map alongside the Signal Log, or two maps simultaneously — within the same screen. Click the + button in the tab bar of any pane and select the panel type to open in the new division.

Workspace split into multiple panes

Intervention Texts

Intervention text button in signal log

An intervention text is a set of written instructions assigned to a specific datapoint. When that datapoint triggers a signal, the operator can open the intervention text to know exactly what action to take — for example, who to call, which door to check, or what the procedure is.

The intervention text button is the 3rd button in each event line. It is red if a text is assigned, grey if not. Clicking it opens the text. The text is also printable from the viewer window.

Intervention texts can be configured to open automatically when a specific event occurs, using the Task settings.

Intervention text viewer

Switching Users

To switch to a different user without closing the application, go to File → Switch User. Enter the credentials of the new user. The application reloads with the new user's permissions.

Switch user dialog

Different users may have different permissions set by the administrator. A restricted user may see fewer commands, a reduced Settings menu, or may be unable to use features such as the category ACK button, event log export, or map editing. This allows the system to be configured so that guards can only perform their specific tasks while engineers retain full access.

CCTV Viewer

When SIWENOID v2 Client is running, two application icons appear in the Windows system tray — one for the client itself and one for the CCTV Viewer.

Camera datapoints appear in the Datapoint Hierarchy under their respective containers. Two types of camera sources are supported: direct streams via RTSP protocol, and cameras connected through a video recorder API (such as Hikvision). API-connected cameras support PTZ (pan-tilt-zoom) control and preset positions. RTSP cameras show live video only.

CCTV tray icon

Viewing a Camera

To open a live camera stream, right-click the camera datapoint in the Datapoint Hierarchy and select Show live video. The CCTV Viewer opens and the stream appears. You can also drag a camera datapoint directly from the hierarchy into the CCTV Viewer window.

CCTV live view

Use the buttons at the bottom left of the CCTV Viewer to change the layout between 1, 4, or 9 camera cells. Drag a cell using the small icon in its top left corner to reposition it. Click the X on a cell to close that stream.

For Hikvision API cameras, directional buttons are available for manual PTZ control.

Automatic Camera on Alarm

If a camera has been assigned to a datapoint and that datapoint triggers an alarm, the associated camera stream automatically appears in the CCTV Viewer. This allows operators to immediately see the alarm location without any manual action.

Automatic camera on alarm

Alert Messages

The system allows administrators to send alert messages to all connected operators. These messages appear as a popup on the operator's screen and must be acknowledged before they can be dismissed.

Sending an Alert Message

Right-click the speech bubble icon at the bottom of the right sidebar and select Add alert note. A dialog opens — type your message and click Send. The message is delivered to all connected clients immediately.

Sending an alert message

Receiving an Alert Message

When an alert message is received, a popup appears showing the message text, sender name, and timestamp. Click OK to acknowledge and dismiss it.

Alert message popup

All sent alert messages are stored in the Event Log for audit purposes, including sender name and timestamp.