This commit is contained in:
LiHuashen
2019-01-05 14:04:01 +08:00
parent 063f6f4b2d
commit 94bf63209d
16 changed files with 77 additions and 144 deletions
Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 85 KiB

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 124 KiB

After

Width:  |  Height:  |  Size: 111 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 114 KiB

After

Width:  |  Height:  |  Size: 101 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 49 KiB

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 116 KiB

After

Width:  |  Height:  |  Size: 103 KiB

@@ -1,6 +1,6 @@
# M5Core Quick Start(macOS, Arudino)
!> 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).
?> 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).
## CONTENT
@@ -1,6 +1,6 @@
# M5Core Quick Start(Windows, Arudino)
!> We suggest you confirm whether the `USB driver`, `Git` and `Arduino IDE` has installed first. If not, please view this two articles [establish serial connection](/en/related_documents/establish_serial_connection) and [Install Git and Arduino IDE](/en/related_documents/how_to_install_git_and_arduino).
?> We suggest you confirm whether the `USB driver`, `Git` and `Arduino IDE` has installed first. If not, please view this two articles [establish serial connection](/en/related_documents/establish_serial_connection) and [Install Git and Arduino IDE](/en/related_documents/how_to_install_git_and_arduino).
## CONTENT
@@ -10,47 +10,29 @@
**[Download the SiLabs CP2104 Driver](https://www.silabs.com/documents/public/software/Mac_OSX_VCP_Driver.zip)**
**As the disk image SiLabsUSBDriverDisk.dmg is downloaded, mount it. Proceed according to the instructions OK.**
**After the disk image `SiLabsUSBDriverDisk.dmg` was downloaded, mount it.**
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_dmg.png">
</figure>
**And install this USB driver following those screenshots.**
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_pkg.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_dmg.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/2.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/macOS_CP2104_pkg.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/3.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/2.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/4.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/3.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/5.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/4.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/6.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/5.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/7.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/6.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/8.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/7.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/9.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/8.png">
<img src="assets/img/getting_started_pics/establish_serial_connection/9.png">
### 2. Check port on MacOS
@@ -70,23 +52,15 @@
**Choice the version of USB driver according to your windows version(Windows7/8/10).**
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_download_CP2104_USB_driver.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_download_CP2104_USB_driver.</figure>
**Choice the right version installer(x64/x86), and install it.**
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver01.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver01.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver02.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver02.png">
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver03.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver03.png">
### 2. Check port on Windows
@@ -94,6 +68,4 @@
**Figures below show serial port for M5Stack Core board**
<figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_m5stack_in_device_manager.png">
</figure>
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_m5stack_in_device_manager.</figure>
@@ -1,8 +1,6 @@
# M5Core クイックスタート(macOS, Arudino)
?> **Tip** もしWindowsを使っているなら[こちらへ](/ja/quick_start/m5core/m5stack_core_get_started_Arduino_Windows)
?> *環境設定の前に、シリアルドライバがインストールされているか確認いてください。もしまだの場合は[シリアル接続の確立方法](ja/related_documents/establish_serial_connection)を参照してください。*
## コンテンツ
@@ -16,38 +14,33 @@
2. [例題](#例題)
?> **Note** *環境設定の前に、シリアルドライバがインストールされているか確認いてください。もしまだの場合は[シリアル接続の確立方法](/en/related_documents/establish_serial_connection)を参照してください。*
## 環境設定
### Step1. `Arduino IDE`インストール
最初にArduino IDEをインストールします。ダウンロードアドレスは https://www.arduino.cc/en/Main/Software です。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_download_arduino_ide.png">
### Step2. ESP32ボードサポート
ターミナルを開いて次のコマンドを実行します。(全文コピーして、ターミナルに貼り付けてッターン!)
Arduino IDEを起動し、メニューか`Arduino`->`Peferences`->`Settings`
```shell
mkdir -p ~/Documents/Arduino/hardware/espressif && \
cd ~/Documents/Arduino/hardware/espressif && \
git clone https://github.com/espressif/arduino-esp32.git esp32 && \
cd esp32 && \
git submodule update --init --recursive && \
cd tools && \
python get.py
```
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_01.png">
デフォルトでスケッチが保存される場所は ~/Documents/Arduino です。もしArduino IDEの設定でスケッチブックの位置を変更している場合や、何か問題が発生したときは必要に応じて上記のコマンドを調整してください。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_02.png">
?> **Tip** もし下記のエラーが発生したら: `xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools),`
`missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun`, ターミナルで`xcode-select --install`を実行し、Arduino IDEを再起動してみてください。
このオプションに最新のESP32ボード管理URLを追加してください`Additional Boards Manager URLs: `
?> **Tip** もし下記のエラーが発生したら: `IOError: [Errno socket error] [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol` `version (_ssl.c:590) when running python get.py`, 上記のコマンドの`python get.py`の行を`python3 get.py`に置き換えて実行し、Arduino IDEを再起動します。
*最新の掲示板管理URLはこちら:"https://github.com/espressif/arduino-esp32/releases/download/1.0.1-rc1/package_esp32_dev_index.json"*
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_03.png">
確認後,選ぶ`Tools`->`Board:`->`Boards Manager...`,新しいポップアップダイアログで、入力して検索します`ESP32`,クリック`Install`
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_04.png">
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_05.png">
### Step3. M5Stack Libインストール
@@ -55,13 +48,9 @@ Arduino IDEを起動し、メニューから`スケッチ`->`ライブラリを
検索ボックスに`m5stack`と入力して検索し、M5Stackのライブラリをインストールします。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_install_m5stack_lib.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_06.png">
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_search_m5stack.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_07.png">
## 例題
@@ -71,43 +60,28 @@ USBケーブルをM5Stackに接続し、ボードとシリアルポートを選
Arduino IDEを起動し、メニューから`ツール -> ボード -> M5Stack-Core-ESP32`とボードを選択します。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_select_board.png">
</figure>
次に、メニューから`ツール -> シリアルポート -> /dev/cu.SLAB_USBtoUART` とシリアルポートを選択します。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_select_serial_port.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_10.png">
### 2. サンプルスケッチ
サンプルスケッチを利用して、定番のHelloWorldを表示してみましょう。メニューから`ファイル -> スケッチ例 -> M5Stack -> Basics -> HelloWorld`と選択します。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_select_example.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_09.png">
コンパイルしてアップロード実行すると、M5Stackの画面に `Hello World!` と表示されます。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/display_hello_world.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/display_hello_world.png">
## ノート
もしシリアルポートが見つからない場合は、Macの`システム環境設定 -> セキュリティとプライバシー`を開いてブロックされているアプリを許可してください。それでもダメな場合は、再度シリアルドライバをインストールしてください。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy.png">
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy_01.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy_01.png">
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy_02.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/macOS_security_and_privacy_02.png">
?> **Tip** **もしmacOSのパーミッションについてもっと詳しい情報が知りたい方は、次のリンクを参照してください。** https://developer.apple.com/library/archive/technotes/tn2459/\_index.html
@@ -1,8 +1,6 @@
# M5Core クイックスタート(Windows, Arudino)
?> **Tip** もしMacをお使いの方は[こちら](ja/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS)を参照してください。
?> `USB driver``Git``Arduino IDE` をインストールしているか確認してください。 もしまだの場合は、 [シリアル接続の確立方法](ja/related_documents/establish_serial_connection) と [GitとArduino IDEのインストール方法](ja/related_documents/how_to_install_git_and_arduino)を参照してください。
## コンテンツ
@@ -14,47 +12,42 @@
2. [例題](#例題)
?> **Tip** *もしM5Stack Libを更新したい場合はこちらの記事を参照してください。[Arduino IDEのM5Stackライブラリ更新方法](/ja/related_documents/upgrade_m5stack_lib).*
?> **Note** *`USB driver`、`Git`、`Arduino IDE(Installation path: C:\Program Files\Arduino)` をインストールしているか確認してください。 もしまだの場合は、 [シリアル接続の確立方法](/ja/related_documents/establish_serial_connection) と [GitとArduino IDEのインストール方法](/ja/related_documents/how_to_install_git_and_arduino)を参照してください。もしあなたがすでにArduino IDEをデフォルトの`C:\Program Files\Arduino`以外にインストールしている場合は、デフォルトパスに再インストールしてください。*
## 環境設定
### Step1. arduino-ESP32サポートのダウンロード
次のバッチファイルをダウンロードして、実行してください。[download_arduino_esp32_support.bat](https://github.com/m5stack/m5-docs/tree/master/docs/assets/scripts/download_arduino_esp32_support.bat)
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/execute_batch_file.png">
</figure>
Arduino IDEを起動し、メニューか`File`->`Peferences`->`Settings`
以下のようにGitHubからリポジトリを取得します。(少し時間がかかります)
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/execute_batch_file_for_downloading_arduino_esp32.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_01.png">
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/download_arduino_esp32_completed.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_02.png">
このオプションに最新のESP32ボード管理URLを追加してください`Additional Boards Manager URLs: `
*最新の掲示板管理URLはこちら:"https://github.com/espressif/arduino-esp32/releases/download/1.0.1-rc1/package_esp32_dev_index.json"*
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_03.png">
確認後,選ぶ`Tools`->`Board:`->`Boards Manager...`,新しいポップアップダイアログで、入力して検索します`ESP32`,クリック`Install`
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_04.png">
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_05.png">
### Step2. M5Stackライブラリのダウンロード
Arduino IDEを開いて`スケッチ -> ライブラリをインクルード -> ライブラリを管理...`と選択します。開いたウィンドウの検索ボックスに`m5stack`と検索し、出てきたライブラリをインストールします。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_m5stack_lib_01.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_06.png">
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_m5stack_lib_02.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_07.png">
!> **Note:** *以下のように表示された場合は、アップデートです。*
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/update_m5stack_lib.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/update_m5stack_lib.png">
## 例題
@@ -64,21 +57,15 @@ Arduino IDEを開いて`スケッチ -> ライブラリをインクルード ->
Arduino IDEのメニューから`ツール`を選択し、ボードとボーレート、シリアルポートを次のように選択します。M5Stack-Core-ESP32、921600、COMx(シリアルポートの番号はお使いの環境によって変わります。)
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/select_board_baudrate_serial_port.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/select_board_baudrate_serial_port.png">
メニューから`ファイル -> スケッチ例 -> M5Stack -> Basics -> FactoryTest`を選択します。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/select_an_example.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/select_an_example.png">
コンパイル&アップロード実行します。
<figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/arduino_upload.png">
</figure>
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/arduino_upload.png">
### 2. 新しいM5Stackのプログラム
@@ -106,3 +93,5 @@ void loop() {
```
コンパイルしてアップロードすると、M5Stackの画面に"Hello World! M5Stack is running successfully!"とメッセージが表示されます。
?> *もしM5Stack Libを更新したい場合はこちらの記事を参照してください。[Arduino IDEのM5Stackライブラリ更新方法](ja/related_documents/upgrade_m5stack_lib).*
@@ -4,6 +4,6 @@
## 好きなプログラミング言語を以下から選んでください。
<img src="assets/img/getting_started_pics/arduino_logo.png"> | <img src="assets/img/getting_started_pics/blockly_and_micropython.png">
---|---
[Arduino](/ja/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) | [Blockly/MicroPython](/ja/quick_start/m5core/m5stack_core_get_started_MicroPython)
<img src="assets/img/macos-logo.png"> | <img src="assets/img/windows-logo.png"> | <img src="assets/img/getting_started_pics/blockly_and_micropython.png">
---|---|---
[MacOS](ja/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) | [Windows](ja/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) | [UiFlow(Blockly/MicroPython)](ja/quick_start/m5core/m5stack_core_get_started_MicroPython)
@@ -1,6 +1,6 @@
# シリアル接続の確立方法
**[MacOS](#for-macOS)**&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;**[Windows](#for-windows)**
**[MacOS](#acOS)**&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;**[Windows](#windows)**
**このページでは、M5StackとPCとの間でシリアル接続を確立するための方法を説明します。**
@@ -1,7 +1,7 @@
# Core 上手指南(macOS, Arudino)
!> 在配置环境之前,先确保你已经安装了USB驱动,并且M5Core能通过串口与PC通信。 如果还没的话,看这篇文章[如何建立串口连接](zh_CN/related_documents/establish_serial_connection).
?> 在配置环境之前,先确保你已经安装了USB驱动,并且M5Core能通过串口与PC通信。 如果还没的话,看这篇文章[如何建立串口连接](zh_CN/related_documents/establish_serial_connection).
## 目录
@@ -31,13 +31,13 @@
<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: `选项
添加最新的ESP32管理网址到`Additional Boards Manager URLs: `选项
*目前最新的板管理网址是这个:"https://github.com/espressif/arduino-esp32/releases/download/1.0.1-rc1/package_esp32_dev_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`,点击`安装`
都确定OK之后,选择`Tools`->`Board:`->`Boards Manager...`,在新弹出的对话框中,输入并搜索`ESP32`,点击`安装`
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/mac/quick_start_arduino_mac_04.png">
@@ -1,6 +1,6 @@
# Core 上手指南(Windows, Arudino)
!> 建议你先确认安装了`USB驱动``Arduino IDE`。 如果还没的话,阅读这两篇文档[如何建立串口连接](/zh_CN/related_documents/establish_serial_connection)和[安装Arduino IDE](/zh_CN/related_documents/how_to_install_git_and_arduino)。
?> 建议你先确认安装了`USB驱动``Arduino IDE`。 如果还没的话,阅读这两篇文档[如何建立串口连接](/zh_CN/related_documents/establish_serial_connection)和[安装Arduino IDE](/zh_CN/related_documents/how_to_install_git_and_arduino)。
## 目录
@@ -15,8 +15,6 @@
## 1. 配置环境
#### (*仅仅只需两步就能完成安装,并开始开发M5Core啦*)
### Step1. 下载Arduino-ESP32的支持包
打开Arduino IDE,选择`File`->`Peferences`->`Settings`
@@ -6,4 +6,4 @@
<img src="assets/img/macos-logo.png"> | <img src="assets/img/windows-logo.png"> | <img src="assets/img/getting_started_pics/blockly_and_micropython.png">
---|---|---
[MacOS](/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) | [Windows](/zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) | [UiFlow(Blockly/MicroPython)](/zh_CN/quick_start/m5core/m5stack_core_get_started_MicroPython)
[MacOS](zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) | [Windows](zh_CN/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) | [UiFlow(Blockly/MicroPython)](zh_CN/quick_start/m5core/m5stack_core_get_started_MicroPython)