This repository contains cdm8e processor implemented in logisim, cdm8e assembler and cdm8e emulator.
- Install python 3.10 or higher, VS Code and logisim
- Download logisim circuit and python package
- Install python package (
pip install cdm8-0.1.0-py3-none-any.whl
) - Install cdm8-asm VS Code extension
- Go to VS Code preferences, search from
cdm
and set ABSOLUTE path tocdm_asm
andcdm_emu
- Next steps are needed only if you want to debug programs in logisim
- Download logisim debug library
- Build you circuit with cdm8e. Circuit must meet following requirements
- Circuit must use
logisim_debug
library - Cdm8e must be on top level
- Circuit should have exactly one
debug ROM
and onedebug RAM
example circuit
- Circuit must use
- Open
.asm
file in VS Code - Open command palette (
Ctrl+Shift+P
by default) and typeSelect and start debugging
- Select
Cdm8 debugger
- Select
Emulator current file
- Open your circuit in logisim
- Select
Cdm8e debug -> Debug tool
on tool panel. A message indicating that server has started should appear - Repeat steps from previous paragraph, except on the last step choose
Logisim current file
Documentation for cdm8e architecture and assembler is here