目录

AutoLasm

FT-M7004 DSP 高性能算子 LASM 代码生成工具

将 C/C++/Python 算法描述转换为 FT-M7004 DSP 的 LASM 线性汇编代码,自动优化流水线调度。

工作流程

用户需求
  │
  ▼
Step 1: 环境检查
  │
  ▼
Step 2: 设计决策(Designer)
  │   触发判断 → 前置确认 → 算法分析 → 决策匹配 → 详细查阅 → 易错检查
  │
  ▼ DESIGN.md
Step 2.5: 设计审查
  │   Developer 审查可实现性 → Designer 回应 → 仲裁分歧
  │
  ▼
Step 3: 代码实现(Developer)
  │   编程模式 → 易错检查 → 覆盖审计 → 尾数处理 → 编译验证 → 交付处理
  │
  ▼
Step 4: 代码审查(Reviewer)
  │   独立编译验证 + 设计一致性审查 + 7维度评分 + 易错指令检查
  │
  ▼ REVIEW.md == PASS
Step 5: 修复循环(仅 FAIL 时,最多 5 轮;连续 2 轮无进展则提前停止)
  │   Developer 修复 → Reviewer 复审
  │
  ▼
Step 6: 完成汇报

安装

Claude Code

git clone https://gitlink.org.cn/yhft_dev/autolasm.git

# 项目级安装(推荐)
/path/to/autolasm/init.sh --project-dir ~/my-project project claude

# 在项目目录内执行
cd ~/my-project && /path/to/autolasm/init.sh project claude

# 全局安装(推荐用于多个算子工作区)
# 安装一次后,每次在哪个目录启动 Claude Code,就在该目录生成 operators/
/path/to/autolasm/init.sh global claude

Windows 用户:直接运行 init.cmd,无需手动打开 Git Bash:

# 项目级安装
D:\path\to\autolasm\init.cmd --project-dir D:\my-project project claude

# 在项目目录内执行
cd D:\my-project && D:\path\to\autolasm\init.cmd project claude

# 全局安装(工作区随 Claude Code 当前目录切换)
D:\path\to\autolasm\init.cmd global claude

也支持 opencode、trae、cursor 等工具,将 claude 替换为对应工具名即可。

详见 quickstart.md。

更新

cd /path/to/autolasm && git pull
# 更新项目级安装
/path/to/autolasm/init.sh --project-dir ~/my-project project claude
# 更新全局安装(升级旧版全局 hook 后,项目级版本才能完整覆盖)
/path/to/autolasm/init.sh global claude

双目录架构

目录 变量 角色 内容
引擎目录 $AUTOLASM_ROOT 引擎(只读) 工具链、库、测试框架、skill 文档、agents、hooks、workflows
项目目录 $AUTOLASM_PROJECT_DIR 工作区(读写) 算子产出:operators/{name}/
  • 项目级安装直接把安装脚本所在的 autolasm 源码目录作为 $AUTOLASM_ROOT,不会把完整引擎复制到指定项目目录;移动或删除源码目录后,需要从新位置重新执行项目级安装
  • 全局安装把独立运行时快照复制到 ~/.autolasm/runtime/current,并把该目录设为 $AUTOLASM_ROOT;安装完成后可以移动或删除原源码目录
  • 项目级安装的项目目录 = init.sh --project-dir 指定,默认为安装时的 $PWD
  • 全局安装不固定工作区:每个会话使用启动 Claude Code 时的当前目录
  • 全局安装的 Python 环境集中在 ~/.autolasm/venv,不会在每个工作区创建 .autolasm-venv
  • 全局运行时包含 AGENTS/workflows、skills、agents、工具链、库和测试框架,不覆盖用户已有的全局同名文件,也不向算子工作区写入 .claude/
  • 全局安装和项目级安装可以共存:当前项目存在有效的项目级安装时,项目版本完整覆盖全局版本,全局 hook 自动静默让路
  • --project-dir 只用于项目级安装;全局安装与该参数组合会直接报错
  • 两者由 session hook 和 init.sh 自动设置环境变量

地址空间约束

完整地址划分、保留区和访问许可矩阵以官方文档 docs/M7004_address_space.md 为准。此处只列 AutoLasm 常用空间:

空间/窗口 地址 摘要
CORE_AM 0x0_1000_0000 当前核 AM;有效用户区512KB
SHARE_AM0~3 0x0_2000_0000、0x0_2100_0000、0x0_2200_0000、0x0_2300_0000 分别映射 Core0~3 的 AM,不是独立存储
GSM 0x0_7000_0000 ~ 0x0_707F_FFFF 8MB 全局共享存储
DDR 0x0_8000_0000 ~ 0xF_FFFF_FFFF 62GB 系统地址空间;实际容量和分配服从平台配置

lib/csl.la 的相关地址常量依据该官方文档定义。向量 L/S 访问其他核 AM 时使用对应的 SHARE_AMi 映射窗口;GSM/DDR 张量数据通过 lib/csl.la 的 DMA 公共接口搬入本核 AM。本核有多个 真实 local tile 时比较单缓冲与 A/B 并按端到端证据选择;只有最终选择 A/B 时才强制双份布局、 两侧所有权和填充/稳态/排空。 DMA 硬件事实和使用经验分别以 docs/FT-M7004V_DMA部件设计说明.md 与 docs/FT-M7004V_DMA使用说明.md 为准。

项目结构

autolasm/                           # 源码/引擎结构(项目级直接使用;全局级复制为运行时快照)
├── AGENTS.md                       # AutoLasm 编排器定义(6步工作流调度 + Subagent 规范)
├── CLAUDE.md                       # 项目说明与关键约束速查
├── init.sh                         # 安装脚本(Linux/Unix)
├── init.cmd                        # 安装脚本(Windows,自动调用 Git Bash)
├── conftest.py                     # pytest 路径配置
├── pytest.ini                      # pytest 配置
├── quickstart.md                   # 快速入门指南
├── agents/                         # Subagent 定义
│   ├── lasm-kernel-designer.md     # 设计决策 Agent(Step 2, 2.5c)
│   ├── lasm-kernel-developer.md    # 代码实现 Agent(Step 2.5a, 3, 5a)
│   ├── lasm-kernel-reviewer.md     # 代码审查 Agent(独立编译验证 + 7维度评分)
│   └── lasm-kernel-debugger.md     # 问题调试 Agent(测试失败根因定位)
├── hooks/                          # 会话钩子
│   ├── hooks.json                  # SessionStart 钩子注册
│   ├── run-hook.cmd                # 跨平台钩子运行器(bash+cmd)
│   └── session-start-autolasm      # 平台检测 + 工具链路径注入 + AGENTS.md 内容注入
├── workflows/                      # 工作流资源
│   ├── development-guide.md        # 开发指南
│   ├── task-prompts.md             # Subagent 调用参数模板(严禁自行改写)
│   ├── board-test-templates/        # 板卡 harness 蓝本;IDE 工程由外部 Skill 创建
│   │   ├── single-core/             # 单核
│   │   └── multi-core/              # 多核
│   ├── references/                 # 审查参考手册
│   │   ├── review-checklist.md
│   │   └── review-final-round.md
│   ├── scripts/
│   │   ├── init_operator_project.sh # 算子目录初始化
│   │   ├── verify_environment.sh   # 环境验证 + 外部板测 Skill 发现
│   │   ├── validate_board_result.py# 结构化真机证据校验
│   │   └── check_delivery.sh       # 最终交付门禁
│   └── templates/                  # 设计、计划、多核实施和板测请求模板
│       ├── design-template.md
│       ├── plan-template.md
│       └── multicore-kernel-template.md
├── vendor/lasm/<version>/           # LASM 工具链(默认版本见 vendor/lasm/DEFAULT_VERSION)
│   ├── bin/lasm                    # 线性汇编器(Linux 原生)
│   ├── bin/lasm.exe                # 线性汇编器(Windows)
│   ├── bin/dspsim.exe              # DSP 仿真器
│   ├── bin/layout.json             # 内存布局配置
│   ├── doc/                        # 用户手册 PDF
│   └── sample/                     # 工具链示例
├── lib/                            # 库函数
│   ├── math.la                     # 数学库(sdiv, sqrt, sin, 归约等)
│   └── csl.la                      # 系统控制库(DMA, 核配置等)
├── tests/                          # 测试框架
│   ├── framework/                  # 测试框架核心
│   ├── operators/                  # 算子测试用例
│   ├── run_test.py                 # 单算子测试 CLI
│   ├── run_all.py                  # 批量测试 CLI
│   └── requirements.txt            # Python 依赖(numpy, pyyaml, pytest)
├── utils/                          # 工具集
│   ├── stack_utils.py              # 出入栈核心模块
│   ├── add_stack.py                # 出入栈 CLI
│   └── clean_generated.py          # 清理测试生成文件
├── docs/                           # 参考文档(按需读取,不自动加载)
│   ├── FT-M7004V_DSP_INST.md      # 完整指令集参考(735KB,默认精确查阅)
│   ├── M7004_address_space.md      # 官方地址划分、保留区与访问许可矩阵
│   ├── architecture.md            # 地址空间/参数对/寄存器规范
│   ├── decision-guide.md          # 4层15章指令决策指南
│   ├── programming-guide.md       # LASM 语法与编程模式
│   ├── FT-M7004V_DMA部件设计说明.md # DMA 硬件事实
│   ├── FT-M7004V_DMA使用说明.md    # DMA 使用经验
│   ├── dma-programming-guide.md   # csl.la 同步 ABI 的 AutoLasm 允许子集
│   ├── multicore-programming-guide.md # 核映射、所有权、屏障与可见性
│   ├── ddr-multicore-guide.md     # DDR 36 位地址、AM staging 与能力组合
│   ├── optimization-barrier-guide.md # @bar 的 S/V MVCGC 上下文规则与 @mdep 边界
│   ├── stack-abi-guide.md         # 最小动态出入栈与可调用 ABI
│   ├── usage-checklist.md         # 易错指令检查清单
│   ├── operator-interface.md      # 算子接口与调用规则
│   └── library-verification.md    # 库函数与编译验证流程
├── .claude/skills/                 # 轻量导航索引(不含重型文档)
│   ├── lasm-kernel-design/        # 设计域 skill
│   ├── lasm-kernel-develop/       # 开发域 skill + 代码模板
│   ├── lasm-kernel-review/        # 审查域 skill
│   └── lasm-kernel-debug/         # 调试域 skill(测试失败根因定位)
└── .claude-plugin/
    └── plugin.json                 # 插件元数据

~/my-project/                       # 项目目录 ($AUTOLASM_PROJECT_DIR,工作区)
└── operators/
    └── {算子名}/
        ├── {算子名}.la             # LASM 源码
        ├── output/                 # 交付输出(含出入栈代码,供 C 调用)
        │   ├── O0/{算子名}.asm     # O0 编译 + 出入栈
        │   └── O2/{算子名}.asm     # O2 编译 + 出入栈
        ├── test_{算子名}.py        # 测试脚本
        └── docs/
            ├── DESIGN.md           # 技术设计
            ├── PLAN.md             # 开发计划
            ├── REVIEW.md           # 审查报告
            ├── WALKTHROUGH.md      # 设计审查记录
            └── environment.json    # 环境信息

四角色分工

角色 Agent 负责阶段 职责
Designer lasm-kernel-designer Step 2, 2.5c 前置确认、算法分析、指令决策、指令验证、易错检查、审查回应
Developer lasm-kernel-developer Step 2.5a, 3, 5a 设计审查、编写 LASM 代码、编译验证、功能测试、覆盖审计、尾数处理、交付修复
Reviewer lasm-kernel-reviewer Step 4, 5b 独立编译验证、设计方案一致性审查、7维度100分制评分、易错指令检查、复审
Debugger lasm-kernel-debugger Step 3(按需) 测试失败根因定位、dspsim 日志追踪、指令周期分析、问题归属判定、输出 DEBUG.md

跨平台支持

AutoLasm 支持 Linux 和 Windows 平台:

平台 lasm dspsim 安装方式
Linux wine lasm.exe wine dspsim.exe 符号链接
Windows lasm.exe dspsim.exe 文件复制

$LASM_BIN 和 $DSPSIM_BIN 由 session hook 和 init.sh 根据平台自动设置。

编译与验证

$LASM_BIN / $DSPSIM_BIN 由 session hook 根据平台自动设置。

编译

$LASM_BIN <input>.la \
  --layout $LASM_LAYOUT \
  --output <output>.asm <output>.dat <output>.dis

仿真

$DSPSIM_BIN -i <output>.dat     # 指定 .dat 文件
$DSPSIM_BIN                     # 默认读取 a.dat
$DSPSIM_BIN -i <output>.dat -n 4  # 4核模拟

输出文件说明

文件 用途
.asm 汇编代码,供人工审阅
.dat 可执行程序,dspsim 仿真输入
.dis 反汇编文件,包含地址/指令编码/符号信息,用于调试分析

测试框架

测试框架用于验证算子功能正确性、生成性能分析所需基础文件。

快速开始

# 安装依赖(在线环境)
pip install -r $AUTOLASM_ROOT/tests/requirements.txt

# 离线环境:确保系统 Python 已安装 numpy、pyyaml、pytest
# venv 使用 --system-site-packages,自动访问系统已安装的包

# 测试单个算子
python $AUTOLASM_ROOT/tests/run_test.py operators/<operator>/<operator>.la

# 批量测试
python $AUTOLASM_ROOT/tests/run_all.py

测试流程

准备数据 → 编译LASM → dspsim仿真 → X86参考实现 → 结果对比 → 性能分析
    ↑                              ↑
    └────────── 自动解析.la ───────┘

CLI 参数

# run_test.py(单算子测试)
python $AUTOLASM_ROOT/tests/run_test.py <operator.la> --dtype fp32 --seed 42 --verbose

# run_all.py(批量测试)
python $AUTOLASM_ROOT/tests/run_all.py --report report.md --fail-fast

# add_stack.py(先做 SCR/@bar 门禁,再生成可交付的 O0/O2 .la/.asm)
python $AUTOLASM_ROOT/utils/add_stack.py <file.la> --validate-only
python $AUTOLASM_ROOT/utils/add_stack.py <file.la> --deliver
python $AUTOLASM_ROOT/utils/add_stack.py --batch

# 清理测试生成文件
python $AUTOLASM_ROOT/utils/clean_generated.py          # 清理
python $AUTOLASM_ROOT/utils/clean_generated.py -n       # 预览模式

正式交付会分别扫描 O0/O2 最终 ASM 中与 .la 文件同名的顶层算子,只为该 C 可调用入口生成最小出入栈;@call / @icall 子函数继续使用 LASM 自身的栈帧。顶层算子按实际使用的 R30..R41、AR7/AR14/AR15 保护(R63:R62 始终保护),并扫描其 S/V MVCGC 控制目标(排除 SVR),按标量/向量访问类型和手册周期生成调用者控制状态保存/恢复;VPE 局部控制使用完整 16-lane 快照。规则和失败条件见 动态出入栈规范。

支持的数据类型

类型 说明 容差
fp32 单精度浮点 rtol=1e-5, atol=1e-8
fp16 半精度浮点 rtol=1e-3, atol=1e-5
int32/int16 整数 精确匹配
cplx64 复数 rtol=1e-5, atol=1e-8

参考文档(docs/)

文件 查阅角色 内容
M7004_address_space.md Designer/Developer/Reviewer/Debugger 官方地址划分、保留区和访问许可矩阵;地址空间事实的权威来源
architecture.md Designer/Developer 地址空间/参数对/寄存器规范/条件寄存器限制
decision-guide.md Designer 4层决策架构:数据准备/计算执行/数据变换/流程控制
programming-guide.md Developer LASM语法/数据类型/常用指令模式/循环优化
FT-M7004V_DMA部件设计说明.md Designer/Developer/Reviewer/Debugger DMA 硬件结构、字段、事件、异常与接口事实
FT-M7004V_DMA使用说明.md Designer/Developer/Reviewer/Debugger DMA 调用流程、使用习惯和性能经验
dma-programming-guide.md Designer/Developer/Reviewer/Debugger lib/csl.la 三种同步 ABI 的 AutoLasm 允许子集、门禁与性能证据边界;不替代两份 DMA 参考文档
multicore-programming-guide.md Designer/Developer/Reviewer/Debugger core_mask、物理/逻辑核映射、通用区间/tile 切分、输出所有权、屏障与内存可见性
ddr-multicore-guide.md Designer/Developer/Reviewer/Debugger DDR 36 位地址、每核 AM、函数分层,以及 DMA 与多核的组合规则
optimization-barrier-guide.md Designer/Developer/Reviewer @bar 的 S/V MVCGC 上下文依赖规则、@mdep 边界及审查门禁
stack-abi-guide.md Developer/Reviewer R63:R62、R30..R41、AR7/AR14/AR15 的动态最小保护与内存栈失败规则
usage-checklist.md Designer/Developer/Reviewer 易错指令使用模式 + 覆盖审计清单
operator-interface.md Developer 算子需求确认/函数模板/尾数处理
library-verification.md Designer/Developer/Reviewer math.la/csl.la 库函数 + 编译验证流程 + 测试验证
FT-M7004V_DSP_INST.md 所有角色 完整指令集(735KB,默认精确查阅,兜底可全文通读)

库函数

math.la — 数学库

函数 功能 用法
sdiv 整数除法 @icall sdiv, a, b, = q, r
vfdivs32 向量浮点除法 @icall vfdivs32, vr_a, vr_b, = vr_c
vfsqrts32 向量平方根 @icall vfsqrts32, vr_a, = vr_res
vreduc16_sum_fp32 浮点向量求和 @icall vreduc16_sum_fp32, vr_a, = sum
vfsins32 向量正弦 @icall vfsins32, vr_x, = vr_res
vfcoss32 向量余弦 @icall vfcoss32, vr_x, = vr_res

csl.la — 系统控制库

函数 功能 用法
get_am_addr 获取核AM地址 @icall get_am_addr, = am_l, am_h
get_ddr_addr 获取DDR地址 @icall get_ddr_addr, = ddr_l, ddr_h
get_core_id 获取核ID @icall get_core_id, = core_id
config_prir DMA 逻辑通道优先级 @icall config_prir, priority_mask
DMA_Config 配置 DMA 逻辑通道 @icall DMA_Config, log, src_l, dst_l, src_index, dst_index, src_num, dst_num, src_h, dst_h
DMA_start / DMA_check 按 bitmask 启动/等待并清完成位 用于同步搬移和 A/B 双缓冲流水
sys_bar 多核栅栏同步 @icall sys_bar, id, num

关键约束

约束 说明
CVCCR配置 使用向量运算前必须配置:SMOVIL 3, R0; SMVCGC R0, CVCCR; SNOP 5
AM空间限制 向量 ldst 只能访问 AM 空间,DDR/GSM 张量需经 DMA 和每核 CORE_AM 数据分块缓冲区 staging
参数对传递 C接口:指针用X_l/X_h,32位标量用val/__val
寄存器对顺序 高位在前:r1:r0
条件寄存器 最多3个(R0-R2),内联函数计入总数
偏移量限制 >15必须用OR寄存器
地址寄存器 向量ldst用AR0-AR7,标量ldst用AR8-AR15
VREDUC 不支持浮点归约,浮点用库函数
SMOVIL/SMOVIH 必须成对使用同一寄存器
混合精度 同一普通计算节点先用 FT-M7004 显式转换指令对齐到最高计算精度,再计算/累加;fp16/bf16 核对 HP16_mode、RoundMode 和 half lane;仅显式输出、cast 或量化节点允许降精度

License

MIT

关于

让AI agent和大模型自动将高级语言生成7004线性汇编代码,以提高DSP代码性能、简化程序员对线性汇编和汇编编程的学习成本,使DSP编程变得更简单。

5.8 MB
邀请码
    Gitlink(确实开源)
  • 加入我们
  • 官网邮箱:gitlink@ccf.org.cn
  • QQ群
  • QQ群
  • 公众号
  • 公众号

版权所有:中国计算机学会技术支持:开源发展技术委员会
京ICP备13000930号-9 京公网安备 11010802047560号