The-Homebrew-Cloud/N64FlashcartMenu
2
0
Fork 0
mirror of https://github.com/Polprzewodnikowy/N64FlashcartMenu.git synced 2024-11-23 02:59:18 +01:00
Code Issues Packages Projects Releases Wiki Activity
4d2d025a1a
N64FlashcartMenu/index.html

171 lines
9.8 KiB
HTML
Raw Normal View History

deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.5"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>N64FlashcartMenu: N64 Flashcart Menu</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr id="projectrow">
<td id="projectalign">
<div id="projectname">N64FlashcartMenu
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.5 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</div>
<div><div class="header">
<div class="headertitle"><div class="title">N64 Flashcart Menu </div></div>
</div><!--header-->
<div class="contents">
deploy: bd7e33ed71bbc991ac8fbf6c928957614ba5ccb2
2023-08-18 01:21:13 +02:00
<div class="textblock"><p ><a class="anchor" id="md_README"></a>An open source menu for N64 flashcarts.</p>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
<h1><a class="anchor" id="autotoc_md1"></a>
Aims</h1>
<ul>
<li>Support as many N64 FlashCarts as possible.</li>
<li>Be open source, using permissive licensed third party licensed libraries.</li>
<li>Be testable, using unit and smoke tests in ares emulated environment.</li>
<li>Encourage active development from community members and N64 FlashCart owners.</li>
<li>Support as many common mods and features as possible.</li>
</ul>
<h1><a class="anchor" id="autotoc_md2"></a>
deploy: bd7e33ed71bbc991ac8fbf6c928957614ba5ccb2
2023-08-18 01:21:13 +02:00
Current (notable) menu features</h1>
<ul>
<li>Fully Open Source.</li>
deploy: 9eb6a0270709df289f67e3086f3c2be0171be27c
2023-08-28 01:58:20 +02:00
<li>Loads all known N64 games (including iQue and Aleck64 ROMs (even if they are byteswapped)).</li>
deploy: 9603e044e69e8b9e1b94a31a718fbf2a932fd6f3
2023-08-20 20:59:00 +02:00
<li>Emulator support (NES, SNES, GB, GBC) ROMs.</li>
deploy: bd7e33ed71bbc991ac8fbf6c928957614ba5ccb2
2023-08-18 01:21:13 +02:00
<li>N64 ROM box image support.</li>
<li>Background image (PNG) support.</li>
<li>Comprehensive ROM save database (including HomeBrew headers).</li>
<li>Comprehensive ROM information display.</li>
<li>Real Time Clock support.</li>
<li>Music playback (MP3).</li>
</ul>
<h1><a class="anchor" id="autotoc_md3"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
Getting started</h1>
<h2><a class="anchor" id="autotoc_md4"></a>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
64drive</h2>
<p >Ensure the cart has the latest <a href="https://64drive.retroactive.be/support.php">firmware</a> installed. Download the latest <code>menu.bin</code> file from the releases page, then put it in the root directory of your SD card.</p>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
<h2><a class="anchor" id="autotoc_md5"></a>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
SC64</h2>
<p >Ensure the cart has the latest <a href="https://github.com/Polprzewodnikowy/SummerCart64/releases/latest">firmware</a> installed. Download the latest <code>sc64menu.n64</code> file from the releases page, then put it in the root directory of your SD card.</p>
<h2><a class="anchor" id="autotoc_md6"></a>
deploy: bd7e33ed71bbc991ac8fbf6c928957614ba5ccb2
2023-08-18 01:21:13 +02:00
ED64 &amp; ED64P</h2>
<p >Currently not supported, but there is an aim to do so. The aim is to replace <a href="https://github.com/networkfusion/altra64">Altra64</a> and <a href="https://github.com/n64-tools/ED64-UnofficialOS-binaries">ED64-UnofficialOS</a>.</p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h2><a class="anchor" id="autotoc_md7"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
Common to all</h2>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h3><a class="anchor" id="autotoc_md8"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
ROM Boxart</h3>
deploy: c36bd4197e5161c0af19df7a2306c445a291c351
2023-09-17 10:38:59 +02:00
<p >To use boxart, you need to place png files of size 158x112 in the folder <code>/menu/boxart</code> on the SD card. Each file must be named according to the 2 letter ROM ID, or 3 letter ROM ID including media type. i.e. for GoldenEye 2 letters, this would be <code>GE.png</code>. i.e. for GoldenEye 3 letters, this would be <code>NGE.png</code>. A known set of PNG files using 2 letter ID's can be downloaded <a href="https://mega.nz/file/6cNGwSqI#8X5ukb65n3YMlGaUtSOGXkKo9HxVnnMOgqn94Epcr7w">here</a>.</p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h3><a class="anchor" id="autotoc_md9"></a>
deploy: cf78d9a0a23aab4fe7adf295313f65eda67fdd6a
2023-08-08 00:15:56 +02:00
Emulator support</h3>
deploy: 9603e044e69e8b9e1b94a31a718fbf2a932fd6f3
2023-08-20 20:59:00 +02:00
<p >Emulators should be added to the <code>/emulators</code> directory on the SD card.</p>
<p >Menu currently supports the following emulators and associated ROM file names:</p><ul>
<li><b>NES</b>: <a href="https://github.com/hcs64/neon64v2">neon64v2</a> by <em>hcs64</em> - <code>neon64bu.rom</code></li>
<li><b>SNES</b>: <a href="https://github.com/Hydr8gon/sodium64">sodium64</a> by <em>Hydr8gon</em> - <code>sodium64.z64</code></li>
<li><b>Game Boy</b> / <b>GB Color</b>: <a href="https://lambertjamesd.github.io/gb64/romwrapper/romwrapper.html">gb64</a> by <em>lambertjamesd</em> - <code>gb.v64</code> / <code>gbc.v64</code></li>
deploy: dfa4a7c2379d3c255ac3361bb52794f166669ac8
2023-09-25 23:41:58 +02:00
<li><b>Sega Master System</b> / <b>Sega Game Gear</b> / <b>Sg1000</b>: <a href="https://github.com/ITotalJustice/TotalSMS">TotalSMS</a> - <code>TotalSMS.z64</code> (Currently broken)</li>
deploy: 37162cac428e4cbf04ee8fd8cc00579a6593a9da
2023-08-05 15:56:29 +02:00
</ul>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h1><a class="anchor" id="autotoc_md10"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
Developer documentation</h1>
<p ><b>Work in progress!</b></p>
<p >You can use a dev container in VSCode to ease development.</p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h2><a class="anchor" id="autotoc_md11"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
To deploy:</h2>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h3><a class="anchor" id="autotoc_md12"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
SC64</h3>
<ul>
<li>Download the deployer <a href="https://github.com/Polprzewodnikowy/SummerCart64/releases/download/v2.16.0/sc64-deployer-windows-v2.16.0.zip">here</a></li>
<li>Extract and place <code>sc64deployer.exe</code> in the <code>tools/sc64</code> directory.</li>
</ul>
<p >Make sure that your firmware is compatible (currently v2.16.0+) See: <a href="https://github.com/Polprzewodnikowy/SummerCart64/blob/v2.16.0/docs/00_quick_startup_guide.md#firmware-backupupdate">https://github.com/Polprzewodnikowy/SummerCart64/blob/v2.16.0/docs/00_quick_startup_guide.md#firmware-backupupdate</a></p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h4><a class="anchor" id="autotoc_md13"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
From the devcontainer</h4>
<p >It is not currently possible to directly communicate with USB devices. BUT, as a work around you can use a proxy TCP/IP connection Set up a proxy: open a terminal window, <code>cd ./tools/sc64</code> and then <code>./sc64deployer.exe server</code></p>
<p >Then in the dev container, use <code>make run</code> or <code>make run-debug</code></p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h4><a class="anchor" id="autotoc_md14"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
From your host (Windows) OS</h4>
<ul>
<li>Run <code>./localdeploy.bat</code> from the terminal</li>
</ul>
<p >Toggle the N64 power switch to load the ROM.</p>
<p ><code>ms-vscode.makefile-tools</code> will help (installed automatically in dev container). TODO: it does not yet work with <code>F5</code>: see <a href="https://devblogs.microsoft.com/cppblog/now-announcing-makefile-support-in-visual-studio-code/">https://devblogs.microsoft.com/cppblog/now-announcing-makefile-support-in-visual-studio-code/</a> WORKAROUND: in the dev container terminal, use make directly, i.e.: <code>make</code> The ROM can be found in the <code>output</code> directory.</p>
<p >NOTE: a "release" version of the SC64 menu is called <code>sc64menu.n64</code> and can be created for when you want to add it directly to the SDCard. This is generated by running <code>make all</code> or running <code>make sc64</code>.</p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h1><a class="anchor" id="autotoc_md15"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
Update Libdragon submodule</h1>
<p >This repo currently uses the <code>unstable</code> branch as a submodule at a specific commit. To update to the latest version, use <code>git submodule update --remote</code> from the terminal.</p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h1><a class="anchor" id="autotoc_md16"></a>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
Generate documentation</h1>
<p >Run <code>doxygen</code> from the dev container terminal. Make sure you fix the warnings before creating a PR! Generated documentation is located in <code>output/docs</code> folder.</p>
deploy: fc2f3aa42cf750d55075b2e5846ed57e952099c8
2023-09-08 21:50:09 +02:00
<h1><a class="anchor" id="autotoc_md17"></a>
deploy: 9603e044e69e8b9e1b94a31a718fbf2a932fd6f3
2023-08-20 20:59:00 +02:00
Open source software and licenses used</h1>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
<ul>
deploy: 9603e044e69e8b9e1b94a31a718fbf2a932fd6f3
2023-08-20 20:59:00 +02:00
<li><a href="https://github.com/DragonMinded/libdragon">libdragon</a> (UNLICENSE License)</li>
<li><a href="https://github.com/randy408/libspng">libspng</a> (BSD 2-Clause License)</li>
<li><a href="https://github.com/univrsal/mini.c">mini.c</a> (BSD 2-Clause License)</li>
<li><a href="https://github.com/lieff/minimp3">minimp3</a> (CC0 1.0 Universal)</li>
<li><a href="https://github.com/richgel999/miniz">miniz</a> (MIT License) </li>
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
</ul>
</div></div><!-- PageDoc -->
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
deploy: dfa4a7c2379d3c255ac3361bb52794f166669ac8
2023-09-25 23:41:58 +02:00
Generated on Mon Sep 25 2023 21:41:56 for N64FlashcartMenu by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.5
deploy: 24c7f3db72a259a812cad06256e14be7cfb78f06
2023-08-05 01:40:16 +02:00
</small></address>
</body>
</html>
Reference in New Issue Copy Permalink