User`s manual
the Pi provides, you may kill the driver after running GSport with sudo killall a2joy. To get
GSport to use the native Linux joystick, enter the GSport Configuration Panel with F4 (SolidApple+4),
go to the joystick configuration, and select "Native Joystick 1".
Apple II storage media:
Another exciting feature of the Apple II Pi is access to the underlying Apple II storage media from
Linux. To facilitate the access from GSport, raw device files that look like normal Linux files but in
actuality map to the physical devices underneath are made available. GSport can use the raw device
files to gain access to the physical media, although with a performance hit (it is, after all, running on
real Apple II hardware at 1 MHz). GSport can be configured to use files for different disk mappings
through the config.txt file or through the F4 Configuration Panel. There is no requirement that Apple II
Pi devices have to mapped to the same GSport slot/drive device. The FUSE driver has an option to
make the raw device files write-able; by default they are read-only. This can be very dangerous, as
Linux thinks it has exclusive use of the file system. If GSport has write access to the device file, it is
best to stay out of the Linux mapped ProDOS file system until GSport has exited.
GSport exit:
Apple II Pi and GSport work together to provide an experience closer to an accelerated Apple IIgs than
an emulator running in a window on a foreign machine. Be careful, it is actually hard to differentiate
which environment you are really running. Take a moment before you just switch off the power when
you are done! Always exit GSport with SolidApple+OpenApple+4 (ALT+F4), then shutdown Linux
with:
sudo halt
Apple II User:
There is a special user account that can quickly launch the GSport full screen emulator and halt Apple
II Pi on exit that makes the Apple II Pi behave more like a traditional Apple II accelerator. Simply login
in as username: apple2 with an empty password. The default GSport environment will be run. If you
don’t have the pre-configured SD card, the apple2 user can be installed with:
sudo apt-get install apple2user
Exit the emulator with the ALT-F4 (OpenApple+ClosedApple+4) key combination. This will shut the
Apple II Pi down safely.
18
18