add module example comment

Author: Gitshaoxiang

examples/Advanced/Blynk/Post-DHT12/DHT12.cpp

@@ -0,0 +1,62 @@
+/*
+	DHT12.cpp - Library for DHT12 sensor.
+	v0.0.1 Beta
+	Created by Bobadas, July 30,2016.
+	Released into the public domain.
+*/
+#include "Arduino.h"
+#include "Wire.h"
+#include "DHT12.h"
+
+DHT12::DHT12(byte scale,byte id)
+{
+	if (id==0 || id>126) _id=0x5c;
+	else _id=id;
+	if (scale==0 || scale>3) _scale=CELSIUS;
+	else _scale=scale;
+}
+
+byte DHT12::read()
+{
+	Wire.beginTransmission(_id);
+	Wire.write(0);
+	if (Wire.endTransmission()!=0) return 1;  
+	Wire.requestFrom(_id, 5);
+	for (int i=0;i<5;i++) {
+		datos[i]=Wire.read();
+	};
+	delay(50);
+	if (Wire.available()!=0) return 2;
+	if (datos[4]!=(datos[0]+datos[1]+datos[2]+datos[3])) return 3;
+	return 0;
+}
+
+float DHT12::readTemperature(byte scale)
+{
+	float resultado=0;
+	byte error=read();
+	if (error!=0) return (float)error/100;
+	if (scale==0) scale=_scale;
+	switch(scale) {
+		case CELSIUS:
+			resultado=(datos[2]+(float)datos[3]/10);
+			break;
+		case FAHRENHEIT:
+			resultado=((datos[2]+(float)datos[3]/10)*1.8+32);
+			break;
+		case KELVIN:
+			resultado=(datos[2]+(float)datos[3]/10)+273.15;
+			break;
+	};
+	return resultado;
+}
+
+float DHT12::readHumidity()
+{
+	float resultado;
+	byte error=read();
+	if (error!=0) return (float)error/100;
+	resultado=(datos[0]+(float)datos[1]/10);
+	return resultado;
+}
+

examples/Advanced/Blynk/Post-DHT12/DHT12.h

@@ -0,0 +1,29 @@
+/*
+	DHT12.h - Library for DHT12 sensor.
+	v0.0.1 Beta
+	Created by Bobadas, July 30,2016.
+	Released into the public domain.
+*/
+#ifndef DHT12_h
+#define DHT12_h
+#include "Arduino.h"
+#include "Wire.h"
+
+#define CELSIUS		1
+#define KELVIN		2
+#define FAHRENHEIT	3
+
+class DHT12
+{
+	public:
+		DHT12(byte scale=0,byte id=0);
+		float readTemperature(byte scale=0);
+		float readHumidity();
+	private:
+		byte read();
+		byte datos[5];
+		byte _id;
+		byte _scale;
+};
+
+#endif

examples/Advanced/Blynk/Post-DHT12/Post-DHT12.ino

@@ -0,0 +1,78 @@
+/*************************************************************
+  Download latest Blynk library here:
+    https://github.com/blynkkk/blynk-library/releases/latest
+  Blynk is a platform with iOS and Android apps to control
+  Arduino, Raspberry Pi and the likes over the Internet.
+  You can easily build graphic interfaces for all your
+  projects by simply dragging and dropping widgets.
+    Downloads, docs, tutorials: http://www.blynk.cc
+    Sketch generator:           http://examples.blynk.cc
+    Blynk community:            http://community.blynk.cc
+    Follow us:                  http://www.fb.com/blynkapp
+                                http://twitter.com/blynk_app
+  Blynk library is licensed under MIT license
+  This example code is in public domain.
+ *************************************************************
+  This example shows how value can be pushed from Arduino to
+  the Blynk App.
+  NOTE:
+  BlynkTimer provides SimpleTimer functionality:
+    http://playground.arduino.cc/Code/SimpleTimer
+  App project setup:
+    Value Display widget attached to Virtual Pin V5
+ *************************************************************/
+
+#include <M5Stack.h>
+#include <WiFi.h>
+#include <WiFiClient.h>
+#include <BlynkSimpleEsp32.h>
+#include "DHT12.h"
+#include <Wire.h> //The DHT12 uses I2C comunication.
+DHT12 dht12; //Preset scale CELSIUS and ID 0x5c.
+
+// You should get Auth Token in the Blynk App.
+// Go to the Project Settings (nut icon).
+char auth[] = "auth";
+char ssid[] = "SSID";
+char pass[] = "PASSWD";
+
+BlynkTimer timer;
+
+// This function sends Arduino's up time every second to Virtual Pin (5).
+// In the app, Widget's reading frequency should be set to PUSH. This means
+// that you define how often to send data to Blynk App.
+void myTimerEvent() {
+    // You can send any value at any time.
+    // Please don't send more that 10 values per second.
+    // Blynk.virtualWrite(V9, millis() / 1000)
+    float tmp = dht12.readTemperature();
+    float hum = dht12.readHumidity();
+    Serial.printf("Temperatura: %2.2f*C  Humedad: %0.2f%%\r\n", tmp, hum);
+
+    Blynk.virtualWrite(V0, tmp);
+    Blynk.virtualWrite(V1, hum);
+    M5.Lcd.setCursor(0, 0);
+    M5.Lcd.setTextColor(WHITE, BLACK);
+    M5.Lcd.setTextSize(3);
+    M5.Lcd.printf("Temperatura:%2.1f  \r\nHumedad: %2.0f%%", tmp, hum);
+}
+
+void setup() {
+    // Debug console
+    M5.begin();
+    Wire.begin();
+
+    //Blynk start
+    Blynk.begin(auth, ssid, pass, "blynk.m5stack.com");
+
+    // Setup a function to be called every second
+    timer.setInterval(2000L, myTimerEvent);
+    M5.Lcd.setBrightness(10);
+}
+
+void loop() {
+
+    Blynk.run();   
+    timer.run(); // Initiates BlynkTimer
+}
+

examples/Fire/M5StackFire_MPU9250/M5StackFire_MPU9250.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/AC-SOCKET/AC-SOCKET.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/BALA/BALA.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/BaseX/BaseX.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/COMMU/factory_test/COMMU_Test_A/COMMU_Test_A.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/DHT12/DHT12.ino

@@ -1,6 +1,7 @@
 /*
-  please add TinyGPSPlus to your library first........
-  TinyGPSPlus file in M5stack lib examples -> modules -> GPS -> TinyGPSPlus-1.0.2.zip
+    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>