Files
Administrator 14893e62a5 feat: Geutebruck GeViScope/GeViSoft Action Mapping System - MVP
This MVP release provides a complete full-stack solution for managing action mappings
in Geutebruck's GeViScope and GeViSoft video surveillance systems.

## Features

### Flutter Web Application (Port 8081)
- Modern, responsive UI for managing action mappings
- Action picker dialog with full parameter configuration
- Support for both GSC (GeViScope) and G-Core server actions
- Consistent UI for input and output actions with edit/delete capabilities
- Real-time action mapping creation, editing, and deletion
- Server categorization (GSC: prefix for GeViScope, G-Core: prefix for G-Core servers)

### FastAPI REST Backend (Port 8000)
- RESTful API for action mapping CRUD operations
- Action template service with comprehensive action catalog (247 actions)
- Server management (G-Core and GeViScope servers)
- Configuration tree reading and writing
- JWT authentication with role-based access control
- PostgreSQL database integration

### C# SDK Bridge (gRPC, Port 50051)
- Native integration with GeViSoft SDK (GeViProcAPINET_4_0.dll)
- Action mapping creation with correct binary format
- Support for GSC and G-Core action types
- Proper Camera parameter inclusion in action strings (fixes CrossSwitch bug)
- Action ID lookup table with server-specific action IDs
- Configuration reading/writing via SetupClient

## Bug Fixes
- **CrossSwitch Bug**: GSC and G-Core actions now correctly display camera/PTZ head parameters in GeViSet
- Action strings now include Camera parameter: `@ PanLeft (Comment: "", Camera: 101028)`
- Proper filter flags and VideoInput=0 for action mappings
- Correct action ID assignment (4198 for GSC, 9294 for G-Core PanLeft)

## Technical Stack
- **Frontend**: Flutter Web, Dart, Dio HTTP client
- **Backend**: Python FastAPI, PostgreSQL, Redis
- **SDK Bridge**: C# .NET 8.0, gRPC, GeViSoft SDK
- **Authentication**: JWT tokens
- **Configuration**: GeViSoft .set files (binary format)

## Credentials
- GeViSoft/GeViScope: username=sysadmin, password=masterkey
- Default admin: username=admin, password=admin123

## Deployment
All services run on localhost:
- Flutter Web: http://localhost:8081
- FastAPI: http://localhost:8000
- SDK Bridge gRPC: localhost:50051
- GeViServer: localhost (default port)

Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-31 18:10:54 +01:00

268 lines
15 KiB
HTML

<!DOCTYPE html>
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" lang="en" xml:lang="en" data-mc-search-type="Stem" data-mc-help-system-file-name="index.xml" data-mc-path-to-help-system="../../" data-mc-target-type="WebHelp2" data-mc-runtime-file-type="Topic" data-mc-preload-images="false" data-mc-in-preview-mode="false" data-mc-toc-path="">
<!-- saved from url=(0014)about:internet -->
<head>
<meta charset="utf-8" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Device information</title>
<link href="../Resources/TableStyles/Rows.css" rel="stylesheet" />
<style>
body
{
font-family: Arial, Helvetica, sans-serif;
font-size: 10pt;
}
</style>
<link href="../../Skins/Default/Stylesheets/TextEffects.css" rel="stylesheet" />
<link href="../../Skins/Default/Stylesheets/Topic.css" rel="stylesheet" />
<link href="../Resources/Stylesheets/Styles.css" rel="stylesheet" />
<script src="../../Resources/Scripts/jquery.min.js">
</script>
<script src="../../Resources/Scripts/plugins.min.js">
</script>
<script src="../../Resources/Scripts/require.min.js">
</script>
<script src="../../Resources/Scripts/require.config.js">
</script>
<script src="../../Resources/Scripts/MadCapAll.js">
</script>
</head>
<body>
<h1>Device information</h1>
<p>All actions for low-level notification of the device or media channels changes.</p>
<h2>Device found</h2>
<p>Action name:<i>DeviceFound(Type, Name, Serial)</i></p>
<p>Action category: logical</p>
<p>This action will be fired when the USB or NET device is connected to the system. It is also fired at start-up for all detected devices.</p>
<table border="1" style="mc-table-style: url('../Resources/TableStyles/Rows.css');" class="TableStyle_Rows" cellspacing="0">
<tr bgcolor="#D9D9D9">
<th colspan="2" class="TableStyle_Rows_Body_0_0_RowSep_ColSep" style="font-weight: bold;">Parameter</th>
<th class="TableStyle_Rows_Body_0_0_RowSep_ColEnd" style="font-weight: bold;">Function</th>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">device type</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Type</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device name</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Name</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Device name if assigned in setup, empty otherwise.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">serial ID</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Serial</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Serial ID of the device.</td>
</tr>
</table>
<h2>New firmware received</h2>
<p>Action name:<i>DeviceNewFirmware(Type, Name, Serial, Firmware)</i></p>
<p>Action category: logical</p>
<p>This action will be fired when the USB or NET device has got the new firmware.</p>
<table border="1" style="mc-table-style: url('../Resources/TableStyles/Rows.css');" class="TableStyle_Rows" cellspacing="0">
<tr bgcolor="#D9D9D9">
<th colspan="2" class="TableStyle_Rows_Body_0_0_RowSep_ColSep" style="font-weight: bold;">Parameter</th>
<th class="TableStyle_Rows_Body_0_0_RowSep_ColEnd" style="font-weight: bold;">Function</th>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">device type</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Type</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device name</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Name</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Device name if assigned in setup, empty otherwise.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">serial ID</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Serial</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Serial ID of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">firmware serial</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Firmware</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Serial ID of the firmware.</td>
</tr>
</table>
<h2>Device plugin error</h2>
<p>Action name:<i>DevicePluginError(Channel, Type, SubType, Name, Serial, ErrorClass, ErrorCode, Description)</i></p>
<p>Action category: logical</p>
<p>This action notifies device plugin error.</p>
<table border="1" style="mc-table-style: url('../Resources/TableStyles/Rows.css');" class="TableStyle_Rows" cellspacing="0">
<tr bgcolor="#D9D9D9">
<th colspan="2" class="TableStyle_Rows_Body_0_0_RowSep_ColSep" style="font-weight: bold;">Parameter</th>
<th class="TableStyle_Rows_Body_0_0_RowSep_ColEnd" style="font-weight: bold;">Function</th>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">channel</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Channel</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Channel.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device type</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Type</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">device sub type</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>SubType</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Sub type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device name</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Name</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Device name.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">serial ID</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Serial</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Serial ID of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">error class</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>ErrorClass</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Error class of the error occured.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">error code</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>ErrorCode</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Plugin type specific error code.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">description</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Description</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Error description.</td>
</tr>
</table>
<h2>Device plugin state</h2>
<p>Action name:<i>DevicePluginState(Channel, Type, SubType, Name, Serial, State, InternalState, Description)</i></p>
<p>Action category: logical</p>
<p>This action notifies device plugin state.</p>
<table border="1" style="mc-table-style: url('../Resources/TableStyles/Rows.css');" class="TableStyle_Rows" cellspacing="0">
<tr bgcolor="#D9D9D9">
<th colspan="2" class="TableStyle_Rows_Body_0_0_RowSep_ColSep" style="font-weight: bold;">Parameter</th>
<th class="TableStyle_Rows_Body_0_0_RowSep_ColEnd" style="font-weight: bold;">Function</th>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">channel</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Channel</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Channel.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device type</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Type</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">device sub type</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>SubType</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Sub type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device name</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Name</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Device name.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">serial ID</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Serial</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Serial ID of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">plugin state</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>State</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">New plugin device state.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">internal state</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>InternalState</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Plugin device specific state.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">description</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Description</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">State description.</td>
</tr>
</table>
<h2>Device reattached</h2>
<p>Action name:<i>DeviceReattached(Type, Name, Serial)</i></p>
<p>Action category: logical</p>
<p>This action will be fired when the USB or NET device is reattached to the system.</p>
<table border="1" style="mc-table-style: url('../Resources/TableStyles/Rows.css');" class="TableStyle_Rows" cellspacing="0">
<tr bgcolor="#D9D9D9">
<th colspan="2" class="TableStyle_Rows_Body_0_0_RowSep_ColSep" style="font-weight: bold;">Parameter</th>
<th class="TableStyle_Rows_Body_0_0_RowSep_ColEnd" style="font-weight: bold;">Function</th>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">device type</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Type</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device name</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Name</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Device name if assigned in setup, empty otherwise.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">serial ID</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Serial</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Serial ID of the device.</td>
</tr>
</table>
<h2>Device removed</h2>
<p>Action name:<i>DeviceRemoved(Type, Name, Serial)</i></p>
<p>Action category: logical</p>
<p>This action will be fired when the USB or NET device is disconnected from the system. It is also fired at the start-up for all parameterized but not present devices.</p>
<table border="1" style="mc-table-style: url('../Resources/TableStyles/Rows.css');" class="TableStyle_Rows" cellspacing="0">
<tr bgcolor="#D9D9D9">
<th colspan="2" class="TableStyle_Rows_Body_0_0_RowSep_ColSep" style="font-weight: bold;">Parameter</th>
<th class="TableStyle_Rows_Body_0_0_RowSep_ColEnd" style="font-weight: bold;">Function</th>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">device type</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Type</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Type of the device.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep">device name</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColSep"><i>Name</i>
</td>
<td class="TableStyle_Rows_Body_0_0_RowSep_ColEnd">Device name if assigned in setup, empty otherwise.</td>
</tr>
<tr>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep">serial ID</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColSep"><i>Serial</i>
</td>
<td class="TableStyle_Rows_Body_1_0_RowSep_ColEnd">Serial ID of the device.</td>
</tr>
</table>
</body>
</html>