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,203 @@
================================================================================
PAGE 11
================================================================================
PleasenotethatthedirectoryC:/GEVISOFT/DATABASE willbecreatedwithoutregarding
thechoseninstallpath.ThisdirectoryhoststheGeViSoftdatabaseGeViDB.mdb whichis
hiddenbydefault.
Insidethe%GEVISOFTSDKPATH% directory,astructurelikethisiscreated:
lADocumentation foldercontaining allGeViSoftrelateddocumentation andmanuals.
lAnExamples folderincludingsubfolders thatarenamedaccording tothecor-
responding IDEandprogramming language.
-Insideeachofthese,thereisaGeViScopeSDK andGeViSoftSDK folderwiththe
respective IncludeandLibfoldersfortheprogramming languageaswellasthefolders
withthedifferentexamples.
-TheC++headersarelocatedinsidetheIncludefolderandthelibrariesinsidetheLib
folder.
-ForDelphi,the.pasandthe.incfilescanallbefoundinsidetheIncludefolder.
The%GEVISOFTSDKPATH% directoryitselfhostsalltheexecutables, dynamiclinklibraries,and
runtimefilesthatareneededbyGeViSoft. Bydefault,alltheexampleprojectswilloutputtheir
generated binariesintothisfolderaswell.Thisguarantees thatallruntimedependencies are
metandyourcompiledexecutables findtheneededDLLs.
Additionally, the.Netwrapperassemblies Geutebrueck.GeViSoftSDKNetWrapper.dll and
GscActionsNET.dll resideinthisfolder.
================================================================================
PAGE 12
================================================================================
SDKSetup
SetupofTest/Build Environment
Thischapterdescribes howtosetupandconfiguretheGeViSofttestenvironment.
 NOTICE
Pleasenotethatyouneedadministrative privileges onthedevelopment machine.
Installation ofGeViSoft
TheSDKisshippedasanexecutable installer.Youjustneedtorunitonyourdevelopment
machinein
ordertoinstalltheSDK.
 NOTICE
Itishighlyrecommended toinstallGeViSoft tothedefaultpathC:/Gevisoft.
 WARNING
PleasemakesurethatyoudonotinstalltheSDKonaproduction GeViSoft machine asthesetup
willoverwrite theinstalled GeViSoft fileswithout notice.
Starting GeViServer
YoucanstartGeViServer fromthecommand promptbyissuingthecommand
%GEVISOFTSDKPATH%/geviserver.exe console
orbyexecuting thestartserver.bat scriptinyourGeViSoftinstallations rootfolder.The
consoleargumentforcesthesoftwaretorunasaconsoleapplication andallowsyouto
================================================================================
PAGE 13
================================================================================
easilymonitortheserversoutput.Onaproduction machine,GeViServer usuallyrunsasa
windowsservice.
 NOTICE
Pleasenotethatwithout alicensedongle, theserverwillterminate aftertwohours.Youcan
directly restartitwithout anyfurther restrictions.
Configuration ofGeViSoft
Inthischapteryouwilllearnhowtoestablishaconnection totheGeViServer withthesetup
clientGeViSet(Settinguptheserverconnection ).
Afterthatthereisadescription forsettingupaGeViIOclientthatprovidesavirtualvideo
matrixanddigitalIO(Configuration oftheGeViIOClient).Youdonotneedtocarryoutthe
stepsdescribed inthatparagraph. Theyareforreferenceonlybecausethisconfiguration is
alreadydoneforyouinthedatabasethatisdeliveredwiththeSDK.
Settinguptheserverconnection
1StartGeViServer byexecuting startserver.bat ifnotalready doneso
2StartGeViSet.exe
3Setuptheserverconnection
aOpenFile->GeViSoft serverconnections
bIfaconnection localhost exists,pressConnect andmovetostep4
cIfnoconnection existschooseConnections ->NewConnection
dEnterlocalhost asthenameofthenewconnection andpresstheForward button
eIntheCreateNewServerConnection window setthecomputer nametolocalhost ,
theusernametosysadmin .CheckSavepassword andsetthepassword tomas-
terkey.SelectLocalconnection asconnection type.PresstheForward button.
Choose thelocalhost connection andpressConnect
================================================================================
PAGE 14
================================================================================
Configuration oftheGeViIOClient(reference)
TheGeViIOclientsconfiguration isalreadydoneforyouinsidethedatabasethatisshipped
withtheSDK.Thestepsdescribed hereareonlyareferenceforyouifyouneedtoadaptset-
tingsforyourtestenvironment.
1.IntheClientsfieldpushtheAddbuttonandaddanewGeViIOclientwiththename
GeViIO_ 01.
2.SelectthenewGeViIOclientandpressConfigure.
3.MarktheclientasActiveandVirtual.
4.AddanewVX3matrixbypressing AddintheInterfaces fieldandselectingtheappro-
priatetype(VX3/CX3).Nametheinterface VirtualVX3.
5.SelectthenewlycreatedVX3interfaceandpressEdit.
6.Add16newvideoinputstotheVX3interfacebypressingtheAddbuttonintheVideo
inputstab.IntheNewvideoInputwindowsetCountto16andpressok.Thenew
videoinputchannelsshouldshowupintheVideoinputtab.
7.Add4newvideooutputsinthesamemannerastheinputs.
8.Add8newinputcontactsand8newoutputcontactsinthesamewayyoudidforthe
videoinput.
9.Sendyournewlycreatedsetuptotheserverbychoosing File->Setuptoserverorby
clicking
.
Nowyourclientwindowshouldlooklikethis:
================================================================================
PAGE 15
================================================================================
Connection toGeViScope (optional)
IfyouhaveaGeViScope serverupandrunning,youcanconnectGeViSofttoitviaaTCP/IP
connection. Ifconnected, actionscanbeexchanged betweenthetwosystems.Asan
================================================================================
PAGE 16
================================================================================
examplethiscanbeusedtoremotecontrolGSCView.
PleasenotethatyoucaninstalltheGeViScope ServerasapartofGeutebrücks GeViScope
SDKifyouhavenotdoneityet.YoucandownloadthisSDKonwww.geutebrueck.com or
requestitfromtheSDKdivision.
InstallingtheGeViScope SDKisaprerequisite forthescenarioandexampleinthechapter
Switching Video.
Youcanconfiguretheconnection toGeViScope insideGeViSet.ChoosethemenuServer->
GeViScope Connections andpressAddinthepop-upmenu.Youcanthenconfigurethecon-
nectionparameters insidetheGeViScope connection window.
 NOTICE
PleasenotethattheAliasisusedtoaddressdifferentGeViScope serversfrominsidethe
SDKwithGSCActions. SeeActionmessages >creatingactionmessages >4.Exampleofcre-
atingaGeViScope ActionMessage
================================================================================
PAGE 17
================================================================================
FirstStepswithGeViSoft
Thischapterwillleadyouthroughout yourfirststepswithGeViSoft. Youwilllearnhowtocon-
necttoaGeViServer, sendsomebasicactions,andcustomize messagelogginganddisplay
toyourneeds.IfyouarealreadyfamiliarwithGeViSoft, youcanskipthischapterorskim
throughit.
GeViAPI TestClient
TheeasiestwaytotestyourGeViSoftsetupisbyusingtheGeViAPITestClient.Youcan
startitfromyour%GEVISOFTSDKPATH% directory.
PleasemakesurethatyourGeViServer isalreadystarted.Ifnotstartitbyexecuting the
“startserver.bat” insidetheGeViSoftrootdirectory.
AfterstartupconnecttotheGeViServer byaddingyourcredentials andpressingthe“Conn”
button.Ifeverything worksout,the“Connected” indicatorwillbeilluminated ingreenandsev-
eralmessages willpopupinthe“Communication log”.Atthispointyourcommunication is
setupcorrectly.
Ifyouhavefollowedtheconfiguration stepsinchapterSettingupGeViIOyouwillalreadybe
abletouseGeViSoftforswitchingyourvirtualvideoI/O.
CrossSwitching Video
SelectthetabVideo/DigIO .Youcanswitchyourvideosignalinthefollowingway:
1.Selectanactiveinputandanactiveoutput.Thesignalwillbeswitchedbetweenthese
two.YoucanseetheactiveI/OonthewindowsrighthandsidebeneaththetextVideo.
a)Toselectanactiveoutput,left-clickononeofyourconfigured videooutputsinthe
upperwindowarea.YoushouldseeActOutchangingwithregardtoyourselection.
================================================================================
PAGE 18
================================================================================
b)Nowmovethemouseoverthedesiredinput(e.g.7)andright-clickontheinput.
Thenumberofyourselectedinputshouldnowappearintheblacksquareaboveyour
selectedoutput.
2.Clearavideooutput.Movethemouseovertheoutputtoclearandright-clickonit.The
numberintheblacksquareabovetheoutputshouldvanish.
================================================================================
PAGE 19
================================================================================
================================================================================
PAGE 20
================================================================================
 NOTICE
Whenswitching theoutput, aCrossSwitch actionwiththechosen channels isdisplayed inthe
Communication LogshowninthelowerpartoftheGeViAPI TestClients window.
IfarealVX3wouldbeconnected toyourGeViSoftandtheinputswereconnected tovideosig-
nals,youwouldswitchtherealsignaltotheaccording output(normallyamonitor).Youwill
learnhowtousetheseswitchactionstoremotecontrolaGscViewinthesamewayyou
woulduseananaloguematrixinthechapterSwitching Video.
Manipulating DigitalI/O
Similartothevideosignalsyoucanswitchdigitaloutputsandgeneratedigitalinputsignalsin
yourvirtualtestclient.
Generateasimulated digitalinput:
Togenerateaninputmoveyourmousepointeroverthedesiredinputchannel.Aleftclick
willsimulateaclosingofthecontact,arightclickanopening.Thecontactsstatesare
colorcodedaccording tothistable:
Color State
White Unknown
Red Closed
Green Open
Gray Unavailable
Generateasimulated digitaloutput:
Togenerateanoutputmovethepointeroverthedesiredoutputsignal.Left-clickingwill
settheoutputsstatetoopen,right-clickingtoclose. Theoutputsstatesarecolorcoded
according tothistable:
Color State
White Unknown
Red Closed