feat: GeViScope SDK integration with C# Bridge and Flutter app

- Add GeViScope Bridge (C# .NET 8.0) on port 7720
  - Full SDK wrapper for camera control, PTZ, actions/events
  - 17 REST API endpoints for GeViScope server interaction
  - Support for MCS (Media Channel Simulator) with 16 test channels
  - Real-time action/event streaming via PLC callbacks

- Add GeViServer Bridge (C# .NET 8.0) on port 7710
  - Integration with GeViSoft orchestration layer
  - Input/output control and event management

- Update Python API with new routers
  - /api/geviscope/* - Proxy to GeViScope Bridge
  - /api/geviserver/* - Proxy to GeViServer Bridge
  - /api/excel/* - Excel import functionality

- Add Flutter app GeViScope integration
  - GeViScopeRemoteDataSource with 17 API methods
  - GeViScopeBloc for state management
  - GeViScopeScreen with PTZ controls
  - App drawer navigation to GeViScope

- Add SDK documentation (extracted from PDFs)
  - GeViScope SDK docs (7 parts + action reference)
  - GeViSoft SDK docs (12 chunks)

- Add .mcp.json for Claude Code MCP server config

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Administrator
2026-01-19 08:14:17 +01:00
parent c9e83e4277
commit a92b909539
76 changed files with 62101 additions and 176 deletions

View File

@@ -0,0 +1,144 @@
================================================================================
PAGE 1
================================================================================
GeViSoft SDK
Dokumentation |Documentation |Documentation |Documentatión
Version 2012_1.7|Date19.07.2012
================================================================================
PAGE 2
================================================================================
GeViSoft SDK
Introduction
TheGeViSoftSDKallowsintegrating yourcustomsolutionsandproductswithGeutebrücks
GeViSoftsuite.Itincludesanapplication programming interface(API)withallnecessary
DLLs,headers,exampleprojects,anddocumentation tohelpyougettingstartedwithyour
integration easily.
TheSDKsupportsC++andDelphi.Furthermore a.Netwrapperisincludedwhichallowsyou
tousetheSDKfromC#.Itprovidesvariousexampleprojectsandsolutionsintheselan-
guages.
================================================================================
PAGE 3
================================================================================
GeViSoft
GeViSoftisGeutebrücks centralmanagement systemforvideocontrol.Itsmainfunctionis
theswitchingofvideosignalsbetweendifferentcameras,monitorsandDVRsbycontrolling
avideomatrixsystem.Alarmhandlingaswellastheremotecontrolofpan/tiltanddomecam-
erasisafurtherfunctionality ofGeViSoft.
GeViSoftcanalsobeusedtohandlegeneralpurposedigitalinputsandoutputsandthus
allowsintegrating customsensortechnology andactuatingelementstotheGeutebrück sys-
tem.
Furthermore, differentperipherals commontovideocontrolsystems,likevideomotionanal-
ysisoroperatorconsoles, canbemanaged.
GeViSoft Architecture
Thearchitecture ofGeViSoftfollowstheclient-serverparadigm. Theserversoftware(GeV-
iServer)usualrunsonadedicated PC.ThishardwareplatformiscalledGeViStation. The
combined systemofsoftwareandhardwareiscalledGeViControl.
AtleastoneIOclientmusthandleconnections totheperipherals. Thisclientiscom-
municating withtheGeViSoftserverandrunsonthesamemachine.ItiscalledGeViIO.
TheGeViIOclientprovidestheinterfaces forthecommunication totheattachedperipherals
likeaVX3matrixoraPTZ.Theseperipherals canalsobevirtualized.
GeViServer andGeViIOcanbeconfigured fromtheGeViSetapplication. Theconfiguration is
described indetailinchapterConfiguration ofGeViSoft.
ThefollowingfigureshowsasetupofGeViSoftwithanattachedVX3,digitalIOandtwoPTZ
devices.
================================================================================
PAGE 4
================================================================================
================================================================================
PAGE 5
================================================================================
Figure1-GeViSoft Example Configuration
Historically, therehasbeenademandtocontrolalargenumberofvideofeedswithalimited
numberofmonitorsinsurveillance systems.Thishasleadtotheinventionofvideomatrixes
liketheVX3,whichalloweddifferentcamerasignalstobedynamically routedtotheattached
monitors.Theroutingcouldbeuserinitiatedortriggeredbyexternaleventslikealarmsordig-
italinputs.
Besidesthevideoroutingitwasnecessary toallowtheoperatortoremotecontrolPTZand
domecamerasfromacentralconsoletoreactonalarmsorotherevents.
Aconfiguration liketheonedescribed aboveisreflectedinthesetupaccording tofigure1.
Nowadays analoguevideocamerasandmonitorsaregettingreplacedbyIPcamerasand
PCsrunningsoftwareviewerslikeGSCView. GeViSoftallowsthehandlingofthesemodern
setupsaswellsothattheycanbeintegrated seamlessly intoexistinginstallations.
Figure2givesanexampleforacomplexsetupintegrating analogueaswellasdigitalcom-
ponents.
================================================================================
PAGE 6
================================================================================
Figure2-Complex GeViSoft Setup
================================================================================
PAGE 7
================================================================================
Additional tocontrolling thecrossswitchinginsidethematrix,GeViSoftcanbeusedtocom-
municatewithGeViScopes. ItispossibletoconfigureGeViSoftinsuchawaythataGeV-
iScopeandtheconnected GscViews canbecontrolled justlikeananaloguevideomatrix,
e.g.aVX3.
Thenextchaptergivesanoverviewofthedifferentcomponents thatadduptoGeViSoft.
GeViServer
GeViServer isthebackendserverinaGeViSoftsystem.Italsomanagestheinternaldata-
base.GeViServer usuallyrunsasaWindowsserviceonproduction machines, butcanalso
bestartedasaconsoleapplication fortestingpurposesordebugging. IfinstalledbytheSDK
setup,theGeViServer mustbestartedfromtheconsole.
ItispossibletorunGeViServer inaclustertoincreasereliability.
GeViAdmin
Theapplication GeViAdmin isusedtosetuptheGeViServer database. Itcanalsobeusedto
configureredundancy settingsbyclustering severalGeViServers. Furthermore, GeViScope
canbeusedfordiagnostics andloadanalysis.GeViAdmin ispartoftheshippingproduct,but
notoftheSDK.TheSDKinstallerautomatically setsupaGeViSoftdatabaseduringthe
installation process.
GeViIO
TheGeViIOclientisresponsible forthecommunication withtheexternalinterfaces and
peripherals. ItrunsonthesamemachineastheGeViServer. Otherinstances ofGeViIO
mightrunonseparatemachines.
================================================================================
PAGE 8
================================================================================
GeViSet
GeViSetistheconfiguration toolforGeViServer. ItcanbeusedtoconfigureGeViIOclients,
users,events,alarmsandallotherfunctionalities ofGeViServer, aswellasconnections to
GeViScope servers.Someconfiguration stepsandoptionsinsideGeViSetareshowninthe
followingchapters.
GeViAPI TestClient
TheGeViAPITestClientallowstestinganddebugging GeViSoftapplications. Withthistool
youcansendandreceiveactionsandalarms,querythedatabase, andretrievesysteminfor-
mation.
================================================================================
PAGE 9
================================================================================
SDKIntroduction
TheGeViSoftSDKprovidesyouwithanopenapplication programming interfacetotheGeV-
iSoftsuiteandallowsyoutointegrateyourcustomproductswithGeutebrücks.
TheSDKincludestheDLLsandcorresponding headerfilesrequiredbyyourC++orDelphi
projects.Furthermore .NetwrapperDllsareincludedwhichallowyoutousetheSDKfrom
yourC#application.
Severalexampleapplications helpyougettingstartedwiththeGeViSoftSDKdevelopment
andmayactasafoundation foryourownsolutions.
FilesandDirectory Structure
Duringinstallation, theenvironment variable%GEVISOFTSDKPATH% isset.Itpointstothe
rootdirectoryoftheSDKinstallation. Thevariablesvalueisdetermined bythepathchosen
astheinstalldirectoryduringsetup.Usually,thisis“C:\GEVISOFT”. AllSDKdirectories are
locatedinsidethisrootdirectory.
Thisisa(partial)treeviewofthestandardinstallation:
================================================================================
PAGE 10
================================================================================