# micropython_nv3007

**Repository Path**: danmu_admin/micropython_nv3007

## Basic Information

- **Project Name**: micropython_nv3007
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-30
- **Last Updated**: 2026-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# micropython_nv3007
Datasheet: https://admin.osptek.com/uploads/NV_3007_Datasheet_V1_0_20240619_2_8a0a34f8c5.pdf
根据商家给的stm32示例代码修改

![](image.png)

## 性能优化

本驱动程序采用了多种 MicroPython 性能优化技术：

1. **使用 `memoryview` 优化 buffer 操作**
   - 所有 framebuffer 操作使用 `memoryview`，避免数据复制
   - 显著提高像素绘制速度

2. **使用 `@micropython.native` 装饰器**
   - 关键绘图函数使用 native 代码编译
   - 性能提升约 2 倍

3. **预分配缓冲区**
   - 填充操作使用预分配的缓冲区
   - 避免频繁的内存分配和垃圾回收

4. **缓存对象引用**
   - 在函数内部缓存频繁访问的对象
   - 减少属性查找开销

5. **边界检查优化**
   - 关键路径使用无边界检查版本
   - 提高批量绘制性能

### 性能建议

1. **使用手动刷新模式**
   ```python
   display.set_auto_flush(False)
   # 执行多个绘图操作
   display.draw_rect(...)
   display.draw_circle(...)
   display.draw_text(...)
   # 最后一次性刷新
   display.flush()
   ```
   比每次操作后自动刷新快得多。

2. **批量操作**
   尽量将相关操作组合在一起执行，减少刷新次数。

3. **避免频繁的清屏操作**
   使用填充矩形覆盖需要更新的区域，而不是清屏。

4. **使用 benchmark.py 测试性能**
   运行 `benchmark.py` 了解在您的硬件上的实际性能。

## Files
- `nv3007.py` - 主驱动模块
- `example.py` - 使用示例程序
- `nv3007_test.py` - 简单测试程序（单文件版本）

## Quickstart
- 复制`nv3007.py`至您的mpy设备
- 修改接线
默认引脚配置：

| 屏幕引脚 | Pico2引脚 |
| -------- | --------- |
| BLK      | GP14      |
| RST      | GP21      |
| DC       | GP20      |
| SDA      | GP19      |
| SCL      | GP18      |
| CS       | GP17      |
| VCC      | 3.3V      |
| GND      | GND       |
- 运行`example.py`或`test.py`测试显示

## API Reference
### Initialization
1. 使用便捷函数（推荐）
```python
from nv3007 import create

# 使用默认配置创建实例
lcd = create()

# 清屏
lcd.clear()

# 绘制红色矩形
lcd.fill_rect(10, 10, 50, 50, NV3007.RED)

...
```

2. 手动配置
```python
from nv3007 import NV3007
from machine import SPI, Pin

# 创建SPI对象
spi = SPI(0, baudrate=8000000, polarity=1, phase=1, 
          bits=8, sck=Pin(18), mosi=Pin(19))

# 创建屏幕实例
lcd = NV3007(spi, cs=17, dc=20, rst=21, blk=14)

...
```

### 基础绘制函数

```python
# 清屏
lcd.clear(color=NV3007.WHITE)

# 画点
lcd.pixel(x, y, color)

# 画线
lcd.line(x1, y1, x2, y2, color)

# 空心矩形
lcd.rect(x, y, w, h, color)

# 实心矩形
lcd.fill_rect(x, y, w, h, color)

# 空心圆
lcd.circle(xc, yc, r, color)

# 实心圆
lcd.fill_circle(xc, yc, r, color)

# 三角形
lcd.triangle(x1, y1, x2, y2, x3, y3, color, filled=False)
```

### 文字渲染

```python
# 导入字体模块
import source_han_sans_cn_regular

# 设置字体
lcd.set_font(source_han_sans_cn_regular)

# 绘制文本（支持中文和英文）
lcd.draw_text(x, y, "文本内容", fg_color, bg_color)

# 示例：绘制白色文字，黑色背景
lcd.draw_text(10, 50, "你好世界", NV3007.WHITE, NV3007.BLACK)

# 绘制彩色文字
lcd.draw_text(10, 100, "MicroPython", NV3007.CYAN, NV3007.BLACK)
```

#### 字体文件生成

使用 [font_to_py](https://github.com/peterhinch/micropython-font-to-py) 工具生成字体文件：

```bash
# 生成中文字体（高度24像素，指定字符集）
font_to_py.py SourceHanSansCN-Regular.otf 24 source_han_sans_cn_regular.py -c 你好世界

# 生成完整ASCII字体
font_to_py.py FreeSans.ttf 17 freesans20.py
```

字体文件需要使用水平映射格式（默认），不支持垂直映射。

### 控制函数

```python
# 设置背光 (0: 关, 1: 开)
lcd.set_backlight(1)

# 进入睡眠模式
lcd.sleep()

# 唤醒屏幕
lcd.wake()
```

### 预定义颜色

```python
NV3007.WHITE
NV3007.BLACK
NV3007.RED
NV3007.GREEN
NV3007.BLUE
NV3007.YELLOW
NV3007.CYAN
NV3007.MAGENTA
# ...
```