S1130

IBM 1130 Emulator in C#

This is an IBM 1130 emulator modified to build and run with .NET Core, compatible with Linux, Mac, and Windows.

The emulator provides a complete IBM 1130 system simulation including:

• CPU instruction set implementation
• IBM 1130 Assembler
• Device emulation (2501 card reader, 1442 card read/punch, 2310 disk drive)
• Memory management
• Interrupt handling

Getting Started

Prerequisites

• .NET 10.0 SDK (version 10.0.0 or later as specified in global.json)
• A C# compatible IDE or text editor

Building the Project

1. Clone the repository:

   git clone https://github.com/semuhphor/S1130.git
   cd S1130

2. Restore dependencies and build:

   dotnet build

Running Tests

Execute the comprehensive test suite:

dotnet test

The project includes 419 unit tests covering CPU instructions, device operations, assembler functionality, and system integration scenarios. Test execution typically completes in under 2 seconds.

Test Output

• Passed/Failed/Skipped counts: Summary of test execution results
• Performance metrics: The test suite includes performance benchmarks (e.g., "1M Instructions in 1000ms")
• Coverage: Tests validate instruction execution, device behavior, and edge cases

Project Status

• ✅ CPU Core: Fully functional instruction set implementation
• ✅ IBM 1130 Assembler: Fully implemented with comprehensive syntax support
• ✅ 2501 Card Reader: Complete block-mode device with test coverage
• ✅ 1442 Card Read Punch: Complete character-mode device with test coverage
• 🚧 2310 Disk Drive: Partial implementation in progress
• ✅ Web API: Backend API for remote emulator access
• ✅ React Frontend: Web-based interface for the emulator

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines on:

• Code style and conventions
• Testing requirements
• Pull request process

Development Guidelines

• Test-Driven Development: All new code should include comprehensive unit tests
• Documentation: Public APIs should include XML documentation comments
• Error Handling: Exception-prone areas require robust error handling and clear failure modes

Useful Links

• Getting started with .NET Core
• Unit testing with .NET Core
• IBM 1130 Documentation (Historical reference)

License

This project maintains the original licensing terms. Please see the repository for specific license information.

---

Thanks,
Bob Flanders and contributors

Run locally

The project includes a backend Web API and an optional React frontend. Here are the steps to run both locally on Windows PowerShell.

Prerequisites:

• .NET 10 SDK (global.json pins 10.0.0)
• Node.js and npm (only required for the frontend)

Run the backend (Web API):

dotnet restore
dotnet build
dotnet run --project src\S1130.WebApi\S1130.WebApi.csproj

By default the API listens on http://localhost:5000. You can configure the frontend to point to a different URL via the environment variable REACT_APP_API_URL.

Run the frontend (optional):

cd web-frontend
npm ci      # or npm install
npm start

Build the frontend for production:

cd web-frontend
npm run build

Run tests for the backend and frontend:

dotnet test
cd web-frontend; npm test

Optional: use Docker to build images defined in docker-compose.yml (if present).