v1.0.2; change file structure

2025-12-13 21:28:14 +08:00 · 2023-09-24 16:59:01 +08:00
parent 5f91e9a9a5
commit 765c433e53
59 changed files with 9077 additions and 632 deletions
--- a/src/guy_button.h
+++ b/src/guy_button.h
@@ -0,0 +1,129 @@
+/******************** F r i e n d s h i p E n d e r ********************
+ * 本程序隶属于 Readguy 开源项目, 请尊重开源开发者, 也就是我FriendshipEnder.
+ * 如果有条件请到 extra/artset/reward 中扫描打赏,否则请在 Bilibili 上支持我.
+ * 项目交流QQ群: 926824162 (萌新可以进来问问题的哟)
+ * 郑重声明: 未经授权还请不要商用本开源项目编译出的程序.
+ * @file guy_button.h
+ * @author FriendshipEnder (f_ender@163.com), Bilibili: FriendshipEnder
+ * @brief 按键驱动库 头文件  
+      guy_button.h - for Readguy project
+      Copied from Button2 Library created by Lennart Hennigs.
+ * @version 1.0
+ * @date 2023-09-21
+
+ * @attention
+ * Copyright (c) 2022-2023 FriendshipEnder
+ * 
+ * Apache License, Version 2.0
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * **************************************************************************
+ *
+  guy_button.h - for Readguy project
+  Copied from Button2 Library created by Lennart Hennigs.
+  
+Original Button2 License:
+
+MIT License
+
+Copyright (c) 2017-2022 Lennart Hennigs 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+ */
+#ifndef _GUY_BUTTON_H_FILE
+#define _GUY_BUTTON_H_FILE
+
+#include "Arduino.h"
+#include <stdint.h>
+#if defined(ARDUINO_ARCH_ESP32) || defined(ESP8266)
+  #include <functional>
+#endif
+#include <Arduino.h>
+
+/////////////////////////////////////////////////////////////////
+
+
+#define GUYBUTTON_empty          0
+#define GUYBUTTON_single_click   1
+#define GUYBUTTON_double_click   2
+#define GUYBUTTON_triple_click   3
+#define GUYBUTTON_long_click     4
+#define GUYBTN_READ_TIMEOUT    100
+#define GUYBTN_LOOP_TIMEOUT     10
+
+class guy_button{
+  protected:
+    uint16_t min_debounce    ;   //去抖时间
+    uint16_t long_press_ms   ;  //长按持续时间+双击识别间隔最大时间
+    uint16_t long_repeat_ms  ;  //长按连按间隔时间
+    uint8_t pin = 255; //未定义引脚
+    uint8_t state;
+    uint8_t prev_state;
+    uint8_t click_count = 0;
+    uint8_t _pressedState;
+    uint8_t multibtn; //是否为多个按钮, 可自己设置
+    uint8_t last_click_type = GUYBUTTON_empty;
+    volatile uint8_t lk = 255;
+    //int id;
+    unsigned int down_time_ms = 0;
+    unsigned long click_ms;
+    unsigned long down_ms;
+    unsigned long long_clicked = 0;
+
+    //bool longclick_detected_retriggerable;
+    //uint16_t longclick_detected_counter = 0;
+    bool was_pressed = false;
+    bool longclick_detected = false;
+    bool pressed_triggered = false;
+    bool trig_mode = false; //长按连按触发模式
+
+    typedef uint8_t (*std_U8_function_U8)(uint8_t);
+    std_U8_function_U8 get_state_cb = NULL;
+
+  public:
+    guy_button();
+    void begin(uint8_t _pin, std_U8_function_U8 f, bool activeLow  = true);
+    void setLongRepeatMode(bool trigMode) { trig_mode = trigMode; }
+    unsigned int wasPressedFor() const { return down_time_ms; }
+    bool isPressed() const { return (state == _pressedState); }
+    bool isPressedRaw() { return (get_state_cb(pin) == _pressedState); }
+    bool wasPressed(){ if(was_pressed){ was_pressed = false; return true; } return false; }
+    uint8_t getNumberOfClicks() const{ return click_count;}
+    uint8_t getType() const { return last_click_type; }
+    uint8_t read();
+    void loop();
+    void setMultiBtn(uint8_t btns) { multibtn = btns; }
+    void setMinDebounce(short n) { min_debounce    =n;}   //去抖时间
+    void setLongPressMs(short n) { long_press_ms   =n;}  //长按持续时间+双击识别间隔最大时间
+    void setLongRepeat(short n)  { long_repeat_ms  =n;}  //长按连按间隔时间
+};
+
+#endif /* END OF FILE. ReadGuy project. */