# info-extractor

**Repository Path**: connecting_repo/info-extractor

## Basic Information

- **Project Name**: info-extractor
- **Description**: 设备信息提取工具（Python wheel 分发，专有许可）。从嵌入式固件（ELF/MAP）提取设备描述信息并生成 DCM，对应 QUICK_START 第④步。离线/在线安装均支持。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/connecting_repo/connecting-docs/blob/master/QUICK_START.md
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, Cli, firmware, DCM

## README

# Device Info Extractor

设备信息提取工具，用于从嵌入式固件中提取设备描述信息。

> 📘 **想走完整流程？** 本工具是 [`connecting-docs/QUICK_START.md`](https://gitee.com/connecting_repo/connecting-docs/blob/master/QUICK_START.md) 第④步"提取 DCM"的实现。安装后直接用 `info-extractor --help` 查看命令。

## 获取本仓库

使用前请先确认已拿到本仓库代码（以下二选一）：

- **克隆仓库（推荐，便于更新）**：
  ```bash
  git clone https://gitee.com/connecting_repo/info-extractor.git
  cd info-extractor
  ```
- **下载 Release 包**：若仅需使用、不想克隆，可从 [`info-extractor` Releases](https://gitee.com/connecting_repo/info-extractor/releases) 下载离线安装包（含 `dist/` 与 `install_offline.bat`），解压即用。

> 后续安装命令中的 `dist/` 与 `install_offline.bat` 均位于本仓库根目录，请确保在仓库目录下执行。

## 安装

### 方式一：在线安装（需网络）

```bash
pip install dist/info_extractor-1.0.0-py3-none-any.whl
```
pip 会自动拉取其余依赖（pyelftools、PyYAML、click、chardet、libclang）。

### 方式二：离线安装（无网络 / 内网）

`dist/` 已包含本工具及其全部依赖的 wheel，直接运行：

```bat
install_offline.bat
```

或手动：

```bash
python -m pip install --no-index --find-links dist dist/*.whl
```

> 离线包按 **Python 3.13 + Windows amd64** 解析依赖；其他 Python 版本
> 或系统需重新用 `pip download` 生成对应平台的 wheel。

## 使用

```bash
info-extractor --help
```

## 文档

- `docs/public/install_usage.md` —— 安装与使用说明
- `docs/public/script_guide.md` —— 脚本调用指南
- `docs/public/config_guide.md` —— 配置说明
- `tool/` —— 示例配置（`config.yaml`）与板卡批处理脚本（`F407.bat`）

> 源码当前在本地维护，后续将随工具迭代开放。