diff --git a/content/docs/fossvr/envision/wmr_controllers_on_arch.md b/content/docs/fossvr/envision/wmr_controllers_on_arch.md
index 6d9aff9..bb9cdf4 100644
--- a/content/docs/fossvr/envision/wmr_controllers_on_arch.md
+++ b/content/docs/fossvr/envision/wmr_controllers_on_arch.md
@@ -67,3 +67,12 @@ paru -S envision-xr-git
     - Leave Monado open.
     - Start the new game.
 - Always turn on the controllers **before** starting Envision.
+
+- Update controller firmware while running Windows. It's necessary for controllers to work in Linux, updating them from Linux is currently impossible.
+- Make sure that you **don't factory-reset the controllers** (performed by long-pressing the pairing button when controllers are off). This action restores the factory firmware version.
+- If monado fails to start with the following error, you likely need to update the firmware in Mixed Reality Portal:
+    ```
+    WARN [wmr_controller_send_fw_cmd] Controller fw read timed out after 250 ms
+    ERROR [wmr_bt_controller_create] WMR Controller (Bluetooth): Failed to create controller
+    ERROR [wmr_create_bt_controller] Failed to create WMR controller (Bluetooth)
+    ```
\ No newline at end of file