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,151 @@
================================================================================
PAGE 21
================================================================================
Green Open
Yellow Alternating (CanbesetviaAlternate Contact action)
Gray Unavailable
Information
IftheGeViIO clientwasconnected torealDIOhardware, youcouldseetheinput
signals changing inrealtime.Setting oftheoutputs would result inswitching
realloads.
================================================================================
PAGE 22
================================================================================
Actions
SofaryouonlyusedGeViAPITestClientsbuilt-infunctionality tointeractwithGeViServer.
InthischapteryouwilllearntouseGeViSoftactionstocontrolthesystem.
GeViSoftactionscanbesentbytypingthemintothetextboxinthelowermiddleoftheGeVi-
APITestClientswindow.Youcanfindacompletelistofthepossibleactionsinthedoc-
umentation.
Hint
Youcaninteractively generate actions andlearnabouttheirparameters bycom-
posing theminGeViSet. Therefore, openGeViSet, andconnect totheserver.
Thennavigate toServer ->Named actions andpressAddinthewindow that
popsup.Inthewindow Named action settings youmaypressthebutton withthe
threedots(“…”)totakeyoutotheAction settings menu.
Thereyoucanchoose anyoftheimplemented actions andviewtheirparameters
andsettings. Tofiltertheactions bycategory choose oneofthecategories from
theupper leftlistbox.Hoover themouse overanyoftheparameters togeta
detailed description ofit.
Asanexample select Crossbar control asacategory andmovetoCrossSwitch to
seethemessages parameters ontherightside.
Thecomplete message is:
CrossSwitch (IDVideoInput, IDVideoOutput, Switchmode) .
CrossSwitching Video
1.Routevideofromaninputtoanoutput--Tosendthevideofrominput7tooutput3,do
thefollowing:
================================================================================
PAGE 23
================================================================================
a)TypethisactionintothetextboxinthelowermiddleoftheGeViAPITestClient
windowandsendit: CrossSwitch (7,3,0)
b)Makesurethatthesignalisroutedaccordingly bycheckingtheoutputinthetab
Video/DigIO
c)Routevideoinput3tooutputchannel2.(CrossSwitch (3,2,0))
2.Clearvideooutput2:ClearVideoOutput (2)
================================================================================
PAGE 24
================================================================================
Crossswitching video1
================================================================================
PAGE 25
================================================================================
Manipulating DigitalI/O
1.Opencontact1andclosecontact2--TheactionsOpenContact (ContactNumber) and
CloseContact (ContactNumber) canbeusedtosetthedigitaloutputsfromGeViSoft.
a)Toopencontact1sendtheaction:OpenContact (1)
b)IntheTabVideo/DigIO ofGeViAPITestClientmakesurethattheindicationof
outputonehasturnedtogreen
c)Toclosecontact2sendtheaction:CloseContact (2)
d)Makesurethattheoutputturnedred.
2.Simulateaclosingoftheinputcontact3andanopeningoftheinputcontact5
a)InputContact (3,true)
b)Makesurethatinput3issignaling closed(redindication)
c)InputContact (5,false)
d)Makesurethatinput5issignaling open(greenindication)
3.Alternating acontact --Simulateaflashlightonoutput8
a)Toalternateacontact,youcanusetheactionAlternateContact (ContactID,
BlinkPeriod_ in_ms,BlinkOnTime_ in_ms)
b)Sendthecommand toflashthelightwithafrequency of1Hzandadutycycleof
500ms: AlternateContact (8,1000,500)
================================================================================
PAGE 26
================================================================================
c)Checkthatthecontactisalternating afterpressingtheRefreshbutton,theout-
put8stateshouldbealternating (yellow).
================================================================================
PAGE 27
================================================================================
================================================================================
PAGE 28
================================================================================
Manipulating digitalIO
================================================================================
PAGE 29
================================================================================
GETAS
InthischapteryouwilllearnaboutGETAS,theGeutebrück TelnetActionServer.The
GETAScomponent allowsyoutosendandreceiveGeViSoftactionsviatelnet.Multiple
clientscanconnecttooneGeViServer atatime.
Thetelnetinterfaceallowsyoutoeasilyintegratesimpleapplications intoyourGeViSoftinfra-
structure.Furthermore itoffersanoptiontoconnectnon-Windowsplatforms.
 CAUTION
Bydefault, GETASisnotactive.Toactivate GETAS, openGeViSet andnavigate toServer->
GETAS.IntheGETASsettings window, youcanthenactivate thecomponent bychecking Enable
TCPport.BydefaultGETASwilllistentoport7707.Leavetheothersettings unmodified and
pressOK.Sendthealteredsetuptotheserverafterwards (File->Setuptoserver).
 CAUTION
Toconnect toGETAS, youneedatelnetclient.YoucaneitherusetheWindows telnetclientora
thirdpartyapplication likeputty.
 ADVICE
IfyouareusingWindows 7,thetelnetclientisnotactivated bydefault. Toactivate itgotoStart
->Control Panel->Programs andFeatures andselecttheTelnetClientfromthelistbox.
NowyoucanconnecttoGeViServer andsendsomeactions.
BasicGETASUsage
1.ConnecttoGeViServer viaGETASOpenacommand window(cmd.exe) andstart
telnet.Inacommand windowtype:telnetlocalhost 7707
================================================================================
PAGE 30
================================================================================
2.Makesurethatyourinputisechoedlocallybyentering setlocalecho
3.Youmaywanttopressenteroncetoclearyourscreenifnecessary.
4.MakesurethatyoustartedyourGeViAPITestClientandconnected ittotheGeV-
iServer
5.Sendanactiontotheserver:
a)CustomAction (42,"HelloGETAS")
b)Ifyoureceiveanechoofyouractionprecededbya4;fromtheGeViSoftserver,
yourconfiguration isworking
c)VerifythatyoucanalsoseetheactionintheGeViAPITestClientscom-
munication log.Ifyoucannotseethemessage, makesureyouareconnected and
yourfiltersettingsinthetabFilterGeViSoftaresetcorrectly.Tobesure,setthe
filtertoacceptallmessages.
6.Monitoractionssentbyotherclientsinyourtelnetsession:
a)SendanactionfromGeViAPITestClient:CustomAction (23,"HelloGETAS
client")
b)Verifythatyoureceivedtheactioninyourtelnetwindow.
VideoandIOControlwithGETAS
1.NowcontrolyourvirtualVX3byusingGETASMakesurethatGeViAPITestClient
isrunningwhileyouissuecommands viatelnetandyoucanseetheVideo/DigIO tab.
YourGeViIO_01configuration shouldbethesameasinchapterSettingupGeViIO.