Macos Ch340 Driver



USB to UART bridge chips which have been included on ESP32-based development boards are listed below.

Driver for use with OS X 10.9 through macOS 10.12 (Sierra). MacOS (official) See also: CH340 CH341 serial adapters on macOS 10.12 Sierra and Chinese Arduinos with CH340/CH341 Serial/USB Chip on OS X Yosemite. Macbook Pro under macOS 10.14.2. It hand Blink example installed and the port wasn't visible in the list. I was trying to figured out, whats wrong and connected my Arduino Due through the programming port. After 2 attempts the sketch was uploaded.

FTDI

  • Drivers:
    • Virtual COM Port (VCP) Drivers (Recommended)
    • D2XX Direct Drivers (Allows direct access to the USB device through a DLL.)
  • Guide: How to Install FTDI Drivers
    (Uses FT232RL in the example, but the general process of the installation is the same.)
SeriesMaximum Bit RateNotes
FT230X3 Mbit/s
  • Chips:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    FT230XQQFN1616+1Built‑inYesPesky ESP32 Dev. Board
    FT230XSSSOP-1616Built‑inYes(None)
FT231X3 Mbit/s
  • Chips:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    FT231XQQFN2020+1Built‑inYesGravitech/MakerAsia Nano32
    FT231XSSSOP-2020Built‑inYesAyarafun/LamLoei Node32S, EzSBC ESP32 Dev. Board, Magic Cauldron ESP-WROOM-32 Breakout, Makestro/DycodeX ESPectro32, Microwavemont ESP32 Super Board, Microwavemont ESP32 Monster Board, Microwavemont ESP32 CAN CAN Board, Microwavemont ESP32-ADB (Rev. 1), Microwavemont ESP32-ADB Type R, Microwavemont ESP32 Web Radio & BT Receiver with Class-D Amp, ProtoCentral Kalam32-Dev, Sparkfun ESP32 Thing, Switch Science ESPr Developer 32
FT232R3 Mbit/s
  • Chips:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    FT232RQQFN3232+1Built‑inYesAsukiaaa ESP32BB (Rev. 1.0–1.4), dotstudio Nefry BT
    FT232RLSSOP-2828Built‑inYesEspressif ESP32 Demo Board V2, Keri's Lab KERISP32
FT2232H12 Mbit/s
  • Chips:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    FT2232HLLQFP-6464ExternalNoEspressif ESP-WROVER-KIT, Baoshi JESP32 JTAG
    FT2232HQQFN6464+1ExternalNo(None)
    FT2232H-56QVQFN-5656+1ExternalNo(None)

SiLabs

  • Drivers:
    • CP210x USB to UART Bridge VCP Drivers (Recommended)
SeriesMaximum Bit RateNotes
CP21021 Mbit/s
  • Chip:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    CP2102QFN2828+1Built‑inYesAi-Thinker NodeMCU-32S, AnalogLamb ESP32 Dev. Board, Asukiaaa ESP32BB (Rev 2.0), Asukiaaa ESP32Stack, DOIT ESP32 DevKit, Dongsen Tech D-duino-32, Dongsen Tech Pocket 32, Dongsen Tech X-32, eBox ESP32-T, eBox ESP32-ST, Elecrow ESP32 WIFI/BLE Board, ESP32.vn ESP-IoT-Uno, Espressif ESP32-DevKitC, Explore Embedded Hornbill ESP32 Dev, Freematics ESPRIT, GOOUUU-ESP32, Heltec WIFI Kit 32, Heltec WIFI LoRa 32, Kilobyte ESP32 Tiny Module, Microwavemont ESP32-ADB (Rev. 2), Noduino Quantum, Robotika Brno RB3200-ESP32universal, Spencer/Gratton ESPlant, thingTronics WiTooth, WeMos-fake LoLin OLED, WeMos-fake WiFi&Bluetooth Battery, WeMos-fake X-32, XiaoJ ESP-WROOM-32 Flashing/Testing Fixture, XiaoJ ESP32-Mini-Board
  • Data sizes of 5 and 6 bits are not supported at baud rates above 921.6 kbit/s. (7 or 8 data bits only.)
CP21042 Mbit/s
  • Chip:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    CP2104QFN2424+1Built‑inYesAdafruit HUZZAH32, AnalogLamb Maple ESP32, AprilBrother ESPea32, Electronic Sweet Peas ESP320, GNDTeknik ESP32 Breakout Kit, IntoRobot Fig, MH-ET LIVE ESP32 DevKit, MH-ET LIVE ESP32 MiniKit, WEMOS LoLin32, Widora-Air
  • Data sizes of 5 and 6 bits are not supported at baud rates above 921.6 kbit/s. (7 or 8 data bits only.)
CP2102N3 Mbit/s
  • Chips:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    CP2102N-QFN20QFN2020+1Built‑inYes(None)
    CP2102N-QFN24QFN2424+1Built‑inYesiohippo ESP32 Dev. Board, Kilobyte ESP32 Breakout, Watterott ESP-WROOM-32-Breakout
    CP2102N-QFN28QFN2828+1Built‑inYes(None)
  • Documentation:

WCH

WinChipHead / Jiangsu Qinheng Co., Ltd. — previously known as Nanjing Qinheng Electronic Co., Ltd.

  • Websites:
    • English
      Lagging behind; lacking content.
  • Drivers:
    Don't worry, you're supposed to use the CH341 driver for CH340.
    • macOS (signed)
      Recommended. Driver for use with OS X 10.9 through macOS 10.12 (Sierra).
    • macOS (official)
      See also: CH340 CH341 serial adapters on macOS 10.12 Sierra and Chinese Arduinos with CH340/CH341 Serial/USB Chip on OS X Yosemite.
SeriesMaximum Bit RateNotes
CH3402 Mbit/s
  • Chips:
    IdentifierPackagePinsClockEmbed. EEPROMESP32 Dev. Boards
    CH340GSOP-1616ExternalNo(None)
    CH340CSOP-1616Built‑inNoGeekworm Easy Kit ESP32-B1
    CH340BSOP-1616Built‑inYes(None)
    CH340EMSOP-1010Built‑inNo(None)
    CH340TSSOP-2020ExternalNoOlimex ESP32-EVB (Rev. B), Olimex ESP32-Gateway
    CH340G, CH340C, CH340B, CH340E, and CH340T are for USB to serial UART. For obvious reasons, chips in the CH340 series used for USB to something else other than serial UART have been excluded. (CH340R is for USB to serial IrDA. CH340H and CH340S are for USB to IEEE-1284 parallel printer interface.) The CH340 SOP-16 chip used in the fake-WeMos D1 R32 board is not positively identified; thus the board is absent from this table.
  • Product page
  • Datasheets (PDF):
    • CH340 Series USB⇔Serial Datasheet (Chinese)
      Document version 2C; includes information on CH340G, CH340C, CH340B, CH340E, CH340T, and CH340R.
    • CH340 Series USB⇔Serial Datasheet (English)
      Document version 1D; includes information on CH340T and CH340R.
    • CH340G USB⇔Serial Datasheet (English)
      Document version 1E; translated by DreamCity Innovations.
  • Hardware design: CH340G in EAGLE EDA

The Beginners Guide has general help. Click here for the Beginners Guide
If you need Mac-specific help, you are at the right page.

Join the Mailing list & search the archives for similar problem reports & how they were resolved, and/or ask the group. Please include enough info about the problem and situation so the community will be able to help you.

Not all functionality is supported on all radios. See Model Support

As of MacOS 10.9, signed packages are required by default. Apple charges for this capability, and requires use of their tooling to do it. For the time being, MacOS users may need to disable signed package checking for CHIRP. Instructions provided by Jim, K2SON:

  1. Locate the app in Finder.
  2. Right click (control-click if you don't have a 2 button mouse) on the app and click Open.
  3. You will get a dialog box about it being an unsigned app, click the Open button.
  4. Enter an Administrator userid and password.
  5. The app will now be flagged to allow it to be opened normally in the future.

Alternately, you can disable them for your entire system, although this has security implications that should not be ignored. Instructions for this provided by Tom, KD7LXL:

  1. Open your System Preferences
  2. Go to Security & Privacy, General tab.
  3. Click the lock
  4. Then choose Allow apps downloaded from: Anywhere.

As of 10.12 (Sierra) the UI for disabling app security was removed. The functionality is still there, but must be enabled from the command line.

MacosTo whitelist a single application (like an unzipped chirp-daily.app):
  1. unzip chirp.zip
  2. control click on the unzipped application and select New Terminal at Folder. (Don't see that menu item? Instructions to enable it)
  3. run this command in the newly opened terminal window:

Alternately, you can disable them for your entire system, although this has security implications that should not be ignored. Run this command in a terminal:

references: single commandglobal

Unfortunately, Apple has made significant changes in 10.15 which cause major issues for independent software developers. CHIRP is significantly impacted and the future is unclear.

At the very least, Catalina users should use the 'unified' build of the app provided on the download page, which uses the system's 64-bit python runtime. Also note that there are significant limitations on what files unsigned applications can access which makes it very difficult to open, save, find, and otherwise organize image and CSV files with chirp. Please see issue #7147 for the current information about workarounds.

USB to serial cables are not merely wire, they contain small computer circuits at one end of the cable that respond as a USB device and convert the data to serial. These cables are not all the same, so the computer needs a software 'driver' so it can recognize the cable and speak to it correctly. You will need to install one of these 5 below.

FTDI cables¶

Note that with Mac OSX 10.9 'Mavericks', Apple provides their own driver for FTDI chipset. You may need to remove the OEM FTDI driver and use only the Apple FTDI driver, or you may need to disable the Apple FTDI driver and install the OEM FTDI drivers. YMMV.

http://www.ftdichip.com/Drivers/VCP.htm
Version 1.5.1 is available for Mac OS X on 64 bit, 32 bit and PPC machines.

Prolific PL-2303 cables - official drivers for the genuine Prolific cables¶

FYI: your cable, if using Prolific chipset, is more likely to be using a counterfeit chip than an original.

http://www.prolific.com.tw/US/CustomerLogin.aspx
Login as guest/ guest & look in the Support section. Specified to work with Mac OSX 10.6, 10.7, & 10.8.

Generic PL-2303 cables (counterfeit and/or “Generic”) If you aren't sure what kind of inexpensive cable you have, try this one first.¶

For Lion (10.7.x), Mountain Lion (10.8.x), and Mavericks (10.9.x):¶

You can try this one, which install open source pl2303 driver and remove any other driver versions:
http://1drv.ms/Nl68Ru At this web page you may need to right-click or control-click to link to get it to download. After downloading, you may need to control-right click, then open in order to bypass Mac Gatekeeper.

For earlier versions of Mac OS X up to 10.5 Leopard. Also some reports of success with Snow Leopard, Lion:¶

RTSystems cables¶

for OSX 10.9.x (aka Mavericks):¶

see RTSystemsCablesAndMavericks

for OSX < 10.9.x:¶

https://www.rtsystemsinc.com/kb_results.asp?ID=9
http://www.rtsystems.us/downloads/MacDrivers/RTSystemUSBSerialDrivers.pkg.mpkg.zip

Silicon Labs CP210x USB to UART Bridge VCP Drivers (including Kenwood TH-D72)¶

  • http://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx
    Macintosh OSX driver for the Intel and PowerPC Platforms versions 10.4, 10.5, 10.6, 10.7, 10.8, and 10.9.

WinChipHead CH340 series chipset¶

The WinChipHead CH340 series chipset is not compatible with the Prolific 2303 drivers. This chipset will report a Product ID of 0x7523 and a Vendor ID of 0x1a86. A signed driver compatible with Yosemite is available from http://blog.sengotta.net/signed-mac-os-driver-for-winchiphead-ch340-serial-bridge/ as the driver offered on the manufacturer's website (in Chinese) is not signed and requires allowing unsigned kernel extensions, which is a significant security risk on OS X.

  • In many cases you need to connect the cable to the radio first, then power the radio on, while holding down some buttons. The exact procedure varies by radio.
  • Some radios need to be put into a 'clone' mode to transfer to PC, some radios may need to be configured to use the mic/speaker jacks for PC transfer instead of for the speaker/mic. The exact procedure varies by radio.
  • You will need to download from the radio to CHIRP first, before uploading anything to the radio. CHIRP creates a template from the radio download so it knows how to talk to the radio.
  • If you want to download from one radio and upload those settings to another radio, first download from each radio to a separate “tab” of CHIRP. Then copy/paste from one tab to the other & upload back to the same radio that produced that tab. Do not try to upload to a radio directly from a tab that was not downloaded from that same radio.
  • Many USB to serial cables include a counterfeit Prolific chip. This can cause connection problems because the official Prolific driver will ignore the counterfeit chip. Some people have reported success by using an older version of the Prolific driver, or a 3rd party driver.
  • If you are using multiple USB cables, each will create a different “virtual port”, meaning that you will need to select the correct virtual port for your radio when connecting to your radio. CHIRP will give you this opportunity each time you download from the radio.
  • If CHIRP won’t launch & won't run, you may have neglected to install the Python runtime. CHIRP needs that. Even though Mac OS X includes Python built-in, the runtime has to be installed is because it includes PyGTK and some other libraries that Chirp requires, in addition to Python itself: http://www.d-rats.com/download/OSX_Runtime/
  • If your radio is not 'Supported', you can try downloading the newest Daily Build to see if support was recently added.

You can verify that the drivers are installed & working by connecting the USB cable to your Mac, then running “System Profiler”, or “System Information” (found in /Applications/Utilities ). When the USB cable is connected and drivers correctly installed, the cable will show up in the USB section of the System Profiler.

Another way to see that the driver is correctly installed is to open Terminal and type:

It will return a list of virtual serial ports including something similar to:

You may also type:

That will return a long list of kexts, including something similar to this at the bottom (most recently installed are listed last):

Look at the CHIRP log for clues.

Ch340 Macos Catalina Driver

Join the Mailing list & search the archives for similar problem reports & how they were resolved, and/or ask the group. Please include enough info about the problem and situation so the community will be able to help you.