mirror of
https://github.com/vonmillhausen/sf2000.git
synced 2024-09-16 10:34:55 +02:00
25ce2e3221
There was a lot of repeated JS across all my tools (e.g., image conversion, BIOS hash checking, etc.), and so I decided to move all shared code out to its own separate library. This will improve scalability and maintainability at the cost of portability - a fair trade in my opinion. This work also involved large-scale refactoring of all of the tools. There's no actual functional difference (all the tools should behave exactly the same), bar some UI improvements for the oldest tools as a result of moving to the same codebase used by the more recent tools.
527 lines
29 KiB
HTML
527 lines
29 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<title>Data Frog SF2000 Button Mapping Tool</title>
|
|
<meta name="viewport" content="width=device-width">
|
|
<link rel="stylesheet" href="tools.css">
|
|
</head>
|
|
<body>
|
|
<h1>Data Frog SF2000 Button Mapping Tool</h1>
|
|
<p>This tool lets you alter the button mappings for the SF2000 hand-held console; it can generate per-game mappings (NOTE: only possible on firmwares prior to the May 15th firmware), as well as alter the global mappings defined in the device's <code>bisrv.asd</code> BIOS file or in the <code>KeyMapInfo.kmp</code> file used by newer BIOS versions. As the SF2000 supports multiplayer gaming via an optional wireless controller (sold separately), mappings for both Player 1 and Player 2 are possible.</p>
|
|
<p> Please note this tool is provided as-is, and no support will be given if this corrupts your device's BIOS or keymap file; make sure you have backups of anything you care about before messing with your device's critical files! 🙂</p>
|
|
<p>This tool was originally written by nikita.burnashev (email) gmail.com; it was re-written (mostly just re-styled) by myself upon their request.</p>
|
|
<hr>
|
|
<div id="steps">
|
|
<section id="fileSection">
|
|
<h2>Step 1: Select <code>bisrv.asd</code> or a game ROM</h2>
|
|
<p>Select the <code>bisrv.asd</code> (for global device mappings) or game ROM file (for per-game mappings) whose button mappings you want to modify. You can find the <code>bisrv.asd</code> file in the <code>bios</code> folder on your device's microSD card.</p>
|
|
<div id="fileMessages"></div>
|
|
<div class="controlContainer">
|
|
<label class="control">Open file: <input id="fileSelector" type="file" onchange="fileLoad(event.target.files[0])"></label>
|
|
</div>
|
|
</section>
|
|
</div>
|
|
<script src="tools.js"></script>
|
|
<script>
|
|
|
|
// Global variables...
|
|
var mappingTableOffset; // Will contain the offset of the button mappings within the data file
|
|
var mappingConsoles; // Will contain a list of the specific game consoles we'll be setting up mappings for
|
|
var firmwareVersion; // Will contain the firmware version if the user selects a bisrv.asd file
|
|
var mappingData; // Used to store the binary data that will eventually be written to the downloadable file
|
|
var fileName; // Will hold the name of the selected file, used for naming ROM .kmp files
|
|
|
|
// Utility function: getButtonMap(int index)
|
|
// =========================================
|
|
// This function returns data about how given buttons on the SF2000
|
|
// map to controls provided by the device's emulators.
|
|
// Thanks to @notv37 :)
|
|
// https://discord.com/channels/741895796315914271/1099465777825972347/1104285497804738640
|
|
function getButtonMap(index) {
|
|
if (mappingConsoles[index] == "Genesis/Mega Drive, Master System")
|
|
return { 'A': 8, 'B': 0, 'C': 1, 'X': 10, 'Y': 11, 'Z': 9 };
|
|
else if (mappingConsoles[index] == "Arcade") // FIXME
|
|
return { 'A': 8, 'B': 0, 'C': 1, 'X': 10, 'Y': 11, 'Z': 9 };
|
|
else if (mappingConsoles[index] == "SNES")
|
|
return { 'A': 8, 'B': 0, 'X': 10, 'Y': 11, 'L': 9, 'R': 1 };
|
|
else // GBA, GB/GBC, NES
|
|
return { 'A': 8, 'B': 0, 'L': 10, 'R': 11, 'X': 9, 'Y': 1 };
|
|
}
|
|
|
|
// This function is called whenever a file is selected in Step 1...
|
|
function fileLoad(file) {
|
|
|
|
// Create a FileReader object, and read in the selected file's contents as
|
|
// an array buffer...
|
|
var fr = new FileReader();
|
|
fr.readAsArrayBuffer(file);
|
|
fr.onload = function(event) {
|
|
|
|
// Clear out any HTML that might already exist after Step 1...
|
|
while(document.getElementById("fileSection").nextSibling) {
|
|
document.getElementById("fileSection").nextSibling.remove();
|
|
}
|
|
|
|
// Clear any old messages...
|
|
document.getElementById("fileMessages").innerHTML = "";
|
|
|
|
// We'll also reset the firmwareVersion global variable...
|
|
firmwareVersion = null;
|
|
|
|
// Read the provided file's data from the buffer array into an unsigned 8-bit int array...
|
|
var data = new Uint8Array(event.target.result);
|
|
|
|
// We'll do a hash-check against it, even if it's not a bisrv.asd...
|
|
hashResult = getFirmwareHash(data);
|
|
|
|
// The result could be either a Promise if it had a bisrv.asd-like structure and we got
|
|
// a hash, or false otherwise... let's check!
|
|
if (hashResult instanceof Promise) {
|
|
|
|
// We got a Promise! Wait for it to finish so we get our bisrv.asd hash...
|
|
hashResult.then(function(dataHash) {
|
|
|
|
// If we have a newer bisrv.asd that stores button mappings in an external KeyMapInfo.kmp,
|
|
// we'll need a Step 1b to load that file as well...
|
|
var step1BRequired = false;
|
|
|
|
// Check the hash against all the known good ones...
|
|
firmwareVersion = knownHash(dataHash);
|
|
switch (firmwareVersion) {
|
|
// Mid-March BIOS...
|
|
case "03.15":
|
|
mappingTableOffset = 0x8DBC0C;
|
|
mappingConsoles = ["Arcade", "Game Boy Advance", "SNES", "Genesis/Mega Drive, Master System", "NES, Game Boy, Game Boy Color"];
|
|
setMessage("info", "fileMessages", "INFO: Mid-March <code>bisrv.asd</code> detected.");
|
|
break;
|
|
|
|
// April 20th BIOS...
|
|
case "04.20":
|
|
mappingTableOffset = 0x8DBC9C;
|
|
mappingConsoles = ["Arcade", "Game Boy Advance", "Game Boy, Game Boy Color", "SNES", "Genesis/Mega Drive, Master System", "NES"];
|
|
setMessage("info", "fileMessages", "INFO: April 20th <code>bisrv.asd</code> detected.");
|
|
break;
|
|
|
|
// May 15th BIOS...
|
|
case "05.15":
|
|
mappingTableOffset = 0;
|
|
mappingConsoles = ["NES", "Genesis/Mega Drive, Master System", "SNES", "Game Boy, Game Boy Color", "Game Boy Advance", "Arcade"];
|
|
step1BRequired = true;
|
|
setMessage("info", "fileMessages", "INFO: May 15th <code>bisrv.asd</code> detected.");
|
|
break;
|
|
|
|
// May 22nd BIOS...
|
|
case "05.22":
|
|
mappingTableOffset = 0;
|
|
mappingConsoles = ["NES", "SNES", "Genesis/Mega Drive, Master System", "Game Boy, Game Boy Color", "Game Boy Advance", "Arcade"];
|
|
step1BRequired = true;
|
|
setMessage("info", "fileMessages", "INFO: May 22nd <code>bisrv.asd</code> detected.");
|
|
break;
|
|
|
|
default:
|
|
// Huh... wasn't false so had bisrv.asd structure, but didn't return
|
|
// a known hash... a new BIOS version? Unknown anyway!
|
|
console.log(dataHash);
|
|
setMessage("error", "fileMessages", "ERROR: While the file you've selected does appear to be generally structured like the SF2000's <code>bisrv.asd</code> BIOS file, the specifics of your file don't match any known SF2000 BIOS version. As such, this tool cannot safely modify the selected file.");
|
|
return;
|
|
break;
|
|
}
|
|
|
|
// If we're here, then we got some kind bisrv.asd file we're happy with; we'll set
|
|
// mappingData to it's full contents...
|
|
mappingData = data;
|
|
|
|
// Keep a record of the input file's name as well...
|
|
fileName = file.name;
|
|
|
|
// Check if we need a KeyMapInfo.kmp file to be provided as well...
|
|
if (step1BRequired) {
|
|
// Yup, we're going to need a KeyMapInfo.kmp file as well...
|
|
stepOneB();
|
|
}
|
|
else {
|
|
// Nope, we're all good; go ahead call our Step Two function...
|
|
stepTwo();
|
|
}
|
|
|
|
});
|
|
}
|
|
else {
|
|
// We got false, so whatever it was, it wasn't a bisrv.asd... let's check some other
|
|
// possibilities...
|
|
if (data.length == 288) {
|
|
// That's the correct length for a KeyMapInfo.kmp file, however we must know the host
|
|
// BIOS version before we can correctly process those files. Let the user know...
|
|
setMessage("error", "fileMessages", "ERROR: The file you've provided may be a <code>KeyMapInfo.kmp</code> button map file; however as the internal data structure of these files varies depending on the version of the host BIOS, you must select your device's <code>bisrv.asd</code> file first. You can find this file in the <code>bios</code> folder on your device's microSD card.");
|
|
return;
|
|
}
|
|
// If we're still checking, next test the file extensions for the individual console's ROMs...
|
|
else if (/\.(zfb|zip)$/i.exec(file.name)) {
|
|
// The file's name ends with .zfb or .zip - assume it's an arcade ROM!
|
|
mappingConsoles = ["Arcade"];
|
|
}
|
|
else if (/\.(zgb|gba|agb|gbz)$/i.exec(file.name)) {
|
|
// The file's name ends with .zgb, .gba, .agb or .gbz - assume it's a Game Boy Advance ROM!
|
|
mappingConsoles = ["Game Boy Advance"];
|
|
}
|
|
else if (/\.(gbc|gb|sgb)$/i.exec(file.name)) {
|
|
// The file's name ends with .gbc, .gb or .sgb - assume it's a Game Boy or Game Boy Color ROM!
|
|
mappingConsoles = ["Game Boy, Game Boy Color"];
|
|
}
|
|
else if (/\.(zsf|smc|fig|sfc|gd3|gd7|dx2|bsx|swc)$/i.exec(file.name)) {
|
|
// The file's name ends with .zsf, .smc, .fig, .sfc, .gd3, .gd7, .dx2, .bsx or .swc - assume it's a SNES ROM!
|
|
mappingConsoles = ["SNES"];
|
|
}
|
|
else if (/\.(zmd|bin|md|smd|gen|sms)$/i.exec(file.name)) {
|
|
// The file's name ends with .zmd, .bin, .md, .smd, .gen or .sms - assume it's a Genesis/Mega Drive or Master System ROM!
|
|
mappingConsoles = ["Genesis/Mega Drive, Master System"];
|
|
}
|
|
else if (/\.(zfc|nes|nfc|fds|unf)$/i.exec(file.name)) {
|
|
// The file's name ends with .zfc, .nes, .nfc, .fds or .unf - assume it's a NES ROM!
|
|
mappingConsoles = ["NES"];
|
|
}
|
|
else {
|
|
// Oh dear, the provided file didn't match any of the above rules! Display an error
|
|
// to the user...
|
|
setMessage("error", "fileMessages", "ERROR: The selected file does not appear to be a known <code>bisrv.asd</code> file, a <code>KeyMapInfo.kmp</code> file, or a game ROM with a known extension!");
|
|
return;
|
|
}
|
|
|
|
// If we're here, then we got some kind of non-bisrv.asd file we're happy with. If
|
|
// mappingConsoles only contains one entry, then it was a ROM file, and we'll want to
|
|
// initialise our mappingData array with 48 slots; otherwise, it was a KeyMapInfo.kmp
|
|
// and we'll set mappingData to it's full contents instead...
|
|
if (mappingConsoles.length == 1) {
|
|
mappingData = new Uint8Array(48);
|
|
}
|
|
else {
|
|
mappingData = data;
|
|
}
|
|
|
|
// In both cases, the mapping data begins at the very start of our data stream...
|
|
mappingTableOffset = 0;
|
|
|
|
// Keep a record of the input file's name as well...
|
|
fileName = file.name;
|
|
|
|
// Go ahead call our Step Two function...
|
|
stepTwo();
|
|
}
|
|
}
|
|
}
|
|
|
|
// This function is called if the file selected in Step 1 is a bisrv.asd
|
|
// version that relies on an external KeyMapInfo.kmp file - so we also
|
|
// need the user to supply that...
|
|
function stepOneB() {
|
|
|
|
// Build our HTML...
|
|
var html = "<section id=\"stepOneB\"><h2>Step 1b: Select <code>KeyMapInfo.kmp</code></h2><p>This version of the SF2000 BIOS reads its button mappings from an external file called <code>KeyMapInfo.kmp</code>, stored in the <code>Resources</code> folder on the microSD card. Please select your device's <code>KeyMapInfo.kmp</code> file now.</p><div id=\"stepOneBMessages\"></div><div class=\"controlContainer\"><label class=\"control\">Open <code>KeyMapInfo.kmp</code>: <input id=\"keyMapInfoSelector\" type=\"file\" accept=\".kmp\"></label></div></section>";
|
|
|
|
// Add a <hr> separator after the last step, and append the new step...
|
|
document.getElementById("steps").insertAdjacentHTML("beforeend", "<hr>");
|
|
document.getElementById("steps").insertAdjacentHTML("beforeend", html);
|
|
|
|
// Attach our event handler to our new file input control...
|
|
var keyMapInfoInput = document.getElementById("keyMapInfoSelector");
|
|
keyMapInfoInput.addEventListener("change", function() {
|
|
|
|
// The user has chosen a new file; it should be a KeyMapInfo.kmp file,
|
|
// so let's do our best to check!
|
|
|
|
// First, clear out any HTML that might already exist after Step 1b...
|
|
while(document.getElementById("stepOneB").nextSibling) {
|
|
document.getElementById("stepOneB").nextSibling.remove();
|
|
}
|
|
|
|
// Clear any old messages...
|
|
document.getElementById("stepOneBMessages").innerHTML = "";
|
|
|
|
// Next, read in the contents of the user-provided file...
|
|
var frKMI = new FileReader();
|
|
fileName = event.target.files[0].name;
|
|
frKMI.readAsDataURL(event.target.files[0]);
|
|
frKMI.onload = function(event) {
|
|
|
|
// Get the file's data and data type...
|
|
var fileData = event.target.result;
|
|
var dataType = fileData.substring(5, fileData.indexOf(";"));
|
|
|
|
// Check to make sure the data type is binary...
|
|
if (dataType === "application/octet-stream") {
|
|
|
|
// The user selected a file that appears to contain binary data; it's
|
|
// a good candidate! Let's check its length next...
|
|
var base64Data = fileData.substring(fileData.indexOf(",") + 1);
|
|
var binaryData = atob(base64Data);
|
|
if (binaryData.length == 288) {
|
|
|
|
// It's the right length - let's assume it's a KeyMapInfo.kmp!
|
|
// We'll assign it to our global mappingData variable, and
|
|
// we'll proceed to Step 2...
|
|
mappingData = new Uint8Array(binaryData.length);
|
|
for (var i = 0; i < binaryData.length; i++) {
|
|
mappingData[i] = binaryData.charCodeAt(i);
|
|
}
|
|
stepTwo();
|
|
|
|
}
|
|
else {
|
|
|
|
// Wrong length for a KeyMapInfo.kmp file!
|
|
setMessage("error", "stepOneBMessages", "ERROR: The selected file does not appear to be a valid <code>KeyMapInfo.kmp</code> file.");
|
|
return;
|
|
}
|
|
}
|
|
else {
|
|
|
|
// The file the user selected doesn't appear to be binary data, so
|
|
// highly unlikely to be a KeyMapInfo.kmp file...
|
|
setMessage("error", "stepOneBMessages", "ERROR: The selected file does not appear to be a valid <code>KeyMapInfo.kmp</code> file.");
|
|
return;
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
// This function triggers automatically when the user selects a valid
|
|
// file (or files) in Step 1...
|
|
function stepTwo() {
|
|
|
|
// We're going to be creating a bunch of HTML here; we want to display
|
|
// banks of mapping controls to the user, one bank per console. Each
|
|
// bank will have a heading specifying which console it's for, and then
|
|
// a section each for Player 1 and Player 2. Each player section will
|
|
// have a list of the six SF2000 buttons that are available to be
|
|
// mapped, and for each a selection box of the target console's buttons
|
|
// for the mapping. There'll also be a checkbox per button, which can
|
|
// be checked to enable "autofire" on that button.
|
|
var html = "<section id=\"mappingSection\"><h2>Step 2: Choose your button mappings</h2>";
|
|
|
|
// First, we need to update Step 2's instructions, depending on whether
|
|
// or not the user supplied a bisrv.asd file or KeyMapInfo.kmp
|
|
// (multiple consoles) or a ROM (one console)...
|
|
if (mappingConsoles.length > 1) {
|
|
|
|
// They provided a bisrv.asd or a KeyMapInfo.kmp file!
|
|
html += "<p>Below you will see the current global button mappings for the file you provided. Each tile covers the button mappings for a different game console - the physical SF2000 buttons are on the left, and the virtual console buttons are in the middle. On the right are some \"autofire\" checkboxes - if the box for a button is checked, it means holding that button down will trigger multiple repeated button presses in the virtual console automatically. As the SF2000 supports local multiplayer via the use of a second wireless controller, there are <i>two</i> sets of button mappings per console - one for Player 1 and one for Player 2. When you have finished tweaking your button mappings, proceed to Step 3.</p>";
|
|
}
|
|
else {
|
|
|
|
// They provided a ROM file!
|
|
html += "<p>Below you will see an empty \"" + mappingConsoles[0] + "\" button mapping table, which will be used to create a unique button mapping profile for \"" + fileName + "\". In the table, the physical SF2000 buttons are on the left, and the virtual console buttons are in the middle. On the right are some \"autofire\" checkboxes - if the box for a button is checked, it means holding that button down will trigger multiple repeated button presses in the virtual console automatically. As the SF2000 supports local multiplayer via the use of a second wireless controller, there are <i>two</i> sets of button mappings per console - one for Player 1 and one for Player 2. When you have finished tweaking your button mappings, proceed to Step 3.</p>";
|
|
}
|
|
html += "<div class=\"controlContainer\">";
|
|
|
|
// Next we'll be looping through all of the consoles we'll be setting
|
|
// up mappings for...
|
|
var presentationButtonOrder = ['A', 'B' ,'X', 'Y', 'L', 'R'];
|
|
for (var currentConsole = 0; currentConsole < mappingConsoles.length; currentConsole++) {
|
|
|
|
// This console's bank of mapping controls will be stored in a <div>,
|
|
// and we'll add a <h3> header for good measure as well...
|
|
html += "<div class=\"control\"><h3>" + mappingConsoles[currentConsole] + "</h3>";
|
|
|
|
// Get the button mapping for this console...
|
|
var buttonMap = getButtonMap(currentConsole);
|
|
|
|
// We'll add two tables of control mappings to the <div>, one each
|
|
// for Player 1 and Player 2...
|
|
for (var player = 0; player < 2; player++) {
|
|
|
|
// Start creating our table HTML...
|
|
html += "<table><caption>Player " + (player + 1) + "</caption>";
|
|
html += "<thead><tr><th class=\"alignL\">SF2000</th><th>Console</th><th>Autofire</th></tr></thead>";
|
|
html += "<tbody>";
|
|
|
|
// Loop through all the SF2000's buttons (well, the ones that can
|
|
// be mapped, anyway)...
|
|
for (var button = 0; button < 6; button++) {
|
|
|
|
// By default, the SF2000 stores its button maps in XYLABR
|
|
// order... except for GBA under newer firmware versions where
|
|
// the order is LRXABY for some reason. We specify the order the
|
|
// bytes are in here. If they do other weird stuff in the future,
|
|
// it'll probably be here that needs to change!
|
|
var buttonByteOrder = ['X', 'Y' ,'L', 'A', 'B', 'R'];
|
|
if (mappingConsoles[currentConsole] == "Game Boy Advance" && ["05.15", "05.22"].includes(firmwareVersion)) {
|
|
buttonByteOrder = ['L', 'R', 'X', 'A', 'B', 'Y'];
|
|
}
|
|
|
|
// Calculate our offset within our mapping data for the current
|
|
// button...
|
|
var offset = mappingTableOffset + (currentConsole * 48) + (player * 24) + (buttonByteOrder.indexOf(presentationButtonOrder[button]) * 4);
|
|
|
|
// Start creating the HTML data for this row in the table...
|
|
html += "<tr>";
|
|
|
|
// SF2000 Button Name (e.g., "Player 1 X")...
|
|
html += "<td>Player " + (player + 1).toString() + " " + presentationButtonOrder[button] + "</td>";
|
|
|
|
// Console button selection list...
|
|
html += "<td class=\"alignC\">";
|
|
html += "<select id=\"sel" + offset.toString(16) + "\">";
|
|
for (var buttonTable in buttonMap) {
|
|
html += "<option ";
|
|
if (mappingData[offset] == buttonMap[buttonTable]) {
|
|
html += "selected";
|
|
}
|
|
html += ">" + buttonTable + "</option>";
|
|
}
|
|
html += "</select></td>";
|
|
|
|
// Autofire checkbox...
|
|
html += "<td class=\"alignC\"><input id=\"cb" + offset.toString(16) + "\" type=\"checkbox\"";
|
|
if (mappingData[offset + 2] == 1) {
|
|
html += " checked";
|
|
}
|
|
html += "></td>";
|
|
|
|
// And we're finished with the row...
|
|
html += "</tr>";
|
|
}
|
|
|
|
// Close off our table body, and add it to the console's <div>...
|
|
html += "</tbody></table>";
|
|
}
|
|
|
|
// Finally, close this console's <div>...
|
|
html += "</div>";
|
|
}
|
|
|
|
// And finally finally, close the mappingControls <div>...
|
|
html += "</div>";
|
|
|
|
// OK, we're all done displaying our mapping table HTML; trigger Step 3's setup...
|
|
document.getElementById("steps").insertAdjacentHTML("beforeend", "<hr>");
|
|
document.getElementById("steps").insertAdjacentHTML("beforeend", html);
|
|
stepThreeSetup();
|
|
}
|
|
|
|
function stepThreeSetup() {
|
|
|
|
// More HTML in this function! We'll display the appropriate
|
|
// instructions to the user (either how to replace the
|
|
// bisrv.asd/KeyMapInfo.kmp file, or where to put the per-rom .kmp
|
|
// file), as well as generate a button that (when clicked) will
|
|
// download the appropriate file to their device...
|
|
|
|
// First, let's clear any HTML that might already exist after Step 2...
|
|
while(document.getElementById("mappingSection").nextSibling) {
|
|
document.getElementById("mappingSection").nextSibling.remove();
|
|
}
|
|
|
|
// Now let's start building our HTML...
|
|
var html = "<section id=\"saveSection\"><h2>Step 3: Save your mapping changes</h2>";
|
|
|
|
// First up, instructions! These will depend on whether they provided a
|
|
// bisrv.asd, a KeyMapInfo.kmp, or a game ROM...
|
|
if (mappingConsoles.length > 1) {
|
|
if (fileName == "bisrv.asd") {
|
|
|
|
// They provided a bisrv.asd file!
|
|
html += "<p>Click the Download button below to download a new <code>bisrv.asd</code> BIOS file for the SF2000, with your updated global button mappings baked into it. Use it to replace the existing <code>bisrv.asd</code> file in the <code>bios</code> folder on your device's microSD card.</p>";
|
|
}
|
|
else if (fileName == "KeyMapInfo.kmp") {
|
|
|
|
// They provided a KeyMapInfo.kmp file!
|
|
html += "<p>Click the Download button below to download a new <code>KeyMapInfo.kmp</code> keymap file for the SF2000, with your updated global button mappings baked into it. Use it to replace the existing <code>KeyMapInfo.kmp</code> file in the <code>Resources</code> folder on your device's microSD card.</p>";
|
|
}
|
|
else {
|
|
|
|
// They provided a... something!
|
|
html += "<p>Click the Download button below to download an updated version of your file, with your updated global button mappings baked into it. Use it to replace the existing file on your device's microSD card.</p>";
|
|
}
|
|
}
|
|
else {
|
|
|
|
// They provided a ROM file! To make the instructions clearer, let's
|
|
// calculate the name of the keymap file we're generating...
|
|
var kmpFileName = fileName.replace(/($|\.[^.]*$)/, function(m, p1) {return p1.toUpperCase() + '.kmp';});
|
|
|
|
// Now the instructions themselves...
|
|
html += "<p>Click the Download button below to download \"" + kmpFileName + "\", a game-specific keymap file for \"" + fileName + "\". Once downloaded, place it in the <code>save</code> subfolder of the folder where the ROM itself is stored. So for example, if \"" + fileName + "\" is in the <code>ROMS</code> folder on your SF2000's microSD card, place the \"" + kmpFileName + "\" file in <code>ROMS/save/</code>. If the <code>save</code> subfolder does not already exist, create it yourself first.</p>";
|
|
}
|
|
|
|
// Add our download button...
|
|
html += "<div class=\"controlContainer\"><div class=\"control\"><input id=\"downloadButton\" type=\"button\" value=\"Download\"></div></div>";
|
|
|
|
// Close our section...
|
|
html += "</section>";
|
|
|
|
// Finally, add a <hr> separator after the last step, and append the
|
|
// new step...
|
|
document.getElementById("steps").insertAdjacentHTML("beforeend", "<hr>");
|
|
document.getElementById("steps").insertAdjacentHTML("beforeend", html);
|
|
|
|
// Let's add the event handler for our Download button...
|
|
var dButton = document.getElementById("downloadButton");
|
|
dButton.addEventListener("click", function() {
|
|
|
|
// Here, we'll construct the file for the user to download (a
|
|
// modified bisrv.asd, a modified KeyMapInfo.kmp, or a .kmp keymap
|
|
// file), and send it to the user's browser...
|
|
|
|
// We need to loop through all of the mapping form data, read its
|
|
// settings, and use those settings to build the binary data of our
|
|
// button mapping. Loop through all of the consoles we're mapping
|
|
// for...
|
|
var presentationButtonOrder = ['A', 'B' ,'X', 'Y', 'L', 'R'];
|
|
for (var currentConsole = 0; currentConsole < mappingConsoles.length; currentConsole ++) {
|
|
|
|
// Get the button mapping for this console...
|
|
var buttonMap = getButtonMap(currentConsole);
|
|
|
|
// For each player...
|
|
for (var player = 0; player < 2; player++) {
|
|
|
|
// ... and for each button...
|
|
for (var button = 0; button < 6; button++) {
|
|
|
|
// By default, the SF2000 stores its button maps in XYLABR
|
|
// order... except for GBA under newer firmware versions where
|
|
// the order is LRXABY for some reason. We specify the order
|
|
// the bytes are in here. If they do other weird stuff in the
|
|
// future, it'll probably be here that needs to change!
|
|
var buttonByteOrder = ['X', 'Y' ,'L', 'A', 'B', 'R'];
|
|
if (mappingConsoles[currentConsole] == "Game Boy Advance" && ["05.15", "05.22"].includes(firmwareVersion)) {
|
|
buttonByteOrder = ['L', 'R', 'X', 'A', 'B', 'Y'];
|
|
}
|
|
|
|
// Calculate the offset in our mapping data for the current
|
|
// button, read the button settings from the HTML controls, and
|
|
// assign the appropriate values to our binary mappingData...
|
|
var offset = mappingTableOffset + (currentConsole * 48) + (player * 24) + (buttonByteOrder.indexOf(presentationButtonOrder[button]) * 4);
|
|
mappingData[offset] = buttonMap[document.getElementById("sel" + offset.toString(16)).value];
|
|
mappingData[offset + 2] = document.getElementById("cb" + offset.toString(16)).checked ? 1 : 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Now that we've got our updated data, we'll need to check if it's
|
|
// an updated bisrv.asd or not - if it is, we'll need to update some
|
|
// CRC32 check-bits in the bisrv.asd data as well...
|
|
if (mappingConsoles.length > 1 && fileName == "bisrv.asd") {
|
|
|
|
// It's a bisrv.asd alright! Let's do the CRC32 update dance...
|
|
patchCRC32(mappingData);
|
|
}
|
|
|
|
// Next, let's determine the name of the file we're going to send to
|
|
// the user's browser...
|
|
var downloadFileName = fileName;
|
|
if (mappingConsoles.length == 1) {
|
|
downloadFileName = downloadFileName.replace(/($|\.[^.]*$)/, function(m, p1) {return p1.toUpperCase() + '.kmp';});
|
|
}
|
|
|
|
// And finally, send the data to the user's browser as a download...
|
|
downloadToBrowser(mappingData, "application/octet-stream", downloadFileName);
|
|
|
|
});
|
|
}
|
|
</script>
|
|
<hr>
|
|
<p><a rel="license" href="https://creativecommons.org/publicdomain/zero/1.0/">CC0</a>: public domain. Version 1.3, 20230626.1</p>
|
|
</body>
|
|
</html> |