Initial commit

Author: Bernhard Trinnes

.github/workflows/update-site.yml

@@ -0,0 +1,57 @@
+name: Generate Tutorials Index
+
+on:
+  workflow_dispatch:
+
+jobs:
+  generate-tutorials-index:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+
+      - name: Generate tutorials.json
+        env:
+          GH_USERNAME: Boernsman
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} # or a PAT if needed
+        run: |
+          python3 <<EOF
+          import requests, json
+
+          headers = {
+              "Accept": "application/vnd.github.mercy-preview+json",
+              "Authorization": f"token '{os.environ['GH_TOKEN']}'"
+          }
+
+          res = requests.get(f"https://api.github.com/users/{os.environ['GH_USERNAME']}/repos", headers=headers)
+          repos = res.json()
+
+          tutorials = []
+          for repo in repos:
+              if not repo.get('fork'):
+                  r = requests.get(repo['url'], headers=headers).json()
+                  if 'topics' in r and 'tutorial' in r['topics']:
+                      tutorials.append({
+                          "name": repo["name"],
+                          "html_url": repo["html_url"],
+                          "description": repo.get("description", "")
+                      })
+
+          with open("tutorials.json", "w") as f:
+              json.dump(tutorials, f, indent=2)
+          EOF
+
+      - name: Commit and push tutorials.json
+        run: |
+          git config user.name "github-actions"
+          git config user.email "actions@github.com"
+          git add tutorials.json
+          git commit -m "Update tutorials index" || echo "No changes to commit"
+          git push
+

.gitignore

@@ -0,0 +1,67 @@
+~*
+
+# ignore node/grunt dependency directories
+node_modules/
+
+# Ignore build directories.
+/build
+/dist
+
+# ignore composer vendor directory
+/vendor
+
+# ignore components loaded via Bower
+/bower_components
+
+# ignore jekyll build directory
+/_site
+
+# ignore OS generated files
+ehthumbs.db
+Thumbs.db
+
+# ignore Editor files
+*.sublime-project
+*.sublime-workspace
+*.komodoproject
+
+# ignore log files and databases
+*.log
+*.sql
+*.sqlite
+
+# ignore compiled files
+*.com
+*.class
+*.dll
+*.exe
+*.o
+*.so
+
+# ignore packaged files
+*.7z
+*.dmg
+*.gz
+*.iso
+*.jar
+*.rar
+*.tar
+*.zip
+
+# ignore private/secret files
+*.der
+*.key
+*.pem
+
+# --------------------------------------------------------
+# BEGIN Explictly Allowed Files (i.e. do NOT ignore these)
+# --------------------------------------------------------
+
+# track these files, if they exist
+!.dockerignore
+!.editorconfig
+!.env.example
+!.git-blame-ignore-revs
+!.gitignore
+!.nvmrc
+!.phpcs.xml.dist

README.md

@@ -0,0 +1,4 @@
+# Bitcrush Testing Github.io Page
+
+Please visit [github.io](https://bitcrushtesting.github.io)
+

_config.yml

@@ -0,0 +1,14 @@
+# Site settings
+title: Bitcrush Testing
+email: contact@bitcrushtesting.com
+description: > # this means to ignore newlines until "baseurl:"
+  Write an awesome description for your new site here. You can edit this
+  line in _config.yml. It will appear in your document head meta (for
+  Google search results) and in your feed.xml site description.
+baseurl: "/example" # the subpath of your site, e.g. /blog/
+url: "http://bitcrushtesting.github.io" # the base hostname & protocol for your site
+github_username:  bitcrushtesting
+
+# Build settings
+markdown: kramdown
+permalink: /:year/:title:output_ext

_includes/footer.html

@@ -0,0 +1,55 @@
+<footer class="site-footer">
+
+  <div class="wrapper">
+
+    <h2 class="footer-heading">{{ site.title }}</h2>
+
+    <div class="footer-col-wrapper">
+      <div class="footer-col  footer-col-1">
+        <ul class="contact-list">
+          <li>{{ site.title }}</li>
+          <li><a href="mailto:{{ site.email }}">{{ site.email }}</a></li>
+        </ul>
+      </div>
+
+      <div class="footer-col  footer-col-2">
+        <ul class="social-media-list">
+          {% if site.github_username %}
+          <li>
+            <a href="https://github.com/{{ site.github_username }}">
+              <span class="icon  icon--github">
+                <svg viewBox="0 0 16 16">
+                  <path fill="#828282" d="M7.999,0.431c-4.285,0-7.76,3.474-7.76,7.761 c0,3.428,2.223,6.337,5.307,7.363c0.388,0.071,0.53-0.168,0.53-0.374c0-0.184-0.007-0.672-0.01-1.32 c-2.159,0.469-2.614-1.04-2.614-1.04c-0.353-0.896-0.862-1.135-0.862-1.135c-0.705-0.481,0.053-0.472,0.053-0.472 c0.779,0.055,1.189,0.8,1.189,0.8c0.692,1.186,1.816,0.843,2.258,0.645c0.071-0.502,0.271-0.843,0.493-1.037 C4.86,11.425,3.049,10.76,3.049,7.786c0-0.847,0.302-1.54,0.799-2.082C3.768,5.507,3.501,4.718,3.924,3.65 c0,0,0.652-0.209,2.134,0.796C6.677,4.273,7.34,4.187,8,4.184c0.659,0.003,1.323,0.089,1.943,0.261 c1.482-1.004,2.132-0.796,2.132-0.796c0.423,1.068,0.157,1.857,0.077,2.054c0.497,0.542,0.798,1.235,0.798,2.082 c0,2.981-1.814,3.637-3.543,3.829c0.279,0.24,0.527,0.713,0.527,1.437c0,1.037-0.01,1.874-0.01,2.129 c0,0.208,0.14,0.449,0.534,0.373c3.081-1.028,5.302-3.935,5.302-7.362C15.76,3.906,12.285,0.431,7.999,0.431z"/>
+                </svg>
+              </span>
+
+              <span class="username">{{ site.github_username }}</span>
+            </a>
+          </li>
+          {% endif %}
+
+          {% if site.twitter_username %}
+          <li>
+            <a href="https://twitter.com/{{ site.twitter_username }}">
+              <span class="icon  icon--twitter">
+                <svg viewBox="0 0 16 16">
+                  <path fill="#828282" d="M15.969,3.058c-0.586,0.26-1.217,0.436-1.878,0.515c0.675-0.405,1.194-1.045,1.438-1.809
+                  c-0.632,0.375-1.332,0.647-2.076,0.793c-0.596-0.636-1.446-1.033-2.387-1.033c-1.806,0-3.27,1.464-3.27,3.27 c0,0.256,0.029,0.506,0.085,0.745C5.163,5.404,2.753,4.102,1.14,2.124C0.859,2.607,0.698,3.168,0.698,3.767 c0,1.134,0.577,2.135,1.455,2.722C1.616,6.472,1.112,6.325,0.671,6.08c0,0.014,0,0.027,0,0.041c0,1.584,1.127,2.906,2.623,3.206 C3.02,9.402,2.731,9.442,2.433,9.442c-0.211,0-0.416-0.021-0.615-0.059c0.416,1.299,1.624,2.245,3.055,2.271 c-1.119,0.877-2.529,1.4-4.061,1.4c-0.264,0-0.524-0.015-0.78-0.046c1.447,0.928,3.166,1.469,5.013,1.469 c6.015,0,9.304-4.983,9.304-9.304c0-0.142-0.003-0.283-0.009-0.423C14.976,4.29,15.531,3.714,15.969,3.058z"/>
+                </svg>
+              </span>
+
+              <span class="username">{{ site.twitter_username }}</span>
+            </a>
+          </li>
+          {% endif %}
+        </ul>
+      </div>
+
+      <div class="footer-col  footer-col-3">
+        <p class="text">{{ site.description }}</p>
+      </div>
+    </div>
+
+  </div>
+
+</footer>

_includes/head.html

@@ -0,0 +1,11 @@
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width initial-scale=1" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+
+    <title>{% if page.title %}{{ page.title }}{% else %}{{ site.title }}{% endif %}</title>
+    <meta name="description" content="{{ site.description }}">
+
+    <link rel="stylesheet" href="{{ "/css/main.css" | prepend: site.baseurl }}">
+    <link rel="canonical" href="{{ page.url | replace:'index.html','' | prepend: site.baseurl | prepend: site.url }}">
+</head>

_includes/header.html

@@ -0,0 +1,27 @@
+<header class="site-header">
+
+  <div class="wrapper">
+
+    <a class="site-title" href="{{ site.baseurl }}/">{{ site.title }}</a>
+
+    <nav class="site-nav">
+      <a href="#" class="menu-icon">
+        <svg viewBox="0 0 18 15">
+          <path fill="#424242" d="M18,1.484c0,0.82-0.665,1.484-1.484,1.484H1.484C0.665,2.969,0,2.304,0,1.484l0,0C0,0.665,0.665,0,1.484,0 h15.031C17.335,0,18,0.665,18,1.484L18,1.484z"/>
+          <path fill="#424242" d="M18,7.516C18,8.335,17.335,9,16.516,9H1.484C0.665,9,0,8.335,0,7.516l0,0c0-0.82,0.665-1.484,1.484-1.484 h15.031C17.335,6.031,18,6.696,18,7.516L18,7.516z"/>
+          <path fill="#424242" d="M18,13.516C18,14.335,17.335,15,16.516,15H1.484C0.665,15,0,14.335,0,13.516l0,0 c0-0.82,0.665-1.484,1.484-1.484h15.031C17.335,12.031,18,12.696,18,13.516L18,13.516z"/>
+        </svg>
+      </a>
+
+      <div class="trigger">
+        {% for page in site.pages %}
+          {% if page.title %}
+          <a class="page-link" href="{{ page.url | prepend: site.baseurl }}">{{ page.title }}</a>
+          {% endif %}
+        {% endfor %}
+      </div>
+    </nav>
+
+  </div>
+
+</header>

_posts/test_iec62304.md

@@ -0,0 +1,62 @@
+# Testing for Functional Safety in the Context of IEC 62304
+
+When developing medical device software, safety is not just an aspiration—it is a legal and ethical obligation. Among the many standards that govern this domain, IEC 62304 stands out as the key international standard for medical device software lifecycle processes. One essential part of compliance with IEC 62304 is systematic testing for functional safety. But what does that mean in practice?
+
+As engineers and software developers, we are trained to think in terms of structure, reliability, and traceability. This mindset aligns closely with the philosophy behind IEC 62304.
+
+## Understanding Functional Safety
+
+Functional safety ensures that a system behaves correctly in response to its inputs, particularly under fault conditions. In the medical domain, this translates to: The software must not cause harm to a patient or user, even in the case of predictable failures.
+
+For example, if a software-controlled infusion pump administers medication, the software must handle sensor failures, communication losses, and user errors in a way that prevents hazardous events. This is where functional safety comes in.
+
+## IEC 62304 and Safety Classification
+
+IEC 62304 defines three software safety classes:
+
+* Class A: No injury or damage to health is possible
+* Class B: Non-serious injury is possible
+* Class C: Death or serious injury is possible
+
+Depending on the classification, the rigor of testing and verification activities increases significantly. For Class C software, comprehensive testing strategies must be implemented, including unit testing, integration testing, and system-level verification with traceability to risk controls.
+
+## The Role of Testing
+Testing in the context of IEC 62304 is not just about finding bugs—it is about demonstrating that the software meets its safety requirements under all foreseeable conditions. Testing must therefore be:
+
+* Systematic: Following a documented and traceable processRisk-based
+* Risk-based: Prioritizing tests based on potential harmBidirectionally
+* Bidirectionally traceable: Linking each test case to a requirement and vice versa
+
+Typical test activities include:
+
+* Static analysis to detect potential defects early
+* Unit tests to verify logic at the function level
+* Integration tests to ensure proper communication between modules
+* System tests with fault injection and edge cases
+* Verification of risk controls, particularly those related to hardware-software interaction
+
+## Traceability
+
+We are known for their obsession with documentation and precision—and in this case, that’s a very good thing. IEC 62304 mandates traceability across the software lifecycle. Every requirement should be linked to:
+
+* Its origin in the risk management process (typically from ISO 14971)
+* The corresponding architecture or design element
+* The test cases that verify it
+
+Tools like Polarion, Codebeamer, or even open-source alternatives like ReqView and Robot Framework can help enforce this rigor.
+
+## Integration with ISO 14971 and IEC 60601
+Testing for functional safety cannot happen in isolation. It must be harmonized with other standards like:
+
+* ISO 14971 for risk management
+* IEC 60601 for electrical safety and essential performance
+
+For example, a Class C software might include a software-implemented failsafe that activates when a hardware sensor reports inconsistent data. This behavior must be tested in both software (mocked sensor failure) and in system testing (actual fault injection).
+
+## Final Thoughts
+
+Testing for functional safety in line with IEC 62304 is not just a regulatory checkbox—it is a mindset. It requires a deep understanding of both the software architecture and the clinical risks involved.
+
+We are in a good position to excel here. Our focus on process discipline, risk management, and engineering integrity provides a solid foundation for building safe, reliable medical software.
+
+In the end, good testing is not about covering every line of code—it is about being able to sleep at night, knowing that your software will not harm anyone.

about.md

@@ -0,0 +1,10 @@
+---
+layout: page
+title: About
+permalink: /about/
+---
+
+Bitcrush | Crushing Bytes to Bits
+Embedded Software Testing
+
+contact@bitcrushtesting.com