# eeprom.py 函数文档

使用ESP32的NVS（非易失性存储）实现EEPROM功能，用于系统配置的持久化存储。

## 常量定义

- **EEPROM_SIZE**: EEPROM存储大小 (512字节)

## EEPROM 类

### 初始化
```python
def __init__(self)
```
- **功能**: 初始化EEPROM模拟器
- **实现**:
  - 创建数据字典
  - 初始化NVS命名空间('DWIN')
  - 从NVS读取初始数据

### NVS操作函数

#### write_to_NVS(self)
```python
def write_to_NVS(self)
```
- **功能**: 将内存中的数据写入NVS存储
- **实现流程**:
  1. 创建字节数组缓冲区
  2. 逐字节写入数据
  3. 设置NVS blob数据
  4. 提交更改
- **存储键名**: 'DWIN_CFG'

#### read_from_NVS(self)
```python
def read_from_NVS(self)
```
- **功能**: 从NVS读取数据到内存
- **实现流程**:
  1. 创建字节数组缓冲区
  2. 读取NVS blob数据
  3. 逐字节写入内存
- **错误处理**:
  - 首次使用自动初始化
  - 异常时写入默认值
- **返回值**: 读取的字节数组

### 基础读写操作

#### read_byte(self, addr)
```python
def read_byte(self, addr)
```
- **功能**: 读取单个字节
- **参数**: 
  - addr: 字节地址
- **返回值**: 0-255的字节值
- **默认值**: 不存在时返回0

#### write_byte(self, addr, value)
```python
def write_byte(self, addr, value)
```
- **功能**: 写入单个字节
- **参数**:
  - addr: 字节地址
  - value: 要写入的值
- **特性**: 自动截断为8位

### 字（Word）操作

#### read_word(self, addr)
```python
def read_word(self, addr)
```
- **功能**: 读取16位字
- **参数**: 
  - addr: 起始地址
- **实现**:
  - 高字节在前
  - 低字节在后
- **返回值**: 0-65535的整数

#### write_word(self, addr, value)
```python
def write_word(self, addr, value)
```
- **功能**: 写入16位字
- **参数**:
  - addr: 起始地址
  - value: 要写入的值
- **实现**:
  - 高字节在前
  - 低字节在后

## 使用示例

### 基本读写操作
```python
# 创建EEPROM实例
eeprom = EEPROM()

# 写入字节
eeprom.write_byte(0, 0xFF)
value = eeprom.read_byte(0)  # 返回255

# 写入字
eeprom.write_word(1, 0x1234)
value = eeprom.read_word(1)  # 返回4660

# 保存到NVS
eeprom.write_to_NVS()
```

### 配置存储
```python
# 存储配置
def save_config(eeprom, config):
    eeprom.write_word(0, config['version'])
    eeprom.write_word(2, config['parameter1'])
    eeprom.write_word(4, config['parameter2'])
    eeprom.write_to_NVS()

# 读取配置
def load_config(eeprom):
    return {
        'version': eeprom.read_word(0),
        'parameter1': eeprom.read_word(2),
        'parameter2': eeprom.read_word(4)
    }
```

## 数据格式

### 字节格式
- 单字节: 8位无符号整数 (0-255)
- 字: 16位无符号整数 (0-65535)
- 存储顺序: 高字节在前（大端序）

### 地址空间
- 范围: 0-511 (EEPROM_SIZE)
- 字对齐: 字操作需要注意地址对齐

## 注意事项

1. 存储限制
   - 总大小限制为512字节
   - 避免越界访问
   - 合理规划地址空间

2. 写入操作
   - 字操作会占用两个连续地址
   - 注意地址不要重叠
   - 及时调用write_to_NVS保存

3. 性能考虑
   - 批量操作后统一保存
   - 避免频繁写入NVS
   - 合理使用字操作减少访问次数

4. 数据持久化
   - 系统复位后自动加载
   - 写入后需要显式保存
   - 首次使用自动初始化

5. 错误处理
   - 地址检查
   - 异常值处理
   - 初始化保护