GitHub - suborb/s1mulator: s1mp3 simulator - resurrected from archive.org

suborb / s1mulator Public

Notifications You must be signed in to change notification settings
Fork 0
Star 2

s1mp3 simulator - resurrected from archive.org

Notifications

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
Changelog.txt		Changelog.txt
Makefile		Makefile
README.txt		README.txt
backlight.cpp		backlight.cpp
backlight.h		backlight.h
cross-mingw32.sh		cross-mingw32.sh
display.cpp		display.cpp
display.h		display.h
dma.cpp		dma.cpp
dma.h		dma.h
hexview.cpp		hexview.cpp
hexview.h		hexview.h
include.h		include.h
main.cpp		main.cpp
memory.cpp		memory.cpp
memory.h		memory.h
nand.cpp		nand.cpp
nand.h		nand.h
port.cpp		port.cpp
port.h		port.h
runctrl.cpp		runctrl.cpp
runctrl.h		runctrl.h

Repository files navigation

s1mulator v0.5.0 Copyright (c) A. J. Buxton <a.j.buxton@gmail.com>. 
This software is licensed under the GPL.

Z80 core emulation Copyright (c) 2006, BlueChip of Cyborg Systems
See z80.c for more information.

This is an emulator for the S1MP3 media player.

It can currently emulate a Z80 core with an attached LCD display.

Requirements
------------

wxWidgets development packages with wxGLCanvas support.

z88dk - to compile the example asm.

Compiling
---------

Linux users should just do a 'make'

If you are cross-compiling using a Linux host, look at cross-mingw.sh.

If you want to build a source tarball and windows zip packages from a
SVN working copy (and you have all the dependancies) then just do 
'make dist'.

Compiling natively under Windows is not yet supported.

Usage
-----

s1mulator [-h] [-D <columns>,<pages>,<pport>,<ppin>,<pinv>,<mport>,<mpin>,<minv>] \
               [-B <rport>,<rpin>,<rinv>,<rport>,<rpin>,<rinv>,<rport>,<rpin>,<rinv>] \
               [-b <filename>[,<offset>]] [-e <str>] [-t <str>]

  -h, --help            Display usage info

  -D, --display=<...>   Parameters for connected display. All must be provided.
                        
        <columns> - Columns of the display. Equal to the number of horizontal pixels.
        <pages>   - Pages of the display. Vertical pixels / 8 for mono displays.
        <pport>   - Port which the power control line is mapped to.
        <ppin>    - Pin of <pport> which is connected to the display.
        <pinv>    - Whether the power control line is inverted.
        <mport>
        <mpin>
        <minv>    - As above, for the command/data mode control line.

  -B, --backlight=<...> Parameters for connected backlight. All must be provided.

        <rport>   - Port which the red backlight is mapped to.
        <rpin>    - Pin of <rport> which is connected to red backlight.
        <rinv>    - Whether the red backlight line is inverted.
        <gport>   - 
        <gpin>    - 
        <ginv>    - 
        <bport>   - 
        <bpin>    - 
        <binv>    - As above, for the green and blue backlights.

  -b, --bin=<...>       Load <filename> into memory at <offset>, or 0 if 
                        no offset given. If 0x8000, load into brom memory.

  -e, --execute=<str>   Initial execution offset.

  -t, --trap=<str>      Trap address. Execution will stop when reached.

Individual params should be separated by "," and there must be no spaces. 

 <*port> should be a number between 0 and 0xff.
 <*pin> should be one of 0x01, 0x02, 0x04, 0x08, ..., 0xf0.
 <*inv> should be 0 if false or 1 if true.

All numerical arguments may be specified in any format accepted by a C compiler.

Example: (These are also the default display and backlight settings.)

./s1mulator -D 140,6,0xf4,0x01,0,0xf4,0x04,0 \
            -B 0xee,0x01,1,0xee,0x02,0,0xee,0x04,0 \
            -b test.bin,0x3400 -e 0x3400

You should see a counting pattern on the simulated LCD, and the backlight 
should cycle colours.

You can use the "View" menu to show various information about the current 
machine state.