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/**"

.gitignore

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

README.md

@@ -13,6 +13,7 @@ Before starting, ensure you have the following installed:
 - **PNPM** (v10.26.0+)
 - **Node.js** (v20+)
 - **Go** (for the backend)
+- **Python** (v3.8+, for the BLCU programming service)
 
 ---
 
@@ -25,6 +26,7 @@ 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                                |
 | `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)            |

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,42 @@
+{
+  "blcu": {
+    "host": "192.168.0.27",
+    "port": 69,
+    "UDP_PORT_DESTINATION": 50420,
+    "TCP_PORT_SERVER": 50500
+
+  },
+  "adj-data": {
+
+    "BCU": "192.168.2.16",
+    "LVBMS": "192.168.1.11",
+    "HVBMS": "192.168.1.17",
+    "PCU": "192.168.1.5",
+    "TCU": "127.0.0.1",
+    "LCU": "192.168.1.4",
+    "VCU": "192.168.1.3"
+
+  },
+  "orders":{
+    "Write Program": "700"
+  },
+  "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/README.md

@@ -1,76 +1,50 @@
-# TFTP Server and Client
+# BLCU - Programming
 
-**TFTP Server and Client** is a comprehensive Python-based application designed to facilitate Trivial File Transfer Protocol (TFTP) operations through a user-friendly graphical interface built with PyQt5. This tool allows users to efficiently manage file transfers to and from TFTP servers, making it an essential resource for network administrators.
+FastAPI service that bridges the *Flashing view* in the Control Station and the BLCU hardware board, transferring firmware files over TFTP.
 
-## Key Features
+## How it works
 
-### TFTP Server
-- **Start/Stop Server:** Easily control the TFTP server with start and stop functionalities.
-- **Select IP Address:** Choose the specific IP address for the server to listen on.
-- **Change Working Directory:** Modify the current working directory for file transfers with a straightforward interface.
-- **View Directory Contents:** Quickly access and view files in the current working directory.
-- **Logging:** Track server activity with real-time logging displayed in the application and stored in a log file.
-[tftp_server](../TFTP_GUI_Server_Client/screenshot/tftp_server.png)
-### TFTP Client
-- **Upload Files:** Seamlessly upload files to a TFTP server using a simple interface.
-- **Download Files:** Effortlessly download files from a TFTP server with progress monitoring.
-- **File Browsing:** Use an integrated file dialog for easy file selection.
-- **Status Updates:** Receive real-time status updates during upload and download processes.
-[tftp_client](../TFTP_GUI_Server_Client/screenshot/tftp_client.png)
-### Monitoring and Alerts
-- Monitor TFTP server activities and transfer statuses with immediate feedback on successes or failures.
-- Real-time updates ensure that users can track the progress of their operations.
+```
+Control Station (Electron)
+        |
+        | HTTP  (port 8069)
+        v
+  api/main.py  (FastAPI)
+        |
+        | TFTP  (UDP port 69)
+        v
+  BLCU board @ 192.168.0.27
+```
 
-### Error Handling and Prompt Detection
-- Implement robust error handling specific to TFTP operations to ensure smooth functionality.
-- Dynamic prompt detection allows the application to handle varying device responses effectively.
+## API endpoints
 
-## Example Configurations
+| Method | Path        | Description                          |
+| :----- | :---------- | :----------------------------------- |
+| GET    | `/health`   | Health check                         |
+| POST   | `/upload`   | Send a local firmware file to BLCU   |
+| POST   | `/download` | Fetch a file from BLCU to local disk |
+| GET    | `/logs`     | Tail the TFTP activity log           |
 
-### Setting Up the TFTP Server
-1. Launch the application and navigate to the TFTP Server tab.
-2. Select an available IP address from the dropdown menu.
-3. Specify the desired port number (default is 69).
-4. Click **Start Server** to begin listening for incoming TFTP requests.
+## Development
 
-### Uploading Files
-1. Navigate to the TFTP Client tab.
-2. Enter the TFTP server IP address.
-3. Use the **Browse Upload...** button to select the file you wish to upload.
-4. Click **Upload File** and monitor the status for updates.
+Dependencies are managed via a Python virtual environment. `pnpm install` creates and populates it automatically.
 
-### Downloading Files
-1. Enter the TFTP server IP address and specify the file name for download.
-2. Click **Download File** to initiate the download process.
-3. Progress and status will be displayed in real time.
+```bash
+# From the repo root — starts all services including this one
+pnpm dev
 
-## System Requirements
+# Or run only this service
+pnpm --filter blcu-programming dev
+```
 
-To run the TFTP Server and Client application, the following system requirements must be met:
+The service starts on `http://127.0.0.1:8069` by default. Override with environment variables:
 
-- **Python 3.x**
-- **PyQt5**
-- **TFTP Library** 
-- **OS:** Windows 10 or Ubuntu >=20.04 (recommended) or any modern Linux distribution 
+```bash
+BLCU_API_HOST=0.0.0.0 BLCU_API_PORT=9000 pnpm --filter blcu-programming dev
+```
 
-## Technologies Used
+## Setup (first time)
 
-- **Python:** The core language utilized for backend logic.
-- **PyQt5:** The framework used for developing the graphical user interface.
-- **TFTP Library:** Employed for implementing TFTP protocol functionalities.
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Contributing
-
-Contributions are welcome! Please fork the repository and create a pull request with your enhancements. Alternatively, you can open an issue to suggest improvements or report bugs.
-
-## Author
-
-**petrunetworking** (Network Engineer)
-
-## Acknowledgements
-
-Developed using Python and inspired by the need for efficient file transfer solutions, this application aims to simplify TFTP operations for network professionals, enabling them to manage their file transfers effectively and reliably.
+```bash
+pnpm install   # creates .venv and installs Python deps via postinstall
+```

blcu-programming/api/board_pinger.py

@@ -0,0 +1,50 @@
+import subprocess
+import threading
+
+from api.config import load
+
+_cfg = load()
+_BOARDS: dict[str, str] = _cfg["adj-data"]
+
+_status: dict[str, bool] = {name: False for name in _BOARDS}
+_lock = threading.Lock()
+
+PING_INTERVAL = 60
+
+
+def get_board_status() -> dict[str, bool]:
+    with _lock:
+        return dict(_status)
+
+
+def _ping(ip: str) -> bool:
+    try:
+        result = subprocess.run(
+            ["ping", "-c", "1", "-W", "1", ip],
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            timeout=3,
+        )
+        return result.returncode == 0
+    except Exception:
+        return False
+
+
+def _ping_all() -> None:
+    results = {name: _ping(ip) for name, ip in _BOARDS.items()}
+    with _lock:
+        _status.update(results)
+
+
+
+def _run(stop: threading.Event) -> None:
+    while not stop.is_set():
+        _ping_all()
+        stop.wait(PING_INTERVAL)
+
+
+def start() -> threading.Event:
+    stop = threading.Event()
+    t = threading.Thread(target=_run, args=(stop,), daemon=True, name="board-pinger")
+    t.start()
+    return stop

blcu-programming/api/config.py

@@ -0,0 +1,10 @@
+import json
+from pathlib import Path
+
+_ROOT = Path(__file__).parent.parent
+_CONFIG_PATH = _ROOT / "BLCU-config.json"
+
+
+def load() -> dict:
+    with _CONFIG_PATH.open(encoding="utf-8") as f:
+        return json.load(f)