Skip to content

richdonne/ch340g-ch34g-ch34x-mac-os-x-driver

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ch340g-ch34g-ch34x-mac-os-x-driver

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.

Introduction

Version 1.3 (2016-09-27) of the OEM driver for the CH34x chipset currently causes a kernel panic (a.k.a. crash) when installed on macOS Sierra. To resolve this issue, please download and install the driver in this repo.

Installation

  • 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

Installation with Homebrew-Cask

  • 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

Troubleshooting

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 press Enter.
  • Restart your Mac.

Please share this page!

Regards,
Adrian Mihalko
www.mihalko.eu

p.s: I LOVE coffee! Buy me a coffee at:
Donate

About

CH340G CH34G CH34X Mac OS X driver

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 100.0%