Hardware configuration new - josalggui/MaRGE GitHub Wiki

System Configuration Notes

This section describes how to set up the system when running MaRGE for the first time. Currently, this tool is only available in the GUI branch, with a planned release to the master branch soon. Before proceeding, ensure that the Red Pitayas are configured properly by following this guide.

First Launch of MaRGE

When you open MaRGE for the first time, the new session window appears:

Session_01

This window contains three key widgets:

  1. Scanner Checks – Displays missing configuration files.
  2. Information Area – Shows real-time system information.
  3. Session Tabs – Allows users to configure session parameters.

On the initial launch, you will notice:

  1. Errors displayed in the information area.
  2. Unchecked scanner checks.
  3. Disabled Run Main GUI buttons.

These issues stem from missing configuration files. This guide explains how to set them up properly.

Configuring the System Files

MaRGE requires the following eight elements to be configured upon first use:

  1. Projects
  2. Study Cases
  3. Gradient Hardware
  4. MaRCoS
  5. RF Configuration
  6. Red Pitaya IPs
  7. RF Coils
  8. Other Hardware Components

Setting Up Projects and Study Cases

To configure a project or study case:

  1. Click on the Project/Study box.
  2. The box will be empty initially. Click Add/Delete to create a new entry.
  3. A pop-up window appears where you can type the project/study name.
    • Entering an existing name deletes that project/study.

Session_02

Once added, clicking Update Scanner Hardware in the session toolbar should check off Projects and Study Cases.

Session_03

Configuring the Console and Red Pitayas

To configure the console and Red Pitayas:

  1. Navigate to the Console tab.

Session_04

  1. Configure MaRCoS settings:
    • Red Pitaya Model: rp-122 or rp-125
    • Gradient Board Model: gpa-fhdo or ocra1
  2. Add the Red Pitaya IP (configured with a static IP):
    • Enter the IP in the IP box and click Add.
    • The new Red Pitaya appears in the console tab.
    • Add multiple Red Pitayas if needed (e.g., for MIMO applications).
  3. Click Save and then Update to finalize the setup.
    • MaRCoS and RP IPs should now be checked.

Session_05

RF Configuration and RF Coils

To set up the RF system:

  1. Go to the RF tab.

Session_06

  1. Define key parameters such as:
    • Gyromagnetic ratio
    • Larmor frequency
    • RF dead time
  2. Add RF coils:
    • Enter the RF coil ID and its RF efficiency.
    • Click Add to include it in the configuration.
  3. Click Save and Update.
    • RFs and RF Coils should now be checked.
    • Added RF coils will appear in the selection box of the Session tab.

Session_07

Configuring Gradients and Other Hardware

In the Gradients and Others tabs:

  1. Complete the configuration fields based on your hardware setup.
  2. Click Save and then Update.

Once all elements are configured:

  • All checks should be marked.
  • A READY message appears in the information console.
  • The Run Main GUI button becomes available.

Session_08

Each time MaRGE is opened, the configuration is automatically loaded, allowing the user to proceed directly to the main window. The configuration can be modified and updated at any time to run the scanner with new parameters.