Skip to content

Instantly share code, notes, and snippets.

@darrenpmeyer
Created October 17, 2018 18:41
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save darrenpmeyer/bd10b6c3a3a21ec7da107bb428450f06 to your computer and use it in GitHub Desktop.
Save darrenpmeyer/bd10b6c3a3a21ec7da107bb428450f06 to your computer and use it in GitHub Desktop.
FIX - Wemos D1 mini crashes macOS 10.13 High Sierra when plugged in via USB

tl;dr: the D1 mini's usbserial interface is a little sketchy and macOS doesn't cope well. You need to install the driver from wch.cn. direct link to CH341SER_MAC.ZIP

SHA-512 sum (copy whole line, run pbpaste | shasum -c in your download directory to check):

efb25faeb87d66a10e284629231fad7ebfbdbf2c2a50ed9b35f8dd9793398ff79df3da3312367dbc497dc62103195bc4eaf6399f8084f442bb1d1a7a51551eac *CH341SER_MAC.ZIP

Problem

When plugging a Wemos D1 mini via USB into a Mac running macOS High Sierra (10.13) -- and possibly other versions -- I experienced an immediate and repeatable crash.

Diagnostic

Examining the crash report offered on reboot, I observed the following line:

last loaded kext at 79125794784: com.wch.usbserial	1 (addr 0xffffff7f89fbe000, size 36864)

This made me suspect that a usbserial driver might be needed; DuckDuckGo searches confirmed from several sources that a driver for the WCH usbserial interface was required for macOS. Examining the vendor's website revealed a download for a Mac driver.

Solution

  1. Ensure Wemos D1 mini is disconnected
  2. Using the vendor's driver download page, download CH314SER_MAC.ZIP
  3. Unpack the zip. From the created folder, run CH34x_Install_V1.4.pkg ; this will require a restart
  4. After restart is complete, reconnect Wemos D1 mini

If no crash or restart occurs after reconnection, you've solved the problem.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment