diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/WebIDE_check_code.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/WebIDE_check_code.png index 202c78bb..215288d8 100644 Binary files a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/WebIDE_check_code.png and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/WebIDE_check_code.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/add_file.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/add_file.png new file mode 100644 index 00000000..6d87b65d Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/add_file.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/check_code_on_m5stack.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/check_code_on_m5stack.png new file mode 100644 index 00000000..b04f65b0 Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/check_code_on_m5stack.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/create_a_new_project.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/create_a_new_project.png new file mode 100644 index 00000000..af0560a1 Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/create_a_new_project.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/faces_py_file.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/faces_py_file.png new file mode 100644 index 00000000..6fa4ec70 Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/faces_py_file.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/final_result.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/final_result.png new file mode 100644 index 00000000..c345018b Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/final_result.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/new_a_faces_prj.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/new_a_faces_prj.png new file mode 100644 index 00000000..c505989c Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/new_a_faces_prj.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/register_page_m5cloud.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/register_page_m5cloud.png new file mode 100644 index 00000000..fa39c3ff Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/register_page_m5cloud.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/rename_file.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/rename_file.png new file mode 100644 index 00000000..a07fb929 Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/rename_file.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/result.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/result.png new file mode 100644 index 00000000..ba0fae4b Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/result.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/save_file.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/save_file.png new file mode 100644 index 00000000..a1594fe0 Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/save_file.png differ diff --git a/docs/assets/img/getting_started_pics/get_started_with_m5cloud/upload_it.png b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/upload_it.png new file mode 100644 index 00000000..17d9e72f Binary files /dev/null and b/docs/assets/img/getting_started_pics/get_started_with_m5cloud/upload_it.png differ diff --git a/docs/assets/img/product_pics/core/fire/m5_fire_04.jpg b/docs/assets/img/product_pics/core/fire/m5_fire_04.jpg index fdf6876a..b4821a2d 100644 Binary files a/docs/assets/img/product_pics/core/fire/m5_fire_04.jpg and b/docs/assets/img/product_pics/core/fire/m5_fire_04.jpg differ diff --git a/docs/assets/img/product_pics/core/m5go/m5go_01.png b/docs/assets/img/product_pics/core/m5go/m5go_01.png new file mode 100644 index 00000000..13e40e34 Binary files /dev/null and b/docs/assets/img/product_pics/core/m5go/m5go_01.png differ diff --git a/docs/assets/img/product_pics/core/m5go/m5go_02.jpg b/docs/assets/img/product_pics/core/m5go/m5go_02.jpg new file mode 100644 index 00000000..98ffa719 Binary files /dev/null and b/docs/assets/img/product_pics/core/m5go/m5go_02.jpg differ diff --git a/docs/assets/img/product_pics/core/m5go/m5go_03.jpg b/docs/assets/img/product_pics/core/m5go/m5go_03.jpg new file mode 100644 index 00000000..3b1ba647 Binary files /dev/null and b/docs/assets/img/product_pics/core/m5go/m5go_03.jpg differ diff --git a/docs/assets/img/product_pics/core/m5go/m5go_04.jpg b/docs/assets/img/product_pics/core/m5go/m5go_04.jpg new file mode 100644 index 00000000..876dc47d Binary files /dev/null and b/docs/assets/img/product_pics/core/m5go/m5go_04.jpg differ diff --git a/docs/assets/img/product_pics/core/m5go/m5go_05.jpg b/docs/assets/img/product_pics/core/m5go/m5go_05.jpg new file mode 100644 index 00000000..514d5b67 Binary files /dev/null and b/docs/assets/img/product_pics/core/m5go/m5go_05.jpg differ diff --git a/docs/assets/img/product_pics/core/m5go/m5go_06.png b/docs/assets/img/product_pics/core/m5go/m5go_06.png new file mode 100644 index 00000000..30c00dba Binary files /dev/null and b/docs/assets/img/product_pics/core/m5go/m5go_06.png differ diff --git a/docs/assets/img/product_pics/core/m5go/m5go_01.jpg b/docs/assets/img/product_pics/core/m5go/m5go_main_board.jpg similarity index 100% rename from docs/assets/img/product_pics/core/m5go/m5go_01.jpg rename to docs/assets/img/product_pics/core/m5go/m5go_main_board.jpg diff --git a/docs/assets/img/related_documents/how_to_connect_wifi_with_m5cloud/check_code_on_m5stack.png b/docs/assets/img/related_documents/how_to_connect_wifi_with_m5cloud/check_code_on_m5stack.png new file mode 100644 index 00000000..b04f65b0 Binary files /dev/null and b/docs/assets/img/related_documents/how_to_connect_wifi_with_m5cloud/check_code_on_m5stack.png differ diff --git a/docs/assets/img/related_documents/how_to_connect_wifi_with_m5cloud/connected_wifi_m5cloud_been_bound.png b/docs/assets/img/related_documents/how_to_connect_wifi_with_m5cloud/connected_wifi_m5cloud_been_bound.png new file mode 100644 index 00000000..ffadfb12 Binary files /dev/null and b/docs/assets/img/related_documents/how_to_connect_wifi_with_m5cloud/connected_wifi_m5cloud_been_bound.png differ diff --git a/docs/en/product_documents.md b/docs/en/product_documents.md index e8287d96..51976898 100644 --- a/docs/en/product_documents.md +++ b/docs/en/product_documents.md @@ -10,9 +10,11 @@ | :----------: |:------------: | | [BASIC](/en/product_documents/m5stack-core/m5core_basic) | [Stick](/en/product_documents/m5stack-core/minicore_stick) | | [GRAY](/en/product_documents/m5stack-core/m5core_gray) | / | +| [WHITE(M5GO Main Board)](/en/product_documents/m5stack-core/m5core_white) | / | | [FIRE](/en/product_documents/m5stack-core/m5core_fire) | / | | [M5GO IOT Kit](/en/product_documents/m5stack-core/m5go_iot_starter_kit) | / | + | Wireless Modules | Accessory Modules | Controlling Modules | diff --git a/docs/en/product_documents/bases/face_base.md b/docs/en/product_documents/bases/face_base.md index 6a5e32f2..9b4bd436 100644 --- a/docs/en/product_documents/bases/face_base.md +++ b/docs/en/product_documents/bases/face_base.md @@ -50,9 +50,13 @@ FACE Kit can be pocket computer because a Battery(650mAh) has been built in the ## DOCUMENTS -- **Example** - [Arduino](https://github.com/m5stack/M5Stack/tree/master/examples/Modules/FACES) - [MicroPython](https://github.com/m5stack/M5Cloud/tree/master/examples/FACES) +- **Example** + - [Arduino](https://github.com/m5stack/M5Stack/tree/master/examples/Modules/FACES) + - [MicroPython](https://github.com/m5stack/M5Cloud/tree/master/examples/FACES) -- **[Quick Start](en/file_to_display_null)** for M5Cloud +- **Quick Start** + - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) + - [MicroPython(M5Cloud)](en/quick_start/m5core/m5stack_core_get_started_MicroPython_m5cloud) - **[Purchase](https://www.aliexpress.com/store/product/M5Stack-NEW-Offer-ESP32-Open-Source-Faces-Pocket-Computer-with-Keyboard-Gameboy-Calculator-for-Micropython-Arduino/3226069_32843973578.html?spm=2114.12010615.8148356.8.25e96be7Jd99Pb.html)** diff --git a/docs/en/product_documents/m5stack-core/m5core_basic.md b/docs/en/product_documents/m5stack-core/m5core_basic.md index 6f49261b..8de22800 100644 --- a/docs/en/product_documents/m5stack-core/m5core_basic.md +++ b/docs/en/product_documents/m5stack-core/m5core_basic.md @@ -2,7 +2,7 @@ ## DESCRIPTION -The M5Stack **BASIC** is a black development kit based on ESP32 chip composed of a black M5Core and a Bottom Base board. You can even program The M5Stack BASIC through Blockly, Arduino or MicroPython. The black core is a basic kit and it does not own any MEMS chip(like MPU9250, MPU6050, or MAG3110...). +The M5Stack **BASIC** is a black development kit based on ESP32 chip composed of a black M5Core and a Bottom Base board. You can even program The M5Stack BASIC through Blockly, Arduino or MicroPython. The black core is a basic kit and **it does not own any MEMS chip(like MPU9250, MPU6050, or MAG3110...)**. The a Bottom board on the back of M5Core. It's designed for expanding gpio on M-Bus besides I2S Pins(GPIO0, GPIO12, GPIO13, GPIO15, GPIO34)for DIY. Each gpio on M-Bus is expanded as pin and port for convenience and flexibility. @@ -99,24 +99,26 @@ The a Bottom board on the back of M5Core. It's designed for expanding gpio on M- - **GitHub** - [Arduino GitHub](https://github.com/m5stack/M5Stack) -- **Quick Start** - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython) +- **Quick Start** + - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) + - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython)
- basic_01 + basic_01
- basic_02 + basic_02
- basic_03 + basic_03
- basic_04 + basic_04
- basic_05 + basic_05
- basic_05 + basic_05
\ No newline at end of file diff --git a/docs/en/product_documents/m5stack-core/m5core_fire.md b/docs/en/product_documents/m5stack-core/m5core_fire.md index ad88d168..00ef2e1b 100644 --- a/docs/en/product_documents/m5stack-core/m5core_fire.md +++ b/docs/en/product_documents/m5stack-core/m5core_fire.md @@ -149,7 +149,9 @@ M5Go CHG. Base is composed of POGO pin. M5Go Base is composed of PORT B, PORT C, ## DOCUMENTS -- **Example** - [Arduino](https://github.com/m5stack/M5Stack/tree/master/examples) - [MicroPython](https://github.com/m5stack/M5GO/tree/master/examples) +- **Example** + - [Arduino](https://github.com/m5stack/M5Stack/tree/master/examples) + - [MicroPython](https://github.com/m5stack/M5GO/tree/master/examples) - **Datasheet** - [ESP32](https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf) - [MPU6050](https://www.invensense.com/wp-content/uploads/2015/02/MPU-6000-Datasheet1.pdf) - [MAG3110](https://www.nxp.com/docs/en/data-sheet/MAG3110.pdf) @@ -157,14 +159,16 @@ M5Go CHG. Base is composed of POGO pin. M5Go Base is composed of PORT B, PORT C, - **[Purchase](https://www.aliexpress.com/store/product/M5Stack-NEW-PSRAM-2-0-FIRE-IoT-Kit-Dual-Core-ESP32-16M-FLash-4M-PSRAM-Development/3226069_32847906756.html?spm=2114.12010615.8148356.10.1c93724d7cJ5rG.html)** -- **Quick Start** - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython) +- **Quick Start** + - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) + - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython) ## READ MORE ### Diagram of Fire
- +
@@ -176,5 +180,5 @@ M5Go CHG. Base is composed of POGO pin. M5Go Base is composed of PORT B, PORT C,
- +
\ No newline at end of file diff --git a/docs/en/product_documents/m5stack-core/m5core_gray.md b/docs/en/product_documents/m5stack-core/m5core_gray.md index 730f104c..a6e9c94d 100644 --- a/docs/en/product_documents/m5stack-core/m5core_gray.md +++ b/docs/en/product_documents/m5stack-core/m5core_gray.md @@ -1,10 +1,10 @@ -# M5Stack GRAY +# M5Core GRAY ## DESCRIPTION -The M5Stack **GRAY** is a development kit based on ESP32 chip composed of a gray M5Core and a Bottom Base board. You can even program The M5Stack GRAY through Blockly, Arduino or MicroPython. +The M5Core **GRAY** is a development kit based on ESP32 chip composed of a gray M5Core and a Bottom Base board. You can even program The M5Core GRAY through Blockly, Arduino or MicroPython. -The M5Stack GRAY equips the ESP32 with everything necessary to program, run and develop on the wonderchip. It also features a MEMS Chip(**MPU9250**), and a TFT LCD, so you can create a 3D remote gesture controller, a simple "Leap Motion" via M5Stack GRAY in a day in stead of couple weeks and so on. +The M5Core GRAY equips the ESP32 with everything necessary to program, run and develop on the wonderchip. It also features a MEMS Chip(**MPU9250**), and a TFT LCD, so you can create a 3D remote gesture controller, a simple "Leap Motion" via M5Core GRAY in a day in stead of couple weeks and so on. The a Bottom board on the back of M5Core. It's designed for expanding gpio on M-Bus besides I2S Pins(GPIO0, GPIO12, GPIO13, GPIO15, GPIO34)for DIY. Each gpio on M-Bus is expanded as pin and port for convenience and flexibility. @@ -92,8 +92,8 @@ The a Bottom board on the back of M5Core. It's designed for expanding gpio on M- ## INCLUDES -- 1x M5Stack GRAY -- 1x M5Stack Core Bottom +- 1x M5Core GRAY +- 1x M5Core Bottom - Type-C USB Cable - User Manual @@ -110,24 +110,26 @@ The a Bottom board on the back of M5Core. It's designed for expanding gpio on M- - **[Purchase](https://www.aliexpress.com/store/product/M5Stack-Official-In-Stock-ESP32-Mpu9250-9Axies-Motion-Sensor-Core-Development-Kit-Extensible-IoT-Development-Board/3226069_32836393710.html?spm=2114.12010615.8148356.12.25e96be7zRik8r.html)** -- **Quick Start** - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython) +- **Quick Start** + - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) + - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython)
- gray_01 + gray_01
- gray_02 + gray_02
- gray_03 + gray_03
- gray_04 + gray_04
- gray_05 + gray_05
- basic_05 + basic_05
\ No newline at end of file diff --git a/docs/en/product_documents/m5stack-core/m5core_white.md b/docs/en/product_documents/m5stack-core/m5core_white.md new file mode 100644 index 00000000..42a23971 --- /dev/null +++ b/docs/en/product_documents/m5stack-core/m5core_white.md @@ -0,0 +1,158 @@ +# M5Core WHITE + +## DESCRIPTION + +**The White M5Core is a main board of M5GO IOT Starter Kit.** The White M5Core is similar with M5Core GRAY. But it's bottom module is M5GO Base, not the same as M5Core GRAY. + +It equips the ESP32 with everything necessary to program, run and develop on the wonderchip. It also features a MEMS Chip(**MPU9250**), and a TFT LCD, so you can create a 3D remote gesture controller, a simple "Leap Motion" via M5Stack GRAY in a day in stead of couple weeks and so on. + +The a Bottom board on the back of M5Core. It's designed for expanding gpio on M-Bus besides I2S Pins(GPIO0, GPIO12, GPIO13, GPIO15, GPIO34)for DIY. Each gpio on M-Bus is expanded as pin and port for convenience and flexibility. + +## FEATURES + +- Programming Support + - M5Flow + - MicroPython + - Arduino +- Compatible LEGO +- TF Card Support + +## PARAMETER + +| Source | Parameter | +| :----------: |:------------: | +| ESP32 | 240MHz dual core, 600 DMIPS, 520K, Wi-Fi, dual mode Bluetooth | +| Flash) | 4M-Bytes | +| Input | 5V @ 500mA | +| Interface | TypeC x 1, GROVE(I2C+I/0+UART) x 1 | +| LCD | 2 inch, 320x240 Colorful TFT LCD, ILI9342 | +| Speaker | 1W-0928 | +| **MEMS** | MPU9250 | +| Battery | 150mAh @ 3.7V, inside vb | +| Op.Temp. | 32°F to 104°F ( 0°C to 40°C ) | +| Size | 54 x 54 x 12.5 mm | +| C.A.S.E | Plastic ( PC ) | +| Weight | 120g with bottom, 100g only core | + +## PinMap + +**POGO Pin** + +| POGO Pin | ESP32 Chip | +| :----------: |:------------: | +| SCL | GPIO22 | +| SDA | GPIO21 | + +**LED Bar** + +| LED Pin | ESP32 Chip | +| :----------: |:------------: | +| LED Pin | GPIO15 | + +**MIC** + +| MIC Pin | ESP32 Chip | +| :----------: |:------------: | +| MIC Pin | GPIO34 | + +**Speak** + +| Speak Pin | ESP32 Chip | +| :----------: |:------------: | +| Speak Pin | GPIO25 | + +**Button** + +| Button Pin | ESP32 Chip | +| :----------: |:------------: | +| BUTTON A | GPIO39 | +| BUTTON B | GPIO38 | +| BUTTON C | GPIO37 | + +**GROVE** + +| PORT A(I2C) | ESP32 Chip | +| :----------: |:------------: | +| SCL | GPIO22 | +| SDA | GPIO21 | +| 5V | 5V | +| GND | GND | + +| PORT B(I/O) | ESP32 Chip | +| :----------: |:------------: | +| G36 | GPIO36 | +| G26 | GPIO26 | +| 5V | 5V | +| GND | GND | + +| PORT C(UART2) | ESP32 Chip | +| :----------: |:------------: | +| RXD | GPIO16 | +| TXD | GPIO17 | +| 5V | 5V | +| GND | GND | + +**MEMS Chip** + +*MPU9250 i2c address: 0x68* + +| MPU9250 | ESP32 Chip | +| :----------: |:------------: | +| SCL | GPIO22 | +| SDA | GPIO21 | +| 5V | 5V | +| GND | GND | + +**LCD** + +| ILI9341 | ESP32 Chip | +| :----------: |:------------: | +| MOSI | GPIO23 | +| MISO | / | +| CLK | GPIO18 | +| CS | GPIO14 | +| DC | GPIO27 | +| RST | GPIO33 | +| BL | GPIO32 | + +**TF Card** + +| TFCard Pin | ESP32 Chip | +| :----------: |:------------: | +| MOSI | GPIO23 | +| MISO | GPIO19 | +| CLK | GPIO18 | +| CS | GPIO4 | + +**M-Bus** + +*Please refer to the last picture* + +## INCLUDES + +- 1x M5Core WHITE +- 1x M5GO Base +- 1x M5GO CHG BASE +- Type-C USB Cable +- User Manual + +## DOCUMENTS + +- **Example** - [Arduino](https://github.com/m5stack/M5Stack/tree/master/examples) - [MicroPython](https://github.com/m5stack/M5GO/tree/master/examples) + +- **GitHub** - [Arduino](https://github.com/m5stack/M5Stack) - [MicroPython](https://github.com/m5stack/M5GO) + +- **[Purchase](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.6.44fa2da3D2i5Yi)** + +- **Quick Start** + - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) + - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython) + +
+ +
+ +
+ basic_05 +
+ \ No newline at end of file diff --git a/docs/en/product_documents/m5stack-core/m5go_iot_starter_kit.md b/docs/en/product_documents/m5stack-core/m5go_iot_starter_kit.md index 73c1d9dd..9a2ea320 100644 --- a/docs/en/product_documents/m5stack-core/m5go_iot_starter_kit.md +++ b/docs/en/product_documents/m5stack-core/m5go_iot_starter_kit.md @@ -139,18 +139,42 @@ We also supply some courses for teaching IOT programming. If you are interesting ## DOCUMENTS -- **Example** - [Arduino](https://github.com/m5stack/M5Stack/tree/master/examples) - [MicroPython](https://github.com/m5stack/M5GO/tree/master/examples) +- **Example** + - [Arduino](https://github.com/m5stack/M5Stack/tree/master/examples) + - [MicroPython](https://github.com/m5stack/M5GO/tree/master/examples) - **GitHub** - [Arduino](https://github.com/m5stack/M5Stack) - [MicroPython](https://github.com/m5stack/M5GO) - **[Purchase](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.6.44fa2da3D2i5Yi)** -- **Quick Start** - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython) +- **Quick Start** + - Arduino - [MacOS](/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) - [Windows_64](/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) + - [MicroPython](/en/quick_start/m5core/m5stack_core_get_started_MicroPython)
- +
- basic_05 + +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ basic_05
\ No newline at end of file diff --git a/docs/en/product_documents/m5stack-core/minicore_stick.md b/docs/en/product_documents/m5stack-core/minicore_stick.md index a89a5937..a1f9a686 100644 --- a/docs/en/product_documents/m5stack-core/minicore_stick.md +++ b/docs/en/product_documents/m5stack-core/minicore_stick.md @@ -64,13 +64,13 @@ MPU9250 Version: - **Quick Start** - Arduino
- +
- +
- +
\ No newline at end of file diff --git a/docs/en/quick_start/m5core/m5stack_core_get_started_MicroPython_m5cloud.md b/docs/en/quick_start/m5core/m5stack_core_get_started_MicroPython_m5cloud.md new file mode 100644 index 00000000..46b1794e --- /dev/null +++ b/docs/en/quick_start/m5core/m5stack_core_get_started_MicroPython_m5cloud.md @@ -0,0 +1,154 @@ +# M5Cloud Quick Start(MicroPython) + +?> **Note** *If it's first time to use M5Core or you want to change the networkable AP that means the Core can't access [http://cloud.m5stack.com](http://cloud.m5stack.com), you need visit this article for setting wifi [How to connect wifi using Core with M5Cloud](/en/related_documents/how_to_connect_wifi_using_core_with_m5cloud).* + +*By default, we consider your M5Core has been connected with the networkable AP successfully. And the screen shows like this figure below.* + +
+ +
+ +## CONTENT + +1. [Connect to M5Cloud](#connect-to-m5cloud) + +2. [Binding device](#binding-device) + +3. [Program with Core](#program-with-Core) + + +## 1. Connect to M5Cloud + +Now If you want to program the M5 from your computer, enter the url shown at the top of the screen `cloud.m5stack.com` + +It will show as following figure. + +
+ +
+ +Now, register a account. + +## 2. Binding device + +Press `Device`->`Add` buttom on M5Cloud IDE for binding M5Stack board to your account.(Now, my check code is `052879`) + +
+ +
+ +
+ +
+ +At the moment, you can program it through Python as shown below. + +## 2. Program with Core + +### a. New a Project + +
+ +
+ +### a. Code it + +*Now, let's get started with FACES Kit.* + +After creating a new project, add a file named `faces.py` as a python module. + +
+ +
+ +
+ +
+ +Then copy following code into faces.py and main.py, and save they. + +```Python +""" +File name: faces.py + +M5Stack MicroPython FACES keyboard I2C driver +""" + +class Faces: + def __init__(self, i2c=None): + if i2c == None: + from machine import I2C, Pin + self.i2c = I2C(sda=21, scl=22) + else: + self.i2c = i2c + self.addr = 0x08 + self.cb = None + + def read(self): + return self.i2c.readfrom(self.addr, 1) + + def _callback(self, pin): + from machine import Pin + if pin == Pin(5): + self.cb(self.read()) + + def callback(self, cb): + from machine import Pin + self.pin = Pin(5) + self.pin.init(Pin.IN) + self.pin.irq(trigger=Pin.IRQ_FALLING, handler=self._callback) + self.cb = cb +``` + +
+ +
+ + +```Python +""" +File name: main.py +""" + +from m5stack import * +from faces import Faces + +keyboard = Faces() + +# read once +print("Key value:", end='') +print(keyboard.read()) + +# callback +def keyboard_cb(value): + print("Key value:", end='') + print(value) + lcd.print(value) + +keyboard.callback(keyboard_cb) +``` + +
+ +
+ +
+ +
+ + +Now, upload and run it! + +
+ +
+ +## Complete + +The function of This demostration is that screen and serial terminal will display the value of the key you pressed. + +Now, I press the first line of QWERTY Keyboard. ("q", "w", "e", "r", "t", "y", "u", "i", "o", "p") + +
+ +
\ No newline at end of file diff --git a/docs/en/related_documents/how_to_connect_wifi_using_core_with_m5cloud.md b/docs/en/related_documents/how_to_connect_wifi_using_core_with_m5cloud.md index 96367b34..325c875a 100644 --- a/docs/en/related_documents/how_to_connect_wifi_using_core_with_m5cloud.md +++ b/docs/en/related_documents/how_to_connect_wifi_using_core_with_m5cloud.md @@ -24,8 +24,6 @@ **Then open brower to login 192.168.4.1 for setting your networkable WIFI name and password. (Now, my networkable wifi is named `MasterHax_5G`)** -?> **Note** If you connect wifi unsuccessfully, repeat it again please. -
@@ -34,12 +32,19 @@ +?> **Note** If you connect wifi unsuccessfully, repeat it again please. + ## 3. Reset Your Device **After connected wifi successfully, reset your core according to the prompt on `192.168.4.1`**
- + +
+ +?> **Note** If your device has been bound to M5Cloud's account before(means you have entered the check code on [M5Cloud](http://cloud.m5stack.com)), the screen will display as below +
+
## Complete