How To Use Arduino Nano Mini Pro With CH340G On Mac Osx Yosemite

Introduction — What is CH340G?

My golden rule is that if something took me longer than 15 minutes to figure out, then it’s worth documenting in a tiny blog post so that it would save time to others, just like many other similar posts saved me million hours by providing simple clear instructions.

Change Log

* Updated Mar, 2020 with the new blog redesign
* Updated Nov, 2017 with the latest driver for OS-X High Sierra
* Updated Oct, 2016 with the new signed driver for OS-X Sierra
* Updated Jan, 2016 with Windows Drivers
* Updated Nov, 2015 with new driver for OS-X El Capitan & Yosemite

Recent versions of cheap Chinese clones of Arduino boards have been coming with a different USB/Serial chip, which replaces the usual FTDI. I read somewhere that licensing costs of FTDI make it prohibitive to companies selling boards for as little as $3, so I assume this is the main motivation. To be honest, as long as I can talk to my Arduino and buy it for $3 a piece, who cares? :)

Below you’ll find links to drivers for both Windows and Mac to make these work. Please leave a comment, if it worked or didn’t work for you, especially if you had to do anything special or hacky to make it work :)

Nano Bottom

Drivers for USB Connection

Windows

A fully signed drivers for Windows can be found below:

Mac OS-X

High Sierra (Added: November, 2017)

Looks like the updated version from their site works now as is. Here is the updated CH341SER_MAC.ZIP (148KB) cached locally, but for other platforms, please checkout their website.

Sierra (Added: October, 2016)

The Version 1.3 of the driver available on the vendor’s website causes a crash on Mac OS-X Sierra. Thankfully, Adrian Mihalko patched the driver, and made it available to the public.

Thanks to this source for patching the driver: https://github.com/adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver for patching the driver.

El Capitán (Added: Nov 22, 2015)

Many instructions down below were written for the old driver, which was not signed, and therefore was not working out of the box on OS-X Yosemite and El Capitan. The latest driver appears to be signed, and should work out the box. The new driver is here: CH34x_Install.zip (111Kb).

Thanks to Björn’s Techblog for posting the driver.

Inside the driver is a brief README with the following instructions:

Driver README

CH34X USB-SERIAL DRIVER INSTALLATION INSTRUCTIONS Version: V1.0 Copyright © Jiangsu Qinheng Co., Ltd. Support System: OSX 10.9 and aboves

Installation Process:

  • Extract the contents of the zip file to a local installation directory

  • Double-click CH34x_Install.pkg

  • Install according to the installation on procedure

  • Restart after finishing installing

After the installation is completed, you will find serial device in the device list(/dev/tty.wchusbserial*), and you can access it by serial tools.

If you can’t find the serial port then you can follow the steps below:

  • Open terminal and type ls /dev/tty* and see is there device like tty.wchusbserial;

  • Open System Report→Hardware→USB, on the right side USB Device Tree there will be device named “Vendor-Specific Device” and check if the Current is normal. If the steps upper don’t work at all, please try to install the package again.

Please enter System Preferences ➜ Security & Privacy ➜ General, below the title "Allow apps downloaded from:" you should choose the choice 2 ➜ "Mac App Store and identified developers" so that our driver will work normally.

Older Driver

This older version requires some hacking in order to get it to work. I am leaving instructions just in case someone needs it, or the new driver does not work for someone.

Download the driver

There are two main sites that people mention in the discussions about the driver:

  • Chinese company that developed it

    • This driver appears newer than on the second link, and is from Dec 2013.

    • NOTE: for me that site took a long long time to load, and then it took forever to download this tiny driver, so I put up a copy here CH341SER_MAC.ZIP (256Kb), so that you don’t have to wait. Hopefully they won’t go after me for mirroring their driver :)

  • Second site is some sketchy Russian Company that sells the USB programmer based on this chip: but this site only has an older version of the driver, from 2012, so I do not recommend downloading it.

Pre-Installation

the following pre-installation steps are only required on the two most recent versions of OS-X Yosemite and El Capitan. It is because the driver is not signed properly from Apple’s perspective. We are waiting on the developer to update the driver so that these pre-installation steps are no longer needed.

OS-X El Capitan Steps (only for the older driver!)

These are not needed for the newer driver above.

  • Reboot and press ⌘-R immediately after the chime to enter Recovery Mode

  • Open Terminal from the recovery mode

  • run the command csrutil enable --without kext

  • Reboot.

<div class="external-reference"">Thanks to this post for these instructions.</div>

OS-X Yosemite Steps

  • Open Terminal Application (it’s located in /Application/Utilities) and type this command once you see a prompt:

  • sudo nvram boot-args="kext-dev-mode=1"

  • Reboot.

<div class="external-reference""> see this post if you wish to know more details.</div>

Installation

  • Download the driver from here: CH341SER_MAC.ZIP (256Kb)

  • Double click the ZIP file do unzip it

  • Open the folder ~/Downloads/CH341SER_MAC

  • Run installer found in that folder

  • Restart when asked.

Usage

If the driver properly loaded, you should see the device in you /dev folder (this is for advanced command-line users of OSX only). On my machine it was called /dev/cu.wchusbserial1441140

This port is showing up correctly in Arduino 1.0.6 and Arduino 1.5.8.

However, if you are using the Eclipse Plugin, it is not smart enough to list this port in the list of available serial ports (either in project properties, or in the serial monitor). You will have to type the entire thing yourself: /dev/cu.wchusbserial1441140 and then Eclipse can upload your sketch.

That’s it! You should be ready to use the drivers and the board.

Disquss Forum — Participation is Welcomed!