From 53fc15260c54fc428dd568fd59b5cd151b3ee717 Mon Sep 17 00:00:00 2001 From: cobalt2727 <60624944+cobalt2727@users.noreply.github.com> Date: Thu, 21 Oct 2021 16:54:13 -0400 Subject: [PATCH 1/6] Update troubleshooting.md --- docs/docs/troubleshooting.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index 45756c5491..22c906dd5d 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -60,7 +60,7 @@ echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governo ## Switchroot -If you are running switchroot Linux on your Nintendo Switch, you can install +If you are running Switchroot L4T Ubuntu on your Nintendo Switch, you can install xemu from the PPA as described in in the [Download](download.md) page. However, when running xemu you may see the following error: @@ -71,7 +71,10 @@ This is normally a bug in some application using the D-Bus library. D-Bus not built with -rdynamic so unable to print a backtrace ``` -To fix this you can build and install SDL from source: +This can be avoided by running the [L4T Megascript](https://github.com/cobalt2727/L4T-Megascript/wiki/Initial-Setup) (use Option A for Switch users, or Option B for Jetson Nano users) +During their "initial setup" script, you'll be prompted to install SDL2 - choose yes to upgrade to working SDL2 binaries. + +If you'd like to do things yourself, instead of using the L4T Megascript, build and install SDL from source: ```bash sudo apt install cmake build-essential From 58a22787c3591f146a41227754c23be86e7f32e7 Mon Sep 17 00:00:00 2001 From: cobalt2727 <60624944+cobalt2727@users.noreply.github.com> Date: Sat, 15 Jan 2022 21:25:34 -0500 Subject: [PATCH 2/6] rewrite bc the megascript now fully supports xemu --- docs/docs/troubleshooting.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index 22c906dd5d..cd72b65b5e 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -58,23 +58,22 @@ profile. To select the `performance` profile: echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor ``` -## Switchroot +## Switchroot/Jetson setup -If you are running Switchroot L4T Ubuntu on your Nintendo Switch, you can install -xemu from the PPA as described in in the [Download](download.md) page. However, -when running xemu you may see the following error: +If you are running Switchroot/L4T Ubuntu on your Nintendo Switch or Jetson device, you can install +xemu from the PPA as described in in the [Download](download.md) page. However, this is generally **not recommended**, as when running xemu you may see the following error: -``` +```bash dbus[12047]: arguments to dbus_message_new_method_call() were incorrect, assertion "path != NULL" failed in file ../../../dbus/dbus-message.c line 1362. This is normally a bug in some application using the D-Bus library. D-Bus not built with -rdynamic so unable to print a backtrace ``` -This can be avoided by running the [L4T Megascript](https://github.com/cobalt2727/L4T-Megascript/wiki/Initial-Setup) (use Option A for Switch users, or Option B for Jetson Nano users) -During their "initial setup" script, you'll be prompted to install SDL2 - choose yes to upgrade to working SDL2 binaries. +Instead of using the PPA, it's recommended to install xemu via the [L4T Megascript](https://github.com/cobalt2727/L4T-Megascript/) (use Option A for Switch users, or Option B for Jetson Nano/other users). +During their "initial setup" script, you'll be prompted to install SDL2 - choose yes to upgrade to their working SDL2 binaries. Afterwards, you can install xemu itself from the menu. The Megascript's [build script](https://github.com/cobalt2727/L4T-Megascript/blob/master/scripts/games_and_emulators/xemu.sh) has been confirmed to result in a slight speed boost over the PPA, but it is not packaged by the xemu developers. Use at your own discretion. -If you'd like to do things yourself, instead of using the L4T Megascript, build and install SDL from source: +If you'd like to do things yourself via the PPA, instead of using the L4T Megascript, build and install SDL2 from source: ```bash sudo apt install cmake build-essential From 8577d01e178f7c7093539f541c75e59c3868a336 Mon Sep 17 00:00:00 2001 From: cobalt2727 <60624944+cobalt2727@users.noreply.github.com> Date: Sun, 16 Jan 2022 12:24:08 -0500 Subject: [PATCH 3/6] fix up info on the SDL2 bug shoutouts to @theofficialgman https://github.com/mborgerson/xemu-website/commit/b6b8227a0b986176ae7d1d57e506751628ecceaf#commitcomment-63959699 --- docs/docs/troubleshooting.md | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index cd72b65b5e..83e5c295a4 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -61,8 +61,12 @@ echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governo ## Switchroot/Jetson setup If you are running Switchroot/L4T Ubuntu on your Nintendo Switch or Jetson device, you can install -xemu from the PPA as described in in the [Download](download.md) page. However, this is generally **not recommended**, as when running xemu you may see the following error: +xemu from the PPA as described in in the [Download](download.md) page. However, this is generally **not recommended** for performance reasons. +Instead of using the PPA, it's recommended to install xemu via the [L4T Megascript](https://github.com/cobalt2727/L4T-Megascript/wiki)'s build script (use Option A for Switch users, or Option B for Jetson Nano/other users). +During their "initial setup" script, you'll be prompted to install SDL2 - choose yes to upgrade to newer SDL2 binaries. Afterwards, you can install xemu itself from the menu. +The Megascript's [build script](https://github.com/cobalt2727/L4T-Megascript/blob/master/scripts/games_and_emulators/xemu.sh) has been confirmed to result in a slight speed boost over the PPA, but it is not packaged by the xemu developers. Use at your own discretion. +If you see the following error, this is a [bug](https://github.com/mborgerson/xemu-website/commit/b6b8227a0b986176ae7d1d57e506751628ecceaf#commitcomment-63959699) from older releases of Switchroot's L4T Ubuntu: ```bash dbus[12047]: arguments to dbus_message_new_method_call() were incorrect, assertion "path != NULL" failed in file ../../../dbus/dbus-message.c line 1362. This is normally a bug in some application using the D-Bus library. @@ -70,18 +74,13 @@ This is normally a bug in some application using the D-Bus library. D-Bus not built with -rdynamic so unable to print a backtrace ``` -Instead of using the PPA, it's recommended to install xemu via the [L4T Megascript](https://github.com/cobalt2727/L4T-Megascript/) (use Option A for Switch users, or Option B for Jetson Nano/other users). -During their "initial setup" script, you'll be prompted to install SDL2 - choose yes to upgrade to their working SDL2 binaries. Afterwards, you can install xemu itself from the menu. The Megascript's [build script](https://github.com/cobalt2727/L4T-Megascript/blob/master/scripts/games_and_emulators/xemu.sh) has been confirmed to result in a slight speed boost over the PPA, but it is not packaged by the xemu developers. Use at your own discretion. - -If you'd like to do things yourself via the PPA, instead of using the L4T Megascript, build and install SDL2 from source: - +This can be fixed by building a newer SDL2 from source or pasting the following into a terminal: ```bash -sudo apt install cmake build-essential -git clone https://github.com/libsdl-org/SDL && cd SDL -mkdir build && cd build -cmake .. -make -j4 -sudo make install +# check for bad machine-id from 3.0.0 L4T Ubuntu image and fix if necessary +# also generate if user has somehow deleted their machine-id as well +if [[ $(cat /var/lib/dbus/machine-id) == "52e66c64e2624539b94b31f8412c6a7d" ]]; then + sudo rm /var/lib/dbus/machine-id && dbus-uuidgen | sudo tee /var/lib/dbus/machine-id +elif [[ ! -f /var/lib/dbus/machine-id ]]; then + dbus-uuidgen | sudo tee /var/lib/dbus/machine-id +fi ``` - -Then launch xemu `LD_LIBRARY_PATH=/usr/local/lib xemu` From d9629e97114a9f10acdf8a2a03fb5b8d073c3aa6 Mon Sep 17 00:00:00 2001 From: cobalt2727 <60624944+cobalt2727@users.noreply.github.com> Date: Thu, 3 Feb 2022 22:58:01 -0500 Subject: [PATCH 4/6] bring launch command back --- docs/docs/troubleshooting.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index 83e5c295a4..23a47674cb 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -84,3 +84,4 @@ elif [[ ! -f /var/lib/dbus/machine-id ]]; then dbus-uuidgen | sudo tee /var/lib/dbus/machine-id fi ``` +Then launch xemu by typing `./xemu` from the "dist" folder at `$your-git-folder-location/dist/` after building (or if using the Megascript, simply launch Xemu from your app list). From f2098b3a525eefcd9b7092fbc5578eaa49d00349 Mon Sep 17 00:00:00 2001 From: cobalt2727 <60624944+cobalt2727@users.noreply.github.com> Date: Thu, 3 Feb 2022 23:03:49 -0500 Subject: [PATCH 5/6] reword again --- docs/docs/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index 23a47674cb..eec99f9e6e 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -84,4 +84,4 @@ elif [[ ! -f /var/lib/dbus/machine-id ]]; then dbus-uuidgen | sudo tee /var/lib/dbus/machine-id fi ``` -Then launch xemu by typing `./xemu` from the "dist" folder at `$your-git-folder-location/dist/` after building (or if using the Megascript, simply launch Xemu from your app list). +Then launch xemu by typing `./xemu` from a "dist" folder inside the git folder at `xemu/dist/` after successfully building (or if using the Megascript, simply launch Xemu from your app list). From 70f050bc7799883c394efb298219ae8b25cdd282 Mon Sep 17 00:00:00 2001 From: cobalt2727 <60624944+cobalt2727@users.noreply.github.com> Date: Thu, 12 May 2022 12:09:02 -0400 Subject: [PATCH 6/6] modify Jetson info as requested --- docs/docs/troubleshooting.md | 31 +++++++++++++------------------ 1 file changed, 13 insertions(+), 18 deletions(-) diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index eec99f9e6e..bd8d955231 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -36,7 +36,7 @@ file. ### Nvidia Settings -It is recommended to **disable** "Multi-threaded Optimizations" in the nVidia +It is recommended to **disable** "Multi-threaded Optimizations" in the Nvidia Control Panel. This feature has been known to negatively impact xemu performance. @@ -60,13 +60,18 @@ echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governo ## Switchroot/Jetson setup -If you are running Switchroot/L4T Ubuntu on your Nintendo Switch or Jetson device, you can install -xemu from the PPA as described in in the [Download](download.md) page. However, this is generally **not recommended** for performance reasons. -Instead of using the PPA, it's recommended to install xemu via the [L4T Megascript](https://github.com/cobalt2727/L4T-Megascript/wiki)'s build script (use Option A for Switch users, or Option B for Jetson Nano/other users). -During their "initial setup" script, you'll be prompted to install SDL2 - choose yes to upgrade to newer SDL2 binaries. Afterwards, you can install xemu itself from the menu. -The Megascript's [build script](https://github.com/cobalt2727/L4T-Megascript/blob/master/scripts/games_and_emulators/xemu.sh) has been confirmed to result in a slight speed boost over the PPA, but it is not packaged by the xemu developers. Use at your own discretion. +If you are running Switchroot/L4T Ubuntu on your Nintendo Switch or Jetson device, you have two options: +- Install xemu using the [official PPA](https://launchpad.net/~mborgerson/+archive/ubuntu/xemu). This gives you the option to quickly install and update xemu like any other package on your device. To do so, run the following: +```bash +sudo add-apt-repository ppa:mborgerson/xemu +sudo apt-get update +sudo apt install xemu +``` +- Install xemu via the [L4T Megascript](https://github.com/cobalt2727/L4T-Megascript/wiki/)'s build script (check the `Initial Setup` page in their wiki to get started). +During their "initial setup" script, you'll be prompted to install SDL2 - choose yes to upgrade to newer SDL2 binaries. Afterwards, you can install xemu itself from the menu. **Skip the "initial setup" script if you're not on a Switch or other Tegra hardware!** +The Megascript's [build script](https://github.com/cobalt2727/L4T-Megascript/blob/master/scripts/games_and_emulators/xemu.sh) gets you the newest updates sooner and has been confirmed to result in a performance boost over the PPA, but it is not packaged by the xemu developers. Use at your own discretion. To update xemu, simply run the Megascript's `Auto Updater` script. -If you see the following error, this is a [bug](https://github.com/mborgerson/xemu-website/commit/b6b8227a0b986176ae7d1d57e506751628ecceaf#commitcomment-63959699) from older releases of Switchroot's L4T Ubuntu: +If you see the following error, this is a bug from older releases of Switchroot's L4T Ubuntu: ```bash dbus[12047]: arguments to dbus_message_new_method_call() were incorrect, assertion "path != NULL" failed in file ../../../dbus/dbus-message.c line 1362. This is normally a bug in some application using the D-Bus library. @@ -74,14 +79,4 @@ This is normally a bug in some application using the D-Bus library. D-Bus not built with -rdynamic so unable to print a backtrace ``` -This can be fixed by building a newer SDL2 from source or pasting the following into a terminal: -```bash -# check for bad machine-id from 3.0.0 L4T Ubuntu image and fix if necessary -# also generate if user has somehow deleted their machine-id as well -if [[ $(cat /var/lib/dbus/machine-id) == "52e66c64e2624539b94b31f8412c6a7d" ]]; then - sudo rm /var/lib/dbus/machine-id && dbus-uuidgen | sudo tee /var/lib/dbus/machine-id -elif [[ ! -f /var/lib/dbus/machine-id ]]; then - dbus-uuidgen | sudo tee /var/lib/dbus/machine-id -fi -``` -Then launch xemu by typing `./xemu` from a "dist" folder inside the git folder at `xemu/dist/` after successfully building (or if using the Megascript, simply launch Xemu from your app list). +This can be fixed by [updating to the newest Switchroot L4T Ubuntu release following this guide](https://wiki.switchroot.org/en/Linux/Ubuntu-Install-Guide#updates-for-previous-30-installs).