1.0.13

.gitignore

@@ -1,9 +1,6 @@
 .pio
-.vscode/.browse.c_cpp.db*
-.vscode/c_cpp_properties.json
-.vscode/launch.json
-.vscode/ipch
-.vscode/*
+.vscode
+/bin
 /include/*
 /lib/*
 /src/*

README.md

@@ -1,13 +1,13 @@
 # J-Calendar
-墨水屏日历，采用三色4.2寸墨水屏，展示基本月历信息，支持农历、公共假期（TODO）、倒计日展示。<br>
-低难度、低成本制作。<br>
+墨水屏日历，采用三色4.2寸墨水屏，展示基本月历信息，支持农历、公共假期、倒计日、天气（实时天气、每日天气）展示。<br>
+项目以低难度、低成本的方式，方便爱好者实现属于自己的低功耗月历。<br>
 <img src="./assets/img/sample.jpg" width="60%"><br>
 注：固件仅供个人下载免费使用，禁止商用。
 
 ## Prepare & Meterial
 1. esp32开发板(建议lolin32 lite,其他esp32开发板亦可)<br>
 2. 4.2寸三色墨水屏(400*300)。
-3. 墨水屏驱动板。
+3. 通用墨水屏驱动板。
 4. 锂电池,需要做ph2.0接头。(建议603048, 900mah)
 5. 金属底座亚克力台卡,95*80mm。
 6. 轻触开关,(12\*12\*7.3,带键帽)
@@ -25,7 +25,7 @@
         * GND->GND
         * VCC->3V
     * 其他
-        * 按钮->(PIN_14, VCC)
+        * 按钮->(PIN_14, GND)
         * LED->22(板载)
 2. 三色墨水屏排线插入时注意针脚方向,屏幕排线和驱动板排线1号针脚均是悬空,注意对齐。
 3. 电池接口需要是ph2.0,且注意正负极(开发板上有标注),如果电池的正负极反了,可以用镊子调整电池插头。
@@ -65,13 +65,20 @@
 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. 重启  
     在所有配置完后,需要重启生效。(也可以在配置状态下,双击按钮重启)
-5. Info. 系统信息  
+5. Info. 系统信息
     可以监控系统的硬件情况,也可以在里面清除配置的Wifi密钥。
 6. Exit. 退出  
     退出配置状态。
@@ -80,15 +87,34 @@
 1. Q: 可以支持哪种屏？
 A: 仅4.2寸三色屏(目前仅支持黑白红,将来支持黑白黄)。
 2. Q: 我使用的屏应该烧录哪个固件？<br>
-A: 从经验上预估，如果是排线是长条无折的屏(一般是ses的4.2寸拆机屏)，选择z21固件。如果是带折的排线，选择z98。如果比较老的屏，选择z15。实在不确定的话，每个固件都试一下。<br>
-
+A: 从经验上预估，SES的拆机屏选z21，比较新一些的选z98，如果是非常老的屏，选z15.不行的话，三个固件都刷一遍试试。<br>
+明确的丝印清单如下：
 |丝印|固件|
 |-----|-----|
 |E042A43-A0|z98|
-|A13600****|z21|
+|P420010|z98|
+|A13600**|z21|
 
 
 ## Releases
+### 1.0.13
+* Fix: bugs.
+### 1.0.12
+* 新功能：增加设置每周首日，默认首日为周日。
+### 1.0.11
+* 优化：补充部分公历&农历节日
+### 1.0.10
+* 新功能：增加日期Tag（通过配置页面进行配置）
+### 1.0.9
+* 优化：
+    1. 统一每日天气与实时天气的布局。
+    2. 增加时间容错性，当同步网络时间失败的时候，使用天气api的更新时间。
+* 新功能：增加节日显示（元旦、劳动节、国庆节）
+### 1.0.8
+* 优化显示：加粗当前日期框；不再使用局刷，全部改为全屏刷新（提高显示的清晰度，兼容不支持局部刷新的三色屏）。
+* 预置2025年公休假信息。
+### 1.0.7
+* 增加24节气显示。修复部分bug。
 ### 1.0.6
 * 增加天气模式--*每日天气*（默认配置），每天刷新一次。（增加月历待机时长。部分不支持局刷的屏可以选择这个模式。）
 ### 1.0.5 
@@ -107,7 +133,6 @@ A: 从经验上预估，如果是排线是长条无折的屏(一般是ses的4.2
 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 © 2023-2024. All Rights Reserved.