From 3d6b1e5dd06a630dfe83bb7710d299e6f0990e28 Mon Sep 17 00:00:00 2001
From: vulpes2 <83679347+vulpes2@users.noreply.github.com>
Date: Sun, 6 Apr 2025 01:40:57 +0000
Subject: [PATCH] Document power state restoration, WoL, WoWLAN and LOM

Signed-off-by: vulpes2 <83679347+vulpes2@users.noreply.github.com>
---
 docs/project/faq.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/project/faq.md b/docs/project/faq.md
index 4381fb61..7b88aa54 100644
--- a/docs/project/faq.md
+++ b/docs/project/faq.md
@@ -82,3 +82,16 @@ Make sure you have the GPU drivers installed. If screen recording is still slow,
 
 ## Chromium / VS Code / Slack / Discord / some other Electron app or Chrome-based browser stopped rendering after an update.
 This is an [upstream Chromium bug](https://bugs.chromium.org/p/chromium/issues/detail?id=1442633) affecting all Chromium-based frameworks such as [Electron](https://github.com/electron/electron/issues/40366). You have to manually delete your shader cache (e.g. `~/.config/Slack/GPUCache`). We can't do anything about it until the fix is backported/released to users.
+
+## Start up automatically after a power failure
+
+This configuration is available at `/sys/bus/platform/devices/macsmc-reboot/ac_power_mode`. Valid options are `off` and `restore`, which is equivalent to the toggle in System Settings on macOS. It is not possible to set the machine to power on unconditionally when power is connected.
+
+## Wake for network access (WoL/WoWLAN)
+
+- Wake on LAN does not work. The BCM57762 gigabit Ethernet controller supports WoL via magic packets, it can be enabled with `ethtool -s REPLACE_WITH_YOUR_INTERFACE wol g`, but the machine does not wake up when it receives magic packets.
+- Wake on Wireless LAN is untested.
+
+## Lights Out Management (LOM)
+
+LOM is only supported on devices with [10Gbps Ethernet cards](https://support.apple.com/guide/deployment/dep580cf25bc/web) enrolled in a mobile device management (MDM) solution. This feature has not yet been reverse engineered.