Skip to content

Latest commit

 

History

History
76 lines (49 loc) · 2.59 KB

guide.md

File metadata and controls

76 lines (49 loc) · 2.59 KB
Raw

Quick start guide

Run a trom application in pygame frontend:
./pyg_sbtcvm.py maze

Start SBTCVM XAS interactive shell:
./xas.py

Start TUI Shell (SBTGSH) (PYGAME FRONTEND ONLY):
./pyg_sbtcvm.py sbtgsh

Start GUI 'desktop' (SBTCVM BENCH) (PYGAME FRONTEND ONLY):
./pyg_sbtcvm.py bench

Start SBTCVM DOS:
./pyg_sbtcvm.py dos

Boot into VDI shell (unfinished):
./pyg_sbtcvm.py

Run a trom application in curses frontend:
./cur_sbtcvm.py maze

Notice: curses frontend is somewhat buggy & incomplete. pygame frontend HIGHLY recommended.

Failing both curses and pygame, a barebones, (non-interactive) frontend, the bare frontend is available:

./bare_sbtcvm.py counttestprint

where does SBTCVM search for applications and source code?

In order (non-bold text describes what applications & source code is kept there)

  • vmsystem: assembler standard libs.
  • vmsystem/roms: system roms live here.
  • roms: quite a lot of test troms.
  • apps: Interactive trom applications.
  • demos: a variety of demos, showing off SBTCVM's graphical capabilities.
  • vmuser: your personal directory.

Notes:

  • Any directory within these, prefixed with r_ Will have its contents in the path. i.e. r_standard_lib in vmsystem
  • Most trom applications & demos use auto directories. where a directory name can be used as an argument for a certain SBTCVM filetype, if it contains a file of that type prefixed with auto_

XAS help has more information on working with directories.

where should i install 3rd party trom apps and assembler libraries?

  • vmuser

more information:

  • SBTCVM Technical Glossary A, markdown-based, Glossary of various technical terms used in SBTCVM.

  • SBTCVM Help Index A, markdown-based, set of help documents (main index)

  • XAS help Help on SBTCVM's XAS shell/build script system, with detailed command listing.

  • The textdocs directory in this repository contains both technical and user documentation.

  • textdocs/SSTNPL contains documentation to the SSTNPL programming language.

  • apps/directory.txt in this repository, has a guide on the TROM applications available there.

Before filing bug reports, read the troubleshooting guide:

Links: