mirror of
https://github.com/libretro/FBNeo.git
synced 2024-11-23 00:49:57 +00:00
87 lines
2.6 KiB
Markdown
87 lines
2.6 KiB
Markdown
# FinalBurn Neo for Raspberry Pi
|
|
|
|
## Important notice
|
|
This port is meant for usage with the old closed-source gpu driver, which has been deprecated since 2019. Anybody using the modern open-source mesa driver should be using the [sdl2 port](README-SDL.md) instead.
|
|
Either way, this port is outdated, unmaintained and currently fails building, so anybody wanting to use this nonetheless will have to fix it first.
|
|
|
|
## Compiling
|
|
To compile the emulator, run `make pi`. You will need SDL 1.2 libraries for
|
|
sound and input:
|
|
|
|
```
|
|
sudo apt-get install libsdl1.2-dev
|
|
```
|
|
|
|
To build on Pi4, you may need additional libraries, including:
|
|
|
|
```
|
|
sudo apt-get install libgles2-mesa-dev libgbm-dev libdrm-dev
|
|
```
|
|
|
|
If you receive "failed to fetch" errors during `apt-get install`, update
|
|
the definitions (`sudo apt-get update`) and try again.
|
|
|
|
## Compatibility
|
|
The emulator runs very smoothly on Pi 1, 2 and 3. It runs on 4, but the
|
|
performance isn't nearly as good.
|
|
|
|
## Input
|
|
To customize joystick input, place a text file in a directory named `joyconfig`.
|
|
The file should have extension `.jc`, and named as follows:
|
|
|
|
```
|
|
<name of romset>.jc
|
|
<name of parent romset>.jc
|
|
capcom6.jc
|
|
default.jc
|
|
```
|
|
|
|
To determine mapping for a particular set, emulator will look for the first
|
|
applicable file, in that order. `capcom6.jc` will only be checked if the set
|
|
is determined to be a 6-button Capcom ROMset, such as SFII, III, etc.
|
|
`default` is a fallback file.
|
|
|
|
For instance, for set `sfau`, emulator will look for `sfau`, `sfa`, `capcom6`,
|
|
then `default`, in that order. For `mkr4` (Mortal Kombat rev 4.0), `mkr4`,
|
|
`mk`, `default` are applicable.
|
|
|
|
### Joyconfig file format
|
|
The format of the file is as follows:
|
|
|
|
```
|
|
<INPUT NAME>=<hardware joystick button number>
|
|
...
|
|
```
|
|
|
|
Input name can be one of: `TEST` (usually `F2` on keyboard), `SERVICE` (`9` on
|
|
keyboard) , `RESET` (`F3`), `QUIT`, `START`, `COIN`, or `BUTTONx` (where `x` is
|
|
a numeric digit between 1 and 9).
|
|
|
|
### Example
|
|
A generic `default` file could look as follows:
|
|
|
|
```
|
|
BUTTON1=1
|
|
BUTTON2=2
|
|
BUTTON3=3
|
|
BUTTON4=4
|
|
BUTTON5=6
|
|
BUTTON6=7
|
|
BUTTON7=8
|
|
COIN=9
|
|
START=10
|
|
```
|
|
|
|
In this case, buttons 1-8 on the hardware joystick map to emulated buttons 1-8,
|
|
while joystick buttons 9 and 10 map to "Coin" and "Start", respectively.
|
|
|
|
## Command-line switches
|
|
`-f`: Enables free play in games that include a Free Play dipswitch. This
|
|
switch isn't guaranteed to always work, since not every game has a free play
|
|
dipswitch, and because different sets may have the switch labeled differently.
|
|
`-F`: Enables free play hack mode. In hack mode, pressing Start also generates
|
|
a Coin button press.
|
|
|
|
## About
|
|
Pi build is maintained by [0xe1f](https://github.com/0xe1f).
|