Digirule2系列硬件的汇编程序和仿真工具链。
dgtools的Python项目详细描述
dgtools公司
dgtools是一个完整的工具包,用于为Digirule开发软件
由bradsprojects提供的硬件系列(2A/2U
)。在
概述
- 在
dgasm
- 汇编程序接受一个人类可读的
.asm
文本文件,其中包含Digirule ASM和 生产:- 一个
.dgb
二进制文件,其已编译代码可供dgsim.py
模拟。在 - 一个
.hex
文件(在2U的情况下)下载到线路板。在
- 一个
- 汇编程序接受一个人类可读的
- 在
dginspect
- 二进制文件“inspector”接受一个
.dgb
二进制文件并生成一个人类可读的文件 “转储”完整的256字节内存范围到标准输出。它还允许用户应用 在不重新编译的情况下修改内存空间。在
- 二进制文件“inspector”接受一个
- 在
{cd9}
- Digirule虚拟机接受
.dgb
二进制文件并生成:- 一个人类可读的HTML(主题化)跟踪,记录CPU在每个状态下所经历的每一个状态变化 执行的时间步骤。在
- 一个附加的
.dgb
文件,它包含在 程序执行。在
- Digirule虚拟机接受
这些工具一起工作来编写、调试和模拟Digirule2的代码,然后再将其传输到 实际硬件。在
dgtools
还包括一些“附加功能”,例如一个崇高的文本.dsf
ASM插件,一个可以处理的控制台gui(dgui
)
一步编译/模拟和代码格式化程序(dgform
)。在
最常见的工作流程是:
- 使用文本编辑器编写可读的程序集代码。在
- 调用
dgasm.py
来编译二进制文件 - 调用
dgsim.py
运行并调试二进制文件 - (或者,调用
dgui
按顺序执行上述两个操作) - 使用
dginspect.py
检查二进制文件,从虚拟机获取/设置值或键入代码。在
安装
先决条件
- Linux系统
- Python>;=3.6
- ^{
}
从PyPi安装pip
pip install dgtools
安装最新开发版本
- 签出dgtools存储库
> virtualenv -p python3.8 pyenv
> source pyenv/bin/activate
- 要开始使用
dgtools
,请执行以下操作:pip install -e ./
(从包含setup.py
文件的dgtools/
目录中)- 这将使
dgtools
脚本可以从文件系统中的任何位置调用,只要pyenv
虚拟环境已激活。在
- 如果您对进一步开发
dgtools
感兴趣:pip install -r requirements.txt
从这里到哪里去?在
dgtools
文档在ReadTheDocs上,当然
在doc/
中。在
中提供了如何使用dgtools
的实际示例
this introductory walkthrough。在
一旦您熟悉了这些工具和Digirule的ASM,您可能想转到
the advanced walkthrough或
查看其他programming examples
在dg_asm_eamples/
中。在
享受吧!在
阿萨纳西奥·阿纳斯塔西奥
- 项目
标签: