User`s manual

Part IV: GSport Apple IIgs Emulator.
This section describes the GSport GS emulator enhanced functions for usage with Apple II Pi. There
are two options for running GSport: If you want a full-screen, immersive experience, the gsportfb
emulator is run from the console. When running the X GUI, the gsportx emulator is run in a window
alongside other X applications. By using the gsport command, the appropriate binary for the current
environment will be run: gsportfb for console, gsportx for X desktop. See http://gsport.sourceforge.net
for further information. The default configuration includes the Internet Starter Kit from Ewen Wannop.
You can get more information from his website at:
http://www.wannop.info/speccie/Site/Speccies_Home_Pages.html
Installation:
The GSport emulator can be installed with:
sudo apt-get install gsport
Keyboard Input:
Although it appears you are using an Apple II keyboard on an Apple II, in reality you are using a Linux
keyboard that just so happens to be an Apple II keyboard on a GS emulator running in Linux. To make
the Apple II keyboard useable under Linux, some of the key functions are different than when used as
just a Apple II. The mappings are mostly the same, but a few of the differences are noted below.
The Delete key has been mapped to BACKSPACE for Linux. To get the expected DELETE key
function under GSport, use the SolidApple+DELETE to get the $7F (DEL) character.
The OpenApple key is mapped to ALT, which GSPort maps back to OpenApple, so most operations
that use OpenApple should work as expected.
The SolidApple key is mapped to a Function key modifier. GSport will map F2 to SolidApple
(Option), which is SolidApple+2 on the Apple II Pi keyboard.
The Apple IIgs has a Control Panel that is accessed with OpenApple+CONTROL+ESC. To get this to
work under GSport and Apple II Pi, the sequence OpenApple+SolidApple+ESC is substituted to get
the Control Panel to open.
When running the full-screen frame-buffer GSport emulator, the only way to cleanly exit the emulator
is with ALT+F4 (SolidApple+OpenApple+4).
Joystick Input:
When running the full-screen frame-buffer GSport emulator, the only way to cleanly exit the emulator
is with ALT+F4 (SolidApple+OpenApple+4) or click on the X (close) button on the title bar.
It is very exciting to be able to provide a Linux joystick driver for Apple II joysticks. The Apple II
joystick will operate under GSport exactly like it does when running on Apple II hardware. The a2joy
driver works with Apple II Pi and the Linux input subsystem to provide joystick events to applications.
The a2joy driver can be set up to automatically start when the computer boots, or manually run before
GSport is started. To run manually, type sudo a2joy from the command line. The a2joy driver runs
constantly in the background to poll the joystick. It is very low overhead, but if you need every cycle
17
17