Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
troubleshooting [2020/09/27 00:56] – [Emulators not lauching] lbrpdxtroubleshooting [2020/12/04 20:49] – [Boot Issues:] lbrpdx
Line 1: Line 1:
 ===== System Troubleshooting ===== ===== System Troubleshooting =====
-   
-====Boot Issues:==== 
-  * You may need to change your BIOS to allow legacy and unsecured boot 
-  * Unplug any attached storage or controllers 
- 
-In order to get more information on your boot sequence, you can edit the ''/boot/boot/syslinux/syslinux.cfg'' file (for Batocera 5.25+, or ''/boot/boot/syslinux.cfg'' for Batocera 5.24 and earlier) and replace: 
- 
-  APPEND label=BATOCERA console=tty3 quiet loglevel=0 vt.global_cursor_default=0 
- 
-With: 
- 
-  APPEND label=BATOCERA console=tty3 loglevel=9 vt.global_cursor_default=0 
- 
-====Troubleshooting==== 
- 
-How to get access to a Linux console for troubleshooting? 
-   * If you can't use SSH because the network is not available, you can plug a USB keyboard on your Batocera box and: 
-   * on an x86_64 or x86 PC you can get a console with full graphical capabilities by pressing the ''[F1]'' key from the main system menu (to get into the file manager) and then ''[F4]'' for an ''xterm''. 
-   * for other architectures, you can get to a text console by pressing simultaneously ''[Ctrl][Alt][F3]''. 
- 
- 
-====Video issues==== 
- 
-Several video issues on PC x86 and x86_64 can be investigated [[display_issues|with xrandr as described on this page]].  
- 
-If you use Batocera with a display that provides a high resolution like a 4K monitor, you might have trouble reading the text on the file browser (''F1'' on a PC) or the configuration screens of a few emulators. You can change the default DPI settings by editing ''batocera.conf'' and look for the section:  
- 
-  ## DPI 
-  ## Workaround when correct DPI setting is not detected 
-  ## if fonts are too small, uncomment next line 
-  #global.dpi=96 
  
 ====Audio issues==== ====Audio issues====
Line 75: Line 44:
 Worst case, if it doesn't work and you want to go back to the original state, just remove the file ''/userdata/system/.asoundrc'' (or ''\system\.asoundrc'' from the network share). Worst case, if it doesn't work and you want to go back to the original state, just remove the file ''/userdata/system/.asoundrc'' (or ''\system\.asoundrc'' from the network share).
  
-====Emulators not lauching====+====Emulators not launching====
  
-When you try to launch a game, the emulator stops and gets you back to EmulationStation. In most cases, you will find some useful information in ''/userdata/system/logs/es_launch_stderr.log'' (or /system/logs/ from the network shared drive).+When you try to launch a game, the emulator stops and gets you back to EmulationStation. In most cases, you will find some useful information in ''/userdata/system/logs/es_launch_stderr.log'' (which is also ''/system/logs/es_launch_stderr.log'' from the network shared drive)
 + 
 +Come to the Discord channel with this file, you'll get some help. In many case, you can see problems with BIOS missing, or bad ROM format.
  
 ====Joystick Troubleshooting==== ====Joystick Troubleshooting====
  
 Please refer to [[diagnose_joysticks_issues|this page for joystick issues]] Please refer to [[diagnose_joysticks_issues|this page for joystick issues]]
 +
 +  
 +====Boot Issues:====
 +First of all:
 +  * You may need to change your BIOS to allow legacy boot.
 +  * Make sure you have enabled "unsecured boot" option in your BIOS, this is a requirement for most Linux distributions
 +  * Unplug any attached storage or controllers
 +  * If your BIOS is UEFI and you can't use legacy boot, make sure you can load ''bootx64.efi'' from Batocera's boot partition
 +
 +In order to get more information on your boot sequence, you can edit the ''/boot/boot/syslinux/syslinux.cfg'' file (for Batocera 5.25+, or ''/boot/boot/syslinux.cfg'' for Batocera 5.24 and earlier) and replace:
 +
 +  APPEND label=BATOCERA console=tty3 quiet loglevel=0 vt.global_cursor_default=0
 +
 +With:
 +
 +  APPEND label=BATOCERA console=tty3 loglevel=9 vt.global_cursor_default=0
 +
 +Don't forget you need to put the ''/boot/'' mount point in write mode first, as [[modify_the_system_while_it_s_running|described on this page]].
 +====Video issues====
 +
 +Several video issues on PC x86 and x86_64 can be investigated [[display_issues|with xrandr as described on this page]]. 
 +
 +If you use Batocera with a display that provides a high resolution like a 4K monitor, you might have trouble reading the text on the file browser (''F1'' on a PC) or the configuration screens of a few emulators. You can change the default DPI settings by editing ''batocera.conf'' and look for the section: 
 +
 +  ## DPI
 +  ## Workaround when correct DPI setting is not detected
 +  ## if fonts are too small, uncomment next line
 +  #global.dpi=96
 +
 +====Network issues and console access====
 +
 +How to get access to a Linux console for troubleshooting?
 +   * If you can't use SSH because the network is not available, you can plug a USB keyboard on your Batocera box and:
 +   * on an x86_64 or x86 PC you can get a console with full graphical capabilities by pressing the ''[F1]'' key from the main system menu (to get into the file manager) and then ''[F4]'' for an ''xterm''. You can get to a text console by pressing simultaneously ''[Ctrl][Alt][F3]''.
 +
  
 ====Create a Batocera support file==== ====Create a Batocera support file====
  • troubleshooting.txt
  • Last modified: 4 months ago
  • by maximumentropy