优化在mac上的上手指南 en ch FAQ的Q5增加图片

2026-05-20 10:23:01 -07:00 · 2019-03-15 17:07:31 +08:00
parent 1cc9d8604e
commit c391fa6214
19 changed files with 221 additions and 106 deletions
@@ -39,12 +39,14 @@

    <img src="assets/img/faq/faq_03.png">

-    **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.

    <img src="assets/img/faq/faq_05.png" width="80%" height="80%">

    <img src="assets/img/faq/faq_06.png" width="80%" height="80%">

+    <img src="assets/img/faq/faq_07.png" width="100%" height="100%">
+
 - **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.
@@ -1,91 +1,142 @@
-# M5Core Quick Start On Arduino IDE {docsify-ignore-all}
+# M5Core Quick Start {docsify-ignore-all}

-:clapper: **[Video Tutorial](#Video-Tutorial)**&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:memo: **[Text Tutorial](#Text-Tutorial)**
+:clapper: **[Video Tutorial](#Video-Tutorial)**&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: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)
+<!-- *注意：如果已经安装了 IDE，请直接从[步骤 2](#_2-安装串口驱动) 开始。* -->

-## 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`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide.png">

-### Step2. ESP32 Board Support
+#### (2) click `JUST DOWNLOAD`

-Open Arduino IDE, click `Arduino`->`Peferences`->`Settings`
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide_02.png">
+
+#### (3) Once the Arduino IDE is downloaded, you can double-click it to open it
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide_03.png">
+
+## 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
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/download_usb_driver_mac_01.png">
+
+#### (2) After unzipped this package, double click the disk image `SiLabsUSBDriverDisk.dmg` for installing
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_dmg.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_pkg.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/2.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/3.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/4.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/5.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/6.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/7.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/8.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/9.png">
+
+#### (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.
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/check_serial_port_mac_01.png">
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/check_serial_port_mac_02.png">
+
+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.
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/check_serial_port_mac_03.png">
+
+Now, the serial port name is `tty.SLAB_USBtoUART`
+
+## 3. Install ESP32 Boards Manager
+
+#### (1) Open IDE, click `File`->`Peferences`->`Settings`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_01.png">

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_02.png">

-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*

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_03.png">

-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...`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_04.png">

+#### (4) Search `ESP32` in the new pop-up dialog, then click `Install`
+
 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_05.png">

-### 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.
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_m5stack_lib_01.png">

-<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_06.png">
+#### (2) 搜索 `M5Stack` 并安装，如下图所示

-<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_07.png">
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_m5stack_lib_02.png">

-## 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

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_10.png">

-### 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`.

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_09.png">

-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!"

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/display_hello_world.png">

 ## 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`.

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy.png">

@@ -97,6 +148,4 @@ Although most versions of MacOS have no problem with detecting the COM port, on

 ## Video Tutorial

-<!-- **Windows** -->
-
-<iframe width="560" height="315" src="https://www.youtube.com/embed/U2es-l4z2Zg" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+<iframe width="560" height="315" src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/LukeVideo/M5Stack%20Arduino%20IDE%20Setup%20in%205%20minutes.mp4" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
@@ -14,7 +14,7 @@

 **[5. Example](#_5-Example)**

-### 1. Install Arduino IDE
+## 1. Install Arduino IDE

 <!-- *注意：如果已经安装了 IDE，请直接从[步骤 2](#_2-安装串口驱动) 开始。* -->

@@ -34,9 +34,9 @@ Open your browser, enter the official website of Arduino  https://www.arduino.cc

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_arduino_2.png">

-### 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

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/check_serial_port_01.png">

-### 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

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_05.png">

-### 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

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/update_m5stack_lib.png"> -->

-### 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.

@@ -214,23 +214,26 @@

 &nbsp;

-[![grove_t_01.png](https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/grove_t_01.png)](en/accessory/converter/grove_t)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[![grove_t_01.png](https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/grove_cable_01.png)](en/accessory/cable/grove_cable)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[![usb_downloader_01.png](https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/tool/usb_downloader_01.png)](en/tool/usb_downloader)
-
-&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;*Grove-T*&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; *Grove Cable*&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; *USB Downloader*
-
-<!-- <div>
-     <img src="assets/img/product_pics/icon_accessory.png" style="vertical-align:middle;">
-     <span style="font-size:30px">Accessory</span>
-</div>
-
-&nbsp;
-
 <div class="item">
  <a href="/#/en/accessory/converter/grove_t">
    <img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/grove_t_01.png">
  </a>
-  <p class="item-title">Grove-T</p>
-</div> -->
+  <p class="item-title" style="font-style:italic;">Grove-T</p>
+</div>
+
+<div class="item">
+  <a href="/#/en/accessory/cable/grove_cable">
+    <img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/grove_cable_01.png">
+  </a>
+  <p class="item-title" style="font-style:italic;">Grove Cable</p>
+</div>
+
+<div class="item">
+  <a href="/#/en/tool/usb_downloader">
+    <img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/tool/usb_downloader_01.png">
+  </a>
+  <p class="item-title" style="font-style:italic;">USB Downloader</p>
+</div>

 <!-- GitHub Buttons -->
 <script async defer src="https://buttons.github.io/buttons.js"></script>
@@ -90,4 +90,4 @@ Arduino IDEを起動し、メニューから`ツール -> ボード -> M5Stack-C

 ## ビデオチュートリアル

-<iframe width="560" height="315" src="https://www.youtube.com/embed/U2es-l4z2Zg" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+<iframe width="560" height="315" src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/LukeVideo/M5Stack%20Arduino%20IDE%20Setup%20in%205%20minutes.mp4" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
@@ -1,4 +1,4 @@
-# M5Core クイックスタート(Windows, Arudino) {docsify-ignore-all}
+# M5Core クイックスタート {docsify-ignore-all}

 ## 目次

@@ -8,7 +8,7 @@
 4. [M5Stackライブラリのインストール](#_4-M5Stackライブラリのインストール)
 5. [サンプルスケッチ実行](#_5-サンプルスケッチ実行)

-### 1. Arduino IDEのインストール
+## 1. Arduino IDEのインストール

 ブラウザを開き、Arduinoの公式サイトにアクセスします。  https://www.arduino.cc/en/Main/Software

@@ -26,9 +26,9 @@

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_arduino_2.png">

-### 2. USB/UARTシリアル変換ドライバのインストール
+## 2. USB/UARTシリアル変換ドライバのインストール

-ブラウザを開き、M5Stackの公式サイトにアクセスします。  https://www.arduino.cc/en/Main/Software
+ブラウザを開き、M5Stackの公式サイトにアクセスします。  https://m5stack.com/download

 #### (1) `Windows`をクリックし、ファイルをダウンロードします。そしてダウンロードしたファイルを解凍します。

@@ -40,12 +40,14 @@

    <!-- 可能是堆叠之后，底座上的 M5-Bus 总线上的左下角的引脚 BATTERY 与 M5Core 接触不太好，这是生产时焊接位置偏了导致的。总线排针焊接位置稍微偏了一些之后，容易出现 BATTERY 引脚与 M5Core 接触不好。 -->

-    **原因和解决方案：**可能是因为这些串口的供电电流不够大，需要在主控中的 RST 引脚和 GND 引脚之间接入电容 ( 电容值是比0.1uF大的 )。
+    **原因和解决方案：**可能是因为这些串口的供电电流不够大，需要在主控中的 RST 引脚和 GND 引脚之间接入电容 ( 电容值是比0.1uF大的 )，或者在下载程序的时候，将 GPIO 0 连接到 GND，使得 GPIO 0 能持续足够的低电平。

    <img src="assets/img/faq/faq_05.png" width="80%" height="80%">

    <img src="assets/img/faq/faq_06.png" width="80%" height="80%">

+    <img src="assets/img/faq/faq_07.png" width="100%" height="100%">
+
 - **Q6: ESP32 有哪些特殊的 GPIO 管脚需要注意？**

    ESP32 有 34 个 GPIO 管脚，其中 GPIO 34-39 仅用作输入，不能作为输出，其他的既可以作为输入又可以作为输出管脚。
@@ -1,87 +1,145 @@
-# Core 上手指南(macOS, Arudino) {docsify-ignore-all}
+# M5Core 的上手指南 {docsify-ignore-all}

-<!-- :clapper: **[视频教程](#视频教程)**&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:memo: **[文本教程](#文本教程)** -->
+:clapper: **[视频教程](#视频教程)**&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:memo: **[文本教程](#目录)**

-?> 在配置环境之前，先确保你已经安装了USB驱动，并且M5Core能通过串口与PC通信。 如果还没的话，看这篇文章[如何建立串口连接](zh_CN/related_documents/establish_serial_connection).
+<!-- ?> 在配置环境之前，先确保你已经安装了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`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide.png">

-### Step2. 安装ESP32的支持包
+#### (2) 选择 `JUST DOWNLOAD`

-打开Arduino IDE，选择`Arduino`->`Peferences`->`Settings`
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide_02.png">
+
+#### (3) Arduino IDE 下载下来就可以直接双击打开使用
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide_03.png">
+
+## 2. 安装串口驱动
+
+<!-- *注意：如果已经安装了 CP21x 的串口驱动的话，请直接从[步骤 3](#_3-安装-ESP32-的板管理) 开始。* -->
+
+浏览器打开 M5Stack 官网 https://m5stack.com/download
+
+#### (1) 点击 `Mac`，下载 Mac 版本的驱动安装包并解压
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/download_usb_driver_mac_01.png">
+
+#### (2) 解压后，双击镜像文件 SiLabsUSBDriverDisk.dmg，开始安装
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_dmg.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_pkg.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/2.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/3.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/4.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/5.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/6.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/7.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/8.png">
+
+<img src="assets/img/getting_started_pics/establish_serial_connection/9.png">
+
+#### (4) 检查确认 COM 串口名
+
+检查确认 COM 串口名，以确定串口驱动是否安装成功：
+
+打开终端 `Terminal`，将 Core 通过 USB Type-C 线连接电脑，执行以下命令
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/check_serial_port_mac_01.png">
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/check_serial_port_mac_02.png">
+
+拔掉 USB 线，再执行一次刚刚的命令，此时终端 `Terminal` 上显示的 COM 列表里消失的 COM 口就是该 Core 对应的 串口名。
+
+<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/check_serial_port_mac_03.png">
+
+## 3. 安装 ESP32 的板管理
+
+#### (1) 打开 Arduino IDE，选择 `文件`->`首选项`->`设置`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_01.png">

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_02.png">

-复制下面最新的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*

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_03.png">

-都确定OK之后，选择`Tools`->`Board:`->`Boards Manager...`，在新弹出的对话框中，输入并搜索`ESP32`，点击`安装`
+#### (3) 选择 `工具`->`开发板:`->`开发板管理器...`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_04.png">

+#### (4) 在新弹出的对话框中，输入并搜索 `ESP32`，点击`安装`
+
 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_05.png">

-### Step3. 安装Arduino-M5Stack库
+## 4. 安装 M5Stack 的库

-打开Arduino IDE, 然后选择`Sketch`->`Include Library`->`Manage Libraries...`
-
-在搜索框输入`M5Stack`搜索并安装。
+#### (1) 打开 Arduino IDE, 然后选择 `项目`->`加载库`->`库管理...`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_06.png">

+#### (2) 搜索 `M5Stack` 并安装，如下图所示
+
 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_07.png">

-## 示例
+## 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` 以选择合适的串口号

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_10.png">

-### 2. 选择一个例程
+#### (2) 选择示例程序 `HelloWorld.ino`

-点击`File`->`Examples`->`M5Stack`->`Basics`
+点击 `File`->`Examples`->`M5Stack`->`Basics`

-选择例程`HelloWorld`.
+选择例程 `HelloWorld`.

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_09.png">

-编译并上传这个例程，然后M5Stack屏幕会显示"Hello World!"
+编译并上传这个例程，然后 M5Stack 屏幕会显示 "Hello World!"

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/display_hello_world.png">

 ## 注意

-虽然大多数版本的MacOS系统都没找不到串口号这个问题，可是有些最新版本系统就可能出现这个问题。
-如果真的遇到这个问题了，请连接M5并在`system preferences`中打开`security and privacy`，设置`permit`
+虽然大多数版本的 MacOS 系统都没找不到串口号这个问题，可是有些最新版本系统就可能出现这个问题。
+如果真的遇到这个问题了，请连接M5并在 `system preferences` 中打开 `security and privacy`，设置 `permit`

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy.png">

@@ -89,10 +147,10 @@

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy_02.png">

-?> **如果你想了解更多关于CP2104 USB驱动的资料，请阅读这个链接的内容** https://developer.apple.com/library/archive/technotes/tn2459/\_index.html
+?> **如果你想了解更多关于 CP2104 USB 驱动的资料，请阅读这个链接的内容** https://developer.apple.com/library/archive/technotes/tn2459/\_index.html

-<!-- ## 视频教程
+## 视频教程

 <!-- **Windows** -->

-<iframe width="560" height="315" src="https://www.youtube.com/embed/U2es-l4z2Zg" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> -->
+<iframe width="560" height="315" src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/LukeVideo/M5Stack%20Arduino%20IDE%20Setup%20in%205%20minutes.mp4" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
@@ -14,7 +14,7 @@

 **[5. 示例](#_5-示例)**

-### 1. 安装 Arduino IDE
+## 1. 安装 Arduino IDE

 <!-- *注意：如果已经安装了 IDE，请直接从[步骤 2](#_2-安装串口驱动) 开始。* -->

@@ -34,7 +34,7 @@

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_arduino_2.png">

-### 2. 安装串口驱动
+## 2. 安装串口驱动

 <!-- *注意：如果已经安装了 CP21x 的串口驱动的话，请直接从[步骤 3](#_3-安装-ESP32-的板管理) 开始。* -->

@@ -72,7 +72,7 @@

 <!-- <img src="assets/img/getting_started_pics/establish_serial_connection/windows_m5stack_in_device_manager.png"> -->

-### 3. 安装 ESP32 的板管理
+## 3. 安装 ESP32 的板管理

 #### (1) 打开 IDE，选择 `文件`->`首选项`->`设置`

@@ -91,9 +91,10 @@
 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_04_cn.png">

 #### (4) 在新弹出的对话框中，输入并搜索 `ESP32`，点击`安装`
+
 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_05_cn.png">

-### 4. 安装 M5Stack 的库
+## 4. 安装 M5Stack 的库

 #### (1) 打开 Arduino IDE, 然后选择 `项目`->`加载库`->`库管理...`

@@ -107,7 +108,7 @@

 <img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/update_m5stack_lib.png"> -->

-### 5. 示例
+## 5. 示例

 这部分是为了验证现在您是否能通过 Arduino IDE 对 M5Core 编程。