top: Initial commit.

Signed-off-by: Damien George <[email protected]>

Author: dpgeorge

README.md

@@ -0,0 +1,26 @@
+Alif Security Toolkit
+=====================
+
+This repository contains a copy of the Alif Security Toolkit, for Alif
+Semiconductor microcontrollers.  Minor changes are applied to the Toolkit to
+make it easier to use within a wider project.
+
+The "vendor" branch contains the original Toolkit source and is updated from
+time-to-time when new versions become available.  The commits in the "vendor"
+branch are tagged as appropriate with a tag that describes the Toolkit release
+at that commit, for example v1.104.0.
+
+There are then working branches that branch at a given vendor tag and apply
+minor patches to the vendor code, for example work-v1.104.0.  The commits that
+form a given working branch are reapplied (with conflict resolution) to newer
+vendor tags to create the next working branch.
+
+Original sources
+================
+
+The sources are obtained from Alif Semiconductor, and placed in the `toolkit`
+directory.
+
+The provided `fetch_from_upstream.sh` script can be used to copy and process a
+new Toolkit release into this repository.  It does some cleaning and formatting
+of the Toolkit source files to make them more uniform.

fetch_from_upstream.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+#
+# Fetch new code for the Alif Security Toolkit, and clean it up a little.
+
+if [ $# -ne 1 ]; then
+    echo "usage: $0 <src>"
+    echo ""
+    echo "eg: $0 path/to/app-release"
+    exit 1
+fi
+
+alifsrc=$1
+alifdest=./toolkit/
+
+if [ ! -f $alifsrc/maintenance.py ]; then
+    echo "ERROR: $alifsrc does not contain an Alif Security Toolkit"
+    exit 1
+fi
+
+# Remove any old files and copy across the new ones.
+echo "Fetching Alif Security Toolkit"
+rm -rf $alifdest
+mkdir -p $alifdest
+cp -r $alifsrc/* $alifdest
+
+# Remove __pycache__.
+rm -rf `find $alifdest -name __pycache__`
+
+# Convert newlines to Unix style, and ensure there's a newline at the end of the file.
+for file in `find $alifdest -regex '.+\.\(py\|txt\|json\)'`; do
+    cat $file | sed 's/$//' | sed '$a\' > tmp$$
+    /bin/mv tmp$$ $file
+done
+
+# Make sure permission flags are sensible.
+for file in `find $alifdest -type f`; do
+    if grep -q argparse $file; then
+        chmod 755 $file
+    else
+        chmod 644 $file
+    fi
+done
+
+# Format Python code.
+ruff format `find $alifdest -name \*.py`