# esp32c3jkbms

**Repository Path**: ljjgithub/esp32c3jkbms

## Basic Information

- **Project Name**: esp32c3jkbms
- **Description**: esp32c3 SuperMINI 开发板加 0.96 oled 连接极空保护板，获取电量百分比。用在电动自行车上随时随地查看电量
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-31
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 介绍

这是一个用 ESP32C3 Super Mini 开发板连接极空保护板蓝牙，获取保护板的数据项目。

本项目只提取电量百分比，显示在 0.96英寸的 oled 屏幕上。因为屏幕实在太小，所以就显示了电量百分比。

# 硬件购买

拼夕夕或某宝购买 ESP32C3 Super Mini 单片机开发板，和 0.96 oled 屏幕。

# 引脚说明

0.96英寸的 oled 屏幕，有四个引脚，分别是: GND VDD SCK SDA 。即 接地 供电 时钟 数据

ESP32C3 Super Mini 有很多引脚，但和屏幕连接只需要4个脚。

板子和屏幕的接线：（连线左边符号是单片机板子，连线右边是 oled 屏幕）

GND----GND  3.3----VDD   4----SCK  3----SDA

# 供电

刷好机，调试完成后，要安装到车上，怎么供电呢？只需要引出两根线即可，GND 这个是连接到负极的，单片机板子上有个5v和3.3v的引脚，根据自己的供电电压选择5v还是3.3v。

我车上有个usb接口，电压是5v的。负极接到单片机板子的GND，正极接到单片机的5V引脚。

一定要确保电压范围，电压太高，一碰就会烧板。

# 外壳

外壳要自己DIY，做好防水就行。

# 用法

下载项目里的这个文件： `Bms_Project_V1.0.bin`

打开 https://web.esphome.io/ 网站刷入即可。

说是说刷，其实和复制文件到磁盘没什么区别，很简单的。

# 配置保护板的 MAC 地址

刷入成功后，板子会开启一个热点，名称是 `ESP32_g84ficwz7o6`，没有密码。`g84ficwz7o6`是随手打的随机字符串，没有特别含义，仅仅是避免名称碰撞。

手机连接这个热点，用浏览器访问`192.168.4.1`这个ip，会打开配置网页。记得要连上单片机的热点才可以访问这个网页。

根据提示填上自己的保护板的蓝牙 MAC 地址。

# 其他

因为这是用爱发电的项目，可能会有bug，因此造成的损失使用者自甘。

其实我自己也在用，不过我自己用的时候，是没有配置系统的，完全在代码里写死 MAC 地址。考虑到使用者未必懂太多底层技术，花了两天时间实现了WIFI AP，自行配置MAC。

注意：为了节省资源，三分钟后会自动关闭 WIFI 热点。

# 代码完全开源

项目里的代码完全可以复制、二次开发。






--------------------------------------------

以下是原模板内容，保留用于将来查看：

| Supported Targets | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C5 | ESP32-C6 | ESP32-C61 | ESP32-H2 | ESP32-H21 | ESP32-H4 | ESP32-P4 | ESP32-S2 | ESP32-S3 | Linux |
| ----------------- | ----- | -------- | -------- | -------- | -------- | --------- | -------- | --------- | -------- | -------- | -------- | -------- | ----- |

# Hello World Example

Starts a FreeRTOS task to print "Hello World".

(See the README.md file in the upper level 'examples' directory for more information about examples.)

## How to use example

Follow detailed instructions provided specifically for this example.

Select the instructions depending on Espressif chip installed on your development board:

- [ESP32 Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/stable/get-started/index.html)
- [ESP32-S2 Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)


## Example folder contents

The project **hello_world** contains one source file in C language [hello_world_main.c](main/hello_world_main.c). The file is located in folder [main](main).

ESP-IDF projects are built using CMake. The project build configuration is contained in `CMakeLists.txt` files that provide set of directives and instructions describing the project's source files and targets (executable, library, or both).

Below is short explanation of remaining files in the project folder.

```
├── CMakeLists.txt
├── pytest_hello_world.py      Python script used for automated testing
├── main
│   ├── CMakeLists.txt
│   └── hello_world_main.c
└── README.md                  This is the file you are currently reading
```

For more information on structure and contents of ESP-IDF projects, please refer to Section [Build System](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/build-system.html) of the ESP-IDF Programming Guide.

## Troubleshooting

* Program upload failure

    * Hardware connection is not correct: run `idf.py -p PORT monitor`, and reboot your board to see if there are any output logs.
    * The baud rate for downloading is too high: lower your baud rate in the `menuconfig` menu, and try again.

## Technical support and feedback

Please use the following feedback channels:

* For technical queries, go to the [esp32.com](https://esp32.com/) forum
* For a feature request or bug report, create a [GitHub issue](https://github.com/espressif/esp-idf/issues)

We will get back to you as soon as possible.