IOP16 Assembler

IOP16 Assembler

• The CPU has an Assembler
• The Assembler is written in Python 3
  • Python code is located here
• There's also a Windows executable if you don't have Python 3 installed on your computer
  • Executable located here

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

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

• YouTube Video Series.
• Documentation slides are here (LibreOffice Impress Open document format).