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
troubleshooting [2020/09/16 20:27]
lbrpdx
troubleshooting [2020/12/04 20:49] (current)
lbrpdx [Boot Issues:]
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''.+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.1600280858.txt.gz
  • Last modified: 6 months ago
  • by lbrpdx