Socfpga 6.12.33 lts

.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# Specify reviewers for all files except the CODEOWNERS file
+* @rabara @ngboonkhai @tiensung @mtham2021 @hoyin0722 @tanmaykathpalia @kuhanh @rohangt07 @skarnan
+
+# Specify reviewers for the CODEOWNERS file
+/.github/CODEOWNERS @vvijayak-devops

.github/pull_request_template.md

@@ -0,0 +1,13 @@
+Description: <Description the change of this Pull Request. Include HSD#, related Pull Request>
+
+Impact Analysis:
+
+What is the scope of the change?
+<Is this something revolutionary and risky and challenging to manage, or will this be closer to business as usual or an evolutionary change?>
+
+Purpose of the change?
+<How clear is the outcome to be achieved? Has it been communicated, and are the objectives defined and achievable?>
+
+Reach of the change?
+<Will the change impact a single component or the impact to other components?>
+Regression Test result: <Regtest result link .>

.github/workflows/ci-pipeline.yml

@@ -0,0 +1,264 @@
+name: altera-linux-ci-pipeline
+###############################################################################
+# Altera SOCFPGA linux Build Pipeline
+###############################################################################
+
+on:
+  pull_request:
+     branches: [ "socfpga-*" ]
+     types: [opened, synchronize, reopened, review_requested, review_submission]
+
+  # Allows to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+defaults:
+  run:
+    shell: bash
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+#This action extracts the new commits and performs checkpatch checks on it.
+  ci-checkpatch:
+    runs-on: [self-hosted,pg-embedded-runner]
+    container:
+      image: amr-registry.sc.altera.com/pse-pswe-software-ba/embedded_coverity:ubuntu20.04.0_6-new-proxy-inbuilt
+      options: -v /mnt/nfs_share/site/proj/psg:/p/psg
+    # Check patch only can run at pull request as it is hard to determine the commit during the push event.
+    env:
+      GITHUB_EVENT_NAME: ${{ github.event_name }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # This will pull the whole repo, otherwise cannot compare commit.
+          ref: ${{ github.event.pull_request.base.ref }}
+
+      - name: Checkpatch.pl
+        run: |
+          git config --global --add safe.directory /__w/${{ github.event.repository.name }}/${{ github.event.repository.name }}
+          git clone https://${{ secrets.GIT_USER }}:${{ secrets.GIT_TOKEN }}@github.com/intel-sandbox/application.devops.github.pr.workflow
+          cd application.devops.github.pr.workflow
+          git checkout master
+          bash workflow_Checkpatch.sh ../ ${{ github.event.repository.name }} ${{ secrets.GITHUB_TOKEN }} ${{ github.event.pull_request.number }} ${{ github.head_ref }} ${{ github.base_ref }}
+
+  ci-coverity:
+    runs-on: [self-hosted,pg-embedded-runner]
+    container:
+        image: amr-registry.sc.altera.com/pse-pswe-software-ba/embedded_coverity:ubuntu20.04.0_6-new-proxy-inbuilt
+    env:
+      # Disable the warnings of Security violation. We need to check why this is trigger later, plaintext password.
+      EC_DISABLE_VAL: project,system
+
+    steps:
+      - uses: actions/checkout@v4
+      - name : Download coverity script
+        run: |
+          git config --global credential.helper store
+          git clone https://${{ secrets.GIT_USER }}:${{ secrets.GIT_TOKEN }}@github.com/intel-sandbox/application.devops.github.pr.workflow
+          cd application.devops.github.pr.workflow
+          git checkout master
+
+      - name : Setup Coverity
+        uses: intel-innersource/frameworks.actions.setup-coverity@v1
+        env:
+          https_proxy: proxy-dmz.intel.com:912 # If the self-hosted runner has issues with the proxy
+        with:
+          version: '2022.3.1'
+
+      - name: Run Coverity Build
+        run: |
+          cd application.devops.github.pr.workflow
+          bash workflow_Coverity.sh ${{ github.workspace }} ${{ github.event.repository.name }} linux-socfpga-github-workflow ${{ github.head_ref }} ${{ github.base_ref }}
+
+      - name: linux-coverity-prechange-report
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-coverity-prechange-report
+          path: linux_output_defect_prechange.json
+          retention-days: 1
+
+      - name: linux-coverity-postchange-report
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-coverity-postchange-report
+          path: linux_output_defect_postchange.json
+          retention-days: 1
+
+  ci-coverity-parse-result:
+    needs: ci-coverity
+    runs-on: [self-hosted,pg-embedded-runner]
+    container:
+        image: amr-registry.sc.altera.com/pse-pswe-software-ba/embedded_coverity:ubuntu20.04.0_6-new-proxy-inbuilt
+
+    steps:
+      - name: Download prechange coverity result
+        uses: actions/download-artifact@v4
+        with:
+          name: linux-coverity-prechange-report
+      - run: |
+          ls
+          pwd
+          rm -rf /tmp/coverity-result-json
+          mkdir /tmp/coverity-result-json
+          cp linux_output_defect_prechange.json /tmp/coverity-result-json/
+          ls /tmp/coverity-result-json/*
+
+      - name: Download postchange coverity result
+        uses: actions/download-artifact@v4
+        with:
+          name: linux-coverity-postchange-report
+      - run: |
+          cp linux_output_defect_postchange.json /tmp/coverity-result-json/
+          ls /tmp/coverity-result-json/*
+
+      - uses: actions/checkout@v4
+      - name : Download coverity parser script
+        run: |
+          git config --global credential.helper store
+          git clone https://${{ secrets.GIT_USER }}:${{ secrets.GIT_TOKEN }}@github.com/intel-sandbox/application.devops.github.pr.workflow
+          cd application.devops.github.pr.workflow
+          git checkout master
+
+      - name : Run Coverity Parser
+        run: |
+          cd application.devops.github.pr.workflow
+          mv /tmp/coverity-result-json/* .
+          rm -rf /tmp/coverity-result-json
+          bash workflow_Coverity_Parser.sh ${{ github.workspace }} ${{ github.event.repository.name }} ${{ secrets.GITHUB_TOKEN }} ${{ github.event.pull_request.number }}
+
+      - name: linux-coverity-report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-coverity-report
+          path: |
+            linux_output_defect.csv
+          retention-days: 1
+
+#This action performs a build test using an ubuntu container.
+  ci-build:
+    # The type of runner that the job will run on
+    runs-on: [self-hosted,pg-embedded-runner]
+    container:
+        image: amr-registry.sc.altera.com/pse-pswe-software-ba/embedded_coverity:ubuntu20.04.0_6-new-proxy-inbuilt
+    env:
+      # Disable the warnings of Security violation. We need to check why this is trigger later, plaintext password.
+      EC_DISABLE_VAL: project,system
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      - uses: actions/checkout@v4
+      - name: Linux Build
+        run: |
+          DIR=$(pwd)
+          git config --global credential.helper store
+          git clone https://${{ secrets.GIT_USER }}:${{ secrets.GIT_TOKEN }}@github.com/intel-sandbox/application.devops.github.pr.workflow
+          cd application.devops.github.pr.workflow
+          git checkout master
+          bash workflow_Build.sh $DIR ${{ github.event.repository.name }} linux-socfpga-github-workflow
+
+      - name: linux-image
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-image
+          path: ${{ github.workspace }}/linux_output.tar
+          retention-days: 1
+
+#This action runs the simic regression test
+  ci-verification:
+     runs-on: [self-hosted,linux-arc-runner]
+     needs: ci-build
+     env:
+      # Disable the warnings of Security violation. We need to check why this is trigger later, plaintext password.
+      EC_DISABLE_VAL: project,system
+      GITHUB_EVENT_NAME: ${{ github.event_name }}
+     steps:
+      - name: Cleaning workspace
+        run: |
+          rm -rf application.devops.github.pr.workflow
+          rm -rf ${GITHUB_WORKSPACE}/.git*
+
+      - name: Download linux artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: linux-image
+      - run: |
+          tar -xvf linux_output.tar
+          ls
+          pwd
+
+      - name: Simics Regtest
+        run: |
+          git clone https://github.com/intel-sandbox/application.devops.github.pr.workflow
+          cd application.devops.github.pr.workflow
+          git checkout master
+          bash workflow_Regtest.sh ${{ github.workspace }} ${{ github.event.repository.name }} ${{ github.event.pull_request.number }}
+
+#This action runs the on-board regression test
+  ci-on-board-verification:
+    runs-on: [self-hosted,linux-arc-runner]
+    needs: ci-build
+    env:
+      # Disable the warnings of Security violation. We need to check why this is trigger later, plaintext password.
+      EC_DISABLE_VAL: project,system
+      GITHUB_EVENT_NAME: ${{ github.event_name }}
+    steps:
+    - name: Cleaning workspace
+      run: |
+        rm -rf application.devops.github.pr.workflow
+        rm -rf ${GITHUB_WORKSPACE}/.git*
+
+    - name: Download linux artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: linux-image
+    - run: |
+        tar -xvf linux_output.tar
+        ls
+        pwd
+
+    - name: On-board Regtest
+      run: |
+        git clone https://github.com/intel-sandbox/application.devops.github.pr.workflow
+        cd application.devops.github.pr.workflow
+        git checkout master
+        bash workflow_On_Board_Regtest.sh ${{ github.workspace }} ${{ github.event.repository.name }} ${{ github.event.pull_request.number }}
+
+#This action checks if the branch has been released and if so block PR until approved by repo Admin
+  ci-check-tag:
+    runs-on: [self-hosted,pg-embedded-runner]
+    container:
+      image: amr-registry.sc.altera.com/pse-pswe-software-ba/embedded_coverity:ubuntu20.04.0_6-new-proxy-inbuilt
+      options: -v /mnt/nfs_share/site/proj/psg:/p/psg
+    env:
+      GITHUB_EVENT_NAME: ${{ github.event_name }}
+    steps:
+      - uses: actions/checkout@v4
+      - name : Download check_tag script
+        run: |
+          git config --global credential.helper store
+          git clone https://${{ secrets.GIT_USER }}:${{ secrets.GIT_TOKEN }}@github.com/intel-sandbox/application.devops.github.pr.workflow
+          cd application.devops.github.pr.workflow
+          git checkout master
+
+      - name: Check_Tag
+        run: |
+          cd application.devops.github.pr.workflow
+          bash workflow_Check_Tag.sh ${{ github.workspace }} ${{ github.event.repository.name }} ${{ github.event.pull_request.number }} ${{ github.base_ref }} ${{ secrets.GITHUB_TOKEN }}
+
+#This is the commit gate that ensures all required checks are passing before the PR is allowed to be merged.
+  ci-check-pr-status:
+    runs-on: [self-hosted,pg-embedded-runner]
+    container:
+      image: amr-registry.sc.altera.com/pse-pswe-software-ba/embedded_coverity:ubuntu20.04.0_6-new-proxy-inbuilt
+      options: -v /mnt/nfs_share/site/proj/psg:/p/psg
+    needs: [ci-coverity-parse-result, ci-verification, ci-checkpatch, ci-check-tag, ci-on-board-verification]
+    steps:
+     - name: On failure
+       if: ${{ needs.ci-coverity-parse-result.result != 'success' || needs.ci-verification.result != 'success' || needs.ci-checkpatch.result != 'success' || needs.ci-check-tag.result != 'success' || needs.ci-on-board-verification.result != 'success'}}
+       run: |
+          echo "Status check has failed."
+          exit 1

Documentation/devicetree/bindings/arm/altera/fpga-dma.txt

@@ -0,0 +1,25 @@
+Altera FPGA DMA FIFO driver
+
+Required properties:
+- compatible : "altr,fpga-dma";
+
+- reg : CSR and DATA register resource definitions (address and length).
+
+- reg-names : Names of the register resources.  Should be "csr", "data".
+
+- dmas : DMA request lines.  Should be <&pdma 0 &pdma 1>
+
+- dma-names : Names of DMA request lines. Should be "tx", "rx".
+
+Example:
+
+	fpgadma: fifo {
+		#address-cells = <1>;
+		#size-cells = <1>;
+		compatible = "altr,fpga-dma";
+		reg = <0xff230000 0x20>, <0xc0011000 0x400>;
+		reg-names = "csr", "data";
+		dmas = <&pdma 0 &pdma 1>;
+		dma-names = "tx", "rx";
+	};
+

Documentation/devicetree/bindings/arm/intel,socfpga.yaml

@@ -20,12 +20,18 @@ properties:
               - intel,n5x-socdk
               - intel,socfpga-agilex-n6000
               - intel,socfpga-agilex-socdk
+              - intel,socfpga-agilex5-socdk
           - const: intel,socfpga-agilex
       - description: Agilex5 boards
         items:
           - enum:
               - intel,socfpga-agilex5-socdk
           - const: intel,socfpga-agilex5
+      - description: Agilex3 boards
+        items:
+          - enum:
+              - intel,socfpga-agilex3-socdk
+          - const: intel,socfpga-agilex3
 
 additionalProperties: true
 

Documentation/devicetree/bindings/clock/intel,agilex5.yaml

@@ -0,0 +1,41 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/intel,agilex5.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Intel SoCFPGA Agilex5 platform clock controller binding
+
+maintainers:
+  - Teh Wen Ping <[email protected]>
+
+description:
+  The Intel Agilex5 Clock controller is an integrated clock controller, which
+  generates and supplies to all modules.
+
+properties:
+  compatible:
+    const: intel,agilex5-clkmgr
+
+  '#clock-cells':
+    const: 1
+
+  reg:
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+  - '#clock-cells'
+
+additionalProperties: false
+
+examples:
+  # Clock controller node:
+  - |
+    clkmgr: clock-controller@10d10000 {
+      compatible = "intel,agilex5-clkmgr";
+      reg = <0x10d10000 0x1000>;
+      #clock-cells = <1>;
+    };
+...

Documentation/devicetree/bindings/dma/snps,dw-axi-dmac.yaml

@@ -76,6 +76,11 @@ properties:
     $ref: /schemas/types.yaml#/definitions/uint32
     enum: [0, 1, 2, 3, 4, 5, 6]
 
+  snps,dma-40-bit-mask:
+    description: |
+      Sets dma bit-mask to 40 bits
+    type: boolean
+
   snps,priority:
     description: |
       Channel priority specifier associated with the DMA channels.