2020-11-29 19:58:03 +00:00
# SA2: Apple ][ Emulator for Linux based on SDL2
This file only lists options not already described in ``-h` `.
2020-12-04 20:02:14 +00:00
## Configuration
There is no GUI to configure the emulator: either manually edit the configuration file ``~/.applewin/applewin.conf`` or use ``qapple`` and run ``sa2 --qt-ini` `.
2020-11-29 19:58:03 +00:00
The format of the configuration file is the same as the Windows Registry of AppleWin.
2021-03-27 20:19:03 +00:00
*Drag & drop* works for floppy disks: they are inserted in Drive 1. If the filename ends with `.yaml` , it will be loaded as a *State* file.
2020-12-04 20:02:14 +00:00
Individual options can be passed via arguments too: ``-c Configuration.Printer_FileName=Printer.txt` `.
If you have a modern gamepad where the axes (``LEFTX`` and ``LEFTY``) move in a circle, the emulator will automatically map to a square: use ``--no-squaring` ` to avoid this.
## Raspberry Pi
2020-11-29 19:58:03 +00:00
On a Raspberry Pi, one needs the KMS (fake or not). Better performance has been observed with the ``opengles2`` driver (use ``sa2 --sdl-driver 1` `).
2021-02-06 17:09:27 +00:00
## Dear ImGui
2021-03-22 08:14:11 +00:00
With the flag ``--imgui``, the rendering is performed with [Dear ImGui](https://github.com/ocornut/imgui). In this case ``--sdl-driver` ` is ignored and a OpenGL ES2.0 implementation is required.
2021-02-06 17:09:27 +00:00
2021-03-19 07:49:10 +00:00
On a Raspberry Pi, a KMS driver is mandatory and best results are obtained on a Pi4 with FullKMS (full screen via ``F6` `).
2021-02-06 17:09:27 +00:00
2021-02-06 17:13:47 +00:00
Output mentions the Dear ImGui version, e.g.: ``IMGUI_VERSION: 1.81 WIP` `.
2021-02-06 17:09:27 +00:00
2020-11-29 19:58:03 +00:00
## Hotkeys
2020-12-06 19:42:00 +00:00
``F2``, ``F5``, ``F6``, ``F9``, ``F11``, ``F12`` and ``Pause` ` have the same meaning as in AppleWin.
2020-11-29 19:58:03 +00:00
2020-12-06 19:42:00 +00:00
``Left Alt`` and ``Right Alt` ` emulate the Open and Solid Apple key.
2020-11-29 19:58:03 +00:00
## Audio
Audio works reasonably well, using AppleWin adaptive algorithm.
Use ``F1` ` during emulation to have an idea of the size of the audio queue
```
Channels: 1, buffer: 32768, SDL: 8804, queue: 0.47 s
Channels: 2, buffer: 45000, SDL: 65536, queue: 0.63 s
```
(1) is the speaker, (2) the Mockingboard.
2020-12-04 20:02:14 +00:00
Speech / phonemes are known to hang the emulator.
2020-11-29 19:58:03 +00:00
## Speed diagnostic
At the end of the run, it will print stats about timings:
```
Video refresh rate: 60 Hz, 16.67 ms
2021-03-21 12:08:30 +00:00
Global: total = 7789.16 ms, mean = 7789.16 ms, std = 0.00 ms, n = 1
Events: total = 22.42 ms, mean = 0.05 ms, std = 0.17 ms, n = 471
Texture: total = 113.32 ms, mean = 0.24 ms, std = 0.06 ms, n = 471
Screen: total = 7624.87 ms, mean = 16.19 ms, std = 1.66 ms, n = 471
CPU: total = 647.21 ms, mean = 1.34 ms, std = 0.48 ms, n = 484
2020-11-29 19:58:03 +00:00
Expected clock: 1020484.45 Hz, 7.74 s
Actual clock: 1014560.11 Hz, 7.79 s
```
- ``events` `: SDL events and audio
- ``texture``: ``SDL_UpdateTexture` `
- ``screen``: ``SDL_RenderCopyEx`` and ``SDL_RenderPresent`` (this includes ``vsync` `)
- ``cpu` `: AW's code
The clock shows expected vs actual speed.
2021-03-22 08:14:11 +00:00
## Debugging
For debugging and profiling (valgrind), it is best to switch off adaptive speed, as otherwise it enters a feedback loop and seems to hang.
Use ``--fixed-speed` `.
