Latest macOS Sierra-compatible driver for devices using the CH340G, CH34G or CH34X chipset. This chipset is used in several Arduino-compatible clones and serial-to-USB cables.
Version 1.4 (2017-01-11) of the OEM driver for the CH34x chipset.
Version 1.3 (2016-09-27) of the OEM driver causes a kernel panic (a.k.a. crash) when installed on macOS Sierra.
- Remove the old driver by issuing one of the following commands (depending on your installation):
sudo rm -rf /System/Library/Extensions/usb.kext
sudo rm -rf /Library/Extensions/usbserial.kext
- Restart your Mac.
- Double-click on the
CH34x_Install_V1.3.pkg
file. - Restart your Mac.
- Plug in your device. It should now be listed under the
/dev
directory. Examples: /dev/cu.wchusbserial1410
/dev/cu.wchusbserial1420
- Install the driver by the following commands:
brew tap mengbo/ch340g-ch34g-ch34x-mac-os-x-driver https://github.com/mengbo/ch340g-ch34g-ch34x-mac-os-x-driver
brew cask install wch-ch34x-usb-serial-driver
If the device doesn't show up under /dev
, check the section "Security and Privacy" in System Preferences for any notices about blocked software.
Note: disabling System Integrity Protection is no longer necessary, as the current drivers are properly signed by the OEM. If you're having problems, they're almost certainly not related to SIP. The instructions below are left only for reference purposes. If you had previously disabled it (especially if you did so completely), you are strongly encouraged to fully re-enable SIP.
If, and only if, the device is not recognized after the installation (or you cannot install the driver), please disable System Integrity Protection:
- Reboot your Mac into Recovery Mode by restarting your computer and holding down
Command+R
until the Apple logo appears on screen. - Open the Terminal (Applications > Utilities > Terminal).
- In the Terminal window, type in
csrutil enable --without kext
(or to fully disable:csrutil disable
) and pressEnter
. - Restart your Mac.
Please share this page!
Regards,
Adrian Mihalko
www.mihalko.eu