Update readme.md

This commit is contained in:
Auios 2024-02-20 19:15:24 -05:00
parent 64a98f6add
commit 4af1b92d05

View File

@ -4,20 +4,20 @@ For a list of instructions, see [instructionList.txt](instructionList.txt).
## How to use the assembler: ## How to use the assembler:
1. Install `bllua3` from [https://notabug.org/redo/bllua3](https://notabug.org/redo/bllua3) 1. Install `bllua3` from [https://notabug.org/redo/bllua3](https://notabug.org/redo/bllua3)
2. Download this repo into one of Blockland's main directories. (`Add-Ons` or `base` for example) 2. Download this repo into `Add-Ons/8608` or anywhere within one of Blockland's main directories.
3. In BL console, execute: 3. In BL console, execute:
``` ```
luaexec("Add-Ons/_misc/8608/assembler-8608.lua"); luaexec("Add-Ons/8608/assembler-8608.lua");
``` ```
4. To assemble a program, place a 1x1f ghost brick on the top-left corner of the ROM, face forward, and in BL console do: 4. To assemble a program, place a 1x1f ghost brick on the top-left corner of the ROM, face forward, and in BL console do:
``` ```
AssembleBuildFile("Add-Ons/_misc/8608/examples/program.asm", "RomX RomY RomZ"); AssembleBuildFile("Add-Ons/8608/examples/program.asm", "RomX RomY RomZ");
``` ```
where `RomX` is the width of the ROM, `RomY` is the depth front to back, and `RomZ` is the height in bits, i.e., "16 16 8". where `RomX` is the width of the ROM, `RomY` is the depth front to back, and `RomZ` is the height in bits, i.e., "16 16 8".
You can also run the assembler from the command line to get a memory dump and disassembly in stdout, if you have lua installed: You can also run the assembler from the command line to get a memory dump and disassembly in stdout, if you have lua installed:
``` ```
luajit "Add-Ons/_misc/8608/assembler-8608.lua" "Add-Ons/_misc/8608/program/asm.asm" luajit "Add-Ons/8608/assembler-8608.lua" "Add-Ons/8608/examples/program.asm"
``` ```
## How to use the emulator: ## How to use the emulator: