A GitHub Action to download and install Microchip XC compilers (xc8, xc16, xc32) for Linux on GitHub Actions Ubuntu runners. This action utilizes the GitHub Actions toolkit's tool cache feature for efficient caching and faster subsequent runs.

• 🚀 Automatic download and installation of Microchip XC compilers
• 💾 Built-in caching using GitHub Actions tool cache
• 🎯 Support for xc8, xc16, and xc32 compilers
• 📌 Version pinning for reproducible builds
• 🔧 Configurable installation directory
• 📤 Outputs installation paths for downstream jobs
• 🛠️ Automatic installation of required 32-bit libraries for 64-bit systems

• XC8: C compiler for 8-bit PIC and AVR microcontrollers
• XC16: C compiler for 16-bit PIC microcontrollers and dsPIC DSCs
• XC32: C/C++ compiler for 32-bit PIC and SAM microcontrollers

steps:
  - uses: actions/checkout@v6
  
  - name: Setup XC8 Compiler
    uses: usimd/setup-xc-action@v1
    with:
      compiler: 'xc8'
      version: '3.10'
  
  - name: Build with XC8
    run: |
      xc8-cc --version
      # Your build commands here

steps:
  - uses: actions/checkout@v6
  
  - name: Setup XC8
    uses: usimd/setup-xc-action@v1
    with:
      compiler: 'xc8'
      version: '3.10'
  
  - name: Setup XC16
    uses: usimd/setup-xc-action@v1
    with:
      compiler: 'xc16'
      version: '2.10'
  
  - name: Setup XC32
    uses: usimd/setup-xc-action@v1
    with:
      compiler: 'xc32'
      version: '5.00'

steps:
  - name: Setup XC32
    uses: usimd/setup-xc-action@v1
    with:
      compiler: 'xc32'
      version: '5.00'
      install-dir: '/usr/local/microchip'

steps:
  - name: Setup XC8
    id: setup-xc8
    uses: usimd/setup-xc-action@v1
    with:
      compiler: 'xc8'
      version: '3.10'
  
  - name: Display Installation Info
    run: |
      echo "Installed at: ${{ steps.setup-xc8.outputs.install-dir }}"
      echo "Compiler path: ${{ steps.setup-xc8.outputs.compiler-path }}"

1. Cache Check: First checks if the requested compiler version is already cached in the GitHub Actions tool cache
2. Prerequisites: Automatically installs required 32-bit libraries on 64-bit systems (see Microchip documentation)
   • libc6:i386
   • libx11-6:i386
   • libxext6:i386
   • libstdc++6:i386
   • libexpat1:i386
3. Download: If not cached, downloads the installer from Microchip's official website
4. Installation: Runs the installer in unattended mode with the specified installation directory
5. Caching: Caches the installed compiler for faster subsequent runs
6. PATH Update: Automatically adds the compiler's bin directory to the PATH
7. Verification: Verifies the installation was successful

The action supports downloading from official Microchip URLs. Current stable versions:

• XC8: v3.10
• XC16: v2.10
• XC32: v5.00

You can specify any version that follows Microchip's URL pattern. If a version doesn't exist, the action will fail with a clear error message.

• This action is designed for Linux runners only (Ubuntu)
• The action uses tool caching to speed up subsequent runs
• Installers are run in unattended mode
• The compiler bin directory is automatically added to PATH
• Installation requires write permissions to the installation directory

If the installation fails, verify:

1. The version number is correct and exists on Microchip's website
2. The runner has sufficient disk space
3. The installation directory is writable

If the compiler is not found in PATH after installation:

1. Check the action outputs for the correct paths
2. Verify the installation completed successfully
3. Try manually adding the path using the action outputs

MIT

Contributions are welcome! Please feel free to submit a Pull Request.