From 38a3761280627b2953e02d7d927b65109dd5e02b Mon Sep 17 00:00:00 2001
From: Ventz Petkov <ventz@vpetkov.net>
Date: Tue, 30 Nov 2021 14:27:02 -0500
Subject: [PATCH] Updated MacOS usb-serial info for the T-Echo

---
 .../docs/getting-started/flashing-nrf52.md    | 59 ++++++++++++++++++-
 1 file changed, 57 insertions(+), 2 deletions(-)

diff --git a/website/docs/getting-started/flashing-nrf52.md b/website/docs/getting-started/flashing-nrf52.md
index 3c4c25c7..921ce519 100644
--- a/website/docs/getting-started/flashing-nrf52.md
+++ b/website/docs/getting-started/flashing-nrf52.md
@@ -8,12 +8,59 @@ import TabItem from '@theme/TabItem';
 
 ## Pre-requisits
 
-Please ensure that you use a data USB cable, as some cables provide power only and not the data lines.
+:::tip
+Please ensure that you use a data USB-C cable, as many USB-C cables provide power only and not the data lines. 
+::: 
 
 ### T-Echo
 
+:::tip
+The usb-C to usb-A cable from LILYGO is *NOT* a "data cable", and can only be used for charging. 
+:::
+
+
+#### Windows:
+
 You may need to install the [USB device drivers](http://www.wch-ic.com/search?q=ch340&t=downloads) if your device does not show up when connected.
 
+#### Mac OS
+
+Last Verified T-Echo nRF52840 on: Mac OS Monterey v12.0.1 (Intel chipset)
+
+:::tip
+You can use the latest [Apple USB-C Charge cables](https://www.apple.com/shop/product/MLL82AM/A/usb-c-charge-cable-2-m). The cable that is provided with the iPad Pro works. Older Laptop usb-C Power cables will *NOT* work, as they are missing the data lines.
+:::
+
+:::caution
+With the latest versions of MacOS, the USB Serial driver is built-in. Do *NOT* download any USB device drivers - this will actually prevent you from connecting to your T-Echo from your Mac. If you downloaded/installed any already, please Remove them.
+:::
+
+<details>
+  <summary>Removing the CH34x (CH340/CH341) USB Drivers</summary>
+  <div>
+    <div>
+        If you have already downloaded/installed the MacOS WCH-IC CH340 ("CH341SER_MAC") drivers via the `CH34x_Install_V1.5.pkg`, you will have to Uninstall the kernel extension:
+        <br />
+        <br />
+        1.) Unplug your T-Echo<br />
+        2.) Open the Terminal and run:<br />
+        3.) sudo -rf /Library/Extensions/usbserial.kext`<br />
+        4.) Reboot
+    </div>
+  </div>
+</details>
+
+
+Verify successful connections with:
+
+* Plug in your T-Echo
+* Open the Terminal
+* `ls -l /dev/tty.usbmodem*`
+
+If the device file exists, you will also notice a "TECHOBOOT" volume in the Finder, or in the Terminal after double-clicking the Reset Button (see below) 
+
+* `ls /Volumes/TECHOBOOT`
+
 ### WisBlock RAK4631
 
 Please ensure that you have updated the bootloader to the latest version using the information on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631/Quickstart/#how-to-check-if-you-have-the-updated-rak4631-bootloader) website.
@@ -32,7 +79,15 @@ Be careful to install the correct load for your board. While it is unlikely that
 
 
 * Connect your device to your computer with a USB cable. If you computer complains about needing to format a new drive, cancel the format command.
-* Double click the reset button on your device, this will put it into boot loader mode.
+* Double click the `Reset` button on your device, this will put it into boot loader mode.
+
+[<img alt="LILYGO T-Echo" src="/img/hardware/t-echo-lilygo.jpg" style={{zoom:'25%'}}  />](/img/hardware/t-echo-lilygo.jpg)
+
 * A new drive will then be mounted on your computer. Open this drive and you should see three files: `CURRENT.UF2`, `INDEX.HTM`, and `INFO_UF2.TXT`
 * Copy the appropriate `firmware-xxxxx-1.2.x.uf2` file from the firmware zip file onto the new drive.
+
+:::note
+You are going to copy/drop "as is" 'firmware-xxxxx-1.2.x.uf2' (*NOT* over the "CURRENT.UF2" file) in the volume, and the device reboot will copy it/load it correctly.
+:::
+
 * Once the file has finished copying over, the device will reboot, loading the new firmware as it does.