IOP16 Assembler

From Land Boards Wiki
Revision as of 20:08, 16 April 2022 by Blwikiadmin (talk | contribs) (→‎Compilating to Windows executable)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

IOP16 Assembler

Assembler - Windows executable

  • Windows executable is in this folder
  • Useful for people who don't have Python 3 installed

Compile Windows executable

  • Compile to make executable using command in DOS window
pyinstaller --onefile pyAssemble_cpu_001.py

Files

Input fileName.csv

  • Input file is tightly constrained in CSV file
    • Input File Header has to be
['LABEL', 'OPCODE', 'REG_LABEL', 'OFFSET_ADDR', 'COMMENT','V3.0.0']

Memory Map File

  • Optional File named: fileName_MMAP.csv
    • Memory map file Header has to be
['IO_ADDR','DIR','MNEUMONIC']
  • IO_ADDR = 0XNN
  • DIR = R, W, or RW
    • Ex: ['0X00','R','LED_RD']

Constants file

  • Useful for storing arrays of constants
    • Ex: print strings
  • Optional File named: fileName_CONST.csv
  • Constants file Header has to be -
['LABEL','STRING']

Output files

  • inFileName_ROM.mif file - Quartus II ROM Memory Initialization File
  • inFileName.lst file - Listing file (with addresses)
  • constFileName_const.mif - Quartus II Constants Memory Initialization File

Error Messages

  • Error messages are pretty rudimentary
  • Dialog box notes that error messages are printed to the command window
  • The line with the error is printed as a list of the line
  • Missing labels are presented as a message
  • Only one error at a time is presented
  • Set variable in source code to enable debugging messages
verbose = True

Assembler opcodes

Opcodes.PNG

Assembler Psuedo-opcodes

  • NOP - No operation
  • HLT - Halt (Jump to self)
  • BEQ - Branch if equal (same as BEZ)
  • BNE - Branch if not equal (Aame as BNZ)

Documentation