a507bb2837
The main "innovation" in this patch are two "virtual buttons" for the record switch on YH92x targets. When the switch state changes, a single BUTTON_REC_SW_ON or .._OFF button event will be generated. Thus keymap code can react on switching, but not on the actual state of the switch. Wherever sensible, the following user scheme is applied: - use PLAY as confirm button - use REW button or Long REW to exit - use REC (YH820) or FFWD (YH92X) as modifier key for button combos Change-Id: Ic8d1db9cc6869daed8dda98990dfdf7f6fd5d5a1
184 lines
7 KiB
TeX
184 lines
7 KiB
TeX
\subsection{\label{ref:Chip8emulator}Chip{}-8 Emulator}
|
|
Chip8 is a kind of assembly language for a long-gone architecture.
|
|
This plugin runs games written using the chip8 instructions.
|
|
To start a game open a \fname{.ch8} file in the \setting{File Browser}
|
|
|
|
There are lots of tiny Chip8 games (usually only about 256 bytes to a
|
|
couple of KB) which were made popular by the HP48
|
|
calculator's emulator for them. The original Chip8 had
|
|
64$\times$32 pixel graphics, and the new superchip emulator supports 128$\times$64
|
|
graphics.
|
|
|
|
The only problem is that they are based on a 4$\times$4 keyboard, but since most
|
|
games do not use all of the buttons, this can easily be worked around.
|
|
|
|
To do this, one may put a \fname{.c8k} file with the same name as the
|
|
original program which contains new key mappings (for \fname{BLINKY.ch8}, one
|
|
writes a \fname{BLINKY.c8k} file). That \fname{.c8k} file contains 16
|
|
characters describing the mapping from the Chip8 keyboard to the default key
|
|
mapping (that way, several Chip8 keys can be pressed using only one
|
|
Rockbox key). For example, a file containing the single line:
|
|
\begin{code}
|
|
0122458469ABCDEF
|
|
\end{code}
|
|
would correspond to the following non-default mappings:
|
|
|
|
3 $\rightarrow$ 2, 6 $\rightarrow$ 8, 7 $\rightarrow$4, 8 $\rightarrow$ 6.
|
|
|
|
The default keymappings are:
|
|
\begin{table}
|
|
\begin{center}
|
|
\begin{tabularx}{.9\textwidth}{c|ccccccccccccccccc}
|
|
\toprule
|
|
Chip8 & Off & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9
|
|
& A & B & C & D & E & F\\
|
|
\midrule
|
|
\begin{sideways}Key\end{sideways}
|
|
&
|
|
% key "off"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
|
|
\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu}
|
|
\opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
|
|
,GIGABEAT_PAD,MROBE100_PAD,SANSA_FUZE_PAD,SANSA_FUZEPLUS_PAD}
|
|
{\ButtonPower}
|
|
\opt{GIGABEAT_S_PAD}{\ButtonBack}
|
|
\opt{PBELL_VIBE500_PAD}{\ButtonRec}
|
|
\opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRew}
|
|
\opt{MPIO_HD200_PAD}{\ButtonRec + \ButtonPlay}
|
|
\opt{MPIO_HD300_PAD}{Long \ButtonMenu}
|
|
\end{sideways}
|
|
&
|
|
% Key "0"
|
|
\begin{sideways}
|
|
\opt{SANSA_FUZEPLUS_PAD}{\ButtonVolDown}
|
|
\opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonFF}
|
|
\end{sideways}
|
|
&
|
|
% "Key "1"
|
|
\begin{sideways}
|
|
\opt{SANSA_FUZEPLUS_PAD}{\ButtonBack}
|
|
\opt{RECORDER_PAD}{\ButtonFOne}
|
|
\opt{ONDIO_PAD,SANSA_FUZEPLUS_PAD}{\ButtonUp}
|
|
\opt{GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonMenu}
|
|
\opt{MPIO_HD200_PAD,MPIO_HD300_PAD}{\ButtonRew}
|
|
\end{sideways}
|
|
&
|
|
% Key "2"
|
|
\begin{sideways}
|
|
\opt{IPOD_4G_PAD,IPOD_3G_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD}
|
|
{\ButtonScrollBack}
|
|
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD%
|
|
,RECORDER_PAD,ONDIO_PAD,SANSA_FUZEPLUS_PAD,GIGABEAT_S_PAD%
|
|
,MROBE100_PAD,PBELL_VIBE500_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonUp}
|
|
\opt{IRIVER_H10_PAD}{\ButtonScrollUp}
|
|
\opt{SANSA_C200_PAD}{\ButtonVolUp}
|
|
\opt{MPIO_HD200_PAD,MPIO_HD300_PAD}{\ButtonFF}
|
|
\end{sideways}
|
|
&
|
|
% Key "3"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD}{\ButtonFThree}
|
|
\opt{MROBE100_PAD,SANSA_FUZEPLUS_PAD}{\ButtonPlay}
|
|
\opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolDown}
|
|
\opt{MPIO_HD200_PAD}{\ButtonFunc}
|
|
\opt{MPIO_HD300_PAD}{\ButtonMenu}
|
|
\end{sideways}
|
|
&
|
|
% Key "4"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD%
|
|
,IPOD_3G_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD%
|
|
,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
|
|
,SANSA_FUZE_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD%
|
|
,SAMSUNG_YH820_PAD}{\ButtonLeft}
|
|
\opt{MPIO_HD200_PAD}{\ButtonRec}
|
|
\opt{MPIO_HD300_PAD}{\ButtonEnter}
|
|
\end{sideways}
|
|
&
|
|
% Key "5"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD}{\ButtonPlay}
|
|
\opt{ONDIO_PAD}{\ButtonMenu}
|
|
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD%
|
|
,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
|
|
,SANSA_FUZE_PAD,SANSA_FUZEPLUS_PAD}
|
|
{\ButtonSelect}
|
|
\opt{IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}%
|
|
{\ButtonPlay}
|
|
\opt{PBELL_VIBE500_PAD}{\ButtonOK}
|
|
\opt{MPIO_HD200_PAD}{\ButtonPlay}
|
|
\opt{MPIO_HD300_PAD}{\ButtonRec}
|
|
\end{sideways}
|
|
&
|
|
% Key "6"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD%
|
|
,IPOD_3G_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD%
|
|
,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
|
|
,SANSA_FUZE_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD%
|
|
,SAMSUNG_YH820_PAD}{\ButtonRight}
|
|
\opt{MPIO_HD200_PAD}{\ButtonVolDown}
|
|
\opt{MPIO_HD300_PAD}{\ButtonPlay}
|
|
\end{sideways}
|
|
&
|
|
% Key "7"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD}{\ButtonFTwo}
|
|
\opt{MROBE100_PAD}{\ButtonDisplay}
|
|
\opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolUp}
|
|
\opt{MPIO_HD200_PAD}{\ButtonVolUp}
|
|
\opt{MPIO_HD300_PAD}{\ButtonScrollUp}
|
|
\opt{SANSA_FUZEPLUS_PAD}{\ButtonBottomLeft}
|
|
\end{sideways}
|
|
&
|
|
% Key "8"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD%
|
|
,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,PBELL_VIBE500_PAD,SAMSUNG_YH92X_PAD%
|
|
,SAMSUNG_YH820_PAD}{\ButtonDown}
|
|
\opt{IPOD_4G_PAD,IPOD_3G_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD}
|
|
{\ButtonScrollFwd}
|
|
\opt{IAUDIO_X5_PAD,SANSA_FUZEPLUS_PAD}{\ButtonDown}
|
|
\opt{IRIVER_H10_PAD,MPIO_HD300_PAD}{\ButtonScrollDown}
|
|
\opt{SANSA_C200_PAD}{\ButtonVolDown}
|
|
\end{sideways}
|
|
&
|
|
% Key "9"
|
|
\begin{sideways}
|
|
\opt{RECORDER_PAD}{\ButtonOn}
|
|
\opt{GIGABEAT_PAD}{\ButtonA}
|
|
\opt{GIGABEAT_S_PAD}{\ButtonPlay}
|
|
\opt{SANSA_FUZEPLUS_PAD}{\ButtonBottomRight}
|
|
\end{sideways}
|
|
&
|
|
% Key "A"
|
|
\begin{sideways}
|
|
\opt{SANSA_FUZEPLUS_PAD}{\ButtonVolUp}
|
|
\end{sideways}
|
|
&
|
|
% Key "B"
|
|
&
|
|
% Key "C"
|
|
&
|
|
% Key "D"
|
|
&
|
|
% Key "E"
|
|
&
|
|
% Key "F"
|
|
\\\bottomrule
|
|
\end{tabularx}
|
|
\end{center}
|
|
\end{table}
|
|
|
|
Some places where can you can find \fname{.ch8} files:
|
|
\begin{itemize}
|
|
\item The PluginChip8 page on www.rockbox.org has several attached:
|
|
\wikilink{PluginChip8}
|
|
\item Check out the HP48 chip games section:
|
|
\url{http://www.hpcalc.org/hp48/games/chip/}
|
|
\item PC emulator by the guy who wrote the HP48 emulator:
|
|
\url{http://www.pdc.kth.se/~lfo/chip8/CHIP8.htm}
|
|
\item Links to other chip8 emulators:
|
|
\url{http://www.zophar.net/chip8.html}
|
|
\end{itemize}
|