feat(companion): add Wake-on-LAN configuration commands and UI

Wires the firmware WOL module up to the companion protocol and app:

- New COMMAND_ID values (SET_WOL_ENABLED, SET_WOL_WIFI_SSID,
  SET_WOL_WIFI_PASSWORD, SET_WOL_TARGET_MAC) at 0x46-0x49, placed after
  the existing SET_EDGE_PROFILE_SWITCHING_BLOCKED (0x45) so they don't
  collide with any currently-assigned command ID. PROTOCOL_MINOR bumped
  to 23 for the new commands and status flag.
- src/companion.cpp: command handlers for the four new commands, plus a
  wolControl status flag (protocol-minor gated) so the companion app can
  tell whether the connected firmware supports WOL at all.
- Companion app: new Wake-on-LAN section in Bridge Settings with an
  enable toggle, Wi-Fi SSID/password fields, and a target MAC address
  field, wired through preload/IPC/bridge-service the same way existing
  settings are. Hidden entirely on firmware without ENABLE_WOLWIFI
  (i.e. wolControl false).

Both sides were verified against each other end-to-end on real hardware:
controller connects while the target PC is off -> WOL fires, gets
ARP-confirmed, PC wakes, controller stays connected through the boot.

Author: gunCannoli

README.md

@@ -75,6 +75,8 @@ on the controller until its lightbar rapidly blinks blue.
 - Switch the host persona between DualSense, DualSense Edge, DualShock 4, and Xbox modes.
 - See Bluetooth signal quality at a glance.
 - Mount, flash, or nuke Pico firmware from Bridge Settings.
+- Wake your PC over Wi-Fi (Wake-on-LAN) just by connecting your controller
+  (Waveshare RP2350B-Plus-W only).
 
 ## Explore Kitsune Input
 
@@ -187,12 +189,70 @@ saved but inactive.
 ### Bridge Settings
 
 Set theme, UI scale, tray and startup behavior, firmware maintenance, power
-saving, LEDs, shortcuts, idle disconnect, and PC sleep disconnect.
+saving, LEDs, shortcuts, idle disconnect, PC sleep disconnect, and Wake-on-LAN.
 
 <p align="center">
   <img src="assets/readme/app-bridge-settings.png" width="680" alt="Bridge Settings dialog in the DS5 Bridge companion app">
 </p>
 
+## Wake-on-LAN
+
+On the Waveshare RP2350B-Plus-W board, DS5 Bridge can wake your PC over Wi-Fi
+the moment your DualSense controller connects — no keyboard, mouse, or
+Ethernet magic-packet utility needed. This is a separate mechanism from the
+existing USB-based "Wake PC on Controller" toggle: that one relies on USB
+remote wake and only works while the Pico stays connected to a PC that is
+merely asleep, not fully powered off. Wake-on-LAN instead sends a real network
+magic packet, so it can wake a PC that's been shut down, as long as the PC's
+network adapter has Wake-on-LAN enabled.
+
+### How it works
+
+1. When your controller connects to the Pico, the firmware first checks
+   whether the target PC already looks awake over USB (so it never sends an
+   unnecessary wake packet, or interrupts you with a lightbar pulse, while
+   you're already at your desk with everything on).
+2. If the PC looks like it needs waking, the Pico connects to your Wi-Fi
+   network using the CYW43 radio it already has onboard for Bluetooth, and
+   sends a standard UDP Wake-on-LAN magic packet addressed to your PC's MAC
+   address.
+3. The firmware watches for the target to come back on the network (via ARP)
+   and resends the magic packet a few times if needed, so a single dropped
+   packet on a slow-to-associate Wi-Fi network doesn't leave your PC asleep.
+4. All of this runs alongside normal Bluetooth/controller operation. A
+   missing Wi-Fi network, wrong credentials, or an unreachable target PC never
+   blocks or delays controller pairing, input, or audio — Wake-on-LAN is
+   strictly best-effort.
+
+### Setup
+
+1. Open **Bridge Settings** in the companion app and find the **Wake-on-LAN**
+   section.
+2. Turn on **Wake PC over Wi-Fi**.
+3. Enter the **Wi-Fi Network** name (SSID) and **Wi-Fi Password** the Pico
+   should use to reach your PC's network. This can be the same network your
+   PC is on, or any network that can route a magic packet to it.
+4. Enter your PC's **Target MAC Address** (`AA:BB:CC:DD:EE:FF`) — use the MAC
+   address of the network adapter you want to wake, not necessarily the one
+   currently active.
+5. In Windows, make sure Wake-on-LAN is enabled for that network adapter
+   (Device Manager → adapter **Properties** → **Power Management** → *Allow
+   this device to wake the computer*, and, for wired adapters, the matching
+   *Wake on Magic Packet* option in **Advanced**) and that fast startup is
+   configured in a way that's compatible with your adapter's wake support.
+
+### Requirements
+
+- Waveshare RP2350B-Plus-W board. Wake-on-LAN firmware builds are gated
+  behind this board at compile time (not because other CYW43-equipped
+  boards like Pico W/Pico 2 W lack the radio — it's only been built and
+  tested on Waveshare so far); other boards simply don't show the
+  Wake-on-LAN section in the app.
+- A Wi-Fi network that can reach your PC's network segment.
+- Wake-on-LAN enabled on the target PC's network adapter and in its BIOS/UEFI
+  power settings, and the adapter's wake support has to survive a full
+  shutdown (not just sleep) for the "wake from off" case.
+
 ## Troubleshooting
 
 - Use the companion app and firmware from the same release when possible.
@@ -233,6 +293,7 @@ steps.
 | `src/companion.cpp` | Vendor HID companion protocol, status reports, command ACKs, and runtime setting dispatch. |
 | `src/usb.cpp` | TinyUSB audio control callbacks and runtime settings fallback. |
 | `src/usb_descriptors.c` | USB device, configuration, HID report, audio, and string descriptors. |
+| `src/wolwifi.cpp` | Wake-on-LAN over Wi-Fi: host-alive gate, Wi-Fi connect, and magic-packet send/resend (Waveshare RP2350B-Plus-W only). |
 | `companion/` | Electron companion app source, protocol parser, HID service, assets, and UI. |
 | `companion/native/AudioHelper/` | Windows audio helper used by the companion app for audio sessions, haptics mirroring, endpoint setup, and media integrations. |
 | `.github/workflows` | CI and release builds. |

companion/src/main/bridge-service.test.ts

@@ -143,6 +143,7 @@ const FULL_REAPPLY_COMMANDS = [
   COMMAND_ID.SET_IDLE_DISCONNECT_TIMEOUT,
   COMMAND_ID.SET_USB_SUSPEND_DISCONNECT_ENABLED,
   COMMAND_ID.SET_WAKE_ON_CONNECT,
+  COMMAND_ID.SET_WOL_ENABLED,
   COMMAND_ID.SET_SLEEP_KEYBIND_ENABLED,
   COMMAND_ID.SET_SPEAKER_VOLUME_SHORTCUT_ENABLED,
   COMMAND_ID.SET_BUTTON_REMAP,
@@ -2696,6 +2697,33 @@ describe('BridgeService', () => {
     expect(commands[2]?.slice(11, 17)).toEqual([0xaa, 0xbb, 0xcc, 0xdd, 0xee, 0xff]);
   });
 
+  it('sends the SSID/password byte length in the command value, not 0', async () => {
+    // Regression test: setWolWifiSsid/setWolWifiPassword used to hardcode
+    // the command's value field to 0 instead of the payload length, so
+    // firmware (which reads value as the byte count to copy) always saw a
+    // zero-length string and silently kept have_ssid=false no matter what
+    // was typed in the UI -- Wi-Fi never got the actual SSID.
+    const service = serviceFixture();
+    const device = new MockHidDevice();
+    device.status = statusReport({ controllerConnected: false });
+    hidMock.state.devicesList = [companionDeviceInfo()];
+    hidMock.state.openDevices.set('companion-path', device);
+
+    await poll(service);
+    await service.setWolWifiSsid('Sweet-Home');
+    await service.setWolWifiPassword('correct horse battery staple');
+
+    const ssidReport = device.sentReports.find((report) => report[7] === COMMAND_ID.SET_WOL_WIFI_SSID);
+    const passwordReport = device.sentReports.find((report) => report[7] === COMMAND_ID.SET_WOL_WIFI_PASSWORD);
+
+    expect(ssidReport?.[9]).toBe('Sweet-Home'.length);
+    expect(ssidReport?.slice(11, 11 + 'Sweet-Home'.length).map((byte) => String.fromCharCode(byte)).join('')).toBe('Sweet-Home');
+
+    const password = 'correct horse battery staple';
+    expect(passwordReport?.[9]).toBe(password.length);
+    expect(passwordReport?.slice(11, 11 + password.length).map((byte) => String.fromCharCode(byte)).join('')).toBe(password);
+  });
+
   it('sends Pico bootloader command and tolerates the expected transport drop', async () => {
     const service = serviceFixture();
     const device = new MockHidDevice();

companion/src/main/bridge-service.ts

@@ -40,7 +40,10 @@ import {
   hostPersonaModeValue,
   normalizeChordControllerSettingStepPercent,
   normalizeBridgePresetId,
-  pollingRateModeValue
+  pollingRateModeValue,
+  wolTargetMacPayload,
+  wolWifiPasswordPayload,
+  wolWifiSsidPayload
 } from '../shared/protocol';
 import type {
   AdaptiveTriggerPreviewEffect,
@@ -1304,7 +1307,9 @@ export class BridgeService extends EventEmitter {
     [SHORTCUT_EVENT.MIC_MUTE_OFF]: () => this.applyControllerMicMuteEvent(false)
   };
 
-  constructor(private readonly settingsStore: SettingsStore) {
+  constructor(
+    private readonly settingsStore: SettingsStore
+  ) {
     super();
     this.snapshot = {
       state: 'no-bridge',
@@ -2954,6 +2959,45 @@ export class BridgeService extends EventEmitter {
     return this.getSnapshot();
   }
 
+  async setWolEnabled(enabled: boolean): Promise<BridgeSnapshot> {
+    await this.sendSettingCommand(COMMAND_ID.SET_WOL_ENABLED, enabled ? 1 : 0, {
+      wolEnabled: enabled
+    });
+    return this.getSnapshot();
+  }
+
+  async setWolWifiSsid(ssid: string): Promise<BridgeSnapshot> {
+    const payload = wolWifiSsidPayload(ssid);
+    await this.sendSettingCommand(
+      COMMAND_ID.SET_WOL_WIFI_SSID,
+      payload.length,
+      { wolWifiSsid: ssid },
+      payload
+    );
+    return this.getSnapshot();
+  }
+
+  async setWolWifiPassword(password: string): Promise<BridgeSnapshot> {
+    const payload = wolWifiPasswordPayload(password);
+    await this.sendSettingCommand(
+      COMMAND_ID.SET_WOL_WIFI_PASSWORD,
+      payload.length,
+      { wolWifiPassword: password },
+      payload
+    );
+    return this.getSnapshot();
+  }
+
+  async setWolTargetMac(mac: string): Promise<BridgeSnapshot> {
+    await this.sendSettingCommand(
+      COMMAND_ID.SET_WOL_TARGET_MAC,
+      0,
+      { wolTargetMac: mac },
+      wolTargetMacPayload(mac)
+    );
+    return this.getSnapshot();
+  }
+
   async setSleepKeybindEnabled(enabled: boolean): Promise<BridgeSnapshot> {
     await this.sendSettingCommand(COMMAND_ID.SET_SLEEP_KEYBIND_ENABLED, enabled ? 1 : 0, {
       sleepKeybindEnabled: enabled
@@ -4040,6 +4084,31 @@ export class BridgeService extends EventEmitter {
       settings.wakeOnConnectEnabled ? 1 : 0,
       { expectSettingsRevisionChange }
     );
+    await this.sendCommand(
+      COMMAND_ID.SET_WOL_ENABLED,
+      settings.wolEnabled ? 1 : 0,
+      { expectSettingsRevisionChange }
+    );
+    if (settings.wolWifiSsid) {
+      const ssidPayload = wolWifiSsidPayload(settings.wolWifiSsid);
+      await this.sendCommand(COMMAND_ID.SET_WOL_WIFI_SSID, ssidPayload.length, {
+        expectSettingsRevisionChange,
+        extraPayload: ssidPayload
+      });
+    }
+    if (settings.wolWifiPassword) {
+      const passwordPayload = wolWifiPasswordPayload(settings.wolWifiPassword);
+      await this.sendCommand(COMMAND_ID.SET_WOL_WIFI_PASSWORD, passwordPayload.length, {
+        expectSettingsRevisionChange,
+        extraPayload: passwordPayload
+      });
+    }
+    if (settings.wolTargetMac) {
+      await this.sendCommand(COMMAND_ID.SET_WOL_TARGET_MAC, 0, {
+        expectSettingsRevisionChange,
+        extraPayload: wolTargetMacPayload(settings.wolTargetMac)
+      });
+    }
     await this.sendCommand(
       COMMAND_ID.SET_SLEEP_KEYBIND_ENABLED,
       settings.sleepKeybindEnabled ? 1 : 0,

companion/src/main/ipc-contract.test.ts

@@ -139,4 +139,19 @@ describe('IPC contract', () => {
     expect(mainSource).toContain("ipcMain.handle('bridge:setWakeOnConnectEnabled'");
     expect(bridgeServiceSource).toContain('setWakeOnConnectEnabled(enabled: boolean): Promise<BridgeSnapshot>');
   });
+
+  it('exposes the Wake-on-LAN over Wi-Fi preferences', () => {
+    expect(preloadSource).toContain("ipcRenderer.invoke('bridge:setWolEnabled', value)");
+    expect(preloadSource).toContain("ipcRenderer.invoke('bridge:setWolWifiSsid', value)");
+    expect(preloadSource).toContain("ipcRenderer.invoke('bridge:setWolWifiPassword', value)");
+    expect(preloadSource).toContain("ipcRenderer.invoke('bridge:setWolTargetMac', value)");
+    expect(mainSource).toContain("ipcMain.handle('bridge:setWolEnabled'");
+    expect(mainSource).toContain("ipcMain.handle('bridge:setWolWifiSsid'");
+    expect(mainSource).toContain("ipcMain.handle('bridge:setWolWifiPassword'");
+    expect(mainSource).toContain("ipcMain.handle('bridge:setWolTargetMac'");
+    expect(bridgeServiceSource).toContain('async setWolEnabled(enabled: boolean): Promise<BridgeSnapshot>');
+    expect(bridgeServiceSource).toContain('async setWolWifiSsid(ssid: string): Promise<BridgeSnapshot>');
+    expect(bridgeServiceSource).toContain('async setWolWifiPassword(password: string): Promise<BridgeSnapshot>');
+    expect(bridgeServiceSource).toContain('async setWolTargetMac(mac: string): Promise<BridgeSnapshot>');
+  });
 });

companion/src/main/main.ts

@@ -1138,6 +1138,18 @@ function registerIpc(service: BridgeService): void {
   ipcMain.handle('bridge:setWakeOnConnectEnabled', (_event, value: boolean) => (
     service.setWakeOnConnectEnabled(value)
   ));
+  ipcMain.handle('bridge:setWolEnabled', (_event, value: boolean) => (
+    service.setWolEnabled(value)
+  ));
+  ipcMain.handle('bridge:setWolWifiSsid', (_event, value: string) => (
+    service.setWolWifiSsid(value)
+  ));
+  ipcMain.handle('bridge:setWolWifiPassword', (_event, value: string) => (
+    service.setWolWifiPassword(value)
+  ));
+  ipcMain.handle('bridge:setWolTargetMac', (_event, value: string) => (
+    service.setWolTargetMac(value)
+  ));
   ipcMain.handle('bridge:setSleepKeybindEnabled', (_event, value: boolean) => (
     service.setSleepKeybindEnabled(value)
   ));

companion/src/main/settings-store.ts

@@ -11,6 +11,8 @@ import {
   MAX_CHORD_FUNCTION_NAME_LENGTH,
   MAX_KEYBOARD_FUNCTION_KEYS,
   REMAP_BUTTON_IDS,
+  WOL_WIFI_PASSWORD_MAX_LENGTH,
+  WOL_WIFI_SSID_MAX_LENGTH,
   clampAudioInterleaveValues,
   defaultChordControllerSettingStepPercent,
   isChordBindingAllowed,
@@ -200,6 +202,10 @@ export const DEFAULT_SETTINGS: CompanionSettings = {
   idleDisconnectTimeoutMinutes: 15,
   usbSuspendDisconnectEnabled: true,
   wakeOnConnectEnabled: true,
+  wolEnabled: false,
+  wolWifiSsid: '',
+  wolWifiPassword: '',
+  wolTargetMac: '',
   sleepKeybindEnabled: DEFAULT_CONTROLLER_PROFILE_SETTINGS.sleepKeybindEnabled,
   speakerVolumeShortcutEnabled: DEFAULT_CONTROLLER_PROFILE_SETTINGS.speakerVolumeShortcutEnabled,
   pollingRateMode: DEFAULT_CONTROLLER_PROFILE_SETTINGS.pollingRateMode,
@@ -1039,6 +1045,18 @@ function normalizeSettings(value: Partial<CompanionSettings> | null | undefined)
     wakeOnConnectEnabled: typeof value?.wakeOnConnectEnabled === 'boolean'
       ? value.wakeOnConnectEnabled
       : DEFAULT_SETTINGS.wakeOnConnectEnabled,
+    wolEnabled: typeof value?.wolEnabled === 'boolean'
+      ? value.wolEnabled
+      : DEFAULT_SETTINGS.wolEnabled,
+    wolWifiSsid: typeof value?.wolWifiSsid === 'string'
+      ? value.wolWifiSsid.slice(0, WOL_WIFI_SSID_MAX_LENGTH)
+      : DEFAULT_SETTINGS.wolWifiSsid,
+    wolWifiPassword: typeof value?.wolWifiPassword === 'string'
+      ? value.wolWifiPassword.slice(0, WOL_WIFI_PASSWORD_MAX_LENGTH)
+      : DEFAULT_SETTINGS.wolWifiPassword,
+    wolTargetMac: typeof value?.wolTargetMac === 'string'
+      ? value.wolTargetMac.trim()
+      : DEFAULT_SETTINGS.wolTargetMac,
     sleepKeybindEnabled: typeof value?.sleepKeybindEnabled === 'boolean'
       ? value.sleepKeybindEnabled
       : DEFAULT_SETTINGS.sleepKeybindEnabled,

companion/src/preload.ts

@@ -140,6 +140,18 @@ const api = {
   setWakeOnConnectEnabled: (value: boolean): Promise<BridgeSnapshot> => (
     ipcRenderer.invoke('bridge:setWakeOnConnectEnabled', value)
   ),
+  setWolEnabled: (value: boolean): Promise<BridgeSnapshot> => (
+    ipcRenderer.invoke('bridge:setWolEnabled', value)
+  ),
+  setWolWifiSsid: (value: string): Promise<BridgeSnapshot> => (
+    ipcRenderer.invoke('bridge:setWolWifiSsid', value)
+  ),
+  setWolWifiPassword: (value: string): Promise<BridgeSnapshot> => (
+    ipcRenderer.invoke('bridge:setWolWifiPassword', value)
+  ),
+  setWolTargetMac: (value: string): Promise<BridgeSnapshot> => (
+    ipcRenderer.invoke('bridge:setWolTargetMac', value)
+  ),
   setSleepKeybindEnabled: (value: boolean): Promise<BridgeSnapshot> => (
     ipcRenderer.invoke('bridge:setSleepKeybindEnabled', value)
   ),