Explorar el Código

Merge branch 'doc/macos_ftdi_jtag' into 'master'

docs: jtag debugging: add macOS 10.15 FTDI details (Github PR)

Closes IDFGH-4078

See merge request espressif/esp-idf!13104
Ivan Grokhotkov hace 4 años
padre
commit
bf49917233

+ 13 - 2
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:
 

+ 12 - 2
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::