Add info about missing CH341 driver for Mac OS (#774)
What the developer wrote
Authored by Tads
Add info about missing CH341 driver for Mac OS (#774)
What changed, and why it matters
This commit only adds documentation text telling macOS users how to install a missing USB driver (CH341) if they have trouble flashing their Krux device. There are no code changes, no bug fixes, and no security-related changes.
No security action needed; this is a documentation-only change.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff adds a documentation snippet (docs/snippets/error-flashing-mac.en.txt) and includes it in two Markdown documentation files. It explains that flashing errors on macOS can occur when the CH341 USB-to-serial driver is absent and points users to the vendor’s driver download page. No source code, build scripts, firmware, or cryptographic logic is modified.
Changed components
docs/getting-started/installing/from-gui/usage.en.mddocs/snippets/error-flashing-mac.en.txtdocs/troubleshooting.en.mdInspect captured patch +8 / −0
diff --git a/docs/getting-started/installing/from-gui/usage.en.md b/docs/getting-started/installing/from-gui/usage.en.md
index f249ea3..3ea25d2 100644
--- a/docs/getting-started/installing/from-gui/usage.en.md
+++ b/docs/getting-started/installing/from-gui/usage.en.md
@@ -204,6 +204,9 @@ flash-krux-logo.en.txt
error-flashing-windows.en.txt
----8<----
+----8<----
+error-flashing-mac.en.txt
+----8<----
#### Air-gapped update with
diff --git a/docs/snippets/error-flashing-mac.en.txt b/docs/snippets/error-flashing-mac.en.txt
new file mode 100644
index 0000000..05fce72
--- /dev/null
+++ b/docs/snippets/error-flashing-mac.en.txt
@@ -0,0 +1 @@
+On macOS, you may also run into flashing errors. This often happens when the CH341 USB driver is missing, preventing proper communication with the device. To fix it, download and install the [CH341 driver](https://www.wch-ic.com/downloads/CH341SER_MAC_ZIP.html).
\ No newline at end of file
diff --git a/docs/troubleshooting.en.md b/docs/troubleshooting.en.md
index 1d39642..cd8cc94 100644
--- a/docs/troubleshooting.en.md
+++ b/docs/troubleshooting.en.md
@@ -48,6 +48,10 @@ If flashing fails with an error: `Greeting fail, check serial port (SLIP receive
error-flashing-windows.en.txt
----8<----
+----8<----
+error-flashing-mac.en.txt
+----8<----
+
## **After Installing**
Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.