From 369924139e1689424de4f37240a9f88e92aa3695 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A1=A9=E5=85=A5=E5=AD=94=E7=AB=A0?= Date: Wed, 23 Jan 2019 11:32:06 +0800 Subject: [PATCH 1/2] add some docs-ja --- docs/ja/README.md | 4 +- docs/ja/app/bala.md | 2 +- docs/ja/base/m5go_base.md | 6 +-- docs/ja/core/m5go_lite.md | 85 +++++++++++++++++++++++++++++++++++++++ docs/ja/module/commu.md | 81 +++++++++++++++++++++++++++++++++---- docs/ja/module/usb.md | 58 +++++++++++++++++++++----- 6 files changed, 212 insertions(+), 24 deletions(-) create mode 100644 docs/ja/core/m5go_lite.md diff --git a/docs/ja/README.md b/docs/ja/README.md index dfccf7fa..5bcbdf17 100644 --- a/docs/ja/README.md +++ b/docs/ja/README.md @@ -16,7 +16,7 @@ **セット** -[![kit_m5go.png](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/core/kit_m5go_01.png)](ja/core/m5go_iot_starter_kit)         [![kit_faces.png](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/core/kit_faces_01.png)](ja/core/face_kit) +[![kit_m5go_lite.png](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/core/kit_m5go_lite_01.png)](ja/core/m5go_lite)         [![kit_m5go.png](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/core/kit_m5go_01.png)](ja/core/m5go_iot_starter_kit)         [![kit_faces.png](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/core/kit_faces_01.png)](ja/core/face_kit) @@ -42,7 +42,7 @@ **駆動モジュール** -[![stepmotor_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_stepmotor_01.png)](ja/module/stepmotor)         [![servo_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_servo_01.png)](ja/module/servo)         [![lego+_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_lego_plus_01.png)](ja/module/lego_plus) +[![stepmotor_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_stepmotor_01.png)](ja/module/stepmotor)         [![servo_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_servo_01.png)](ja/module/servo)         [![lego+_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_lego_plus_01.png)](ja/module/lego_plus)         [![module_usb.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_usb_01.png)](ja/module/usb) diff --git a/docs/ja/app/bala.md b/docs/ja/app/bala.md index fa282d6e..47ff8598 100644 --- a/docs/ja/app/bala.md +++ b/docs/ja/app/bala.md @@ -4,7 +4,7 @@ * * * -:memo:**[概要](#概要)**   :bulb:**[クイックスタート](/zh_CN/quick_start/bala/bala_quick_start)**   :octocat:**[サンプルコード](https://github.com/m5stack/M5Bala/tree/master/examples)**   🛒**[購入リンク](https://www.aliexpress.com/store/product/M5Satck-New-BALA-Car-ESP32-Development-Mini-Electric-Self-balancing-Car-2DC-Motor-with-Encoder-PSRAM/3226069_32904033658.html?spm=2114.12010615.8148356.40.1fd3724dW3O2Bu.html)** +:memo:**[概要](#概要)**   :bulb:**[クイックスタート](/ja/quick_start/bala/bala_quick_start)**   :octocat:**[サンプルコード](https://github.com/m5stack/M5Bala/tree/master/examples)**   🛒**[購入リンク](https://www.aliexpress.com/store/product/M5Satck-New-BALA-Car-ESP32-Development-Mini-Electric-Self-balancing-Car-2DC-Motor-with-Encoder-PSRAM/3226069_32904033658.html?spm=2114.12010615.8148356.40.1fd3724dW3O2Bu.html)** ## 概要 diff --git a/docs/ja/base/m5go_base.md b/docs/ja/base/m5go_base.md index 8b51e687..100b7577 100644 --- a/docs/ja/base/m5go_base.md +++ b/docs/ja/base/m5go_base.md @@ -1,10 +1,8 @@ # M5GO ベース - - ## 概要 -M5GOベースは、[M5GO IOT Starter Kit](zh_CN/product_documents/m5stack-core/m5go_iot_starter_kit)および[M5Fire](zh_CN/product_documents/m5stack-core/m5core_fire)キットのベースです +M5GOベースは、[M5GO IOT Starter Kit](ja/product_documents/m5stack-core/m5go_iot_starter_kit)および[M5Fire](ja/product_documents/m5stack-core/m5core_fire)キットのベースです M5GOベースは、600mAhバッテリ、Mバスバスインタフェース、マイク、赤色充電インジケータLED、2つのRGBストリップ（10）、PORT BおよびPORT Cで構成されています。 @@ -65,7 +63,7 @@ M5GOベースの充電処理中、赤いLEDが点滅し、バッテリが完全 ## 関連情報 - **[回路図](https://github.com/m5stack/M5GO/blob/master/hardware/schematics/M5GO_Base.pdf)** -- **[M5GO IOT Starter Kit リンクを購入する](https://www.aliexpress.com/store/product/M5Stack-Official-Stock-Offer-M5GO-IoT-Starter-Kit-ESP32-for-Arduino-MicroPython-Programming-Development-IR-MIC/3226069_32881911596.html?spm=2114.12010615.8148356.2.52385ab04i7vIu)** +- **[M5GO IOT Starter Kit リンクを購入する](https://www.aliexpress.com/store/product/M5Stack-Official-Stock-Offer-M5GO-IoT-Starter-Kit-ESP32-for-Arduino-MicroPython-Programming-Development-IR-MIC/3226069_32881911596.html)**
diff --git a/docs/ja/core/m5go_lite.md b/docs/ja/core/m5go_lite.md new file mode 100644 index 00000000..f28cdb77 --- /dev/null +++ b/docs/ja/core/m5go_lite.md @@ -0,0 +1,85 @@ +# M5GO Lite + +gray_02gray_04 + +* * * + +:memo:**[概要](#概要)**   :bulb:**[クイックスタート](ja/quick_start/m5core/m5stack_core_quick_start)**   :octocat:**[サンプルコード](#サンプルコード)**   :electric_plug:**[回路図](https://github.com/m5stack/M5-3D_and_PCB/blob/master/M5_Core_SCH%2820171206%29.pdf)**   🛒**[購入リンク](https://www.aliexpress.com/item/M5Stack-NEW-Lite-IoT-Development-Board-Kit-ESP32-MPU9250-Grove-16MFlash-DHT12-Temperature-Humidity-Sensor-Module/32965981279.html)**   :clapper:**[関連動画](#関連動画)** + +## 概要 + +**M5GO Lite**は**ENV unit**と**M5Core White**のコンパクトなキットです。[M5GO IOT Starter Kit](ja/core/m5go_iot_starter_kit)のシンプルなバージョンです。 + +M5GO Liteは[UiFlow](http://flow.m5stack.com)やArduino IDEを使用してプログラミングすることができます。 + +教育用のコースなども用意しています。興味がある方は、お気軽にこちらのメールアドレスへご連絡ください。 + +## 特徴 + +- サポートする開発環境 + - Arduino + - ESP-IDF + - MicroPython +- TF Card サポート(最大16GB) + +## パッケージ内容 + +- 1x M5Core(白) +- 1x M5GO Base +- 1x Units +- 1x GROVE ケーブル +- USB Type-C ケーブル +- ユーザーマニュアル + +gray_02gray_04 + +## 関連リンク + +- **データシート** + - [ESP32](https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf) + - [MPU9250](https://www.invensense.com/wp-content/uploads/2015/02/PS-MPU-9250A-01-v1.1.pdf) + +## サンプルコード + +以下はENVユニット向けのサンプルコードです。周囲の温度、湿度、気圧を計測します。事前準備として、`Adafruit BMP280 Library`をインストールする必要があります。Arduino IDEの`Preferences`->`追加のボードマネージャURL`に`https://adafruit.github.io/arduino-board-index/package_adafruit_index.json`を追記したのち、`スケッチ`->`ライブラリをインクルード`->`ライブラリを管理`->`Adafruit BMP280`と検索します。 + +*完全なソースコードは[こちら](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Core/m5go/m5go_lite/Arduino/ENV)* + +```arduino +/* + Install Adafruit BMP280 Library first. +*/ +#include +#include "DHT12.h" +#include //The DHT12 uses I2C comunication. +#include "Adafruit_Sensor.h" +#include + +// 宣言 +DHT12 dht12; +Adafruit_BMP280 bme; + +// 初期化 +M5.begin(); +Wire.begin(); +bme.begin(); + +// データ読み込み +float tmp = dht12.readTemperature(); +float hum = dht12.readHumidity(); +float pressure = bme.readPressure(); +``` + +**より多くのサンプルコードは[こちら](https://github.com/m5stack/M5Stack/tree/master/examples/Basics)** + +### 2. UIFlow + +*If you want the complete code, please click [here](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/ENV/UIFlow)。* + + + +## 関連動画 + +- **M5Stack紹介** + + \ No newline at end of file diff --git a/docs/ja/module/commu.md b/docs/ja/module/commu.md index c6327a64..c34dbf82 100644 --- a/docs/ja/module/commu.md +++ b/docs/ja/module/commu.md @@ -4,9 +4,7 @@ *** -:memo:**[概要](#概要)**      🛒**[購入リンク](https://www.aliexpress.com/store/product/M5Stack-New-COMMU-Module-Extend-RS485-TTL-CAN-I2C-Port-with-MCP2515-TJA1051-SP3485-Development-Board/3226069_32954475633.html?spm=a2g1y.12024536.productList_5885013.subject_2)** - - +:memo:**[概要](#概要)**      :octocat:**[サンプルコード](#サンプルコード)**      :electric_plug:**[回路図](#回路図)**      🛒**[購入リンク](https://www.aliexpress.com/store/product/M5Stack-New-COMMU-Module-Extend-RS485-TTL-CAN-I2C-Port-with-MCP2515-TJA1051-SP3485-Development-Board/3226069_32954475633.html)** ## 概要 @@ -48,12 +46,79 @@ - **データシート** - [MCP2515](http://ww1.microchip.com/downloads/en/devicedoc/20001801h.pdf) - [TJA1051](https://www.nxp.com/docs/en/data-sheet/TJA1051.pdf) - [SP3485](https://www.exar.com/ds/sp3485.pdf) - +#### CAN通信 - +COMMUでCAN通信を行うためのサンプルコードです。 - \ No newline at end of file +[MCP_CAN_lib file](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Module/COMMU/Arduino/DependentLibrary/MCP_CAN_lib)を`C:\Users\\Documents\Arduino\libraries`配下にコピーします。そして`commu_can_transmitter.ino`と`commu_can_receiver.ino`を2つのM5Coreにそれぞれ書き込みます。 + +*完全なソースコードは[こちら](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Module/COMMU/Arduino/CAN)* + +```arduino +/* + commu_can_transmitter.ino +*/ +#include +#include +#include "m5_logo.h" + +#define CAN0_INT 15 // Set INT to pin 2 +MCP_CAN CAN0(12); // Set CS to pin 10 + +// 宣言 +byte data[8] = {0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07}; + +// 初期化 +M5.begin(); +CAN0.begin(MCP_ANY, CAN_1000KBPS, MCP_8MHZ); +/* Change to normal mode to allow messages tobe transmitted */ +CAN0.setMode(MCP_NORMAL); + +// データ送信 +CAN0.sendMsgBuf(0x100, 0, 8, data); +``` + +```arduino +/* + commu_can_receiver.ino +*/ +#include +#include +#include "m5_logo.h" + +#define CAN0_INT 15 // Set INT to pin 2 +MCP_CAN CAN0(12); // Set CS to pin 10 + +// 宣言 +byte data[8] = {0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07}; + +// 初期化 +M5.begin(); +/* Initialize MCP2515 running at 16MHz with a baudrate of 500kb/s */ +/* and the masks and filters disabled. */ +CAN0.begin(MCP_ANY, CAN_1000KBPS, MCP_8MHZ); +/* Set operation mode to normal so theMCP2515 sends acks to received data. */ +CAN0.setMode(MCP_NORMAL); +pinMode(CAN0_INT, INPUT);// Configuring pin for /INT input + +// 受信データ読み込み +CAN0.readMsgBuf(&rxId, &len, rxBuf); +``` + + + +#### RS485通信 + +COMMUでRS485通信を行うためのサンプルコードです。 + +[example](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Module/COMMU/Arduino/RS485)を ２つのM5Coreにそれぞれ書き込みます。そしてAボタンを押すと、データの送受信が行われます。 + + + +# 回路図 + + diff --git a/docs/ja/module/usb.md b/docs/ja/module/usb.md index 34b7e4b7..8cf2ac89 100644 --- a/docs/ja/module/usb.md +++ b/docs/ja/module/usb.md @@ -4,9 +4,7 @@ *** -:memo:**[概要](#概要)**      🛒**[購入リンク](https://item.taobao.com/item.htm?spm=a1z10.3-c.w4002-1172588106.13.1dbd425eDUpt0Z&id=583599151180)** - - +:memo:**[概要](#概要)**      :octocat:**[サンプルコード](#サンプルコード)**      :electric_plug:**[回路図](#回路図)**      🛒**[購入リンク](https://www.aliexpress.com/item/M5Stack-New-USB-Module-USB-HOST-HID-with-MAX3421E-SPI-Interface-Output-5-Input-5-Compatible/32961627365.html)** ## 概要 @@ -33,14 +31,56 @@ - **[フォーラム](http://forum.m5stack.com/)** -- **データシート** - [MAX3421E](https://www.sparkfun.com/datasheets/DevTools/Arduino/MAX3421E.pdf) +- **データシート** + - [MAX3421E](https://www.sparkfun.com/datasheets/DevTools/Arduino/MAX3421E.pdf) - +`usb_mouse.ino`をM5Coreに書き込みます。USBマウスをモジュールに接続します。マウスの左ボタンを押して緑色の線を描き、右ボタンで白色の線を描きます。中央のボタンを押すと画面をクリアします。 - +```arduino +#include +#include +#include +#include +#include +#include +#include "M5Mouse.h" - +// new objects +USB Usb; +USBHub Hub(&Usb); +HIDBoot HidMouse(&Usb); +MouseRptParser Prs; + +// 初期化 +M5.begin(); +Usb.Init(); +HidMouse.SetReportParser(0,(HIDReportParser*)&Prs); + +// handle event coming from usb device +Usb.Task(); +if(Usb.getUsbTaskState() == USB_STATE_RUNNING) +{ + Mouse_Pointer(mou_px, mou_py); + mou_px = 0; + mou_py = 0; + /* left button pressed: draw white point */ + if (mou_button == 1) + M5.Lcd.drawCircle(StaPotX, StaPotY, 1, WHITE); + /* right button pressed: draw green point */ + if (mou_button == 2) + M5.Lcd.drawCircle(StaPotX, StaPotY, 1, GREEN); + /* middle button pressed: clear screen */ + if (mou_button == 4) + M5.Lcd.fillScreen(BLACK); +} +``` + + + +## 回路図 + + \ No newline at end of file From 9bd6ed70f7a4bf8af8db270d5be00cc6c5ddc65b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A1=A9=E5=85=A5=E5=AD=94=E7=AB=A0?= Date: Wed, 23 Jan 2019 11:38:22 +0800 Subject: [PATCH 2/2] fix bug --- docs/ja/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/README.md b/docs/ja/README.md index a5be3e79..f9551384 100644 --- a/docs/ja/README.md +++ b/docs/ja/README.md @@ -42,7 +42,7 @@ **駆動モジュール** -[![stepmotor_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_stepmotor_01.png)](ja/module/stepmotor)         [![servo_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_servo_01.png)](ja/module/servo)         [![lego+_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_lego_plus_01.png)](ja/module/lego_plus)         [![module_usb.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_usb_01.png)](ja/module/usb) +[![stepmotor_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_stepmotor_01.png)](ja/module/stepmotor)         [![servo_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_servo_01.png)](ja/module/servo)         [![lego+_01.jpg](http://m5-docs.oss-cn-shenzhen.aliyuncs.com/assets/img/product_pics/homepage_picture/module/module_lego_plus_01.png)](ja/module/lego_plus)