Files
geutebruck/SOURCES/GeViScope_SDK_text/GeViScope_SDK_pages_011-020.txt
Administrator 14893e62a5 feat: Geutebruck GeViScope/GeViSoft Action Mapping System - MVP
This MVP release provides a complete full-stack solution for managing action mappings
in Geutebruck's GeViScope and GeViSoft video surveillance systems.

## Features

### Flutter Web Application (Port 8081)
- Modern, responsive UI for managing action mappings
- Action picker dialog with full parameter configuration
- Support for both GSC (GeViScope) and G-Core server actions
- Consistent UI for input and output actions with edit/delete capabilities
- Real-time action mapping creation, editing, and deletion
- Server categorization (GSC: prefix for GeViScope, G-Core: prefix for G-Core servers)

### FastAPI REST Backend (Port 8000)
- RESTful API for action mapping CRUD operations
- Action template service with comprehensive action catalog (247 actions)
- Server management (G-Core and GeViScope servers)
- Configuration tree reading and writing
- JWT authentication with role-based access control
- PostgreSQL database integration

### C# SDK Bridge (gRPC, Port 50051)
- Native integration with GeViSoft SDK (GeViProcAPINET_4_0.dll)
- Action mapping creation with correct binary format
- Support for GSC and G-Core action types
- Proper Camera parameter inclusion in action strings (fixes CrossSwitch bug)
- Action ID lookup table with server-specific action IDs
- Configuration reading/writing via SetupClient

## Bug Fixes
- **CrossSwitch Bug**: GSC and G-Core actions now correctly display camera/PTZ head parameters in GeViSet
- Action strings now include Camera parameter: `@ PanLeft (Comment: "", Camera: 101028)`
- Proper filter flags and VideoInput=0 for action mappings
- Correct action ID assignment (4198 for GSC, 9294 for G-Core PanLeft)

## Technical Stack
- **Frontend**: Flutter Web, Dart, Dio HTTP client
- **Backend**: Python FastAPI, PostgreSQL, Redis
- **SDK Bridge**: C# .NET 8.0, gRPC, GeViSoft SDK
- **Authentication**: JWT tokens
- **Configuration**: GeViSoft .set files (binary format)

## Credentials
- GeViSoft/GeViScope: username=sysadmin, password=masterkey
- Default admin: username=admin, password=admin123

## Deployment
All services run on localhost:
- Flutter Web: http://localhost:8081
- FastAPI: http://localhost:8000
- SDK Bridge gRPC: localhost:50051
- GeViServer: localhost (default port)

Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-31 18:10:54 +01:00

110 lines
8.5 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

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.

================================================================================
GeViScope_SDK.pdf - Pages 11 to 20
================================================================================
────────────────────────────────────────────────────────────────────────────────
Page 11
────────────────────────────────────────────────────────────────────────────────
IftheconnectionisopeninGSCVieworGSCSetup,thesettingsoftheconnectioncannot
bechanged.Closealllocalconnectionsatfirsttobeabletochangetheconnectionsettings.
Step5:configureGSCViewtobeabletoremotecontrolitby
actions
Theentry“Optionsprofile”inthesection“Profiles”showsatabcontrolwithalotofdifferent
GSCViewsettings.TobeabletoremotecontrolGSCViewtheoption“Remotecontrol”on
the“Actions”tabhastobeset.
────────────────────────────────────────────────────────────────────────────────
Page 12
────────────────────────────────────────────────────────────────────────────────
The“Viewerclientnumber”shouldbesettoaarbitraryglobalnumberthatisuniqueinthe
wholesystem.Thisglobal“Viewerclientnumber”identifiesthisspecialinstanceof
GSCViewinthewholenetwork.Thenumberisusedindifferentactionstoremotecontrol
GSCView.
Bycontrastthe“globalnumber”ofaviewerinacustomsceneidentifiesaspecialviewerin
auserdefinedscene.Detailsaboutuserdefinedsceneswillbetopicofthenextstep.
Step6:userdefinedscenes
TodefineuserdefinedscenesinGSCViewtheentry“Scenes”insection“Resources”
shouldbeselected.Byrightclickingononeofthepredefinedscenesnewuserdefined
scenescanbecreated.Forthisstepbystepexampletwonewsceneswiththenames
“MyStartScene”and“MyScene”havetobeadded.Withthebutton“Editscene”theglobal
numbersoftheviewersofthesceneandthevideochannelsthatshouldbedisplayedcanbe
set.
The“MyStartScene”shouldbebasedonthe“Matrix4x4”.Theviewersshouldhavethe
globalnumbers1001to1016.Eachviewershoulddisplaylivepicturesofavideochannelof
thelocalconnection.Thevideochannelscanbesetviadrag&dropwhileeditingthescene.
────────────────────────────────────────────────────────────────────────────────
Page 13
────────────────────────────────────────────────────────────────────────────────
The“MyScene”shouldbebasedonthe“Matrix2x2”andtheviewersshouldhavetheglobal
numbers1101to1104.Theviewersshouldnotautomaticallydisplayanyvideochannel.
Theywillbeusedbyspecialactionstodisplayvideochannels.
────────────────────────────────────────────────────────────────────────────────
Page 14
────────────────────────────────────────────────────────────────────────────────
Step7:modifytheappearanceofGSCView
TheappearanceofGSCViewcanbecontrolledbydifferentsettingsintheentry“Optionspro-
file”ofthesection“Profiles”.Forthistestscenario,GSCViewshouldappearasastupid
videowallwithoutanyusercontrolsdirectlyvisibleintheGSCViewapplicationwindow.To
achievethis,thefollowingoptionsonthe“Application”tabhavetobeset:
────────────────────────────────────────────────────────────────────────────────
Page 15
────────────────────────────────────────────────────────────────────────────────
Pleasekeepinmind,thatiftheoption“Sensitiveareaenabled”isnotsetandifall“Hide…”
optionsareset,themainmenuofGSCViewonlycanbeaccessedbypressingF10!
Step8:saveall settings
Allsettingsshouldbesavedbyselectingthemenuentry“FileSave”.
Step9:testthesystemwithGSCPLCSimulator
AfterrestartingGSCViewitshouldappearinfullmodewith16viewersdisplayinglivepic-
turesofthevideochannelsofthelocalconnection.
────────────────────────────────────────────────────────────────────────────────
Page 16
────────────────────────────────────────────────────────────────────────────────
Nowstartthesoftware“\BIN\GSCPLCSimulator.exe”totestthesystem.The
GSCPLCSimulatorservesasamonitoringtoolforallmessages(actions)andeventsthat
aretransportedinsidethecompletesystem.Furthermoreactionscanbetriggeredand
eventscanbestartedandstopped.
Afteritsstarttheconnectiontothelocalservershouldbebuildupautomaticallyandall
actiontrafficisdisplayedinalist.
────────────────────────────────────────────────────────────────────────────────
Page 17
────────────────────────────────────────────────────────────────────────────────
Withthebutton“Dialog”anactioncanbeselectedandwiththebutton“Send”thisactioncan
besendtotheGeViScopeserver.Fortestingthesystemfirstselecttheaction“VCchange
scenebyname”inthecategory“Vieweractions”todisplay“MyScene”ontheGSCView
withtheglobal“Viewerclientnumber”1000.
────────────────────────────────────────────────────────────────────────────────
Page 18
────────────────────────────────────────────────────────────────────────────────
Aftersendingtheaction,GSCViewshoulddisplayan“empty”“MyScene”.
────────────────────────────────────────────────────────────────────────────────
Page 19
────────────────────────────────────────────────────────────────────────────────
Todisplayvideochannelsintheviewersof“MyScene”theaction“Viewerconnectlive”can
beused.Theparameter“viewer”nowmeanstheglobalnumberofaviewerof“MyScene”,
e.g.1102.Theparameter“channel”shouldbesettotheglobalnumberofthevideochannel
thatshouldbedisplayed,e.g.2.
────────────────────────────────────────────────────────────────────────────────
Page 20
────────────────────────────────────────────────────────────────────────────────
Aftersendingtheaction,GSCViewdisplayslivevideoofthevideochannel2ontheupper
leftviewerinGSCView.