From 9ec19163edcb604a76b1a1e85843ef8b414a6949 Mon Sep 17 00:00:00 2001 From: Eli Date: Mon, 5 Oct 2020 02:38:28 +0100 Subject: [PATCH] docs: jtag debugging: add macOS 10.15 FTDI details Merges https://github.com/espressif/esp-idf/pull/5949 --- .../jtag-debugging/configure-ft2232h-jtag.rst | 15 +++++++++++++-- .../jtag-debugging/configure-ft2232h-jtag.rst | 14 ++++++++++++-- 2 files changed, 25 insertions(+), 4 deletions(-) diff --git a/docs/en/api-guides/jtag-debugging/configure-ft2232h-jtag.rst b/docs/en/api-guides/jtag-debugging/configure-ft2232h-jtag.rst index d36ac5c164..a04a56d5f8 100644 --- a/docs/en/api-guides/jtag-debugging/configure-ft2232h-jtag.rst +++ b/docs/en/api-guides/jtag-debugging/configure-ft2232h-jtag.rst @@ -112,9 +112,20 @@ Manually unloading the driver sudo kextunload -b com.FTDI.driver.FTDIUSBSerialDriver - In some cases you may need to unload Apple's FTDI driver as well:: + In some cases you may need to unload Apple's FTDI driver as well: + + * macOS < 10.15:: + + sudo kextunload -b com.apple.driver.AppleUSBFTDI + + * macOS 10.15:: + + sudo kextunload -b com.apple.DriverKit-AppleUSBFTDI + + .. warning:: + + Attempting to use serial over the wrong channel with the FTDI driver will cause a kernel panic. The ESP-WROVER-KIT uses channel A for JTAG and channel B for serial. - sudo kextunload -b com.apple.driver.AppleUSBFTDI 4. Run OpenOCD: diff --git a/docs/zh_CN/api-guides/jtag-debugging/configure-ft2232h-jtag.rst b/docs/zh_CN/api-guides/jtag-debugging/configure-ft2232h-jtag.rst index 0f26f79e9a..9643665c65 100644 --- a/docs/zh_CN/api-guides/jtag-debugging/configure-ft2232h-jtag.rst +++ b/docs/zh_CN/api-guides/jtag-debugging/configure-ft2232h-jtag.rst @@ -112,9 +112,19 @@ MacOS sudo kextunload -b com.FTDI.driver.FTDIUSBSerialDriver - 有时，您可能还需要卸载苹果的 FTDI 驱动:: + 有时，您可能还需要卸载苹果的 FTDI 驱动: - sudo kextunload -b com.apple.driver.AppleUSBFTDI + * macOS < 10.15:: + + sudo kextunload -b com.apple.driver.AppleUSBFTDI + + * macOS 10.15:: + + sudo kextunload -b com.apple.DriverKit-AppleUSBFTDI + + .. warning:: + + 对于 FTDI 驱动，如果使用串口的通道不正确，则可能会导致内核崩溃。ESP-WROVER-KIT 将通道 A 用于 JTAG，通道 B 用于串口。 4. 运行 OpenOCD::