tools: Flashpack - a tool to flash vamOS

.github/workflows/pages.yml

@@ -0,0 +1,51 @@
+name: deploy pages
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - 'tools/flashpack/**'
+      - '.github/workflows/pages.yml'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: build
+        working-directory: tools/flashpack
+        run: |
+          bun install
+          bun run build
+
+      # To deploy to a custom domain (e.g. flashpack.comma.ai),
+      # uncomment this step and configure DNS to point to GitHub Pages
+      # - name: set custom domain
+      #   run: echo "flashpack.comma.ai" > tools/flashpack/dist/CNAME
+
+      - name: configure pages
+        uses: actions/configure-pages@v5
+
+      - name: upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: tools/flashpack/dist
+
+      - name: deploy to github pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -4,4 +4,7 @@
 **/.DS_Store
 **/*.tar.xz
 
-__pycache__/
+__pycache__/
+
+tools/flashpack/dist
+tools/flashpack/node_modules

tools/flashpack/build.ts

@@ -0,0 +1,18 @@
+const build = await Bun.build({
+  entrypoints: ["./src/index.html"],
+  outdir: "./dist",
+  sourcemap: "linked",
+  minify: true,
+});
+
+if (!build.success) {
+  for (const log of build.logs) console.error(log);
+  process.exit(1);
+}
+
+const outputs = build.outputs.map(({ path, kind, size }) => ({
+  path,
+  kind,
+  "size (KiB)": (size / 1024).toFixed(1),
+}));
+console.table(outputs);

tools/flashpack/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "flashpack",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run serve.ts",
+    "build": "bun run build.ts"
+  },
+  "dependencies": {
+    "@commaai/qdl": "github:commaai/qdl.js"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.0.0"
+  },
+  "trustedDependencies": [
+    "@commaai/qdl"
+  ]
+}

tools/flashpack/serve.ts

@@ -0,0 +1,12 @@
+import index from "./src/index.html";
+
+const server = Bun.serve({
+  static: {
+    "/": index,
+  },
+  development: true,
+  fetch() {
+    return new Response("404!");
+  },
+});
+console.info(`Running on http://${server.hostname}:${server.port}`);

tools/flashpack/setup-udev.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+set -e
+
+sudo tee /etc/udev/rules.d/99-qualcomm-edl.rules > /dev/null <<'EOF'
+SUBSYSTEM=="usb", ATTR{idVendor}=="05c6", ATTR{idProduct}=="9008", MODE="0666"
+SUBSYSTEM=="usb", ATTR{idVendor}=="3801", ATTR{idProduct}=="9008", MODE="0666"
+EOF
+
+sudo udevadm control --reload-rules
+sudo udevadm trigger
+
+for d in /sys/bus/usb/drivers/qcserial/*-*
+do
+    [ -e "$d" ] && echo -n "$(basename $d)" | sudo tee /sys/bus/usb/drivers/qcserial/unbind > /dev/null
+done
+
+echo "Done. Unplug and replug your device."