firmware: implement EV3 official firmware restore

Basic support for restoring the official EV3 firmware. Is missing a video
and needs a bunch of helpful error messages, but basic functionality
is working.

Author: dlech

package.json

@@ -35,6 +35,7 @@
         "@types/react-transition-group": "^4.4.10",
         "@types/redux-logger": "^3.0.12",
         "@types/semver": "^7.5.6",
+        "@types/w3c-web-hid": "^1.0.6",
         "@types/w3c-web-usb": "^1.0.10",
         "@types/web-bluetooth": "^0.0.20",
         "@types/web-locks-api": "^0.0.5",

src/firmware/actions.ts

@@ -465,3 +465,45 @@ export const firmwareDidRestoreOfficialEV3 = createAction(() => ({
 export const firmwareDidFailToRestoreOfficialEV3 = createAction(() => ({
     type: 'firmware.action.didFailToRestoreOfficialEV3',
 }));
+
+/**
+ * Low-level action to flash firmware to an EV3 hub.
+ * @param firmware The firmware binary blob.
+ */
+export const firmwareFlashEV3 = createAction((firmware: ArrayBuffer) => ({
+    type: 'firmware.action.flashEV3',
+    firmware,
+}));
+
+/**
+ * Low-level action that indicates {@link firmwareFlashEV3} succeeded.
+ */
+export const firmwareDidFlashEV3 = createAction(() => ({
+    type: 'firmware.action.didFlashEV3',
+}));
+
+/**
+ * Low-level action that indicates {@link firmwareFlashEV3} failed.
+ */
+export const firmwareDidFailToFlashEV3 = createAction(() => ({
+    type: 'firmware.action.didFailToFlashEV3',
+}));
+
+export const firmwareDidReceiveEV3Reply = createAction(
+    (
+        length: number,
+        replyNumber: number,
+        messageType: number,
+        replyCommand: number,
+        status: number,
+        payload: ArrayBufferLike,
+    ) => ({
+        type: 'firmware.action.didReceiveEV3Reply',
+        length,
+        replyNumber,
+        messageType,
+        replyCommand,
+        status,
+        payload,
+    }),
+);

src/firmware/alerts/NoWebHid.tsx

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2025 The Pybricks Authors
+
+import { Intent } from '@blueprintjs/core';
+import { Error } from '@blueprintjs/icons';
+import React from 'react';
+import type { CreateToast } from '../../toasterTypes';
+import { useI18n } from './i18n';
+
+const NoWebHid: React.FunctionComponent = () => {
+    const i18n = useI18n();
+    return (
+        <>
+            <p>{i18n.translate('noWebHid.message')}</p>
+            <p>{i18n.translate('noWebHid.suggestion')}</p>
+        </>
+    );
+};
+
+export const noWebHid: CreateToast = (onAction) => ({
+    message: <NoWebHid />,
+    icon: <Error />,
+    intent: Intent.DANGER,
+    onDismiss: () => onAction('dismiss'),
+});

src/firmware/alerts/index.ts

@@ -1,10 +1,11 @@
 // SPDX-License-Identifier: MIT
-// Copyright (c) 2022 The Pybricks Authors
+// Copyright (c) 2022-2025 The Pybricks Authors
 
 import { dfuError } from './DfuError';
 import { flashProgress } from './FlashProgress';
 import { noDfuHub } from './NoDfuHub';
 import { noDfuInterface } from './NoDfuInterface';
+import { noWebHid } from './NoWebHid';
 import { noWebUsb } from './NoWebUsb';
 import { releaseButton } from './ReleaseButton';
 
@@ -13,6 +14,7 @@ export default {
     flashProgress,
     noDfuHub,
     noDfuInterface,
+    noWebHid,
     noWebUsb,
     releaseButton,
 };

src/firmware/alerts/translations/en.json

@@ -8,6 +8,10 @@
         "message": "This browser does not support WebUSB or WebUSB is not enabled.",
         "suggestion": "Use a supported browser such as Google Chrome or Microsoft Edge."
     },
+    "noWebHid": {
+        "message": "This browser does not support WebHID or WebHID is not enabled.",
+        "suggestion": "Use a supported browser such as Google Chrome or Microsoft Edge."
+    },
     "noDfuHub": {
         "message": "Could not find your hub?",
         "suggestion1": {

src/firmware/assets/EV3_Firmware_V1.09H.bin

@@ -453,7 +453,8 @@ export const InstallPybricksDialog: React.FunctionComponent = () => {
     const inProgress = useSelector(
         (s) =>
             s.firmware.isFirmwareFlashUsbDfuInProgress ||
-            s.firmware.isFirmwareRestoreOfficialDfuInProgress,
+            s.firmware.isFirmwareRestoreOfficialDfuInProgress ||
+            s.firmware.isFirmwareFlashEV3InProgress,
     );
     const dispatch = useDispatch();
     const [hubName, setHubName] = useState('');

src/firmware/assets/ev3-image-1.10e.bin

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-// Copyright (c) 2021-2023 The Pybricks Authors
+// Copyright (c) 2021-2025 The Pybricks Authors
 
 import { AnyAction } from 'redux';
 import {
@@ -23,6 +23,7 @@ test('initial state', () => {
           "installPybricksDialog": {
             "isOpen": false,
           },
+          "isFirmwareFlashEV3InProgress": false,
           "isFirmwareFlashUsbDfuInProgress": false,
           "isFirmwareRestoreOfficialDfuInProgress": false,
           "progress": null,