# 1153tool

**Repository Path**: holdtao/1153tool

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 2ED1153配置工具

用于 `2EDN1153DAA` 的诊断保护配置与解析工具。  
当前提供浏览器界面（`ui.html`）和命令行入口（`src/index.js`）。

## 工程架构

### 1) 界面层

- `ui.html`：主界面入口，包含顶部导航与功能页面切换
- `src/ui/modules/drain/app.js`：页面交互逻辑、计算流程编排、结果表格渲染

### 2) 核心计算层

- `src/core/registers/registerDictionary.js`：寄存器字典（地址、默认值、字段位段）
- `src/core/rules/drainProtection.rule.js`：漏极保护规则定义（参数、位宽、前提模式）
- `src/core/engine/bitUtils.js`：位操作工具（置位、钳位、格式化）
- `src/core/engine/drainCalculator.js`：阈值参数 -> 字段编码 -> 寄存器值
- `src/core/prereq/drainPrereqChecker.js`：功能生效前提检查（已满足/缺失）
- `src/output/formatters.js`：输出格式化（写入清单、检查结果）

### 3) 命令行与示例

- `src/index.js`：命令行运行入口
- `examples/drain-input.json`：示例输入文件
- `package.json`：脚本命令定义

## 当前功能模块

### 基于漏极电压的诊断保护

包含两个功能页签：

1. `阈值配置 -> 寄存器值`
   - 输入参数：`DUVL/DUVW/DUVH/DOV/DOVW` 及行为位
   - 支持通道模式：仅A / 仅B / A+B
   - 输出：
     - 字段编码值
     - 寄存器配置值（16位、高8位、低8位）
     - 每个字段位段和值
     - 前提检查（已满足/缺失）

2. `寄存器值 -> 参数反解析`
   - 输入漏极相关寄存器值
   - 反推出参数编码和电压值
   - 支持通道模式：仅A / 仅B / A+B

### 故障告警解析

- 输入 `CHDIAG` 和 `WCHDIGC`
- 自动解析当前置位对应的故障/告警类型
- 输出内容包括：
  - 寄存器16位值、高8位、低8位
  - 触发项列表（类别、通道、来源寄存器、位号、标识、中文说明）

### 基于栅极/源极/栅源电压的诊断保护

- 当前为预留模块入口，后续可按同样模式接入“配置”和“反解析”能力

## 使用方法

## 图形界面（推荐）

1. 打开 `ui.html`（双击或浏览器打开）
2. 在顶部导航选择模块
3. 根据页面提示输入参数或寄存器值
4. 点击对应按钮获取结果

## 命令行方式

先安装 Node.js（建议 LTS），然后在项目根目录执行：

```bash
npm start
```

或指定输入文件：

```bash
node src/index.js examples/drain-input.json
```

## 扩展开发说明

后续新增保护功能建议复用现有分层：

1. 在 `src/core/rules` 增加新功能规则
2. 在 `src/core/registers` 增加寄存器映射
3. 在 `src/core/engine` 增加计算/反解析逻辑
4. 在 `src/ui/modules` 新增页面模块并挂到导航

这样可以保持“规则可扩展、界面可插拔、输出格式统一”。