# Switching Platform Editor

URL: https://irs.systems/en/docs/switching-platform/switching-platform-editor

## Switching Platform Editor SW

- Access levels operator and developer by password (customer defined)
- Easy Configuration (drag and drop) of SP-Module population and configuration
- Auto-Setup functionality of connected and detected SP-Modules
- Definition of Alias-Names for switching channels and switching groups
- Access to modules EEPROM for custom defined specific data
- Testpanels to show switching states and ADC values and allow manual switching
- Execution of SP-Modules selftest incl. report (not all modules provide selftest)
- System settings (e.g. custom ID for SP modules)
- Project file definition for integration in Test Sequences
- 100% multithreading functionality support on Module level (threads access dedicated SP-Modules without resource sharing)
- .NET library (.NET Framework 4.6.2) and CVI wrapper function

## Switching Platform Startup

![Starting the SP software, login as Developer, adding a rack and selecting a template](/docs/assets/switching-platform/images/sp-editor-startup.png)

1. Start SP software via desktop icon
2. Login as „Developer“: basic PW setting is empty (no password set)
3. Add Rack via icon or menu *Rack – Add* to start with configuration of project
4. Select template (e.g. *SP-400*, *SP-1200*). IP-Address standard value: **`192.168.111.0`**

> **Note**
> „Administrator“ is reserved for IRS internal. Set PC side IP to e.g. **`192.168.111.250`**.

## Database Reference

In top menu select *Database – Update / Import*, browse and select the `*.spm` database file. Then press the “open” button and confirm the update.

Verify Database version in top menu *Database – Show Version*.

![Database update and import dialog, confirmation and database version info](/docs/assets/switching-platform/images/sp-editor-database.png)

## SP Mainframe Population

![SP Editor main window with tree view, slots of the selected mainframe and module database list](/docs/assets/switching-platform/images/sp-editor-population.png)

- Connect / Disconnect the selected mainframe
- Tree view of complete topology
- Configured SP-Modules vs. detected SP-Modules
- All available SP-Modules acc. referenced database file
- All available slots for selected mainframe
- Drag & Drop to populate / configure the slots with SP-Modules

## SP Mainframe Slot Properties

![Slot properties of slot 2 with controller options and device information of the SPC-64 µC card](/docs/assets/switching-platform/images/sp-editor-slot-properties.png)

- Shows all setting options of selected slot (here: slot 2)
- When connected: slots turn to green if detected modules align with project configuration (Setup = Detected)
- Options for SPC-64 µC card in slot #2
- Shows slot related properties (depends on populated module type)
- General Information about SPC-64 µC card
- Each SP-64 µC card can switch Fans *On/Off* (note: can be switched manually)

## Auto Setup & Update Downloader

![Menu Rack – Auto Setup and menu Help – Update Downloader with the application downloader window](/docs/assets/switching-platform/images/sp-editor-auto-setup.png)

Use *Rack – Auto Setup* to detect automatically all populated SP-Modules and create configuration within few seconds.

Use *Help – Update Downloader* to connect to IRS Server and download all available SW releases.

## Test Panels & Selftest

> **Warning**
> User is responsible for manual switching!

![Test panels for a selected slot and test execution report of a selftest](/docs/assets/switching-platform/images/sp-editor-test-panels.png)

- Testpanel available for *Developer* access
- Test Panel for selected slot, multiple Testpanels at same time
- Manual switching of SP-Module channels
- Displaying switching state for debugging „Live View“
- Most modules provide internal selftest incl. report protocol
- Complete rack selftest of all populated modules within few seconds

## Project File & Configuration Report

![Project menu and configuration report listing SPC controllers and SPM modules](/docs/assets/switching-platform/images/sp-editor-config-report.png)

- Project file create, open and save menu: Required for TestStand Initialisation and API functions
- Generates a project configuration report to identify and list all components
- SPC – Controller: SNr., Firmware and HW ID
- SPM – Modules: configured type (project file), detected type, SNr.

## Request Builder

![Opening the Request Builder from the Platform menu and the Request Builder window with tree view](/docs/assets/switching-platform/images/sp-request-builder-overview.png)

- Integrated assistance for configured modules
- Shows all possible commands and options
- Easy creation of command strings
- Copy to clipboard in different formats
- Tree view for all configured mainframes and their used (setup) slots
- For each slot all possible options and functional groups are visible

![Request Builder: selecting slot, functional group and command, filling parameters](/docs/assets/switching-platform/images/sp-request-builder-command.png)

1. Select slot, functional group; choose available command incl. short description
2. Command & parameters; modify array size via right mouse button
3. Fill parameters with available resources; command & parameter string

![Request Builder: executing a command and copying it to the clipboard in different formats](/docs/assets/switching-platform/images/sp-request-builder-copy.png)

1. Execute command directly and immediately to a connected mainframe
2. Copy in different formats to clipboard to transfer easy and safe to other SW:

```text
"/SP1200_0/3/Relay", "Switch", "LC1,LC1-SENSE1,LC4,True,False,True"
```

## Documentation

![Switching Platform documentation viewer with datasheets, version history and API documentation](/docs/assets/switching-platform/images/sp-editor-documentation.png)

1. Open Documentation: *Help - Documentation*
2. View Datasheets & Version History
3. Tree view of API Classes & Methods
4. Syntax description of methods & their parameters