Apple-2-Tools/gsplus
1
0
Fork 0
mirror of https://github.com/digarok/gsplus.git synced 2024-11-24 06:34:02 +00:00
Code Issues Projects Releases Wiki Activity

test package paths

Browse Source
This commit is contained in:
Dagen Brock 2016-10-27 22:52:02 -05:00
parent 9baa24c73a
commit 76d61e3fce
3 changed files with 82 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitlab-ci.yml
View File

@ -27,6 +27,7 @@ package-ubuntu-x:
paths: paths:
- gsplusx - gsplusx
- config.txt - config.txt
- doc/gsplusmanual.txt
build-ubuntu-sdl: build-ubuntu-sdl:

BIN
doc/gsplusmanual.pdf
View File

Binary file not shown.

146
doc/gsplusmanual.txt
View File

@ -1,33 +1,38 @@
gsplus _______ _______ _
gsp_icon_128.png | || | _| |_
| ___|| _____||_ _|
| | __ | |_____ |_|
| || ||_____ |
| |_| | _____| |
|_______||_______|
GSplus
Modern cross-platform Apple IIgs emulator and tools based on KEGS Modern cross-platform Apple IIgs emulator and tools based on KEGS
Manual Version: Initial Draft
Date: 2016-05-01 Manual Versions: Alpha Draft: 2016-10-27, Initial Draft: 2016-05-01
Overview & Purpose Overview & Purpose
This is an early release of an experimental project to modernize the KEGS/GSport emulator platform and eventually extend it. This project is an attempt to build a better Apple IIgs emulator by modernizing the KEGS/GSport emulator family and extending it into a platform.
The first steps are represented here. This release features a new SDL2 driver. SDL or "Simple DirectMedia Layer" enables the writing of one cross-platform driver to handle input and output (video, mouse, keyboard, audio, joystick). The hope is that I can leverage the multi-platform nature of SDL to provide first-class support for the major platforms supported by SDL, which includes Mac OSX, Windows and Linux. The first steps were a release of a new SDL2 driver. SDL or "Simple DirectMedia Layer" enables the writing of one cross-platform driver to handle input and output (video, mouse, keyboard, audio, joystick). This helps the goal of providing first-class support for all of the major platforms supported by SDL, including Mac OSX, Windows and Linux.
Currently, five builds are being supported: Part of this effort has also led to the development of an automated build and packaging pipeline using Gitlab CI. This helps our team of one continue to develop on primarily a single platform, while still ensuring that it works across many operating systems
* OSX (SDL2 driver) Currently, the main supported platforms are Linux, OSX and *Windows. *Unfortunately the SDL2 version of Windows is not done as of this draft, but the Win32 API version still works well and is regularly built, though missing some features like screenshots.
* Ubuntu (SDL2 driver)
* Ubuntu (SDL driver)
* Ubuntu (X11 driver)
* Window (Win32 driver)
There are more platforms still in the codebase, and some, like Raspberry Pi will probably be added to official support. But I may drop some of the older platforms like OS/2.
________________ ________________
Getting started Getting started
1. Download the emulator and put it in a folder 1. Download the emulator package and put it in a folder
2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine. (If you have a real IIgs, there are ways to save it from your machine as well.) 2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine. (If you have a real IIgs, there are ways to save it from your machine as well.)
3. Download some Apple IIgs software. (I recommend the excellent Apple IIgs dedicated site, http://www.whatisthe2gs.apple2.org.za/ ) 3. Download some Apple IIgs software.
(If you have a real IIgs, you can transfer your disks using ADTPro http://adtpro.sourceforge.net/ ) 1. I recommend the excellent Apple IIgs dedicated site, http://www.whatisthe2gs.apple2.org.za/
4. Edit your config: 2. If you have a real IIgs, you can transfer your disks using ADTPro http://adtpro.sourceforge.net/
1. By hand… edit the config file (config.txt, config.gsplus, or .gsplus) 1. Edit your config:
1. You can manually edit the config.txt file … OR ...
2. While the emulator is running… hit F4 to enter config menu. 2. While the emulator is running… hit F4 to enter config menu.
1. Boot the Apple IIgs by running the emulator 1. Boot the Apple IIgs by running the emulator
1. Windows: gsplus.exe 1. Windows: gsplus.exe
2. Mac/Ubuntu: ./gsplus 2. Mac/Ubuntu: ./gsplus
Emulator Hot-Keys Emulator Hot-Keys
There are several keys used to interact with the emulator while it is running. Here’s a quick list of the main hot-keys and what they do. There are several keys used to interact with the emulator while it is running. Here’s a quick list of the main hot-keys and what they do.
F4 - Configuration menu F4 - Configuration menu
@ -37,18 +42,19 @@ F7 - Toggle Fast Disk Emulation
F9 - Invert Paddles F9 - Invert Paddles
F10 - Toggle a2vid_palette (?) F10 - Toggle a2vid_palette (?)
F11 - Toggle Fullscreen Mode F11 - Toggle Fullscreen Mode
F12 - RESET Key (i.e. - “Ctrl-F12” = “Ctrl-Reset” on an Apple II) F12 - RESET Key (so to hit “Ctrl-Reset” on an Apple II, you hit “Ctrl-F12”)
Other Input/Output SHIFT+F5 - Screenshot
1. Mouse and keyboard should automatically work
2. Joystick with SDL2 driver is known to be working. The axes and buttons are not yet configurable. Better info forthcoming.
3. There are drivers for serial controller, ImageWriter (II?) printer, and networking. I’m not currently familiar with the state of these drivers or their usage. More info will be added as I take time to research more of the modules.
Configuration Menu
Enter the configuration menu at any time while running gsport by hitting <F4>.
The configuration options are loaded from, and saved to, a configuration text file. The file can be named one of the following: config.txt, config.gsplus, or .gsplus.
If you are just starting out, it’s recommended to use the configuration menu versus editing the file yourself.
Screen Shot 2016-05-01 at 9.10.00 AM.png
Most important, you can use the Disk Configuration menu option to “mount” and “eject” disks. Other Input/Output
1. Mouse and keyboard should automatically work
2. Joystick with SDL2 driver is known to be working. It simply uses the “first” joystick and the first analog pad on that stick plus the first two buttons. The axes and buttons are not yet configurable. Better info forthcoming.
3. There are drivers for serial controller, ImageWriter (II?) printer, and networking. I may have broken some of this functionality to get builds working. I’m not currently familiar with the state of these drivers or their usage. More info will be added as I take time to research more of the modules.
Configuration Menu
Configuration options are loaded from, and saved to, a configuration text file. The default configuration file is config.txt. If you are just starting out, it’s recommended to use the configuration menu versus editing the file yourself.
Enter the configuration menu at any time while running GSplus by hitting <F4>.
Most importantly, you can use the Disk Configuration menu option to “mount” and “eject” disks.
Command-line Options Command-line Options
This is from source, some are experimental and not all may be built on your system. This is from source, some are experimental and not all may be built on your system.
-badrd Halt on bad reads -badrd Halt on bad reads
@ -72,6 +78,7 @@ This is from source, some are experimental and not all may be built on your syst
-display value Set X-Windows DISPLAY=value -display value Set X-Windows DISPLAY=value
-enet value Set ethernet to value -enet value Set ethernet to value
-config value Set config file to value -config value Set config file to value
-debugport value Set debugport to value
Note: The final argument, if not a flag, will be tried as a mountable device. Note: The final argument, if not a flag, will be tried as a mountable device.
@ -81,47 +88,50 @@ Note: The final argument, if not a flag, will be tried as a mountable device.
Debugger Commands Debugger Commands
Enter from the debugger prompt (Shift-F6) Enter from the debugger prompt (Shift-F6)
GSport Debugger help (courtesy Fredric Devernay) GSplus CLI Debugger help (courtesy Fredric Devernay)
General command syntax: [bank]/[address][command] General command syntax: [bank]/[address][command]
e.g. 'e1/0010B' to set a breakpoint at the interrupt jump pt e.g. 'e1/0010B' to set a breakpoint at the interrupt jump pt
Enter all addresses using lower-case. As with the IIgs monitor, you can omit the bank number after having set it: 'e1/0010B' followed by '14B' will set breakpoints at e1/0010 and e1/0014 Enter all addresses using lower-case. As with the IIgs monitor, you can omit the bank number after having set it: 'e1/0010B' followed by '14B' will set breakpoints at e1/0010 and e1/0014
g Go g Go
[bank]/[addr]g Go from [bank]/[address] [bank]/[addr]g Go from [bank]/[address]
s Step one instruction s Step one instruction
[bank]/[addr]s Step one instr at [bank]/[address] [bank]/[addr]s Step one instr at [bank]/[address]
[bank]/[addr]B Set breakpoint at [bank]/[address] [bank]/[addr]B Set breakpoint at [bank]/[address]
B Show all breakpoints B Show all breakpoints
[bank]/[addr]D Delete breakpoint at [bank]/[address] [bank]/[addr]D Delete breakpoint at [bank]/[address]
[bank]/[addr1].[addr2] View memory [bank]/[addr1].[addr2] View memory
[bank]/[addr]L Disassemble memory [bank]/[addr]L Disassemble memory
P Dump the trace to 'pc_log_out' P Dump the trace to 'pc_log_out'
Z Dump SCC state Z Dump SCC state
I Dump IWM state I Dump IWM state
[drive].[track]I Dump IWM state [drive].[track]I Dump IWM state
E Dump Ensoniq state E Dump Ensoniq state
[osc]E Dump oscillator [osc] state [osc]E Dump oscillator [osc] state
R Dump dtime array and events R Dump dtime array and events
T Show toolbox log T Show toolbox log
[bank]/[addr]T Dump tools using ptr [bank]/[addr] as 'tool_set_info' [bank]/[addr]T Dump tools using ptr [bank]/[addr] as 'tool_set_info'
[mode]V XOR verbose with 1=DISK, 2=IRQ,4=CLK,8=SHADOW,10=IWM,20=DOC, [mode]V XOR verbose with 1=DISK, 2=IRQ,4=CLK,8=SHADOW,10=IWM,20=DOC,
40=ABD,80=SCC, 100=TEST, 200=VIDEO 40=ABD,80=SCC, 100=TEST, 200=VIDEO
[mode]H XOR halt_on with 1=SCAN_INT,2=IRQ, 4=SHADOW_REG, 8=C70D_WRITES [mode]H XOR halt_on with 1=SCAN_INT,2=IRQ, 4=SHADOW_REG, 8=C70D_WRITES
r Reset r Reset
[0/1]=m Changes m bit for l listings [0/1]=m Changes m bit for l listings
[0/1]=x Changes x bit for l listings [0/1]=x Changes x bit for l listings
[t]=z Stops at absolute time t (obsolete) [t]=z Stops at absolute time t (obsolete)
S show_bankptr_bank0 & smartport errs S show_bankptr_bank0 & smartport errs
P show_pmhz P show_pmhz
A show_a2_line_stuff show_adb_log A show_a2_line_stuff show_adb_log
Ctrl-e Dump registers Ctrl-e Dump registers
[bank]/[addr1].[addr2]us[file] Save mem area to [file] [bank]/[addr1].[addr2]us[file] Save mem area to [file]
[bank]/[addr1].[addr2]ul[file] Load mem area from [file] [bank]/[addr1].[addr2]ul[file] Load mem area from [file]
v Show video information v Show video information
q Exit Debugger (and GSport) q Exit Debugger (and GSplus)
________________ ________________
Project Info Project Info
Developers inquire within :P Developers inquire within :P
Main page and full source code repository: https://github.com/digarok/gsplus Main page and full source code repository: https://github.com/digarok/gsplus
This project has an ugly unmaintained homepaged at http://apple2.gs/plus/ This project has an ugly unmaintained homepage at http://apple2.gs/plus/