rename example files

examples/Basics/FactoryTest/FactoryTest.ino

@@ -36,10 +36,6 @@ void startupLogo() {
 
     M5.Lcd.fillScreen(BLACK);
     delay(800);
-    for(int i=0; i>=100; i++) {
-        M5.Lcd.setBrightness(i);
-        delay(2);
-    }
 }
 
 //TF card test

examples/Modules/AcSocket/AcSocket.ino → examples/Modules/AC-SOCKET/AC-SOCKET.ino

@@ -1,3 +1,6 @@
+/*
+    Description:Click button B to turn on the power. Click button A to turn off the power.
+*/
 #include <Arduino.h>
 #include <M5Stack.h>
 #include "protocol.h"

examples/Modules/Bala/Bala.ino → examples/Modules/BALA/BALA.ino

@@ -1,5 +1,6 @@
-// only for mpu6886 !!!!!
-// first init need press BtnC and reboot to calibrate
+/*
+    Description: This code only for mpu6886! first init need press BtnC and reboot to calibrate !
+*/
 
 #include <M5Stack.h>
 

examples/Modules/BaseX/BaseX.ino

@@ -1,10 +1,6 @@
 /*
- * @Author: Sorzn
- * @Date: 2019-12-12 14:33:57
- * @LastEditTime: 2019-12-13 16:18:07
- * @Description: M5Stack project
- * @FilePath: /M5Stack/examples/Modules/BaseX/BaseX.ino
- */
+    Description: Provide three LEGO motor drive modes。Press button B to switch the mode, button A and C control parameter value increase and decrease
+*/
 
 #include <M5Stack.h>
 #include "BaseX.h"

examples/Modules/COMMU/factory_test/COMMU_Test_A/COMMU_Test_A.ino

@@ -1,6 +1,7 @@
 /*
-  please add MCP_CAN_LIB to your library first........
-  MCP_CAN_LIB file in M5stack lib examples -> modules -> COMMU -> MCP_CAN_lib.rar
+    Description: Press button A for CAN communication test, press button B for RS485 communication test.
+    Please install library before compiling:  
+    MCP_CAN_LIB: file in M5stack lib examples -> modules -> COMMU -> MCP_CAN_lib.rar（unzip the lib zip file to the Arduino Lib path）
 */
 
 #include <M5Stack.h>

examples/Modules/DHT12/DHT12.ino

@@ -1,3 +1,6 @@
+/*
+    Description: Use DHT12 Sensor to read temperature, humidity and display the data on the screen.
+*/
 #include <M5Stack.h>
 #include "DHT12.h"
 #include <Wire.h>     //The DHT12 uses I2C comunication.

examples/Modules/GPS_NEO_M8N/FullExample/FullExample.ino

@@ -0,0 +1,167 @@
+/*
+    Description: Use GPS Module to get the coordinate data and time of the current location.
+    Please install library before compiling:  
+    TinyGPSPlus: file in M5stack lib examples -> modules -> GPS -> TinyGPSPlus-1.0.2.zip （unzip the lib zip file to the Arduino Lib path）
+*/
+
+#include <M5Stack.h>
+#include <TinyGPS++.h>
+
+/*
+   This sample code demonstrates the normal use of a TinyGPS++ (TinyGPSPlus) object.
+   It requires the use of SoftwareSerial, and assumes that you have a
+   4800-baud serial GPS device hooked up on pins 4(rx) and 3(tx).
+*/
+static const uint32_t GPSBaud = 9600;
+
+// The TinyGPS++ object
+TinyGPSPlus gps;
+
+// The serial connection to the GPS device
+HardwareSerial ss(2);
+
+void setup()
+{
+  M5.begin();
+  ss.begin(GPSBaud);
+
+  // M5.Lcd.println(F("FullExample.ino"));
+  // M5.Lcd.println(F("An extensive example of many interesting TinyGPS++ features"));
+  // M5.Lcd.print(F("Testing TinyGPS++ library v. ")); M5.Lcd.println(TinyGPSPlus::libraryVersion());
+  // M5.Lcd.println(F("by Mikal Hart"));
+  // M5.Lcd.println();
+  M5.Lcd.println(F("Sats HDOP Latitude   Longitude   Fix  Date       Time     Date Alt    Course Speed Card  Distance Course Card  Chars Sentences Checksum"));
+  M5.Lcd.println(F("          (deg)      (deg)       Age                      Age  (m)    --- from GPS ----  ---- to London  ----  RX    RX        Fail"));
+  M5.Lcd.println(F("---------------------------------------------------------------------------------------------------------------------------------------"));
+}
+
+void loop()
+{
+  M5.Lcd.setCursor(0, 70);
+  M5.Lcd.setTextColor(WHITE, BLACK);
+  static const double LONDON_LAT = 51.508131, LONDON_LON = -0.128002;
+
+  printInt(gps.satellites.value(), gps.satellites.isValid(), 5);
+  printInt(gps.hdop.value(), gps.hdop.isValid(), 5);
+  printFloat(gps.location.lat(), gps.location.isValid(), 11, 6);
+  printFloat(gps.location.lng(), gps.location.isValid(), 12, 6);
+  printInt(gps.location.age(), gps.location.isValid(), 5);
+  printDateTime(gps.date, gps.time);
+  printFloat(gps.altitude.meters(), gps.altitude.isValid(), 7, 2);
+  printFloat(gps.course.deg(), gps.course.isValid(), 7, 2);
+  printFloat(gps.speed.kmph(), gps.speed.isValid(), 6, 2);
+  printStr(gps.course.isValid() ? TinyGPSPlus::cardinal(gps.course.deg()) : "*** ", 6);
+
+  unsigned long distanceKmToLondon =
+    (unsigned long)TinyGPSPlus::distanceBetween(
+      gps.location.lat(),
+      gps.location.lng(),
+      LONDON_LAT, 
+      LONDON_LON) / 1000;
+  printInt(distanceKmToLondon, gps.location.isValid(), 9);
+
+  double courseToLondon =
+    TinyGPSPlus::courseTo(
+      gps.location.lat(),
+      gps.location.lng(),
+      LONDON_LAT, 
+      LONDON_LON);
+
+  printFloat(courseToLondon, gps.location.isValid(), 7, 2);
+
+  const char *cardinalToLondon = TinyGPSPlus::cardinal(courseToLondon);
+
+  printStr(gps.location.isValid() ? cardinalToLondon : "*** ", 6);
+
+  printInt(gps.charsProcessed(), true, 6);
+  printInt(gps.sentencesWithFix(), true, 10);
+  printInt(gps.failedChecksum(), true, 9);
+  M5.Lcd.println();
+
+  smartDelay(1000);
+
+  if (millis() > 5000 && gps.charsProcessed() < 10)
+    M5.Lcd.println(F("No GPS data received: check wiring"));
+}
+
+// This custom version of delay() ensures that the gps object
+// is being "fed".
+static void smartDelay(unsigned long ms)
+{
+  unsigned long start = millis();
+  do 
+  {
+    while (ss.available())
+      gps.encode(ss.read());
+  } while (millis() - start < ms);
+}
+
+static void printFloat(float val, bool valid, int len, int prec)
+{
+  if (!valid)
+  {
+    while (len-- > 1)
+      M5.Lcd.print('*');
+    M5.Lcd.print(' ');
+  }
+  else
+  {
+    M5.Lcd.print(val, prec);
+    int vi = abs((int)val);
+    int flen = prec + (val < 0.0 ? 2 : 1); // . and -
+    flen += vi >= 1000 ? 4 : vi >= 100 ? 3 : vi >= 10 ? 2 : 1;
+    for (int i=flen; i<len; ++i)
+      M5.Lcd.print(' ');
+  }
+  smartDelay(0);
+}
+
+static void printInt(unsigned long val, bool valid, int len)
+{
+  char sz[32] = "*****************";
+  if (valid)
+    sprintf(sz, "%ld", val);
+  sz[len] = 0;
+  for (int i=strlen(sz); i<len; ++i)
+    sz[i] = ' ';
+  if (len > 0) 
+    sz[len-1] = ' ';
+  M5.Lcd.print(sz);
+  smartDelay(0);
+}
+
+static void printDateTime(TinyGPSDate &d, TinyGPSTime &t)
+{
+  if (!d.isValid())
+  {
+    M5.Lcd.print(F("********** "));
+  }
+  else
+  {
+    char sz[32];
+    sprintf(sz, "%02d/%02d/%02d ", d.month(), d.day(), d.year());
+    M5.Lcd.print(sz);
+  }
+
+  if (!t.isValid())
+  {
+    M5.Lcd.print(F("******** "));
+  }
+  else
+  {
+    char sz[32];
+    sprintf(sz, "%02d:%02d:%02d ", t.hour(), t.minute(), t.second());
+    M5.Lcd.print(sz);
+  }
+
+  printInt(d.age(), d.isValid(), 5);
+  smartDelay(0);
+}
+
+static void printStr(const char *str, int len)
+{
+  int slen = strlen(str);
+  for (int i=0; i<len; ++i)
+    M5.Lcd.print(i<slen ? str[i] : ' ');
+  smartDelay(0);
+}

examples/Modules/GSM/GSM.ino → examples/Modules/GSM_M6315/GSM_M6315.ino

@@ -1,3 +1,6 @@
+/*
+    Description: Send AT command to get current signal quality.
+*/
 #include <M5Stack.h>
 
 void IotWriteCommand(char cmd[],char date[]){