1.0.19

.gitignore

@@ -6,5 +6,6 @@
 /src/*
 /test/*
 platformio.ini
-extra_script.py
+*.py
+*.csv
 .DS_Store

README.md

@@ -2,6 +2,7 @@
 墨水屏日历，采用三色4.2寸墨水屏，展示基本月历信息，支持农历、公共假期、倒计日、天气（实时天气、每日天气）展示。<br>
 项目以低难度、低成本的方式，方便爱好者实现属于自己的低功耗月历。<br>
 <img src="./assets/img/sample.jpg" width="60%"><br>
+Bilibili连接：https://www.bilibili.com/video/BV1wHDhYoE3G/<br>
 注：固件仅供个人下载免费使用，禁止商用。
 
 ## Prepare & Meterial
@@ -44,7 +45,7 @@
 1. **单点**  
     如果处在休眠中,唤醒系统,并强制刷新月历。
     如果处在运行中,强制刷新日历。
-    如果处在配置中,不做任何处理
+    如果处在配置中,不做任何处理。
 2. **双击**  
     系统正常运行中,双击进入系统配置。(并强制停止WIFI相关操作,如获取天气。)
     系统配置状态中,双击重启系统。
@@ -53,10 +54,11 @@
 
 ## LED Indicator: 
 (板载LED,PIN-22)
-1. 快闪: 系统启动中(正在连接WIFI)
-2. 常亮: WIFI连接完成(成功或失败)
-3. 三短闪一长灭: 系统配置中。
-4. 熄灭: 系统休眠。
+1. 快闪: LED每秒闪约两次，系统启动中(正在连接WIFI)
+2. 常亮: WIFI连接完成。
+3. 慢闪: LED每两秒闪一次，WIFI连接失败（10秒钟后休眠）。
+4. 三短闪一长灭: 系统配置中。（3分钟后超时休眠）
+5. 熄灭: 系统休眠。
 
 ## Web Config Guide:
 通过在开机状态下(LED常亮)双击,即可进入配置状态,这时系统会生成一个名为J-Calendar的ap,默认密码为:password。(默认超时时间为180秒)
@@ -65,11 +67,16 @@
 1. Config Wifi. Wifi配置  
     进入配置wifi页面,选择搜索到的ap,并输入密码,并保存。
 2. Setup. 系统配置  
-    * 和风天气:<br>输入和风天气的token和城市id(城市对应的id请在和风天气的官网查找。)系统会每2小时刷新当前天气,如果token置空,天气将不会被刷新,系统每日凌晨0点刷新日历。[城市id列表](./assets/file/China-City-List-latest.csv) <br>
+    * 周首日:
+        * 0: 周日(默认); 1: 周一;
+    * 和风天气:
+        * 输入和风天气的API Key和城市id(城市对应的id请在和风天气的官网查找。)系统会每2小时刷新当前天气,如果Key置空,天气将不会被刷新。<br>
+        * 天气类型：0:每日天气（默认，每天凌晨刷新一次）; 1: 实时天气(每两个小时刷新一次天气)<br>[城市id列表](./assets/file/China-City-List-latest.csv) <br>
     * 倒数日:<br>输入倒数日名称和日期,名称不能超过4个中文字符,时间以yyyyMMdd的格式填入。配置正确的话,日历每天会显示倒数“距****还有**天”。如果倒数日名称为空,系统将不显示倒数日信息。
     * 日期Tag:<br>
         1. 输入格式，yyyyMMddx，yyyy为年，每年显示设为0000，MM为月份，每月显示设为00，dd为日期，x为tag的图标（a:书签；b：金钱；c：笑脸；d：警告）。例如：00000015b，每年每月15日旁边显示$符号；00000312a，每年3月12日，显示书签符号。
         2. 最多可以设置三个tag，中间以分号隔开。例如：00000015b;00000312a
+    * 保存配置后，系统自动重启。
 3. Update. OTA升级  
     此项需要在浏览器内完成,通过ip地址访问配置页面,然后进入Update,选择固件文件后上传,等待。刷新完成后,页面会有成功提示。
 4. Restart. 重启  
@@ -80,9 +87,11 @@
     退出配置状态。
 
 ## Q & A
-1. Q: 可以支持哪种屏？
+1. Q: 刷完机后，如何配置？启动流程是如何的？
+A: 需要在系统运行状态下（状态灯常亮或慢闪时）双击按键，即可进入配置状态。LED灯变成三短闪一长灭时说明进入配置状态了。
+2. Q: 可以支持哪种屏？
 A: 仅4.2寸三色屏(目前仅支持黑白红,将来支持黑白黄)。
-2. Q: 我使用的屏应该烧录哪个固件？<br>
+3. Q: 我使用的屏应该烧录哪个固件？<br>
 A: 从经验上预估，SES的拆机屏选z21，比较新一些的选z98，如果是非常老的屏，选z15.不行的话，三个固件都刷一遍试试。<br>
 明确的丝印清单如下：
 |丝印|固件|
@@ -93,6 +102,24 @@ A: 从经验上预估，SES的拆机屏选z21，比较新一些的选z98，如
 
 
 ## Releases
+### 1.0.19
+* New: 假日信息通过网络API获取。
+* Refine: 由于esp32内置时钟的误差，会有可能唤醒的时间不准确，同时，由于处于午夜0点左右，导致提前刷新或在刷新期间切换日期，导致日期显示不准确。处理方式：计时器唤醒的情况下，23:50以后不刷新直接休眠，等待至0点以后唤醒刷新。
+### 1.0.18
+* Fix: 修正Wifi连接失败后，同步时间导致系统时间错误。
+### 1.0.17
+* Refine: 如果wifi连接失败，等待10s再休眠，并增加LED慢闪作为指示。（在这时间段内供用户进行双击打开配置状态）
+* Fix: 修正倒数日名称显示不足的问题。
+### 1.0.16
+* New Feature: UI调整，新增今日农历日期的展现。
+### 1.0.15
+* Fix: 编译异常。
+### 1.0.14
+* Fix: bug(假日颜色不正确), 增加显示假日和调休icon(日历右上角)。
+### 1.0.13
+* Fix: bugs.
+### 1.0.12
+* 新功能：增加设置每周首日，默认首日为周日。
 ### 1.0.11
 * 优化：补充部分公历&农历节日
 ### 1.0.10
@@ -120,11 +147,14 @@ A: 从经验上预估，SES的拆机屏选z21，比较新一些的选z98，如
 * 基本功能
 * 功耗优化等
 
+### ★★★固件还不错，请这老小子喝杯咖啡吧★★★
+<img src="./assets/img/buymeacoffee.jpg" width="30%"><br>
+
 ## Reference:
 1. \<WEMOS LOLIN32簡介\> https://swf.com.tw/?p=1331&cpage=1
 2. \<GxEPD2\> https://github.com/ZinggJM/GxEPD2
 3. \<U8g2_for_Adafruit_GFX\> https://github.com/olikraus/U8g2_for_Adafruit_GFX
 4. \<和风天气\> https://dev.qweather.com/docs/api/weather/weather-now/
 <br>
- Copyright © 2023-2024. All Rights Reserved.
+ Copyright © 2023-2025. All Rights Reserved.