Initial contribution

.github/update_versions.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+SCRIPT=$(realpath -P $0)
+DIRNAME=$(dirname ${SCRIPT})
+
+VERSIONS=($(find -maxdepth 1  -mindepth 1 -type d) $(find -maxdepth 1 -mindepth 1 -type l))
+declare -A versions
+for folder in ${VERSIONS[*]#./}; do
+  if [ -f $folder/footer.js ]; then
+    version=$(grep "Version" $folder/footer.js | \
+              sed -r "s/.*'Version ([^']+)'.*/\1/" | \
+              sed -r "s/\+.*$//" | \
+              sed -r "s/([^0-9])$/\10/")
+    versions["$version"]="$folder"
+  fi
+done
+fields=()
+for version in $(IFS=$'\n'; sed -r 's/$/_/' <<< "${!versions[*]}" | sort -Vr | sed -r 's/_$//'); do
+    fields+=( "\"${versions[$version]}\": \"$version\"" )
+done
+
+echo "//--- list of versions ---" > version.js
+echo "const versions = {" >> version.js
+echo -n "    " >> version.js
+echo $(IFS=,; echo "${fields[*]}") | sed 's/,/,\n    /g'  >> version.js
+echo "}" >> version.js
+echo "//--- list of versions ---" >> version.js
+cat ${DIRNAME}/version.js.in >> version.js
+
+exit 0

.github/version.js.in

@@ -0,0 +1,56 @@
+
+var script = document.currentScript
+if (script && script.src) {
+  var scriptUrl = new URL(script.src);
+  var docUrl = new URL(document.URL);
+  var baseUrl = new URL(scriptUrl)
+  baseUrl.pathname = baseUrl.pathname.split('/').slice(0,-1).join("/")
+
+  function urlForVersion(url, version) {
+      url = new URL(url);
+      pathname = url.pathname.replace(baseUrl.pathname, "");
+      parts = pathname.split("/");
+      parts[1] = version;
+      url.pathname = baseUrl.pathname + parts.join("/");
+      return url
+  }
+
+  function writeVersionDropdown() {
+      currentVersion = document.currentScript.parentNode.innerText;
+      document.currentScript.parentNode.classList.add("dropdown");
+      document.currentScript.parentNode.innerText = "";
+      document.write('  <span onclick="myFunction()" class="dropbtn">'+currentVersion+'</span>');
+      document.write('  <div id="myDropdown" class="dropdown-content">');
+      for(var version in versions) {
+          var label = versions[version];
+          if (label != version) {
+              label += " ("+version+")"
+          }
+          label = "Version " + label
+          document.write('    <a href="'+urlForVersion(docUrl, version)+'">'+label+'</a>');
+      }
+      document.write('  </div>');
+  };
+} else {
+  function writeVersionDropdown() {}
+}
+
+/* When the user clicks on the button,
+toggle between hiding and showing the dropdown content */
+function myFunction() {
+  document.getElementById("myDropdown").classList.toggle("show");
+}
+
+// Close the dropdown menu if the user clicks outside of it
+window.onclick = function(event) {
+  if (!event.target.matches('.dropbtn')) {
+    var dropdowns = document.getElementsByClassName("dropdown-content");
+    var i;
+    for (i = 0; i < dropdowns.length; i++) {
+      var openDropdown = dropdowns[i];
+      if (openDropdown.classList.contains('show')) {
+        openDropdown.classList.remove('show');
+      }
+    }
+  }
+}

.github/workflows/gh-pages.yml

@@ -0,0 +1,46 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to GitHub Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: [gh-pages]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v3
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          # Upload entire repository
+          path: '.'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<title>Redirect to the CMSIS-Zone main page after 0 seconds</title>
+<meta http-equiv="refresh" content="0; URL=./latest/index.html">
+<meta name="keywords" content="automatic redirection">
+</head>
+
+<body>
+
+If the automatic redirection is failing, click <a href="./latest/index.html">open CMSIS-Zone Documentation</a>.
+
+</body>
+</html>

latest

@@ -0,0 +1 @@
+main

main/ErrorMessages.html

@@ -0,0 +1,209 @@
+<!-- HTML header for doxygen 1.9.6-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=11"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>CMSIS-Zone: Error Messages</title>
+<link href="doxygen.css" rel="stylesheet" type="text/css"/>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
+<link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
+<link href="extra_search.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="jquery.js"></script>
+<script type="text/javascript" src="dynsections.js"></script>
+<script type="text/javascript" src="printComponentTabs.js"></script>
+<script type="text/javascript" src="footer.js"></script>
+<script type="text/javascript" src="navtree.js"></script>
+<link href="navtree.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="resize.js"></script>
+<script type="text/javascript" src="navtreedata.js"></script>
+<script type="text/javascript" src="navtree.js"></script>
+<link href="search/search.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="search/searchdata.js"></script>
+<script type="text/javascript" src="search/search.js"></script>
+<script type="text/javascript">
+/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
+  $(document).ready(function() { init_search(); });
+/* @license-end */
+</script>
+<script type="text/javascript" src="darkmode_toggle.js"></script>
+<link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
+<link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
+<link href="extra_search.css" rel="stylesheet" type="text/css"/>
+<link href="version.css" rel="stylesheet" type="text/css" />
+<script type="text/javascript" src="../version.js"></script>
+</head>
+<body>
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+<div id="titlearea">
+<table cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr style="height: 55px;">
+  <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
+  <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
+   <div id="projectname">CMSIS-Zone
+   &#160;<span id="projectnumber"><script type="text/javascript">
+     <!--
+     writeHeader.call(this);
+     writeVersionDropdown.call(this, "CMSIS-Zone");
+     //-->
+    </script>
+   </span>
+   </div>
+   <div id="projectbrief">System Resource Management</div>
+  </td>
+   <td>        <div id="MSearchBox" class="MSearchBoxInactive">
+        <span class="left">
+          <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
+          <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
+               onfocus="searchBox.OnSearchFieldFocus(true)" 
+               onblur="searchBox.OnSearchFieldFocus(false)" 
+               onkeyup="searchBox.OnSearchFieldChange(event)"/>
+          </span><span class="right">
+            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
+          </span>
+        </div>
+</td>
+  <!--END !PROJECT_NAME-->
+ </tr>
+ </tbody>
+</table>
+</div>
+<!-- end header part -->
+<div id="CMSISnav" class="tabs1">
+  <ul class="tablist">
+    <script type="text/javascript">
+      writeComponentTabs.call(this);
+    </script>
+  </ul>
+</div>
+<!-- Generated by Doxygen 1.9.6 -->
+<script type="text/javascript">
+/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
+var searchBox = new SearchBox("searchBox", "search/",'.html');
+/* @license-end */
+</script>
+</div><!-- top -->
+<div id="side-nav" class="ui-resizable side-nav-resizable">
+  <div id="nav-tree">
+    <div id="nav-tree-contents">
+      <div id="nav-sync" class="sync"></div>
+    </div>
+  </div>
+  <div id="splitbar" style="-moz-user-select:none;" 
+       class="ui-resizable-handle">
+  </div>
+</div>
+<script type="text/javascript">
+/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
+$(document).ready(function(){initNavTree('ErrorMessages.html',''); initResizable(); });
+/* @license-end */
+</script>
+<div id="doc-content">
+<!-- window showing the filter options -->
+<div id="MSearchSelectWindow"
+     onmouseover="return searchBox.OnSearchSelectShow()"
+     onmouseout="return searchBox.OnSearchSelectHide()"
+     onkeydown="return searchBox.OnSearchSelectKey(event)">
+</div>
+
+<!-- iframe showing the search results (closed by default) -->
+<div id="MSearchResultsWindow">
+<div id="MSearchResults">
+<div class="SRPage">
+<div id="SRIndex">
+<div id="SRResults"></div>
+<div class="SRStatus" id="Loading">Loading...</div>
+<div class="SRStatus" id="Searching">Searching...</div>
+<div class="SRStatus" id="NoMatches">No Matches</div>
+</div>
+</div>
+</div>
+</div>
+
+<div><div class="header">
+  <div class="headertitle"><div class="title">Error Messages </div></div>
+</div><!--header-->
+<div class="contents">
+<div class="textblock"><p>The following table explains the output messages issued by CMSIS-Zone utility.</p>
+<table class="markdownTable">
+<tr class="markdownTableHead">
+<th class="markdownTableHeadLeft">Message   </th><th class="markdownTableHeadLeft">Description    </th></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z101: &lt;name&gt;: Invalid memory size   </td><td class="markdownTableBodyLeft">Size of the memory region is invalid or negative    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z102: &lt;name&gt;: Memory size exceeds parent region size   </td><td class="markdownTableBodyLeft">Size of the sub-memory region exceeds the available memory in the parent    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z103: &lt;name&gt;: Invalid memory offset   </td><td class="markdownTableBodyLeft">Offset of the sub-memory region is invalid or negative    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z104: &lt;name&gt;: Memory offset is outside parent boundary   </td><td class="markdownTableBodyLeft">Offset of the sub-memory region is outside of the available memory in the parent    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z105: &lt;name&gt;: Memory exceeds parent region boundary   </td><td class="markdownTableBodyLeft">The sub-memory region exceeds the limits of physical memory space in the parent    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z106: &lt;name&gt;: Memory region cannot be arranged: no physical slot is available   </td><td class="markdownTableBodyLeft">The memory region cannot be arranged as there is no physical memory space available    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z107: &lt;name&gt;: Memory region fully overlaps with region &lt;name&gt;   </td><td class="markdownTableBodyLeft">The sub-memory region overlaps with another memory region    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z108: &lt;name&gt;: Memory region partially overlaps with region &lt;name&gt;   </td><td class="markdownTableBodyLeft">The sub-memory region overlaps with another memory region    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z110: &lt;name&gt;: Number of available MPU slots is exceeded   </td><td class="markdownTableBodyLeft">There are not enough MPU regions to allocate the required resources    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z111: No MPU slot can be allocated according to ArmV7 requirements   </td><td class="markdownTableBodyLeft">There are not enough MPU regions to allocate the required resources    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z112: &lt;name&gt;: Memory size is rounded up to align with ArmV7 MPU requirements   </td><td class="markdownTableBodyLeft">The Memory size of the region is increased due to MPU alignment restrictions    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z120: No startup memory region is specified   </td><td class="markdownTableBodyLeft">There is not memory region for the reset vector (startup) defined    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z121: Multiple startup memory regions are specified   </td><td class="markdownTableBodyLeft">There is more then one region for the reset vector (startup) defined    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z201: &lt;name&gt;: Memory region is missing   </td><td class="markdownTableBodyLeft">The memory region in the assignment *.azone file is missing in the resource *.rzone file    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z202: &lt;name&gt;: Peripheral group is missing   </td><td class="markdownTableBodyLeft">The peripheral group in the assignment *.azone file is missing in the resource *.rzone file    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z203: &lt;name&gt;: Peripheral is missing   </td><td class="markdownTableBodyLeft">The peripheral in the assignment *.azone file is missing in the resource *.rzone file    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z401: &lt;name&gt;: Device description is missing   </td><td class="markdownTableBodyLeft">The device specification in the resource *.rzone file is incomplete    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z402: &lt;name&gt;: Device pack is not specified   </td><td class="markdownTableBodyLeft">The device specification in the resource *.rzone file is incomplete    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z403: &lt;name&gt;: Device pack specification is invalid   </td><td class="markdownTableBodyLeft">The device specification in the resource *.rzone file is incomplete    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z404: &lt;name&gt;: Resource file is missing   </td><td class="markdownTableBodyLeft">The resource *.rzone file referenced by the assignment *.azone file is missing    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z405: &lt;name&gt;: Error reading resource file   </td><td class="markdownTableBodyLeft">The resource *.rzone file has an incorrect format    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z406: &lt;name&gt;: Processor description is missing   </td><td class="markdownTableBodyLeft">The processor specification in the resource *.rzone file is incomplete    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z407: &lt;name&gt;: Processor description: missing or invalid DnumInterrupts attribute for TrustZone device   </td><td class="markdownTableBodyLeft">The processor specification in the resource *.rzone file is incomplete    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z408: &lt;name&gt;: Processor description: missing or invalid DnumSauRegions attribute for TrustZone device   </td><td class="markdownTableBodyLeft">The processor specification in the resource *.rzone file is incomplete    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z501: &lt;name&gt;: Creating sub-zone files failed   </td><td class="markdownTableBodyLeft">The sub-zone resource files cannot be created    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z601: &lt;name&gt;: creating FreeMarker model failed   </td><td class="markdownTableBodyLeft">The FreeMarker model *.fzone file cannot be created    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z602: &lt;name&gt;: processing template file failed   </td><td class="markdownTableBodyLeft">The FreeMarker model template file cannot be processed    </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyLeft">Error Z603: &lt;name&gt;: processing template file failed   </td><td class="markdownTableBodyLeft">The FreeMarker model template file cannot be processed    </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyLeft">Error Z604: &lt;name&gt;: folder contains no template files   </td><td class="markdownTableBodyLeft">There are no FreeMarker model template files   </td></tr>
+</table>
+</div></div><!-- contents -->
+</div><!-- PageDoc -->
+</div><!-- doc-content -->
+<!-- start footer part -->
+<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
+  <ul>
+    <li class="footer">
+      <script type="text/javascript">
+        <!--
+        writeFooter.call(this);
+        //-->
+      </script> 
+    </li>
+  </ul>
+</div>
+</body>
+</html>