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
wifi_ssid [2022/05/24 13:20] – added tip about channels (thanks debug) atariwifi_ssid [2024/01/05 16:54] (current) – [Manual SSID] precision about special characters + screenshot lbrpdx
Line 21: Line 21:
 ==== Manual SSID ==== ==== Manual SSID ====
  
-In case the access point does not appear in the list (or you just have your SSID hidden in your router's settings), an SSID can be defined manually.+In case the access point does not appear in the list (or you just have your SSID hidden in your router's settings), an SSID can be defined manually by clicking ''INPUT MANUALLY''.
  
-The SSID is case-sensitive. Special characters should be escaped with a backslash (''\''). For example, if the password is ''special?characters@*'', the entered in password should be ''special\?characters\@\*''.+The SSID is case-sensitive. Both for SSID and the password, special characters should be escaped with a backslash (''\''). For example, if the password is ''special?characters@*'', the entered in password should be ''special\?characters\@\*''. You can also edit these fields directly in the ''batocera.conf'' file.
  
 Upon connecting successfully, the Wi-Fi icon will appear in the top-right of the screen (certain themes may reposition this). Upon connecting successfully, the Wi-Fi icon will appear in the top-right of the screen (certain themes may reposition this).
  
-<WRAP center round todo> +{{ ::wifi_connected.png?600 |}}
-Screenshot of this very basic feature? +
-</WRAP>+
  
 ===== Command line options ===== ===== Command line options =====
Line 48: Line 46:
  
 ===== Troubleshooting ===== ===== Troubleshooting =====
 +
 +==== Wi-Fi is not working ====
  
 After activating Wi-Fi, it may take a moment to actually activate. In fact, it might not even activate until the system is rebooted. The power of Linux! Reboot and try again. It might even be worth waiting around ten seconds or so on the main menu before going into the Wi-Fi menu. After activating Wi-Fi, it may take a moment to actually activate. In fact, it might not even activate until the system is rebooted. The power of Linux! Reboot and try again. It might even be worth waiting around ten seconds or so on the main menu before going into the Wi-Fi menu.
 +
 +It could also be that your Wi-Fi chipset requires particular drivers not already included in Batocera. Check [[#how_to_manually_add_drivers_(advanced)|the section on how to do that below]].
  
 ==== I can't see my SSID in the list, but I can see my neighbor's ==== ==== I can't see my SSID in the list, but I can see my neighbor's ====
Line 57: Line 59:
 For instance, the Raspberry Pi line infamously does not support channel 13 on the 2.4GHz Wi-Fi. For instance, the Raspberry Pi line infamously does not support channel 13 on the 2.4GHz Wi-Fi.
  
-Your device may also be limiting the channels based on the Wi-Fi region set in ''batocera.conf''.+The [[https://openwrt.org/docs/guide-user/network/wifi/wifi_countrycode|country region]] can be altered in ''batocera.conf'' by adding the ''wifi.country'' key and making it equal to your country's region code. For example: ''wifi.country=US''
 + 
 +What if you don't know your country's code? Use the **Alpha-2 code** from this list: https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
  
 ==== My Wi-Fi is slow/laggy! ==== ==== My Wi-Fi is slow/laggy! ====
Line 66: Line 70:
   * Turn off as many other Wi-Fi enabled devices as you can, including your phone, your smart thermostat, your fridge, etc.   * Turn off as many other Wi-Fi enabled devices as you can, including your phone, your smart thermostat, your fridge, etc.
   * Turn off any large mechanical devices that throw out lots of interference like combustion engines, generators, UPS's, microwaves, etc.   * Turn off any large mechanical devices that throw out lots of interference like combustion engines, generators, UPS's, microwaves, etc.
 +  * If using 2.4 GHz Wi-Fi (the "default" for most routers) make sure you aren't using any USB 3.0 devices as [[https://superuser.com/questions/1282590/why-does-usb-3-0-interfere-with-2-4ghz-devices|they can cause direct interference]].
   * Try to have a direct line-of-sight to your router. If that is not possible due to a wall being in the way, try to have the least amount of objects between the device and the router.   * Try to have a direct line-of-sight to your router. If that is not possible due to a wall being in the way, try to have the least amount of objects between the device and the router.
     * Usually, the best place for the router is very high above the ground, as there are less things on the ceiling than the floor.     * Usually, the best place for the router is very high above the ground, as there are less things on the ceiling than the floor.
Line 80: Line 85:
 ==== How to manually add drivers (advanced) ==== ==== How to manually add drivers (advanced) ====
  
-Most network devices should already be supported by the Linux kernel included in Batocera. However, in some rare cases (such as bleeding-edge hardware) the drivers might not be included yet. If the manufacturer has provided pre-compiled binary driver files, it is possible to install them.+Most network devices should already be [[hardware:compatible_dongle_list|supported by the Linux kernel included in Batocera]]. However, in some rare cases (such as bleeding-edge hardware) the drivers might not be included yet. If the manufacturer has provided pre-compiled binary driver files, it is possible to install them.
  
 If your network/Wi-Fi device complains about requiring certain binary firmware files (check with ''dmesg'' [[:access_the_batocera_via_ssh|via terminal]]), you can [[:modify_the_system_while_it_s_running|put them into]] ''/lib/firmware/rtlwifi/'' and run ''batocera-save-overlay'' after confirming it works.  If your network/Wi-Fi device complains about requiring certain binary firmware files (check with ''dmesg'' [[:access_the_batocera_via_ssh|via terminal]]), you can [[:modify_the_system_while_it_s_running|put them into]] ''/lib/firmware/rtlwifi/'' and run ''batocera-save-overlay'' after confirming it works. 
Line 93: Line 98:
 If you've done this and it worked successfully, let the devs know so they can add it to the next version of Batocera. If you've done this and it worked successfully, let the devs know so they can add it to the next version of Batocera.
 </WRAP> </WRAP>
 +
 +==== I'm having general network issues that may not necessarily be related to Wi-Fi ====
 +
 +Check out the [[:network_issues|network issues page]].
  
  • wifi_ssid.1653391252.txt.gz
  • Last modified: 23 months ago
  • by atari