14893e62a5
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>
139 lines
4.0 KiB
Markdown
139 lines
4.0 KiB
Markdown
# .NET Installation Guide for GeViScopeConfigReader
|
|
|
|
## What You Need to Install
|
|
|
|
To build the GeViScopeConfigReader project, you need:
|
|
|
|
1. **.NET SDK 8.0** (or .NET SDK 6.0+)
|
|
2. **.NET Framework 4.8 Developer Pack**
|
|
|
|
## Installation Steps
|
|
|
|
### Option A: Manual Download (Recommended)
|
|
|
|
#### Step 1: Install .NET SDK 8.0
|
|
|
|
1. Go to: https://dotnet.microsoft.com/download/dotnet/8.0
|
|
2. Under ".NET SDK 8.0.x", click **Download .NET SDK x64** for Windows
|
|
3. Run the installer (dotnet-sdk-8.0.xxx-win-x64.exe)
|
|
4. Follow the installation wizard
|
|
5. Click "Install" and wait for completion
|
|
|
|
**Direct download link:**
|
|
https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-8.0.404-windows-x64-installer
|
|
|
|
#### Step 2: Install .NET Framework 4.8 Developer Pack
|
|
|
|
1. Go to: https://dotnet.microsoft.com/download/dotnet-framework/net48
|
|
2. Under "Developer Pack", click **Download .NET Framework 4.8 Developer Pack**
|
|
3. Run the installer (ndp48-devpack-enu.exe)
|
|
4. Follow the installation wizard
|
|
5. Click "Install" and wait for completion
|
|
|
|
**Direct download link:**
|
|
https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net48-developer-pack-offline-installer
|
|
|
|
### Option B: Visual Studio 2022 Community (Full IDE)
|
|
|
|
If you prefer a full IDE with all tools integrated:
|
|
|
|
1. Go to: https://visualstudio.microsoft.com/downloads/
|
|
2. Download **Visual Studio 2022 Community** (free)
|
|
3. Run the installer
|
|
4. In the workload selection, choose:
|
|
- ✓ **.NET desktop development**
|
|
5. Click "Install"
|
|
|
|
This option includes everything: .NET SDK, .NET Framework targeting packs, MSBuild, and a full IDE.
|
|
|
|
## Verify Installation
|
|
|
|
After installing, close and reopen your terminal, then run:
|
|
|
|
```cmd
|
|
dotnet --version
|
|
```
|
|
|
|
You should see output like: `8.0.404` or similar
|
|
|
|
## Build the Project
|
|
|
|
Once installed, navigate to the project and build:
|
|
|
|
```cmd
|
|
cd C:\DEV\COPILOT\geutebruck-api\GeViScopeConfigReader
|
|
dotnet build
|
|
```
|
|
|
|
If successful, you'll see:
|
|
```
|
|
Build succeeded.
|
|
0 Warning(s)
|
|
0 Error(s)
|
|
```
|
|
|
|
The executable will be at:
|
|
```
|
|
C:\DEV\COPILOT\geutebruck-api\GeViScopeConfigReader\bin\Debug\net48\GeViScopeConfigReader.exe
|
|
```
|
|
|
|
## Run the Application
|
|
|
|
### Step 1: Start GeViScope Server
|
|
|
|
```cmd
|
|
cd "C:\Program Files (x86)\GeViScopeSDK\BIN"
|
|
GSCServer.exe
|
|
```
|
|
|
|
Leave this running in the background.
|
|
|
|
### Step 2: Run the Configuration Reader
|
|
|
|
```cmd
|
|
cd C:\DEV\COPILOT\geutebruck-api\GeViScopeConfigReader\bin\Debug\net48
|
|
GeViScopeConfigReader.exe
|
|
```
|
|
|
|
Or with custom parameters:
|
|
```cmd
|
|
GeViScopeConfigReader.exe localhost sysadmin masterkey output.json
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### "dotnet command not found" after installation
|
|
|
|
- Close and reopen your terminal/PowerShell
|
|
- The installer adds dotnet to your PATH, but you need a fresh session
|
|
|
|
### "Could not find SDK for TargetFramework '.NETFramework,Version=v4.8'"
|
|
|
|
- Install .NET Framework 4.8 Developer Pack (Step 2 above)
|
|
- The SDK alone is not enough - you need the targeting pack
|
|
|
|
### Build errors about missing DLLs
|
|
|
|
- Ensure GeViScope SDK is installed at: `C:\Program Files (x86)\GeViScopeSDK\`
|
|
- Check that these DLLs exist:
|
|
- `C:\Program Files (x86)\GeViScopeSDK\BIN\GscDBINET_4_0.dll`
|
|
- `C:\Program Files (x86)\GeViScopeSDK\BIN\GscExceptionsNET_4_0.dll`
|
|
|
|
## Quick Links
|
|
|
|
- .NET SDK 8.0: https://dotnet.microsoft.com/download/dotnet/8.0
|
|
- .NET Framework 4.8 Developer Pack: https://dotnet.microsoft.com/download/dotnet-framework/net48
|
|
- Visual Studio 2022: https://visualstudio.microsoft.com/downloads/
|
|
- GeViScope SDK Documentation: `C:\Program Files (x86)\GeViScopeSDK\Documentation\`
|
|
|
|
## Next Steps After Building
|
|
|
|
1. **Test the application** - Connect to your GeViScope server and export configuration
|
|
2. **Examine the JSON output** - Review the exported configuration file
|
|
3. **Modify as needed** - Edit Program.cs to add custom features
|
|
4. **Create similar tool for GeViSoft** - Use Access database connection
|
|
|
|
---
|
|
|
|
**Recommendation**: For quickest setup, use Option A (Manual Download). It takes about 5-10 minutes total and gives you command-line build tools without the overhead of Visual Studio.
|