set write permisison

.github/workflows/build_documentation.yml

@@ -0,0 +1,91 @@
+name: Build and upload Documentation 
+
+on: 
+    workflow_dispatch: 
+    push: # Only for Testing change later 
+
+
+env: 
+    BUILD_TYPE: RELEASE 
+
+permissions:
+  contents: write  # Required to push to gh-pages branch
+  pages: write     # Required for GitHub Pages deployment
+  id-token: write  # Required for GitHub Pages deployment
+
+jobs:
+    build-and-deploy:
+        strategy: 
+            matrix:
+                patform: [ubuntu-latest]
+                python-version: ["3.12"]
+        runs-on: ${{ matrix.patform }}
+
+        defaults:
+            run:
+                shell: "bash -l {0}"
+
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                fetch-depth: 0  # Fetch all history for proper git operations
+                token: ${{ secrets.GITHUB_TOKEN }}  # Use the default token
+
+            - name: Install System Packages
+              uses: awalsh128/cache-apt-pkgs-action@latest
+              with:
+                packages: libhdf5-dev doxygen
+                version: 1.0
+
+            - name: Setup Python
+              uses: actions/setup-python@v5
+              with:
+                python-version: 3.12
+                cache: 'pip'
+            - name: Install Python Packages
+              run: pip install sphinx sphinx_rtd_theme breathe
+               
+
+            - name: Build Documentation
+              run: |
+                mkdir build
+                cd build
+                cmake -DCMAKE_BUILD_TYPE=${{env.BUILD_TYPE}} -DSLS_BUILD_DOCS=ON -DSLS_USE_HDF5=ON -DSLS_USE_PYTHON=ON ..
+                make -j4 
+                make docs
+
+            - name: Upload Documentation Artifact
+              uses: actions/upload-pages-artifact@v4
+              with:
+                path: build/docs/html # maybe we need to upload images as well - so one can click on them? 
+        
+            - name: Checkout gh-pages
+              uses: actions/checkout@v4
+              with:
+                ref: gh-pages
+                path: gh-pages
+                
+            - name: Copy documentation to gh-pages # create folder structure 
+              run: cp -r build/docs/html/. gh-pages/
+              
+            - name: Commit and Push changes to gh-pages
+              run: |
+                cd gh-pages
+                git config --global user.name 'github-actions'
+                git config --global user.email 'github-actions@github.com'
+                git add .
+                git commit -m "Update Documentation"
+                git remote set-url origin https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git
+                git push origin gh-pages 
+              env: 
+                GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+
+
+
+
+
+
+
+
+

.github/workflows/cmake.yaml

@@ -1,6 +1,6 @@
 name: Native CMake Build
 
-on: [push, pull_request]
+on: [pull_request] # [push, pull_request] 
 
 env:
   # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
@@ -29,7 +29,7 @@ jobs:
       - name: Configure CMake
         # Configure CMake in a 'build' subdirectory. `CMAKE_BUILD_TYPE` is only required if you are using a single-configuration generator such as make.
         # See https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html?highlight=cmake_build_type
-        run: cmake -B ${{github.workspace}}/build -DCMAKE_BUILD_TYPE=${{env.BUILD_TYPE}} -DSLS_USE_TESTS=ON -DSLS_USE_HDF5=ON -DSLS_USE_GUI=ON -DSLS_USE_MOENCH=ON -DSLS_USE_PYTHON=ON
+        run: cmake -B ${{github.workspace}}/build -DCMAKE_BUILD_TYPE=${{env.BUILD_TYPE}} -DSLS_USE_TESTS=ON -DSLS_USE_HDF5=ON -DSLS_USE_GUI=ON -DSLS_USE_MOENCH=ON -DSLS_USE_PYTHON=ON 
 
       - name: Build
         # Build your program with the given configuration
@@ -45,3 +45,8 @@ jobs:
           python -m pytest ${{github.workspace}}/python/tests
 
 
+  
+      
+
+
+

etc/gh-workflow-conda-env.yml

@@ -0,0 +1,9 @@
+name: githib-workflow-environment 
+channels:
+  - conda-forge
+dependencies:
+  - doxygen
+  - sphinx
+  - breathe
+  - sphinx_rtd_theme
+  

slsDetectorServers/xilinx_ctbDetectorServer/chip_config_xilinx.txt

@@ -1 +1,24 @@
-# nothing
+# Prepare MH02 configuration
+reg 0xC00C 0x00040041
+reg 0xC010 0x01200004
+
+# configure Matterhorn SPI
+setbit 0xC014 0
+
+# wait till config is done
+pollbit 0xC014 3 0
+
+# reset transceiver
+reg 0xC120 0x0
+reg 0xC120 0x1
+reg 0xC120 0x0
+
+# set MSB LSB inversions and polarity for transceiver
+reg 0xC120 0x1e0
+
+# Enable MH02 PLL clock
+pattern enable_clock_pattern.pyat
+# start the flow
+setbit 0xB030 0
+clearbit 0xB030 0
+sleep 1

slsDetectorServers/xilinx_ctbDetectorServer/reset_chip_xilinx.txt

@@ -1,2 +1,39 @@
 
-# nothing
+# turn off clock
+clearbit 0xB018 15 
+setbit 0xB010 15
+sleep 1
+
+# reset Matterhorn periphery
+setbit 0xC014 1
+sleep 1
+
+# turn on clock
+clearbit 0xB010 15
+sleep 1
+
+# reset rx transceiver datapath
+setbit 0xC120 4
+sleep 1
+
+# reset 8b10b counters
+setbit 0xC120 9
+setbit 0xC120 10
+setbit 0xC120 11
+setbit 0xC120 12
+sleep 1
+clearbit 0xC120 9
+clearbit 0xC120 10
+
+# reset buffer fifos
+reg 0x9024 0xFFFFFFFF
+reg 0x9028 0xFFFFFFFF
+reg 0x902C 0xFFFFFFFF
+reg 0x9024 0x0
+reg 0x9028 0x0
+reg 0x902C 0x0
+setbit 0xA000 18
+
+# load default pattern
+pattern readout_pattern.pyat
+