- 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>
203 lines
9.6 KiB
Plaintext
203 lines
9.6 KiB
Plaintext
|
||
================================================================================
|
||
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 scriptinyourGeViSoftinstallation’s rootfolder.The
|
||
consoleargumentforcesthesoftwaretorunasaconsoleapplication andallowsyouto
|
||
|
||
================================================================================
|
||
PAGE 13
|
||
================================================================================
|
||
|
||
easilymonitortheserver’soutput.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)
|
||
TheGeViIOclient’sconfiguration 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ück’s 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 TestClient’s window.
|
||
IfarealVX3wouldbeconnected toyourGeViSoftandtheinputswereconnected tovideosig-
|
||
nals,youwouldswitchtherealsignaltotheaccording output(normallyamonitor).Youwill
|
||
learnhowtousetheseswitchactionstoremotecontrolaGscViewinthesamewayyou
|
||
woulduseananaloguematrixinthechapterSwitching Video.
|
||
Manipulating DigitalI/O
|
||
Similartothevideosignalsyoucanswitchdigitaloutputsandgeneratedigitalinputsignalsin
|
||
yourvirtualtestclient.
|
||
Generateasimulated digitalinput:
|
||
Togenerateaninputmoveyourmousepointeroverthedesiredinputchannel.Aleftclick
|
||
willsimulateaclosingofthecontact,arightclickanopening.Thecontacts’statesare
|
||
colorcodedaccording tothistable:
|
||
Color State
|
||
White Unknown
|
||
Red Closed
|
||
Green Open
|
||
Gray Unavailable
|
||
Generateasimulated digitaloutput:
|
||
Togenerateanoutputmovethepointeroverthedesiredoutputsignal.Left-clickingwill
|
||
settheoutput’sstatetoopen,right-clickingtoclose. Theoutputs’statesarecolorcoded
|
||
according tothistable:
|
||
Color State
|
||
White Unknown
|
||
Red Closed |