# BiliWatch

**Repository Path**: oddbear_ws/biliwatch

## Basic Information

- **Project Name**: BiliWatch
- **Description**: 桌面小数字表的代码与固件
- **Primary Language**: C++
- **License**: CC-BY-SA-4.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2024-07-18
- **Last Updated**: 2024-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BiliWatch v1.0

## 说明

- 板卡：微雪ESP32-C3-Zero
- 烧录环境：Windows
- 此版本支持免开发环境烧录、无线配置等功能
- 本文档对发行版的使用进行说明，固件形式直接烧录，如果想了解源码与开发环境，请查看README_devenv_zh.md
- B站视频链接：[造有趣：显示B站数据和粉丝数的桌面电子表摆件（开源）_哔哩哔哩_bilibili](https://www.bilibili.com/video/BV1pz421B7YU/?vd_source=50a799bfb12dbe10475b5e57e45fd10b)

## 下载文件

- 点击右侧发行版中的BiliWatch_v1

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_1.png)

- 点进去后下载BiliWatch_load_v1.zip，下载后随便解压到哪里

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_2.png)

## 烧录程序

- 在解压出来的文件夹，打开 BiliWatch_load_v1\flash_download_tool_3.9.4\flash_download_tool_3.9.4.exe

![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_3.png)

- Chip Type选择ESP32-C3，WorkMode选择Develop，LoadMode选择USB，选好后点OK

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_4.png)

- 进入下图界面，点图中的 [···] 图标选择对应文件，依次选好四个文件

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_5.png)

- 选好文件后会变成绿色，如下图，选好后将ESP32-C3板卡按住BOOT键与电脑连接，连接后选择板子的串口，点START开始烧录

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_6.png)

- 进度条开始跑后等待烧录完成即可，烧录完成后重新给板子上电或按一下板子上的RESET键，不出意外程序就正常运行了，可以将屏幕连上（断电连），装上外壳使用了（不过还是推荐测试完再装外壳）

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_7.png)

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_8.png)

- 如果烧录时候出现错误，看本文档最后的解决建议部分

## BiliWatch 使用

### 配置WiFi与B站信息

- 上电后会进入WiFi连接，板子的灯亮蓝色，屏幕显示Wait WiFi...，如果在15秒内连不上就会进入配置状态，新板子刚刷完一般没有WiFi信息，所以等待15秒就会进入配置模式（如果板子之前连过WiFi，是存在配置信息的，WiFi会连上，但是没有B站参数所以数据都会显示0，这种看后面的手动进入配置模式的方法）

- 进入配置模式后，屏幕显示如下图，这时用手机或电脑连接WiFi：BiliWatch

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_9.png)

- 连接BiliWatch WiFi后，手机或电脑会弹出配置页面，或者是弹个选项出来，点击即可进入配置页面。如果弹出的配置界面不对或者啥反应都没有，打开浏览器输入192.168.7.1进入配置页面

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_10.png)

- 在配置页面中填写自己的WiFi、B站Cookie和B站UID后点击Submie，这里需要注意ESP32-C3只支持2.4GHz频段的WiFi，如果搜不到你想连的WiFi，可能你的WiFi是5GHz频段，这个一般路由器都可以设置或双频段

  - B站Cookie获取方法参考：[cookie登录b站获取cookie登录billbill教程_获取b站cookie-CSDN博客](https://blog.csdn.net/qq_28821897/article/details/132002110)

  - UID在B站主页就能找到，或者电脑浏览器点到主页，B站网址后面跟的问号前面那串数字就是（需要先登录）

  - 注意：Cookie首尾不要引号(")

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_11.png)

- 点击Submie后跳转下图页面，不出意外就是成功了，BiliWatch会进入WiFi连接状态，连上WiFi后就开始正常运行了

  （我遇到有时候可能因为信号问题，偶发15秒内连不上又进入配置模式，如果确定WiFi名字和密码填的没错，不用重新配置，可以直接拔电再上电试一次，试了还不行可以用手机开热点让BiliWatch连手机热点试试）

  ![image text](https://gitee.com/oddbear_ws/biliwatch/raw/master/readme_img/r_12.png)

### 手动进入配置模式

在使用中，B站Cookie过一段时间会过期，这时播放量与点赞量都会显示为0，就需要新的Cookie，这时需要让BiliWatch进入配置模式（已经连了WiFi想换另一个WiFi同样）

- 在BiliWatch开机的状态下，长按板子上的BOOT键3秒以上

  （如果已经装了外壳，打开滑盖后BOOT键是右边的那个，推荐手指伸进去按，我的手可以正常伸进去轻松按到，用牙签什么的伸进去按的容易把板子元件不小心戳烂 [猜猜我为什么知道...]）

- 长按直到切换为WiFi连接状态后松开，切换WiFi连接状态板子的灯会变蓝色，屏幕显示Wait WiFi...，观察哪一个都可以
- 长按BOOT这个操作是把WiFi配置清除，板子15秒连不上WiFi就会进入配置模式

---

## 烧录失败解决建议

开发过程中需要反复烧录测试，有时候报错烧不成，遇见次数多了总结了一些解决和观察方法

1. 如果使用发行版或开发环境烧录报错失败，先将BiliWatch与电脑断开，不按BOOT键连接电脑，连上后看下串口号，举例看到的串口号为COM30
2. 断开TypeC，按住BOOT键再与电脑连接，如果这时看到串口号还是COM30就是对的，这时烧录应该能成功。如果串口号变成其他的，比如COM25，这个就不对，之前烧录失败时应该也是COM25
3. 尝试反复断开、按住BOOT键连接电脑，如果串口号变成和不按BOOT键连接电脑时一致就对了，进行烧录
4. 如果反复试，串口都不对，将屏幕连接断开，单独板子尝试（发现和连着屏幕有关系，原因没完全想明白），单独板子一般没问题的，我还没有遇到过单板子也出现上述问题的情况
5. 如果上面的都不行，有可能板子出了什么问题，找商家要测试固件测试一下