KB: Troubleshooting Allegro Design Import in Altium Designer

Altium Designer Altium Designer
Importing Allegro design files into Altium Designer requires converting Allegro binary *.brd or *.dra files into ASCII *.alg format using the Cadence utility extracta.exe. This utility is part of Allegro, requires a valid license, and must be locally accessible. When Altium Designer and Allegro are installed on the same system, conversion can be performed automatically once required environment variables are configured correctly. If Allegro is installed on a separate machine or conversion fails, a manual workflow can be used. Starting with AD 26.1, the manual workflow has been simplified because the Allegro2Altium.bat file now includes all required extraction definitions internally, eliminating the need for additional configuration files. After conversion, the ASCII file can be imported into Altium Designer using the Import Wizard.

Solution Details

Typical failures during Allegro imports

Users may encounter issues when importing Allegro *.brd or *.dra files into Altium Designer. Common symptoms include timeout errors such as Cadence Allegro extracta.exe has timed out, unable to continue translation, failed imports, or the inability to convert binary Allegro files into a format that Altium Designer can process. These issues are commonly associated with missing Allegro utilities, incorrect environment variable configuration, expired Allegro licenses, or large design files. Altium Designer supports importing Allegro binary and ASCII files up to Allegro version 17.4

Dependency on Allegro conversion utilities

Altium Designer ultimately requires Allegro ASCII (*.alg) files for import. Binary Allegro files must first be converted using extracta.exe, which is installed as part of Allegro and depends on a valid Allegro license. Because these utilities and supporting DLLs cannot be redistributed with Altium Designer, the conversion must occur on a system where Allegro is installed. Once the design has been converted to ASCII format, the resulting *.alg file can be imported into Altium Designer without requiring Allegro on that machine.

Conversion workflow overview

  • Option 1 – Automatic Conversion: Use when Allegro and Altium Designer are installed and licensed on the same machine.
  • Option 2 – Manual Conversion: Use when Allegro is installed on a different machine or the automatic conversion fails. Workflow differs depending on Altium version:
    • AD 26.1 and Later: The Allegro2Altium.bat file is self-contained and no additional extraction definition files are required.
    • Before AD 26.1: The conversion process requires additional configuration files such as AllegroExportViews.txt and AllegroPackageExportViews.txt.
  • If no system with Allegro installed is available, consider contacting an Altium Service Bureau that offers Allegro conversion services.

Conversion and import steps

Option 1: Automatic Conversion (Allegro and Altium Designer installed on the same machine)

  1. Confirm Allegro is installed (e.g., C:\Cadence\SPB_17.2).
  2. Open the Start menu and select Settings.
  3. Navigate to System » About
  4. Under Device specifications, select Advanced system settings.
  5. In the Systems Properties dialog, Environment Variables....
    System Properties dialog on the Advanced tab, showing administrator notice and settings sections, with Environment Variables as the next option to select. 
  6. In the Systems Variables section, select the Path variable and click Edit.
    Environment Variables dialog showing System variables, with Path selected and the Edit button as the next action. 
  7.  Add the required Allegro installation paths:

    C:\Cadence\SPB_17.2\tools\bin
    C:\Cadence\SPB_17.2\tools\pspice
    C:\Cadence\SPB_17.2\tools\capture
    C:\Cadence\SPB_17.2\tools\pcb\bin
    C:\Cadence\SPB_17.2\OpenAccess\bin\x64\opt

    Edit environment variable dialog showing Path entries, with New button available and Cadence SPB_17.2 tool paths listed near the end. 
  8. Create a system variable:
    Name: CDSROOT
    Value: C:\Cadence\SPB_17.2 (or your installed version)

    Environment Variables dialog showing System variables, with Path selected and New button ready to add a new system variable.

    New System Variable dialog showing variable name CDSROOT and value C:\Cadence\SPB_17.2, with OK as the next action.

  9. Verify configuration in Command Prompt:
    echo %CDSROOT%
    echo %PATH%
  10. Restart the PC.
  11. In Altium Designer, go to File » Import Wizard.
  12. Select Allegro Design Files and add the *.brd file.
  13. Proceed through the wizard and configure options.
  14. Carefully verify layer mapping, including stackup, plane layers, and mechanical layers.
  15. Finish the wizard and verify the generated .PcbDoc.

Option 2: Manual Conversion Using Allegro2Altium.bat

  1. Prepare files for conversion:
    • Copy the Allegro design file (*.brd or *.dra).
    • Copy Allegro2Altium.bat from the Altium installation folder
      (e.g., C:\Program Files\Altium\AD26.8.1\System)
    • For versions prior to AD 26.1: also copy:
      • AllegroExportViews.txt
      • AllegroPackageExportViews.txt
  2. Place all files in a working folder on a machine where Allegro (with extracta.exe) is installed.
  3. Open Command Prompt and navigate to the working folder:

    cd C:\WorkingFolder

  4. Run the conversion:

    Allegro2Altium PCBName.brd

  5. Wait for completion. Output files include:
    • PCBName.brd.alg
    • extract.log
  6. Review extract.log if errors occur.
  7. Copy the generated *.alg file to the machine running Altium Designer for import.
  8. Launch Altium Designer, select File » Import Wizard, and click NEXT on the Welcome page. 

    Altium Designer Import Wizard start page, explaining the wizard converts files from other vendors to Altium Designer files, with Next as the available action.

  9. Select Allegro Design Files in the Select Type of Files to Import dialog and click Next.

    Altium Designer Import Wizard on Select Type of Files to Import, with Allegro Design Files selected and Next available to continue.

  10. In the Importing Allegro Designs dialog, click Add. Browse to the location of the Allegro design file (*.alg), select the file, and click Open.

    Altium Allegro Import Wizard with Load Allegro Design Files dialog open, showing Galileo_G87173_204.brd selected and Open available to add the design file.

  11. Verify that the correct file is listed and click Next.

    Altium Allegro Import Wizard showing the selected Galileo_G87173_204.brd file added to Allegro Design Files, with Next available to proceed.

  12. If available, add the Allegro Constraint Manager .DCFX file by clicking Add, browsing to the file location, selecting the file, and clicking Open. Click Next to continue.

    Altium Allegro Import Wizard on Constraints for Allegro designs, showing an empty Allegro Constraints Files list and Next available to continue without adding constraints.

  13. Wait while Altium Designer analyzes the selected files. Progress is displayed in the Analyzing Files page. When the analysis is complete, the next page of the Import Wizard opens automatically.
  14. In the Reporting Options dialog, select any desired log files and click Next.

    Altium Allegro Import Wizard on Reporting Options, with Log All Errors, Log All Warnings, and Log All Events selected and Next available to continue.

  15. In the Default PCB Specific Options dialog, configure the desired settings for Polygon ConnectionsPlane Connections, and Auto-Generated Objects, then click Next.

    Altium Allegro Import Wizard on Default PCB Specific Options, showing relief polygon connect, direct plane connect, import copper pour cutouts, and optimize clearance rules selected, with Next available.

  16. In the Current PCB Layer Mappings dialog, review the layer mappings and make any necessary adjustments. To change a mapping, select the corresponding cell and choose the desired layer from the drop-down list. After verifying the mappings, click Next.

    Altium Allegro Import Wizard on Current PCB Layer Mappings, showing all layers mapped; GND is selected as Mid Layer 4 with Altium layer name GND, and Next available.

  17. In the Current PCB Options dialog, review the output project structure and specify the directory where the imported files will be created. Use the Browse Folder button to select the Project Output Directory. If necessary, click Menu to modify the project structure. Click Next to continue.

    Altium Allegro Import Wizard on Current PCB Options, showing project output directory for Galileo-Reference-Design, imported .brd mapped to a .PcbDoc, menu open, and Next available.

  18. Wait while Altium Designer generates the imported project. Progress is displayed in the import progress window. When the import is complete, click Finish to close the Allegro Import Wizard.

  19. After the import completes, review the translated design and verify that the Allegro design has been successfully converted into an Altium Designer .PcbDoc.

    Altium Designer PCB editor showing the imported Galileo_G87173_204 PCB open, with dense routed board layers displayed and the project file selected in the Projects panel.

Additional Notes

  • From AD 26.1 onward, the Allegro import workflow is simplified because the Allegro2Altium.bat file is self-contained and no longer depends on external configuration files. In earlier versions, matching configuration files were required and had to align with the tool version.

References

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.