diff --git a/docs/assets/img/getting_started_pics/how_to_burn_firmware/m5buner_com_bandrate_02.jpg b/docs/assets/img/getting_started_pics/how_to_burn_firmware/m5buner_com_bandrate_02.jpg deleted file mode 100644 index 52dd9acc..00000000 Binary files a/docs/assets/img/getting_started_pics/how_to_burn_firmware/m5buner_com_bandrate_02.jpg and /dev/null differ diff --git a/docs/assets/img/getting_started_pics/m5stickc/m5stickc_qs_mac_adn_config_01.png b/docs/assets/img/getting_started_pics/m5stickc/m5stickc_qs_mac_adn_config_01.png deleted file mode 100644 index d6e7d009..00000000 Binary files a/docs/assets/img/getting_started_pics/m5stickc/m5stickc_qs_mac_adn_config_01.png and /dev/null differ diff --git a/docs/en/module/lora.md b/docs/en/module/lora.md index 117fc6a4..a7a2d23f 100644 --- a/docs/en/module/lora.md +++ b/docs/en/module/lora.md @@ -60,7 +60,7 @@ LoRa and LoRaWAN permit long-range connectivity for Internet of Things (IoT) dev These are the point-to-point communication examples between two LORA modules. The LoRa nodes send and receive messages. -* Blue string indicates send succeed. +* Blue string indicates sending succeed. * Yellow string display the received messages. diff --git a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md index 7759e3d7..3fae61af 100644 --- a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md +++ b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md @@ -97,13 +97,13 @@ The serial device name is `tty.SLAB_USBtoUART` -#### (4) Search `ESP32` in the pop-up window, find it and click `Install` +#### (4) Search `ESP32` in `Boards Manager` window, find it and click `Install` ## 4. Install M5Stack Library -#### (1) Open Arduino IDE, then Select `Sketch`->`Include Library`->`Manage Libraries...` +#### (1) Open Arduino IDE, Select `Sketch`->`Include Library`->`Manage Libraries...` @@ -119,11 +119,11 @@ Make sure you have M5Core connected to your computer via USB #### (1) Select the correct board name and serial device name -Open Arduino IDE, select `Tools`->`Board`->`M5Stack-Core-ESP32` for your M5Core, `Tools` -> `Ports` for serial port +Choose the correct development `Board` and `Port`： `Tools`->`Board`->`M5Stack-Core-ESP32`, `Tools` -> `Ports` ->`tty.SLAB_USBtoUART` -#### (2) Then select an example +#### (2) Then choose an example `File`->`Examples`->`M5Stack`->`Basics` @@ -132,13 +132,13 @@ Choose the example named `HelloWorld`. #### (3) Upload it -Click `Upload`, to flash the code to the device. Once it's done, reset the M5Core, the screen on M5Core will display "Hello World!" +Click `Upload`, to flash the code to the device. Once it's done, reset the M5Core. It will display "Hello World!" on the screen. ## Note -Most version of MacOS have no problem detecting the serial device that connected to the computer, but might have truble on High Sierra. Sometimes `SLAB_USBtoUART` fail to appear. In this case, after connected the M5,open `security and privacy` in the `system preferences` and set it to `permit`. +Most version of MacOS have no problem detecting the serial device that connected to the computer, but it might have exceptions on High Sierra. Sometimes `SLAB_USBtoUART` fail to appear. In this case, after connected the M5,open `security and privacy` in the `system preferences` and set it to `permit`. @@ -151,8 +151,7 @@ Most version of MacOS have no problem detecting the serial device that connected ## 6. Related Video - Arduino video tutorial for M5. - Although This video is a little out of date, some webpage is not available, it still a good tutorial for beginners,and it shows the manual way of adding m5stack library and almost covered every step we have mentioned in the former steps. - + Although This video is a little out of date, some webpage is not available anymore. it's still a good tutorial for beginners,and it shows the manual way of adding m5stack library and almost covered every step we have mentioned above. diff --git a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md index 3bdece6a..4015c8b3 100644 --- a/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md +++ b/docs/en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows.md @@ -26,7 +26,7 @@ Open up your browser, and visit Arduino official website https://www.arduino.cc -#### (3) To install IDE, double click Arduino executable file. Keep the default selection throughout this process, including the installation path. +#### (3) To install IDE, double click the Arduino executable file. Keep the default selection throughout this process, including the installation path. @@ -42,9 +42,9 @@ Open up your browser, visit M5Stack official website https://m5stack.com/downloa #### (2) Based on your Windows operating system type, select the corresponding driver installation package -* 32-bit Windows operating system, choose `CP210xVCPInstaller_x86_vx.x.x.x.exe` +* 32-bit, choose `CP210xVCPInstaller_x86_vx.x.x.x.exe` -* 64-bit Windows operating system, choose `CP210xVCPInstaller_x64_vx.x.x.x.exe` +* 64-bit, choose `CP210xVCPInstaller_x64_vx.x.x.x.exe` @@ -56,9 +56,9 @@ Open up your browser, visit M5Stack official website https://m5stack.com/downloa #### (4) Check the serial port number `COMx` -Check the list of identified COM ports in the `Windows Device Manager`: +Check identified COM ports list in the `Windows Device Manager`: -Connect the Core to the computer via a USB Type-C cable, open `Windows Device Manager`, click `Ports(COM & LPT)` if you see this `SiLicon Labs CP210x USB to UART Bridge(COMx) ` , means the driver installation is succeed and your PC is allowed to communicate with M5. +Connect the M5Core to your computer via USB Type-C cable, open `Windows Device Manager`, click `Ports(COM & LPT)` if you see this `SiLicon Labs CP210x USB to UART Bridge(COMx) ` , means the driver installation succeed and your PC is allowed to communicate with M5. @@ -100,7 +100,7 @@ Connect the Core to the computer via a USB Type-C cable, open `Windows Device Ma ## 5. Example -Now that everything is ready to go, you can select a demo example from the `Example` list, before that let's do some configuration on the IDE. +Now that everything is ready to go, you can select a demo example from the `Example` list, before that, let's do some configuration on the IDE. Make sure you have M5Core connected to your computer via USB @@ -110,7 +110,7 @@ config your board name, baudrate, the specified serial port: M5Stack-Core-ESP32, -#### (2) Then select an example +#### (2) Then choose an example @@ -119,9 +119,9 @@ Click `Upload`, to flash the code to the device. -#### (4) New a M5Stack program +#### (4) Creat a new M5Stack program -Open Arduino IDE, create a `.ino` file, `File`->`New`. Click `Save`, name it my_test.ino, and save it somewhere. +Create a `.ino` file, `File`->`New`. Click `Save`, name it `my_test.ino`, and save it somewhere. Copy the code below to my_test.ino @@ -145,6 +145,6 @@ void loop() { } ``` -compile it and upload, the M5Stack screen will display "Hello World!" "M5Stack is running successfully!" +Compile and upload, the M5Stack screen will display "Hello World!" "M5Stack is running successfully!" \ No newline at end of file diff --git a/docs/en/quick_start/m5core/m5stack_core_get_started_MicroPython.md b/docs/en/quick_start/m5core/m5stack_core_get_started_MicroPython.md index d52f27e9..f21f52be 100644 --- a/docs/en/quick_start/m5core/m5stack_core_get_started_MicroPython.md +++ b/docs/en/quick_start/m5core/m5stack_core_get_started_MicroPython.md @@ -14,9 +14,9 @@ ## 1. Install USB to Serial Driver -Open up your browser, and visit the official website of M5Stack https://m5stack.com/download +Open up your browser, and visit M5Stack official website https://m5stack.com/download -### (1) Navigate to `Explore` `Download` `CP210X Driver` and based on your OS choose to download the installation package, unzip it then. +### (1) Navigate to `Explore` `Download` `CP210X Driver`. Based on your OS choose to download the installation package, unzip the package afterwards. @@ -24,7 +24,7 @@ Open up your browser, and visit the official website of M5Stack https://m5stack #### 1. For Mac -- After unzipped this package, double click the disk image `SiLabsUSBDriverDisk.dmg` for installation +- Double click the disk image `SiLabsUSBDriverDisk.dmg` for installation @@ -48,16 +48,16 @@ Open up your browser, and visit the official website of M5Stack https://m5stack - Check the serial port number `/dev/tty.SLAB_USBtoUART` -To make sure if the Driver has installed on your MAC: +To make sure if the Driver is installed on your MAC: -Open `Terminal`, connect `M5Core` with your MAC through USB Type-C cable, and type in the following command to view the available serial ports list. +Open `Terminal`, connect `M5Core` with your MAC through USB Type-C cable, and type in the command `ls .dev.tty*` to view the available serial ports list. -Disconnect M5Core device, and type in the same command on `Terminal` to see which port disappeared from the list. -That how we identify the name of the serial device. +Disconnect M5Core device, and type in the same command to see which port disappeared from the list. +That how we identify the name of the current serial port device. @@ -65,11 +65,11 @@ That how we identify the name of the serial device. -#### 2. +#### 2. For Windows - Based on your windows system, please choose: -* 32-bit Windows operating system `CP210xVCPInstaller_x86_vx.x.x.x.exe` + - 32-bit `CP210xVCPInstaller_x86_vx.x.x.x.exe` -* 64-bit Windows operating system `CP210xVCPInstaller_x64_vx.x.x.x.exe` + - 64-bit `CP210xVCPInstaller_x64_vx.x.x.x.exe` @@ -81,9 +81,9 @@ That how we identify the name of the serial device. - Check the serial port number `COMx` -Check the list of identified COM ports in the `Windows Device Manager`: +Check identified COM port list in the `Windows Device Manager`: -Connect the Core to the computer via a USB Type-C cable, open `Windows Device Manager`, click `Ports(COM & LPT)` if you see this `SiLicon Labs CP210x USB to UART Bridge(COMx) ` , means the driver installation is succeed and your PC is allowed to communicate with M5. +Connect the device to your computer via a USB Type-C cable, open `Windows Device Manager`, click `Ports(COM & LPT)` if you see this `SiLicon Labs CP210x USB to UART Bridge(COMx) ` , means the driver installation succeed and your PC is allowed to communicate with M5. @@ -99,44 +99,44 @@ Go to [M5Stack Official Website](http://www.m5stack.com/download), and download ### (2) Flash the firmware -- Connect M5Core to your computer via the USB Type-C cable, unzip the M5Burner pakage,here appears a folder, open the folder and double-click the executable `M5Burner.exe` +- Connect M5Core to your computer via the USB Type-C cable, unzip the M5Burner pakage. +- Here appears a folder, open it and double-click the executable `M5Burner.exe` -- Select the `serial number` and `921600 baud rate` that the board is connected to the computer, and select the latest version of UIFlow firmware. +- Select the `serial number` and `921600 baud rate` , and select the latest version of UIFlow firmware. - + - Download UIFlow firmware from the cloud. -- - -- Before Click `Burn` make sure you erase it first, and then make sure you choose the right firmware on the left list. + - +- Before Click `Burn` make sure you click erase first, and then make sure you choose the right firmware on the left list. + - Click `Burn` -- If you see the following message, means the firmware has flash onto your M5Core. +- If you see the following message, means you have the firmware flashed onto your M5Core. ## 3. Wi-Fi Setting -### (1) Press `SETUP` to enter the Wi-Fi config mode. +### (1) Enter the Wi-Fi config mode. -- Reboot the M5Core by press the red button on the side,the device will run the UIFlow firmware. -- Click `SETUP` right after the screen light up. Please be quick. -- In this page, navigate to `Link Server: Flow.m5stack.com` press the middle button to confirm. +- Reboot the M5Core by press the red button on the side, then the device will run the UIFlow firmware we just downloaded. +- Click `SETUP` right after the screen light up. Please be quick. If you miss it, repeat the process. +- In the `SETUP` page, choose `Link Server: Flow.m5stack.com` and press the middle button to confirm. ### (2) Connect to AP -- Now the device is in Wi-Fi AP mode, use your phone to connect this AP. The AP name would start with "M5Stack-". +- Now the device is in Wi-Fi AP mode, use your phone to connect this AP. The AP name would start with "M5Stack-". - After connected to the AP, your phone and the device has established a Wi-Fi connection. -- Open up a broswer on your phone and type in `192.168.4.1` in the address bar. Here you will enter the Wi-Fi Config page. -- Choose the local Wi-Fi and type in the password to tell the device use that Wi-Fi to get access to the internet. +- Then you will need to visit this address `192.168.4.1` on your phone browser. Here you will enter the Wi-Fi config page. +- Choose the local Wi-Fi (5G is not supported yet), type in the password. Then click `Configure`. By this way, you can tell the device to use the chosen Wi-Fi to get access to the internet. @@ -146,11 +146,11 @@ Go to [M5Stack Official Website](http://www.m5stack.com/download), and download -- The status of the small dot on the screen: +- The small dot(top right) on the screen indicates the connection status with UIFlow server: -* Green means connected to UIFlow cloud. + - Green: connected -* Red means disconnected to UIFlow cloud. + - Red : disconnected. ## 4. Program @@ -160,8 +160,9 @@ Go to [M5Stack Official Website](http://www.m5stack.com/download), and download -- At top right coner, navigate to `setting`,here you will need to type in the `APIKEY` displayed on the screen, choose your `Language` and `Device`(core). Click `OK`. -- The device will trying to connect with the UIFlow server. Once it connected, the small dot on the screen will turn green. +- At top right coner, navigate to `setting`, here you will need to type in the `APIKEY` displayed on the screen, choose your `Language` and `Device`(core). Click `OK`. +- Hold on untill the webpage shows "connected". +- Now that the device has established a connection with the UIFlow server. we can start programming @@ -190,6 +191,18 @@ Now you can start programming with UIFlow! *Source codee link: https://github.com/m5stack/M5-ProductExampleCodes/blob/master/Core/M5_draw_heart.m5f* +## Supplement + +> What gonna happen if you click `Download`?
+ You will have the current code downloading onto the device, it will reboot right away. Then, the device will enter "execute" mode back from the reboot. In this case, if you want to go back to program mode, you will need to press the power button to reboot the device and press button `A` right away. + + + +>How to switch to another Wi-Fi for the device? +- First, reboot the device, +- Right after the reboot, press button `Upload` to the left. +- You will see M5Core connecting the local Wi-Fi and going back to program mode. + #### c. Write a MicroPython program Copy the following code into the Python editing area, then click `Run` diff --git a/docs/en/quick_start/m5core/m5stack_core_quick_start.md b/docs/en/quick_start/m5core/m5stack_core_quick_start.md index 086bbcf2..99f4eecb 100644 --- a/docs/en/quick_start/m5core/m5stack_core_quick_start.md +++ b/docs/en/quick_start/m5core/m5stack_core_quick_start.md @@ -1,7 +1,7 @@ # M5Core Get Started {docsify-ignore-all} -**Choose your Developmet platform below for getting started** +**Choose the development platform** | | | | |:---:|:---:|:---:| -|[Arduino-MacOS](en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) | [Arduino-Windows](en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) | [UIFlow](en/quick_start/m5core/m5stack_core_get_started_MicroPython)| +|[Arduino-MacOS](en/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS) | [Arduino-Windows](en/quick_start/m5core/m5stack_core_get_started_Arduino_Windows) | [UIFlow (Blockly & Micropython)](en/quick_start/m5core/m5stack_core_get_started_MicroPython)| diff --git a/docs/en/quick_start/m5stick/m5stick_quick_start.md b/docs/en/quick_start/m5stick/m5stick_quick_start.md index 6197a7c8..84bf0a5c 100644 --- a/docs/en/quick_start/m5stick/m5stick_quick_start.md +++ b/docs/en/quick_start/m5stick/m5stick_quick_start.md @@ -1,6 +1,6 @@ # M5Stick Quick Start {docsify-ignore-all} -**Choose your development platform below for getting started** +**Choose the development platform** | | | | |:---:|:---:|:---:| diff --git a/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_MacOS.md b/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_MacOS.md index 5aa4095e..5751fc65 100644 --- a/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_MacOS.md +++ b/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_MacOS.md @@ -26,7 +26,7 @@ -Open up your browser, visit official website of Arduino https://www.arduino.cc/en/Main/Software +Open up your browser, visit Arduino official website https://www.arduino.cc/en/Main/Software #### (1) click `Mac OS X` to download `Arduino IDE` @@ -111,7 +111,7 @@ The serial port name is `tty.SLAB_USBtoUART` ## 4. Install M5Stack Library -#### (1) Open Arduino IDE, then Select `Sketch`->`Include Library`->`Manage Libraries...` +#### (1) Open Arduino IDE, Select `Sketch`->`Include Library`->`Manage Libraries...` @@ -127,15 +127,15 @@ The serial port name is `tty.SLAB_USBtoUART` ## 6. Example -Now that everything is ready to go, you can select a demo example from the `Example` list, before that let's do some configuration on the IDE. +Now that everything is ready to go, you can select a demo from the `Example` list, before that let's do some configuration on the IDE. Make sure you have M5Stick connected to your computer via USB -#### (1) Select the correct board name and serial device name +#### (1) Select the correct board and serial port name Start up Arduino IDE, and select `Tools -> Boards -> M5Stack-Core-ESP32` -select `Tools -> Ports ->` to set up the serial port. +choose the right port at `Tools -> Ports ->`. @@ -143,17 +143,17 @@ select `Tools -> Ports ->` to set up the serial port. Click `File-> Examples`. Here are some test demos in `M5Stack`->`Stick` -You can find a example name `FactoryTest` inside Basics. +We can try an example inside Basics, name `FactoryTest` . -Click `Upload`, to flash the code to the device. Once it's done, reset the device, the screen on M5Core will display "Hello World!" +Click `Upload`, to flash the code to the device. Once it's done, reset the device, The Screen will display "Hello World!" -**The button located on the bottom left is the power button, single-click to reboot. To enter deep sleep mode, double click this button** +**The button located on the bottom left is the power button, single-click to reboot. To enter deep sleep mode, double click** ## Note -Most version of MacOS have no problem detecting the serial device that connected to the computer, but might have truble on High Sierra. Sometimes `SLAB_USBtoUART` fail to appear. In this case, after connected the M5,open `security and privacy` in the `system preferences` and set it to `permit`. +Most version of MacOS have no problem detecting the serial device that connected to the computer, but might have exception on High Sierra. Sometimes `SLAB_USBtoUART` fail to appear. In this case, after connected the M5,open `security and privacy` in the `system preferences` and set it to `permit`. diff --git a/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_Windows.md b/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_Windows.md index c256d1c1..1688e387 100644 --- a/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_Windows.md +++ b/docs/en/quick_start/m5stick/m5stick_quick_start_with_arduino_Windows.md @@ -46,9 +46,9 @@ Open up your browser, and visit M5Stack official website https://m5stack.com/dow #### (2) Based on your Windows operating system type, select the corresponding driver installation package -* 32-bit Windows operating system, choose `CP210xVCPInstaller_x86_vx.x.x.x.exe` +* 32-bit `CP210xVCPInstaller_x86_vx.x.x.x.exe` -* 64-bit Windows operating system, choose `CP210xVCPInstaller_x64_vx.x.x.x.exe` +* 64-bit `CP210xVCPInstaller_x64_vx.x.x.x.exe` @@ -60,9 +60,9 @@ Open up your browser, and visit M5Stack official website https://m5stack.com/dow #### (4) Check the serial port number `COMx` -Check the list of identified COM ports in the `Windows Device Manager`: +Check identified COM port list in the `Windows Device Manager`: -Connect the Core to the computer via a USB Type-C cable, open `Windows Device Manager`, click `Ports(COM & LPT)` if you see this `SiLicon Labs CP210x USB to UART Bridge(COMx) ` , means the driver installation is succeed and your PC is allowed to communicate with M5. +Connect the Core to the computer via a USB Type-C cable, open `Windows Device Manager`, click `Ports(COM & LPT)` if you see this `SiLicon Labs CP210x USB to UART Bridge(COMx) `, means the driver installation succeed and your PC is allowed to communicate with M5. @@ -84,7 +84,7 @@ Connect the Core to the computer via a USB Type-C cable, open `Windows Device Ma -#### (4) Search `ESP32` in the pop-up window, find it and click `Install` +#### (4) Search `ESP32` at `Boards Manager` window, find it and click `Install` @@ -106,26 +106,26 @@ Connect the Core to the computer via a USB Type-C cable, open `Windows Device Ma ## 6. Example -Now that everything is ready to go, you can select a demo example from the `Example` list, before that let's do some configuration on the IDE. +Now that everything is ready to go, you can select a demo from the `Example` list, before that, let's do some configuration on the IDE. Make sure you have M5Stick connected to your computer via USB #### (1) Select the correct board name and serial device name -Start up Arduino IDE, and select `Tools -> Boards -> M5Stack-Core-ESP32` +Select `Tools -> Boards -> M5Stack-Core-ESP32` -select `Tools -> Ports ->` to set up the serial port. +Choose the right port number at `Tools -> Ports ->`. #### (2) Select an example -Click `File-> Examples`. Here are some test demos in `M5Stack`->`Stick` +Click `File-> Examples`. Here are some test demo in `M5Stack`->`Stick` -You can find a example name `FactoryTest` inside Basics. +Let's try an example inside Basics. Name `FactoryTest` -Click `Upload`, to flash the code to the device. Once it's done, reset the device, the screen on M5Core will display "Hello World!" +Click `Upload`, to flash the code to the device. Once it's done, reset the device, The screen will display "Hello World!" **The button located on the bottom left is the power button, single-click to reboot. To enter deep sleep mode, double click this button** diff --git a/docs/en/quick_start/m5stick/m5stick_quick_start_with_uiflow.md b/docs/en/quick_start/m5stick/m5stick_quick_start_with_uiflow.md index 2c1f312c..d622be1c 100644 --- a/docs/en/quick_start/m5stick/m5stick_quick_start_with_uiflow.md +++ b/docs/en/quick_start/m5stick/m5stick_quick_start_with_uiflow.md @@ -20,15 +20,15 @@ ## Update firmware ->Update the stick to the latest firmware version for a better experience. +> For a better developing experience, Please update your device to the newest firmware version. -*If you need to update or flash firmware, please click [here](en/related_documents/how_to_burn_firmware)* +*To update UIFlow firmware, please click [here](en/related_documents/how_to_burn_firmware)* ## Power on ->The button located on the bottom left is the power button, single-click to reboot. To enter deep sleep mode, double click this button +>The button located on the bottom left is the power button, single-click to reboot. To enter deep sleep mode, double click this button. >In addition to the power button, M5Stick also provides another button, Button`A`. @@ -38,23 +38,24 @@ ### Step1. Set up WIFI -- If you power on M5Stick for the very first time, it will enter the configuration page by default. And it's OLED screen will display an **AP name(SSID)** and **ap-setting address(192.168.4.1)**. +- If you got M5Stick for the very first time, once it powered on, by default, it will enter the configuration page. The LED screen will display an **AP name(SSID)** and a **webpage address(192.168.4.1)**. -- In this case, you can use your phone to connect AP. -- After connected, use a browser on your phone and type in 192.168.4.1 onto the address bar. -- Enter the WIFI configuration page, choose your local WIFI, and type in password, click `Save`, and hold on for the connection to be done. +- You will need to use your phone to connect that AP. +- Once it connected, you will need to visit this address (192.168.4.1) on your phone browser. +- Now that you have entered the WIFI configuration page, choose your local WIFI, and type in password, click `Save`, and hold on for the connection to be done. ## Step2. Setting API Key -- After connected with Wi-Fi, M5Stick will reset and enter the programming mode automatically. -- When the screen displays “Done”, which means that the device has connected to the internet. +- After connected with the local Wi-Fi(5G is not supported yet), M5Stick will reset and get into program mode automatically. +- When a display on the screen shows “Done”, means that the device has connected to the internet. - To get access to our WebIDE, please visit here [flow.m5stack.com](http://flow.m5stack.com/). -- On the webpage, top right, navigate to `Settings` ,type in the **API Key** displayed on the M5stick screen and click `Save`. +- On the webpage, top right, navigate to `Settings` ,type in the **API Key** on the screen and click `Save`. -- After it was connected to the UIFlow, we can start programming +- Hold on untill the webpage shows "connected". +- Now that the device has established a connection with the UIFlow server. we can start programming @@ -62,11 +63,15 @@ ## Supplement ->If clicked `Download`, the device will downloaded the latest code, and after reboot the device will enter "execute" mode. In this case, if you want to go back to program mode, you will need to press `A` button right after it reset. +> What gonna happen if you click `Download`?
+ You will have the current code downloading onto the device, it will reboot right away. Then, the device will enter "execute" mode back from the reboot. In this case, if you want to go back to program mode, you will need to press the power button to reboot the device and press button `A` right away. - + ->If you want to switchh to a new wifi for the device, you will need to reboot the device and press and hold `A` button for more than one second, and release once the stick screen sappears `UIFlow` logo. +>How to switch to another Wi-Fi for the device? +- First, reboot the device, +- Right after the reboot, press and hold button `A` for more than one second. +- Rrelease the button when `UIFlow` logo appears on the screen . ## Related Video diff --git a/docs/en/quick_start/m5stickc/m5stickc_quick_start.md b/docs/en/quick_start/m5stickc/m5stickc_quick_start.md index 4db5dedf..2767c28b 100644 --- a/docs/en/quick_start/m5stickc/m5stickc_quick_start.md +++ b/docs/en/quick_start/m5stickc/m5stickc_quick_start.md @@ -1,7 +1,7 @@ # M5StickC Quick Start {docsify-ignore-all} -**Pick up your programming mode below for getting started** +**Choose the development platform** -| | | -|:---:|:---:| -|[Arduino-Windows](en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_Windows) | [UIFlow](en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow)| +| | | | +|:---:|:---:|:---:| +|[Arduino-MacOS](en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_MacOS) | [Arduino-Windows](en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_Windows) | [UIFlow](en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow)| diff --git a/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_MacOS.md b/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_MacOS.md index d2f0ed98..9fffe509 100644 --- a/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_MacOS.md +++ b/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_MacOS.md @@ -6,7 +6,7 @@ - + ## Text Tutorial @@ -57,13 +57,13 @@ Open up your browser, and visit Arduino official website https://www.arduino.cc/ -#### (4) Search `ESP32` in the pop-up window, find it and click `Install` +#### (4) Search `ESP32` in `Boards Manager` window, find it and click `Install` ### Step3. Install M5StickC Lib -#### (1) Open Arduino IDE, then Select `Sketch`->`Include Library`->`Manage Libraries...` +#### (1) Open Arduino IDE, Select `Sketch`->`Include Library`->`Manage Libraries...` @@ -80,7 +80,7 @@ Make sure you have M5Core connected to your computer via USB #### (1) Select the correct board name and serial device name -Open Arduino IDE, select `Tools`->`Board`->`M5StickC` for your M5Core, `Tools` -> `Ports` for serial port +Open Arduino IDE, select `Tools`->`Board`->`M5StickC` , `Tools` -> `Ports`(choose the series port name) `Upload Speed`->`115200` @@ -89,17 +89,17 @@ Open Arduino IDE, select `Tools`->`Board`->`M5StickC` for your M5Core, `Tools` - Click `File-> Examples`. Here are some test demos in `M5Stack`->`Stick` -Let's open a example called `FactoryTest` inside Basics. +Let's open this example called `FactoryTest` inside Basics. - + -Click `Upload`, to flash the code to the device. Once it's done, reset the M5Core, the screen on M5Core will display "Hello World!" +Click `Upload`, to flash the code to the device. Once it's done, reset the M5Core, On M5Core screen will display "Hello World!" **The button located on the bottom left is the power button, single-click to reboot. To enter deep sleep mode, double click this button** ## Note -Most version of MacOS have no problem detecting the serial device that connected to the computer, but might have truble on High Sierra. Sometimes `SLAB_USBtoUART` fail to appear. In this case, after connected the M5,open `security and privacy` in the `system preferences` and set it to `permit`. +Most version of MacOS have no problem detecting the serial device that connected to the computer, but it might have exceptions on High Sierra. Sometimes `SLAB_USBtoUART` fail to appear. In this case, after connected the M5,open `security and privacy` in the `system preferences` and set it to `permit`. diff --git a/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_Windows.md b/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_Windows.md index 930c4e70..c960d12b 100644 --- a/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_Windows.md +++ b/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_arduino_Windows.md @@ -52,7 +52,7 @@ Open up your browser, and visit Arduino official website https://www.arduino.cc -#### (4) Search `ESP32` in the pop-up window, find it and click `Install` +#### (4) Search `ESP32` in `Boards Manager` window, find it and click `Install` @@ -68,7 +68,7 @@ Open up your browser, and visit Arduino official website https://www.arduino.cc ## 4. Example -Now that everything is ready to go, you can select a demo example from the `Example` list, before that let's do some configuration on the IDE. +Now that everything is ready to go, you can select a demo example from the `Example` list, before that, let's do some configuration on the IDE. Make sure you have M5StickC connected to your computer via USB @@ -78,13 +78,14 @@ config your board name, baudrate, the specified serial port: M5StickC, 115200, C -#### (2) Then select an example +#### (2) Choose an example #### (3) Upload it Click `Upload`, to flash the code to the device. + ## 5. Video Tutorial diff --git a/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow.md b/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow.md index c112fe9f..7f335ead 100644 --- a/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow.md +++ b/docs/en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow.md @@ -12,7 +12,7 @@ ### (1) Download M5Burner -Go to [M5Stack Official Website](http://www.m5stack.com/download), and download M5Burner +Go to [M5Stack](http://www.m5stack.com/download) Official Website , and download M5Burner Screenshot of coverpage @@ -20,26 +20,25 @@ Go to [M5Stack Official Website](http://www.m5stack.com/download), and download ### (2) Flash the firmware -- Connect M5StickC to your computer via the USB Type-C cable, unzip the M5Burner pakage,here appears a folder, open the folder and double-click the executable `M5Burner.exe` +- Connect M5StickC to your computer via the USB Type-C cable, unzip the M5Burner pakage +- Here appears a folder, open the folder and double-click the executable `M5Burner.exe` -- Select the `serial number` and `115200 baud rate` that the board is connected to the computer, and select the latest version of UIFlow firmware. +- Select the `COM` number and `Baudrate` (115200), and select the latest version of UIFlow firmware. - Download UIFlow firmware from the cloud. -- - + -- Before Click `Burn` make sure you erase it first, and then make sure you choose the right firmware on the left list. +- Before Click `Burn` make sure you click erase first, and then make sure you choose the right firmware on the left list. + - - Click `Burn` - -- If you see the following message, means the firmware has flash onto your M5Core. +- If you see the following message, means the firmware has downloaded onto your M5Core. @@ -47,9 +46,7 @@ Go to [M5Stack Official Website](http://www.m5stack.com/download), and download #### (1) Select `SETUP` -After flash the UIFlow firmware, press and hold the `Power` button (bottom left side)for 2 seconds until the screen light up. - -The screen will display the AP name as shown below. +After flash the UIFlow firmware, press and hold the `Power` button (bottom left side) for 2 seconds until the screen light up. @@ -58,15 +55,16 @@ The screen will display the AP name as shown below. - Now the device is in Wi-Fi AP mode, use your phone to connect this AP. The AP name would start with "M5-". - After connected to the AP, your phone and the device has established a Wi-Fi connection. -- Open up a broswer on your phone and type in `192.168.4.1` in the address bar. Here you will enter the Wi-Fi Config page. -- Choose the local Wi-Fi and type in the password to tell the device use that Wi-Fi to get access to the internet. +- Once it connected, you will need to visit this address (192.168.4.1) on your phone browser. Here you will enter the Wi-Fi config page. +- Choose the local Wi-Fi(5G is not supported yet), type in the password. Then click `Configure`. By this way, you can tell the device to use the chosen Wi-Fi to get access to the internet. #### (3) Connect to Wi-Fi -- After the M5Core connected to the internet, the device will restart and display the UIFlow version number, the `APIKEY` ,and a global icon for indication of connection status with UIFlow server. - +- After connected with the local Wi-Fi, M5StickC will reset and get into program mode automatically. +- When a display on the screen shows the UIFlow version number, the `APIKEY` ,and a global icon, which means that the device has connected to the internet. +- The global icon indicate the connection status with UIFlow server. * Green: Connected * Red : Disconnected @@ -80,13 +78,13 @@ The screen will display the AP name as shown below. -- At top right coner, navigate to `setting`,here you will need to type in the `APIKEY` displayed on the screen, choose your `Language` and `Device`(core). Click `OK`. +- At top right coner, navigate to `setting`,here you will need to type in the `APIKEY` which is displayed on the screen, choose your `Language` and `Device`(Stick-c). Click `OK`. -- The device will trying to connect with the UIFlow server. Once it connected, the small dot on the screen will turn green. +- The device will trying to connect with the UIFlow server. Once the connection has established , the globle icon on the screen will turn green. Now you can start programming with UIFlow! @@ -97,20 +95,20 @@ Now you can start programming with UIFlow! -- From `Event`, drag in `Event` into the programming area. and attach it underneath `Setup` +- From `Event`, drag in `Loop` into the programming area. and attach it underneath `Setup` -- From `Hardware` -> `LED`, drag in some blocks `LED ON` and `LED OFF` , place then inside `Loop` +- From `Hardware` -> `LED`, drag in some blocks, `LED ON` and `LED OFF`. place them inside `Loop` - From `Timer`, drag in block `Wait 1s` - hit `Run` + -**The Result:** - +- the LED on the device will blink at a 1Hz frequency.