gigatron/rom/Contrib/at67/tools/gtbasic/README.md
2025-01-28 19:17:01 +03:00

1.6 KiB

gtasm

Takes a .vasm or .asm or .s assembly file, (vCPU), and assembles it into a .gt1 output file.

Building

  • CMake 3.7 or higher is required for building, has been tested on Windows with Visual Studio and gcc/mingw32
    and also built and tested under Linux.
  • A C++ compiler that supports modern STL.

Usage

gtasm <input filename> <start address in hex>

Address

The address, (specified in hex), is the start address of the vCPU assembly code.

Output

gtasm outputs a standard .gt1 file, containing the start address and segments of the assembled code.

Logging

Warnings and errors are output to stderr, (console under main window in Windows).

Example

gtasm starfield.vasm 0x0200

************************************************************
* starfield.gt1 : 0x0200 :   787 bytes :   9 segments
************************************************************
* Segment :  Type  : Address : Memory Used
************************************************************
*     0   :  RAM   : 0x00e0  :    16 bytes
*     1   :  RAM   : 0x0200  :    88 bytes
*     2   :  RAM   : 0x0300  :   169 bytes
*     3   :  RAM   : 0x0400  :   182 bytes
*     4   :  RAM   : 0x0500  :   144 bytes
*     5   :  RAM   : 0x0590  :    16 bytes
*     6   :  RAM   : 0x05a0  :    48 bytes
*     7   :  RAM   : 0x08a1  :    50 bytes
*     8   :  RAM   : 0x09a1  :    74 bytes
************************************************************
* Free RAM after loading: 44763
************************************************************