+
+ Grove Cable
+
- **Solution:** you need to connect the capacitor between RST pin and GND pin in your Core (Capacitance value is more than 0.1 uF).
+ **Solution:** you need to connect the capacitor between RST pin and GND pin in your Core (Capacitance value is more than 0.1 uF) or connect GPIO 0 with GND when downloading your firmware so that GPIO 0 keeps low level for an enough time as the third following picture shows.
+ 
+
- **Q6: What special GPIO pins do you need to pay attention to in ESP32?**
The ESP32 has 34 GPIO pins, of which GPIO 34-39 is only used as an input and cannot be used as an output. Others can be used as both an input and an output pin.
diff --git a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md
index d306a778..62e6b9ce 100644
--- a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md
+++ b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md
@@ -1,91 +1,142 @@
-# M5Core Quick Start On Arduino IDE {docsify-ignore-all}
+# M5Core Quick Start {docsify-ignore-all}
-:clapper: **[Video Tutorial](#Video-Tutorial)** :memo: **[Text Tutorial](#Text-Tutorial)**
+:clapper: **[Video Tutorial](#Video-Tutorial)** :memo: **[Text Tutorial](#Table-of-Contents)**
-***
+## Table of Contents
-?> Before setting the development environment, we suggest you confirm whether the USB driver has installed. If not, please visit this link [establish serial connection](/en/related_documents/establish_serial_connection).
+**[1. Install Arduino IDE](#_1-install-Arduino-IDE)**
-## Text Tutorial
+**[2. Install USB to Serial Driver](#_2-Install-USB-to-Serial-Driver)**
-1. [Setting Environment](#setting-environment)
+**[3. Install ESP32 Boards Manager](#_3-Install-ESP32-Boards-Manager)**
- - [Step1. Install Arduino IDE](#step1-install-arduino-ide)
+**[4. Install M5Stack Library](#_4-Install-M5Stack-Library)**
- - [Step2. ESP32 Board Support](#step2-esp32-board-support)
+**[5. Example](#_5-Example)**
- - [Step3. Install M5Stack Lib](#step3-install-m5stack-lib)
+## 1. Install Arduino IDE
-2. [Example](#example)
+
-## Setting Environment
+Open your browser, enter the official website of Arduino https://www.arduino.cc/en/Main/Software
-### Step1. Install `Arduino IDE`
-
-First, if Arudino IDE is not installed, install it. It's *download address* is https://www.arduino.cc/en/Main/Software
+#### (1) click `Mac OS X` for downloading `Arduino IDE`
-### Step2. ESP32 Board Support
+#### (2) click `JUST DOWNLOAD`
-Open Arduino IDE, click `Arduino`->`Peferences`->`Settings`
+
+
+#### (3) Once the Arduino IDE is downloaded, you can double-click it to open it
+
+
+
+## 2. Install USB to Serial Driver
+
+Open your browser, enter the official website of M5Stack https://m5stack.com/download
+
+#### (1) click `Mac` for downloading this installation package and then unzip this package
+
+
+
+#### (2) After unzipped this package, double click the disk image `SiLabsUSBDriverDisk.dmg` for installing
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+#### (4) Check the serial port number `COMx`
+
+Comfirm if the USB to Serial Driver was successfully installed already:
+
+Open `Terminal`, connect `M5Core` with PC through USB Type-C cable, and execute the following command for viewing serial port list.
+
+
+
+
+
+Disconnect M5Core device, and execute the just executed command to verify which port disappears from the list. The disappearing COM port is the serial port name corresponding to M5Core.
+
+
+
+Now, the serial port name is `tty.SLAB_USBtoUART`
+
+## 3. Install ESP32 Boards Manager
+
+#### (1) Open IDE, click `File`->`Peferences`->`Settings`
-Copy the following last ESP32 Board Manager URL to this option `Additional Boards Manager URLs: `
+#### (2) Copy the following ESP32 Boards Manager url to `Additional Boards Manager URLs:`
-*NOW, last ESP32 board manager URL is https://dl.espressif.com/dl/package_esp32_index.json*
+*ESP32 Boards Manager url: https://dl.espressif.com/dl/package_esp32_index.json*
-Confirm OK and click `Tools`->`Board:`->`Boards Manager...` for installing esp32
-
-Search `ESP32` in the new pop-up dialog, then click `install`
+#### (3) Click `Tools`->`Board:`->`Boards Manager...`
+#### (4) Search `ESP32` in the new pop-up dialog, then click `Install`
+
-### Step3. Install M5Stack Lib
+## 4. Install M5Stack Library
-Start up Arduino IDE, then Select `Sketch`->`Include Library`->`Manage Libraries...`
+#### (1) Open Arduino IDE, then Select `Sketch`->`Include Library`->`Manage Libraries...`
-Type `M5Stack` into the search box, search it and install.
+
-
+#### (2) 搜索 `M5Stack` 并安装，如下图所示
-
+
-## Example
+## 5. Example
+
+This section for verifying whether you can program with Arduino or not. Now, The USB cable connects to M5Core, then select your serial port which is connected M5Core.
-The USB cable connects to M5Stack Core, then select your serial port which is connected M5Stack Core.
Select a demo example, compile and upload
-### 1. Select your board and the serial port
+#### (1) Select the correct board name and serial port name
-Start up Arduino IDE, and click `Tools -> Boards -> M5Stack-Core-ESP32` to select your board
-
-Click `Tools -> Ports ->` to select the serial port which is connected with M5Stack Core
+Open Arduino IDE, select `Tools`->`Board`->`M5Stack-Core-ESP32` for your M5Core, `Tools` -> `Ports` for serial port
-### 2. Select an example
+#### (2) Then select an example likes `HelloWorld.ino`
-Click `File-> Examples`. Here are some test programs in `M5Stack->`
+Select `File`->`Examples`->`M5Stack`->`Basics`
-Try to open a sketch called `HelloWorld` inside Basics.
+Select a example named `HelloWorld`.
-Compile it and upload, the M5Stack screen will show "Hello World!"
+Upload it, and after this program was uploaded successfully, the screen on M5Core will display "Hello World!"
## Note
-Although most versions of MacOS have no problem with detecting the COM port, on some newer versions of High Sierra sometimes Slab\_USBtoUART does not appear. If this is the case, after you connect the M5 open `security and privacy` in the system preferences and set it to `permit`.
+Although most versions of MacOS have no problem with detecting the COM port, on some newer versions of High Sierra sometimes `Slab_USBtoUART` does not appear. If this is the case, after you connect the M5 open `security and privacy` in the `system preferences` and set it to `permit`.
@@ -97,6 +148,4 @@ Although most versions of MacOS have no problem with detecting the COM port, on
## Video Tutorial
-
-
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md
index c9f6ba50..65ae9325 100644
--- a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md
+++ b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md
@@ -14,7 +14,7 @@
**[5. Example](#_5-Example)**
-### 1. Install Arduino IDE
+## 1. Install Arduino IDE
@@ -34,9 +34,9 @@ Open your browser, enter the official website of Arduino https://www.arduino.cc
-### 2. Install USB to Serial Driver
+## 2. Install USB to Serial Driver
-Open your browser, enter the official website of M5Stack https://www.arduino.cc/en/Main/Software
+Open your browser, enter the official website of M5Stack https://m5stack.com/download
#### (1) click `Windows` for downloading this installation package and then unzip this package.
@@ -66,7 +66,7 @@ Disconnect M5Core device and connect it back, to verify which port disappears fr
-### 3. Install ESP32 Boards Manager
+## 3. Install ESP32 Boards Manager
#### (1) Open IDE, click `File`->`Peferences`->`Settings`
@@ -88,7 +88,7 @@ Disconnect M5Core device and connect it back, to verify which port disappears fr
-### 4. Install M5Stack Library
+## 4. Install M5Stack Library
#### (1) Open Arduino IDE, then Select `Sketch`->`Include Library`->`Manage Libraries...`
@@ -102,7 +102,7 @@ Disconnect M5Core device and connect it back, to verify which port disappears fr
-->
-### 5. Example
+## 5. Example
This section for verifying whether you can program with Arduino or not. Now, The USB cable connects to M5Core, then select your serial port which is connected M5Core.
diff --git a/docs/index.md b/docs/index.md
index 2b9dbd32..ef87cedf 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -214,23 +214,26 @@
-[](en/accessory/converter/grove_t) [](en/accessory/cable/grove_cable) [](en/tool/usb_downloader)
-
- *Grove-T* *Grove Cable* *USB Downloader*
-
-
+ Grove-T
+ + +
+
+ Grove Cable
+
+
+ USB Downloader
+
-### 2. USB/UARTシリアル変換ドライバのインストール
+## 2. USB/UARTシリアル変換ドライバのインストール
-ブラウザを開き、M5Stackの公式サイトにアクセスします。 https://www.arduino.cc/en/Main/Software
+ブラウザを開き、M5Stackの公式サイトにアクセスします。 https://m5stack.com/download
#### (1) `Windows`をクリックし、ファイルをダウンロードします。そしてダウンロードしたファイルを解凍します。
diff --git a/docs/zh_CN/faq.md b/docs/zh_CN/faq.md
index 6ac9d653..5ea991f6 100644
--- a/docs/zh_CN/faq.md
+++ b/docs/zh_CN/faq.md
@@ -40,12 +40,14 @@
- **原因和解决方案：**可能是因为这些串口的供电电流不够大，需要在主控中的 RST 引脚和 GND 引脚之间接入电容 ( 电容值是比0.1uF大的 )。
+ **原因和解决方案：**可能是因为这些串口的供电电流不够大，需要在主控中的 RST 引脚和 GND 引脚之间接入电容 ( 电容值是比0.1uF大的 )，或者在下载程序的时候，将 GPIO 0 连接到 GND，使得 GPIO 0 能持续足够的低电平。
+
+
- **Q6: ESP32 有哪些特殊的 GPIO 管脚需要注意？**
ESP32 有 34 个 GPIO 管脚，其中 GPIO 34-39 仅用作输入，不能作为输出，其他的既可以作为输入又可以作为输出管脚。
diff --git a/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md b/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md
index d9755e05..745b31e8 100644
--- a/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md
+++ b/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md
@@ -1,87 +1,145 @@
-# Core 上手指南(macOS, Arudino) {docsify-ignore-all}
+# M5Core 的上手指南 {docsify-ignore-all}
-
+:clapper: **[视频教程](#视频教程)** :memo: **[文本教程](#目录)**
-?> 在配置环境之前，先确保你已经安装了USB驱动，并且M5Core能通过串口与PC通信。 如果还没的话，看这篇文章[如何建立串口连接](zh_CN/related_documents/establish_serial_connection).
+
-## 文本教程
+## 目录
-1. [配置环境](#配置环境)
+**[1. 安装 Arduino IDE](#_1-安装-Arduino-IDE)**
- - [Step1. 安装Arduino IDE](#Step1-安装arduino-ide)
+**[2. 安装串口驱动](#_2-安装串口驱动)**
- - [Step2. 安装ESP32的支持包](#Step2-安装ESP32的支持包)
+**[3. 安装 ESP32 的板管理](#_3-安装-ESP32-的板管理)**
- - [Step3. 安装Arduino-M5Stack库](#Step3-安装arduino-m5stack库)
+**[4. 安装 M5Stack 的库](#_4-安装-M5Stack-的库)**
-2. [示例](#示例)
+**[5. 示例](#_5-示例)**
-## 配置环境
+## 1. 安装 Arduino IDE
-### Step1. 安装Arduino IDE
+浏览器打开 Arduino 官网 https://www.arduino.cc/en/Main/Software
-首先，如果Arduino IDE还没安装的话，先安装它。 这是下载地址 *download address* https://www.arduino.cc/en/Main/Software
+#### (1) 点击选择安装包 `Mac OS X`
-### Step2. 安装ESP32的支持包
+#### (2) 选择 `JUST DOWNLOAD`
-打开Arduino IDE，选择`Arduino`->`Peferences`->`Settings`
+
+
+#### (3) Arduino IDE 下载下来就可以直接双击打开使用
+
+
+
+## 2. 安装串口驱动
+
+
+
+浏览器打开 M5Stack 官网 https://m5stack.com/download
+
+#### (1) 点击 `Mac`，下载 Mac 版本的驱动安装包并解压
+
+
+
+#### (2) 解压后，双击镜像文件 SiLabsUSBDriverDisk.dmg，开始安装
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+#### (4) 检查确认 COM 串口名
+
+检查确认 COM 串口名，以确定串口驱动是否安装成功：
+
+打开终端 `Terminal`，将 Core 通过 USB Type-C 线连接电脑，执行以下命令
+
+
+
+
+
+拔掉 USB 线，再执行一次刚刚的命令，此时终端 `Terminal` 上显示的 COM 列表里消失的 COM 口就是该 Core 对应的 串口名。
+
+
+
+## 3. 安装 ESP32 的板管理
+
+#### (1) 打开 Arduino IDE，选择 `文件`->`首选项`->`设置`
-复制下面最新的ESP32板管理网址到`Additional Boards Manager URLs: `选项中
+#### (2) 复制下面的 ESP32 板管理网址到 `附加开发板管理器:` 中
-*目前最新的板管理网址是这个：https://dl.espressif.com/dl/package_esp32_index.json*
+*ESP32 的板管理网址是这个：https://dl.espressif.com/dl/package_esp32_index.json*
-都确定OK之后，选择`Tools`->`Board:`->`Boards Manager...`，在新弹出的对话框中，输入并搜索`ESP32`，点击`安装`
+#### (3) 选择 `工具`->`开发板:`->`开发板管理器...`
+#### (4) 在新弹出的对话框中，输入并搜索 `ESP32`，点击`安装`
+
-### Step3. 安装Arduino-M5Stack库
+## 4. 安装 M5Stack 的库
-打开Arduino IDE, 然后选择`Sketch`->`Include Library`->`Manage Libraries...`
-
-在搜索框输入`M5Stack`搜索并安装。
+#### (1) 打开 Arduino IDE, 然后选择 `项目`->`加载库`->`库管理...`
+#### (2) 搜索 `M5Stack` 并安装，如下图所示
+
-## 示例
+## 5. 示例
-用USB线连接M5Core和PC，然后选择PC上正与M5Core连接的串口号。
+这部分是为了验证现在您是否能通过 Arduino IDE 对 M5Core 编程。
-### 1. 选择板子和串口
+用 USB 线连接 M5Core 和电脑，然后选择电脑上正与 M5Core 连接的串口号。
-打开Arduino IDE, 并点击`Tools`->`Boards`->`M5Stack-Core-ESP32`
+#### (2) 选择板子和串口
-点击`Tools` -> `Ports` 以选择合适的串口号
+打开 Arduino IDE, 并点击 `Tools`->`Board`->`M5Stack-Core-ESP32`
+
+点击 `Tools` -> `Ports` 以选择合适的串口号
-### 2. 选择一个例程
+#### (2) 选择示例程序 `HelloWorld.ino`
-点击`File`->`Examples`->`M5Stack`->`Basics`
+点击 `File`->`Examples`->`M5Stack`->`Basics`
-选择例程`HelloWorld`.
+选择例程 `HelloWorld`.
-编译并上传这个例程，然后M5Stack屏幕会显示"Hello World!"
+编译并上传这个例程，然后 M5Stack 屏幕会显示 "Hello World!"
## 注意
-虽然大多数版本的MacOS系统都没找不到串口号这个问题，可是有些最新版本系统就可能出现这个问题。
-如果真的遇到这个问题了，请连接M5并在`system preferences`中打开`security and privacy`，设置`permit`
+虽然大多数版本的 MacOS 系统都没找不到串口号这个问题，可是有些最新版本系统就可能出现这个问题。
+如果真的遇到这个问题了，请连接M5并在 `system preferences` 中打开 `security and privacy`，设置 `permit`
@@ -89,10 +147,10 @@
-?> **如果你想了解更多关于CP2104 USB驱动的资料，请阅读这个链接的内容** https://developer.apple.com/library/archive/technotes/tn2459/\_index.html
+?> **如果你想了解更多关于 CP2104 USB 驱动的资料，请阅读这个链接的内容** https://developer.apple.com/library/archive/technotes/tn2459/\_index.html
-
- -->
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md b/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md
index 0abaf20d..1d69407a 100644
--- a/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md
+++ b/docs/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md
@@ -14,7 +14,7 @@
**[5. 示例](#_5-示例)**
-### 1. 安装 Arduino IDE
+## 1. 安装 Arduino IDE
@@ -34,7 +34,7 @@
-### 2. 安装串口驱动
+## 2. 安装串口驱动
@@ -72,7 +72,7 @@
-### 3. 安装 ESP32 的板管理
+## 3. 安装 ESP32 的板管理
#### (1) 打开 IDE，选择 `文件`->`首选项`->`设置`
@@ -91,9 +91,10 @@
#### (4) 在新弹出的对话框中，输入并搜索 `ESP32`，点击`安装`
+
-### 4. 安装 M5Stack 的库
+## 4. 安装 M5Stack 的库
#### (1) 打开 Arduino IDE, 然后选择 `项目`->`加载库`->`库管理...`
@@ -107,7 +108,7 @@
-->
-### 5. 示例
+## 5. 示例
这部分是为了验证现在您是否能通过 Arduino IDE 对 M5Core 编程。