Go to file
Yanyan Jiang 1173fc6d21 Merge branch 'syscall-args' into 'master'
am,asye: use macros `SYSCALL_ARGx()` to get syscall arguments

See merge request !136
2017-08-09 12:28:16 +08:00
am am,asye: use macros `SYSCALL_ARGx()` to get syscall arguments 2017-08-08 17:15:45 +08:00
apps am,asye: use macros `SYSCALL_ARGx()` to get syscall arguments 2017-08-08 17:15:45 +08:00
libs libs,klib,string: remove assert 2017-07-23 11:48:05 +08:00
tests Implemented riscv32-emu Turing machine. 2017-08-06 11:17:48 +08:00
.gitignore correct scanline 2017-05-28 07:38:52 -04:00
Makefile Makefile: clean all builds 2017-07-28 11:30:58 +08:00
Makefile.app fix makefile 2017-06-04 07:15:47 -04:00
Makefile.check Makefile: really set the default value of ARCH to native 2017-06-06 00:02:49 +08:00
Makefile.compile Merge branch 'riscv32-emu' of https://git.njuics.cn/syslab17/nexus-am into riscv32-emu 2017-08-06 11:26:55 +08:00
Makefile.lib Makefile.lib: add -fno-builtin while compiling lib 2017-06-12 19:53:17 +08:00
README.md update proj readme 2017-07-07 04:24:15 -04:00
SPEC.md am,asye: use macros `SYSCALL_ARGx()` to get syscall arguments 2017-08-08 17:15:45 +08:00

README.md

The Abstract Machine (AM)

抽象计算机:必要的抽象,帮你编写一个完整的计算机系统!

目录组织:

  • am/AM头文件、每个体系结构分别实现的AM代码。
  • libs/建立在AM上、体系结构无关的运行库如软件模拟浮点数、基础libc功能等。
  • apps/一些运行在AM上应用程序示例。
  • tests/: 用来测试AM实现的简单测试程序。

AM Specification

参考:AM Specification

创建一个AM应用

在任何目录都可以创建运行在AM上的应用程序。程序用C/C++语言编写除AM之外无法调用其他库函数但可以引用stdarg.h, limits.h等包含体系结构相关数据定义的头文件)。

为此你需要在应用程序项目的根目录添加一个Makefile

NAME = app-name
SRCS = src/main.c src/help.c src/lib.cpp
include $(AM_HOME)/Makefile.app

一些注意事项:

  • NAME定义了应用的名字。编译后会在build/目录里出现以此命名的应用程序。

  • SRCS指定了编译应用所需的源文件。可以放在应用目录中的任意位置。

  • 应用目录下的include/目录会被添加到编译的-I选项中。

  • 环境变量AM_HOME需要包含nexus-am项目的根目录的绝对路径

编译时,首先确保AM_HOME正确设置,然后执行make ARCH=体系结构名编译。例如make ARCH=native将会编译成本地可运行的项目,make ARCH=mips32-minimal生成用于仿真的MIPS32程序。ARCH缺省时默认编译到本地。