# PinAssignment

**Repository Path**: H0x9DEFA478/PinAssignment

## Basic Information

- **Project Name**: PinAssignment
- **Description**: 一个引脚分配工具，可以图形化选择IO复用功能，适合用在io和复用功能很多的器件上，通过不同的引脚描述文件以适配各种器件
- **Primary Language**: C++
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2023-03-08
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PinAssignment

## 介绍

        一个引脚分配工具，可以图形化选择IO复用功能，适合用在io和复用功能很多的器件上

        目前已实现图形化功能

## 使用说明

        使用Qt Creator编译源码, 使用Qt6

        hpa文件夹下是引脚描述文件示例

        PinAssignment需要一个hpa文件来新建spa文件，spa文件用于保存配置的引脚状态和配置(spa文件完全独立，不依赖hpa文件，尽管是通过hpa文件创建的)

### 新建一个新的引脚分配, 保存引脚分配

![菜单](./assets/menu.png)

**新建分配文件**: 通过hpa文件创建分配文件
**打开分配文件**: 打开保存的分配文件(spa)，继续上次的引脚分配
**保存分配文件**: 保存分配文件(spa)

### 操作方法

以HPM6750IVM为例

![开始](./assets/start.png)

#### 搜索-高亮引脚功能

左上角有个搜索框，用于搜索引脚功能，单击对应的功能对应的引脚会高亮(绿色)

![搜索](./assets/Search.png)

#### 设置引脚功能

右键对应的引脚即可选择引脚功能

![搜索](./assets/rclick.png)

正常选中的引脚变为深蓝色，如果选中的引脚对应功能高亮，则变为天蓝色，如果高亮的引脚已经选择别的功能，则变为红色

![颜色](./assets/Color.png)

### hpa文件说明

hpa文件内容为ASCII文本，用于描述器件的引脚功能

![hpa文件内容](./assets/hpa_text.png)

1. 文件第一行由**Package**开头, 最后以**Package**单独占一行结束。

2. 第一行的**Package**后紧跟一个空格后再加一个封装名, 例如**Package LQFP48**, **Package BGA289**, 支持边长相等的LQFP和BGA封装

3. 中间每一行都将描述一个管脚，一行内部有多个`项`, `项`与`项`之间使用空格隔开, 第一个项为引脚编号, 如: `32`, `B4`; 第二个`项`为管脚类型, 有`GND`, `Power`, `Sys`, `IO`, `NC`可选; 第三个`项`为引脚名, 后续的`项`为引脚的功能

4. 最后一个**Package**之前的所有行不得有空行