1.3.3: fix 2.66BWR refresh & pre-add new driver

extra/guy_driver_template/guy_template/guy_template.cpp

@@ -0,0 +1,74 @@
+/******************** 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_template.cpp
+ * @author FriendshipEnder (f_ender@163.com), Bilibili: FriendshipEnder
+ * @brief 墨水屏 驱动库函数 源代码模板
+ *        使用前, 先查找替换 template 改为你需要的驱动名称
+ *        比如3英寸的屏幕驱动程序应该叫 guy_dev_300a
+ *        此时需要将 template 替换为300A.
+ *        替换好之后, 改文件名, 大小写也要注意改 (文件名最好不要出现大写)
+ *        最后把这个brief替换掉
+ * @version 1.0
+ * @date 2023-11-11
+
+ * @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.
+ */
+#include <stdlib.h>
+#include "guy_template.h"
+#ifdef READGUY_DEV_template
+namespace guydev_template{
+//以下代码均为我 FriendshipEnder 原创, 呵呵哒~~
+
+void drv::drv_init(){ //初始化屏幕
+  //add driver code...
+}
+void drv::drv_fullpart(bool part){ //初始化慢刷功能
+  if(lastRefresh) return;
+  //add driver code...
+}
+void drv::drv_setDepth(uint8_t i){
+  epdFull=0; iLut = i?(i>15?15:i):15;  //如果需要, 改成自己的代码
+}
+void drv::drv_dispWriter(std::function<uint8_t(int)> f,uint8_t m){ //单色刷新
+  if(m&1){//stage 1
+    if(lastRefresh) drv_dispWriter(f,2);
+    //add driver code...
+  }
+  if(m&2){//stage 2
+    uint32_t ms=millis()-lastRefresh;
+    uint32_t u=epdFull?slowRefTime:fastRefTime;  //全刷:局刷 busy时间
+    if(ms<u) guy_epdBusy(u-ms);   //对于busy电平为低电平忙碌,高电平正常的屏幕则改为ms-u
+    lastRefresh=0;
+    //add driver code...
+  }
+}
+void drv::drv_sleep() { //开始屏幕睡眠
+  if(RST_PIN>=0){ //RST_PIN<0 无法唤醒
+    //add driver code...
+  }
+  epd_PowerOn = 0;
+  epdFull = 1; //强制设置为慢刷新模式
+}
+}
+#endif /* END OF FILE. ReadGuy project.
+Copyright (C) 2023 FriendshipEnder. */
+
+

extra/guy_driver_template/guy_template/guy_template.h

@@ -0,0 +1,63 @@
+/******************** 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_template.h
+ * @author FriendshipEnder (f_ender@163.com), Bilibili: FriendshipEnder
+ * @brief 墨水屏 驱动库函数 头文件模板
+ *        使用前, 先查找替换 template 改为你需要的驱动名称
+ *        比如3英寸的屏幕驱动程序应该叫 guy_dev_300a
+ *        此时需要将 template 替换为300A.
+ *        替换好之后, 改文件名, 大小写也要注意改 (文件名最好不要出现大写)
+ *        最后把这个brief替换掉
+ * @version 1.0
+ * @date 2023-11-11
+
+ * @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.
+ */
+#include "../guy_epdbase.h"
+#if (!defined(_GUY_EPDtemplate_H_FILE) && (defined(READGUY_DEV_template)))
+#define _GUY_EPDtemplate_H_FILE
+
+namespace guydev_template{
+constexpr int GUY_D_WIDTH       =200;  //驱动屏幕宽度
+constexpr int GUY_D_HEIGHT      =200;  //驱动屏幕高度
+constexpr int slowRefTime       =2000; //驱动屏幕慢刷时间, 单位毫秒
+constexpr int fastRefTime       =500;  //驱动屏幕快刷时间, 单位毫秒
+
+class drv : public readguyEpdBase {
+public:
+  int drv_ID() const { return READGUY_DEV_template; }
+  void drv_init(); //初始化屏幕
+  void drv_fullpart(bool part); //切换慢刷/快刷功能
+  void drv_dispWriter(std::function<uint8_t(int)> f,uint8_t m=3); //按照函数刷新
+  void drv_sleep() ; //开始屏幕睡眠
+  int drv_width() const { return GUY_D_WIDTH;  }; //返回显示区域宽度
+  //int drv_panelwidth() const { return GUY_D_WIDTH;  }; //返回缓存的数据宽度
+  int drv_height() const{ return GUY_D_HEIGHT; }; //返回显示区域高度
+  void drv_setDepth(uint8_t i); //设置显示颜色深度
+  int drv_supportGreyscaling() const { return 16; }
+private:
+  uint8_t epd_PowerOn=1;  //是否上电. 睡眠则设为0
+  uint8_t epdFull=0;      //是partical模式/快速刷新模式 0快刷, 1慢刷
+  uint8_t iLut=15;        //颜色深度
+};
+} 
+#endif /* END OF FILE. ReadGuy project.
+Copyright (C) 2023 FriendshipEnder. */

extra/guy_driver_template/readme.md

@@ -0,0 +1,23 @@
+# 添加新驱动程序
+
+1. 将文件夹 guy_template 整个拷贝到 guy_epaper 文件夹下
+
+2. 根据里面的模板文件, 添加自定义驱动.
+
+3. 使用查找工具搜索 src 下的以下文本.
+
+```
+//添加新屏幕型号 add displays here
+```
+
+然后把新加入的屏幕驱动 define 给加上
+
+4. 更新 `EPD_DRIVERS_NUM_MAX` 变量, 表明一共有多少个驱动可用.
+
+5. 加好了之后, 应该就可以使用这个驱动了.
+
+6. 记得更改项目根目录的 readme 文件
+
+# 禁用驱动程序
+
+前往 guy_epaper_config.h 文件, 注释掉不需要编译的驱动文件即可