# DWIN_RAM_MAPPER

**Repository Path**: Star-air/dwin_ram_mapper

## Basic Information

- **Project Name**: DWIN_RAM_MAPPER
- **Description**: 迪文RAM地址规划器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DWIN_RAM_MAPPER

> 迪文RAM规划器 

![Overview](./Docs/Image/Overview.png)

## 一、目录结构

```text
ram_map/
  ram_map_editor.html                 # 可视化编辑器（根目录）
  start_ram_map_cfg_server.cmd        # 一键启动本地配置服务并打开网页
  README.md
  data/
    ram_map_template.csv              # 地址模板
    ram_map_20260423053654.csv        # 示例/导出 CSV
  generator/
    gen_ui_addr_map.ps1               # CSV -> C 头文件生成脚本
  generated/
    ui_addr_map.h                     # 生成结果
  editor/
    ram_map_cfg_server.js             # 本地配置服务
    ram_map_ai_cfg.json               # AI 配置文件（由服务写入）
```

## 二、CSV 字段说明

- `name`：人类可读名称
- `key`：代码键名（建议使用 `A-Z0-9_`）
- `group`：分组（例如 `SYS` / `GLOBAL` / `PAGE_xxx`）
- `addr`：起始地址（`0x0000~0xFFFF`）
- `size`：长度（单位：word），默认 `1`
- `type`：可选类型
- `rw`：可选 `R` / `W` / `RW`
- `page`：可选页面标记
- `default`：可选默认值
- `macro_override`：可选宏名覆盖（用于兼容旧代码）
- `comment`：备注

## 三、宏命名规则

- 默认宏名规则：`UI_ADDR_<GROUP>_<KEY>`
- 当 `size > 1` 时会额外生成：
- `<ADDR_MACRO>_BASE`（若原宏名不以 `_BASE` 结尾）
- `UI_LEN_<GROUP>_<KEY>`（或按 `UI_ADDR_*` 推导）

## 四、校验规则

- 地址范围必须在 `0x0000~0xFFFF`
- `size` 必须大于 `0`
- 不允许地址重叠
- 不允许宏名重复

## 五、生成头文件

默认命令：

```powershell
cd Code\Module\dwin_ram\ram_map
.\generator\gen_ui_addr_map.ps1
```

自定义输入/输出命令：

```powershell
.\generator\gen_ui_addr_map.ps1 `
  -InputCsv .\data\ram_map_template.csv `
  -OutputHeader .\generated\ui_addr_map.h `
  -MapVersion "1.0.0"
```

## 六、可视化编辑器

直接打开 `ram_map_editor.html`，支持：

- 导入/编辑/导出 CSV
- 一键导出头文件（调用本地服务执行 `gen_ui_addr_map.ps1`）
- 导出头文件时自动同步当前 CSV 到 `data/ram_map_web_current.csv`
- 地址空间占用可视化
- AI 翻译键名

推荐流程：

```text
CSV -> ram_map_editor.html -> 导出 CSV -> gen_ui_addr_map.ps1 -> ui_addr_map.h
```

## 七、AI 配置持久化（本地文件）

网页通过本地服务读写配置文件：`editor/ram_map_ai_cfg.json`。
同一个本地服务也负责“导出头文件”按钮调用。

推荐启动方式：

```text
start_ram_map_cfg_server.cmd
```

等价命令：

```powershell
cd Code\Module\dwin_ram\ram_map
node .\editor\ram_map_cfg_server.js
```

服务地址：`http://127.0.0.1:18977`