ULTRA_SONIC、Vibrator、MAKEY

Author: TinyuZhao

examples/Unit/MAKEY/MAKEY.ino

@@ -1,8 +1,19 @@
 /*
-    Description: Use MAKEY Unit to control M5Core to emit tones.
+*******************************************************************************
+* Copyright (c) 2021 by M5Stack
+*                  Equipped with M5Core sample source code
+*                          配套  M5Core 示例源代码
+* Visit the website for more information：https://docs.m5stack.com/en/core/gray
+* 获取更多资料请访问：https://docs.m5stack.com/zh_CN/core/gray
+*
+* describe: MAKEY.
+* date：2021/8/19
+*******************************************************************************
+  Please connect to Port A(22、21),Connect port G on the MAKEY Unit to other ports (except 5V) to control the tone it emits
+  请连接端口A(22、21),将MAKEY Unit上的G口与其他口连接(除5V外)控制其发出音调
 */
+
 #include <M5Stack.h>
-#include <Wire.h>
 
 #define NOTE_D1 294
 
@@ -15,18 +26,13 @@
 #define NOTE_DL7 494
 
 void setup() {
-  // Power ON Stabilizing...
-  delay(500);
-  M5.begin();
-  M5.Power.begin();
-  pinMode(39, INPUT);
-  pinMode(38, INPUT);
-  // Init I2C
-  Wire.begin();
-  M5.Lcd.setTextSize(2);
-  M5.Lcd.setTextColor(WHITE, BLACK);
+  M5.begin(); //Init M5Stack.  初始化M5Stack
+  M5.Power.begin(); //Init power  初始化电源模块
+  M5.lcd.setTextSize(2);  //Set the text size to 2.  设置文字大小为2
   M5.Lcd.println("M5Stack Makey Piano.");
+  Wire.begin(); //Wire init, adding the I2C bus.  Wire初始化, 加入i2c总线
 }
+
 int Key1 = 0, Key2 = 0, Index = 0;
 void showKey() {
 

examples/Unit/ULTRA_SONIC/ULTRA_SONIC.ino

@@ -1,59 +1,48 @@
 /*
-    Description: Display the distance measured by ultrasonic
+*******************************************************************************
+* Copyright (c) 2021 by M5Stack
+*                  Equipped with M5Core sample source code
+*                          配套  M5Core 示例源代码
+* Visit the website for more information：https://docs.m5stack.com/en/core/gray
+* 获取更多资料请访问：https://docs.m5stack.com/zh_CN/core/gray
+*
+* describe: Ultrasonic.  超声波测距传感器
+* date：2021/8/19
+*******************************************************************************
+  Please connect to Port A,Display the distance measured by ultrasonic
+  请连接端口A,显示超声波测量的距离
 */
 
 #include <M5Stack.h>
 
-TFT_eSprite Terminalbuff = TFT_eSprite(&M5.Lcd);
-
 void setup() {
-  // put your setup code here, to run once:
-    M5.begin();
-    
-    Wire.begin(21,22);
-    
-    Terminalbuff.createSprite(160, 80);
-    Terminalbuff.fillRect(80,20,160,80,BLACK);
-    
-    Terminalbuff.pushSprite(80,20);
-    Terminalbuff.setTextFont(4);
-    M5.Lcd.setCursor(105, 0, 4);
-    
-    M5.Lcd.print("Ultrasonic");
+  M5.begin(); //Init M5Stack.  初始化M5Stack
+  M5.Power.begin(); //Init power  初始化电源模块
+  Wire.begin(21, 22);
+  M5.Lcd.setCursor(105, 0, 4);  //Set the cursor at (105,0) and set the font to a 4 point font.  将光标设置在(105,0)处,且设置字体为4号字体
+  M5.Lcd.print("Ultrasonic\nDistance:");
 }
 
 float readEUS()
 {
-    uint32_t data;
-    Wire.beginTransmission(0x57);
-    Wire.write(0x01);
-    Wire.endTransmission();
-    delay(120);
-    Wire.requestFrom(0x57,3);
-    data  = Wire.read();data <<= 8;
-    data |= Wire.read();data <<= 8;
-    data |= Wire.read();
-    return float(data) / 1000;
-    
+  uint32_t data;
+  Wire.beginTransmission(0x57); //Transfer data to 0x57.  将数据传输到0x57
+  Wire.write(0x01);
+  Wire.endTransmission(); //Stop data transmission with the Ultrasonic Unit.  停止与Ultrasonic Unit的数据传输
+  delay(120);
+  Wire.requestFrom(0x57,3); //Request 3 bytes from Ultrasonic Unit.  向Ultrasonic Unit请求3个字节。
+  data  = Wire.read();data <<= 8;
+  data |= Wire.read();data <<= 8;
+  data |= Wire.read();
+  return float(data) / 1000;
 }
 
 void loop() {
-                                                                            
-    float newvalue = 0;
-
-    while(1)
-    {
-        newvalue = readEUS();
-
-        Terminalbuff.fillRect(80,20,160,80,BLACK);
-        Terminalbuff.setCursor(30,50);
-
-        if(( newvalue < 1500 )&&( newvalue > 20 ))
-        {
-            Terminalbuff.printf("%.2fmm",newvalue);
-            Terminalbuff.pushSprite(80,20);
-        }
-        delay(100);
-    }
-
+  static float newvalue = 0;
+  newvalue = readEUS();
+  if(( newvalue < 1500 )&&( newvalue > 20 )){
+    M5.Lcd.setCursor(105,27);
+    M5.Lcd.printf("%.2fmm",newvalue);
+  }
+  delay(100);
 }

examples/Unit/VIBRATOR/VIBRATOR.ino

@@ -1,27 +1,37 @@
 /*
-    Description: Adjust the speed of VIBRATOR Unit through PWM.
+*******************************************************************************
+* Copyright (c) 2021 by M5Stack
+*                  Equipped with M5Core sample source code
+*                          配套  M5Core 示例源代码
+* Visit the website for more information：https://docs.m5stack.com/en/core/gray
+* 获取更多资料请访问：https://docs.m5stack.com/zh_CN/core/gray
+*
+* describe: Vibrator.  震动电机
+* date：2021/8/19
+*******************************************************************************
+  Please connect to Port B,Adjust the speed of VIBRATOR Unit through PWM.
+  请连接端口B,通过PWM调节Vibrator Unit的速度。
 */
+
 #include <M5Stack.h>
 
-const int motor_pin = 21;
+#define motor_pin  26
 int freq = 10000;
 int ledChannel = 0;
 int resolution = 10;
 void setup() {
-  // put your setup code here, to run once:
-  M5.begin();
-  M5.Power.begin();
-  M5.Lcd.setCursor(120, 110, 4);
-  M5.Lcd.println("MOTOR");
-  ledcSetup(ledChannel, freq, resolution);
-  ledcAttachPin(motor_pin, ledChannel);
-
+  M5.begin(); //Init M5Stack.  初始化M5Stack
+  M5.Power.begin(); //Init power  初始化电源模块
+  M5.lcd.setTextSize(2);  //Set the text size to 2.  设置文字大小为2
+  M5.Lcd.setCursor(110, 10); //Set the cursor at (140,10).  将光标设置在(140,10)处
+  M5.Lcd.println("Vibrator");
+  ledcSetup(ledChannel, freq, resolution);  //Sets the frequency and number of counts corresponding to the channel.  设置通道对应的频率和计数位数
+  ledcAttachPin(motor_pin, ledChannel); //Binds the specified channel to the specified I/O port for output.  将指定通道绑定到指定 IO 口上以实现输出
 }
 
 void loop() {
-  // put your main code here, to run repeatedly:
-    ledcWrite(ledChannel, 512);
-    delay(1000);
-    ledcWrite(ledChannel, 0);
-    delay(1000);
+  ledcWrite(ledChannel, 512);  //Output PWM.  输出PWM
+  delay(1000);
+  ledcWrite(ledChannel, 0);
+  delay(1000);
 }