ep.lgb.hu :: Enterprise-128 EXOS file analyzer, lister and disassembler

This software can be used to analyze, list and disassemble Enterprise-128 EXOS files (or EXOS_ROM / raw binary files/images) on a PC. This means IS-BASIC, IS-FORTH, WP and ML programs.
It includes the character set conversion to UTF-8, the possibility to turn on "hex debug", and "info mode" and to choose between text or html output.
The script itself can also dump its internal "database" (conversion DB) so you can examine basic tokens and the character set(s) used on the Enterprise and other internal informations (Z80 opcode table, EXOS functions, EXOS file types, I/O ports, etc).
The name "EPBAS" came from the original functionality: list IS-BASIC programs, and nothing more.

Download, usage, documentation

DOWNLOAD: Download the converter (v0.5.8)!
In theory it should work with python2 and python3 as well, though I am using mainly python2. It's possible that older python2 version does not work, try with python2.7.
After download, you should check the README file out in the ZIP or you can visit the "Documentation" link here, below.
If you want only a quick preview, I recommend the "USE IT ONLINE" mode below, or you can visit the pages below with example outputs.
TRY/USE IT ONLINE: Click here to do so.
You can test/use this software this way without any installation on your PC, especially useful if you want to test the project, or you don't need it too often.
Documentation
Description of the project, copyright, installation and usage information.
This file is basically the same as the README file in the downloadable ZIP, only formatted differently.

Internal DB dumps

These modes are not about the conversion, but to show internal information used by the software. You can read the actual command line after the examples was used to generate these files. These information can be even useful for other projects without any dependency on this one.

Output of conversion DB dump
python epbas.py -db > result-dist-db.txt
This allows you to check the used data tables out, eg BASIC tokens, character sets (for a better view, check the next link out too), EXOS functions and supported file types, I/O ports.
NEW: Dump of known character sets of the converter [in HTML format]
python epbas.py -chset > result-chset.html
NEW: Dump of Z80 opcodes [in HTML format]
python epbas.py -z80ops > result-z80ops.html

Example outputs

Example outputs. You can read the actual command line after the examples was used to generate these files. The first IS-BASIC examples shows many different modes to display a BASIC program, later examples focuses only on the "most used" mode suitable for the web (you may want to use text mode if you need the output to work with, though).

Output sample for HTML with info mode turned on (IS-BASIC program)
python epbas.py -html -info -out=result-dist-list.html TEST.BAS
Output sample for TEXT with info mode turned on (IS-BASIC program)
python epbas.py -info -out=result-dist-list.txt TEST.BAS
Output sample for HTML with HEX debug and info mode turned on (IS-BASIC program)
python epbas.py -html -info -hex -out=result-dist-hex-list.html TEST.BAS
Output sample for TEXT with HEX debug and info mode turned on (IS-BASIC program)
python epbas.py -info -hex -out=result-dist-hex-list.txt TEST.BAS
NEW: Output sample for HTML with HEX debug and info mode on a WP file
python epbas.py -info -html -hex -out=result-editor.html TEST.WP
For cleaner output you can skip -hex.
NEW: Output sample for HTML with info mode on type-5 (user ML) file
python epbas.py -html -info -hex -out=result-dasm.html TEST.COM
Note: disassembly is also supported, see below.
NEW: Output sample (HTML) on disassembly mode of type-5 stuff
python epbas.py -html -info -hex -dasm -out=result-dasm-real.html TEST.COM
NEW: Output sample (HTML) introducing IS-FORTH support
python epbas.py -html -info -out=result-forth.html TEST4.4TH
NEW: Output sample (HTML) EXOS_ROM disassembly
python epbas.py -html -info -dasm -out=result-exosrom.html tpt.rom

Any help/feedback is welcome!