Files
geutebruck/GeViSoft_SDK_Docs/chunk_002_pages_11-20.txt
Administrator a92b909539 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>
2026-01-19 08:14:17 +01:00

203 lines
9.6 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

================================================================================
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