From b603ecc3c81ea18712148919c2a5ace50da25e04 Mon Sep 17 00:00:00 2001
From: vany5921 <908744431@qq.com>
Date: Thu, 9 Jul 2020 10:04:54 +0800
Subject: [PATCH] Create bala2_quick_start.md
---
.../en/quick_start/bala2/bala2_quick_start.md | 130 ++++++++++++++++++
1 file changed, 130 insertions(+)
create mode 100644 docs/en/quick_start/bala2/bala2_quick_start.md
diff --git a/docs/en/quick_start/bala2/bala2_quick_start.md b/docs/en/quick_start/bala2/bala2_quick_start.md
new file mode 100644
index 00000000..8892c4c8
--- /dev/null
+++ b/docs/en/quick_start/bala2/bala2_quick_start.md
@@ -0,0 +1,130 @@
+# BALA2 Quick Start {docsify-ignore-all}
+
+!>To program M5Bala2, you will need M5Stack Gray as main controller.
+
+
+
+## Prepare Install serial port driver
+
+### For Windows
+
+>Unzip the downloaded CP210X driver compression package, select the installation program corresponding to your operating system, and double-click to install.
+
+
+
+### For Mac
+
+>Unzip the downloaded CP210X driver compression package, install the program, and double-click the image file to start the installation.
+
+
+
+## Development Environment
+
+1. [UIFlow](#UIFlow)
+2. [Arduino IDE](#Arduino-IDE)
+
+## UIFlow
+
+1.
+
+
+
+1. Press the Red button on side of M5Core (double click for shutdown).
+
+
+
+1. Press the button on side of M5Bala bottom to power on (double click for shutdown).
+
+
+
+
+
+6. Open [UIFlow](http://flow.m5stack.com/) website, and switch programming language from `Blockly` to `Python`.
+
+
+
+7. Copy the following code to UIFlow and then click `Download`.
+
+```python
+from m5stack import *
+from m5ui import *
+from m5bala import M5Bala
+import i2c_bus
+clear_bg(0x111111)
+
+m5bala = M5Bala(i2c_bus.get(i2c_bus.M_BUS))
+btnA = M5Button(name="ButtonA", text="ButtonA", visibility=False)
+btnB = M5Button(name="ButtonB", text="ButtonB", visibility=False)
+btnC = M5Button(name="ButtonC", text="ButtonC", visibility=False)
+title0 = M5Title(title="Title", fgcolor=0xFFFFFF, bgcolor=0x0000FF)
+
+title0.setTitle('calirate start')
+wait(2)
+sampleCount = 2000
+gyroXSum = 0
+gyroYSum = 0
+gyroZSum = 0
+
+for _ in range(sampleCount):
+ gyroXYZ = m5bala.imu.gyro
+ gyroXSum += gyroXYZ[0] # X
+ gyroYSum += gyroXYZ[1] # Y
+ gyroZSum += gyroXYZ[2] # Z
+
+gyroXMean = gyroXSum / sampleCount
+gyroYMean = gyroYSum / sampleCount
+gyroZMean = gyroZSum / sampleCount
+
+m5bala.imu.setGyroOffsets(gyroXMean, gyroYMean, gyroZMean)
+
+title0.setTitle('balance start')
+while True:
+ m5bala.balance()
+ wait(0.001)
+```
+
+## Arduino IDE
+
+1. Setting Arduino development environment - [Establish Serail Connection](https://docs.m5stack.com/#/en/related_documents/establish_serial_connection) - [Get Started with Ardino IDE](https://docs.m5stack.com/#/en/quick_start/m5core/m5stack_core_quick_start)
+
+
+
+2. Install `m5stack` library in `Library Manager`.
+
+
+
+3. Install `NeoPixelBus` library in `Library Manager`.
+
+
+
+4. Install `MPU6050_tockn` library in `Library Manager`.
+
+
+
+5. Make sure that M5Core has connected to PC, then click `Tools` -> `Port` for selecting the corresponding serial port on Arduino IDE.
+
+6. click `Tools` -> `Board: ` to select `M5Stack-Core-ESP32` or `M5Stack-Fire`.
+
+
+
+7. Clone **[M5Bala](https://github.com/m5stack/M5Bala.git)** by shell command. *If you dont't have Git installed yet, click [here](https://git-scm.com/download/win) and install it.*
+
+```shell
+git clone --recursive https://github.com/m5stack/M5Bala.git
+```
+
+8. Click `Sketch` -> `Include Library` -> `Add .ZIP Library...` . select `M5Bala` you just cloned from github.
+
+
+
+
+
+9. Open a bala example: Click `File` -> `Examples` -> `M5Bala` -> `Basic`.
+
+
+
+10. Compile and upload.
+
+
+
+
\ No newline at end of file