# ext2-ul-oled-chinese

**Repository Path**: mind-plus/ext2-ul-oled-chinese

## Basic Information

- **Project Name**: ext2-ul-oled-chinese
- **Description**: 积木里的中文在代码生成时自动完成 16×16 点阵取模，无需外部取模软件，即可在 SSD1306 I2C OLED（默认地址 0x3C）上直接显示中文和英文
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# OLED中文显示（oledchinese）

`oledchinese` 是一个适用于 Mind+ V2 上传模式（ArduinoC）的功能类扩展。它只提供一块 **OLED 坐标显示** 积木：积木里的中文在代码生成时自动完成 16×16 点阵取模，无需外部取模软件，即可在 SSD1306 I2C OLED（默认地址 0x3C）上直接显示中文和英文。

本库同时是 **中文自动取模板库**：`extension/utils/font-to-bitmap.js` 在代码生成期用 canvas 逐字渲染 SimSun 16px 字形并按行取模（每字 32 字节），配合 `unicodeToGB2312Tab.js` 码表生成 `{unicode, utf8, gb2312, bitmap}` 表项，合并去重后写入 Arduino 常量 `chCode`，经 `oled12864.setChCode(chCode)` 交由显示库渲染。

产品 / 型号：
- DFRobot OLED-12864 显示模块（`DFR0486`），依赖 Arduino 库 `DFRobot_Mindplus_SSD1306@1.0.0`（头文件 `DFRobot_SSD1306_I2C.h`）

## 积木

| 积木 | 参数 | 说明 |
| --- | --- | --- |
| `OLED 128*64 在坐标X:[X] Y:[Y]显示[TEXT]` | TEXT：文本输入（默认 “你好世界”）；X：0–127 滑条（默认 42）；Y：0–3 下拉（默认 1） | 在指定坐标显示文本。中文自动取模；积木自带初始化（include / 对象 / `begin(0x3c)` / `setChCode`），无需额外初始化积木。micro:bit 下 Y 按 16px 行高生成 `Y*16` |

对应生成的 Arduino 代码结构（以默认参数、Arduino 主控为例）：

```cpp
#include <DFRobot_SSD1306_I2C.h>
DFRobot_SSD1306_I2C oled12864;
const uint8_t chCode[] = {
    {0x4f60,0xe4bda0,0xc4e3,{0x10,0x10,...}},   // 你
    {0x597d,0xe5a5bd,0xbac3,{...}}              // 好
};

void setup() {
    oled12864.begin(0x3c);
    oled12864.setChCode(chCode);
}

void loop() {
    oled12864.setCursor(42, 1);
    oled12864.print("你好世界");
}
```

## 更新日志

### V0.0.1

- 新建库：唯一积木 `displayInXY`（OLED 坐标显示），中文代码生成期自动取模
- 取模表项合并去重后写入 `chCode` 常量，多积木共享一份字库

## 开发指南

更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)