From 5b5005f4c96dbce4099130011a16c22848ebdfea Mon Sep 17 00:00:00 2001
From: Mauricio Alvarez Leon <65101411+BBBmau@users.noreply.github.com>
Date: Thu, 12 Dec 2024 10:52:28 -0800
Subject: [PATCH] `docs`: improve flashing device section (#404)

* add note for flashing with M-Series macs

* include mention of QDL mode when flashing device
---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e85278f..12ea94d 100644
--- a/README.md
+++ b/README.md
@@ -30,12 +30,15 @@ Building
 ./build_system.sh
 ```
 
-Flashing to a comma 3/3X:
+Flashing to a comma 3/3X (Be sure to set your device in QDL mode before flashing. Refer to [QDL MODE Section](https://flash.comma.ai/) for more information.):
 ```
 ./flash_kernel.sh
 ./flash_system.sh
 ```
 
+> [!NOTE]
+> If flashing on M-series Macs, you may need to run `brew install libusb` and then `sudo mkdir -p /usr/local/lib && sudo ln -s /opt/homebrew/lib/libusb-1.0.0.dylib /usr/local/lib/libusb.dylib` if getting "No backend available".
+
 Validating changes:
 * Running openpilot is a good smoketest for general AGNOS functionality
 * [CI](https://github.com/commaai/agnos-builder/blob/master/.github/workflows/build.yaml) ensures the kernel and system builds work (and pushes the images for you to download)