Merge branch 'master' into master

m5stack · Jul 3, 2024 · 5237715 · 5237715
2 parents 500884b + 588e69b
commit 5237715
Show file tree

Hide file tree

Showing 88 changed files with 38,438 additions and 29,838 deletions.
diff --git a/.clang-format b/.clang-format
@@ -1,17 +1,167 @@
 ---
-
-# This is a clang-format config file. Run command below with this file in
-# one of the parent directories.
-#
-# 	clang-format -style=file -i <filename> (.cpp or .h)
-#
-# ( -i = in-place editing, without it formatted source goes to stdout )
-#
-# See https://clang.llvm.org/docs/ClangFormatStyleOptions.html
-
 Language:        Cpp
 BasedOnStyle:  Google
-ReflowComments:  false
-SortIncludes:    false
+AccessModifierOffset: -1
+AlignAfterOpenBracket: Align
+AlignConsecutiveMacros: true
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlines: Left
+AlignOperands:   true
+AlignTrailingComments: true
+AllowAllArgumentsOnNextLine: true
+AllowAllConstructorInitializersOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortBlocksOnASingleLine: Never
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: false
+AllowShortLambdasOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: WithoutElse
+AllowShortLoopsOnASingleLine: true
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: Yes
+BinPackArguments: true
+BinPackParameters: true
+BraceWrapping:
+  AfterCaseLabel:  false
+  AfterClass:      false
+  AfterControlStatement: false
+  AfterEnum:       false
+  AfterFunction:   false
+  AfterNamespace:  false
+  AfterObjCDeclaration: false
+  AfterStruct:     false
+  AfterUnion:      false
+  AfterExternBlock: false
+  BeforeCatch:     false
+  BeforeElse:      false
+  IndentBraces:    false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: None
+BreakBeforeBraces: Attach
+BreakBeforeInheritanceComma: false
+BreakInheritanceList: BeforeColon
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakConstructorInitializers: BeforeColon
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: true
+ColumnLimit:     80
+CommentPragmas:  '^ IWYU pragma:'
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DeriveLineEnding: true
+DerivePointerAlignment: true
+DisableFormat:   false
+ExperimentalAutoDetectBinPacking: false
+FixNamespaceComments: true
+ForEachMacros:
+  - foreach
+  - Q_FOREACH
+  - BOOST_FOREACH
+IncludeBlocks:   Regroup
+IncludeCategories:
+  - Regex:           '^<ext/.*\.h>'
+    Priority:        2
+    SortPriority:    0
+  - Regex:           '^<.*\.h>'
+    Priority:        1
+    SortPriority:    0
+  - Regex:           '^<.*'
+    Priority:        2
+    SortPriority:    0
+  - Regex:           '.*'
+    Priority:        3
+    SortPriority:    0
+IncludeIsMainRegex: '([-_](test|unittest))?$'
+IncludeIsMainSourceRegex: ''
+IndentCaseLabels: true
+IndentGotoLabels: true
+IndentPPDirectives: None
+IndentWidth:     4
+IndentWrappedFunctionNames: false
+JavaScriptQuotes: Leave
+JavaScriptWrapImports: true
+KeepEmptyLinesAtTheStartOfBlocks: false
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+ObjCBinPackProtocolList: Never
+ObjCBlockIndentWidth: 2
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 1
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 200
 PointerAlignment: Left
+RawStringFormats:
+  - Language:        Cpp
+    Delimiters:
+      - cc
+      - CC
+      - cpp
+      - Cpp
+      - CPP
+      - 'c++'
+      - 'C++'
+    CanonicalDelimiter: ''
+    BasedOnStyle:    google
+  - Language:        TextProto
+    Delimiters:
+      - pb
+      - PB
+      - proto
+      - PROTO
+    EnclosingFunctions:
+      - EqualsProto
+      - EquivToProto
+      - PARSE_PARTIAL_TEXT_PROTO
+      - PARSE_TEST_PROTO
+      - PARSE_TEXT_PROTO
+      - ParseTextOrDie
+      - ParseTextProtoOrDie
+    CanonicalDelimiter: ''
+    BasedOnStyle:    google
+ReflowComments:  true
+SortIncludes:    false
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 2
+SpacesInAngles:  false
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceBeforeSquareBrackets: false
+Standard:        Auto
+StatementMacros:
+  - Q_UNUSED
+  - QT_REQUIRE_VERSION
+TabWidth:        4
+UseCRLF:         false
+UseTab:          Never
 ...
diff --git a/...orkflows/arduino-action-core2-compile.yml → .github/workflows/arduino-action-compile.yml b/...orkflows/arduino-action-core2-compile.yml → .github/workflows/arduino-action-compile.yml
@@ -40,12 +40,12 @@ jobs:
         # You may add a suffix behind the fqbn with "|" to specify one board for e.g. different compile options like arduino:avr:uno|trace
         #############################################################################################################
         arduino-boards-fqbn:
-          - m5stack:esp32:m5stack-core2
+          - m5stack:esp32:m5stack_core2
 
         # Specify parameters for each board.
         #############################################################################################################
         include:
-          - arduino-boards-fqbn: m5stack:esp32:m5stack-core2
+          - arduino-boards-fqbn: m5stack:esp32:m5stack_core2
             platform-url: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/arduino/package_m5stack_index.json
             sketches-exclude: WhistleSwitch,50Hz,SimpleFrequencyDetector
 

diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # M5Core2 Library
 
-[![Arduino Compile](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-core2-compile.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-stickc-compile.yml)
+[![Arduino Compile](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-compile.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-compile.yml)
 [![Arduino Lint](https://github.com/m5stack/M5Core2/actions/workflows/Arduino-Lint-Check.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/Arduino-Lint-Check.yml)
 [![Clang Format](https://github.com/m5stack/M5Core2/actions/workflows/clang-format-check.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/clang-format-check.yml)
 

diff --git a/README_cn.md b/README_cn.md
@@ -1,6 +1,6 @@
 # M5Core2 Library
 
-[![Arduino Compile](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-core2-compile.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-stickc-compile.yml)
+[![Arduino Compile](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-compile.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/arduino-action-compile.yml)
 [![Arduino Lint](https://github.com/m5stack/M5Core2/actions/workflows/Arduino-Lint-Check.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/Arduino-Lint-Check.yml)
 [![Clang Format](https://github.com/m5stack/M5Core2/actions/workflows/clang-format-check.yml/badge.svg)](https://github.com/m5stack/M5Core2/actions/workflows/clang-format-check.yml)
 

diff --git a/examples/Advanced/I2C_Tester/I2C_Tester.ino b/examples/Advanced/I2C_Tester/I2C_Tester.ino
@@ -44,14 +44,13 @@ void loop() {
         Wire.beginTransmission(
             address);  // Data transmission to the specified device address
                        // starts.   开始向指定的设备地址进行传输数据
-        error =
-            Wire.endTransmission(); /*Stop data transmission with the slave.
-                  停止与从机的数据传输 0: success.  成功 1: The amount of data
-                  exceeds the transmission buffer capacity limit.
-                  数据量超过传送缓存容纳限制 return value:              2:
-                  Received NACK when sending address.  传送地址时收到 NACK 3:
-                  Received NACK when transmitting data.  传送数据时收到 NACK 4:
-                  Other errors.  其它错误 */
+        error = Wire.endTransmission(); /*Stop data transmission with the slave.
+                      停止与从机的数据传输 0: success.  成功 1: The amount of
+                      data exceeds the transmission buffer capacity limit.
+                      数据量超过传送缓存容纳限制 return value:              2:
+                      Received NACK when sending address.  传送地址时收到 NACK
+                      3: Received NACK when transmitting data.  传送数据时收到
+                      NACK 4: Other errors.  其它错误 */
         if (error == 0) {
             M5.Lcd.print(address, HEX);
             M5.Lcd.print(" ");

diff --git a/examples/Advanced/MultiTask/MultiTask.ino b/examples/Advanced/MultiTask/MultiTask.ino
@@ -46,8 +46,8 @@ void setup() {
     M5.begin();  // Init M5Core2.  初始化M5Core2
     // Creat Task1.  创建线程1
     xTaskCreatePinnedToCore(
-        task1,  // Function to implement the task.
-                // 线程对应函数名称(不能有返回值)
+        task1,    // Function to implement the task.
+                  // 线程对应函数名称(不能有返回值)
         "task1",  // 线程名称
         4096,     // The size of the task stack specified as the number of *
                   // bytes.任务堆栈的大小(字节)

diff --git a/examples/Advanced/Storage/SPIFFS/SPIFFS/SPIFFS.ino b/examples/Advanced/Storage/SPIFFS/SPIFFS/SPIFFS.ino
@@ -28,7 +28,7 @@ void setup() {
         M5.Lcd.println(
             "SPIFFS format start...");  // output format String in LCD.
                                         // 在屏幕上输出格式化字符串
-        SPIFFS.format();  // Formatting SPIFFS.  格式化SPIFFS
+        SPIFFS.format();                // Formatting SPIFFS.  格式化SPIFFS
         M5.Lcd.println("SPIFFS format finish");
     }
 

diff --git a/examples/Advanced/Storage/SPIFFS/SPIFFS_Add/SPIFFS_Add.ino b/examples/Advanced/Storage/SPIFFS/SPIFFS_Add/SPIFFS_Add.ino
@@ -29,7 +29,7 @@ void setup() {
         M5.Lcd.println(
             "\nSPIFFS format start...");  // Screen prints format String.
                                           // 屏幕打印格式化字符串
-        SPIFFS.format();  // Formatting SPIFFS.  格式化SPIFFS
+        SPIFFS.format();                  // Formatting SPIFFS.  格式化SPIFFS
         M5.Lcd.println("SPIFFS format finish");
     }
     if (SPIFFS.begin()) {  // Start SPIFFS, return 1 on success.

diff --git a/examples/Advanced/Storage/SPIFFS_Add/SPIFFS_Add.ino b/examples/Advanced/Storage/SPIFFS_Add/SPIFFS_Add.ino
@@ -29,7 +29,7 @@ void setup() {
         M5.Lcd.println(
             "\nSPIFFS format start...");  // Screen prints format String.
                                           // 屏幕打印格式化字符串
-        SPIFFS.format();  // Formatting SPIFFS.  格式化SPIFFS
+        SPIFFS.format();                  // Formatting SPIFFS.  格式化SPIFFS
         M5.Lcd.println("SPIFFS format finish");
     }
     if (SPIFFS.begin()) {  // Start SPIFFS, return 1 on success.

diff --git a/examples/Advanced/WIFI/WiFiSetting/WebServer.h b/examples/Advanced/WIFI/WiFiSetting/WebServer.h
@@ -47,7 +47,8 @@ enum HTTPClientStatus { HC_NONE, HC_WAIT_READ, HC_WAIT_CLOSE };
 
 #define HTTP_DOWNLOAD_UNIT_SIZE 1460
 #define HTTP_UPLOAD_BUFLEN      2048
-#define HTTP_MAX_DATA_WAIT      1000  // ms to wait for the client to send the
+#define HTTP_MAX_DATA_WAIT \
+    1000                         // ms to wait for the client to send the
                                  // request
 #define HTTP_MAX_POST_WAIT 1000  // ms to wait for POST data to arrive
 #define HTTP_MAX_SEND_WAIT 5000  // ms to wait for data chunk to be ACKed
@@ -98,8 +99,8 @@ class WebServer {
     void addHandler(RequestHandler* handler);
     void serveStatic(const char* uri, fs::FS& fs, const char* path,
                      const char* cache_header = NULL);
-    void onNotFound(THandlerFunction fn);  // called when handler is not
-                                           // assigned
+    void onNotFound(THandlerFunction fn);    // called when handler is not
+                                             // assigned
     void onFileUpload(THandlerFunction fn);  // handle file uploads
 
     String uri() {

diff --git a/examples/Advanced/WIFI/WiFiSetting/WiFiSetting.ino b/examples/Advanced/WIFI/WiFiSetting/WiFiSetting.ino
@@ -91,10 +91,12 @@ restoreConfig() { /* Check whether there is wifi configuration information
 boolean checkConnection() {  // Check wifi connection.  检测wifi连接情况
     int count = 0;           // count.  计数
     M5.Lcd.print("Waiting for Wi-Fi connection");
-    while (count < 30) { /* If you fail to connect to wifi within 30*350ms
-                            (10.5s), return false; otherwise return true.
-                                       若在30*500ms(15s)内未能连上wifi,返回false;否则返回true
-                          */
+    while (
+        count <
+        30) { /* If you fail to connect to wifi within 30*350ms
+                 (10.5s), return false; otherwise return true.
+                            若在30*500ms(15s)内未能连上wifi,返回false;否则返回true
+               */
         if (WiFi.status() == WL_CONNECTED) {
             M5.Lcd.printf("\nConnected!\n");
             return (true);
@@ -179,7 +181,7 @@ void startWebServer() {  // Open the web service.  打开Web服务
 void setupMode() {
     WiFi.mode(WIFI_MODE_STA);  // Set Wi-Fi mode to WIFI_MODE_STA.
                                // 设置Wi-Fi模式为WIFI_MODE_STA
-    WiFi.disconnect();  // Disconnect wifi connection.  断开wifi连接
+    WiFi.disconnect();         // Disconnect wifi connection.  断开wifi连接
     delay(100);
     int n = WiFi.scanNetworks();  // Store the number of wifi scanned into n.
                                   // 将扫描到的wifi个数存储到n中

diff --git a/examples/Basics/record/record.ino b/examples/Basics/record/record.ino
@@ -53,9 +53,9 @@ void loop() {
                                    // 将触摸坐标存储在pos.内
     if (pos.y > 240) {
         if (pos.x < 109) {
-            M5.Axp.SetLDOEnable(3, true);  // Open the vibration.   开启震动马达
+            M5.Axp.SetVibration(true);  // Open the vibration.   开启震动马达
             delay(100);
-            M5.Axp.SetLDOEnable(3, false);
+            M5.Axp.SetVibration(false);
             data_offset = 0;
             M5.Spk.InitI2SSpeakOrMic(MODE_MIC);
             size_t byte_read;

diff --git a/examples/Basics/speak/speak.ino b/examples/Basics/speak/speak.ino
@@ -54,9 +54,9 @@ void loop() {
                                    // 将触摸坐标存储在pos.内
     if (pos.y > 240)
         if (pos.x < 109) {
-            M5.Axp.SetLDOEnable(3, true);  // Open the vibration.   开启震动马达
+            M5.Axp.SetVibration(true);  // Open the vibration.   开启震动马达
             delay(100);
-            M5.Axp.SetLDOEnable(3, false);
+            M5.Axp.SetVibration(false);
             delay(100);
             M5.Spk.PlaySound(
                 previewR,