Main Page/it: Difference between revisions

From The FunKey Wiki
Main Page/it
Content added Content deleted
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 158: Line 158:
</div>
</div>
<div style='text-align:right;float:center'class="mobileonly";>
<div style='text-align:right;float:center'class="mobileonly";>
[[File:FunKeyMapping-1.jpg|thumb|right|150px|alt:Image showing the FunKey S buttons.|System buttons]]
[[File:FunKeyMapping-1.jpg|thumb|center|225px|alt:Image showing the FunKey S buttons.|System buttons]]
[[File:FunKeyMapping-2.jpg|thumb|right|150px|alt:Image showing the FunKey S function key's alternate button inputs and their uses.|FN shortcuts]]
[[File:FunKeyMapping-2.jpg|thumb|center|225px|alt:Image showing the FunKey S function key's alternate button inputs and their uses.|FN shortcuts]]
</div>
</div>
The system has thirteen buttons built into it: four directional buttons, four action buttons, two trigger buttons, a START button, and two system buttons. The top-right system button is the Menu button, while the one to the left of the START button is the Fn button. The Menu button has two purposes: a short press activates the system menu, allowing the user to modify settings or return to the main menu, while a long press turns the system on or off. The Fn (Function) button has several functions to extend the capabilities of the system's limited number of buttons. Pressing the Fn button by itself is registered as SELECT, while pressing it in conjunction with L or R is registered as L2 or R2, respectively. The other uses of the Fn button are shortcuts to modify several system settings without needing to go to the system's settings menu. The settings that can be modified with the use of the Fn button are brightness (X and B), volume (Y and A), zoom (RIGHT and LEFT), and aspect ratio (DOWN). Additionally, screenshots can be taken using the Fn plus UP shortcut. While FunKey S systems come by default with either white or grey buttons (depending on which system color is ordered), aside from the L and R buttons these can be swapped out individually with the included green, blue, red, and yellow extra button sets.
The system has thirteen buttons built into it: four directional buttons, four action buttons, two shoulder buttons, a START button, and two system buttons: ''Menu'' and ''Fn''. Centered at the top of the control panel, the Menu button serves two purposes: a short press activates the system menu, allowing the user to modify settings or return to the main menu, while a long press turns the system on or off. Sharing a button with SELECT, the Fn (Function) input extends the system's limited button count via the use of button combinations. In conjunction with the shoulder buttons, Fn activates the L2 and R2 trigger inputs of the PlayStation, while its use with the directional and action buttons grants access to the volume, brightness, zoom, aspect ratio, and screenshot shortcuts. While this functionality does [[List of games with compatibility issues#Games that require adapted controls|in rare cases]] override button combinations used by games, each such case can be solved by the device's per-game or per-console button remapping capabilities. In addition to the white or grey buttons installed by default, packaged with the FunKey S are green, blue, red, and yellow button sets that the user may use to further personalize their device.


<div style="text-align:center;">
<div style="text-align:center;">
Line 173: Line 173:


</div>
</div>
The FunKey S runs [[FunKey-OS]], a custom Linux-based operating system. The system comes with several emulators and games out of the box, with future updates to the operating system expected to add support for more emulators. These emulators can be launched on the device via one of two launchers, RetroFE and Gmenu2x, with both having multiple themes that users can choose between. By connecting the device to a computer, users can supplement the device's [[#Which games are included on the FunKey S?|homebrew game catalogue]] with their own games by adding their files to the game folders of the corresponding emulators. Should the need arise, users can also edit or delete any file on the device via Commander, the included file management application, without the need to connect the FunKey S to a computer. The files used to build the FunKey-OS firmware are open source and available on the FunKey Team's [https://github.com/FunKey-Project/FunKey-OS GitHub] page.
The FunKey S runs [[FunKey-OS]], a purpose-made open source distribution of Linux. Launchable from one of the device's two application launchers, the device's seven default emulators enable the emulation of twelve consoles out of the box, with Game Boy Advance and improved PlayStation emulation requiring the addition of [[#Why does the FunKey S need emulated system BIOS files?|BIOS files]] by the user. While the list of consoles emulated out of the box is expected to grow with future firmware updates, [[List of third-party OPK applications#Emulators|third-party emulators]] can also be used to give the device additional emulation capabilities. While the device includes [[#Which games are included on the FunKey S?|61 homebrew games]] to help demonstrate its functionality, users may also add their own games and box art to the device's emulated system folders to expand their FunKey S catalogue. Should the need arise, users can edit or delete any file on the device via Commander, the included file management application, without the need to connect the FunKey S to a computer. As FunKey-OS is open source, the files used to build it are publicly available on the FunKey Team's [https://github.com/FunKey-Project/FunKey-OS GitHub page].


<div style="text-align:center;">
<div style="text-align:center;">
Line 179: Line 179:


</div>
</div>
As the unlicensed distribution of video game properties on an emulation system such as the FunKey S would constitute illegal piracy, only freely distributable homebrew games are included on the system. This means that users seeking to play games originally released commercially on emulated systems must extract ROM backups from their own copies of such games for use on their own systems. Alternatively, a number of games originally licensed for emulated systems are now available digitally on platforms such as Steam, with the ROMs of those games often extractable for personal use in external emulators such as the FunKey S. A list of such games is available on [[List of emulatable games (commercial)|this page]] of the FunKey Wiki.
As the unlicensed distribution of copyrighted games in any circumstance is illegal piracy, the FunKey S only comes with freely-distributable homebrew games hand-picked for their quality. This means that users seeking to emulate copyrighted games on the device must extract their own game backups and transfer them to the device's console folders. Alternatively, many games originally released in a physical format are now available digitally on platforms such as Steam, with the ROMs of those games often extractable for personal use in external emulators such as those of the FunKey S. A list of such games is available on [[List of emulatable games (commercial)|this page]] of the FunKey Wiki.


<div style="text-align:center;">
<div style="text-align:center;">
Line 316: Line 316:


</div>
</div>
While users can put ROM backups of physical and digital commercial games that they own onto the FunKey S, there are also many freeware options that can be legally downloaded and used on the system. Since the FunKey S operating system, FunKey-OS, is open source, developers are able to develop and share [[List of third-party OPK applications|their own apps and games]] for the platform. Additionally, hundreds of freely available [[w:Homebrew (video games)|homebrew]] games have been released for various systems over the past three decades, many of which being available for download on homebrew lists across the Internet. The FunKey Wiki maintains [[Available third-party software|lists]] of emulatable software, including [[List of emulatable games (freeware)|freeware games]], [[List of emulatable games (commercial)|commercial games]], and [[List of emulatable utilities|utilities]].
While users can put ROM backups of their own physical and digital commercial games onto the FunKey S, there is also much freeware and commercial software that can be legally acquired and used on the device. As the system's operating system is both well-documented and open source, third-party developers have released dozens of natively-running [[List of third-party OPK applications|original and ported programs]] for the device that are not limited by the bottleneck of an emulator. In terms of emulatable software, however, the FunKey Wiki also maintains lists of hundreds of [[List of emulatable games (freeware)|freeware]] and [[List of emulatable games (commercial)|commercial]] games, as well as several dozen [[List of emulatable utilities|public domain e-books and utilities]].


<div style="text-align:center;">
<div style="text-align:center;">
Line 408: Line 408:


</div>
</div>
To complement the set of default Gmenu2x wallpapers, the FunKey Wiki maintains a database of minimalist FunKey S wallpapers [https://drive.google.com/drive/folders/1dYCPLxipiOZ3FPd67AGfUwI0EEA8UfAF?usp=sharing here]. Users may also use any 240-pixel square PNG format image as a Gmenu2x wallpaper on their FunKey S. Once acquired, Gmenu2x wallpapers should be put in the ''/mnt/FunKey/.gmenu2x/skins/240x240/Default/Wallpapers'' location of the FunKey S file system.
To complement the set of default Gmenu2x wallpapers, the FunKey Wiki maintains a database of minimalist FunKey S wallpapers [https://drive.google.com/drive/folders/1dYCPLxipiOZ3FPd67AGfUwI0EEA8UfAF?usp=sharing here]. Users may also use any 240-pixel square PNG format image as a Gmenu2x wallpaper on their FunKey S. Once acquired, Gmenu2x wallpapers should be put in the ''/mnt/FunKey/.gmenu2x/skins/240x240/Default/Wallpapers'' location of the FunKey S file system. If you don't see the ''.gmenu2x'' folder, your computer's Unix-based operating system is hiding hidden folders. To enable the viewing of such folders on MacOS, use the ''Shift+Cmd+Period'' key combination. To do so on ChromeOS, click the three-dot icon at the top-right of the ''Files'' application and select the ''Show hidden folders'' option.


<div style="text-align:center;">
<div style="text-align:center;">
Line 582: Line 582:


</div>
</div>
On a sixty minute full charge, the FunKey S has a median battery life of two hours. Since the device's battery life is impacted by CPU usage and brightness and audio levels, there can be significant deviation from the median by roughly thirty minutes in either direction. In practice, this means that low-intensity emulation such as that of the Game Boy will result in above-average battery life, while high-intensity emulation such as that of the PlayStation will result in below-average battery life. Additionally, the device has a blue LED light that indicates when it is charging, with a battery symbol in the top right corner of the main menu indicating the current charge level. When the FunKey S begins to run low on charge, a charging notification appears on screen. If the device runs out of charge, progress in the game being played at the time will be saved automatically prior to shutdown and returned to when the system is recharged and reopened.
On a sixty minute full charge, the FunKey S has a median battery life of two hours. Since the device's battery life is impacted by CPU usage and brightness and audio levels, there can be significant deviation from the median by roughly thirty minutes in either direction. In practice, this means that low-intensity emulation such as that of the Game Boy will result in above-average battery life, while high-intensity emulation such as that of the PlayStation will result in below-average battery life. Additionally, the device has a blue LED light that indicates when it is charging, with a battery symbol in the top right corner of the main menu indicating the current charge level. While a low-charge indicator is displayed on-screen before the FunKey S runs out of charge, should this occur, an autosave of the current game is automatically generated prior to shutdown and returned to when the system is recharged and reopened.


<div style="text-align:center;">
<div style="text-align:center;">
Line 588: Line 588:


</div>
</div>
The FunKey S supports the RTC functionalities used by Game Boy Color and Game Boy Advance games, such as Harvest Moon GBC, Pokemon Crystal, and Pokemon Emerald. It does this by siphoning an extremely small amount of charge from the FunKey S battery, allowing games that employ the feature to keep track of time. RTC functionality is still preserved even if the FunKey S is turned off or runs out of charge, as there is a buffer of charge resevered for such an instance. To best make use of the RTC feature, it is recommended that users save in-game, as save states and automatic FunKey S saves can affect the RTC timing of games.
The FunKey S supports the RTC functionalities used by Game Boy Color and Game Boy Advance games, such as Harvest Moon GBC, Pokemon Crystal, and Pokemon Emerald. It does this by siphoning an extremely small amount of charge from the device's battery, allowing games that employ the feature to keep track of time. RTC functionality is still preserved even if the FunKey S is turned off or runs out of charge, as there is a buffer of charge reserved for such an instance. To best make use of the RTC feature, it is recommended that users rely solely on in-game saves for games with RTC functionality, as save states and autosaves can affect the RTC timing of games.


<div style="text-align:center;">
<div style="text-align:center;">
Line 606: Line 606:


</div>
</div>
The display of the FunKey S refreshes at a maximum rate of 50 FPS due to that being the maximum writing speed of data being sent from the processor to the internal graphics memory of the display, which, if not limited by the processor, would have a maximum refresh rate of 120 FPS. Since NTSC games are still emulated accurately, however, games with framerates higher than that of the FunKey S function normally, only missing ten frames each second while experiencing no screen tearing between the remaining frames.
The FunKey S display refreshes at a maximum rate of 50 FPS due to that being the most data the device's processor can send to the display's internal graphics memory each second. If this were not a limitation, the display would otherwise have a maximum refresh rate of 120 FPS. As NTSC games are still emulated at 60 FPS, however, ten frames are dropped each second rather than gameplay being slowed down to match the differing frame rate. As this issue was anticipated during the designing of the FunKey S, however, several software and hardware techniques were implemented to avoid screen tearing between the remaining 50 frames of NTSC games.


<div style="text-align:center;">
<div style="text-align:center;">
Line 642: Line 642:


</div>
</div>
Although the FunKey Team is not currently selling any accessories for the FunKey S aside from what is included with it, the editors of this wiki have compiled [[List of FunKey S compatible keychain accessories|a list of products]] that can be used in conjunction with the FunKey S, including adapters, power banks, cables, pouches, and keychain decorations. To match the FunKey S keychain aesthetic, all accessories listed have been checked to not exceed size or weight levels that would make putting them on a keychain difficult and/or inconvenient. Additionally, all items on the list have been checked (to the best ability of the editors) for description accuracy, payment security, and product reliability. Despite this, prior to buying any accessory, please be sure to verify that it meets your requirements, as neither the FunKey Wiki editors nor the FunKey Team are responsible for the reliability of third-party products.
Although the FunKey Team is not currently selling any accessories for the FunKey S aside from what is included with it, the editors of this wiki have compiled [[List of FunKey S compatible keychain accessories|a list of products]] that can be used in conjunction with the FunKey S, including adapters, power banks, cables, pouches, and keychain decorations. To match the FunKey S keychain aesthetic, research has been conducted to ensure that all listed accessories do not exceed size or weight levels that would make putting them on a keychain inconvenient. While the editors of this wiki have conducted extensive research to confirm that all products listed are compatible and reliable, neither the editors nor the FunKey Team are responsible for the reliability of third-party products. Therefore, prior to making any purchase, users should verify that a listed product adequately meets their needs.


<div style="text-align:center;">
<div style="text-align:center;">
Line 648: Line 648:


</div>
</div>
As both the hardware specifications and operating system of the FunKey S have been open sourced on the FunKey Team's [https://github.com/FunKey-Project GitHub page], users are able and encouraged to create their own software for the device and share it with others. To facilitate this, an SDK has been created and made [https://github.com/FunKey-Project/FunKey-OS/releases/tag/FunKey-OS-2.0.0 available] for [[FunKey-OS]] software development. Additionally, a [https://doc.funkey-project.com/developers/hardware_ref/design/ development guide] is available on the documentation page of the FunKey website. The FunKey Wiki maintains a [[List of third-party OPK applications|database]] of all publicly available software developed for the FunKey S, so developers who wish to create an article for their program or add it to one of the lists can either edit the wiki themselves or ask a wiki editor to do so for them.
As both the hardware specifications and operating system of the FunKey S are open source and documented on the FunKey Team's [https://github.com/FunKey-Project GitHub page], users are able and encouraged to develop their own software for the device. To facilitate this, an SDK has been created and made [https://github.com/FunKey-Project/FunKey-OS/releases/tag/FunKey-OS-2.0.0 available] for [[FunKey-OS]] software development. Additionally, a [https://doc.funkey-project.com/developers/hardware_ref/design/ development guide] is available on the documentation page of the FunKey website. The FunKey Wiki maintains a [[List of third-party OPK applications|database]] of all third-party software developed for the FunKey S, so developers who wish to create an article for their program or add it to one of the lists can either edit the wiki themselves or ask a wiki editor to do so for them.


<div style="text-align:center;">
<div style="text-align:center;">
Line 660: Line 660:


</div>
</div>
While the FunKey Team's numerous social media pages are represented with the icons at the top of this page, they can be contacted directly via the [https://www.funkey-project.com/contact contact page] on their website. If you wish to email them, questions regarding the FunKey S can be sent to their [mailto:support@funkey-project.com support] email address, while other inquiries can be sent to their [mailto:contact@funkey-project.com contact] email address.
While the FunKey Team's numerous social media pages are represented with the icons at the top of this page, they can be contacted directly via the [https://www.funkey-project.com/contact contact page] of their website. If you wish to email them, questions regarding the FunKey S can be sent to their [mailto:support@funkey-project.com support] email address, while other inquiries can be sent to their [mailto:contact@funkey-project.com contact] email address.


<div style="text-align:center;">
<div style="text-align:center;">
Line 672: Line 672:


</div>
</div>
In addition to the [https://www.funkey-project.com/#comp-k9gow1reform email newsletter] on their website, the FunKey Team posts regular updates about the FunKey S on [https://www.kickstarter.com/projects/squonk/funkey-s-the-worlds-smallest-foldable-handheld-console/posts Kickstarter]. Recent news updates are regularly reformatted and posted on the main page of The FunKey Wiki, with summaries of past news updates available at the [[The FunKey Times]]. Users wishing to discuss recent news updates are recommended to join the [[FunKey Community Discord Server]].
In addition to the [https://www.funkey-project.com/#comp-k9gow1reform email newsletter] on their website, the FunKey Team posts regular updates about the FunKey S on [https://www.kickstarter.com/projects/squonk/funkey-s-the-worlds-smallest-foldable-handheld-console/posts their Kickstarter page]. Recent news updates are regularly reformatted and posted on the main page of the FunKey Wiki, with summaries of past news updates available in the [[The FunKey Times]]. Users wishing to discuss recent news updates are recommended to join the [[FunKey Community Discord Server]].


<div style="text-align:center;">
<div style="text-align:center;">
Line 678: Line 678:


</div>
</div>
The FunKey Wiki is a community-managed database of FunKey S information, operated and edited independently of the FunKey Team. Currently, the Administrator of and primary contributor to The FunKey Wiki is [[User:CoolieCoolster|CoolieCoolster]], but anyone is free to contribute to the improvement of the wiki!
The FunKey Wiki is a community-managed database of FunKey S information, operated and edited independently of the FunKey Team. Currently, the Administrator of and primary contributor to the FunKey Wiki is [[User:CoolieCoolster|CoolieCoolster]], but anyone is free to contribute to the improvement of the wiki!


<div style="text-align:center;">
<div style="text-align:center;">
Line 690: Line 690:


</div>
</div>
Since The FunKey Wiki uses the [[w:MediaWiki|MediaWiki]] wiki engine, the same markdown format that is used to edit other MediaWiki wikis such as Wikipedia is also used here. If you wish to learn the MediaWiki markdown format, MediaWiki has [[mw:Manual:FAQ#Basic usage|several tutorials]] on their website in addition to a [https://discord.gg/ZrV2Ex9 Discord server] where users can ask questions, but if you have any specific questions about editing or templates used on The FunKey Wiki, you may also ask [[User talk:CoolieCoolster|the FunKey Wiki admin]].
Since The FunKey Wiki uses the [[w:MediaWiki|MediaWiki]] wiki engine, the same markdown format that is used to edit other MediaWiki wikis such as Wikipedia is also used here. If you wish to learn the MediaWiki markdown format, MediaWiki has [[mw:Manual:FAQ#Basic usage|several tutorials]] on their website in addition to a [https://discord.gg/ZrV2Ex9 Discord server] where users can ask questions, but if you have any specific questions about editing or templates used on the FunKey Wiki, you may also ask [[User talk:CoolieCoolster|the FunKey Wiki admin]].


<div style="text-align:center;">
<div style="text-align:center;">
Line 696: Line 696:


</div>
</div>
Users who are fluent in a language other than English are encouraged to translate one or more of the wiki's pages into that language to improve the helpfulness of the wiki. To translate any page marked for translation, select the "Translate" text above the list of the available languages at the top of that page. If a page has already been translated into a language that you speak fluently, you are free to analyze and improve the translation. If you have translated a page but are unsure on how to implement the translation, feel free to ask [[User talk:CoolieCoolster|the FunKey Wiki admin]] for assistance. For more information about translating on the FunKey Wiki, visit the [[FunKey Wiki Translation Center|Translation Center]].
Users who are fluent in a language other than English are encouraged to translate one or more of the wiki's pages into that language to improve the helpfulness of the wiki. To translate any page marked for translation, select the ''Translate'' text above the list of the available languages at the top of that page. If a page has already been translated into a language that you speak fluently, you are free to analyze and improve the translation. If you have translated a page but are unsure on how to implement the translation, feel free to ask [[User talk:CoolieCoolster|the FunKey Wiki admin]] for assistance. For more information about translating on the FunKey Wiki, visit the [[FunKey Wiki Translation Center|Translation Center]].


<div style="text-align:center;">
<div style="text-align:center;">