m5/m5-docs
0
0
Fork 0
mirror of https://github.com/m5stack/m5-docs.git synced 2026-05-20 10:23:01 -07:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'master' of https://github.com/m5stack/m5-docs

Browse Source
This commit is contained in:
LiHuashen
2019-03-13 15:33:51 +08:00
parent edee047430 4bc43004d8
commit 1e05b0e082
10 changed files with 129 additions and 79 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/en/core/basic.md
+1 -1
View File
@@ -63,7 +63,7 @@ This is a [Bottom board](en/base/core_bottom) on the back of M5Core. It's design
</tr>
<tr>
<td>Flash</td>
<td>4M-Bytes</td>
<td>16MB (old model: 4MB)</td>
</tr>
<tr>
<td>Input</td>
docs/en/core/gray.md
+1 -1
View File
@@ -106,7 +106,7 @@ This is a [Bottom board](en/base/core_bottom) on the back of M5Core. It's design
</tr>
<tr>
<td>Flash</td>
<td>4MB</td>
<td>16MB (old model: 4MB)</td>
</tr>
<tr>
<td>Input</td>
docs/en/core/m5go.md
+1 -1
View File
@@ -103,7 +103,7 @@ We also supply some courses for teaching IOT programming. If you are interesting
</tr>
<tr>
<td>Flash & PSRAM</td>
<td>16MB Flash + 4MB pSRAM </td>
<td>16MB Flash</td>
</tr>
<tr>
<td>Input</td>
docs/en/core/m5go_lite.md
+1 -1
View File
@@ -106,7 +106,7 @@ We also supply some courses for teaching IOT programming. If you are interesting
</tr>
<tr>
<td>Flash & PSRAM</td>
<td>16MB Flash + 4MB pSRAM </td>
<td>16MB Flash</td>
</tr>
<tr>
<td>Input</td>
docs/ja/core/basic.md
+1 -1
View File
@@ -64,7 +64,7 @@
|項目|詳細|
|:---|:---|
|ESP32| 240MHz x 2コア, 600 DMIPS, 520KB SRAM, Wi-Fi, デュアルモードBluetooth|
|Flash| 4MB |
|Flash| 16MB (旧: 4MB) |
|電源入力| 5V @ 500mA |
|インターフェース| USB Type-C x 1, Grove(I2C+I/0+UART) x 1|
|画面| 2 inch, 320x240 Colorful TFT LCD, ILI9342 |
docs/ja/core/gray.md
+1 -1
View File
@@ -109,7 +109,7 @@
</tr>
<tr>
<td>Flash</td>
<td>4MB</td>
<td>16MB (旧: 4MB)</td>
</tr>
<tr>
<td>電源入力</td>
docs/ja/faq.md
+42 -35
View File
@@ -4,10 +4,9 @@
## Core
---
### Q. 各M5Coreの違いを教えてください。
- Q. 各M5Coreの違いを教えてください。
- A. 各M5Coreの主な違いは、内部ハードウェアの構成とキットのセット内容です。 基本モデルから上位モデルになるにつれ、姿勢センサーMPU9250の追加、FLASHの増量、PSRAMの追加などの違いがあります。 詳しくは[こちら](https://github.com/m5stack/M5-Schematic/blob/master/Core/hardware_difference_between_cores_ja.md)をご覧ください。
A. 各M5Coreの主な違いは、内部ハードウェアの構成とキットのセット内容です。 基本モデルから上位モデルになるにつれ、姿勢センサーMPU9250の追加、FLASHの増量、PSRAMの追加などの違いがあります。 詳しくは[こちら](https://github.com/m5stack/M5-Schematic/blob/master/Core/hardware_difference_between_cores_ja.md)をご覧ください。
<img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_table/core_comparison/core_main_comparison_04_ja.png">
@@ -15,78 +14,86 @@
---
- Q. 内蔵スピーカーをどうしたらオフにできますか？
- A. Setup()関数の中に以下の命令を追記してください。
### Q. 内蔵スピーカーをどうしたらオフにできますか？
```arduino
dacWrite(M5STACKFIRE_SPEAKER_PIN, 0);
```
A. Setup()関数の中に以下の命令を追記してください。
```arduino
dacWrite(M5STACKFIRE_SPEAKER_PIN, 0);
```
---
- Q. M5Coreとモジュールを積み重ねたあとだと、ソフトウェアを書き込みできません。（例えばUSB Host モジュール）
- A. GPIO0 ピンとM5CoreのM-Busとの接触が悪いために起きている可能性があります。しっかりと挿さっているか確認してください。
### Q. M5Coreとモジュールを積み重ねたあとだと、ソフトウェアを書き込みできません。（例えばUSB Host モジュール）
どうしてもダメな場合は、自分でGPIO０ピンをGNDにプルダウンしてみてください。
A. GPIO0 ピンとM5CoreのM-Busとの接触が悪いために起きている可能性があります。しっかりと挿さっているか確認してください。どうしてもダメな場合は、自分でGPIO０ピンをGNDにプルダウンしてみてください。
---
- Q. M5GOと[M5GO bottom](ja/base/m5go_bottom)を組み合わせた時に、バッテリは満充電のはずなのに、電源が入りません。
- A. スタッキング後、ベース上のM-Busの左下隅のBATTERYピンがM5Coreに正しく接続されていない可能性があります。これは製造時のはんだ付け位置のずれが原因です。バスピンの位置がわずかに偏っていると、BATTERYピンがM5Coreとうまく接触しないことがあります。再度はんだ付けをして直す必要があります。自分で直せない方は、購入元または @M5Stack にご相談ください。
### Q. M5GOと[M5GO bottom](ja/base/m5go_bottom)を組み合わせた時に、バッテリは満充電のはずなのに、電源が入りません。
A. スタッキング後、ベース上のM-Busの左下隅のBATTERYピンがM5Coreに正しく接続されていない可能性があります。これは製造時のはんだ付け位置のずれが原因です。バスピンの位置がわずかに偏っていると、BATTERYピンがM5Coreとうまく接触しないことがあります。再度はんだ付けをして直す必要があります。自分で直せない方は、購入元または @M5Stack にご相談ください。
---
- Q. 書き込み時に以下の図のようなエラーになってしまいます。
### Q. 書き込み時に以下の図のようなエラーになってしまいます。
<img src="assets/img/faq/faq_03.png">
- A. PCによって書き込みができない場合があるようです。そこで下図のRST-GND間に0.1uF〜程度のコンデンサをつけると改善する場合があるようです。
A. PCによって書き込みができない場合があるようです。そこで下図のRST-GND間に0.1uF〜程度のコンデンサをつけると改善する場合があるようです。
<img src="assets/img/faq/faq_05.png" width="80%" height="80%">
---
- Q. ESP32で取り扱いに注意しないといけないピンはありますか？
- A. GPIO34-39までは入力専用です。出力には使用できません。その他は入出力に使用できます。
### Q. ESP32で取り扱いに注意しないといけないピンはありますか？
A. GPIO34-39までは入力専用です。出力には使用できません。その他は入出力に使用できます。
---
- Q. M5Stick with MPU9250で工場出荷時のファームウェアだと起動してから、ボタンAを押すとNoと表示されますが、これはMPU9250がないということですか？
- A. 再起動してください。そうすれば認識されるはずです。なぜならMPU9250検出用コードはSetup()内にあり、一度しか実行されないため、検出に失敗することがあります。
### Q. M5Stick Gray（MPU9250あり）で工場出荷時のファームウェアを起動し、ボタンAを押すとNoと表示されますが、これはMPU9250がないということですか？
A. 再起動してみてください。認識されるはずです。
## Unit
- Q. M5Stack向けの各カメラの違いはなんですか？
- A. 各カメラの主な違いは、いくつかのピンの位置(OV2640-SIOD、OV2640-VSYNC, GROVEポート)、 レンズタイプ、 PSRAMの有無があります。詳しくは[こちら](https://shimo.im/sheets/gP96C8YTdyjGgKQC/09fd4)をご覧ください。
### Q. M5Stack向けの各カメラの違いはなんですか？
<img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_table/camera_comparison/camera_comparison_ja.png">
A. 各カメラの主な違いは、いくつかのピンの位置(OV2640-SIOD、OV2640-VSYNC, GROVEポート)、 レンズタイプ、 PSRAMの有無があります。詳しくは[こちら](https://shimo.im/sheets/gP96C8YTdyjGgKQC/09fd4)をご覧ください。
- Q. WiFiを用いて、カメラの画像をスマートフォンに送信できますが、どの程度の距離まで大丈夫ですか？
- A. M5Cameraで実験したところ、室内では約20メートルでした。
<img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_table/camera_comparison/camera_comparison_ja.png">
### Q. WiFiを用いて、カメラの画像をスマートフォンに送信できますが、どの程度の距離まで大丈夫ですか？
A. M5Cameraで実験したところ、室内では約20メートルでした。
## 共通
---
### Q. USB Type-C ケーブルに表裏はありますか？
- Q. USB Type-C ケーブルに表裏はありますか？
- A. 仕様上は表裏の区別はありませんが、たまに接触が悪い場合があるようです。その場合は表裏を逆に差し替えてみてください。
A. 仕様上は表裏の区別はありませんが、たまに接触が悪い場合があるようです。その場合は表裏を逆に差し替えてみてください。
---
- Q. ArduinoでI2Cがうまく動きません。
- A. Arduino IDEのボードマネージャから最新のesp32ライブラリ(>=1.0.1)を導入してください。
### Q. ArduinoでI2Cがうまく動きません。
A. Arduino IDEのボードマネージャから最新のesp32ライブラリ(>=1.0.1)を導入してください。
---
- Q. UIFlowのソースは公開されていますか？
- A. 現在公開はされていません。もしかしたら将来公開されるかもしれません。
### Q. UIFlowのソースは公開されていますか？
A. 現在公開はされていません。もしかしたら将来公開されるかもしれません。
---
- Q. XXX の使い方がわかりません。
- A. Twitterで [@M5Stack](https://twitter.com/M5Stack) 宛てにメッセージをお送りください。
### Q. XXX の使い方がわかりません。
A. Twitterで [@M5Stack](https://twitter.com/M5Stack) 宛てにメッセージをお送りください。
---
- Q. 買った時から XXX が壊れています。
- A. お買い求め担ったお店にお問い合わせいただくか、またはTwitterで [@M5Stack](https://twitter.com/M5Stack) 宛てにメッセージをお送りください。
### Q. 買った時から XXX が壊れています。
A. お買い求め担ったお店にお問い合わせいただくか、またはTwitterで [@M5Stack](https://twitter.com/M5Stack) 宛てにメッセージをお送りください。
docs/ja/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md
+79 -36
View File
@@ -1,96 +1,139 @@
# M5Core クイックスタート(Windows, Arudino) {docsify-ignore-all}
?> `USB driver`、`Git`、`Arduino IDE` をインストールしているか確認してください。 もしまだの場合は、 [シリアル接続の確立方法](ja/related_documents/establish_serial_connection) と [GitとArduino IDEのインストール方法](ja/related_documents/how_to_install_git_and_arduino)を参照してください。
## 目次
## コンテンツ
1. [Arduino IDEのインストール](#_1-Arduino-IDEのインストール)
2. [USB/UARTシリアル変換ドライバのインストール](#_2-USBUARTシリアル変換ドライバのインストール)
3. [ESP32ボードマネージャのインストール](#_3-ESP32ボードマネージャのインストール)
4. [M5Stackライブラリのインストール](#_4-M5Stackライブラリのインストール)
5. [サンプルスケッチ実行](#_5-サンプルスケッチ実行)
1. [環境設定](#環境設定)
### 1. Arduino IDEのインストール
- [Step1. arduino-ESP32サポートのダウンロード](#step1-arduino-esp32サポートのダウンロード)
ブラウザを開き、Arduinoの公式サイトにアクセスします。 https://www.arduino.cc/en/Main/Software
- [Step2. M5Stackライブラリのダウンロード](#step2-m5stackライブラリのダウンロード)
#### (1) `Windows ZIP file for non admin install`をクリックし、`Arduino IDE`をダウンロードします。
2. [例題](#例題)
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/arduino_cc_package.png">
## 環境設定
#### (2) `JUST DOWNLOAD`をクリックします。
### Step1. arduino-ESP32サポートのダウンロード
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/arduino_cc_package_02.png">
Arduino IDEを起動し、メニューから`File`->`Peferences`->`Settings`と選択します。
#### (3) `Arduino IDE`をインストールするために、実行ファイルをダブルクリックします。選択肢はデフォルトのまま、最後まで進めていきます。
以下のようにGitHubからリポジトリを取得します。（少し時間がかかります）
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/select_arduino_install_path.png">
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_arduino_2.png">
### 2. USB/UARTシリアル変換ドライバのインストール
ブラウザを開き、M5Stackの公式サイトにアクセスします。 https://www.arduino.cc/en/Main/Software
#### (1) `Windows`をクリックし、ファイルをダウンロードします。そしてダウンロードしたファイルを解凍します。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/download_usb_driver_win_01.png">
#### (2) お使いのWindowsのビット数に合わせて、ドライバをインストールします。
* 32ビット版Windowsをお使いの方は `CP210xVCPInstaller_x86_vx.x.x.x.exe`
* 64ビット版Windowsをお使いの方は `CP210xVCPInstaller_x64_vx.x.x.x.exe`
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver01.png">
#### (3) 実行ファイルをダブルクリックし、インストールします。
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver02.png">
<img src="assets/img/getting_started_pics/establish_serial_connection/windows_install_usb_driver03.png">
#### (4) シリアルポート`COMx`の番号を確認します。
USB/UARTシリアル変換ドライバがうまくインストールされている場合は、`Windowsデバイスマネージャ`からCOMポートの番号を確認することができます:
USB Type-C ケーブルを使ってM5CoreをPCに接続します。`Windowsデバイスマネージャ`を開き、`ポート(COM & LPT)`をクリックし、COMポート番号を確認します。
もしどのCOMポートかわからない場合は、一度M5CoreをPCから外し、再度接続することでCOMポートが表示されます。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/check_serial_port_01.png">
## 3. ESP32ボードマネージャのインストール
#### (1) Arduino IDEを起動し、メニューから`ファイル`->`Peferences`->`環境設定`と選択します。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_01.png">
<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: `
#### (2) 以下のESP32 Boards Manager URLを`Additional Boards Manager URLs:`に追記します。
*最新のボードマネージャURLはこちら：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/windows/quick_start_arduino_win_03.png">
`Tools`->`Board:`->`Boards Manager...`を選択し、新しいポップアップダイアログで、`ESP32`と入力して検索します。`Install`をクリックします。
#### (3) `ツール`->`Board:`->`ボードマネージャ...`と選択します。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_04.png">
#### (4) ダイアログで`ESP32`と検索し、`Install`をクリックします。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_05.png">
### Step2. M5Stackライブラリのダウンロード
## 4. M5Stackライブラリのインストール
Arduino IDEを開いて`スケッチ -> ライブラリをインクルード -> ライブラリを管理...`と選択します。開いたウィンドウの検索ボックスに`m5stack`と検索し、出てきたライブラリをインストールします。
#### (1) Arduino IDEを開き、メニューから`スケッチ`->`ライブラリのインクルード`->`ライブラリの管理...`と選択します。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/quick_start_arduino_win_06.png">
<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_07.png">
#### (2) `M5Stack`と検索し、インストールします。
!> **Note:** *以下のように表示された場合は、アップデートします。*
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/install_m5stack_lib_02.png">
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/update_m5stack_lib.png">
## 5. サンプルスケッチ実行
## 例題
Arduino IDEには多数のサンプルプログラム（サンプルスケッチという）が予め用意されています。
USBケーブルでPCとM5Coreを接続し、M5Coreが接続されているCOMポートを選択し、
サンプルスケッチ選択、そしてコンパイル＆アップロードの順番で実行していきます。
このセクションではArduinoでプログラムができるかを確認します。最初にM5StackとPCをUSBケーブルで接続してください。そしてM5Stackが接続されているシリアルポートを選択し、サンプルプログラムを実行してみましょう。
#### (1) 実行するための設定をします。
### 1. `FactoryTest.ino`サンプルスケッチ実行
Arduino IDEのメニューから`ツール`を選択し、ボードとボーレート、シリアルポートを次のように選択します。M5Stack-Core-ESP32、921600、COMx（シリアルポートの番号はお使いの環境によって変わります。)
あなたのボード、ボーレート（通信速度）、COMポートを選択します。(例：M5Stack-Core-ESP32, 921600, COM26) `COM`ポートの番号は人により異なります。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/select_board_baudrate_serial_port.png">
メニューから`ファイル -> スケッチ例 -> M5Stack -> Basics -> FactoryTest`を選択します。
#### (2) `FactoryTest.ino`のサンプルスケッチを選択します。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/select_an_example.png">
コンパイル＆アップロード実行します。
#### (3) プログラムのコンパイルとM5Coreへのプログラムのアップロードを行います。
<img src="assets/img/getting_started_pics/m5stack_core/get_started_with_arduino_m5core/windows/arduino_upload.png">
### 2. 新しいM5Stackのプログラム
#### (4) 最初のM5Stackプログラム
Arduino IDEで新しいファイルを開いて`my_test`という名前をつけます。
次に以下のコードをコピーし、`my_test`に貼り付けます。
Arduino IDEを開き、`新しいファイル(.ino)`を開き、`my_test.ino`と名前を変更します。
そして以下のプログラムをコピーして、貼り付けし、実行してみましょう。
```arduino
#include <M5Stack.h>
// M5Stackがスタートする時に一度だけ実行されます。
// the setup routine runs once when M5Stack starts up
void setup(){
// M5Stackの初期化
M5.begin();
// LCDの画面に表示
// LCD display
M5.Lcd.print("Hello World!");
M5.Lcd.print("M5Stack is running successfully!");
}
// この中の処理は無限に繰り返し実行されます。
// 無限ループ
void loop() {
// このプログラムでは何もしない
}
```
コンパイルしてアップロードすると、M5Stackの画面に"Hello World! M5Stack is running successfully!"とメッセージが表示されます。
?> *もしM5Stack Libを更新したい場合はこちらの記事を参照してください。[Arduino IDEのM5Stackライブラリ更新方法](ja/related_documents/upgrade_m5stack_lib).*
アップロードが成功すると、M5Stackの画面に、`Hello World!M5Stack is running successfully!`と表示されるはずです。
docs/zh_CN/core/basic.md
+1 -1
View File
@@ -69,7 +69,7 @@
</tr>
<tr>
<td>Flash闪存</td>
<td>4M-Bytes</td>
<td>16MB (旧: 4MB)</td>
</tr>
<tr>
<td>输入电压</td>
docs/zh_CN/core/gray.md
+1 -1
View File
@@ -82,7 +82,7 @@
</tr>
<tr>
<td>Flash闪存</td>
<td>4M-Bytes</td>
<td>16MB (旧: 4MB)</td>
</tr>
<tr>
<td>输入电压</td>