J-Calendar

墨水屏日历，采用三色4.2寸墨水屏，展示基本月历信息，支持农历、公共假期、倒计日、天气（实时天气、每日天气）展示。
项目以低难度、低成本的方式，方便爱好者实现属于自己的低功耗月历。

注：固件仅供个人下载免费使用，禁止商用。

Prepare & Meterial

1. esp32开发板(建议lolin32 lite,其他esp32开发板亦可)
   
2. 4.2寸三色墨水屏(400*300)。
3. 通用墨水屏驱动板。
4. 锂电池,需要做ph2.0接头。(建议603048, 900mah)
5. 金属底座亚克力台卡,95*80mm。
6. 轻触开关,(12*12*7.3,带键帽)
7. 工具:电烙铁、电线若干。

Manufacture Guide:

1. 开发板接线
   
   • 墨水屏驱动板
     • Busy->4
     • RST->16
     • DC->17
     • CS->5
     • SCK->18
     • SDA->23
     • GND->GND
     • VCC->3V
   • 其他
     • 按钮->(PIN_14, VCC)
     • LED->22(板载)
2. 三色墨水屏排线插入时注意针脚方向,屏幕排线和驱动板排线1号针脚均是悬空,注意对齐。
3. 电池接口需要是ph2.0,且注意正负极(开发板上有标注),如果电池的正负极反了,可以用镊子调整电池插头。
4. 烧录固件
   使用ESP32的烧录工具flash_download_tool烧录固件. Flash Download Tools
   1. 选择烧录的文件和烧录地址（bootloader.bin与partitions.bin烧录过一次后，就不需要重复烧录了）
   2. 选择Flash的配置信息
   3. 选择连接的串口以及波特率（波特率可以根据实际情况调整）
   4. 擦除Flash。
   5. 开始烧录。
      （参考下图）
      
5. 安装盒，3D打印，用PLA或ABS均可。E-ink box2 v22.3mf

Button Operation Guide:

1. 单点
   如果处在休眠中,唤醒系统,并强制刷新月历。 如果处在运行中,强制刷新日历。 如果处在配置中,不做任何处理
2. 双击
   系统正常运行中,双击进入系统配置。(并强制停止WIFI相关操作,如获取天气。) 系统配置状态中,双击重启系统。
3. 长按
   系统运行中,长按清除配置信息(WIFI密钥除外)和缓存,并重启。

LED Indicator:

(板载LED,PIN-22)

1. 快闪: 系统启动中(正在连接WIFI)
2. 常亮: WIFI连接完成(成功或失败)
3. 三短闪一长灭: 系统配置中。
4. 熄灭: 系统休眠。

Web Config Guide:

通过在开机状态下(LED常亮)双击,即可进入配置状态,这时系统会生成一个名为J-Calendar的ap,默认密码为:password。(默认超时时间为180秒) 连接上ap后会直接弹出配置页面。(或者直接通过浏览器输入地址 http://192.168.4.1进入)。 配置页面:

1. Config Wifi. Wifi配置
   进入配置wifi页面,选择搜索到的ap,并输入密码,并保存。
2. Setup. 系统配置
   • 和风天气:
     输入和风天气的token和城市id(城市对应的id请在和风天气的官网查找。)系统会每2小时刷新当前天气,如果token置空,天气将不会被刷新,系统每日凌晨0点刷新日历。城市id列表
     
   • 倒数日:
     输入倒数日名称和日期,名称不能超过4个中文字符,时间以yyyyMMdd的格式填入。配置正确的话,日历每天会显示倒数“距****还有**天”。如果倒数日名称为空,系统将不显示倒数日信息。
   • 日期Tag:
     
     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. 系统信息 可以监控系统的硬件情况,也可以在里面清除配置的Wifi密钥。
6. Exit. 退出
   退出配置状态。

Q & A

1. Q: 可以支持哪种屏？ A: 仅4.2寸三色屏(目前仅支持黑白红,将来支持黑白黄)。
2. Q: 我使用的屏应该烧录哪个固件？
   A: 从经验上预估，SES的拆机屏选z21，比较新一些的选z98，如果是非常老的屏，选z15.不行的话，三个固件都刷一遍试试。
   明确的丝印清单如下：

   丝印	固件
   E042A43-A0	z98
   P420010	z98
   A13600**	z21

Releases

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

• 增加强制刷新处理(单击按钮)。
• 修复日历功能、修复日历字典数据
• 修复部分bug。

1.0.4

• 增加倒计日功能
• 修复部分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/
   Copyright © 2023-2024. All Rights Reserved.