1.0.8

README.md

@@ -1,18 +1,21 @@
 # J-Calendar
-墨水屏日历，采用三色4.2寸墨水屏，展示基本月历信息，支持农历、公共假期、倒计日展示。<br>
-注：个人可免费下载固件使用，禁止商用。
+墨水屏日历，采用三色4.2寸墨水屏，展示基本月历信息，支持农历、公共假期（TODO）、倒计日展示。<br>
+低难度、低成本制作。<br>
+<img src="./assets/img/sample.jpg" width="60%"><br>
+注：固件仅供个人下载免费使用，禁止商用。
 
 ## Prepare & Meterial
-1. esp32开发板(建议lolin32 lite,其他esp32开发板亦可)
+1. esp32开发板(建议lolin32 lite,其他esp32开发板亦可)<br>
 2. 4.2寸三色墨水屏(400*300)。
 3. 墨水屏驱动板。
 4. 锂电池,需要做ph2.0接头。(建议603048, 900mah)
 5. 金属底座亚克力台卡,95*80mm。
-6. 轻触开关,(12*12*7.3,带键帽)
+6. 轻触开关,(12\*12\*7.3,带键帽)
 7. 工具:电烙铁、电线若干。
 
 ## Manufacture Guide:
-1. 接线
+1. 开发板接线<br>
+    * 墨水屏驱动板
         * Busy->4
         * RST->16
         * DC->17
@@ -21,34 +24,39 @@
         * SDA->23
         * GND->GND
         * VCC->3V
+    * 其他
+        * 按钮->(PIN_14, VCC)
         * LED->22(板载)
 2. 三色墨水屏排线插入时注意针脚方向,屏幕排线和驱动板排线1号针脚均是悬空,注意对齐。
 3. 电池接口需要是ph2.0,且注意正负极(开发板上有标注),如果电池的正负极反了,可以用镊子调整电池插头。
 4. 烧录固件<br>
-    使用ESP32的烧录工具flash_download_tool烧录固件
+    使用ESP32的烧录工具flash_download_tool烧录固件. [Flash Download Tools](https://www.espressif.com/en/support/download/other-tools?keys=flash+download+tools)
     1. 选择烧录的文件和烧录地址（bootloader.bin与partitions.bin烧录过一次后，就不需要重复烧录了）
     2. 选择Flash的配置信息
     3. 选择连接的串口以及波特率（波特率可以根据实际情况调整）
     4. 擦除Flash。
     5. 开始烧录。<br>
     （参考下图）<br>
-    <img src="./assets/img/flash_download_tool_guide.png" width="50%">
+    <img src="./assets/img/flash_download_tool_guide.png" width="70%">
+5. 安装盒，3D打印，用PLA或ABS均可。[E-ink box2 v22.3mf](./assets/file/E-ink%20box2%20v22.3mf)
 
 ## Button Operation Guide:
 1. **单点**  
-    如果处在休眠中,唤醒系统
+    如果处在休眠中,唤醒系统,并强制刷新月历。
+    如果处在运行中,强制刷新日历。
+    如果处在配置中,不做任何处理
 2. **双击**  
-    系统正常运行中,双击进入系统配置。  
+    系统正常运行中,双击进入系统配置。(并强制停止WIFI相关操作,如获取天气。)
     系统配置状态中,双击重启系统。
 3. **长按**  
     系统运行中,长按清除配置信息(WIFI密钥除外)和缓存,并重启。
 
 ## LED Indicator: 
 (板载LED,PIN-22)
-1. 快闪:系统启动中,正在连接WIFI
-2. 常亮:WIFI连接完成(成功或失败)
-3. 三短闪一长灭:系统配置中。
-4. 熄灭:系统休眠。
+1. 快闪: 系统启动中(正在连接WIFI)
+2. 常亮: WIFI连接完成(成功或失败)
+3. 三短闪一长灭: 系统配置中。
+4. 熄灭: 系统休眠。
 
 ## Web Config Guide:
 通过在开机状态下(LED常亮)双击,即可进入配置状态,这时系统会生成一个名为J-Calendar的ap,默认密码为:password。(默认超时时间为180秒)
@@ -57,8 +65,8 @@
 1. Config Wifi. Wifi配置  
     进入配置wifi页面,选择搜索到的ap,并输入密码,并保存。
 2. Setup. 系统配置  
-    和风天气:输入和风天气的token和城市id(城市对应的id请在和风天气的官网查找。)系统会每2小时刷新当前天气,如果token置空,天气将不会被刷新,系统每日凌晨0点刷新日历。  
-    倒数日:输入倒数日名称和日期,名称不能超过4个中文字符,时间以yyyyMMdd的格式填入。配置正确的话,日历每天会显示倒数“距****还有**天”。如果倒数日名称为空,系统将不显示倒数日信息。
+    * 和风天气:<br>输入和风天气的token和城市id(城市对应的id请在和风天气的官网查找。)系统会每2小时刷新当前天气,如果token置空,天气将不会被刷新,系统每日凌晨0点刷新日历。[城市id列表](./assets/file/China-City-List-latest.csv) <br>
+    * 倒数日:<br>输入倒数日名称和日期,名称不能超过4个中文字符,时间以yyyyMMdd的格式填入。配置正确的话,日历每天会显示倒数“距****还有**天”。如果倒数日名称为空,系统将不显示倒数日信息。
 3. Update. OTA升级  
     此项需要在浏览器内完成,通过ip地址访问配置页面,然后进入Update,选择固件文件后上传,等待。刷新完成后,页面会有成功提示。
 4. Restart. 重启  
@@ -68,13 +76,44 @@
 6. Exit. 退出  
     退出配置状态。
 
+## Q & A
+1. Q: 可以支持哪种屏？
+A: 仅4.2寸三色屏(目前仅支持黑白红,将来支持黑白黄)。
+2. Q: 我使用的屏应该烧录哪个固件？<br>
+A: 从经验上预估，SES的拆机屏选z21，比较新一些的选z98，如果是非常老的屏，选z15.不行的话，三个固件都刷一遍试试。<br>
+明确的丝印清单如下：
+|丝印|固件|
+|-----|-----|
+|E042A43-A0|z98|
+|P420010|z98|
+|A13600**|z21|
+
+
+## Releases
+### 1.0.8
+* 优化显示：加粗当前日期框；不再使用局刷，全部改为全屏刷新（提高显示的清晰度，兼容不支持局部刷新的三色屏）。
+* 预置2025年公休假信息。
+### 1.0.7
+* 增加24节气显示。修复部分bug。
+### 1.0.6
+* 增加天气模式--*每日天气*（默认配置），每天刷新一次。（增加月历待机时长。部分不支持局刷的屏可以选择这个模式。）
+### 1.0.5 
+* 增加强制刷新处理(单击按钮)。
+* 修复日历功能、修复日历字典数据
+* 修复部分bug。
+### 1.0.4<br>
+* 增加倒计日功能
+* 修复部分bug。
+### 1.0.3
+* 基本功能
+* 功耗优化等
+
 ## 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>
 <br>
- Copyright © 2022-2024. All Rights Reserved.
+ Copyright © 2023-2024. All Rights Reserved.