From f271839e8d867cce4623fa0a04345625ff69ab89 Mon Sep 17 00:00:00 2001 From: Leon Styhre Date: Wed, 20 Mar 2024 19:20:36 +0100 Subject: [PATCH] Documentation update --- ANDROID-DEV.md | 25 +++++++------------------ ANDROID.md | 26 ++++++++------------------ FAQ-ANDROID.md | 6 +++--- 3 files changed, 18 insertions(+), 39 deletions(-) diff --git a/ANDROID-DEV.md b/ANDROID-DEV.md index de13ecc44..45bc7490e 100644 --- a/ANDROID-DEV.md +++ b/ANDROID-DEV.md @@ -158,22 +158,7 @@ You can relocate as many systems as you want, you just need to place them all wi ## Issues with the Ayn Odin 2 -There are two serious issues that seem to be specific to the Ayn Odin 2, although it remains to be seen whether the problem exists also on other devices. - -The first problem is that some emulators refuse to run games that you place inside directories that contain dots in their names. This is quite problematic as the [directories interpreted as files](USERGUIDE.md#directories-interpreted-as-files) functionality depends on the ability to add file extensions to directory names. - -This has been observed with M64Plus FZ, Play!, Saturn.emu, FPse and FPseNG and it's working fine with RetroArch, NetherSX2, ePSXe and DuckStation. Note however that this is not a complete list as not all emulators have been tested for this problem. - -If you run into this issue you can use the _folder link_ functionality as an alternative to the _directories interpreted as files_ functionality. How to use folder links is described in the [User guide](USERGUIDE.md). - -The second problem is that a number of emulators can't be launched from ES-DE at all. When attempting to run such an emulator an error popup with the game name followed by "ERROR CODE -1" is displayed. The affected emulators are ColEm, fMSX, iNES, MasterGear, My Boy!, My OldBoy!, Redream and Speccy. - -The following devices have been tested and do **not** experience either of these two problems: - -* Ayn Odin Lite (Android 11) -* Retroid Pocket 4 Pro (Android 13) -* Google Pixel 4a (Android 13) -* Google Pixel Tablet (Android 14) +There is one serious issue that seems to be specific to the Ayn Odin 2, and that is that a number of standalone emulators can't be launched. When attempting to run such an emulator an error popup with the game name followed by "ERROR CODE -1" is displayed. The affected emulators are ColEm, fMSX, iNES, MasterGear, My Boy!, My OldBoy!, Redream and Speccy. There are also some issues with sound quality on the Odin 2, such as large fluctuations in volume where some sounds are quite loud and some are quite silent. There are also some strange aliasing effects when playing samples rapidly. @@ -449,23 +434,27 @@ This is clearly not a complete list of Android devices, but rather those we know | Anbernic | RG556 | 13 | Yes | None | | | Ayn | Odin | 10 | Yes | None | | | Ayn | Odin Lite | 11 | Yes | None | | -| Ayn | Odin 2 | 13 | Yes | Can't launch some emulators,
Can't have dots in directory names,
Minor audio issues | Bugs in the firmware/OS image | +| Ayn | Odin 2 | 13 | Yes | Can't launch some emulators,
Minor audio issues | Bugs in the firmware/OS image | | Google | Pixel 4a | 13, 14 | Yes | None | | | Google | Pixel Tablet | 14 | Yes | None | | | Honor | 20 lite | 10 | Yes | None | | | Honor | Magic5 Pro | 13 | Yes | None | | | Huawei | Mate 10 Pro | 10 | Yes | None | | +| Lenovo | Legion Y700 | 12 | Yes | None | | +| Logitech | G Cloud | 11 | Yes | None | | | Meta | Quest 3 | 12 ? | Yes | None | | +| Motorola | Moto G100 | 12 | Yes | None | | | Nokia | 5.4 | 12 | Yes | None | | | Nokia | 7 Plus | 10 | Yes | None | | | Nvidia | Shield Pro | 11 (TV) | Yes | None | Limited RAM capacity on this device makes it unsuitable for demanding themes and large game collections | | OnePlus | 6T | 11 | Yes | None | | | Oppo | A15 | 10 | Yes | None | | -| REDMAGIC | 8 Pro | 13 | Yes | None | | +| RedMagic | 8 Pro | 13 | Yes | None | | | Retroid | Pocket 2s | 11 | Yes | None | | | Retroid | Pocket 3+ | 11 | Yes | None | | | Retroid | Pocket 4 Pro | 13 | Yes | None | | | Samsung | Galaxy Note 20 | 13 | No | Fails at configurator/onboarding | Has a non-standard app permission screen, possibly this breaks the configurator | +| Samsung | Galaxy S9+ | 10 | Yes | | | | Samsung | Galaxy S10 | 12 | Yes | None | | | Samsung | Galaxy S20 | 13 | Yes | None | | | Samsung | Galaxy S22 Ultra | 14 | Yes | None | | diff --git a/ANDROID.md b/ANDROID.md index da185ebd8..584bc50cc 100644 --- a/ANDROID.md +++ b/ANDROID.md @@ -158,22 +158,7 @@ You can relocate as many systems as you want, you just need to place them all wi ## Issues with the Ayn Odin 2 -There are two serious issues that seem to be specific to the Ayn Odin 2, although it remains to be seen whether the problem exists also on other devices. - -The first problem is that some emulators refuse to run games that you place inside directories that contain dots in their names. This is quite problematic as the [directories interpreted as files](USERGUIDE.md#directories-interpreted-as-files) functionality depends on the ability to add file extensions to directory names. - -This has been observed with M64Plus FZ, Play!, Saturn.emu, FPse and FPseNG and it's working fine with RetroArch, NetherSX2, ePSXe and DuckStation. Note however that this is not a complete list as not all emulators have been tested for this problem. - -If you run into this issue you can use the _folder link_ functionality as an alternative to the _directories interpreted as files_ functionality. How to use folder links is described in the [User guide](USERGUIDE.md). - -The second problem is that a number of emulators can't be launched from ES-DE at all. When attempting to run such an emulator an error popup with the game name followed by "ERROR CODE -1" is displayed. The affected emulators are ColEm, fMSX, iNES, MasterGear, My Boy!, My OldBoy!, Redream and Speccy. - -The following devices have been tested and do **not** experience either of these two problems: - -* Ayn Odin Lite (Android 11) -* Retroid Pocket 4 Pro (Android 13) -* Google Pixel 4a (Android 13) -* Google Pixel Tablet (Android 14) +There is one serious issue that seems to be specific to the Ayn Odin 2, and that is that a number of standalone emulators can't be launched. When attempting to run such an emulator an error popup with the game name followed by "ERROR CODE -1" is displayed. The affected emulators are ColEm, fMSX, iNES, MasterGear, My Boy!, My OldBoy!, Redream and Speccy. There are also some issues with sound quality on the Odin 2, such as large fluctuations in volume where some sounds are quite loud and some are quite silent. There are also some strange aliasing effects when playing samples rapidly. @@ -442,23 +427,27 @@ This is clearly not a complete list of Android devices, but rather those we know | Anbernic | RG556 | 13 | Yes | None | | | Ayn | Odin | 10 | Yes | None | | | Ayn | Odin Lite | 11 | Yes | None | | -| Ayn | Odin 2 | 13 | Yes | Can't launch some emulators,
Can't have dots in directory names,
Minor audio issues | Bugs in the firmware/OS image | +| Ayn | Odin 2 | 13 | Yes | Can't launch some emulators,
Minor audio issues | Bugs in the firmware/OS image | | Google | Pixel 4a | 13, 14 | Yes | None | | | Google | Pixel Tablet | 14 | Yes | None | | | Honor | 20 lite | 10 | Yes | None | | | Honor | Magic5 Pro | 13 | Yes | None | | | Huawei | Mate 10 Pro | 10 | Yes | None | | +| Lenovo | Legion Y700 | 12 | Yes | None | | +| Logitech | G Cloud | 11 | Yes | None | | | Meta | Quest 3 | 12 ? | Yes | None | | +| Motorola | Moto G100 | 12 | Yes | None | | | Nokia | 5.4 | 12 | Yes | None | | | Nokia | 7 Plus | 10 | Yes | None | | | Nvidia | Shield Pro | 11 (TV) | Yes | None | Limited RAM capacity on this device makes it unsuitable for demanding themes and large game collections | | OnePlus | 6T | 11 | Yes | None | | | Oppo | A15 | 10 | Yes | None | | -| REDMAGIC | 8 Pro | 13 | Yes | None | | +| RedMagic | 8 Pro | 13 | Yes | None | | | Retroid | Pocket 2s | 11 | Yes | None | | | Retroid | Pocket 3+ | 11 | Yes | None | | | Retroid | Pocket 4 Pro | 13 | Yes | None | | | Samsung | Galaxy Note 20 | 13 | No | Fails at configurator/onboarding | Has a non-standard app permission screen, possibly this breaks the configurator | +| Samsung | Galaxy S9+ | 10 | Yes | | | | Samsung | Galaxy S10 | 12 | Yes | None | | | Samsung | Galaxy S20 | 13 | Yes | None | | | Samsung | Galaxy S22 Ultra | 14 | Yes | None | | @@ -470,6 +459,7 @@ This is clearly not a complete list of Android devices, but rather those we know | Xiaomi | Pad 5 | 13 | Yes | None | | | Xiaomi | Redmi Note 11 | 11 | Yes | None | | + ## Supported game systems All emulators are RetroArch cores unless marked as **(Standalone)** diff --git a/FAQ-ANDROID.md b/FAQ-ANDROID.md index 129ae9158..0bf5cbcac 100644 --- a/FAQ-ANDROID.md +++ b/FAQ-ANDROID.md @@ -71,11 +71,11 @@ Also be aware that there are some slight variations when it comes to how emulato ## Why do some standalone emulators fail to launch with "ERROR CODE -1" or just display a black screen? -ERROR CODE -1 is a general failure mode which could be caused by multiple things. Some emulators react like this when there's a permission issue and they can't access the game file. See the previous question above for how to deal with such permission problems. And some emulators return this error when the file you attempt to launch has an unsupported file extension. For example MD.emu does not support .bin files, but if you rename these to the .gen extension then game launching works as expected. +ERROR CODE -1 is a general failure mode which could be caused by multiple things. Some emulators react like this when there's a permission issue and they can't access the game file. See the previous question above for how to deal with such permission problems. And some emulators return this error when the file you attempt to launch has an unsupported file extension. For example MD.emu does not support .bin files, but if you rename these files to the .gen extension then game launching works as expected. -If you have an Ayn Odin 2 this error will occur for a number of emulators such as Redream and My Boy! due to what seems to be a problem with their Android OS image. See the [Issues with the Ayn Odin 2](ANDROID.md#issues-with-the-ayn-odin-2) section in the Android documentation for more details about the latter. +If you own an Ayn Odin 2 then this error will also occur when attempting to launch the ColEm, fMSX, iNES, MasterGear, My Boy!, My OldBoy!, Redream and Speccy emulators. This seems to be caused by bugs in their firmware/OS image and needs to be resolved by Ayn. -The black screen on game launch is just a variation of this failure mode, it depends on how the emulator handles errors whether there will be a black screen or whether it will abort and report the launch failure to ES-DE. +A black screen on game launch is also a possible variation of this failure mode, it depends on how the emulator handles errors whether there will be a black screen or whether it will abort and report the launch failure to ES-DE. ## Sometimes after I return from a game ES-DE is restarting, did it crash?