add (old) meeting notes from November I just found

2024-03-11 10:49:41 -04:00
29 changed files with 102 additions and 2439 deletions
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@ -11,31 +11,31 @@ jobs:
      image: docker.io/rockylinux:9
    steps:
      - name: Install deps
+        run: dnf -y install git python3 python3-pip
+
+      - name: setup ssh
+        env:
+          SSH_KEY: "${{ secrets.SSH_KEY }}"
        run: |
-          dnf -y upgrade
-          dnf -y install git python3 python3-pip cairo-devel
+          mkdir -p  ~/.ssh/
+          echo "$SSH_KEY" > ~/.ssh/id_rsa
+          chmod 0700 ~/.ssh/
+          chmod 0600 ~/.ssh/id_rsa

      - name: checkout
+        env:
+          GIT_SSH_COMMAND: "ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no"
        run:
          git clone https://git.resf.org/$GITHUB_REPOSITORY.git $GITHUB_WORKSPACE

      - name: Install python requirements
        run: python3 -m pip install -r requirements.txt
-
-      - name: Build
-        run: |
-          python3 -m mkdocs build
-
-      - name: Install fastly CLI
-        run: |
-          dnf -y install \
-          npm \
-          https://github.com/fastly/cli/releases/download/v10.13.3/fastly_10.13.3_linux_amd64.rpm
-
+      
      - name: Deploy
-        env:
-          FASTLY_API_TOKEN: "${{ secrets.FASTLY_API_TOKEN }}"
+        env: 
+          GIT_SSH_COMMAND: "ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no"
+          GIT_AUTHOR_NAME: "Rocky Bot"
+          GIT_AUTHOR_EMAIL: "auto@rockylinux.org"
        run: |
-          pushd compute-js
-          npm install
-          fastly compute publish
+          git remote set-url origin ssh://git@git.resf.org:22220/$GITHUB_REPOSITORY.git
+          python3 -m mkdocs gh-deploy --force
--- a/.gitignore
+++ b/.gitignore
@ -1,2 +0,0 @@
-/site
-.cache
--- a/2
+++ b/2
@ -1,7 +1,7 @@
 FROM rockylinux:9

 RUN dnf update -y &&\
-    dnf install -y git python3-pip cairo  &&\
+    dnf install -y git python3-pip  &&\
    dnf clean all

 # bind volume $CWD > /wiki exists in docker-compose.yml
--- a/README.md
+++ b/README.md
@ -13,16 +13,16 @@ This Wiki is browseable at **https://sig-altarch.rocky.page** .

 Feel free to contribute to this Wiki via pull request.

-You can test any changes locally by running it with Docker/Podman compose on your PC.  Clone this wiki, `cd` into the folder, set SeLinux to permissive temporarily and run:
+You can test any changes locally by running it with Docker/Podman compose on your PC.  Clone this wiki, `cd` into the folder, and run:

 ```
-setenforce 0
 docker-compose up
 ```

 It should build and run the wiki container.  You can browse it and see your live edits by visiting `localhost:8000` .


+
 ## Continuous Integration / Continuous Deployment

 Actions Runner executes workflow to publish to https://sig-altarch.rocky.page on push to main.
--- a/compute-js/.gitignore
+++ b/compute-js/.gitignore
@ -1,4 +0,0 @@
-/node_modules
-/bin
-/pkg
-/static-publisher
--- a/compute-js/.publish-id
+++ b/compute-js/.publish-id
@ -1,2 +0,0 @@
-# Generated by @fastly/compute-js-static-publish.
-2U3RUindKvK1F6Sb7AEHXZ
--- a/compute-js/fastly.toml
+++ b/compute-js/fastly.toml
@ -1,12 +0,0 @@
-# This file describes a Fastly Compute package. To learn more visit:
-# https://www.fastly.com/documentation/reference/compute/fastly-toml
-
-authors = ["sig-altarch@rocky.page"]
-description = "SIG/AltArch Wiki"
-language = "javascript"
-manifest_version = 2
-name = "sig-altarch.rocky.page"
-service_id = "vvJfk2GYOVZGX7FPrEHEa5"
-
-[scripts]
-  build = "npm run build"
--- a/compute-js/package-lock.json
+++ b/compute-js/package-lock.json
--- a/compute-js/package.json
+++ b/compute-js/package.json
@ -1,23 +0,0 @@
-{
-  "name": "sig-altarch.rocky.page",
-  "version": "0.1.0",
-  "description": "SIG/Altarch Wiki",
-  "author": "sig-altarch@rocky.page",
-  "type": "module",
-  "devDependencies": {
-    "@fastly/compute-js-static-publish": "^6.0.3"
-  },
-  "dependencies": {
-    "@fastly/js-compute": "^3.20.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "license": "UNLICENSED",
-  "private": true,
-  "scripts": {
-    "deploy": "fastly compute deploy",
-    "prebuild": "npx @fastly/compute-js-static-publish --build-static",
-    "build": "js-compute-runtime ./src/index.js ./bin/main.wasm"
-  }
-}
--- a/compute-js/src/index.js
+++ b/compute-js/src/index.js
@ -1,18 +0,0 @@
-/// <reference types="@fastly/js-compute" />
-import { getServer } from '../static-publisher/statics.js';
-const staticContentServer = getServer();
-
-// eslint-disable-next-line no-restricted-globals
-addEventListener("fetch", (event) => event.respondWith(handleRequest(event)));
-async function handleRequest(event) {
-
-  const response = await staticContentServer.serveRequest(event.request);
-  if (response != null) {
-    return response;
-  }
-
-  // Do custom things here!
-  // Handle API requests, serve non-static responses, etc.
-
-  return new Response('Not found', { status: 404 });
-}
--- a/compute-js/static-publish.rc.js
+++ b/compute-js/static-publish.rc.js
@ -1,34 +0,0 @@
-/*
- * Copyright Fastly, Inc.
- * Licensed under the MIT license. See LICENSE file for details.
- */
-
-// Commented items are defaults, feel free to modify and experiment!
-// See README for a detailed explanation of the configuration options.
-
-/** @type {import('@fastly/compute-js-static-publish').StaticPublisherConfig} */
-const config = {
-  rootDir: "../site",
-  staticContentRootDir: "./static-publisher",
-  // kvStoreName: false,
-  // excludeDirs: [ './node_modules' ],
-  // excludeDotFiles: true,
-  // includeWellKnown: true,
-  // contentAssetInclusionTest: (filename) => true,
-  // contentCompression: [ 'br', 'gzip' ], // For this config value, default is [] if kvStoreName is null. 
-  // moduleAssetInclusionTest: (filename) => false,
-  // contentTypes: [
-  //   { test: /.custom$/, contentType: 'application/x-custom', text: false },
-  // ],
-  server: {
-    publicDirPrefix: "",
-    staticItems: ["/assets/"],
-    // compression: [ 'br', 'gzip' ],
-    spaFile: false,
-    notFoundPageFile: "/404.html", 
-    autoExt: [],
-    autoIndex: ["index.html","index.htm"],
-  },
-};
-
-export default config;
--- a/docker-compose.yml
+++ b/docker-compose.yml
@ -5,7 +5,6 @@ services:
      - type: bind
        source: .
        target: /wiki
-    
    build:
      context: .
    ports:
--- a/docs/.pages
+++ b/docs/.pages
@ -1,3 +0,0 @@
-nav:
-    - single_board_computers 
-    - events
--- a/docs/single_board_computers/risc-v/vf2.md
+++ b/docs/single_board_computers/risc-v/vf2.md
--- a/docs/single_board_computers/rpi/dnf-restart.md
+++ b/docs/single_board_computers/rpi/dnf-restart.md
@ -1,9 +1,11 @@
 ---
-title: dnf-claims-restart
+title: Solutions
 author: Funzi
 ---

-# `dnf` always claims to require a restart
+# Solutions and Troubleshooting
+
+## `dnf` always claims to require a restart

 ### Symptom

--- a/docs/assets/extra.css
+++ b/docs/assets/extra.css
@ -1,33 +0,0 @@
-:root {
-  @media screen and (max-width: 76.234375em) {
-    .md-nav__title[for="__drawer"] {
-      background: linear-gradient(135deg, #10b981 0%, #1055b9 100%);
-    }
-  }
-}
-
-[data-md-color-scheme="resf"] {
-  --md-accent-fg-color:         #0e7391;
-  --md-primary-fg-color--dark:  #107fa1;
-  --md-primary-fg-color--light: #FFFFFF;
-  --md-primary-fg-color:        #107fa1;
-  --md-typeset-a-color:         #107fa1;
-}
-[data-md-color-scheme="resf-dark"] {
-  color-scheme: dark;
-  --md-default-fg-color:        #FFFFFF;
-  --md-default-bg-color:        rgb(30, 33, 41);
-
-  --md-primary-fg-color:        #107fa1;
-  --md-primary-bg-color:        #FFFFFF;
-  --md-primary-fg-color--dark:  #107fa1;
-
-  --md-accent-fg-color:         #0e7391;
-
-  --md-default-fg-color--light: rgba(226, 228, 233, 0.56);
-
-  --md-typeset-table-color: rgba(240, 241, 244, 0.12);
-
-  --md-typeset-color:           rgba(226, 228, 233, 0.82);
-  --md-typeset-a-color:         #107fa1;
-}
--- a/docs/assets/icon-white.svg
+++ b/docs/assets/icon-white.svg
@ -1,3 +0,0 @@
-<svg width="4096" height="4096" viewBox="0 0 192 192" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path fill-rule="evenodd" clip-rule="evenodd" d="M186.658 127.658C190.119 117.746 192 107.093 192 96C192 42.9807 149.019 0 96 0C42.9807 0 0 42.9807 0 96C0 122.234 10.523 146.011 27.5783 163.338L124.958 65.9584L149 90L186.658 127.658ZM169.122 158.205L124.958 114.042L55.7978 183.202C68.0268 188.849 81.6455 192 96 192C125.288 192 151.514 178.884 169.122 158.205Z" fill="white"/>
-</svg>
--- a/docs/assets/resf-icon-w-bg.png
+++ b/docs/assets/resf-icon-w-bg.png
--- a/docs/assets/resf-icon.png
+++ b/docs/assets/resf-icon.png
--- a/docs/assets/resf-white.svg
+++ b/docs/assets/resf-white.svg
@ -1,63 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   width="44.450001mm"
-   height="44.450001mm"
-   viewBox="0 0 44.450001 44.450001"
-   version="1.1"
-   id="svg1"
-   inkscape:version="1.3.2 (091e20ef0f, 2023-11-25)"
-   sodipodi:docname="resf-white.svg"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <sodipodi:namedview
-     id="namedview1"
-     pagecolor="#ffffff"
-     bordercolor="#666666"
-     borderopacity="1.0"
-     inkscape:showpageshadow="2"
-     inkscape:pageopacity="0.0"
-     inkscape:pagecheckerboard="0"
-     inkscape:deskcolor="#d1d1d1"
-     inkscape:document-units="mm"
-     inkscape:zoom="1.624662"
-     inkscape:cx="105.86818"
-     inkscape:cy="665.36917"
-     inkscape:window-width="1440"
-     inkscape:window-height="3356"
-     inkscape:window-x="0"
-     inkscape:window-y="52"
-     inkscape:window-maximized="1"
-     inkscape:current-layer="layer1" />
-  <defs
-     id="defs1" />
-  <g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1"
-     transform="translate(-2.5796834,-3.8748417)">
-    <path
-       d="M 2.5796834,3.8748417 H 47.029686 V 31.39389 l -6.87626,-6.876256 -5.13556,5.135562 -10.27113,-10.271125 -5.13556,5.135298 -10.2710976,-10.271045 -6.760395,6.760289 z"
-       fill="#ffffff"
-       id="path3"
-       style="stroke-width:0.264583" />
-    <path
-       d="m 40.153426,32.220977 -16.10386,16.103865 h 22.98012 v -9.227609 z"
-       fill="#ffffff"
-       id="path4"
-       style="stroke-width:0.264583" />
-    <path
-       d="M 24.746736,27.085415 31.166056,33.505 16.346271,48.324842 H 3.5072594 Z"
-       fill="#ffffff"
-       id="path5"
-       style="stroke-width:0.264583" />
-    <path
-       d="m 9.3400784,21.949588 -6.760395,6.760633 V 41.549127 L 15.759558,28.369173 Z"
-       fill="#ffffff"
-       id="path6"
-       style="stroke-width:0.264583" />
-  </g>
-</svg>
--- a/docs/events/meeting-notes/2024-08-23.md
+++ b/docs/events/meeting-notes/2024-08-23.md
@ -1,32 +0,0 @@
-# SIG/AltArch meeting 2024-08-23
-
-## Attendees
-
-* Neil Hanlon
-* Sherif Nagy
-* Bryan Zuelly
-* Daniel
-* Stack
-
-## Discussions
-
-* [ ] Sherif to move rpi kernel into SIG repo
-* https://forums.rockylinux.org/t/beta-sbc-images/15488/2
-  * beta generic images
-  * Stack: these are working really well
-    * what do we need to do to get this across the line?
-    * we need to build the kernel as the SIG
-      * [ ] Bryan to send Neil the kconfig we’re gonna user
-    * [ ] build three different images in kiwi
-      * GPT, MBR, RPi
-* [ ] Neil to move SIG Wiki to Fastly
-
-### Open Floor
-
-* armhfp - nice to have, maybe we can get back to this at some point?
-
-## Action Items
-* [ ] 📝 Sherif to move rpi kernel into SIG repo
-* [ ] 📝 Bryan to send Neil the kconfig we’re gonna user
-* [ ] 📝 build three different images in kiwi
-* [ ] 📝 Neil to move SIG Wiki to Fastly
--- a/docs/events/meeting-notes/first-meeting.md
+++ b/docs/events/meeting-notes/first-meeting.md
@ -1,11 +0,0 @@
-### Decisions from 1st meeting - no exact date
-
-* Images should be generic so as to be able to be installed on any board, where possible.
-    * uboot can live on SPI or external flash
-    * We need to help document this for our users and have guides on how to get the SBCs working. This is a big pain point for many SBC users as there is so much variation.
-        * To this end, we should investigate some tooling to aid in writing images for boards which will boot on the first try.
-* Uboot should similarly be generic and work for all boards, insofar as it is practical to do so.
-* We will wait for the next Kernel.org LTS to be cut, as that should have all the changes for the boards we're talking about.
-* We will engage with our upstreams (Fedora, ELRepo, etc) for changes we make with the Kernel SIG for AltArch/SBC support.
-    * This necessitates participating in SIG/Kernel to represent our needs in these kernels.
-* We should strive to perform native builds when possible, but recognize that emulation is a necessary evil.
--- a/docs/index.md
+++ b/docs/index.md
@ -1,18 +1,16 @@
 # SIG/AltArch Wiki

+## Links
+
+## Responsibilities
+
 ## Meetings / Communications
-Meetings are held fortnightly.  Additional details can be found on the [Public_Calendar](https://calendar.google.com/calendar/u/0/embed?src=c_2e1oqh6t0i6sqhja5nu9lq8lgo@group.calendar.google.com)
+
 ## Members

- Sherif Nagy
- Skip Grube
- Pablo Greco
- Neil Hanlon
- Pratham Patel
- Bryan Zuelly
-
-
-## Getting In Touch / Contributing
-The primary way to get into contact with the Sig/AltArch group would be our Mattermost [channel](https://chat.rockylinux.org/rocky-linux/channels/altarch).
-
+## Project layout

+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.
--- a/docs/single_board_computers/board-specific/amlogic/amlogicboards.md
+++ b/docs/single_board_computers/board-specific/amlogic/amlogicboards.md
@ -1,10 +0,0 @@
-# Amlogic-Based boards
-
-
-The Libre boards below will require the use of the ```libretech-flash-tool``` provided by libre computer.  it can be found on [their](https://github.com/libre-computer-project/libretech-flash-tool) github page.
-
- LibreTech-AC 'LaFrite'(S805X)
- LibreTech CC 'LePotato'(S905X)
-
-
-
--- a/docs/single_board_computers/board-specific/rockchip/rockchipboards.md
+++ b/docs/single_board_computers/board-specific/rockchip/rockchipboards.md
@ -1,12 +0,0 @@
-# Rockchip-based Boards
-
-For the boards below you will use the ```libretech-flash-tool``` from Libre.  It can be found on [their](https://github.com/libre-computer-project/libretech-flash-tool) github page.
-
- rk3328
- rk3399
- roc-cc-rk3399
-
-The Orange Pi 5 and Rock 5b require proprietary blogs from Rockchip.  The Rock5b uboot is built and provided by Raxda.  The Orange Pi 5 uboot can be obtained from project on github or built locally using a docker container.  More info to come soon.
-
- Raxda Rock 5b
- Orange Pi 5
--- a/docs/single_board_computers/rpi/zero2w.md
+++ b/docs/single_board_computers/rpi/zero2w.md
@ -1,28 +0,0 @@
---
-title: Pi Zero 2W
-author: Codedude
---
-
-# Pi Zero 2W wont boot
-
-### Problem
-
-The Raspberry Pi Zero 2W wont boot using the standard Rocky LInux Raspberry Pi image.
-### Solution
-
-Using info gathered from [Rocky_Linux_forum_post](https://forums.rockylinux.org/trocky-linux-9-0-rpi-image-fail-to-boot-on-rpi3-workaround/7802/2)
-
-```
-# Blacklist brcmfmac
-1. mount root partition
-2. create a file called "01-rpi-blacklist.conf" in /etc/modprobe.d
-3. umount root partition
-4. boot the sd card in the pi zero 2w.
-Then:
-5. run /usr/bin/fix-wifi-rpi.sh  This script extracts all firmware files.  Feel free to look it over before running it.
-6. delete the 01-rpi-blacklist.conf file from /etc/modprobe.ed
-7. reboot
-8.  Wifi should now be functional
-```
-
- 
--- a/docs/support/hardware/supported.md
+++ b/docs/support/hardware/supported.md
@ -0,0 +1,49 @@
+---
+title: Supported SBC Hardware
+author: Bryan Z.
+---
+
+# Rocky Linux Supported SBC Hardware Models
+
+## Raspberry Pi SBCs
+
+| Model         | Image                             | Status        |
+|---------------|-----------------------------------|---------------|
+| Pi 4B         | RockyLinux_Rpi_9-latest.img.xz    | Complete      |
+| Pi 3B/B+      | RockyLinux_Rpi_9-latest.img.xz    | Complete      |
+
+
+## Banana Pi
+| Model         |  Status                                           |
+|---------------|---------------------------------------------------|
+| Unknown       | Stage 1(hardware being procured)                  |
+
+## Orange Pi
+| Model         | Status                                            |
+|---------------|---------------------------------------------------|
+| Unknown       | Stage 1(hardware being procured)                  |
+
+## Pine 
+| Model         | Image                                                    | Status                                 |
+|---------------|----------------------------------------------------------|----------------------------------------|
+| Pine64        |                                                          | Stage 1(hardware being obtained)       |
+| RockPro64     | Rocky-9.1-aarch64-generic-Minimal-rk3399-sda.raw.tar.gz  | Complete                               |
+| A64_LTS       |                                                          | Stage 1(hardware being obtained)       |
+
+## Libre Computer
+| Model         | Status                                                         |
+|---------------|----------------------------------------------------------------|
+| Renegade      | Stage 2(hw obtained, initial testing to discover whats needed) |
+| La Frite      | Stage 2(hw obtained, initial testing to discover whats needed) |
+| Tritium       | Stage 2(hw obtained, initial testing to discover whats needed) |
+| Le Potato     | Stage 2(hw obtained, initial testing to discover whats needed) |
+
+## Ordoid
+| Model         | Status                                                          |
+|---------------|-----------------------------------------------------------------|
+| N2+           | Stage 2(hw obtained, initial testing to discover what's needed) |
+
+## Khadas
+| Model         | Image                             | Status        |
+|---------------|---------------------------------------------------|
+| In early phases of discovery. |  |  |
--- a/mkdocs.yml
+++ b/mkdocs.yml
@ -11,23 +11,24 @@ repo_name: sig_altarch/wiki
 edit_uri: _edit/main/docs/

 # Copyright
-copyright: Copyright &copy; 2024 Rocky Enterprise Software Foundation
-
-extra_css:
-  - assets/extra.css
+copyright: Copyright &copy; 2023 Rocky Enterprise Software Foundation

 # Configuration
 theme:
  name: material
-  logo: assets/resf-white.svg
+  logo: assets/icon-white.svg
  palette:
    - media: "(prefers-color-scheme: light)"
-      scheme: resf
+      scheme: default
+      primary: teal
+      accent: teal
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
-      scheme: resf-dark
+      scheme: slate
+      primary: teal
+      accent: teal
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
@ -38,7 +39,7 @@ theme:
    - python
    - yaml
  features:
-    # - navigation.expand
+    - navigation.expand
    - navigation.indexes
    - navigation.instant
    - navigation.sections
@ -53,7 +54,6 @@ theme:
 # Plugins
 plugins:
  - autolinks
-  - social
  - awesome-pages
  - git-revision-date-localized:
      type: date
@ -69,8 +69,8 @@ markdown_extensions:
  - meta
  - pymdownx.details # this allows collapsible attributions
  - pymdownx.emoji:
-      emoji_index: !!python/name:material.extensions.emoji.twemoji
-      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+      emoji_index: !!python/name:materialx.emoji.twemoji
+      emoji_generator: !!python/name:materialx.emoji.to_svg
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
--- a/requirements.txt
+++ b/requirements.txt
@ -1,51 +1,7 @@
-babel==2.16.0
-bracex==2.5
-cairocffi==1.7.1
-CairoSVG==2.7.1
-certifi==2024.7.4
-cffi==1.17.0
-charset-normalizer==3.3.2
-click==8.1.7
-colorama==0.4.6
-cssselect2==0.7.0
-defusedxml==0.7.1
-ghp-import==2.1.0
-gitdb==4.0.11
-GitPython==3.1.43
-idna==3.8
-Jinja2==3.1.4
-Markdown==3.7
-MarkupSafe==2.1.5
-mergedeep==1.3.4
-mkdocs==1.6.0
-mkdocs-autolinks-plugin==0.7.1
-mkdocs-awesome-pages-plugin==2.9.3
-mkdocs-get-deps==0.2.0
-mkdocs-git-revision-date-localized-plugin==1.2.7
-mkdocs-macros-plugin==1.0.5
-mkdocs-material==9.5.33
-mkdocs-material-extensions==1.3.1
-mkdocs-windmill==1.0.5
-natsort==8.4.0
-packaging==24.1
-paginate==0.5.6
-pathspec==0.12.1
-pillow==10.4.0
-platformdirs==4.2.2
-pycparser==2.22
-Pygments==2.18.0
-pymdown-extensions==10.9
-python-dateutil==2.9.0.post0
-pytz==2024.1
-PyYAML==6.0.2
-pyyaml_env_tag==0.1
-regex==2024.7.24
-requests==2.32.3
-six==1.16.0
-smmap==5.0.1
-termcolor==2.4.0
-tinycss2==1.3.0
-urllib3==2.2.2
-watchdog==4.0.2
-wcmatch==9.0
-webencodings==0.5.1
+mkdocs
+mkdocs-autolinks-plugin
+mkdocs-awesome-pages-plugin
+mkdocs-git-revision-date-localized-plugin
+mkdocs-macros-plugin
+mkdocs-material
+mkdocs-windmill