BLCU

.github/workflows/frontend-tests.yaml

@@ -29,7 +29,7 @@ jobs:
           cache: "pnpm"
 
       - name: Install dependencies
-        run: pnpm install --frozen-lockfile --filter=testing-view --filter=competition-view --filter=ui --filter=core
+        run: pnpm install --frozen-lockfile --filter=testing-view --filter=flashing-view --filter=competition-view --filter=ui --filter=core
 
       - name: Build frontend
         run: pnpm build --filter="./frontend/**"

.github/workflows/release.yaml

@@ -66,7 +66,7 @@ jobs:
         run: pnpm install --frozen-lockfile
 
       - name: Build with Turbo
-        run: pnpm turbo build --filter=testing-view --filter=competition-view
+        run: pnpm turbo build --filter=testing-view --filter=competition-view --filter=flashing-view
 
       - uses: actions/upload-artifact@v4
         with:
@@ -80,6 +80,12 @@ jobs:
           path: frontend/competition-view/dist/**
           retention-days: 1
 
+      - uses: actions/upload-artifact@v4
+        with:
+          name: flashing-dist
+          path: frontend/flashing-view/dist/**
+          retention-days: 1
+
   build-backend:
     name: Build Backend - ${{ matrix.os }}
     needs: determine-version
@@ -125,22 +131,103 @@ jobs:
           path: electron-app/binaries/${{ matrix.binary }}
           retention-days: 1
 
+  build-blcu:
+    name: Build BLCU - ${{ matrix.os }}
+    needs: determine-version
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: true
+      matrix:
+        include:
+          - os: windows-latest
+            binary: blcu-programming-windows-amd64.exe
+            binary-base: blcu-programming-windows-amd64
+          - os: ubuntu-latest
+            binary: blcu-programming-linux-amd64
+            binary-base: blcu-programming-linux-amd64
+          - os: macos-latest
+            binary: blcu-programming-darwin-arm64
+            binary-base: blcu-programming-darwin-arm64
+          - os: macos-15-intel
+            binary: blcu-programming-darwin-amd64
+            binary-base: blcu-programming-darwin-amd64
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Create virtual environment
+        working-directory: blcu-programming
+        run: python -m venv .venv-build
+
+      - name: Install dependencies
+        working-directory: blcu-programming
+        shell: bash
+        run: |
+          if [ "${{ runner.os }}" = "Windows" ]; then
+            .venv-build/Scripts/pip install -r requirements-build.txt
+          else
+            .venv-build/bin/pip install -r requirements-build.txt
+          fi
+
+      - name: Build with PyInstaller
+        working-directory: blcu-programming
+        shell: bash
+        run: |
+          if [ "${{ runner.os }}" = "Windows" ]; then
+            PYTHON=".venv-build/Scripts/python"
+          else
+            PYTHON=".venv-build/bin/python"
+          fi
+          if [ "${{ runner.os }}" = "Windows" ]; then
+            PATH_SEP=";"
+          else
+            PATH_SEP=":"
+          fi
+          "$PYTHON" -m PyInstaller \
+            --clean \
+            --noconfirm \
+            --onefile \
+            --name "${{ matrix.binary-base }}" \
+            --distpath "../electron-app/binaries" \
+            --hidden-import uvicorn.loops.auto \
+            --hidden-import uvicorn.protocols.http.auto \
+            --hidden-import uvicorn.protocols.websockets.auto \
+            --hidden-import uvicorn.lifespan.on \
+            --hidden-import multipart \
+            --hidden-import multipart.multiparser \
+            --paths "." \
+            --add-data "BLCU-config.json${PATH_SEP}." \
+            api/main.py
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: blcu-${{ matrix.os }}
+          path: electron-app/binaries/${{ matrix.binary }}
+          retention-days: 1
+
   package-and-upload:
     name: Package & Upload - ${{ matrix.os }}
-    needs: [determine-version, create-draft-release, build-frontend, build-backend]
+    needs: [determine-version, create-draft-release, build-frontend, build-backend, build-blcu]
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: true
       matrix:
         include:
           - os: windows-latest
             binary: backend-windows-amd64.exe
+            blcu-binary: blcu-programming-windows-amd64.exe
           - os: ubuntu-latest
             binary: backend-linux-amd64
+            blcu-binary: blcu-programming-linux-amd64
           - os: macos-latest
             binary: backend-darwin-arm64
+            blcu-binary: blcu-programming-darwin-arm64
           - os: macos-15-intel
             binary: backend-darwin-amd64
+            blcu-binary: blcu-programming-darwin-amd64
     steps:
       - uses: actions/checkout@v4
 
@@ -150,6 +237,12 @@ jobs:
           name: backend-${{ matrix.os }}
           path: electron-app/binaries
 
+      - name: Download BLCU binary
+        uses: actions/download-artifact@v4
+        with:
+          name: blcu-${{ matrix.os }}
+          path: electron-app/binaries
+
       - name: Set executable permissions (Unix)
         if: runner.os != 'Windows'
         run: chmod +x electron-app/binaries/*
@@ -166,6 +259,12 @@ jobs:
           name: competition-dist
           path: electron-app/renderer/competition-view
 
+      - name: Download flashing-view dist
+        uses: actions/download-artifact@v4
+        with:
+          name: flashing-dist
+          path: electron-app/renderer/flashing-view
+
       - uses: pnpm/action-setup@v4
         with:
           version: 10.26.0

.gitignore

@@ -10,3 +10,7 @@ node_modules/
 
 # Global binaries
 *.exe
+
+# electron modules
+electron-app/python
+electron-app/logger

README.md

@@ -13,6 +13,9 @@ Before starting, ensure you have the following installed:
 - **PNPM** (v10.26.0+)
 - **Node.js** (v20+)
 - **Go** (for the backend)
+- **Python** (v3.11+, for the BLCU programming service)
+
+`pnpm install` automatically creates the Python virtual environment and installs dependencies for the BLCU programming service on Windows, macOS, and Linux.
 
 ---
 
@@ -24,7 +27,9 @@ Our `pnpm-workspace.yaml` defines the following workspaces:
 | :----------------------------- | :------- | :---------------------------------------------------- |
 | `testing-view`                 | TS/React | Web interface for telemetry testing                   |
 | `competition-view`             | TS/React | UI for the competition                                |
+| `flashing-view`                | TS/React | UI for flashing firmware to the BLCU board            |
 | `backend`                      | Go       | Data ingestion and pod communication server           |
+| `blcu-programming`             | Python   | FastAPI service that flashes firmware to the BLCU board via TFTP |
 | `hyperloop-control-station`    | JS       | The main Control Station electron desktop application |
 | `e2e`                          | TS       | End-to-end tests for the whole app (Playwright)       |
 | `@workspace/ui`                | TS/React | Shared UI component library (frontend-kit)            |
@@ -67,8 +72,14 @@ All Turbo scripts support filtering to target specific workspaces:
 - `pnpm build:linux` – Packages the Electron app for Linux.
 - `pnpm build:mac` – Packages the Electron app for macOS.
 
+#### Frontend View Scripts
+
+- `pnpm build:testing-view` – Builds only the Testing View frontend.
+- `pnpm build:competition-view` – Builds only the Competition View frontend.
+- `pnpm build:flashing-view` – Builds only the Flashing View frontend.
+
 #### Utility Scripts
 
 - `pnpm ui:add <component-name>` - To add shadcn/ui components
 
-  > Note: don't forget to also include it in frontend-kit/ui/src/components/shadcn/index.ts to be able to access it from @workspace/ui
+  > Note: don't forget to also include it in frontend-kit/ui/src/components/shadcn/index.ts to be able to access it from @workspace/ui

backend/pkg/adj/validator.go

@@ -1,6 +1,7 @@
 package adj
 
 import (
+	"os"
 	"os/exec"
 	"path"
 	"strings"
@@ -62,6 +63,13 @@ func Validate() {
 // If none of the candidates are found, an empty string is returned,
 // indicating that no Python interpreter is available.
 func pythonCommand() string {
+	// Prefer bundled Python shipped with the Electron app
+	if bundled := os.Getenv("HYPERLOOP_PYTHON_PATH"); bundled != "" {
+		if _, err := os.Stat(bundled); err == nil {
+			return bundled
+		}
+	}
+
 	candidates := []string{"python3", "python", "py"}
 
 	for _, c := range candidates {

blcu-programming/BLCU-config.json

@@ -0,0 +1,44 @@
+{
+  "blcu": {
+    "host": "192.168.0.27",
+    "port": 69,
+    "UDP_PORT_DESTINATION": 50420,
+    "TCP_PORT_SERVER": 50500
+
+  },
+  "adj-data": {
+    "LVBMS": "192.168.1.11",
+    "HVBMS": "192.168.1.17",
+    "PCU": "192.168.1.5",
+    "LCU": "192.168.1.4",
+    "VCU": "192.168.1.3"
+  },
+  "orders":{
+    "Write Program": {"id":"700", "description":"Write Program to BLCU", "enum-order": [
+            "VCU",
+            "HVBMS",
+            "LVBMS",
+            "PCU",
+            "LCU"
+        ]}
+  },
+  "packet":{
+
+    "id": 1,
+    "general_state_machine": [
+      "Connecting",
+      "Operational",
+      "Fault"
+    ] ,
+    "operational_state_machine":[
+      "Idle",
+      "Flashing"
+    ]
+  },
+  "api": {
+    "host": "0.0.0.0",
+    "port": 8069,
+    "log_level": "info"
+  },
+  "log_file": "tftp_server_activity.log"
+}

blcu-programming/BLCU-test-config.json

@@ -0,0 +1,44 @@
+{
+  "blcu": {
+    "host": "127.0.0.27",
+    "port": 69,
+    "UDP_PORT_DESTINATION": 50400,
+    "TCP_PORT_SERVER": 50500
+
+  },
+  "adj-data": {
+    "LVBMS": "192.168.1.11",
+    "HVBMS": "192.168.1.17",
+    "PCU": "192.168.1.5",
+    "LCU": "192.168.1.4",
+    "VCU": "192.168.1.3"
+  },
+  "orders":{
+    "Write Program": {"id":"700", "description":"Write Program to BLCU", "enum-order": [
+            "VCU",
+            "HVBMS",
+            "LVBMS",
+            "PCU",
+            "LCU"
+        ]}
+  },
+  "packet":{
+
+    "id": 134,
+    "general_state_machine": [
+      "Connecting",
+      "Operational",
+      "Fault"
+    ] ,
+    "operational_state_machine":[
+      "Idle",
+      "Flashing"
+    ]
+  },
+  "api": {
+    "host": "0.0.0.0",
+    "port": 8069,
+    "log_level": "info"
+  },
+  "log_file": "tftp_server_activity.log"
+}