Skip to content

PHASE0_README.md

Latest commit

 

History

History
95 lines (80 loc) · 3.99 KB

PHASE0_README.md

File metadata and controls

95 lines (80 loc) · 3.99 KB

GPUShare Project Scaffold - PHASE 0 Complete

This document provides instructions for opening and verifying the GPUShare project scaffold in OMNeT++ IDE.

Project Structure

gpu_share/
├── src/
│   ├── package.ned                         # Main package declaration
│   ├── gpu/
│   │   ├── package.ned                     # GPU subsystem package
│   │   ├── messages/
│   │   │   ├── package.ned                 # Message package
│   │   │   └── TestMessage.msg             # Basic test message
│   │   └── modules/
│   │       ├── package.ned                 # Module package  
│   │       ├── TestModule.ned              # Test module definition
│   │       └── TestModule.cc               # Test module implementation
│   ├── Module_1.cc                         # Existing simple module (kept)
│   └── Simple_Network.ned                  # Existing network (kept)
├── simulations/
│   ├── package.ned                         # Simulations package
│   ├── omnetpp.ini                         # General config (kept)
│   └── scaffold_test/                      # Note: underscore, not hyphen!
│       ├── package.ned                     # Test simulation package
│       ├── TestScaffold.ned                # Test network definition
│       └── omnetpp.ini                     # Test configuration
└── Makefile                                # Top-level makefile (kept)

OMNeT++ IDE Instructions

1. Open Project in OMNeT++ IDE

  • Launch OMNeT++ IDE
  • File → Import → General → Existing Projects into Workspace
  • Browse to: d:\omnetpp-6.2.0\samples\gpu_share
  • Select "gpu_share" project and click Finish

2. Build the Project

  • Right-click on "gpu_share" project in Project Explorer
  • Select "Build Project" or press Ctrl+B
  • The project should compile without errors

3. Run the Scaffold Test

  • Navigate to: simulations/scaffold_test/omnetpp.ini (note: underscore, not hyphen)
  • Right-click and select "Run As" → "OMNeT++ Simulation"
  • Select configuration: ScaffoldTest
  • Choose "Qtenv" for graphical interface
  • Click "Run"

Troubleshooting

Package Name Errors

If you see errors like "declared package does not match expected package":

  1. Refresh Project: Right-click project → Refresh (F5)
  2. Clean Build: Project → Clean → Select gpu_share → Clean
  3. Rebuild: Right-click project → Build Project
  4. Check Directory Names: Ensure simulations/scaffold_test/ uses underscore, not hyphen

OMNeT++ IDE Cache Issues

If the IDE still shows old references:

  1. Close OMNeT++ IDE completely
  2. Delete workspace cache: Delete .metadata folder in your workspace
  3. Restart IDE and re-import project
  4. Ensure NED path: Project Properties → OMNeT++ → NED Path includes both src and simulations

Expected Verification Results

Build Verification

✓ Project compiles without errors ✓ All .msg files generate corresponding _m.h and _m.cc files ✓ No missing imports or undefined references

Simulation Verification

✓ Network topology shows: testNode1 ↔ testNode2 ✓ Simulation runs for 10 seconds ✓ Event log shows message exchanges:

  • testNode1 sends "ping" at t=1.0s
  • testNode2 receives and responds with "pong" at t=1.5s
  • Pattern continues until messagesSent limit reached

Key Statistics/Signals to Observe

  • Event log messages: "TestModule testNode1 sent message #1", etc.
  • Message contents: "ping", "pong"
  • Sequence numbers increment correctly
  • Debug output shows module initialization

Package Organization

  • gpu_share: Root package for entire project
  • gpu_share.gpu: Core GPU sharing subsystem
  • gpu_share.gpu.messages: Protocol message definitions
  • gpu_share.gpu.modules: Module implementations
  • gpu_share.simulations.scaffold_test: Test scenarios

This scaffold provides the foundation for the remaining phases of the GPUShare project.