Differences

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

Link to this comparison view

Next revision		 Previous revision
wifi_ssid [2020/01/28 19:28] – created genetik57wifi_ssid [2024/01/05 15:54] (current) – [Manual SSID] precision about special characters + screenshot lbrpdx
Line 1: Line 1:
-~~NOTOC~~ +<WRAP center round todo> 
-===== WiFi SSID =====+Under construction. 
 +</WRAP>
  
-**What is an SSID?**+====== Wi-Fi ======
  
-An SSID is the name of your wireless network.+Although Batocera functions perfectly fine offline, connecting it to the internet opens it up to [[:updates_and_downloads|so]] [[:add_games_bios#the_network_share|much]] [[:es-webserver|more]] [[:ai_game_translation|cool]] [[:scrape_from|stuff]]. An ethernet cable provides the best connection quality (especially for [[:netplay|netplay]]), but Wi-Fi is available as an alternative.
  
-**Connecting to your SSID**+Batocera //should// support most built-in and PCI-e Wi-Fi modules for ordinary PCs, however newer models are less likely to work out of the box. [[hardware:compatible_dongle_list|Click here for a list of known compatible USB Wi-Fi dongles]].
  
-When you select SSID, a keyboard will pop-up and allow you to type in your networks SSID - Type it exactly the same (case sensitive)+===== Wi-Fi setup =====
  
-**How do I know if it was successful?**+Ethernet connects and configures itself automatically, but this is not so the case for Wi-Fi. Some manual action is required.
  
-After toggling on the WiFi, Entering the SSID and Password, go to the bottom to "Back" and select it. This will take you back one page in the menu. Go back into your network portion of the menu and you should see an IP address towards the top of the menu. Ex 192.168.1.25 . If you see numbers at the top, then you successfully connected to Wifi+First, activate Wi-Fi in the first place by going to the **MAIN MENU** -> **NETWORK SETTINGS** -> **ENABLE WIFI** (turning Wi-Fi off can be useful for battery-powered [[:choose_a_handheld|handheld]] [[:handheld_pc|devices]]).
  
-**What if it wasn't?**+Wait a moment for the Wi-Fi chip to actually turn on and start scanning (some devices may require a full reboot). Then all the available Wi-Fi access points will appear in the list. 
 + 
 +From EmulationStation menu, you can configure only one Wi-Fi connection. If editing ''batocera.conf'' directly, it is possible to configure up to three connections. 
 + 
 +==== 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 by clicking ''INPUT MANUALLY''. 
 + 
 +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). 
 + 
 +{{ ::wifi_connected.png?600 |}} 
 + 
 +===== Command line options ===== 
 + 
 +<WRAP center round todo> 
 +WIP 
 +</WRAP> 
 + 
 +Access Batocera [[:access_the_batocera_via_ssh|via SSH or local terminal]] to run these. You can use an ethernet cable for an SSH connection, or if no networking is available period then run the local terminal on the Batocera machine itself. 
 + 
 +<code> 
 +batocera-wifi start                      Turn on all available Wi-Fi modules. 
 +batocera-wifi scanlist                   List all available Wi-Fi in range. 
 +batocera-wifi list                       List all saved Wi-Fi configurations. 
 +batocera-wifi enable <SSID> <passkey>    Connect to the specified Wi-Fi and save it. 
 +batocera-wifi disable                    Turn off all Wi-Fi modules. 
 +</code> 
 + 
 +===== 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. 
 + 
 +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 ==== 
 + 
 +It's possible that the device you are using Batocera on is not compatible with the channel that your router is set to use. 
 + 
 +For instance, the Raspberry Pi line infamously does not support channel 13 on the 2.4GHz Wi-Fi. 
 + 
 +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! ==== 
 + 
 +The best advice for this is... don't use Wi-Fi. Use an Ethernet cable, especially if you want to do something ping-sensitive like [[:netplay|Netplay]] or [[systems:moonlight|game streaming]]. In the modern high-tech world we live in there is so much wireless noise in the air that getting a consistent, lag-free Wi-Fi signal is a pipe-dream. Only if you're seated right next to the router less than a few feet away, and even then... 
 + 
 +But if your situation absolutely requires the use of Wi-Fi, here are some tips: 
 +  * 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. 
 +  * 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. 
 +    * Usually, the best place for the router is very high above the ground, as there are less things on the ceiling than the floor. 
 +    * This especially applies to any metallic or perfectly-flat objects as they can reflect the signal, causing even more interference. 
 +  * Optimize your router's settings. This can include doing things like enabling Quality of Service (QoS), Smart Queue Management (SQM), etc. 
 +    * Typically only modern high-end routers support these features, as they require a bit more CPU power than just normal networking does. If your router supports installing [[https://openwrt.org/|OpenWRT]] onto it, it likely also supports this setting. 
 +  * If your device has other wireless interfaces such as Bluetooth or internal Wi-Fi (and you're using a USB dongle), turn them off. 
 +    * This is especially so if you only have 2.4 GHz Wi-Fi, as that operates near the same frequency as Bluetooth. 
 + 
 +<WRAP center round tip> 
 +You can disable the Raspberry Pi 4's onboard Wi-Fi by adding ''dtoverlay=disable-wifi'' to ''/boot/config.txt''. 
 +</WRAP> 
 + 
 +==== How to manually add drivers (advanced) ==== 
 + 
 +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.  
 + 
 +An example of a Wi-Fi device complaining about binary firmware files in ''dmesg'': 
 + 
 +<code> 
 +[ X.XXXXXXX ] Wi-Fi: xxx0: RTL: firmware file rtlwifi/XXXXXXXXXX.bin not found 
 +</code> 
 + 
 +<WRAP center round tip> 
 +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> 
 + 
 +==== I'm having general network issues that may not necessarily be related to Wi-Fi ==== 
 + 
 +Check out the [[:network_issues|network issues page]].
  
-Go back and double check that you have the correct username and password entered. If you still are having issues, this might be a driver issue with your WiFi Card. Feel free to report the issue along with the make and model of the wifi adapter or the name of the PC if it is integrated into the motherboard. 
  • wifi_ssid.1580239704.txt.gz
  • Last modified: 6 years ago
  • by genetik57