UCAP Node Manager

A comprehensive VS Code extension for managing local UCAP (Unified Control and Acquisition Platform) test nodes directly from your development environment.

🚀 Features

Node Management

• Start/Stop UCAP nodes with virtual environment selection
• Real-time process monitoring and health checking
• Comprehensive logging with output channels
• Node configuration presets for quick setup

Device Management

• Hierarchical TreeView (Node → Device → Process)
• Create devices from JSON configuration files
• Device lifecycle control (Start/Stop/Reload devices)
• Real-time process discovery using local-ucap utilities

Process Debugging

• Three-level process hierarchy visualization
• Python debugger integration with one-click attachment
• Multi-process debugging support
• Automatic process discovery by device name

UCAP Console Integration

• Direct UCAP Console launch from node context
• Expert mode activation with node pre-loaded
• External application management

📋 Requirements

• VS Code 1.74.0 or higher
• Python with local-ucap package installed
• Virtual environment with UCAP dependencies
• UCAP Console (for console integration feature)

🎯 Usage

1. Install the extension from VSIX file
2. Open Activity Bar and find "UCAP Node Manager"
3. Start a node using the "+" button
4. Manage devices by right-clicking nodes
5. Debug processes by expanding device trees
6. Open UCAP Console from node context menu

⚙️ Commands

• UCAP: Start UCAP Node - Create and start new node
• UCAP: Stop All Nodes - Stop all running nodes
• UCAP: Open Extension Settings - Configure extension
• UCAP: Export Node Configuration - Backup configurations
• UCAP: Create Node Preset - Save node templates

🔧 Configuration

Configure the extension through VS Code settings:

{
  "ucapNodeManager.defaultVenvPath": "/path/to/your/venv",
  "ucapNodeManager.defaultPort": 19042,
  "ucapNodeManager.autoRefresh": true,
  "ucapNodeManager.refreshInterval": 2000
}

📦 Installation

1. Download the .vsix file
2. Open VS Code
3. Go to Extensions view (Ctrl+Shift+X)
4. Click "..." menu → "Install from VSIX..."
5. Select the downloaded .vsix file

🐛 Issues & Support

For issues, feature requests, or questions, please contact the UCAP development team.

📜 License

Internal CERN tool - Not for external distribution.

Developed for OP usage of CERN UCAP Infrastructure Team