From 22515a6fdf0ffb38f2a991323a2faca1cc8ef0e1 Mon Sep 17 00:00:00 2001 From: Robin Jones Date: Mon, 31 Mar 2025 16:28:20 +0100 Subject: [PATCH] [main] Next release changes (#225) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Description ### Release Notes 2025-03-31 - **New Features** - Introduced tabs in main menu for ROM favorites and recently played ROM history. - Introduced first run check to ensure users are aware of latest changes. - Introduced ability to turn off GUI loading bar. - BETA_FEATURE: Introduces ROM descriptions from files. - BETA_FEATURE: Enabled setting for fast ROM reboots on the SC64. - Add macOS metadata to hidden files. - Added settings schema version for future change versioning. - Added setting for PAL60 compatibility mode (see breaking changes). - BETA_FEATURE: Added setting for line doublers that need progressive output, enable using "force_progressive_scan" setting in `config.ini`. - **Bug Fixes** - Menu sound FX issues (hissing, popping and white noise). - RTC not showing or setting correct date parameters in certain circumstances. - GB / GBC emulator not saving in certain circumstances. - **Documentation** - Re-orginised and improved user documentation. - Added a lot of doxygen compatible code comments. - Added project license. - **Refactor** - RTC subsystem (align with libDragon improvements). - Boxart images (Deprecates old boxart image folder layout). - Settings (PAL60 compatibility, schema version, fast reboot, first run, progress bar). - **Other** - Updated libDragon SDK. - Updated miniz library. ### Breaking changes * GB /GBC emulator changed save type to SRAM (from FRAM) to improve compatibility with Summercart64 (which only uses H/W compatible FRAM), this may break your ability to load existing saves. * For similar PAL60 functionality, you may need to also enable the new "pal60_compatibility_mode" setting in `config.ini`. ### Current known Issues * The RTC UI requires improvement (awaiting UI developer). * Menu sound FX may not work properly when a 64 Disk Drive is also attached (work around: turn sound FX off). * Fast Rebooting a 64DD disk once will result in a blank screen. Twice will return to menu. This is expected until disk swapping is implemented. * MP3 Player crashes menu if the MP3 file's sample rate is less than 44100 hz. ### Deprecation notices * Autoload ROM's will be deprecated in favor of Fast Reboot in a future menu version. * Old boxart images using filenames for game ID is deprecated and the compatibility mode will be removed in a future release. ## Motivation and Context Works towards next release to main. ## How Has This Been Tested? On a SummerCart64 ## Screenshots ## Types of changes - [x] Improvement (non-breaking change that adds a new feature) - [x] Bug fix (fixes an issue) - [x] Breaking change (breaking change) - [x] Documentation Improvement - [x] Config and build (change in the configuration and build system, has no impact on code or features) ## Checklist: - [x] My code follows the code style of this project. - [x] My change requires a change to the documentation. - [x] I have updated the documentation accordingly. - [ ] I have added tests to cover my changes. - [ ] All new and existing tests passed. Signed-off-by: GITHUB_USER ## Summary by CodeRabbit ## Summary by CodeRabbit - **New Features & Enhancements** - Introduced dynamic history and favorites management for ROM and disk selections with a new tabbed interface. - Added support for autoloading ROMs, 64DD disk emulation, emulator integration, MP3 playback, and custom background images. - Expanded settings options—including PAL60 compatibility and fast ROM reboots—and improved startup behavior with an introductory credits display. - Added a feature to toggle the loading progress bar and enhanced the display of ROM information. - Implemented a bookkeeping system for managing history and favorites, along with new context menu entries for toggling settings. - Added a new user guide for N64FlashcartMenu and introduced a FAQ section addressing common issues. - Enhanced the user interface with new tabs for managing ROM favorites and recently played ROMs. - Introduced first run checks for user awareness of changes. - **Bug Fixes** - Resolved issues related to menu sound effects, RTC date parameters, and saving functionality in the GB/GBC emulator. - **Documentation** - Overhauled and expanded user guides, FAQs, and README materials to provide clearer instructions on ROM configuration, cheats, flashcart support, and new features. - Added detailed documentation comments throughout the codebase to improve clarity and maintainability, including updates to the pull request template and license information. - Included a new section in the CHANGELOG detailing various updates and breaking changes. --------- Signed-off-by: GITHUB_USER Co-authored-by: Suprapote <111246491+Suprapote@users.noreply.github.com> Co-authored-by: Christopher Bonhage Co-authored-by: Mateusz Faderewski Co-authored-by: Fazana <52551480+FazanaJ@users.noreply.github.com> Co-authored-by: Guillermo Horacio Romero Villa <65469983+E1ite007@users.noreply.github.com> Co-authored-by: Ross Gouldthorpe Co-authored-by: Víctor "IlDucci Co-authored-by: XLuma <39510265+XLuma@users.noreply.github.com> Co-authored-by: thekovic <72971433+thekovic@users.noreply.github.com> --- .devcontainer/devcontainer.json | 1 - .github/ISSUE_TEMPLATE/feature_request.yml | 9 + .github/PULL_REQUEST_TEMPLATE.md | 3 + .github/workflows/build.yml | 4 +- .gitignore | 5 +- CHANGELOG.md | 52 ++ CONTRIBUTING.md | 2 +- LICENSE.md | 661 ++++++++++++++++++ Makefile | 6 +- README.md | 115 +-- docs/00_index.md | 36 + docs/07_menu_customization.md | 4 - ...started_sd.md => 10_getting_started_sd.md} | 41 +- ...1_menu_controls.md => 11_menu_controls.md} | 14 +- docs/12_rom_configuration.md | 45 ++ docs/13_datel_cheats.md | 48 ++ docs/14_rom_patches.md | 8 + docs/15_controller_paks.md | 6 + docs/16_background_images.md | 7 + docs/17_64dd.md | 12 + docs/18_emulators.md | 12 + docs/19_gamepak_boxart.md | 29 + docs/22_autoload_roms.md | 8 + docs/31_file_browser.md | 38 + docs/32_menu_settings.md | 21 + docs/33_rtc_settings.md | 9 + docs/35_menu_information.md | 4 + docs/36_flashcart_information.md | 4 + docs/37_n64_information.md | 5 + docs/41_mp3_player.md | 8 + docs/61_advanced_customization.md | 3 + docs/62_hardware_mods.md | 6 + docs/65_experimental.md | 18 + docs/81_faq.md | 18 + docs/99_developer_guide.md | 18 +- docs/images/rtc-information.png | Bin 0 -> 111272 bytes docs/images/system-information.png | Bin 0 -> 103438 bytes libdragon | 2 +- src/boot/boot.h | 37 +- src/boot/boot_io.h | 144 ++-- src/boot/cheats.c | 63 +- src/boot/cheats.h | 21 +- src/boot/cic.c | 79 ++- src/boot/cic.h | 64 +- src/boot/reboot.h | 24 +- src/boot/vr4300_asm.h | 6 + src/flashcart/64drive/64drive.c | 76 +- src/flashcart/64drive/64drive_ll.c | 77 +- src/flashcart/64drive/64drive_ll.h | 159 +++-- src/flashcart/64drive/README.md | 2 +- src/flashcart/ed64/ed64_vseries.c | 16 +- src/flashcart/ed64/ed64_vseries_ll.h | 14 + src/flashcart/ed64/ed64_xseries.c | 174 +++++ src/flashcart/ed64/ed64_xseries.h | 2 +- src/flashcart/ed64/ed64_xseries_ll.h | 14 + src/flashcart/flashcart.c | 134 +++- src/flashcart/flashcart.h | 157 ++++- src/flashcart/flashcart_utils.c | 35 +- src/flashcart/flashcart_utils.h | 45 +- src/flashcart/sc64/README.md | 2 +- src/flashcart/sc64/sc64.c | 121 +++- src/flashcart/sc64/sc64_ll.c | 91 ++- src/flashcart/sc64/sc64_ll.h | 221 ++++-- src/libs/miniz | 2 +- src/menu/actions.c | 6 + src/menu/actions.h | 12 +- src/menu/bookkeeping.c | 289 ++++++++ src/menu/bookkeeping.h | 84 +++ src/menu/cart_load.c | 79 ++- src/menu/cart_load.h | 43 +- src/menu/disk_info.c | 64 +- src/menu/hdmi.h | 27 +- src/menu/menu.c | 93 ++- src/menu/menu.h | 17 +- src/menu/menu_state.h | 8 + src/menu/mp3_player.c | 135 +++- src/menu/path.c | 138 +++- src/menu/path.h | 155 +++- src/menu/png_decoder.c | 56 +- src/menu/rom_info.c | 225 +++--- src/menu/rom_info.h | 345 ++++----- src/menu/settings.c | 18 + src/menu/settings.h | 24 +- src/menu/sound.c | 51 +- src/menu/sound.h | 21 +- src/menu/ui_components.h | 22 + src/menu/ui_components/background.c | 63 +- src/menu/ui_components/boxart.c | 42 +- src/menu/ui_components/common.c | 210 +++++- src/menu/ui_components/constants.h | 42 +- src/menu/ui_components/context_menu.c | 36 +- src/menu/ui_components/file_list.c | 30 +- src/menu/ui_components/tabs.c | 28 + src/menu/usb_comm.c | 46 +- src/menu/views/browser.c | 74 +- src/menu/views/credits.c | 8 +- src/menu/views/flashcart_info.c | 4 +- src/menu/views/history_favorites.c | 217 ++++++ src/menu/views/load_disk.c | 118 +++- src/menu/views/load_rom.c | 72 +- src/menu/views/rtc.c | 64 +- src/menu/views/settings_editor.c | 35 +- src/menu/views/startup.c | 9 +- src/menu/views/text_viewer.c | 56 +- src/menu/views/views.h | 299 +++++++- src/utils/fs.c | 4 + src/utils/fs.h | 106 ++- src/utils/utils.h | 55 +- 108 files changed, 5469 insertions(+), 1123 deletions(-) create mode 100644 LICENSE.md create mode 100644 docs/00_index.md delete mode 100644 docs/07_menu_customization.md rename docs/{00_getting_started_sd.md => 10_getting_started_sd.md} (68%) rename docs/{01_menu_controls.md => 11_menu_controls.md} (65%) create mode 100644 docs/12_rom_configuration.md create mode 100644 docs/13_datel_cheats.md create mode 100644 docs/14_rom_patches.md create mode 100644 docs/15_controller_paks.md create mode 100644 docs/16_background_images.md create mode 100644 docs/17_64dd.md create mode 100644 docs/18_emulators.md create mode 100644 docs/19_gamepak_boxart.md create mode 100644 docs/22_autoload_roms.md create mode 100644 docs/31_file_browser.md create mode 100644 docs/32_menu_settings.md create mode 100644 docs/33_rtc_settings.md create mode 100644 docs/35_menu_information.md create mode 100644 docs/36_flashcart_information.md create mode 100644 docs/37_n64_information.md create mode 100644 docs/41_mp3_player.md create mode 100644 docs/61_advanced_customization.md create mode 100644 docs/62_hardware_mods.md create mode 100644 docs/65_experimental.md create mode 100644 docs/81_faq.md create mode 100644 docs/images/rtc-information.png create mode 100644 docs/images/system-information.png create mode 100644 src/flashcart/ed64/ed64_vseries_ll.h create mode 100644 src/flashcart/ed64/ed64_xseries.c create mode 100644 src/flashcart/ed64/ed64_xseries_ll.h create mode 100644 src/menu/bookkeeping.c create mode 100644 src/menu/bookkeeping.h create mode 100644 src/menu/ui_components/tabs.c create mode 100644 src/menu/views/history_favorites.c diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index effc134b..abd04448 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -10,7 +10,6 @@ "customizations": { "vscode": { "extensions": [ - "ms-vscode.cpptools", "ms-vscode.makefile-tools" ], "settings": { diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index c602330b..1192fa99 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -22,6 +22,15 @@ body: validations: required: true + - type: textarea + id: release-context + attributes: + label: Release Context + description: Is your feature request related to the latest release or pre-release version. + placeholder: This is still not available on the latest release or the pre-release versions, so it is applicable to both (and not a regression). + validations: + required: true + - type: textarea id: solution attributes: diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 78caa941..13cd7a39 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -33,5 +33,8 @@ - [ ] I have added tests to cover my changes. - [ ] All new and existing tests passed. + +You agree with the license terms and that other license types may be granted with permission of the original `N64FlashcartMenu` project license holders. + Signed-off-by: GITHUB_USER diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index d775c9ae..d17741d9 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -99,8 +99,8 @@ jobs: files: | ./output/N64FlashcartMenu.n64 ./output/menu.bin - ./output/OS64.v64 - ./output/OS64P.v64 + # ./output/OS64.v64 + # ./output/OS64P.v64 ./output/sc64menu.n64 continue-on-error: true diff --git a/.gitignore b/.gitignore index dcc08de7..3ccc4cee 100644 --- a/.gitignore +++ b/.gitignore @@ -16,4 +16,7 @@ # Ignore any N64 ROM **/*.n64 **/*.v64 -**/*.z64 \ No newline at end of file +**/*.z64 + +# Ignore macOS filesystem cruft +.DS_Store diff --git a/CHANGELOG.md b/CHANGELOG.md index 7d31f95d..163505a9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,58 @@ built from latest commit on main branch. - For the 64Drive, use the `menu.bin` file in the root of your SD card. - For the ares emulator, use the `N64FlashcartMenu.n64` file. +## Release Notes 2025-03-31 + +- **New Features** + - Introduced tabs in main menu for ROM favorites and recently played ROM history. + - Introduced first run check to ensure users are aware of latest changes. + - Introduced ability to turn off GUI loading bar. + - BETA_FEATURE: Introduces ROM descriptions from files. + - BETA_FEATURE: Enabled setting for fast ROM reboots on the SC64. + - Add macOS metadata to hidden files. + - Added settings schema version for future change versioning. + - Added setting for PAL60 compatibility mode (see breaking changes). + - BETA_FEATURE: Added setting for line doublers that need progressive output, enable using "force_progressive_scan" setting in `config.ini`. + + +- **Bug Fixes** + - Menu sound FX issues (hissing, popping and white noise). + - RTC not showing or setting correct date parameters in certain circumstances. + - GB / GBC emulator not saving in certain circumstances. + + +- **Documentation** + - Re-orginised and improved user documentation. + - Added a lot of doxygen compatible code comments. + - Added project license. + + +- **Refactor** + - RTC subsystem (align with libDragon improvements). + - Boxart images (Deprecates old boxart image folder layout). + - Settings (PAL60 compatibility, schema version, fast reboot, first run, progress bar). + +- **Other** + - Updated libDragon SDK. + - Updated miniz library. + +### Breaking changes +* GB /GBC emulator changed save type to SRAM (from FRAM) to improve compatibility with Summercart64 (which only uses H/W compatible FRAM), this may break your ability to load existing saves. +* For similar PAL60 functionality, you may need to also enable the new "pal60_compatibility_mode" setting in `config.ini`. + + +### Current known Issues +* The RTC UI requires improvement (awaiting UI developer). +* Menu sound FX may not work properly when a 64 Disk Drive is also attached (work around: turn sound FX off). +* Fast Rebooting a 64DD disk once will result in a blank screen. Twice will return to menu. This is expected until disk swapping is implemented. +* MP3 Player crashes menu if the MP3 file's sample rate is less than 44100 hz. + + +### Deprecation notices +* Autoload ROM's will be deprecated in favor of Fast Reboot in a future menu version. +* Old boxart images using filenames for game ID is deprecated and the compatibility mode will be removed in a future release. + + ## Release Notes 2025-01-10 - **Bug Fixes** diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 82e87184..f64caa34 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,4 +8,4 @@ As such, a GitHub account is recommended, which you can sign up for [here](https Additionally this document assumes that you already know how to use GitHub and Git. If that's not the case, we recommend learning about it first [here](https://docs.github.com/en/get-started/quickstart/hello-world). -**Help us by creating a PR.** \ No newline at end of file +**Help us by creating a PR.** diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 00000000..0ad25db4 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,661 @@ + GNU AFFERO GENERAL PUBLIC LICENSE + Version 3, 19 November 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU Affero General Public License is a free, copyleft license for +software and other kinds of works, specifically designed to ensure +cooperation with the community in the case of network server software. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +our General Public Licenses are intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + Developers that use our General Public Licenses protect your rights +with two steps: (1) assert copyright on the software, and (2) offer +you this License which gives you legal permission to copy, distribute +and/or modify the software. + + A secondary benefit of defending all users' freedom is that +improvements made in alternate versions of the program, if they +receive widespread use, become available for other developers to +incorporate. Many developers of free software are heartened and +encouraged by the resulting cooperation. However, in the case of +software used on network servers, this result may fail to come about. +The GNU General Public License permits making a modified version and +letting the public access it on a server without ever releasing its +source code to the public. + + The GNU Affero General Public License is designed specifically to +ensure that, in such cases, the modified source code becomes available +to the community. It requires the operator of a network server to +provide the source code of the modified version running there to the +users of that server. Therefore, public use of a modified version, on +a publicly accessible server, gives the public access to the source +code of the modified version. + + An older license, called the Affero General Public License and +published by Affero, was designed to accomplish similar goals. This is +a different license, not a version of the Affero GPL, but Affero has +released a new version of the Affero GPL which permits relicensing under +this license. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU Affero General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Remote Network Interaction; Use with the GNU General Public License. + + Notwithstanding any other provision of this License, if you modify the +Program, your modified version must prominently offer all users +interacting with it remotely through a computer network (if your version +supports such interaction) an opportunity to receive the Corresponding +Source of your version by providing access to the Corresponding Source +from a network server at no charge, through some standard or customary +means of facilitating copying of software. This Corresponding Source +shall include the Corresponding Source for any work covered by version 3 +of the GNU General Public License that is incorporated pursuant to the +following paragraph. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the work with which it is combined will remain governed by version +3 of the GNU General Public License. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU Affero General Public License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU Affero General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU Affero General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU Affero General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU Affero General Public License as published + by the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If your software can interact with users remotely through a computer +network, you should also make sure that it provides a way for users to +get its source. For example, if your program is a web application, its +interface could display a "Source" link that leads users to an archive +of the code. There are many ways you could offer source, and different +solutions will be better for different programs; see section 13 for the +specific requirements. + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU AGPL, see +. diff --git a/Makefile b/Makefile index df989653..da3579fa 100644 --- a/Makefile +++ b/Makefile @@ -30,6 +30,7 @@ SRCS = \ flashcart/64drive/64drive.c \ flashcart/flashcart_utils.c \ flashcart/ed64/ed64_vseries.c \ + flashcart/ed64/ed64_xseries.c \ flashcart/flashcart.c \ flashcart/sc64/sc64_ll.c \ flashcart/sc64/sc64.c \ @@ -40,6 +41,7 @@ SRCS = \ libs/miniz/miniz_zip.c \ libs/miniz/miniz.c \ menu/actions.c \ + menu/bookkeeping.c \ menu/cart_load.c \ menu/disk_info.c \ menu/fonts.c \ @@ -56,12 +58,14 @@ SRCS = \ menu/ui_components/common.c \ menu/ui_components/context_menu.c \ menu/ui_components/file_list.c \ + menu/ui_components/tabs.c \ menu/usb_comm.c \ menu/views/browser.c \ menu/views/credits.c \ menu/views/error.c \ menu/views/fault.c \ menu/views/file_info.c \ + menu/views/history_favorites.c \ menu/views/image_viewer.c \ menu/views/text_viewer.c \ menu/views/load_disk.c \ @@ -95,7 +99,7 @@ FILESYSTEM = \ $(addprefix $(FILESYSTEM_DIR)/, $(notdir $(SOUNDS:%.wav=%.wav64))) \ $(addprefix $(FILESYSTEM_DIR)/, $(notdir $(IMAGES:%.png=%.sprite))) -$(MINIZ_OBJS): N64_CFLAGS+=-DMINIZ_NO_TIME -fcompare-debug-second +$(MINIZ_OBJS): N64_CFLAGS+=-DMINIZ_NO_TIME -Wno-unused-function -fcompare-debug-second $(SPNG_OBJS): N64_CFLAGS+=-isystem $(SOURCE_DIR)/libs/miniz -DSPNG_USE_MINIZ -fcompare-debug-second $(FILESYSTEM_DIR)/FiraMonoBold.font64: MKFONT_FLAGS+=--compress 1 --outline 1 --size 16 --range 20-7F --range 80-1FF --range 2026-2026 --ellipsis 2026,1 $(FILESYSTEM_DIR)/%.wav64: AUDIOCONV_FLAGS=--wav-compress 1 diff --git a/README.md b/README.md index f0b8c9ea..ceb4f5ec 100644 --- a/README.md +++ b/README.md @@ -2,26 +2,27 @@ ![GitHub Org's stars](https://img.shields.io/github/stars/Polprzewodnikowy/N64FlashcartMenu) [![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/Polprzewodnikowy/N64FlashcartMenu.svg)](http://isitmaintained.com/project/Polprzewodnikowy/N64FlashcartMenu "Average time to resolve an issue") [![Percentage of issues still open](http://isitmaintained.com/badge/open/Polprzewodnikowy/N64FlashcartMenu.svg)](http://isitmaintained.com/project/Polprzewodnikowy/N64FlashcartMenu "Percentage of issues still open") -[![#yourfirstpr](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](https://github.com/Polprzewodnikowy/N64FlashcartMenu/CONTRIBUTING.md) +[![#yourfirstpr](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](https://github.com/Polprzewodnikowy/N64FlashcartMenu/blob/main/CONTRIBUTING.md) # N64 Flashcart Menu -An open source menu for N64 flashcarts and aims to support as many as possible. -The menu is not affiliated with any partuclar flashcart and does not necessarily expose all capable firmware features. It MUST be updated independently of any (current) flashcart frmware. - +An open source menu for N64 flashcarts and aims to support as many as possible. The menu is not affiliated with any partuclar flashcart and does not necessarily expose all capable firmware features. **This project considers flashcart sellers that include this menu or copyrighted ROM's as part of their product offering as licence offenders which may result in future action.** -![example menu information](./docs/images/menu-information.png "example menu information") - -## Supported Flashcarts -This menu aims to support as many N64 flashcarts as possible. +## Flashcart Supported +This menu aims to support as many N64 flashcarts as possible. The current state is: ### Supported * SummerCart64 * 64Drive -### Work in Progress (pre-release only) -* ED64 -* ED64P +### Work in Progress +* ED64 (X and V series) +* ED64P (clones) + +### Not yet planned +* Doctor V64 +* PicoCart +* DaisyDrive ## Current (notable) menu features @@ -36,84 +37,23 @@ This menu aims to support as many N64 flashcarts as possible. * Real Time Clock support. * Music playback (MP3). * Menu sound effects. -* N64 ROM autoload. +* N64 ROM autoload option (on power). +* N64 ROM fast reboot option (on reset). +* ROM information descriptions. +* ROM history and favorites. ## Documentation -* [Getting started guide](./docs/00_getting_started_sd.md) -* [Menu controls](./docs/01_menu_controls.md) -* [Menu customization](./docs/07_menu_customization.md) -* [Developer guide](./docs/99_developer_guide.md) - -## Video showcase (as of Oct 12 2023) -[![N64FlashcartMenu Showcase](http://img.youtube.com/vi/6CKImHTifDA/0.jpg)](http://www.youtube.com/watch?v=6CKImHTifDA "N64FlashcartMenu Showcase (Oct 12 2023)") +Please take a moment to browse the current documentation / user guide: +[User Guide - Index](./docs/00_index.md) ## Aims -* Support as many N64 FlashCarts as possible. +* Support as many N64 Flashcarts as possible. * Be open source, using permissively licensed third-party libraries. * Be testable in an emulated environment (Ares). * Encourage active development from community members and N64 FlashCart owners. -* Support as many common mods and features as possible. - - -## Experimental features -These features are subject to change: - -### N64 ROM autoload -To use the autoload function, while on the `N64 ROM information` display, press the `R` button on your joypad and select the `Set ROM to autoload` option. When you restart the console, it will now only load the selected ROM rather than the menu. -**NOTE:** To return to the menu, hold the joypad `Start` button while powering on the console. - -### GamePak sprites -To use N64 GamePak sprites, place PNG files within the `sd:/menu/boxart/` folder. - -#### Supported sprites -These must be `PNG` files that use the following dimensions: -* Standard N64 GamePak boxart sprites: 158x112 -* Japanese N64 GamePak boxart sprites: 112x158 -* 64DD boxart sprites: 129x112 - -They will be loaded by directories using each character (case-sensitive) of the full 4 character Game Code (as identified in the menu ROM information). -i.e. for GoldenEye NTSC USA (NGEE), this would be `sd:/menu/boxart/N/G/E/E/boxart_front.png`. -i.e. for GoldenEye PAL (NGEP), this would be `sd:/menu/boxart/N/G/E/P/boxart_front.png`. - -To improve compatibility between regions (as a fallback), you may exclude the region ID (last matched directory) for GamePaks to match with 3 letter IDs instead: -i.e. for GoldenEye, this would be `sd:/menu/boxart/N/G/E/boxart_front.png`. - -**Warning**: Excluding the region ID may show the wrong boxart. -**Note**: For future support, boxart sprites should also include: -* `boxart_back.png` -* `boxart_top.png` -* `boxart_bottom.png` -* `boxart_left.png` -* `boxart_right.png` - -As a starting point, here is a link to a boxart pack following the new structure, including `boxart_front.png` and fallback images: -* [Recommended Boxart](https://drive.google.com/file/d/1IpCmFqmGgGwKKmlRBxYObfFR9XywaC6n/view?usp=drive_link) - - -#### Compatibility mode -If you cannot yet satisfy the correct boxart layout, The menu still has **deprecated** support for filenames containing the Game ID. - -**Note:** This will add a noticeable delay for displaying parts of the menu. - -Each file must be named according to the 2,3 or 4 letter GamePak ID (matched in this order). -i.e. -* for GoldenEye 4 letters, this would be `sd:/menu/boxart/NGEE.png` and/or `sd:/menu/boxart/NGEP.png`. -* for GoldenEye 3 letters, this would be `sd:/menu/boxart/NGE.png`. -* for GoldenEye 2 letters, this would be `sd:/menu/boxart/GE.png`. - - -As a starting point, here are some links to boxart image packs: -* [Japan Boxart](https://mega.nz/file/KyJR0B6B#ERabLautAVPaqJTIdBSv4ghbudNhK7hnEr2ZS1Q6ub0) -* [American Boxart](https://mega.nz/file/rugAFYSQ#JHfgCU2amzNVpC4S6enP3vg--wtAAwsziKa7cej6QCc) -* [European Boxart](https://mega.nz/file/OmIV3aAK#kOWdutK1_41ffN64R6thbU7HEPR_M9qO0YM2mNG6RbQ) -* [64DD Boxart](https://mega.nz/file/ay5wQIxJ#k3PF-VMLrZJxJTr-BOaOKa2TBIK7c2t4zwbdshsQl40) - - -### Menu Settings -The Menu creates a `config.ini` file in `sd:/menu/` which contains various settings that are used by the menu. -These can be updated using the settings editor, but if required, you can also manually adjust the file on the SD card using your computer. +* Support as many common mods and features as possible (flashcart dependent). ## Flashcart specific @@ -122,7 +62,7 @@ These can be updated using the settings editor, but if required, you can also ma * Ensure the cart has the latest [firmware](https://github.com/Polprzewodnikowy/SummerCart64/releases/latest) installed. * Download the latest `sc64menu.n64` file from the [releases](https://github.com/Polprzewodnikowy/N64FlashcartMenu/releases/) page, then put it in the root directory of your SD card. -![SC64 flashcart information](./docs/images/sc64-flashcart-information.png "example SC64 flashcart information") +![SC64 flashcart information](./docs/images/sc64-flashcart-information.png "example SC64 flashcart information") ### 64drive @@ -139,16 +79,23 @@ The aim is to reach feature parity with [ED64-UnofficialOS](https://github.com/n Download the `OS64.v64` ROM from the latest [action run - assets] and place it in the `/ED64` folder. #### ED64 (X series) -X Series support is currently awaiting fixes. Please use the official [OS](https://krikzz.com/pub/support/everdrive-64/x-series/OS/) for now. +The aim is to reach feature parity with [OS](https://krikzz.com/pub/support/everdrive-64/x-series/OS/) for now. +Download the `OS64.v64` ROM from the latest [action run - assets] and place it in the `/ED64` folder. #### ED64 (P clone) Download the `OS64P.v64` ROM from the latest [action run - assets] and place it in the `/ED64P` folder. The aim is to reach feature parity with [Altra64](https://github.com/networkfusion/altra64) -# Open source software and licenses used +# License +This project is released under the [GNU AFFERO GENERAL PUBLIC LICENSE](LICENSE.md) as compatible with all other dependent project licenses. +Other license options may be available upon request with permissions of the original `N64FlashcartMenu` project authors / maintainers. +* Mateusz Faderewski / Polprzewodnikowy +* Robin Jones / NetworkFusion -* [libdragon](https://github.com/DragonMinded/libdragon) (UNLICENSE License) +# Open source software and licenses used +## libraries +* [libdragon](https://github.com/DragonMinded/libdragon/tree/preview) (UNLICENSE License) * [libspng](https://github.com/randy408/libspng) (BSD 2-Clause License) * [mini.c](https://github.com/univrsal/mini.c) (BSD 2-Clause License) * [minimp3](https://github.com/lieff/minimp3) (CC0 1.0 Universal) diff --git a/docs/00_index.md b/docs/00_index.md new file mode 100644 index 00000000..668784c3 --- /dev/null +++ b/docs/00_index.md @@ -0,0 +1,36 @@ +[Return to README](README.md) +## N64FlashcartMenu User Guide + +### General +- [Initial Setup of an SD Card](./10_getting_started_sd.md) +- [Basic Controls](./11_menu_controls.md) +- [ROM Configuration](./12_rom_configuration.md) +- [Cheats (Gameshark, etc.)](./13_datel_cheats.md) +- [ROM Patches (Hacks, Fan Translations, etc.)](./14_rom_patches.md) +- [Controller PAKs](./15_controller_paks.md) +- [Background Images](./16_background_images.md) +- [64DD](./17_64dd.md) +- [Emulators](./18_emulators.md) +- [Game Art Images](./19_gamepak_boxart.md) +- [Autoloading N64 ROMs](./22_autoload_roms.md) + +### Menus +- [File Browser](./31_file_browser.md) +- [Menu Settings](./32_menu_settings.md) +- [Date-Time (RTC) Settings](./33_rtc_settings.md) +- [Menu Information](./35_menu_information.md) +- [Flashcart Information](./36_flashcart_information.md) +- [N64 Information](./37_n64_information.md) + +### Other +- [MP3 Player](./41_mp3_player.md) +- [Advanced Customization](./61_advanced_customization.md) +- [N64 Hardware Modifications Compatibility](./62_hardware_mods.md) +- [FAQ](./81_faq.md) + +#### Experimental Features (Subject to change) +- [Experimental Features](./65_experimental.md) + +### Developers +- [Developer Guide](./99_developer_guide.md) +- [Contributing](https://github.com/Polprzewodnikowy/N64FlashcartMenu/blob/main/CONTRIBUTING.md) \ No newline at end of file diff --git a/docs/07_menu_customization.md b/docs/07_menu_customization.md deleted file mode 100644 index 0cfcf74f..00000000 --- a/docs/07_menu_customization.md +++ /dev/null @@ -1,4 +0,0 @@ -## Menu Customization - -### Adding a background image -Add a PNG image to the SD card. When browsing the menu, select and load the image and then respond to the dialogue message. diff --git a/docs/00_getting_started_sd.md b/docs/10_getting_started_sd.md similarity index 68% rename from docs/00_getting_started_sd.md rename to docs/10_getting_started_sd.md index 547b2593..6d27b114 100644 --- a/docs/00_getting_started_sd.md +++ b/docs/10_getting_started_sd.md @@ -1,40 +1,29 @@ -## Initial Setup of SD Card +[Return to the index](./00_index.md) +## Initial Setup of an SD Card -### First Steps +### First steps Connect the SD card to your PC and ensure it is properly formatted to be compatible with your flashcart. **WARNING:** Filenames are expected to be written in ASCII, with Western Europe characters fully compatible. Other Unicode characters, such as those from Eastern Europe, Russia, Asia or Middle East regions (to name just a few examples) are not fully supported and may not be displayed. +**Note:** It is advised to use ROM files in the Big Endian (default, also called "non-byteswapped") format. Although the menu auto-converts byteswapped ROM files, the load time will increase. + #### Preparations for SC64 - FAT32 and EXFAT are fully supported. - An SD formatted with 128 kiB cluster size is recommended. - - Download the latest `sc64menu.n64` file from the [releases](https://github.com/Polprzewodnikowy/N64FlashcartMenu/releases/) page, then put it in the root directory of your SD card. -- Create a folder in the root of your SD card called `menu`. -- Place your ROM files on the SD card, **in any folder except `menu`**. +- Place your ROM files on the SD card, **in any folder except `menu`**. **NOTE:** byteswapped ROM's will increase load times. #### Preparations for other supported flashcarts - FAT32 recommended. - An SD formatted with the default cluster size is recommended. +- Download the latest [menu](https://github.com/Polprzewodnikowy/N64FlashcartMenu/releases/) file specific for your flashcart and place it in the expected location. -(TBW) - - -### Emulator Support -Emulators should be added to the `/menu/emulators` directory on the SD card. - -N64FlashcartMenu currently supports the following emulators and associated ROM file names: -- **NES**: [neon64v2](https://github.com/hcs64/neon64v2/releases) by *hcs64* - `neon64bu.rom` -- **SNES**: [sodium64](https://github.com/Hydr8gon/sodium64/releases) by *Hydr8gon* - `sodium64.z64` -- **Game Boy**/**GB Color**: [gb64](https://lambertjamesd.github.io/gb64/romwrapper/romwrapper.html) by *lambertjamesd* - `gb.v64`/`gbc.v64` ("Download Emulator" button) -- **SMS**/**GG**: [smsPlus64](https://github.com/fhoedemakers/smsplus64/releases) by *fhoedmakers* - `smsPlus64.z64` -- **Fairchild Channel F**: [Press-F-Ultra](https://github.com/celerizer/Press-F-Ultra/releases) by *celerizer* - `Press-F.z64` - - -### 64DD Disk Support -To load and run 64DD disk images, place the required 64DD IPL dumps in the `/menu/64ddipl` folder on the SD card. -For more details, follow [this guide on the 64dd.org website](https://64dd.org/tutorial_sc64.html). +### Emulator support +See the [Emulators](./18_emulators.md) page. +### 64DD Disk support +See the [64DD](./17_64dd.md) page. #### So what would the layout of the SD card look like? ```plaintext @@ -61,8 +50,8 @@ SD:\ │ ├── (a rom).z64 ├── (a rom).n64 -├── (some folder with roms)\ - │ └── (some folder with roms)\ +├── (some folder with ROMs)\ + │ └── (some folder with ROMs)\ | └── (some supported ROM files) │ ├── (some supported ROM files) @@ -78,7 +67,7 @@ and they must share the same file name, but use the `.sav` extension. `.sav` fil the "cartridge save memory". ```plaintext -├── (some folder with roms)\ +├── (some folder with ROMs)\ ├── a_rom.z64 ├── b_rom_whatever.n64 └── saves\ @@ -86,7 +75,7 @@ the "cartridge save memory". └── b_rom_whatever.sav ``` -### Transfering Saves From An ED64 +### Transferring saves from an ED64 If you are transferring a file from a different flashcart, such as the ED64, you must change the file extension to `sav`. For example, a save file called `Glover (USA).eep` should have its extension changed to `Glover (USA).sav` to work with N64FlashcartMenu. diff --git a/docs/01_menu_controls.md b/docs/11_menu_controls.md similarity index 65% rename from docs/01_menu_controls.md rename to docs/11_menu_controls.md index 7dab5b42..71a0ba22 100644 --- a/docs/01_menu_controls.md +++ b/docs/11_menu_controls.md @@ -1,6 +1,6 @@ -## Menu Controls - -### Additional Control Information +[Return to the index](./00_index.md) +## Basic Controls + #### Fast scroll Press either the `C-Up` or `C-Down` buttons to scroll by pages, rather than by elements. @@ -8,18 +8,18 @@ Press either the `C-Up` or `C-Down` buttons to scroll by pages, rather than by e #### N64FlashcartMenu settings Press the `START` button on the browser screen to open the Settings window. ![Main context menu](./images/main-context-menu.png "Main context menu") -From here you can edit some of the N64FlashcartMenu settings, -see information about either the console, the flashcart you are using or N64FlashcartMenu itself, and if your cart has Real-Time Clock (RTC) support, you can also change its date and time. +From here you can edit some of the N64FlashcartMenu settings, see information about either the console, the flashcart you are using or N64FlashcartMenu itself, and if your cart has Real-Time Clock (RTC) support, you can also change its date and time. #### Browser options Press the `R` button to open the Browser Options window. Here you can see a ROM's properties, delete it from your SD card or establish the default folder where N64FlashcartMenu's browser will start in future boots. #### Additional ROM information + Press either the `L` or `Z` button on the ROM information screen to open an additional window that will show additional information about the currently -selected ROM file, such as its endianess, regional variant, set clock rate, and much more. +selected ROM file, such as its endianness, regional variant, set clock rate, and much more. -### 64DD ROM +### 64DD-related #### Expansion disks To load an expansion disk (such as F-Zero X), first browse to the N64 ROM and load it (**but not start it!**), then browse to the 64DD expansion file and press either the `L` or `Z` button. diff --git a/docs/12_rom_configuration.md b/docs/12_rom_configuration.md new file mode 100644 index 00000000..a0a049bb --- /dev/null +++ b/docs/12_rom_configuration.md @@ -0,0 +1,45 @@ +[Return to the index](./00_index.md) +## ROM Configuration + +The N64FlashcartMenu allows overriding the ROM's default configuration that is provided from the internal database. + +The internal database is contained within `rom_info.c`. + +The N64FlashcartMenu expects that you are using a flashcart that has an [UltraCIC](https://n64brew.dev/wiki/Checking_Integrated_Circuit) available. + +NOTE: Some old ROM hacks may have adjusted the ROM code to manipulate the expected CIC and save type in order to allow compatibility with more available chips (usually 6102) as was used on flashcarts prior to 2018. If it does, you may need to override the internal database using the override settings. + +If you override the defaults and want to go back to the default ones, delete the `.ini` file. + +### Homebrew Header +The N64FlashcartMenu fully supports the [homebrew header](https://n64brew.dev/wiki/ROM_Header#Advanced_Homebrew_ROM_Header) + +### Available Overrides + +#### CIC type +The Checking Integrated Circuit [CIC](https://n64brew.dev/wiki/Checking_Integrated_Circuit) was a physical security chip used by retail Nintendo 64 game cartridges that prevented unlicensed and pirated game cartridges from running and used in conjunction with the [PIF](https://n64brew.dev/wiki/PIF-NUS). + +WARNING: Changing the CIC type to an unsupported one may result in a blank screen for that particular ROM until you manually delete the override file! + +For more detailed information regarding the various CIC chips, please visit [micro-64.com's game CIC database](http://micro-64.com/database/gamecic.shtml). + +#### Save type +Games that have been programmed to include an internal save system might use various types of chips, methods and sizes. + +WARNING: Using the wrong save type can cause unwanted behaviors on games and/or corrupt existing ones! + +For more detailed information regarding the various saving methods, please visit [micro-64.com's game save database](http://micro-64.com/database/gamesave.shtml) + +#### TV Region type + +All ROMs are generally programmed to work with a single type of television output setting, whether it's NTSC, PAL or MPAL or their multiple variants. Forcing the region will generally make the ROM work on your display, however: + +1. Be aware that not every CRT from the 1990s and 2000s is compatible with both NTSC and PAL standards. +2. Be aware that flat TVs from late 2010s-2020s might have other issues, such as when a game changes its internal resolution during gameplay (i.e. Resident Evil 2 with Expansion Pak). +3. Expect potential side effects: + - Speed issues + - Audio/visual desynchronization + - Other unexpected/unwanted behaviors + +### Autoload +See the [Autoload N64 ROMs](./22_autoload_roms.md) page. diff --git a/docs/13_datel_cheats.md b/docs/13_datel_cheats.md new file mode 100644 index 00000000..08ac1612 --- /dev/null +++ b/docs/13_datel_cheats.md @@ -0,0 +1,48 @@ +[Return to the index](./00_index.md) +## Cheats (Gameshark, etc.) + +The N64FlashcartMenu supports the cheat code types made popular by the peripherals: +- GameShark +- Action Replay + +Another product by Blaze, called the Xploder64/Xplorer64 also existed in some regions, but these codes are less likely to work. + +**WARNING**: It is not advised to connect a physical cheat cartridge in conjunction with most flashcarts. + + +The N64FlashcartMenu can only support cheat codes based on Datel carts when also using an Expansion Pak. + +Caveats: +- Something about cheats and expansion paks. + +The current code types are supported: +- 80 (description here) +- D0 (description here) +- Fx (description here) +- ... + +The codes XX are not supported, because... +- e.g. they rely on the button. + +``` +// Example cheat codes for the game "Majoras Mask USA" +uint32_t cheats[] = { + // Enable code + 0xF1096820, + 0x2400, + 0xFF000220, + 0x0000, + // Inventory Editor (assigned to L) + 0xD01F9B91, + 0x0020, + 0x803FDA3F, + 0x0002, + // Last 2 entries must be 0 + 0, + 0, +}; +``` + +And pass this array as a boot parameter: `menu->boot_params->cheat_list = cheats;` + +Check the [Pull Requests](https://github.com/Polprzewodnikowy/N64FlashcartMenu/pulls) for work towards GUI editor support. diff --git a/docs/14_rom_patches.md b/docs/14_rom_patches.md new file mode 100644 index 00000000..a37a0320 --- /dev/null +++ b/docs/14_rom_patches.md @@ -0,0 +1,8 @@ +[Return to the index](./00_index.md) +## ROM Patches (Hacks, Fan Translations, etc.) + +At the time of writing, N64FlashcartMenu does not support patching on-the-fly, although you can use various offline and online utilities to patch your games. + +Check the [Pull Requests section](https://github.com/Polprzewodnikowy/N64FlashcartMenu/pulls) for work towards it. + +The aim is to support APS/IPS/BPS/XDELTA patches. diff --git a/docs/15_controller_paks.md b/docs/15_controller_paks.md new file mode 100644 index 00000000..e96fd851 --- /dev/null +++ b/docs/15_controller_paks.md @@ -0,0 +1,6 @@ +[Return to the index](./00_index.md) +## Controller Paks + + +At the time of writing, N64FlashcartMenu can only recognize if a Controller Pak is inserted on a Controller. Controller Pak backups, backup restoration and handling are not yet supported. +Check the [Pull Requests section](https://github.com/Polprzewodnikowy/N64FlashcartMenu/pulls) for work towards it. diff --git a/docs/16_background_images.md b/docs/16_background_images.md new file mode 100644 index 00000000..0ad51734 --- /dev/null +++ b/docs/16_background_images.md @@ -0,0 +1,7 @@ +[Return to the index](./00_index.md) +## Background Images + +### How to add a background image +First copy an image in .PNG format to anywhere on the SD card. Then when the N64FlashcartMenu is loaded on the N64, browse to the image and then select it to show it on the screen. Press the `A` Button again to open up the confirmation message, which will ask if you want to set a new background image. + +Press the `A` Button to confirm and set the image as your new background or press the `B` Button to cancel and return to the image display screen. diff --git a/docs/17_64dd.md b/docs/17_64dd.md new file mode 100644 index 00000000..d4bb77fa --- /dev/null +++ b/docs/17_64dd.md @@ -0,0 +1,12 @@ +[Return to the index](./00_index.md) +## 64DD Disk support + +Specific flashcarts (such as the [SummerCart64](https://summercart64.dev)) can fully emulate the original 64DD (load, run, save) disks without having a physical device connected to the N64 and don't require conversion ROMs. + +To load and run 64DD disk images, place the required 64DD IPL dumps in the `/menu/64ddipl` folder on the SD card. +For more details, follow [this guide on the 64dd.org website](https://64dd.org/tutorial_sc64.html). + +**Note**: It is not yet possible to swap 64DD disks via N64FlashcartMenu. + +### Conversion ROMs +The N64Flashcart Menu is able to load and run conversion ROMs (but does not perform saves). diff --git a/docs/18_emulators.md b/docs/18_emulators.md new file mode 100644 index 00000000..c4bce2f3 --- /dev/null +++ b/docs/18_emulators.md @@ -0,0 +1,12 @@ +[Return to the index](./00_index.md) +## Emulators +N64FlashcartMenu supports multiple emulators that are compatible with the N64. At the time of writing, current emulator support includes NES, SNES, GB, GBC, SMS, GG, and CHF ROMs. + +Emulators should be added to the `/menu/emulators` directory on the SD card. N64FlashcartMenu currently supports the following emulators and associated ROM file names: +- **NES**: [neon64v2](https://github.com/hcs64/neon64v2/releases) by *hcs64* - `neon64bu.rom` +- **SNES**: [sodium64](https://github.com/Hydr8gon/sodium64/releases) by *Hydr8gon* - `sodium64.z64` +- **Game Boy**/**GB Color**: [gb64](https://lambertjamesd.github.io/gb64/romwrapper/romwrapper.html) by *lambertjamesd* - `gb.v64`/`gbc.v64` ("Download Emulator" button) +- **SMS**/**GG**: [smsPlus64](https://github.com/fhoedemakers/smsplus64/releases) by *fhoedmakers* - `smsPlus64.z64` +- **Fairchild Channel F**: [Press-F-Ultra](https://github.com/celerizer/Press-F-Ultra/releases) by *celerizer* - `Press-F.z64` + +If you are an emulator developer and are interested in adding your emulator, take a look at this [template pull request](https://github.com/Polprzewodnikowy/N64FlashcartMenu/pull/178). diff --git a/docs/19_gamepak_boxart.md b/docs/19_gamepak_boxart.md new file mode 100644 index 00000000..bf73681a --- /dev/null +++ b/docs/19_gamepak_boxart.md @@ -0,0 +1,29 @@ +[Return to the index](./00_index.md) +## Game Art Images +To use N64 game box art images, place your PNG files within the `sd:/menu/boxart/` folder. + +#### Supported images +Files must be in `PNG` format and use the following dimensions: +* American/European N64 box art sprites: 158x112 +* Japanese N64 box art sprites: 112x158 +* 64DD box art sprites: 129x112 + +Images will be loaded by directories using each character (case-sensitive) of the full 4-character Game Code (as identified in the menu ROM information): +i.e. for GoldenEye NTSC USA (NGEE), this would be `sd:/menu/boxart/N/G/E/E/boxart_front.png`. +i.e. for GoldenEye PAL (NGEP), this would be `sd:/menu/boxart/N/G/E/P/boxart_front.png`. + +To improve compatibility between regions (as a fallback), you may exclude the region ID (last matched directory) for GamePaks to match with 3-character IDs instead: +i.e. for GoldenEye, this would be `sd:/menu/boxart/N/G/E/boxart_front.png`. + +**Warning**: Excluding the region ID may show a box art of the wrong region. +**Note**: For future support, box art sprites should also include: +- `boxart_back.png` +- `boxart_top.png` +- `boxart_bottom.png` +- `boxart_left.png` +- `boxart_right.png` +- `gamepak_front.png` +- `gamepak_back.png` + +As a starting point, here is a link to a box art pack, that has `boxart_front.png`: +- [Third party box art](https://drive.google.com/file/d/1IpCmFqmGgGwKKmlRBxYObfFR9XywaC6n/view?usp=drive_link) diff --git a/docs/22_autoload_roms.md b/docs/22_autoload_roms.md new file mode 100644 index 00000000..e6ae7c2d --- /dev/null +++ b/docs/22_autoload_roms.md @@ -0,0 +1,8 @@ +[Return to the index](./00_index.md) +## Autoloading N64 ROMs +You can set up N64FlashcartMenu to load a specific ROM directly instead of booting up the menu's graphical user interface. **NOTE:** byteswapped ROMs will slow down the ROM load process. +If you only want to continously reload a ROM for a single gaming session, you should consider the setting for [Fast ROM reboots](./32_menu_settings.md) instead. + +### How to enable autoloading +To use the autoload function, open the `N64 ROM information` screen on any ROM, then press the `R` Button on your Controller and select the `Set ROM to autoload` option. When you restart the console, N64FlashcartMenu will now only load the selected ROM, rather than the menu itself. +**NOTE:** If you want to return to the menu, press and hold the `START` Button on your Controller while turning the console's POWER button to the ON position. diff --git a/docs/31_file_browser.md b/docs/31_file_browser.md new file mode 100644 index 00000000..04ddc9f1 --- /dev/null +++ b/docs/31_file_browser.md @@ -0,0 +1,38 @@ +[Return to the index](./00_index.md) +## File Browser + +The File Browser allows you to navigate and manage files on your N64 flashcart. Below are the key features and instructions on how to use the File Browser effectively. + +### Features +- **File and folder navigation**: Browse through directories and files on your flashcart. +- **File operations**: Perform operations such as delete and show properties. +- **File information**: View detailed information about each file, including size and date modified. +- **Load files**: Load files from the file system. +- **Switching tabs (Pre-release only)**: Switch between the file browser, favorites and history tabs. + +### Usage Instructions + +1. **Navigating Files**: + - Use the directional `Up` and `Down` buttons (`C-Up` and `C-Down` for fast scrolling) to move through the list of files and directories. + - Press the `A` Button to open a directory or load a supported file. + +2. **Performing File Operations**: + - Highlight the file or directory you want to operate on. + - Press the `R` Button to open the operations menu. + - Select the desired operation (delete, show properties, set as default) and follow the on-screen prompts. + +3. **Viewing Settings menu**: + - Press the `Z` Button to display the menu. + +4. **Switching tabs (Pre-release only)**: + - Press the `C-Right` and `C-Left` Buttons to switch between the file browser, favorites and history tabs. + +### Tips + +- Make sure you regularly back up important files from the SD Card to your computer to avoid accidental loss. +- Familiarize yourself with the button layout to navigate and manage files efficiently. + +### Troubleshooting + +- If a file operation fails, make sure there is enough space on the SD card and that the file is not write-protected. +- For any issues not covered in this guide, refer to the troubleshooting section in the main manual or contact the support channels on Discord. diff --git a/docs/32_menu_settings.md b/docs/32_menu_settings.md new file mode 100644 index 00000000..a3941d8b --- /dev/null +++ b/docs/32_menu_settings.md @@ -0,0 +1,21 @@ +[Return to the index](./00_index.md) +## Menu Settings +N64FlashcartMenu automatically creates a `config.ini` file in `sd:/menu/`, which contains various settings that can be set within the menu's Settings editor. +If required, you can manually adjust the file (required for some advanced settings) on the SD card using your computer. + +### Show Hidden Files +Shows any N64FlashcartMenu system-related files. This setting is OFF by default. + +### Use Save Folders +Controls whether N64FlashcartMenu should use `/saves` folders to store ROM save data. This setting is ON by default. +ON: ROM saves are saved in separate subfolders (called `\saves`, will create one `\saves` subfolder per folder). +OFF: ROM saves are saved alongside the ROM file. + +### Sound Effects +The menu has default sound effects to improve the user experience. This setting is OFF by default. + +### Fast ROM reboots +Certain flashcarts support the ability to use the N64 `RESET` button for re-loading the last game, rather than returning to the menu. When enabled (and if supported by your flashcart), the power switch must be toggled to return to the menu. +NOTE: if a USB cable is connected, the last game may continue to be re-loaded. +Fast Rebooting a 64DD disk once will result in a blank screen. Twice will return to menu. This is expected until disk swapping is implemented. +This setting is OFF by default. diff --git a/docs/33_rtc_settings.md b/docs/33_rtc_settings.md new file mode 100644 index 00000000..f40165b5 --- /dev/null +++ b/docs/33_rtc_settings.md @@ -0,0 +1,9 @@ +[Return to the index](./00_index.md) +## Date-Time (RTC) Settings + +![RTC information](./images/rtc-information.png "RTC Information") +If your flashcart supports the Real-Time Clock (RTC from herein) feature, N64FlashcartMenu has the ability to read and set it. + +Press the `START` Button on the File Browser and select `Time (RTC) settings` to enter the Adjust Real-Time Clock screen. Here you will see a notice regarding other ways to change the RTC. If your flashcart is compatible, press the `A` Button to display the RTC change prompt. + +Press Up and/or Down on your Control Stick or Directional Buttons to modify the currently selected value, or Left and/or Right to select another value to change. If you are satisfied with the changes, press the `R` Button to save the current time and date and return to the Adjust Real-Time Clock screen. If you want to cancel your changes, press the `B` Button to return to the Adjust Real-Time Clock screen and keep the old RTC values. diff --git a/docs/35_menu_information.md b/docs/35_menu_information.md new file mode 100644 index 00000000..7b31ef14 --- /dev/null +++ b/docs/35_menu_information.md @@ -0,0 +1,4 @@ +[Return to the index](./00_index.md) +## Menu information +![N64FlashcartMenu menu information](./images/menu-information.png "N64FlashcartMenu menu information") +This screen will show you various information regarding the N64FlashcartMenu you have booted, such as its version, its build date, and the developer credits. diff --git a/docs/36_flashcart_information.md b/docs/36_flashcart_information.md new file mode 100644 index 00000000..a30a8c4b --- /dev/null +++ b/docs/36_flashcart_information.md @@ -0,0 +1,4 @@ +[Return to the index](./00_index.md) +## Flashcart Information +![Screenshot of the Flashcart information screen](./images/sc64-flashcart-information.png "Screenshot of the Flashcart information screen") +This screen shows all the information that N64FlashcartMenu can gather from the flashcart, such as the firmware version and flashcart features that may be supported within the N64FlashcartMenu. diff --git a/docs/37_n64_information.md b/docs/37_n64_information.md new file mode 100644 index 00000000..5cc897c7 --- /dev/null +++ b/docs/37_n64_information.md @@ -0,0 +1,5 @@ +[Return to the index](./00_index.md) +## N64 Information + +![Example N64 system information](./images/system-information.png "Example N64 system information") +This screen will show information about your N64 console. At the time of writing, it will show the status of the Expansion Pak, 64DD and all the Controller ports. diff --git a/docs/41_mp3_player.md b/docs/41_mp3_player.md new file mode 100644 index 00000000..70c4ac55 --- /dev/null +++ b/docs/41_mp3_player.md @@ -0,0 +1,8 @@ +[Return to the index](./00_index.md) +## MP3 Player + +The N64FlashcartMenu includes an MP3 Player that can read MP3 files from the SD Card. MP3 sound files must have a sample rate of 44100 Hz or higher. + +Whilst in the menu, select an MP3 file in the File Browser to go to the MP3 Player screen, where the audio playback will begin immediately. + +Here you can pause the playback by pressing the `A` Button, and skip the audio forward or backwards by pressing either `Left` or `Right` on the directional buttons or the Control Stick. When you want to stop the playback and return to the File Browser, press the `B` Button. diff --git a/docs/61_advanced_customization.md b/docs/61_advanced_customization.md new file mode 100644 index 00000000..47d46e5c --- /dev/null +++ b/docs/61_advanced_customization.md @@ -0,0 +1,3 @@ +[Return to the index](./00_index.md) +## Advanced Menu Customization +Advanced customization options are currently [experimental](65_experimental.md). diff --git a/docs/62_hardware_mods.md b/docs/62_hardware_mods.md new file mode 100644 index 00000000..f86bd4fa --- /dev/null +++ b/docs/62_hardware_mods.md @@ -0,0 +1,6 @@ +[Return to the index](./00_index.md) +## N64 Hardware Modifications Compatibility + + +The following known N64 modifications are supported: +- PixelFX HDMI Game ID (works out the box) diff --git a/docs/65_experimental.md b/docs/65_experimental.md new file mode 100644 index 00000000..f5e6ad07 --- /dev/null +++ b/docs/65_experimental.md @@ -0,0 +1,18 @@ +[Return to the index](./00_index.md) +## Experimental Features (Subject to change) + +### ROM info descriptions (pre-release only) +To show a ROM description in the N64 ROM information screen, add a `.ini` file next to the game ROM file with the same name and the following content: +```ini +[metadata] +description=This is the ROM description that does X Y Z. +``` +Text files must use ASCII characters only, Linux `LF` endings (CRLF is not supported) and the descriptions themselves must be limited to 300 characters. + +### Customizing the font +The N64FlashcartMenu allows the ability to test new fonts or adding regional characters without recompiling the menu. However the font is explicitly linked to the currently used version of the libdragon SDK. +Add a `font64` file to the `sd:/menu/` directory called `custom.font64`. + + +You can build a font64 file with `Mkfont`, one of `libdragon`'s tools. At the time of writing, you will need to obtain `libdragon`'s [preview branch artifacts](https://github.com/DragonMinded/libdragon/actions/workflows/build-tool-windows.yml) to find out a copy of the prebuilt Windows executable. [Read its related Wiki page](https://github.com/DragonMinded/libdragon/wiki/Mkfont) for usage information. + diff --git a/docs/81_faq.md b/docs/81_faq.md new file mode 100644 index 00000000..063c8e19 --- /dev/null +++ b/docs/81_faq.md @@ -0,0 +1,18 @@ +[Return to the index](./00_index.md) +## Frequently Asked Questions (FAQ) + +### ROM hack (insert hack name here) does not work +- Most ROM hacks rely on an Expansion Pak, or might be only compatible with emulators. +- Some (very old) hacks override the CIC or save type that is expected from the internal N64FlashcartMenu database. (for more information on how to change the expected types, [read here](./12_rom_configuration.md)). + +### My Roms are all in individual ZIP files and it is hassle to extract them before adding them to the SD card +You can try running a powershell script to extract them before adding them to the SD card: +``` +$exts = @("*.n64", "*.z64", "*.v64"); Get-ChildItem -Filter "*.zip" | ForEach-Object { Expand-Archive $_.FullName -DestinationPath "$($_.BaseName)_temp" -Force; Get-ChildItem "$($_.BaseName)_temp\*" -File -Include $exts | Move-Item -Destination .; Remove-Item "$($_.BaseName)_temp" -Recurse -Force } +``` + +### I am using macOS and want to clean unwanted files before adding them to the SD card +On macOS, if you have extracted ROM's from ZIP or other compressed files, run `dot_clean -m /Volumes/SummerCart` to clear those awful dotfiles. + +### I have changed the menu/config.ini file manually and things are not working. +Delete the file. It will be re-created automatically with the default settings. diff --git a/docs/99_developer_guide.md b/docs/99_developer_guide.md index d11db677..824fd588 100644 --- a/docs/99_developer_guide.md +++ b/docs/99_developer_guide.md @@ -1,9 +1,14 @@ -## Developer documentation +[Return to the index](./00_index.md) +## Developer Guide You can use a dev container in VSCode to ease development. -### A quickstart video tutorial on how to set up your environment -[![Devcontainer quickstart guide](http://img.youtube.com/vi/h05ufOsRgZU/0.jpg)](http://www.youtube.com/watch?v=h05ufOsRgZU "Devcontainer quickstart guide"). +Expected pre-requsites: +* Docker container environment (for dev container support). +* VSCode. + +### A quick start video tutorial on how to set up your environment +[![Devcontainer quick start guide](http://img.youtube.com/vi/h05ufOsRgZU/0.jpg)](http://www.youtube.com/watch?v=h05ufOsRgZU "Devcontainer quick start guide"). ### How to deploy @@ -32,10 +37,10 @@ NOTE: it does not yet work with `F5`: see [this blog post](https://devblogs.micr WORKAROUND: in the dev container terminal, use make directly, i.e.: `make`. The ROM can be found in the `output` directory. -NOTE: a "release" version of the SC64 menu is called `sc64menu.n64` and can be created for when you want to add it directly to the SDCard. This is generated by running `make all` or running `make sc64`. +NOTE: A "release" version of the SC64 menu is called `sc64menu.n64` and can be generated by running `make all` or running `make sc64`. You can then copy the resulting `sc64menu.n64` file to your SD card. #### Ares Emulator -For ease of development and debugging, the menu ROM can run in the [Ares emulator](https://ares-emu.net/) (without most flashcart features). +For ease of development and debugging, the N64FlashcartMenu ROM can run in the [Ares emulator](https://ares-emu.net/) (without most flashcart features). * Ensure you have the Ares emulator on your computer. * Load the `N64FlashcartMenu.n64` ROM. @@ -70,6 +75,3 @@ You can then serve the webpage: ```bash cd output/docs && jekyll serve ``` - -### Test ability to Customize the font -Add a `font64` file to the `menu` directory called "custom.font64". You can build a font64 file with the `libdragon` tools. diff --git a/docs/images/rtc-information.png b/docs/images/rtc-information.png new file mode 100644 index 0000000000000000000000000000000000000000..346badece63f7db3f3e4f0b097a02d9cc6c7e7c2 GIT binary patch literal 111272 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%0AaVJrblOxhTpCmHel-h}~ zXS)wq(3q!xfPZyO^?Qo=y$1@1xhZ6hrVR@vCM@DMLnLsuhWEAXTK_xUwDJfkMIgjq zDrFe|y?tigznR6T=ch-xG|(p1XVaZ<>Z=*hgBBkM>>d7CpaEJhzt32H(nvxLeb20E zgx#qg3iFvtBW-0r^mDDvnv+Q6W4C{$T9K-U2M=H(0@9T@EQ)~rOLu##3HDGw^4I25 z9P9NVrLG!ZC$f+_3HnBabJJR^DmYL?lR7gq35f}0&ticCR!X4_4J#w3tPKX*Zi{_7 z{q!4BC>P|+=GE2)wAkHy$n97em}#<-56^abw7e3mS*<^87dbEPs|mk~b@zs>%|3+Q z+&d)VB`y15P3FQ7db1*rYvHa*HxWYN6OvmuqTfQGuOg~x2fa5D1F7{+K6(K=VrK!p zKH0?PyJC`GC}?HlaN0_z3tIyi>al$)HhQ-D@YQP4b#a*7>HJZ6-zf}Xdvg*+U-kFh zwRhKa2j<=-|A5pJqkV`gz1_CED}4CnsiP}rYdwOCttNVOr*Nz-v?|;#J@`M0&N8U2 zEsDa0LUAeX?(Qzd-3d~xxH}Yw;>ChXa4!Uk7N=0$-QBIY6^D1<48LH8WRiQ%*=O%> zt#$CD;b(YbqYlvmuO=qTCtcpUrPxvQ3dAs`?>P9^n=cqHo13Q5K-^;%fw{ML!s2u{ zG))C$7^&s;s>6%B67H^x1N!$fAw#gyyvPR2&KLx$NkA#{i<8roO6E5XpA9RI&VJgB z_#-QEmA?=a&D5}RJkNWzXdYi{JEIdF!wi7W2g?o28C65eD+1ov&ATv5VEe2pgJhg( zOJV2bUx|R%zd8sc#g#~tGd{UKH59z!1n8?FdLpW3w82{#b>_!9pR*QfU1#u?msc*s zLlzrVL~27m?M-$`t-4-d=H!q92zGEpgzs<#)I~eT+W`pyL1n7gdExKZX@j=FS`X%e zp2kz+aCD;u&NY_$CP|tX8AQ_Qy3?K?xb9B{Pxm)J0&@TrW!CbeTdDQaCzZ=!4AI_X zwZLyH=Zld$7KDVP-M_esXWZnD1RaNd=a@hTNEWIN757;)j0$MEF(4Eex%AibUbJ#2H4(`8)b-m^vU=u>Cl#&y@;=QQV zE_c?{=191fc(9X;+OLM0i)ZwK#$R;lF_5z5w!Mp_gN20SjK5>+ZpfN+L!A&RHz(n_ z3+r68Ex;uK#PbBbH;}(20h3I+LEY7H$L1(1Pd$o{q|O4byk61Q1@B1La!Pj26iMZL zyM)2~2$d?^>&2Uk`+p^=CpB7C*lf)(W{dB4Hw~UG^3;2EXq@ee}n#j#z z&#LRWDb%h)Ux6+oHKdSiW-rA<0YHS+3m`U9}$K^J-i4WKQ6m*)G0XlGqclSkP)|sZ5cMBj@Z(nY*v07-8IU;akHR1^Sc1u zgYR?JYdl}CmwSj&rVT5Uf<6q)u?RGy6tkSK>26{gM7y0{@v<2=%X@mV-o_n&ukICe zf25I;>bd7#yQTe@fk&fDGD`CQBk+9BS!F1w#*`{OSF#ZWm9OC%aeK0FI73Db3@bEm zJFEjAY;1489F`rbzC$60m$6*EJM0m;dX-yh2*QUChrvt7&&bV56BA}a#GYnG`V}kX zAgBstg$`_p$*MW?H>SeqA{ynG>#S%!!YME}k(e~Qi|pDzu{e;RYHM5EBv;ulHu9L3 zSAA8)#tHyk#fy;eOiC`Q_Nz!9-Ikxc^&P_U5t@x?u$i>?))qN)iVBAB%i8LnW#~Cl zH<1Qq{(;fFcO{8b=je5Q*>}DIxI|Q9KBwZQ9{^j$D0Y>Iac$7~U;w0WCs!RW5Rwt@ z1xJdH9=z_IyWDRfG~Z42tolq){&QHD*Tdix1}yjWX-)3C$uEXXUUAXaToZtd9v7E$ zAeig)-ClS&s^@Ke()Xh1Zw7a~ky=Au-9}m)ZD-=lKFhgYGafe0ap`Y&H|82FDhc7St^5k_tpNPDy zy%@IpCMpXlv84SO)>l?j`&LuZ8C$Uj)51HlgeBQrGO+4Ut zfCX!eI)}2m5osKn=dZ@bFM=FEc=g=z0)&J-o$j4;p)_6Tux>xHj4C=YpTp*#;P)0> z`fMhx-Ghe-DAO~;Cntc^BKwQ2ZB%zRY@_pvY(M~Y>lt-&@;lvhHY2mIR>;AUK-4WQ zZHb4&VR2nyh%%iLz*QQp8A%t#@T1)jzadkGPq-9+XC>wb9Ad=0?ldJS)FuDm7gK1C zhF{}DG9h%SN{J11Wv&0`<2;@JMj2_$$j&eWQrV7J@q ztg`CaN1N3KB`N@R4x~LC9!!eSQ~n>^W3KfWW8^j9I>ir#5R^c*P$&y4JGY2P_v*6< zuB9cQ#+X`dMhD#{E3zjJl_(f6moeN25d9C}nZNiZ4bdzarhQ}o#Fq7cM0v-$aatNa zBQyJt@|Gx1wA+;Q^ki;#Wv~kOr1+mrb@3%-Fa#oKl|kLweiE@d>|)n)Uls0Ht+}q3 z@|z)@P6}hPrYd;85zo#JI^`L+rxzRC5$N02rVs98U}ZLyIsndDrsDI=Ne&P4%SB|- z(BG(N7=_3-fT2f23y6w?fl17WK6zwXoJU%B0T)RBDu2K!O{IiYnz+s<|9Eu(J+v=m!()Ky5wT4GTe2|p=UVda-b?3n?An@Jx z^Zy@vRXHSWpAS{a)Rs{Z7)Y;){_fS)`4h})@Oi1zp4foTsrP^z@i;KLTLveb+VJ<+ zaBnJEN6+_T$C);cPW0NEpFDgZ%0gg>kv=ItKy^*3%SrVJEiVgQKKLuED!crAA_@%+ zJ%lPM8K3~PB;}WT1#8W+)=x92r9Z3>&szKM7k8oTNjEL-H4f$R>Ka3WbOq|)#=)v~ z_J6v|{&g(g7(h2bX+4Y)j03b^}F7-VD= z7m`SM*D%MG#;e7rGjnq#Y=}eV5rmOtMj8W8U0p-5nMrbxoJRYQK1a2tx%tm(Hw&)i z9?viSdfH@*neZ4EvZ!QvdY3R9DofHU{A`oeWp?-juk{JxA5s3+EM5h}>@F4EK_*FV zDX?I$M#9!r03 zFI-?}o`+Dt$Xy~6dsg%?A_DpufYp;(kEETZ;G|=lsJicu3jPnv06C5mQ`7CaCJ(75 zmT#}Waqz;2_UdkKZ!cHfCoXTRgK{1oe1KNVp9AqXAC?g+0@UrhCxsGC;0AHoP#qAr zU=oyL!-HHU+pi_(6NI)V$CqAElbFTs!+*zF(C04> z3$AvMbmgi%Ox+f<&*k5*Ob6>kK2u{coObe^_6`6u};i$qsX@T4thpLSH?oT&f z9RcQI%Y>&v|ha0MxqI-#5*uZ+v1(Ev~pDVsF2IRTF=CZ&u5&WY~|p*e+xI4t7g^ z=98%_62iFvAoE$#>#U8NmdC~2E8)=wO=}xWbnl{SanDE}q^nPrS5+QdY&{8h9IBEy z(Dlncv~@nAPjudxdw_QSIQl*Oc_KFl2xsjS9Zp^#O%CPYVI3oP56Hn{VO1E*-x(}X z^pwgYQL+p9bjDS`gnAvblPw$+v0yBs=x8MRm1XBgA8Ys^|?|Z`PRt8qM)>Qop6&cND~p4yC1) zDVhDg$ciyGwnlPv4Wsvim<_zQzkdC?OpFf<`Dw7iSj}MSWEFxsMA$ z4d`lL1hV)X;0!nfR@FEN@>#I{)H$*lwZvxf+Bn%2v_n7iRGSKyDlgN)p`d8wz5u}f zzy4#7D(7u#@+aVh8#KtuEQ+mD9w0o})Z8@O3b110@gi3Q7$P^AVCu2Zh$*yXAhspERK>G1R@5j{FB^entU&>m?^ z=b-a0+ZX-|HadLs^~GuX+vVNN(p0cG=9fTD#f63n|6}5f%>f|T_z(GR0Rs8r6*M>Nm9?`2zAr=4f3m-^!OXa6||8!E|DmwQ6-m?(|zp z$o-{O3RWx;vh;e{c^~qts?r9?-`+)HY$yyos@$W64h1p`D_h{?;o9u^+@vkedJjxi^hOQSmERJAh%)*-{4s6^drYu ze|kr|=h^-+ZxB1tx7cDWO8&68qb;rIeM?_``8Yyvb7r$!J3wwa()hKzi$jary%!&k z;Fz4!+zN>ZrqN-w8$tZp^xxTroPq)pL^&cim(18_4>#BMFJpgyzs|u`*3b-W88q6q zmB>g8|Y=)PN4cLG*z8}!cfaDyE zLbS3)Tw|sDoOb@au3SLS=VVI4K;jC*aa7vMbv~KshU;njS9e4(;><`3Ac~-(ydYIq z!v;(rtYJS}_&_qZcXGHH7Op9{`$baOV%JPBYioM8kw1yiT_#A$^99<$iCeVedFSS~ zj3dD>Ue{T9Px!O*d_eFzp!cRoG%R!v;3j`KG@qSKOB||_cdVwJoTX@Fo%Fxqot-_ta{#|6!i2zh+pmanZyN}jmOn87A+ zE3MeZnVj>?DRTZjR8ig0U5;(7P|C6_)Z}`X6R)YU{LS1i5YtU_AhFFbp;6zUmXVF! z^q?chVRbe7Nh8gYw<^pQ@e8vLH~`A9?Jc>pgUy2XSc(%3pdF!? zA)%iwO0?LnRVGJPWkIn+wKB2;bS?99J+)fS*VFdZoPwWm%!}SH zT17-W`U2&tv~6+r{63IDd;nuN-@w7cIhI8q&s{H|HV|+2CYiM)0$Y2TbxF< zhPX9Fofx>dkOW)W?bZ?DxA`6slJt^K0)_3+F5G7YPS7b@nT((rGqz!~OKj1A>g0^@ zV2e9GAqgQhgx8XwirQ3baMet7C8zT-4H&zYoesZsXhi}d^-{iWGgQ2BAH@G_s>&~5Ati_CjcfT|_ zC2MWK+$XbVQ6Casf||L({&5c{=6;w6c09-qDYFH#Ana3bzBWA zeusbx$aql#q%eufzI$^bm4% zZV`vs=AEswn(8F~ECTZE?5qpGr)uix%Z{hfy<4d*j*jI`u8s<|wSwdl9xRsUxt#3A zD35#WEHdNZe_*)5Ey#dnLF;7i1rC22^5?+;2BxYnE*44r;Jodd@ax#vyCOS5?KulG zn=maowTtEJYS)`FtpuBB-4m*2 zduJ^{Xw8)LKSca^7$P1J__{|mQ>%ZIASI&@6KM2U_7EU;)^b1w*sW>+MsfPahF>ha z3An9m9e2pY{%x6j_((@KvUwdo6+l$(5nVe4NKH_Ih5GB47ZxKsZKQSXhmrBY1Tz>& z_N)+F-?rgVtEx!4#33OvH4&-fTxCUh$)K*X5X92XH)3mu(%1J%z;B<+C_OTY6~fR# z(N!qvfTqk+rwWdOD2(Td_ayRfY^Lg(l>TVS0up1-+OJjTe;Uv~?Bit_w5yb=?}@O| zD8G{&N8_uCQy-Mi)@D-ia3!N}QudjYvsPinIB81%saXqj{WW)o-5AQG{Yk?8nV~ek#wf%@ zJ8>)x$cxzed5nLb_2ZR!;^oj;pMbFB)67z506T4>Cn}oi)j`lJ?d!1*-nE@jtN;4rZ))nQLJl$ja-xSHmf|imIu}pv+ZCsGqiJ z?3+G8E!RT@T`C;#sz~tS@O!BCNj$pC^9vSFd^@EGQ=!V)y;*8%{(7We>Z{7_{=y|n z-}W%1<$SSoo@b2Qq!n+_5{)Bg?-o9hG7VlHs{sb*x1+fnObg5O9hgThHs6^%4C~%c z#Rra_tg=Y-0C{etyttOq$lVr6gmk5J4}SqGr1aM-c1U)n^c;wYXyM~U1!$%~0^q(x{&@Gx zXFVw_6>LRZ~>`N8D5I%ssx zegRW5)A;=sCIx8;F39S!E3M;`Tc1WPOV`C8ocd%=5@w(+fQvSklcKF#5XO_{rci}y zWbNb{5u-bCeF9MQQ`i&rH3D?jSaXqk@+=?2hCaRFvgP_G2P>r$oU36O&2q*mp44EN zgjdFwD(z~=!wF?FCI4e|nigxBS2WhbQ7IH`%aQ>tWaQ=oMzS&OKD&rYQ9QJ~Xsg$U zQqRtB`zBZCZ?^~c_eBVdT7L|)`@r-JtWfLg`Lz>K4`Je_UmAEw-P2h6hDq-NwIvz4 z5i-HhBL+6M)KdAdLK7Sxx8AYipG_?~B1mB(NVIu@cq&~Jk`Iyqu>+)9*P0IiQ(g%T z9Jdydot>Tkr6GxlAF-lvqpADqt_0dWZ&?4YvNexrWD+IAP>e{B!_`4YmOl{**YcYa z)-oF#F*|i%NQrso;>Gp8g-1h~QPJ)=IJ_YazJ$z8Ayt-02&7~_yBv9MrxTaNd9Rl1 zZ-3ZpEk{hF?dEsj0xWPJV)IRUYFU(-2YP!6q@>6Y@L0{McWfyL1549-Qu`|R zS8=Zca}`H}Yu^FuYa zZ!$DYQbrH`9yV~gg{72LL%=l*+gi9y$qE2CH(LZ0JTnpuau3 zC(*B|M1U*Qc4o7)Abt%Kc()+dSMal`2*T7N&Fkw*DswzP_3H=t<<7J2+(q7ZhT-dcDzD?pE)(d}qjTjjaAWh3J;lMA@Q#4J(@5r71Hy z#4vhj$kocqdMHy6wNovV*#V{J^5dnh`a(@8tMIw$Lcm@9Wuv3^FIhzV2u21LX$@YM zgSDK7)dh&8E@2DjNPrZ|%6QiM6QG=|ESBG7E!imF*P9-4$qpcHW z<6LR=HXphgwE1$f=#OC_^iR{oSSArG0yXxQ-Tbg5qvIXQkx#DgS=Mvk#F%yNz^mt+yNJ@NX`xwX@IIU;g-87b(U9|g|j8b%}SB$cj3Q}+5?Pl~c7 zpJ=k%b+}^RHNs`^^R7-vAv?4-YZLG;{ zL1E~QRDROP9$@1GSRsAOh5!iySe+a369>sLNmPRn{nAo;LK5KSrdLo{nEmNbWT_GY z#R{J#PGXzitcZI~eQB2KEDtnSYEIc>Ovxy};7CYtrl9#3(Hg@a2`R*w;Ma;?-BS6= z(Qi4@8p*S>VGj*z;{Bb^aVC3tq7TfgUU!kU=OW*$>+t9gd#;9Jr@My|han86Xbsx5 zKU6rIypc?NKd@jYf?UHCbq;q?i4CM+eUS{d_crqhk)f0>I9b_{y}?9k67fJ-O6}oc zW*0ad-0;f>)TkpQ^PO5pO`Oy^G*reDu(OUjv)6Up*>@m-%}BM95(K7BFM*AK(w`aDWoe))BQVWt0T(YC`# z_b-)wJgbMc^T1H?mz}rnrp`xPUp5nJEVh#7!Z^TnH|h7?s*Bw#94`kdB7*;_ z=cek}>JvqujOWciwTr9T1Hp}e*d;yu*3424iaC#WV3fx&%*8Y*q11k!dWKTivTUCh zWRr)O^GlPrUEy}`ZJg^Cnmsh3yY>3ewttmB%1a{*sY1;oHE_jQS$_hpw7xoSi)m(o zMwves1xUCK28G_0vUf~}nYDC7P@+XPX|6^T%CiVkiaj^f zN}Com-Uo(}>x{}+l~%d!-(UL!>l?_T68BGJ54v=|?+3J9sUztC^(Hc=B&KkUKPZAD z35x2sYF>AbNY4w1u6{lW+EIJkNxz>q@eeh3&arZ^G877g;HA=*NOy-Xf~DB9WV$4D z_r4lYOyaKnY@#1&_1_X0^f%-X42-V%u2m%nS5FCSm?w&qEgtWrGrrV>DC?N}v-JZe z*86I&kK&hkZ|6aMd4Wf7+suGRFFr!mHw+RJ)JOrK&rDcP*djKR$gg_wXfJnkOqQgY z2}O0+4UZgR!U)SY=UQUn<7-Uqe+Bn6Wk`jYK^N|3Im!XcX5Q>Qo?`azJMnwL}+U1fnoB_=VE(_i)- zXa*4ddD@ z0m(idcY($zCX%Em2IfonFmtmd*qQ0UJ)UXC8aL#vZlcf2UtR8BF|_nR6Pv3Ha`A5& z*9XRQ{NgH;AGPsj^AW|5D#xz6Vd3o(B!6J$8A;LUOUg=rVi0JBZ~JcL&O#W7yOaw5 z`uUxe;5b2;o8a)H5ZoT6`AkpW~->r2CAUPIvV(dN!pN1g=zwjo1v9wYR z?kOu9YzolPmcXz2O^`J<@)neEXNxV5UG6Njh>6JQ;1l!(^7O3iDrzOEhs7e_bf6Hz zTefw-r1^CN4_eUO^piqfPq88HEL938!(#wk%LNpj{lv2`kZEAQ_DuqrofQIA+&T zVgl#m&$OX6F8Yv%>-0I{x+KM4VUL_C)>|{rdI3g<)OPxar^OHqY~w(UwBX4FVVSZ? zabQzoz%iRCRS|gvnu+uC2}8x|IN^PLGFDbrwMKu6udbM!R)UCu26@GDvV%^kaZvRm zvm|XQM^r!7B2;mFsLoW2*zfMt$|!)=vagTfYj(l}6_$=`l0F_iUh~CQ@rAZhh}uI9 z51QyMf*XSlo^tuopv8>SVSbdOwW~6MDGHohla)|uN+OQTzG4mhQKd?A%{LdM@RZJ4J@= z7ev-3fvGLI8nYfqg7pc-n$q(cgL;D6qChl4*oxE2$as$54EUyx|vybcQ zRZg}UAI{h#u1|Sv@<-hoaaYGiW5gESsbp4H@(*Hud7v9O`be*0Q$_$iZRd;7l@pL~ zojSZl11cQ(@P0=jSKKwNTJ(kV^~tMawCU~4;06OD1XB-8?=d8!g)J1l)7+@_r%ppT zGSwz6c-^++_Qu`+A1rW>LUxY*-q6@l8zS+Qc~jP)5f;N zjsW%o_2AC{9g02v@d70*sb`8yPX})# z>4BeRpySe|U;{*XaU=%Y1?&HsF#BDQNtQxd!6e ziZC2y@sgrT%ClykU2EtYhf{U$j#9kr^kfUX(V24tcXMnwe!Xm+XMoJ;Db`KuHRA+oP|0tO)`JiQ#!pO4 zfa?1Gz1VXgc{E*k**BA-%DQ)B&hP0W3b5FidM^-aK8}u#a(C8*satxC1cwUSo;wtq z8qp?xC+`DmfX;e;&=1k#K}ZO8PPvUxll{<&otx7=Ei3`Sw%sgdlGszgQro00uhLJsW{dh}yvJpgFQnJ^J z4J>$)D7|cH5jK3A0lM^&0xHZjw6wVJbY0m}%Y=ig8N9*uUtv)ynNv|tvUHD^@Nma} zq2=FGYPmYQAG8j>kM(P?pc!3ikU3HBR!F*rAmT)KneJ~J0NIIjk>4U(j(l$ANS zUuRLT?~x}9cxz&a_s`K&)p6;oQJu0v2vgV~Mw z(SM6eNAg1yY>bD*he#awk`M9XmmER&y>7^GaN3 z)x$A^Hf>P=M<}1eg2?aER0I)Si;D!+zv*7sQi3R`7=2JWbzxQ-mm2Kx+q};E53Z-y z*2aKIMzo{S2NZaz*#&+8t5rRCyj^vDIt9Y9lE*EYy|-ZH;>pY%JhGq8+R~v=CMZ+I zVw)GnE!wS3rYuwH_FlS)m4$_cr?o3HRy0Mj!uAaAUppux8(T@k&rrWJzZ3*=@9*=C z==-JkgBArv?!;)UIXI~)b%6%(tYf!43%Z3{MV(FQ!37$PPAlEHfOWGKH!z?DKP>q; z0rtO{P&+GYJn!S5=A&bBC4VPyXGyo3m&94LVHDY9thEr@_||15ilZ|hb@^8<}| zEkUM9wE_nd*(E_=P~Qb{^yV71F)$!%f%LloD`O;l94=w;_^PM-L2UB9`n(5Lv5Uol zC9ew#-dj%`Tol>JN1uH^HBK=BISq-h<%rJ!^}W;)fFS(!6lj|!JV0cO{dPQ!15Sa1 zB}q`*L2VV&Ej{ATB(L&FacKt_FeJi8MX<4T+-?+Y($E6M*)iN;++6I}E|fFqJTy%B zhfD#Ld(-FO~KQW6qqTCQ6*wd9kMv*3G|JQibRm53EQu9 z{o=ZRPqddRqn(mk<9Lim*8ZY#)^=|C^-Ne=faFV{Y3|Vxl9zuSlN+MfC0seH3kk95 z5-?eei|~xYN!P9Mxz_pWv=*^}zx~)irad;$c)9|}j!S`k<8IYYnA~>*q1kc6@z6H` z(g!ao1Ei@>}|j-n4X19#Tq&?k&uM zFW+012>S=*Y@M9;F9$XzM7=g7%%!N|w_t}yD#}@^sTz`Ka#ZWx2ULX?ny}+!1^xC( zjGU@8L zsehq%d=7@d{J!{SL)_^~6Ba5wBs-g`Ht7@Ybgh$P3{~+&?1d>ZgMH z91Ye8%K$JwoxQ5X2ug|jSO*R>%Mom7X%ax~j~VV`b+X z?IJ;$LrR*Gl2YTi!iP@U8hUl5Xf{Qwnkz80@?#u}3DF%GU={pDUZ^%IYHEuNc)FVb zoX5APx#ZSGhHqwfnJ~AOr;mI*hpr?3QWL6ank@A1vkG5E_7vAKvUwV9(^q$nUfoc= z7Mh&}T?C5VY+<+#biL={0=za07!Lxydo!uR9 zn)&ebSYB1NDMcQTAxGw$GO+Om7ccVs@$=_pBwU=S8TVB3*Lyz}_6fJcKQNicSvGby z<};6uK-M9BUx_74Kfa*f8I4^0Z&hDfCDW)pwZOkc0C^EvZlc?>I*Pi`);d^v8LRpB z#g{)D43J3wzv9tMqI1Y#y5<##>b&vGTjj23k84l3Nc6ytbdd&73ZtN)Sa1=tD3x-G z`JItWh&-X{Rv7|qO{%_+X=#N3>^%Ym=4^a%a7ZcHvjmfh%LWB?ve>V%unekq1I~jW z64WDZS9{0E9Ra=4u|#UQhpf&QrXQ-m<4zY-((p9ZF+VL(=6=VD8Jk)Q2#!iLt{bxC z85tPd1fq#NFCP>6kIqgh)0Gm3iuI!U^rHq800xZ9)~ptgE{F7$FdQj=K+sygx3qF3 zQ4(4ba>6RKS>C#D;m&S#OIqsVr0e&Kk}EQ7aS5-gcrk2Q9#fm(octuHU!oV7D*zKYZ|mcV}GNiUl)=!nV{%PRDAB@U>?HZuGa#TKSL69eYfuTEiPA7)W4IJRoRoc9LJ4BN1|rr1cM%U>g#6~!EpdoOG?~hjTwbQ ziPN@FRmDv*dUfGrj7@?Q$Ble{i7A z3qR<3I*c25bAr+0w#U@Cqi$fJ}&1DwFf>18$&h;^q|Vk755mXzYfCyFPibQGqXquC-H@T3?D zB|?CV)-Yg|{`?IIQHSYyZ+>G!Zf*A!67|5)gB^NgGsKo!) z>*p`)=Ti#{UhXZO{N>PJ3Yn!oq4UM1r4jr4R+0snYinz$7#Ky+zfhIRU%yhOlQiw@ z>@S`ISlHM&`1ty}yQ!8O@MOwTbW=36w3IY7J~lcgj#;fCag1GDaG;=Y(OmtOmwX1U zd!Kytac|L7?w?Ju*v1DI4+Wt6KZ<`P)ny_-OOUGMS-O6OS<{g3r64k*11#=MOr(_T zu_4(CK|$h|dfDTRe8WmgfJVjqi_3Qlx)}9ULjpGgWN=7Ts~966LA0X#+6Uwcd;Qpf zsSy2b<`^72qFyU=Y5c<89es5i2Vo^s(=Y)40scn~Nk(?Axs_Aqy=F?t7f#-}IG{c# zgo8uZ$J>9(Aj+a4$qgL7@OL)JuL5%BW>S?SOTJ`$6_mp^pVR;<3#1nKQ&vPc@+|)5_HcTv8Hf z#;uR~zD~c4t)f^!6WBK4OeQB*yD{tQlUYV(ERCZ?2#tIbn>WI43MSRpTA6XeBmwkX z3j_+4im=gU3jwylVZ{*}CnwsRaV{PnNueAoBXepQ8F=LhWo|B^2*?N~6EY?ez9vXR zhQ?5W%bbg!+|tf8L)t;V`*YhqVYR9x$dx6kFR7kYvWw!F-+=<>Uu`qTz~m<4ki~}q z4Wl1=7J(iJ9^$iUy1;#0rl2#r(wtjReBx%5<8rZ(q)#%0(noSEvqMgivI_h$Ph1}4 zh_<)4caIus!2&!BT*+G80YCZKN&sA7;x=N0 zRX$?4#khrOU~o7@ADCngj|`XntfuTp`eI>$GvI1tXV-m!K#)gZW@eWpPmoCjWmF&5 z2SfB!DfQPRd9|(ZBjkIxEs_)nr%YG0by77zMk)d{lm`d<`x#kA6cFXsvi66<3KtBO ze~}vnb*&lE(};G<-Oge98AGP`p~YPK5&e&4Wej_7&lo0v6{^(e==k-{LGISdb3>HkN44cj5iTmm140$_)e}5DZD9=b;1j6^j_smQt zrV-{EhpeL(!Tp1Md0H)LWMm*Ct+==n&gf3bA902TFP>9K1h_x7^W-4B@bK`cf7S@D zB4in7=Mog`y3&lTgcMb_$KDe2B@9^-5R*~jniN1=Gl8`2!b^gHfESu=&ZypFZ}4v2 z#+Bek3{I>x)W*h+Mw5s#H=0X~bM&USSb4w!t_;dh(pZ`~T__2GS(qB!Ro>sUSaTS8O{6nI*(!1L=j;&}0YVn9Rn{ygXwl0cP^sdo7hCNjoZUZIo+iX`1;CR2H>N*~|AQ+;@@J{pwa9&U@T0Yh%OoT>_iL`t zKH-nwzm3=;qp4Po$XyUA*ImyJ#CzE<0@+?$22h%W){mR!q!PuV_(_|DBBejLw0{yH zMD@Bp7ymt`J2Lbs*nnKTA!l_XsMM={j?$^}TrGeMOf}nZu>Mz_$46Wy;K2E8tCTZg zqD^M4WRQ|1s+(fvY2W_UI8vRIa{afMe9-z_ASisBVek%<0bIxchC;z^BVJe)cX*j+ z`F2-1DR*ZElrwGnq)pqzLmO4Z$HHfn7!MA6c&CU-{DI5fZM@`fJ7ga+lhYYqjWFU7 z!fv3y_gs(vx%wDrk<8u&ip%hl{3)+0_j=v02s#F&jD0>^5BPxSG4O_T;qfK&8W>*1 zXP@OBkK0$1x{AH-{verL+rX8>Z55VXf5^@|z@&0+Z{P7gziWN)wkCcNiF6t0|Cz@O z2mW{GA5{G||CjzrHDADOsq?me^PKx`O{CE&!27gChh9Ja*}cMt-${cktcdBa-`&WB zy7kuW@3ugE8LIK~x3-{zY!T1yhqJp}w|{3#>`x|%?N2cRJSyPY|E>I5T(&~Ed3bgK zPe*~yJHO5YL`sr{qRsh~YC0cw&!Gv$rq;+phQn5{DM1rY5F({IE~(L7%R4P6s@nD^ zBz}LLh28Vks)FOkIG4?H1#rdRgpgV~i|;90T9clRAYOFjXbyD`Qkis5O#2qbs%(UKj+l2@Jdb5W{m=cslL>DR?2LL!>%f~WJ1ktgj%ig?LTDhOMyJgzqznz!?iMPsLj3DWU|e)q5MI^?rpTV66yOL z@05QCyP$nMzXCruR5ATIPUHkWT^F+s&66BjP-Fw`B}%+#cM_$gsing4Sc|NB(g3|T zYAQnT-BQLN`3MZ-lz-2fe%787;`y0+DiE=KH)vC%66hWn-mB>v-C?@T`m;bRtgs-lMf78k36ugY$L!<1WDFtV=AUq zRM>9i1g+#o$%Jk=AekvZjUfSQKdJsw7V>R>U=lTqj@p_>MGn;NJM`7n0Y!a^H!oXD z`@PX2+0#LNqS6`Rd3?gYsnm?RN3d0y4Ky11pw4?#lQm)q$;`EM^G|{t5dxAhT6V@j ze0>}iB@QvMzQKD2_v`vzoiq*51!16vjKl}R4L#xqReSfWgADqCN`AQy7Jf%uG`gU6 z>EtU+SRT;k46lDCxlt++T|%u16w@Y?=ZV3oic)3HLOL@cP_crAji&nEgEX(S2$~tj z_DR;lCKFus0MPakrh`&5Q(^m$#tM#&&_e>Y*ZBSYYFG|ZVwIW8hxQf;8F$JPUX=lL zL&F%6)>;hGg$pKL3O+8W%KehyJ1qGsm2*T8n7fAq=;uFYlIO84;I^O(Aj(KBczA%M z@S$0=Y7t&2Fp~1C*~AAj>!#1Q{_5H?G7BE4YkwwJEwTml8nZ04U{o|N>_4=UeVPfF z#-9w(pe+6>(OBc`f3ly%-@vYz(kWF$nHB)RH;n`n{seB(#4hwwj63zz=l1W z-l8SDPHJuuLT_{Ef~5iG|f?NL9d36On9W z{k4WifiusFkfXn>Ynj5+{1V1(e4FioL!FOSNnL4I*fq-$V9RPDzo8%Uc_=Gsl#9)# zQN~VWt1Q`?3<)o``dn1+v)li{fj&BQ^Fk=p9u4H3{T`y%MMVs%PwXLI7X!q%{#6(V zt~6RI+Vg)*FV5OnWOg}rH*Q;Tigp-r718s9@i!=*RDQ6Qa@m90r{=DD;?H7-c zmB!v(;6MsPIom~!Eln3&O%$jlTU&KY3d8y4O8li^qutA;cqNj0Lp*DQi;u4xGGi^^ zvkeCbPARRejNXZ(B%JezijMbP;|q8`qaKWBQ>Tv0Z&c0EMDQmq;MtoGwJBbuIvVKB zf2LAAC+do0w-Uy}HuD63IfW%Y53nE}_A>NK%Z6DP)c>8nyVLNhS5dJyzLrLN@Lteh zIH*o=&Hm~yb@CVH3iDCnyp5)$bDHwA5ViG$%iP2_wX5o6{-!p5JxeFASC5COI+fA6 zMvrRG9-}>il#fnH18W;b_&QED6%Dt;6&rs~+j%D&Yp%Ra(h}X9`N@8Fj1fCsc{O3M zj5yl+{T%x;7C=FOK0Ueki7t6Nj^Fr4MMb&?)86{wdA)Imu+JGbzcobE?_Z?{O?X3D z(%W6qLia<6?CbE(l=!A-FHuM2LOOrKPEKO7tk}@;??>-}Wzls?RisbyO9pgDZX^5R z+5%_N2TOO?$SCJwB-`j!lAQ4t_CM#WPY;O0c@=!v1F!$%=p5rBecLd++ty}#tIf8x zo7?Or+qSuRvu)co8Jk_3ZQI8C{NK-g=r=X<%za(=c^*fkmWE|K-o{1d!TiW5PYk8v zURRE4&oD2eR`$)SrpMX#n(NtjP8HX)j`?*BKJT-$4nb!_JT6WI&LiRNAG#iWM(VFOTWe(R+G3n_S1K{@9`D2IP z77zz&x%Ezut6$9hj_Z#BQd61awqMs7vukdvF6B_K`-)BPUOSx8O?&F29LzHDS{$_Y zx{!-K>WI-8oR?|EpA!TOKVhLst_s36>A)^MH+@5QCktG`b~xo0O8T;3wg)A`Lji%u znx1>$flVokzq1-tU%)B>`7H|LLB*DrjcY*DHgk6uK(_Z|$=BKqxgNHG_}A0sJqBs( z=i?`ieJy3$@575>)zEQ%Xjsm?TKala+PuE0s2=dkT(@FtoX4JtYZf|PI1SeBEdSBc z*Fw!Q`E2!)dBnR)Z?N9g{-EA5Te&eVb8sCU`1w+@va$5xWqGCL2bmfH>h7A#{Yx5( zLA8!2X{CLh8#Xaf^_0wABH`|8{0Cw;2Z2CMLrouN*S&M+<;zDFc9w7Gq5%fV#ca>( z7jqe+&e%Y;%q?4)C#V}z+4m#!$h(EZUtirG9QkS2T4OPAog3ME%DuO=J#{fo!iX`_q}Z%Z}- z)E1Sy#dZ2|dn;F~cdZFm$CmrL!T#KW=I^~Na4^Y5C&%#6^XPp%eA}xGOUZGw-S&CM zp60$|kk|Y&rX|_QVPo|6{7l<&$NU@70>%;^l7lI|GL#q>42VQ+IVvb`2nyM?XC}~} zjmgb*-p-0Z3{qgmUim1)3|_PBKtW!fS}x64#2uZv15mH`Abj-0+~8O3YDbMX^O#BXTm?#Ay_G!iyrcj39yOniLAEKof; z51GJU)Pf1K}-2RR%v|gFg+MOi4$C~aCSUvpL{ylE1-A9EjPV+=W32P zyKa!j2<>hG`E#6-e^X1~+m1=(u{)p&iQWvL{pp6Idp$T}GmRy5~<5LSZwy3Ug0d?Dv|L zG+oc@*Je!?SXUG!;G?VsW3rTGIeKxtV`D)aQ>Kd#Jy=^qZ@ygnQ^l!Lwa8cs^VGr} zUd-q>SybxRQ7vne!Ov1$EPZN5HR1{?--;U8AWg99uGgpG$ZudPInrME>Ka~YHN`D9 z$SlQmV(xuhP#oS+)*B9WcG%-a4Z_;e6TFl8uZHi$_~a<0+H-AhRwmzQ z;rHhH=^00d-xHmk1m^+;K#*m>d;CexJ71Uq)BMK1D&GsY4X+)q@t*Ob%2zePMOr-y zB5EQiGU5{fG&Kc+X(MyZjlPT5iG#qt$ z+3U|(+`J*iuyj&-8gNNxdWQb-1GO`1+^G+J!;X_J3J27@Vld`%O>{Htcy43Hdj$6u zvFvdR6@vN_=vk+p&enW(Ck$=#!d*_b1>#LiOUTz5Bp4VV9`4F0T;dm~c`~I7?jBKX zmB2c%Tg#3F3^Au=4}qnSMX#0C*Y3Nu*e^qG3Lq3P{a^rf{-Poh-4|FEGW7w} z`b9dugQQPPYwR@H57&d&8pR_%J_okz)lZZ+(T$khFY52xKaYZWtKRFL7w59tuc$A` zE_BwLG<7}8O{*th-J>rhSGcHzL_vtDJR*|A*RGtDvyA=)rAPD51L-!1y+rBbb>=e^ z?<>A9w!l6C1>q|cs=kXCa(Wr8qqcCn2@*m=ibEgz^b_3v%}uCBN^gg0M^zw zk|DY(vNQ#KaUk7W=t+<7a73yY`Fovlf|JSFHAGpy7)Fh43orNFt+E;;y#V=pM|?;x zH-`reK@tviUHGhB!;Rf;wDn-OQ(X@}^+w)aP1~wHtXeib4BsB&2s?{k%SQjP2FKTK^W-Xr3JM?im zTMXjQxf#F{Yj)cEMjlJ^EiFxLK}*ck6fanxm5*bj#qproC6`cpZde^F^GuV=Ye73u z3hs!obs)4!SKq;CLPnJl{Y1i5qWZ%L5({EPRlm5UV zd*}iA@6YOH3hWvJ@5qy&+wmH0{XY9ogXICA^d+*P9_*i1@1hiF=UoykA4!nFr0f(u z_VU_fqj_kF|6Qz}x1M~i0cCmbi?u&aOO1^&d=AQ4tk`JGe2#LUk$Mv`ZB1?eG4R-p z(UKsTKu74kt@K)*{ecaXU>~pHU+K(+(;EGt~$z|Ybp>xAa<|E z0K%dwFw!{XTSQVmyjI)#VBx50YNn?C&VVe3wGE(V^ULdjz`%B0Yp^o7q7oJk$l!8` z@ca88RBN%u=L;T31t21T1I^*$;_mc3g#$YWz$QuW{x8-?+j1A~l>wPnXhQxP4x4J? zhQn!9)cnr-hjljR(jQQKmK~IUdu6$xld=^jhR+=J_|^U|Bg8-fXJt<0xDJY0-Z1F_ z>Vi&$T`l7+BsMV{=G`JexZmKNP2kUJ#w8nkhex|Kr7R^SgLgGd=Izb=^(!T=PH2lE zX(&w{m+Ztz6`tGV3&V?2R^q{4+isJ^`(51i!uReqLg!TIJg!SA$PI*qs9Q_RLAfSA~q;p^QFP;b^hSGe${M*Voq|5k>6B$qBf_zbLsURJ~%LM zc!)?i`5WBlDC^wgH0iN|5(h3gO(Z-SVRk1r?Re&sU6nQkg_w&1JQn7}yu71n_*Fp* zoOXf?GBH_$@{L_QF7f)1BJ;;rzJ(X9WL1y4z`UV9--UH=h8C2~Suh+V`jg-@G^LTG zUE@@hQzw5ZKq0UC@@GHK7BAIXG8z|RiWoAdrG0BT$pQi)Hbq^&zeBI6zolC~ZH9c` z@kZwF-deFW-FZgDNKRt@!SYMa7dgoQ9p;JK&J8)*_fmh}wZTA>8>kSIe2dgyap<`Q zWMp5oKjTn03}XqPBDLn`;C{=Mk0EGtnOR?#w3I?07V&rD5v9TzsFU#ujw+(2f~&g8 z_a`+X3)VlRN|UB3qWRWZmTN&%0tYshKuj(p#_+R%agxa~*K18-b-!MbDQJEpchzjQ z$-xVjjxzPkdM099Qso1ceFWvljKNKt|6TQps4DLOxB`A#vHIL|wA`;gi2*MzSDRa& z|1|{*q4wxRW)S2iV(RFmM}cxVG_>tTh`BKi{^|B~;Y|e@dP!N-UNchXcgJ;sI&U@^ z9yN|C%U##^5I+A@E~^flq1NyySX2?m%{k1XDBZZ>jOz= znoD)g@Mi?{vnmS)sYuC;+JbY+Nchc>l>G0^=PeiC?+Jc%18q`sa|;TTTV`I~@!46( zV+)L)ac50UHfty+;pAAhu&^o%nA{;F`yr>}&%Q(bW1sNxWEQTToY+Lwow3*vmKcQ; zra-vVJ$yPHlu=g+A!?jaH`z;j4d~x`b zTlU9{?)y@DwHN1gl{T&8NnBIw!T5%)^S;XNZs^g)+pO#Sh05LKM6=-9lkS5V1q-f{yYRBvSCcC(+>tp}r9a)@Hs^R;a zK|xpcuP_qycemk;f||{#_4SGOx29U-8!U^HG5|%ew;BZBe%S**HaS*XRhR&M-WL6n z*VV8PuEp-2ra+j@ri?<%+U}~yKFjl5Ogd8RZ>%CKN0rM!<}YPxr>|d#@6Wh~f`7Ix zHakLtZDY%mCmhZfPY`sni>k_kyrC}&%E11qg|HJ@9_gdW3^$90gr*BsKcy!o9PejQ ztF&9hbE^OfDsrvyiJ;{1C=M>+{^J#){qrF#OSrwoHx0M#P-I0F6~D6-vsVAD8DNjS zzgw!5!FR`TWaQy|K@_M(h6&nC;V81sN2e%Gvs&s53V^<^F5yZg;U;p79*QY(q$k*v=pI}eIWL;zbU|y;pV2>VaUv_7rN^c1ZXYeB zBjpUJcuq7pYTa+JdUA=p-;#%nRLpEF^BSGM>=}>KjZI#Su})sjUnSQ_3rZBk?yp<` zPCDP;6K{o1DknyRa&>kt{_j%W?YAA@qY$(X-g)_kEzoy_%!C(r>2_26Pw5DCp-H> z?MysWu=baG~B;o+aC z1~KU087ml-%_aD7$G|4s&tbe4C||HNu+sd9P@{+e#=ere@FfHV>C?Pg?>g{&A*F5i zx*gQ&@Cu%v|LU{j*d-`f5<@x|<*+-Hj=$;}17uJ878j}H_+QwRW|Uq>O!=gwELlVQ z;K)V$slrBv`d|h(Ji@ci83GOL9xpS2_!sYy6I$1#zybttRqb&5sIcy}BV%xdBk23P z!_&3ieFdP8t@u}!YqfB6pNQ!k+@|heh_V64wJ~qkA42B#1o6V=&%t7)C1pirEg4ID z%!BKtGv8ur18Y2C>`4wHk~m#yD{RRdh6$dit!`&d{+7bQ)#Z&%HjSD z?*+izx{l)U6dL8daJ*@&H0N3Wcz@W)IeNTK?xJHS=q4;F6A2$(a5769_%9^eehv4p zBrx=iFui@C?dh?Yn9)kIIfWE#t)!svSB(Ez0qAL>-d}9UX=?HUj6LNA<@nJwAjAS0 zfO_8YB6xq%l^J!H+29PWc>z}fECyL?ZOkK)B>02s8m^{4$C5cn6J_2Y81o%x{B$6u zc^ym1Kh*JnZ*nr=GCwz4o9q6wf6E~$NrlPlYnzL;=|Pk=+w5!&SJxkbt=bSmgPCU} zh}IrGU*tusm-~yo;b`B8N=;sKYxA7S(kyThMIO8qLUaTwHT72Z+cW+$n4Z<;*wa7AC}IDNeI;_Yo@ zecVVK6W}l07+ZT-6D=tCtwk}sG-J#9gDIlQ+-Qco)La3;ey1`9vL(V4xPLLy{PDc$ z?X^FXy?GC?Sv!osG=k_w;Aqt~WUuG1;@iFN>3XKzF1?W*4t|EHb#+D-IY+W_ROB-$ z_B5WKJVNk&_kDfC=ktQr1Y70icO(K&$El@%5>lS$hWvSVm)ENYdh(>TcU&V#=m#6ApKRao$oa6v6 zG}ZAPiJRmvouLxUH;ld zw6Z#^d79x&BkdVekTd4Pnj^Lf!{}8$<em=hJqVEzRv z;3;Vt5UaNs-}#pv>OW1d7Jm9~8rcOBoxlfUWWpNyaJ3<`tW{%#CR|M|Wp`vws)3{F zdP(<<9f%=^{=z;w@0>Ubu{rRAKBq*Z-tFm!2U3YXFHOGbKuJYTObibIIvTCD{sO>f zR8(|&R$du}g*ZUo7zUZ|k*Kng-pR?OrplZE5D5dxFo(Bg5JmCeQimfp;nPq^%fq|p zQoB1VP~-z9WJP&-0k&2Vo>W7_1CH~~gU=i`OG2a16dbm;h6h!$%Ni$C2v8}wsr{xw zOKnFs^G)B2+Vv?_O8kx4#RjqsoX%-F0!$?e4;G$B*`G!}3hx*3x-56SJLm9yZ=5*^ zoAP`kST0n~I}STWx)y9XXFT8DXD)WkdFHEiC%1Y-R2{1`etIUwQ_AI)l|4g$w=y?2 z-b3Uf07QE2fLZW^k*WGsDP}c%&FytYk#95FdIfkhrpS38D+LMxI1-P;lM8)){qNb6 za$=^?@k)kTKYSrpWdAKs3mDsf2{YDHBd;ikC#%3@(BU4xinooEHX(~|4p79T;lK)u zK@$C|_XpYckaX4i&_~6A!?eof-%kfz(vqAq>ahl4-$|xUy}*o)1Q0;WHY{{skt<(>_@qoiVCv$r*c;9E)*k< zprlw*%R)ek8fkyXhSh(24c@mSto6dgckp_n4Nh+n1 zKrX`l75EHHGdm4dhh$k2EKD9zRqOD(brNIBaia&o>F*Xw#lYSHHnTQV;`uAInp#F) zNzLytapw5=ncpM9h$leMKC~YV0Q{jwSJp7$^*2bXph=C5Gbk#njjg%zkG1Y&1ylUu zc0Pw04do6C4^RdvGjXs;$mw=9=zp#_um90SiJ6U+S6UkxJn#zxM68IG*I5)?6#Ppv z%#tcHft9rl@HTYyC61cn;-8bp4=ZYE1qJBox&5JCn1~zMt&t%V4#l@n$4s3@_&0{4 zTIH3kH2HH>lkrFIY#}a|1GP)T#a@-?#phgyrxD|IuN!(VKK`JfAmBTFdTy?N>@}*MEDk`uh6zi`YRbYI=PSlQhog_Tkqah%JAn!b0P*$%%g} z3xfnr8?xTLJW2Ud|6wD91M)>k`Y|xDVkJydaniSA#R#|l(@&Ulk6i5x0uuGV2gph~ z3cuW)VQs&=`#l9QkC2c%HB<~T(oD@luuvy9STi$o4o645{n!}PF_oCXr8}89If5iG0as$7#bQ~0fqa{^-R0_G1S-ARveiu}G$XNJvSEH7HTEp=o|fM|TXo?93)sc35&z(9sCB_Iq!Ut#w}>En-S*W~^v_ zJOK-m3XZBEZzlrz-oTW_YPBx&IN0KwCXKnKs-&hcwQ(-Qx07#X$A>x16*w}g;wET7 z=OMM)=gbl~Z(s&WDkv}ms1j>lqw$Ipd#X(7!u(>V&+N5B`tc*iS0S&nvnqf|=NAZs ziirtz$mh3F{Q3X=SM@w8g)Gl^ZXj!fn`AHwDXb6iIkm?l@*29d?&~21u-Fw@LB@kd8z zGJd$nUHE>y04~p+nHoaYgx>;7nC&#x`J zkC4v9%`0O)_QXg@L4Y`QLZ1f$4|7m~*^z^rHN;#!1uU=-fYZq&6)u5BOOX>dwrr#| zD21=}iMLy!Mteg5UMcv*AU_qWPf1M*4$4o%f9q>p@PHAIMtdF1Z{h7 zJ}qcVObnU7sBmHOFwd`tY5sKf)`8c-VgRSe^@$>&PX^@Cgsr^nI_D>gFxR`+r@n^}m zoZp^H*4<%ze`S2y#{NhFKvaHCJfyfsMV$#zZehyaybv=EFp%)D!SJPJrGd9t)3ph1DGt;DrvvS#Kmeuu!gATatH@7=|B;oQ4cV^LVnSglpHCoDla5b z{GG>JL6#(5h<2Ff~vh?Al9p)=DB{+eM=WnU1^7;Aetu3xiJ z!em1Dvf}cme_L8^Qt#1egq9ZQ`sKCY3M0x;#)`A>@=iY0W4m1iC3E?1K>$Cb8>Psx zWUJH^(|+T575JCspgKwAkN zG19rAkyAlIL5K+lh*^^y!e0)(AzxL$_jhgQ6MDo6H?08*5a_@1TQp9Mxn?jce@9YT zltFU}n6R2vC5mQD2-(UPyl_xKs9~eDC8gyB%?+Ql9mV^SB`8^@Yca8f_3jXNcMD-M zm089whhR#bz5;avm=Jp_v7Xx#zCd}2LKd~CNK~N4WO2yw+SuL{v8Vt-%pEqB9%t0U zMJc5dLJlybpuRMRWa~QRl}U`%<1ngciElJd1Nxd&7#hMN_Zbi>L9$|DQsB{mC{v3Y zR3vP96%|Q){gg+=3{_pep7QE0s7@v>ny{)(Di$l15#0%zeIX9ZI9bygI_U8!dFRm5 z+!ut@4EU!nC3#U;(ZAGHcn9jvRe`FqmFF-1Xm4f3*DufxmHVQtX;fG2-(4WR*z1J$}{Q_O5Mc zChFBIfl4d{ZaA_EjIFKaTkApU;{kD3ox5qv9XVdm`}$`|)dH zg;I=%Pb1KxR`IYneldxdno`ODh#R&@U`ut~r2D4n^SXL-d-q_dQH007BVi}p+z4MVVW#F&FWXENDU-`)g;K|L74yN15qZA4vQm*nIzvnc?ZJx z08o#jR8rtiAz2I?B$SYpq^P7Vtf`6DwB~{rg7n>JGV7<+dVA=^glt$?n4MMXh7b=} zGO;zUgdrNHsHhk~bD5ZPODgCShuCywdV4sKE9IJf$i=ik~PK6{reJ(@Ea$z5))NoV+=vt-cQNeeAjc zdT+>XZ+8poq1E!bs)G}myrtFUg9i^l?WooYUV8yHqzCfVZ;shivx+g^av4gzm=yyH zQ$Gz2QDug#tcs~e)KoAo*T!4|L z1@dA^gwQj05B>K~p-PK?@^A=cNd$uK5B;EcaXnR7*m(~x5ZE8uQ{+lIc`@pJo{;r9 zaP>_FZn=H4bpcRPaYyCa9sNiE(?@pJbx@eEmItRhi7sUO9@K|ptmDj8c#&&YG3O@1 zLhh_RJ{C51EnT?3KLnsW9}VGu*1tbp36}?j)?eJKD%itr`2%dtysxQo?={ticTaD#itTw*&Kefs#4?;J_uItVqo3VJaji$H2sp z2No<6=CufkzxwSlq*umo3=dQse{zAxucy&&939Ef?44u^8=3>3TfYLFfGg-%qk8JG z)e#GVn-iKg=`3`B2;b*`&F~Zt84LILs+QD0tr#KABMgizc$}{Pm6rW|2-B+mYpPdi z^QtdQiFaQ>Bi{}|C2KZS0e2mLPfZsNhV;xI*Z1%UUhm{n zL6aaM7hV0BdV4*t_D%vQs_3uNl>FoQ(SU_{-UO0`Ictl;)CqsMyp>jj7%~wN@pPpl z+1vA8QB_HdA-&h$h@@SMLX07vG(O3MAQxtNW%&`%`SpMacm+_&SZT?oX{plujnfZ< zWxciOqq{!dPFL!owHH!#)%5JCM}U7T*gF3OVT6Xp?Q%=3Jv*cSSo-({k_QiegEOk&COw3i((~Gsmvh1_y8QjK#0#mf`rcOb57tUC6Eqn?-FJz z|6(nEojUxA0u^=j=4P(&s^^7w#YRo2Ub8@ODGbo@(O;O*K3%L0SZi}t(o_v7Dy{l8 zmH%q*z4O=^Yty;ER@Iie-ZsWN>2`Z=?86uL5Vz{EW4~k7^y|E2=w)sgZ?ua`(GMgx z4e%hodtLqoWkdnU*uZ^>GJg<#`c7YX5W{T~cy#X?b~mSy@_A636`- zIJ&G%vZ#2_ZU1FsXSyFAMsshyjc_}w?RzehvWUJQ?A{*xE(%hD8Bn z%$^#*U8aaBN>o!zmu^HOSkU}CsffbGW@WCBv0KhI1%Z~m5L@e5YP~7&gj%uX7XjYq0Rh4Qcg|mg z#E)c`%$V1KI6jl)g&YH>#&uHXzcnHt%CPP7_LpDOyD5?lBP9m#Z|++`gv>0fGBmjP z?%D+OXXB@fEtzFy8V2DCI&Z_Y?cT?1-W_jRolZf?IzF-3Iv!DGR{mkrOreKt^`z+S z&#&PK$dNg4Ac_P>bulh9E-BUSns6qnJg^BPp3Cb@0*xjy&wqb2e^5Kvf5@FIXH#M5NJN$Qu2*{K?XDphUh`DOqlF@4dCitiqT6u zMp|0hM}&~FYv8u+xU|w-|0F82!FE-AS(=%HS=JfE9)h&)S7xTw=9B5?2V{qqCB(!i zM@OaFpZ3#%Sbenx&f5G$c~j7tfVMX~aEXZWxi{zIma7d-^NV;%2L0bDuP-^E>+Ryk9B`>6AE%UuWc zXU~^m6yuD912S;Z|{n(f2Fps#0XFKEhVyRh~ z_H)zX;{gFL5}hGm3Ru-yxZ|aHdN(&w7Jwnz{TLy+TI=9$VSRTyXcXwn1LzKbhPei8 zJDcsYL`Ve9)v5m#QXNccZ;m9E8?n??8u3=1!34(8Xvi!8M-S*t4_8iXMr{M~BmqtY z;8j&=pKYzC-b6%>0|T$vk1P_?v_1p-Dp%*5kx|B*o|{Q#9zG$CWb*HtCiXxBv<1qm zm2glcH9Pv>9DjGIqp5mWza0iLjBJ#roTD+X9=v#c&-4h!XI-T1czpx2Khi&h-OUjT z$>$2DaleK@ix(M`@I*u*+HLOw+O@VGfMHqcYAezTwz`a})mlAu((4bMA=I?AhUDK5uIEM(fP2O3T?ybj7_&;Zi-NTN zyem1_`HlH8D?yfJn_Wo!^~Vv zeRr1HPP!NRfP&1=?uv`9sCX~K;r^5x=%uQ-U#($2ZJT01UJvhFblGzIOt5@7-6B_N z`wX1|JMB&yrwm@#DB!}3BoHNP@_-b8@wnfZyx+=wBmnU~(%SL9!0VX7Cp(#EJ@& zHN2Sp<%<_itKWwF@IDK0f=f|%-Nu||?7K)tC58ynQX!A$V5XPHAefo>jOEjXENXv= zHw{f}xi4-!&4pxE=C^Sm27&@KELI%hWq1Gt17n3ERywYJ4CDnZcNyb>yA&+sf>}lZ z^XOG|recCF+Dt8Hb!2<;@B)w~>1HT0CB7i}bd3oT{ak0|LaHM4{~}()(e$^54qYa; z6FIFYp1tq`p@(GiA-BxG!d&X0JA>`*@S9n1R2gncQgG^o-kyV+8dX>@y)u667ybMr zy%Iebd1=B@qu>m9U#s}yBfGiyv`@VZ`Oa&G#{K4@W7w()Kk<>@1?G#Yv5mh?#z2Q_uS+!qB* zg7IR*a-=YeEiQ^AW66*yE2J6WXDqlh8x$DGTIO2ocq@v?#KwOZk@7j8KnfDZifT!r zTQgToVbe#qX{<*y?rn;k5{WS_l5oBH7`ZVrJi87^Md$+Xe#ZeBKcf@vQPi2}VIYMc zosY(v(d1&-9nZfj4)%yN-$ZS(s>sOvH!Q{XvdD0TDGen+z(@}YQSp561BTqOsGT2E z{TpTHe5MXrf?s1DNd)|1$0W$eWAoySp+m_{;6@$K z1;KlbxXN83sXPeku+&cyOuxw-CRhV-rMZgRP9DTSnKQ))8Gk|yG`!66_p zUYaiSx^LniUFCLkzf0799nOB0`|i69OF=Q3FiIZ5e0z(0dD8WM0!SRwykG8b`Wbyf zZM}E!$m~Obx$V>og)%3IxIu&@xG5e;>j!=r83ZMoD~r~Xf!O@#r6)%`u%gQEI$Bl}{Qb9=P|7)a>!QDdLgW;u z$A_3Rl$OgHQXM7UlwCUZHJ0?vK%cDXCp$`s`E4C4byJgM0ZCQIxd-26Y;>K&9Na_} z_juNqY9%U>3f=nPsC%R=pKI#Q>$@)f7uHD@4xZ!dnQC;4@|0hO?am5t)>c%Fg>@E0 zNt2|}z9Dx~@;@0c@~v~c!B?H7-6bxO4;YOE&f8F~dcn+jlw^5u2j_KgCMv%++v^X>KD$78nF-KefhCR39w+@jmDNb#zHZ;HqGx-v}w zYHIt?4qvHx>O^GEx4v&pO)<_Z-L<{viiONHm5+Y#Pxa;S>ih%Nd9K9#91L9-sHv_z zKe2BzL8YoTj99i+fB@O+_s1pSdoM;Vsl4P{T(b1~I0u2`%AUht$;R(psv*_3Jwz2t zL{crKmCZf*t4NjD3>ZqoaQG@bP4#L*m}q66D$l-?OY*Xc8PZmkpy)T`P8n5>2Gp3j z9^KBhgB>rto|$AlH(iL~NF!Yq5a1yGz!B?X#1;iJ!K`L6_=K|wD-nyB3!_l^cUS5E zu19Mk%&jareMbZ*i%J?tL)9n+bo>JLOBMSRFtEZer=JA%77A<7MDF4*TLdiqy+3`b zi;xfzR6e2YBdU3+-ZX(WGcF!kF8%$j@=S+BU%5f)Ya~gS5U=t4qO(H7%F(>!mwQ}0 zVFhq5r%N>s0ZJeTy36~r#sk^84nj|7d92J9IKi8`PrNQ)qxM^)!;)&6^jWoh3fh)JGf6~_TfUyNfVgO3SqyrAqp6asc20ullK-a zh0=}qP=XJvX#JVYNMO#UK+H8;kP3fFt!7Qw<26EX8s4xP>O9Y=XkM_LU7VQNoT4bR zJ<=|`UU)a}L*WzZ&Zioh8qq148M_`?kiBnK5Rj1n%_@ta#*tC?3mNeW!NDmUc1npV zaqmQUCWrS3| za@Q^8rnzWgJub)?xaXbnTd6JztDZd5^{k{n{yn>I{dZ~1INkC>%(&>4Go%t@n#6d7 z4KwXeyh9}61^8G@eQN;L>mBzL!Ug;~Z*7VZ2&J^d@HbdV`?4JMvy9CSPq}r24XZKu zoEfwF4v5a>egd+3J&TKKqBB=E_&Qf{HQs;EMW3_k-m2CvO4Cqun~$-6bOnxyn z4e;D+mc%T%m&OdtWk-^UFN6DT+;;em?zq>KcT_`IsC`AmUK>etS5>axHdFz}dB;jo zM%c*AF(Cl$!ph{j@rgzrrzz?8VEMeI=lqhJ_Ob)V?0tHpu<(2&_H%_NVbnCk#E3SY zEa<02jiT<1%UAR@$mS0&dmk_H~gd7rDxwnjDo&pD-k$ zslJqkp3x2m#`KHrbTH_E10zp3Sv=?QJ)T=(dScc*@0t1dMo2e47>ebP(VGcOW+ZJ^ z0;!B6m8{Xqj@Kni9W}>It>I|QZ;bm6oC{xH(9#!z9z8jrIxAlKrDiZHaQxPY7hhCV z67{n=U(PF~v_wt2u=lW9Sw}=iI=Woa2^vAkwlRd4 zW3N7w`IXW92#;Ocp|;nMO&7jzu`(^9F;d-dy|abdW8+=i+C8mNyH|hZ^v!K;5r_>8 zB)f6e`V#{q-w3-sf3My)u!{I0JOcUbza-9}+er~hP zRb|HG)EHN*bqLjg{%`p_7zQOsv;j$Bq$)b+3-5lIXY{i57?voizFDDL<(X`?isA$Z z2Pxn}*^pkvUej6KaJO6mDH_!tXc)}#_EODo5!+QT@bJ4_HY&hq3o3%reQemKDw zfhcVU;HM4rhk1&>>RGUSTqM)*p^+GblDF%w=Ytr*3qjj{1(-dk95 zADy78LadcGAqk3^9VJRQv^b&@;S@^GuF84l6ga+DTJKa)T^Iv0Fwu4d$(5=Q2BzXGWHBOK1rd64 zrU(0?c0!|EK;#PCJI99=u1cWa0#u9gqpAG7{4~GtW<*z_3t?yNg#a|in0OmYNu^2o z^XWVjEldSd?r)|V-kxuUfc@FX%q)dV0@nFoCA>i+q9m;o3JZ@%mf>I&^A9#@3=ATW z%VKv)*w2jW&WcZZU3+9#nFM&Y^6G75>76v-SLJ__st(^yUClNM365cueSRi}U9U8)<>S9vS`W=DQ;+CuzigO`q>>kQ$P|+DCO5 z9r||RiO(dEf!*b4oYg>;rJ1zOUPE$B z30wZhB~w1G+g21@$@aN0qsCB`uVPcVk{VXRIASSAc{UriB+x;lYObjHBe6~+1F{V! z(SAU~9zPypukYM0o$PCdwaA_KB5CB=?XN$X@Gsxv`kbd~gf&NSNf*yHM+?+Ql^9bO zMGF&7^m%<{4HF?kX<|#z4q+P@@*CM%W_W&!#8RXwsw+fgdge$Q;Gr0M{@o+9S2rP* z*zS|~F#zk}QW=UyUFwTu=y}pvfzyv9tIMu@yT$E+%DII>iNlydC%ZYKkh9FICP=7T_UIIjXOmom2 z!Xnq&ww`^9G+MG>3Rh-9#`0W5qHjPc`&9oTu6QW*(yP>|>jk!$QYkpC5kpn1`5~RG zK(;=%IX6BbL12kO-LMO~vZUScgCn9=w=tS@isR=!eY2NL1$YRDb~k4E&fV&#(MBqK zrJ~}fG}AB+l_sBc?)`g)V~96lut;Lc=8uy90d7H&zQp;lWjRUgk_7eq7|N6xBPFi! zV_X`iV$*Eg`$`hKZcg=kYJdShLgYfIe2uxssUcw!Q_;eBw?3a59aBT}GDY^tqH!Np z_HUzW!gQ!if%d;Ij`|WZE-WiqRwY(@&Av|;mmf2B zuIH3hUsn1nDz!aKKvkAouA(Y-6PiH#UV&>|QErV4-@~;%8EaW?$6BlTV6jp8k#5`L z@K2$$&u^&aUjqr;e-=vN8m7vXoJ6mk8Z!H?GU+n*XEl3$1D(xw|Ge4rs-O|LUcdIM zSyrCiX6UnQ?>$XTsrqrSdU({8RaI zWW&?0%vO8K_FV-=XNM~?`In~d?d7zpTDeW>@Ut;AI1Q%7 zKE2m=;WdX@O%nE<`~2}`E^uWyP2FOB&dx|qp@=QTE(sO7@*uKlX}t+5&IuXXC<+`k9J5n{PHJvt_qRHlN=dY^ivo_&PRw z`0G@1%#rO~=cSYB3cNt3(#rmxIcD1Fwp7Be4b{h)tu<0-$)1mYdRce6dt}~!>U#c3 zQeDN-V0$r1ni9J~X@jX~Wwft+-PZI;8rz<2V#DzUlXmq>uMJVQS7lO?G|3ouxir?~ zm(Ls9#helwBfPpu?Vx$M(flWO-YsY!@ad!%l* zf}OpTcW0N#ul%kU1LV`}VpZ;*vE4{Jz1XJ0PEX8y`;{I{HNFd#&&(rduI1BFy<*Es zbv)dr#M<9zWqZNk4Fa7TV>NU(6sO&A+PwNHsN%={jWHDs;8c8C{6A}moTgSYp|JUA z%cMj)%w|YY_Nu`Ui)aD zIklRQ%KNJAu^J3%X2yo~R~2L-C2{sMV24+9;O4Mv1z0;FP$cf#j}xnPhA-75G z76`b`g)JM^Z(L^t;l!i_fivRGpp|xYkxjS9U{@!$-?5!;uU%N$ZNuPoF~+T!n^tUv ze4biAX(k_1XA_Ymi3`X2@t==RugzcUqk651&;Pd@zN|DVuQftPmV9NL|1IRPA5rb^ zA04&D(Zyx_c|I*!>R-3A_VhF=1ExWY6*)cA!28Okp8HBDndi_-Iqiw6ev&!QJ}0Jz zm!_^UQJoXOu=hMGBH(u`IJ|Gy;I1S zUoV8z)FRVWD%16HgnHO&x3(BvTG6uVYJb>I)n3hpsHeEI*5vlEZrwd+N1%-@?#j*K zpH8lxPIARPZKXben(%6R%g!z%>)!hDSDfT;?AU6O+FoT%=y}hT*zCpnsWh%X;(obj zsV&#OSL@@;A2_=bo3^TU!TPOY-*5JbY!B3HJNyW=_nCRNOs~g3d+K`C**Gdbj2%v? zUafa{+;bVbHj7R>T_A2 z*?jWa#_G3{VzqGKY&%>y)pucScMNuqBU|@a4V%>rSZ!kv1a^qUSWSfu(P|6~iEWP4 z6z#qlgWWMWaK`OPYOi_`(bgM)d(ZYsQfpwUw6zsU6H*tp!k05DPhRokhB^af*Gfv= zOch=6Q~PdGV{K5pAB?fH16`eKW3bpdJ6j`Ycla7P(@tDmbMcm;k<3sdW#kKX{Kf>eOs|TcF&;l)M~KBXs1|Ay#E(uT7@~5va(njj#FhdhVuYs;}ym z+JE_2@>lZrt083F2!bG7E|hCGLmi^sgwaA^7ok(wg*Ck07j9@JPyq(q?!nevw-`ov zqfy(YSN$lIHB5HxTM*bq-wIK+@xy6&tA6a-8DPWnexlH}cWG)Dc!TPQAI^_6GqGDq zV3$|0YbK?YS!vl8(+|to^Zb!L%l~`(Rm)y($O{`D4ONXs-qFRX_uk!PB-6Ur{CPch z(=*jq^-Ar(d@RNd1-NNo?*BA%)ym{kV-N&ExE%OeC3aJt6K8miGyY7m#=Ral`L%LC zG1fFQc3KfX)i&$LP-`UWhd$%PwPS90#_tPb{a~l4SNvFG^(3th4W!uJg|o9@?eu8x z$EGRGOnbGjY@R3($Xfj%iG`E3_ z${3I3Jqm*QO>fd;KmK}rz0>AHrBv1+xC@AV+AbFVc7hM-{E9&6j>+M|pgZvlY; zf&wT_AyjBW($w3v1t=nS?%OiA5~}kP1rVwW`>{!nK!t?b5CtK|XpFO=vwmu)q1T3S zv0RGZOYu|5`8Px(VZ)|B#Qeurot9k{iKdAopp`?(M!K8NKKWF$ky&oS>LY$h+zAHWz zRUJl^{O^n5Qv6Bu`4O@|-|g78LAz726}7FMw{S2T9xw@^nF zO@~%)nyFhSt%_Y#PNN8QWH*fS+YI2>|5k*`>P>7DrwJ&aiL8xC5LLEN01a+Sgizz+ z_kJP*A~fEQPe|2I;C6ggZoxpiPLu(d ztl7DEDUe{4-TojocA-H(&0OJEZgn;oepg*4rD!cK#n0u{bY$&8v$BNt7jYVoyecFwr3iu`2*QlXY0tAlL=dRT zCTUh%;57rP(g1q#z+?A%^2^`{;FcY?*hW4zkzcLIg^{9^-E>b^>_?Qf&~OH*sfj9f z833pR- z$V(>KYa)CIg7EG|>c30JE|G4P3btYPjZl&rlEn6cs}>&KkKOS&@5dOsv6`Lukn7Pa zzfX*}tML0L+C|FzVq#VdakFF;cK0}wV*FxW?seO(84|msyxWt>`Z3lI#%{XjqE_1a zNz$0a7>x3ECzZJ<7md}TTpX3PLVgV7%`~!_4`bZU(0RL!tW@I3|9&@+edag&`QO~w zX3CEg5UL$3f$i+dDs=3VbS!(|NJfhIIMD ztw(K}V*C9;5V&pcZ5w3mAFAmvxE+&i2!PXw*qsv5S`&tLd->}7adsWX+cel!NVQwR zR4e7Q9d0AHidI8|@|qSKht_tZN##};^=>t8lSSpVBGoikH1+=oq1N} z%8}g-RJmP$3r-b2H9P}o6{3_a7nO>}?+EL@v#L>^LMd;67g_^6Lc7y0iV$C3-4ppR ze1w(9)pms@mxo&WIBl+2V?*z&`g~RF^W~|ya&3$a)4B7VHL~Bj-4)oT*gjh|KdtMU z^iM%m8$M;fTc2NAh1L*K+eNIjd-qWo+B9U$AhY4yl9S0hx1UjM8WhUy4C|lTemB-{ zb>PDrQC57p%u!I;4LXCem7l?FfTyeVK$;rT#DGzl1kxl%yVX0j6D%+ajNO&mm=u%P z?dvgiWzsZBFqA7ogi2FXl34#*xxF5&=0gW|&5v@DI6Dxh=`cVXgQ;#CpC)#5N)@D} z#%^SpsuZKGT_wDj!W09 zyiumpbl^%@#=`ckh1RuOJO3!DZFp?vluIQr_9IA=#7e)B9Y6G2BiCs5Tn2lCqe|nF zS&+tmpV@ibmG$?15{xS@8X!e!2(+yeQboW%m@ym0#udv#2RJ z6|(7@ny()Fp52CDL3Q)4tp7?KW$d={-juPr3vLD{IC|fz<~;KrT|O9NcN&J2)L0`( z@26Vd02On_+NW{3TJ5PjLD1Gxp6oCC{%tth zkP>KJS-{JN;fDj9&}8g8OWg`vre=SkDrsexUyW9FR!g9;vr4Q3l(DvocAXDL_SIJ| z`LL_`nUvko31k;dw+oFJ>^??r=qJ$r&Dp1^$t9o8Odct0xtZGOshhkUz64BnXj_jyS477i{rxBx-O^Hc&m`6cKhxhefm`8BMSmMJ*p5D2!oIy$n@laxNN0r<2FIE zYB*Z~8<&@1XnP`d10<{Mv%Rmt?mC}hKOUuA@pP3|Vv`aT3IL=@f(}Ep)|BG1-PSuz zt>v|Epu!NWB9bTw3Eb|A8dX`LFHKW)5DDq2s=aQ1Zp(vGR_Lwy_>?BlAvy>u{(OU@oRAzFLsL@| z3m0C&x(ypyv}6fQ#R4fQ0fF6S+qiP!qORn&tIHCTSob=xYaF;LOgX_!dylRrPn~e= zuPbaGDio>f%r(Xd&&qZ{3SmSPH4#Qd3ZY%DI@_>SL#r36Z&2+r$jXhur>Wg!4wuLN zon*glg(ARhL+&nXrHP^fO;M3TSRe{R!XR>*7gvKRyD6A0Gu1M0+y;Yw8SN}qb#6N} z*`pC@YRh{P+il8&ARvlDqC$}{4BfN3@?s2O5K@SW6bem*HPbDP-LAbs?q$nWn%eE% z3sHe6jLF^gYg%lc`g30&*dDpv(9EM$Sjju(IyZ$V zB+TsAs<4%r3PZwTNK}Xj!;mm45`>|9*VR2yY_DF~{*{5$E}>ydkTDbrMWV>owNX%@ zDQY4NLYpqv7zaT}6h?$$KvNVE1qBLWkwRE>jl6PYE+sKZr4cVDNfMHz zOsQOAGKne0vHiHUtvtyXBH^}DwoBn!|MspmMyitTgX?AK6ZEnv{v-5^-F1hECOrJy2Bvr1CX@J69D0Dvaw7 zIVY_xExiB!_wrAF{-1LDZMV_V+yuCVeKG~p8j1N|#%BmgoRGwjCdMuxgf-TxRE|kC zJ&7qhOLH4Hu9B$sEwa}=sXGj58dsjb9G5A@Wt&gRpj<{Mm#3AK`V3OlaEwVv(lV)2 z?Iua=+}Q@yH_nTfEaIm=^+`VSi~o*KefpCuTegHS4BYOPE*FxD;k=l<}^uuwaEnt1Nbf)V?$2G%pq0y=*2L+ly2vOk#!nQe387o**tyP>N#=5ClbR zW70|wG;ioL7vluW{8xx_?ylF7J4IW7?= zrOXo8LG_VbG#NPtTzRz1P*-o*M#8?kN}BQ>E5X{{w>E&$uF*~?Pfk)UO;V0+ILf3z zf>J5vB&JlJq*R(9PD(Qnj$KK1i)eu%&6G!$(VAfOdQ9=a`pYVqNvd%X+o(qNxAIn+DRtL6O@t?W#j79WRfJAq#RFDiW4Tv zWhRpnrFfE3JV}z8jCR64PwF}=zGkq)Y*yHt)4|(}T0mk*&kt zzEtYZ+_?fwb8|D}Wxy}RP!orwZ8L8w@` zU>?hs%x9pl9}_2>ICYj+UwxfpCr%Otk=?>s*@{dV4ayLN3Sv9V5YkFYfrOAW90xNA zVaZ05KvN8wh?FMEXcDa;90OB^z@W;$ato|#R+-93Oq52p$7K|0kXW_2+iE!=fVhA$ ziUf^OG3XR@iDCiP%q=pjeK9Tca^Q4k z7)6*gW$E$-eC9L%mQ|}(@ceTx@azBYZ?I?YAqrt=$3wLuB}J#MVn>lWiKT5(KyP0g zv%56Gxsb_IWd@H#3{9TrJeri4GUG(5h|-F(iP0)XDPtD{tfaCsI8~Esd!@3@Ux^RAUSInHjIIZLK9bQ-NZlnXaAVBE3RbM%dhcA|NYN+X8R+IjSbTjXpB)9 z0upVk#>{9ZEToY5-lc6gq7Xt|AWdL0u>ztoiG5!t1-A{iHW38M38~hvLP21>d|SyO z<(pt@>`$6NM^ll-i`OyGw}!E%Ns=gGbo^!Zyz&a;$89=HY?qC;LTg;vWGgj+6Sn=9 zOk@#%MsP0ArGh;Ocwo*-A+(MQRky%>`!9p2gg`v+3>ar4SXs1WZhn*t2IJ zd-m?3RGx4u{ET>|?AW^12w6Li)TAhr_yI5sHZ6(MV7Sb5W!(!jwq8(ZjE*6&X^h%n z&a7TmU9p_zLOZ99pXa6LcQH{aF^NJ20SlHdX5RcZIy#D^BSV}xc#6ZXA7>~vXbQwk zWCTE;8MZ+RRX}Kp#H7rby_`9V=Fl~}8`2Y;I)0d=ukB`d2#SP^(?(}UKl7HYq<>*6 zi5_F*#BL7n+t0aUbnogqAB4^JGad7WRj-EWmWL(CiqZkr&0HM;D)V^m; zK$(=;eY04zW(|FF=VLIOFOAZS;@p|D9C+<8Cr+QG(9y-RRg37K-A}P---JqFqBPFY zqet1de?O;AoFvdilGIjQfvXQRnv~E9UuBxwVbPL4mJO_?wYiJIp^#Vh?dH&-{Sb^> zdkzhKU0p0&w1j!HmQXGm4jw+mt^=i%d>VvUcrSe&=_7=Upds1VKno zPY;_nU&;OVzn@L(*E4^?eBvbG;Gsi&^{ZdwkN)tF7#$s*!K-(T#~Z{pruAb}*x`sY zxj^qp2VfF9I*WYbBOm4ZYqrte+Ql@~{ z0BhE+;unAM|77Lz73_NTRsQc^{eO6E*K0LivncEkM4F~-zIG$G-*GGJ*Q}&8R_2Kx zKFMR>dzx4Gzm6hwTPoQEM(y*EinQ-X#o+tXjQ}kALc8+;r0o^mKPn9-Cmt zQ_u33U-~kSJ^lnEW23gWXY7VhC{<|~jlm74fl^Iexn&FYz4yH=TCsq$XHW9P;}7w~ zBad?U(4f~MlLB46o!ox=?JQojl*5OQ@bLE@;l%MH-~^faZ?=jesAvukm+Z`#VmY zI7PA8#K`FROjs9(!W!S&p#xi~W(AHan(po{?z!hZyzhPYv2NWux;nclO_n%y@)TeD z>eu<*&;1_fMuzhqE7)FSR)}bT!WmT6b7$>kjIzTjJ$>EWc;hy1zvB+JY`&7VmUbR{ z_;G&qKm9)(J$a1w&Q7*oa}D=D_#hkBuVP?UKj(%{^TLju{QcMep6`AChnyQ3C80X} zSj7OgXWmk1V#SITeBgs0;p%IyV!@(?#PN9!?BBR0}TBS(%gZ{89f_`rkQ zcKcl{U9|`m!NEPR@q>pS=I_4#x9oiB6|1S8@}0Qv(G7nY46|p=VcX5Oa`VkMv2o)D zX3y^9d*A&ozw*n!%+Vvq=xA-{!4E#bCqDTJR;*rwRuGqC#>XdkVdqZ%^pF39M;`ql zqod=fG$Fy-L)f^yb&Vz_=Rf~H|Cw8EyqWfvPD-T`qoqlXA3MyS{@MTFOJDpe&X0|g#CAv~Q~@!ze7zG0 z!>~r^=<4bsNfLhV_kNGx`mNt00Dh@ZC=kanvuDrdo_p@0tE-DBia2!W5Dz`{5NFSx z&4>Grz>g_6H8u0W5B(&c`qal+y?O;E8RzVolbkwwh|zPS9Nf2$L;DZ0dDE3V_`m}! zS-O~si3y^p$enlI!L7I6OiQsyX`;mP`D?jm>+Rfh%lnzLdsG9zx!A(Qc$tZKoPjw5Ty@Px?z!hZtXjU3%^R-es?FE2XvrFMQ#0q2G6|z>*|LO> z-E$pVSFUIEz%q*AGCJE9QfldABq=jKF$mhK53KY}wdYrpSFm#RS~hRFimh9>vU$q} zHeR`o-u_N@?|zL(zW063kDh1!+O^zz%Prh`>n&V!?bR$>w3tvU&Yz!PA}$lPwR7FQ z8@Tq?4Xjz$$rXKF^bsUI3nvFhDHg1TW6^@e+h&XlX6j8Cj(j|-7x_JY)-EuouZN7@$zIl|&G3Q1`okWomHEEVCTFT8g+{%Vc zn~9Tz)2B~WW-sX|$Os+EH38LrR755CqD2o)~~(_;(lH|c8p^q=NL7IIeYFn zCywr>5H$1P10Q7b=4)taZDnL^gjLH{a`#>DVd281oI5v+F=cML@fL2n@n)7UU%}e7 zYq|2ujVxcjjAF5gv9SpzCdTX9b!e^8$_iz6_Df1zTPs1R86O{Ga$=H>_D+-vIB@U~ zPd@o1K~u=Owd>fnZ5ub=d^20NY+>%)xnLB7L&GSenZIx$*Is`;n>TJ??V8nW+OV1{ zH*I46{Dq{cVPs?!liGZ#ML8>z5Tg>>XLWPOeYf+#hwtOMZJSs;e-2Tg*!{|W9)0); z&X1Mp@4tf0*WAF8wd+ZP3C7FA^tJ}{w6@b->}F`F%;7^Ph*dcgpNrd#hXzW~QS4#; z>dkD~avM$Uot!I8qM{LcdYf4?tDUj4Bb+*Lin(*va>Mm^(bBt+F*8OfEYsU%m@~VZ zU}BOZhmLW6bOKaLPfs_SuH49$E4MIb&K%C4A7T9b7z)MQzD3-B--o&PeLu;yH{8VR zh4Toam_7Sn0s;n4pS8VuQWni$#4R`7LVI^VM^Bt&*WTB8{lypAxqUmk zw!g-)BWKWI2Q3}#jF(EBJadfUp&>%0NsZyy@nih(@h3QW;*=FF^R6rC&q=Xm) za~Jip_1bkTTRA{f(v;7a=xn)yj-J_=sEyYTyvFFrAotvN2Os_5hnP2K4nbUG^xPzE zt+VKvGnaiwj&b_@Db{RU&ehkhq!=Wa(kRVoC$oF5VE({5_8dCM{)2~^eMLL>-F-K+ zySh1jbco%r?q%nzukri~Px8#O-)GO>L)I9$BKHS19jj_dRIVPbCo;Zu34#D)469eK z=H{Dkrm3k3V+_wc^9+wa{GC68ii5YlM!22M_X{?|kPSD|7@wK$@m3UAlyy z`qU@bxN#$+qv!eJ7yg>h{kK2lFTe05{^8pX@x6y1W_)s-pZLj-@iRaBvn*P&nBBWy zr={4+&;R_-bH|-`po5Sd&ppS=^{e>kPd>=)w_nF~Th_5<-CFLt=}vCG{uY)jTFKE9 zr)lf%;{K1kkGt-@ovqhwWYe0}+;z)s+SLecLm&Mp zcir_KuD)t3D^{;$GM?n67hj~mub-d(;`&zml3r0(=w}@i9*a%JD;MZy@}OpR`J0P ze}JF-#7}U~efMzfHCMA{^=b-*W=@|z&Dp`>s_|M4c0|_@Qz#f_545sq{#-hW%^co$ zjI)F1Ny7q7ovrlD?&kd1IR=N$fT|kbf?I`IDU41rI^n7t*K*H&Te)iUJT|Xb!osdT zI>XuYb+6#asf2w;&rob{=e9d<;bR~EF!$VX7gulDOmlOAy?b|Y^5k*SB;o!K+|Q?e z>eJkQ+wEL?{dH{Hwv8KZxSnk{Y~$)J*Kp?aNnU>GMf!Vt`M?7Y@X1g86!$&wezx7b zjn!*c(An9_nNue?Gk6A*ru205aR2+>&nG_lajxFFg)r0{IIx%DbEEb-YP1|x{OpL% zt{$$s>RL8mvz3<4W}e*f2!HTje~mAH{*QU`p-0&9_)d1edV(t!F5#d4Z~vUz@4TH- zT;jFeuXEE)+xXd^`$sHXu!vV)eTC7n^ZeY;{VYHE@sDxURabJ$EjMxFP20Hg%1z9k zGmCxu_Hy>@*~;?JStW**Qjs3VaQ(I$S+Qy*6Xgj`oI1hq(2%R?^LgcdtCXIOPS#wpjM;tj(59KDrcNd%Q}*uP z&-WksF2m=~U`&}aXO6OK=XM@@_))e$`5axH{j_!VF&4+{IkboUhxamB8n4<)RSw(S zq{>j59OKO330^<&5>G$<1Ag$`Z(-tq-mW>QppCtUPq6d#S2;0wlmmxf<>{xs$DOjTyyQUeEd^C#e43)i~Z(mG;&a zPMti?&gY+F|K5E(`P4H!@xs%Ll}0!-c!cfSpWxfy{5!t=&2Nyz3H<}JF&bWc@g=_V z?S~j0J(uk%*;l1CO4*Ir3<=}s$2orVEIXgu!*{;>1D=2B75W$U(A1yRk@DmSyPkiMlSfXm`_)5y@7s^__!G|& zwKmb-*G`EMUV8OecJFaEvOY;EK4$z$w%?IoUk>Pen`W;-uDw~O&HJKSEi z-%8!=uzL8i@%BMGZT8BQE4lgRn`v%tt`RykSe2A_oc#@rRG;rG=FM9`f8T7<#4tQ` zj_uDq$M)x*=g`sP95{HG$x=+Y6ceb>Z5>pASYwnX2qTONXlZF?WO$IBPd&kFFTPBq zn<#envtZR)x|c3wtYA2=Cm0$$%z@oI*|XyXg2{xQ)^3)pSk0V;R}d5moEaQuq7<`q z)k?PAzKtat=QA?2hwVT78;-sHI*WSe@tzyr%ksr*IeT`LLTd|QR3s$g$iZWrJbsp@ zrXCi|UrvAD0#Y-+QWHjG;@$cAv{9*Q-`348~KE%PNzQyx@`zWt|=LO7g zNK|g+#%piqs?E1BIGpg%Q`>p!l^rzo2HbVu&0K%uRYZX%3Z~9Xz)wp>Gd@=0wVj6; z8k(f7Yk<{T*7AW5y^nwL=}+(rKl^X^^!-1>y2V%0QS2fL0>U673JYlLlF30}P)S6P zv~uK?lH#K4 zQ#xDvXlt2GYML+$v8cHQaptm9$gh z<;R|5=MQ!glm@uv=KI-n{Wf}LwL=Jnf}yRugE%TMQG}qUm8iQFu=W8S`*mwK^6iJA zU~KX%L!-wj6au$CkAP5YU7H9OIfvYEkO`DJCEABMXLh1wK_C`wYf+P<+5R7yi6LW z1Uf?NkT^{V1A{J|<<;k2;k)1XAz%CY4|w94SD@I;_19m`ilqwyC{IiwC%weuNXd*TP|d14plOaYQU z0^Ltp6*ztB946N25W*H{>IL1FqT8UgJ0fbaV=qUK?&t5m_7(o%cm6A1`tv{M$o{>M zq_j1+(Nt`;@3px|qC!;E#Jt6Gx$eem_~1w0&(HqEKj-7`{dv~Sxs4_kqD((DwUI_e ziY;xZmL`Jk7NV9eVq<5G843hZ8(nkfvi7RY-1p#peEMUb;2(eNr@3?8eGG()Fs6$% zE;2qAGtk@5>ZPj~XzM3T3+#SvKc~;0CX5Pb6%x3zW3y4=mhwRBi19Iab>Crru;T@O z@Y3TP9N*8RIST1n;*k?fBx7{+w$R)$NlSB?f*B_sPUtEOFlW|U2KpDWc*$}KVZ@2! zXL$0-T|B*gC(j-_%t$ms+%!Vea*nigmgb;Ld1#2HBw}9AGOpQtEAPMOBmC??`Z%BX zsr$IeP&$AhWbd&fJpKIBgoT7=RbuqS z5ng+82PbwPVfg4d4j&z4=dL~M-1j=8m{j#LG~UFxRwPBmz@lDOtX#x`c>}aJH$xip`kvSL{m=alU;fHpa_-zQ`g&WL z)z?W{4teac*ZINDA)Y-p#KT8+^X(V^ia-1NU*nr!|1E|N?}YLsl-<;nYOdHr84P9G zI+|F%dr%;Wg6lYIRvf6wRt_>1h^@hT(dVv2<>0^P~+Gh=LjaSzY#+`)mPdl)=> zkU&q;)m3E9oE|!xLMBce7VA7kelw*1F!cO+>-N)(Er)h3!Vcxv?T)pK+7A#tgYU}4re2yVA zh$;@z-l15zWFZ4xbJ1zQ_*l#%-+zQJ{Mn!I)j#_J-~XF$a`wm>n-Q7m!1nc~cGE1Z z;WG-xM&PCA_w(FyJ2`#k6#aAC_~3`$$G`ix|Av42uYQ3K-Txu_XU$`BvP7v|#+Win zrD$WP#iqvQb!zO?>>yB#PmJ-}Yp?R({@d^IwXgj(!^49ViXq+IU8HH^v@F%MDWxdK zWs<~hmSwOrV3e{m5rQB<1$MC~qwE?esR=lAVuI&h+Q}<>UgF@P7dU(70If{{tl zdgk9!9BF7V%v#aTf<>*gwN4UEjxcoOIGne`Qxhpnghd8c%wo}o*>rRo(sY>NGsif0 z{w%4ENn&_m$IE=>&;OP$|M}PW+86(pojYFU?5Pn@kQg{UG|cv$J9y%mXBeHBw3@#( zB}vP6Mp8NEl^0*&@kbxw```LL-}&ZuIdKlmZ5h|TX9*p%N~rKG!>11O-EaOa zfBC0>#uq>TdA|FNZ*lzSJ`}c>KQwrpr=NO+AAI{8eCO}}mR&ErOj#QiZ&=B74_r;_ zd<_hugA&cn5$o5lW6k>2q*2P5!4tgt>Q2%)LHV^ya5J|248%0G25KrssR?vaMopCI zYaU?B@@wgAS%6V(oH{qb;K@NsBV`I{FDkT8jkF|^>-@uB(O9!XdT%N zfr5xq*;WQ=no=rR1EoNPggUb8MVJ6(0&C`{?FxO$q=YWpTBBA>57-Dq5xpN~NJ#v!c$Iha4JH7o2C^WZY zbWBt*v?d3bt0q}p=%nNPd`icAD63@<^+U1Q&XBQ7e%QS6`VM8K?AGQEnw#4&CSjs9 z#*P=BX3zeYNz^##2__~7DaV7XUN(>a?dLwpzx&s}z{fxOQ`~&ZeJozGmbSKjlq!;j z&6Em7Cfg=CRoqAO?EUn0pP{pKl;%@q`b`HB&2)s_40O+9{+t!8S-X|3x822-o3^rK z-F!NGn}`aAVia0~L|34Fu~sOwvHgani&nB~=~c9K&f>*a_wePv`zyZww|~vv7hmMe z{xclgb%Nu2&ybev;ywnuNS1F7wFYep1hf&R3psV7o1w|2By+A{qQ8w}Y6lbPNm>GE z1Da4k2L#Qiut=zi1gZ&T+A*dHOp(AucGXUlo6_gnIBnNKQGg*uhh_S@o7lW^A$MJK zD|cV_9yYAHiJqQ?boS07RuiZ~!uj!YJpRPv{K@D4g8%-1{-3jB`-?QUw6SUHmE3aIt*qa)mfqeTl5$+x z6f1UnPH3eG-18_vsenL-oIgL#(IY1~dEzWe1$1?GyTzWYuu{8DgqtOTM(fC>(^kwu zU>D*`%5IjAo0$@Yux`aH{^dXY=ltt`_P_I!Kl#tN<<|R{zi26~twqAnmWV)UOk&r^ z7#SMm*rCIm8#+gGp_Nb-Aqj!dt;k7L;I=8XIi{=zCJc%;%rLU4RbZ5zsReG9Q5v#f zU^UlW^FD6A>BB^wy&OD!mhV0N1h4Ks0<@q^bERjV$%V>U=$e|YVk=j#+RBIT`YC$4 zmN9z1z~e8z%2O}BKq;})TU$c7dhrTAcJIenK6?Y>V+EdnVK0w9v7O2Bn1})>IC0`6 zU;Fyk`Q1PKeZKJ5Ut;&(eU&vdG*;OO&=iIgG;TJ9a*GB+oF+W8;|2cf?|qJ6{H0&y z-~Yb8wUEfbtRxsUy? zy~x?qgCt>0&^m@mhB89F}BGtVC2cmMlW`1il|Yy8S@ z{lEOz|M_2de&;isJbsv_ARr1ADl{aNFuH`+69j64kV!})CMPrpMtV8b+{cN&R)#tc zayHya5WfPY6R3$X+pQ{t)!W!c4@~86Y)ZswiKLto5)rB*<3lN7(oR4pNz%gX*(=z# z?JhQK+)AOj$oA)+;ad;=J=>q#&Y81k2$Z2kLpU~uI;GHux@e!gp2V!?DE%A^hdHLs zQf3s@Hpzq;=Je1ZUf%fxfA!x!%WwY2|IBaw-@nW6{>JC{yRZENgTq7iUAiHb%Ezi8 zRd%g{){cngwh7GS5ND1Y;MBe|jGjvvPBkNiQHG0yBu(R#nXsEW;T9cpQ$N#0k*Wz2 zMkuqJb0a?_oP3hSX^DB`5$%Jk86Rq6EP)YV3#rW<&;R1j z`HkQHzxkct{S97t;aTFbl!5M9%uwdbQw%z(Z zR<2u((IuXF_WOM6AHL3u&+K4yD5WXtLn%cmNl1ef<)*rqOiE0G(FrPu(LouANiz%D zd5ld331w1ZN{OACd47DH6phjmDh)^`tpGMr9-+Idz_y!L@WBt=z!g^%Ikj&efAhco zlE3}pmnoe;19}V?b-IkKh*Pa_$_k=Fz}jm!amNR4V*T~=N#i3t`n|v6@Bi1Iacs|i zFpwx%zHtM$e(b$$ym<}fra>Ni;_vzV=YNk^UfuyDlvBG_h9aaGwbIkxM{9E%1qI4x zIVmuaSS`f4u@MsNQsN3@{X5~ZG&#!AqX#%~qg7~T*@e>lH|gtx%zU)00BYaP+XpX0WMzpdnvQ(WKQE=clTb=kRuJ@@ zI&qRyM^B)YqN}r$+ity`TW-IDRqHo!^$pjuaM>bS+FBT&9A~mzBGmyKH*ev(Yp$ZB zy&Z+-+`02iPQ+*wQ5e~k1dEEWkkZ<&C>9|I45+|XR9e~ItX6~tXlrXCYA({$Qm{Q= zGmci1OpFh5?(AuHJoz-=`1&{b%Rm1zU;E0pdHuEhjEsy~g`BZN0jaUZNlB7eBPxyC zr^TR>m`Eu?qgXJ1G4tmwrl-4)wzl?~{Y&hpkojc{pcy?k&cyi=ItXa*=;Yd~Z{W6@ z@20veVhH^P!bZm_0ckbY!?|p+WfAuf;i!b~UPe1)6rLhS@ zt(>5w?P`h23WA|CWjK54G#$ledRw|!&@-3yt2VN1$x1qVdnp^kM7c~{a*d6#y`+kI z)7D)T%>XEr3DFctw4%AQjU~&M)6?5WYil<_As`49&4mK}-CeX6n@C9r0z+GCk+!y0 zT3T9Asa=RGO%hCM)sShTN#cZ1rKEAp#P|ed6EHrRFg!fMYcK8R2j6{)Fa7m5_{%SS zo$vqfafZjwV@T+1>*1ce-p9ZC7r($S{O`ZOz4zV2!0b-@2-;3l42axw_-C=&1%S@Z zF1B91l?OlgQSQ9!y{uTZfv~xiRBJ*~ngUIGv6=Jd#wkx4l2kKm&H}Ex;Z~L|SwR>U zDvKp49aL6|wLL@Z-WsW2(9u^y*-}U%@PYT;#{Y=_8#S>?YlTTG)C0a zOw=0EKhVrAw_L?7H(yP&hBF5a^Wu}wF>-R4V$@7aYX|5Eh*-69JwNkv|CoRCng5-i z{bxVJm7CYwj+5ILsI9r3rluz5&7DUWgkTJXLPSq@H@X-xFn=yfHm~O9`|sf158lB| zw_nSewaYN6CQwDva!4|6D3~HW9kY4wdp^Lw{1^X@fBTvLllvZcFFk!dq!1b;qG=?yaNyn`KG|)Aht2S(q~ZA&Uf{)-Ui2fX zcE%G1DWe61{af!1- zXDCgMvtsEIHgC9+YqnfNM{5s8X-=Lw$@%dyRxDe^?Kj-Ry45#Onr!E_eMfm_=T6R! zpQgD9nhUU?YZmw2`d%J<&nLL$hI`qt_F4+X7Q3P}B__tt5ol`^jSGVDXZPY)j+@G=hgQ0^>OdL_twl_dFY{s7#tkT1o_S&D}j|tcFJUH zM+XD5XR~JQ8t%CL4&HP3d${5H>uGCg;rP*Gw6?S`f8Kls24=B#?Haahx{~&e4p536 z&ppdS4}F_~fj&O?p%1ZY^=djgI%sNYrKP2v)2GgI;`nKdQf%C~fqU+K59`;iqqDP% z=B5_f+B+CMKhCKWC+%V~Ny?%{OSxjvQU(TQv+c$kx&OfraL;}3p|!o4g9rDbwc+l& z?_$oJxg0xsjHjM{n$FG+uD{_rqA23I=bmH7jvXXPg4UY#8#gj*&TQt+o6FT#U&Y$B zYtdS&Z`i=qTd$^cy#-X2&lfhTf+!-P zbf=_rcL_+BbSd3PHz=v3beD7<=?3Y}L#K3i_cy@r|J}RpTGw@!F5j4UX3w5IduE>f zY|m7}%(vPe7w_ z0!azRWrGe4b;Yxqfiqh}jQ5(IVWj??Hp^J~;{^so=m;BI8w>G;Dz*SJ_OGaR*WhA! z1=!%Pi>)T%-N~;iic6>}&~q6XyU}j`&s;jnDtF@#Bn>Yp9_3?p8-z^-5HN)85tY(#>9Dj8c9yBPV0~P`bZ(w*lAGboE|?YxNedW3k(c!Xn24 z7zL}_8>Lt)(UA~mqVZ1C1o2YCzSS`e%f;QZnYJCrnf9wWSNh5sJ5m~z_t}}5zV25@ z`+ZjYtqAlDe=md0)N1VB02tLOnDxE@DWC;D2l=P^DhV#x);b1k0baiJ>w-`S9%n05 zmS0%MlW<(KG)gG#F9Pt!L+}SUck-qi67wWxWYa9RwwG`AT>1HLz`o#8$~hL{^`Q5C zHxDn9$?~4COjq&`Fc0jeW>YmCXo(x-#a(+lPW(ulkncUntS=AYb7{L0zxf$QFZ z!zN^pA1h$88Jm+a5_J~z2>UDc?SxG@4W3&=&tYK)jY zkZ5>)T}7i*ZvE6peQ0v12@zmF!1OWT7R#@NJ?gsS6xjV|L} z{ho(%k*b*E-V@#%7?1)hj&|HU&C`Lf1;CuS>~R!YSjR0_zQ5Qr>WQY=*xOn9+W>>d zX%l;J@D_h(XU1XL;(Eyw?7s}Y;P3q1Cb_=8otjzg>wL62G&3WmnAWMJ!FIIpg0HpS zajqw+a<(sCX)89C612zCW531U`EoK_UVVr?Kjv)yPJ6fJhz)~Y3viXlJ2akh8TBWo zrI-6!uv;#r6JDU4%{j6=&Rf42x2gwJ$jTupJYB-`7j&UKmoR|wRkhp{{cP@xz;Iw^ zZFvLL?JjKZpt&EjiB`l)fuWl&X%7<)=A{s~KvX@Q{}Pu zI$dM5D#ZYd1C*K5X&nXNSl`zyzFGyN$evwuz%LkBEwiP+-`(9-AdS6E-u?jmH|;#Y z>&WQ1pjqQO9mfty$%o9eUXGd(ON)m`qUVnvHl>_1oXvS6JI=Y&u+KTsf|+o8@`j7s z!F+AOpYV&F9f)KrAFgONqSPt^G;#hpmdC(0TU1!R)i^uUE;3rWlxPqQ`aS`-=6%#NVnm=spL! zl$Bo!qxV({$JSCm)*a+8*#GB2P9YJLjJvR(Rv#&Wiq`zB6wXlZZ6APRPBz?tO^91g za&q$O-Al8L&CSIqEyy4DE8DX2%3_-f8*&Oso~vyKhus-KbQ_dHn9jl}PW)qicO$K^ zFsZ3Y5I~dv7HQSaG*CIbVvKt=m^^)O`Lhc?(kn}sxlg(Pi@g;d7K z0n93a?p4SR_-6rFR6yL!$mWqOBoCb)?>kuXcizZcnkT0VbI<$`>n!N z?D+UNoXpSLAF23mkU-%z?l{EgC`x5`e!N59Bpe_m6%-B4dy6tA#)gHk;DSPBf$;{8 z6rq8geq@!VP(+E*yhpOrqWCF3$KTF<&H#DTdfrlFOUsqxf1KLRC#=a%msI_UT=2PR zs^(u#3pkG*&KMaPyO%=mer2b)hY#y_Z5o-Dy;7w4!&1D|Er>Ea&i;3s)7HeqYNd0C zwC;Klf#-HY@48Q=vHg4*tIwCMrl$6#-ABA^Jbr6%fGKOUy)K{ZvI&6W?Gt6zr1-#` zd$=PH@ZRC|^-14@n+^`Flbu&hw4DuNG*0H}HXwiU3#bjoRffKgUiKz1hh|E~FuI1^h-Rpl@Pt9Vhxw5YKV?Eq=%An8P-Gc!nu zDsf_J>ailNwr~+!lMs@4?;jy!1OdK=rd6Eg_Pgx zNI1H_X!|1|CW(t*=-_ldaS(AYmyXbsC+X|koBCthlPr}i#g6j?Kt;bG5%PTq7ckSn z1=IFQH*G>3wsI;~OuB zb&gu~WEntC00AFyG;l5k5~u_&41G!VI5h#(s^Y-Vf#pQ%gp{r8i`mjkFpv!0+dEM@l z3NH_v(GFZN-Lb;y53XYLHB@BpMeXcZp_-I79{N5i+8#f7uTE_@k4^eRg8(Y2Yx}l3 zlDvoKtXZaEzm0ysH9~d}O{74p{yWVoU1oV<43Y8g%={=J+mDGMfA-3?>Pn8DOOV3v z6wdY%s7l@aeG(C2kUU@QO@A|rdEW2X(6ymxR4_&_K8y5kl&iz>t7+SOZu7oI+;-%o zhGlgoi5)NPL=#X=d~EMqGw*uWOh#@1H0DkTFWrzN`)a{wwui0%3Q z7r?};qG|p7=H}*u;D^N4L>~KaFdCS6+>nGNTwS?gO5tKz83fQoGsK%Wphg_ln`mHm zB(v6}GM=5~ef|0vm=a067*5yK*V!^jx=!bKPiT}2QX!B~pt&~J=Zxwa8gcAabn0dy z_}u;AppT&)MU+^&jr{WR5(^7Uz^o0FiiLxt`}OND{i#uDixw2oH%UqO_a)B^2Z<*| zH(~WB^Y(7=|4h399#g|ys?!S zP20aoL77CJuFlSn!J81i+w@BAN{m41vdYTgd42&&Ng5D7cAqtP!B!XxhIf|t_}C7( zDSpbz-b{>){rmfzAXAf=VzGdv8I2$c6Ca=UPwv;k>hTF!I0OspLwcV3hAw^*lK+%iS|8ldz&FJ; z1@H9>Y1ue{i zG=|P4YXgkFSSW#kap%;FQPRNxGS+pX)a=>>&;+oUffqLW7oP>+LfY~g35khO{&!(v zaB{MCd_uzZepWH>zlDV_0K?bwkA5aXNyM_y=+o!5K2U z(5D~3KC6$2q+cLwFp58y7 z`nfsn%gd|#ke?uuveGkLZ0v>egQY}1dz?bF`g-?XoLFgFNoGA%y+jUcaDYA_M;BE{ z6-pCx19NkHa`G1L4TVhd^72pAD2ms@(kez2Fr}-5LqmeqpH_P(OYwMJd=$Enmf}YS z$H#jP4SE1%YY`N`Jy{zAW^4OXRT*_}L|%Fb)HAe0l=DB4he`iZYyRWv1FTk;lE}FbH1@A2c_i zsK~N=g~>=ZWu^5eYEWqCngTnj;XZz&@4iIP)m~%D-8tbM>Fn$*nRxTw-R<7deU#Ia zSg`hoi5<;XN$@9d>D-dMQ#@vJV>@&d81J44x-={z+l`!{xF z9rtuYdeHk5+$l4Iw!V$?Mh-hP*p5jQHZex<#Qsc>$5tP+m+pEk;xUk^-)ld>X1PhT;{WR&&J6H z_u9!ytCY!l*UAfDo%84E&aj{x+{$>%yDR;O4|Js#0$!Jr9K}LL&yew~ww^R5hL_ z(A}{ooNgZ(v>aGoyBF@1b#2@Bv(zVx9%!0#B)d6rG0)EMd*0q$UY`yug>IL-5iHN= zI$F7!MUAAE+XySAO_O%a*XnHlxPP-R6Qrr;*bQmj>2y2ew496j|x|quZ{p`ut}*`=qMnIQXoxvy3(?KfyES zcqCN3&?>w#Tcr84)R#3~mAO@4d(9i_xHcc$|K4%0D{D5JN`s*8Zo5=l>ehL4EsS?_ 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 WL=#6pwTa&Yma3wrLZzJL`~L%X#kVB@ literal 0 HcmV?d00001 diff --git a/docs/images/system-information.png b/docs/images/system-information.png new file mode 100644 index 0000000000000000000000000000000000000000..08e69eaf0a9737644e1d21da19023057ab0bfa7f GIT binary patch literal 103438 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 literal 0 HcmV?d00001 diff --git a/libdragon b/libdragon index d95e9c0d..47ca3ee8 160000 --- a/libdragon +++ b/libdragon @@ -1 +1 @@ -Subproject commit d95e9c0deac9794c3d7216861a864cd6b8455a22 +Subproject commit 47ca3ee8906d01e2cf9aad1c8c3c248d635c6c13 diff --git a/src/boot/boot.h b/src/boot/boot.h index 3abd87da..08dd60d7 100644 --- a/src/boot/boot.h +++ b/src/boot/boot.h @@ -7,42 +7,43 @@ #ifndef BOOT_H__ #define BOOT_H__ - #include #include - /** @brief Boot device type enumeration */ typedef enum { - BOOT_DEVICE_TYPE_ROM = 0, - BOOT_DEVICE_TYPE_64DD = 1, + BOOT_DEVICE_TYPE_ROM = 0, /**< Boot from ROM */ + BOOT_DEVICE_TYPE_64DD = 1, /**< Boot from 64DD */ } boot_device_type_t; /** @brief Reset type enumeration */ typedef enum { - BOOT_RESET_TYPE_COLD = 0, - BOOT_RESET_TYPE_NMI = 1, + BOOT_RESET_TYPE_COLD = 0, /**< Cold reset */ + BOOT_RESET_TYPE_NMI = 1, /**< Non-maskable interrupt reset */ } boot_reset_type_t; /** @brief TV type enumeration */ typedef enum { - BOOT_TV_TYPE_PAL = 0, - BOOT_TV_TYPE_NTSC = 1, - BOOT_TV_TYPE_MPAL = 2, - BOOT_TV_TYPE_PASSTHROUGH = 3, + BOOT_TV_TYPE_PAL = 0, /**< PAL TV type */ + BOOT_TV_TYPE_NTSC = 1, /**< NTSC TV type */ + BOOT_TV_TYPE_MPAL = 2, /**< MPAL TV type */ + BOOT_TV_TYPE_PASSTHROUGH = 3, /**< Passthrough TV type */ } boot_tv_type_t; /** @brief Boot Parameters Structure */ typedef struct { - boot_device_type_t device_type; - boot_tv_type_t tv_type; - uint8_t cic_seed; - bool detect_cic_seed; - uint32_t *cheat_list; + boot_device_type_t device_type; /**< Type of boot device */ + boot_tv_type_t tv_type; /**< TV type */ + uint8_t cic_seed; /**< CIC seed */ + bool detect_cic_seed; /**< Flag to detect CIC seed */ + uint32_t *cheat_list; /**< Pointer to the cheat list */ } boot_params_t; - +/** + * @brief Boot the system with the specified parameters. + * + * @param params Pointer to the boot parameters structure. + */ void boot (boot_params_t *params); - -#endif +#endif /* BOOT_H__ */ diff --git a/src/boot/boot_io.h b/src/boot/boot_io.h index eb9f5cc6..ccda89da 100644 --- a/src/boot/boot_io.h +++ b/src/boot/boot_io.h @@ -69,7 +69,7 @@ typedef struct { io32_t DMA_BUSY; /**< DMA Busy Register. */ io32_t SEMAPHORE; /**< Semaphore Register. */ io32_t __reserved[0xFFF8]; - io32_t PC; + io32_t PC; /**< Program Counter Register. */ } sp_regs_t; /** @@ -123,16 +123,20 @@ typedef struct { #define SP_SR_CLR_SIG7 (1 << 23) #define SP_SR_SET_SIG7 (1 << 24) -/** @brief DPC Registers Structure. */ +/** + * @brief DPC Registers Structure. + * + * This structure represents the registers for the DPC (Display Processor). + */ typedef struct { - io32_t START; - io32_t END; - io32_t CURRENT; - io32_t SR; - io32_t CLOCK; - io32_t BUF_BUSY; - io32_t PIPE_BUSY; - io32_t TMEM; + io32_t START; /**< Start Register. */ + io32_t END; /**< End Register. */ + io32_t CURRENT; /**< Current Register. */ + io32_t SR; /**< Status Register. */ + io32_t CLOCK; /**< Clock Register. */ + io32_t BUF_BUSY; /**< Buffer Busy Register. */ + io32_t PIPE_BUSY; /**< Pipe Busy Register. */ + io32_t TMEM; /**< TMEM Register. */ } dpc_regs_t; #define DPC_BASE (0x04100000UL) @@ -160,36 +164,26 @@ typedef struct { #define DPC_SR_CLR_CMD_CTR (1 << 8) #define DPC_SR_CLR_CLOCK_CTR (1 << 9) -/** @brief Video Interface Registers Structure. */ +/** + * @brief Video Interface Registers Structure. + * + * This structure represents the registers for the Video Interface (VI). + */ typedef struct { - /** @brief The Control Register. */ - io32_t CR; - /** @brief The Memory Address. */ - io32_t MADDR; - /** @brief The Horizontal Width. */ - io32_t H_WIDTH; - /** @brief The Virtical Interupt. */ - io32_t V_INTR; - /** @brief The Current Line. */ - io32_t CURR_LINE; - /** @brief The Timings. */ - io32_t TIMING; - /** @brief The Virtical Sync. */ - io32_t V_SYNC; - /** @brief The Horizontal Sync. */ - io32_t H_SYNC; - /** @brief The Horizontal Sync Leap. */ - io32_t H_SYNC_LEAP; - /** @brief The Horizontal Limits. */ - io32_t H_LIMITS; - /** @brief The Virtical Limits. */ - io32_t V_LIMITS; - /** @brief The Colour Burst. */ - io32_t COLOR_BURST; - /** @brief The Horizontal Scale. */ - io32_t H_SCALE; - /** @brief The Virtical Scale. */ - io32_t V_SCALE; + io32_t CR; /**< Control Register. */ + io32_t MADDR; /**< Memory Address. */ + io32_t H_WIDTH; /**< Horizontal Width. */ + io32_t V_INTR; /**< Vertical Interrupt. */ + io32_t CURR_LINE; /**< Current Line. */ + io32_t TIMING; /**< Timings. */ + io32_t V_SYNC; /**< Vertical Sync. */ + io32_t H_SYNC; /**< Horizontal Sync. */ + io32_t H_SYNC_LEAP; /**< Horizontal Sync Leap. */ + io32_t H_LIMITS; /**< Horizontal Limits. */ + io32_t V_LIMITS; /**< Vertical Limits. */ + io32_t COLOR_BURST; /**< Color Burst. */ + io32_t H_SCALE; /**< Horizontal Scale. */ + io32_t V_SCALE; /**< Vertical Scale. */ } vi_regs_t; #define VI_BASE (0x04400000UL) @@ -211,20 +205,18 @@ typedef struct { #define VI_CURR_LINE_FIELD (1 << 0) -/** @brief Audio Interface Registers Structure. */ +/** + * @brief Audio Interface Registers Structure. + * + * This structure represents the registers for the Audio Interface (AI). + */ typedef struct { - /** @brief The Memory Address. */ - io32_t MADDR; - /** @brief The Length of bytes. */ - io32_t LEN; - /** @brief The Control Register. */ - io32_t CR; - /** @brief The Status Register. */ - io32_t SR; - /** @brief The DAC rate. */ - io32_t DACRATE; - /** @brief The bit rate. */ - io32_t BITRATE; + io32_t MADDR; /**< Memory Address. */ + io32_t LEN; /**< Length of bytes. */ + io32_t CR; /**< Control Register. */ + io32_t SR; /**< Status Register. */ + io32_t DACRATE; /**< DAC rate. */ + io32_t BITRATE; /**< Bit rate. */ } ai_regs_t; #define AI_BASE (0x04500000UL) @@ -234,29 +226,23 @@ typedef struct { #define AI_SR_FIFO_FULL (1 << 31) #define AI_CR_DMA_ON (1 << 0) -/** @brief Peripheral Interface Register Structure. */ +/** + * @brief Peripheral Interface Register Structure. + * + * This structure represents the registers for the Peripheral Interface (PI). + */ typedef struct { - /** @brief The Memory Address. */ - io32_t MADDR; - /** @brief The Cart Address. */ - io32_t PADDR; - /** @brief The Read Length. */ - io32_t RDMA; - /** @brief The Write Length. */ - io32_t WDMA; - /** @brief The Status Register. */ - io32_t SR; - /** @brief The Domain 2 Registers. */ + io32_t MADDR; /**< Memory Address. */ + io32_t PADDR; /**< Cart Address. */ + io32_t RDMA; /**< Read Length. */ + io32_t WDMA; /**< Write Length. */ + io32_t SR; /**< Status Register. */ struct { - /** @brief The Latch Value. */ - io32_t LAT; - /** @brief The Pulse Width Value. */ - io32_t PWD; - /** @brief The Page Size Value. */ - io32_t PGS; - /** @brief The Release Value. */ - io32_t RLS; - } DOM[2]; + io32_t LAT; /**< Latch Value. */ + io32_t PWD; /**< Pulse Width Value. */ + io32_t PGS; /**< Page Size Value. */ + io32_t RLS; /**< Release Value. */ + } DOM[2]; /**< Domain 2 Registers. */ } pi_regs_t; #define PI_BASE (0x04600000UL) @@ -274,12 +260,24 @@ typedef struct { #define ROM_CART_BASE (0x10000000UL) #define ROM_CART ((io32_t *) ROM_CART_BASE) +/** + * @brief Read a value from a CPU IO address. + * + * @param address The address to read from. + * @return uint32_t The value read from the address. + */ static inline uint32_t cpu_io_read (io32_t *address) { io32_t *uncached = UNCACHED(address); uint32_t value = *uncached; return value; } +/** + * @brief Write a value to a CPU IO address. + * + * @param address The address to write to. + * @param value The value to write. + */ static inline void cpu_io_write (io32_t *address, uint32_t value) { io32_t *uncached = UNCACHED(address); *uncached = value; diff --git a/src/boot/cheats.c b/src/boot/cheats.c index fd76eedc..324c21ce 100644 --- a/src/boot/cheats.c +++ b/src/boot/cheats.c @@ -1,5 +1,10 @@ -#include +/** + * @file cheats.c + * @brief Cheat Engine Implementation + * @ingroup boot + */ +#include #include "boot_io.h" #include "cheats.h" #include "vr4300_asm.h" @@ -21,22 +26,25 @@ #define ENGINE_TEMPORARY_ADDRESS (PATCHER_ADDRESS + 0x10000) #define DEFAULT_ENGINE_ADDRESS (0x807C5C00) +/** @brief Cheat structure */ typedef struct { - uint8_t type; - uint32_t address; - uint16_t value; + uint8_t type; /**< Cheat type */ + uint32_t address; /**< Cheat address */ + uint16_t value; /**< Cheat value */ } cheat_t; +/** @brief Cheat entry structure */ typedef struct { - cheat_t main; - cheat_t sub; + cheat_t main; /**< Main cheat */ + cheat_t sub; /**< Sub cheat */ } cheat_entry_t; +/** @brief Special cheat types enumeration */ typedef enum { - SPECIAL_DISABLE_EXPANSION_PAK = 0xEE, - SPECIAL_WRITE_BYTE_ON_BOOT = 0xF0, - SPECIAL_WRITE_SHORT_ON_BOOT = 0xF1, - SPECIAL_SET_STORE_LOCATION = 0xFF, + SPECIAL_DISABLE_EXPANSION_PAK = 0xEE, /**< Disable Expansion Pak */ + SPECIAL_WRITE_BYTE_ON_BOOT = 0xF0, /**< Write byte on boot */ + SPECIAL_WRITE_SHORT_ON_BOOT = 0xF1, /**< Write short on boot */ + SPECIAL_SET_STORE_LOCATION = 0xFF, /**< Set store location */ } cheat_type_special_t; #define IS_WIDTH_16(t) ((t) & (1 << 0)) @@ -49,6 +57,13 @@ typedef enum { #define IS_DOUBLE_ENTRY(t) (IS_TYPE_CONDITIONAL(t) || IS_TYPE_REPEATER(t)) +/** + * @brief Patch the IPL3 with the cheat engine. + * + * @param cic_type The CIC type. + * @param target The target address. + * @return true if successful, false otherwise. + */ static bool cheats_patch_ipl3 (cic_type_t cic_type, io32_t *target) { uint32_t patch_offset = 0; uint32_t j_instruction = I_J((uint32_t)(target)); @@ -92,6 +107,13 @@ static bool cheats_patch_ipl3 (cic_type_t cic_type, io32_t *target) { return false; } +/** + * @brief Get the next cheat entry from the cheat list. + * + * @param cheat_list Pointer to the cheat list. + * @param cheat Pointer to the cheat entry structure. + * @return true if successful, false otherwise. + */ static bool cheats_get_next (uint32_t **cheat_list, cheat_entry_t *cheat) { cheat_t *c = &cheat->main; cheat->sub.type = 0; @@ -119,6 +141,12 @@ static bool cheats_get_next (uint32_t **cheat_list, cheat_entry_t *cheat) { return true; } +/** + * @brief Get the engine address from the cheat list. + * + * @param cheat_list Pointer to the cheat list. + * @return io32_t* The engine address. + */ static io32_t *cheats_get_engine_address (uint32_t *cheat_list) { cheat_entry_t cheat; while (cheats_get_next(&cheat_list, &cheat)) { @@ -129,11 +157,24 @@ static io32_t *cheats_get_engine_address (uint32_t *cheat_list) { return (io32_t *)(DEFAULT_ENGINE_ADDRESS); } +/** + * @brief Update the cache for the specified memory range. + * + * @param start The start address. + * @param end The end address. + */ static void cheats_update_cache (volatile void *start, volatile void *end) { data_cache_hit_writeback(start, (end - start)); inst_cache_hit_invalidate(start, (end - start)); } +/** + * @brief Install the cheat engine. + * + * @param cic_type The CIC type. + * @param cheat_list Pointer to the cheat list. + * @return true if successful, false otherwise. + */ bool cheats_install (cic_type_t cic_type, uint32_t *cheat_list) { if (!cheat_list) { return false; @@ -165,7 +206,7 @@ bool cheats_install (cic_type_t cic_type, uint32_t *cheat_list) { *engine_p++ = I_BNEL(REG_K1, REG_ZERO, 1); *engine_p++ = I_MTC0(REG_ZERO, C0_REG_WATCH_LO); - // Check if watch exception ocurred, if yes then proceed to relocate the game exception handler + // Check if watch exception occurred, if yes then proceed to relocate the game exception handler *engine_p++ = I_ANDI(REG_K0, REG_K0, CAUSE_EXC_CODE_MASK); *engine_p++ = I_ORI(REG_K1, REG_ZERO, CAUSE_EXC_CODE_WATCH); *engine_p++ = I_BNE(REG_K0, REG_K1, 15); // Skips to after the 'eret' instruction diff --git a/src/boot/cheats.h b/src/boot/cheats.h index 53cbbe5e..8b2d13a6 100644 --- a/src/boot/cheats.h +++ b/src/boot/cheats.h @@ -1,10 +1,25 @@ +/** + * @file cheats.h + * @brief Header file for cheat installation functions. + * @ingroup boot + */ + #ifndef CHEATS_H__ #define CHEATS_H__ #include - #include "cic.h" -bool cheats_install (cic_type_t cic_type, uint32_t *cheat_list); +/** + * @brief Installs cheats based on the CIC type. + * + * This function installs the cheats provided in the cheat list based on the + * specified CIC type. + * + * @param cic_type The type of CIC (Copy Protection Chip) used. + * @param cheat_list A pointer to an array of cheats to be installed. + * @return true if the cheats were successfully installed, false otherwise. + */ +bool cheats_install(cic_type_t cic_type, uint32_t *cheat_list); -#endif +#endif // CHEATS_H__ diff --git a/src/boot/cic.c b/src/boot/cic.c index 990e95ca..ef1fef3a 100644 --- a/src/boot/cic.c +++ b/src/boot/cic.c @@ -1,39 +1,101 @@ +/** + * @file cic.c + * @brief CIC (Copy Protection) functions implementation + * @ingroup boot + */ + #include "cic.h" - +/** + * @brief Get a 32-bit value from a byte array at the specified index. + * + * @param p Pointer to the byte array. + * @param index Index to get the value from. + * @return uint32_t The 32-bit value. + */ static inline uint32_t _get (uint8_t *p, int index) { int i = index * 4; return (p[i] << 24 | p[i + 1] << 16 | p[i + 2] << 8 | p[i + 3]); } +/** + * @brief Add two 32-bit values. + * + * @param a1 First value. + * @param a2 Second value. + * @return uint32_t The result of the addition. + */ static inline uint32_t _add (uint32_t a1, uint32_t a2) { return a1 + a2; } +/** + * @brief Subtract one 32-bit value from another. + * + * @param a1 First value. + * @param a2 Second value. + * @return uint32_t The result of the subtraction. + */ static inline uint32_t _sub (uint32_t a1, uint32_t a2) { return a1 - a2; } +/** + * @brief Multiply two 32-bit values. + * + * @param a1 First value. + * @param a2 Second value. + * @return uint32_t The result of the multiplication. + */ static inline uint32_t _mul (uint32_t a1, uint32_t a2) { return a1 * a2; } +/** + * @brief Rotate a 32-bit value left by a specified number of bits. + * + * @param a The value to rotate. + * @param s The number of bits to rotate. + * @return uint32_t The result of the rotation. + */ static inline uint32_t _rol (uint32_t a, uint32_t s) { return ((a) << (s)) | ((a) >> (-(s) & 31)); } +/** + * @brief Rotate a 32-bit value right by a specified number of bits. + * + * @param a The value to rotate. + * @param s The number of bits to rotate. + * @return uint32_t The result of the rotation. + */ static inline uint32_t _ror (uint32_t a, uint32_t s) { return ((a) >> (s)) | ((a) << (-(s) & 31)); } +/** + * @brief Calculate the sum of three 32-bit values. + * + * @param a0 First value. + * @param a1 Second value. + * @param a2 Third value. + * @return uint32_t The result of the sum. + */ static uint32_t _sum (uint32_t a0, uint32_t a1, uint32_t a2) { uint64_t prod = ((uint64_t) (a0)) * (a1 == 0 ? a2 : a1); uint32_t hi = (prod >> 32) & 0xFFFFFFFF; uint32_t lo = prod & 0xFFFFFFFF; uint32_t diff = hi - lo; return (diff == 0) ? a0 : diff; -}; +} +/** + * @brief Calculate the IPL3 checksum for the CIC. + * + * @param ipl3 Pointer to the IPL3 data. + * @param seed The seed value. + * @return uint64_t The calculated checksum. + */ static uint64_t cic_calculate_ipl3_checksum (uint8_t *ipl3, uint8_t seed) { const uint32_t MAGIC = 0x6C078965; @@ -97,7 +159,12 @@ static uint64_t cic_calculate_ipl3_checksum (uint8_t *ipl3, uint8_t seed) { return checksum; } - +/** + * @brief Detect the CIC type based on the IPL3 data. + * + * @param ipl3 Pointer to the IPL3 data. + * @return cic_type_t The detected CIC type. + */ cic_type_t cic_detect (uint8_t *ipl3) { switch (cic_calculate_ipl3_checksum(ipl3, 0x3F)) { case 0x45CC73EE317AULL: return CIC_6101; // 6101 @@ -127,6 +194,12 @@ cic_type_t cic_detect (uint8_t *ipl3) { return CIC_UNKNOWN; } +/** + * @brief Get the seed value for the specified CIC type. + * + * @param cic_type The CIC type. + * @return uint8_t The seed value. + */ uint8_t cic_get_seed (cic_type_t cic_type) { switch (cic_type) { case CIC_5101: return 0xAC; diff --git a/src/boot/cic.h b/src/boot/cic.h index 3de811bb..130ac8c3 100644 --- a/src/boot/cic.h +++ b/src/boot/cic.h @@ -1,33 +1,55 @@ +/** + * @file cic.h + * @brief Header file for CIC (Copy Protection Chip) related functions and definitions. + * @ingroup boot + */ + #ifndef CIC_H__ #define CIC_H__ - #include - #define IPL3_LENGTH (4032) - +/** + * @enum cic_type_t + * @brief Enumeration of different CIC types. + */ typedef enum { - CIC_5101, - CIC_5167, - CIC_6101, - CIC_7102, - CIC_x102, - CIC_x103, - CIC_x105, - CIC_x106, - CIC_8301, - CIC_8302, - CIC_8303, - CIC_8401, - CIC_8501, - CIC_UNKNOWN, + CIC_5101, /**< CIC type 5101 */ + CIC_5167, /**< CIC type 5167 */ + CIC_6101, /**< CIC type 6101 */ + CIC_7102, /**< CIC type 7102 */ + CIC_x102, /**< CIC type x102 */ + CIC_x103, /**< CIC type x103 */ + CIC_x105, /**< CIC type x105 */ + CIC_x106, /**< CIC type x106 */ + CIC_8301, /**< CIC type 8301 */ + CIC_8302, /**< CIC type 8302 */ + CIC_8303, /**< CIC type 8303 */ + CIC_8401, /**< CIC type 8401 */ + CIC_8501, /**< CIC type 8501 */ + CIC_UNKNOWN /**< Unknown CIC type */ } cic_type_t; +/** + * @brief Detects the CIC type based on the provided IPL3 data. + * + * This function analyzes the provided IPL3 data to determine the CIC type. + * + * @param ipl3 A pointer to the IPL3 data. + * @return The detected CIC type. + */ +cic_type_t cic_detect(uint8_t *ipl3); -cic_type_t cic_detect (uint8_t *ipl3); -uint8_t cic_get_seed (cic_type_t cic_type); +/** + * @brief Gets the seed value for the specified CIC type. + * + * This function returns the seed value associated with the given CIC type. + * + * @param cic_type The type of CIC. + * @return The seed value for the specified CIC type. + */ +uint8_t cic_get_seed(cic_type_t cic_type); - -#endif +#endif // CIC_H__ diff --git a/src/boot/reboot.h b/src/boot/reboot.h index d8ec302b..ff4272c3 100644 --- a/src/boot/reboot.h +++ b/src/boot/reboot.h @@ -1,17 +1,31 @@ +/** + * @file reboot.h + * @brief Header file for reboot-related definitions. + * @ingroup boot + */ + #ifndef REBOOT_H__ #define REBOOT_H__ - #ifndef __ASSEMBLER__ #include #include - +/** + * @brief Start address of the reboot code. + * + * This variable marks the start address of the reboot code section. + */ extern uint32_t reboot_start __attribute__((section(".text"))); + +/** + * @brief Size of the reboot code. + * + * This variable holds the size of the reboot code section. + */ extern size_t reboot_size __attribute__((section(".text"))); -#endif +#endif // __ASSEMBLER__ - -#endif +#endif // REBOOT_H__ diff --git a/src/boot/vr4300_asm.h b/src/boot/vr4300_asm.h index b2736e21..d3c0494c 100644 --- a/src/boot/vr4300_asm.h +++ b/src/boot/vr4300_asm.h @@ -1,3 +1,9 @@ +/** + * @file vr4300_asm.h + * @brief Header file for v4300 CPU-related definitions. + * @ingroup boot + */ + #ifndef VR4300_ASM_H__ #define VR4300_ASM_H__ diff --git a/src/flashcart/64drive/64drive.c b/src/flashcart/64drive/64drive.c index 98e28fc1..91787d39 100644 --- a/src/flashcart/64drive/64drive.c +++ b/src/flashcart/64drive/64drive.c @@ -1,3 +1,9 @@ +/** + * @file 64drive.c + * @brief 64drive functions implementation + * @ingroup flashcart + */ + #include #include #include @@ -12,7 +18,6 @@ #include "64drive_ll.h" #include "64drive.h" - #define ROM_ADDRESS (0x10000000) #define SAVE_ADDRESS_DEV_A (0x13FE0000) #define SAVE_ADDRESS_DEV_A_PKST2 (0x11606560) @@ -20,11 +25,14 @@ #define SUPPORTED_FPGA_REVISION (205) - static d64_device_variant_t device_variant = DEVICE_VARIANT_UNKNOWN; static d64_save_type_t current_save_type = SAVE_TYPE_NONE; - +/** + * @brief Initialize the 64drive. + * + * @return flashcart_err_t Error code. + */ static flashcart_err_t d64_init (void) { uint16_t fpga_revision; uint32_t bootloader_version; @@ -62,6 +70,11 @@ static flashcart_err_t d64_init (void) { return FLASHCART_OK; } +/** + * @brief Deinitialize the 64drive. + * + * @return flashcart_err_t Error code. + */ static flashcart_err_t d64_deinit (void) { if (d64_ll_enable_cartrom_writes(false)) { return FLASHCART_ERR_INT; @@ -70,6 +83,12 @@ static flashcart_err_t d64_deinit (void) { return FLASHCART_OK; } +/** + * @brief Check if the 64drive has a specific feature. + * + * @param feature The feature to check. + * @return true if the feature is supported, false otherwise. + */ static bool d64_has_feature (flashcart_features_t feature) { switch (feature) { case FLASHCART_FEATURE_64DD: return false; @@ -78,6 +97,7 @@ static bool d64_has_feature (flashcart_features_t feature) { case FLASHCART_FEATURE_AUTO_CIC: return true; case FLASHCART_FEATURE_AUTO_REGION: return true; case FLASHCART_FEATURE_SAVE_WRITEBACK: return true; + case FLASHCART_FEATURE_ROM_REBOOT_FAST: return true; default: return false; } } @@ -107,6 +127,13 @@ static flashcart_firmware_version_t d64_get_firmware_version (void) { return version_info; } +/** + * @brief Load a ROM into the 64drive. + * + * @param rom_path Path to the ROM file. + * @param progress Progress callback function. + * @return flashcart_err_t Error code. + */ static flashcart_err_t d64_load_rom (char *rom_path, flashcart_progress_callback_t *progress) { FIL fil; UINT br; @@ -149,6 +176,14 @@ static flashcart_err_t d64_load_rom (char *rom_path, flashcart_progress_callback return FLASHCART_OK; } +/** + * @brief Load a file into the 64Drive. + * + * @param file_path Path to the file. + * @param rom_offset ROM offset. + * @param file_offset File offset. + * @return flashcart_err_t Error code. + */ static flashcart_err_t d64_load_file (char *file_path, uint32_t rom_offset, uint32_t file_offset) { FIL fil; UINT br; @@ -187,6 +222,12 @@ static flashcart_err_t d64_load_file (char *file_path, uint32_t rom_offset, uint return FLASHCART_OK; } +/** + * @brief Load a save file into the 64drive. + * + * @param save_path Path to the save file. + * @return flashcart_err_t Error code. + */ static flashcart_err_t d64_load_save (char *save_path) { uint8_t eeprom_contents[2048] __attribute__((aligned(8))); FIL fil; @@ -233,6 +274,12 @@ static flashcart_err_t d64_load_save (char *save_path) { return FLASHCART_OK; } +/** + * @brief Set the save type for the 64drive. + * + * @param save_type The save type. + * @return flashcart_err_t Error code. + */ static flashcart_err_t d64_set_save_type (flashcart_save_type_t save_type) { d64_save_type_t type; @@ -279,6 +326,12 @@ static flashcart_err_t d64_set_save_type (flashcart_save_type_t save_type) { return FLASHCART_OK; } +/** + * @brief Set the save writeback for the 64drive. + * + * @param save_path Path to the save file. + * @return flashcart_err_t Error code. + */ static flashcart_err_t d64_set_save_writeback (char *save_path) { uint32_t sectors[SAVE_WRITEBACK_MAX_SECTORS] __attribute__((aligned(8))); @@ -297,7 +350,17 @@ static flashcart_err_t d64_set_save_writeback (char *save_path) { return FLASHCART_OK; } +// static flashcart_err_t d64_set_bootmode (flashcart_reboot_mode_t boot_mode) { +// if (d64_ll_set_persistent_variable_storage(true, 0, 0)) { +// return FLASHCART_ERR_INT; +// } + +// return FLASHCART_OK; +// } + + +/** @brief Flashcart structure for 64drive. */ static flashcart_t flashcart_d64 = { .init = d64_init, .deinit = d64_deinit, @@ -310,9 +373,14 @@ static flashcart_t flashcart_d64 = { .load_64dd_disk = NULL, .set_save_type = d64_set_save_type, .set_save_writeback = d64_set_save_writeback, + .set_next_boot_mode = NULL, // d64_set_bootmode, }; - +/** + * @brief Get the flashcart structure for 64drive. + * + * @return flashcart_t* Pointer to the flashcart structure. + */ flashcart_t *d64_get_flashcart (void) { return &flashcart_d64; } diff --git a/src/flashcart/64drive/64drive_ll.c b/src/flashcart/64drive/64drive_ll.c index d0a02ce0..b0c9ecb7 100644 --- a/src/flashcart/64drive/64drive_ll.c +++ b/src/flashcart/64drive/64drive_ll.c @@ -1,15 +1,22 @@ +/** + * @file 64drive_ll.c + * @brief Low-level functions for 64drive + * @ingroup flashcart + */ + #include #include "../flashcart_utils.h" #include "64drive_ll.h" - #define CI_STATUS_BUSY (1 << 12) #define D64_DEVICE_VARIANT_MASK (0xFFFF) #define D64_FPGA_REVISION_MASK (0xFFFF) - +/** + * @brief Command IDs for 64drive. + */ typedef enum { CMD_ID_SET_SAVE_TYPE = 0xD0, CMD_ID_DISABLE_SAVE_WRITEBACK = 0xD1, @@ -22,10 +29,13 @@ typedef enum { CMD_ID_DISABLE_EXTENDED_MODE = 0xF9, } d64_ci_cmd_id_t; - static d64_regs_t *d64_regs = D64_REGS; - +/** + * @brief Wait for the CI (Command Interface) to become idle. + * + * @return true if a timeout occurred, false otherwise. + */ static bool d64_ll_ci_wait (void) { int timeout = 0; do { @@ -36,12 +46,25 @@ static bool d64_ll_ci_wait (void) { return false; } +/** + * @brief Send a command to the CI (Command Interface). + * + * @param id The command ID. + * @return true if a timeout occurred, false otherwise. + */ static bool d64_ll_ci_cmd (d64_ci_cmd_id_t id) { io_write((uint32_t) (&d64_regs->COMMAND), id); return d64_ll_ci_wait(); } - +/** + * @brief Get the version information of the 64drive. + * + * @param device_variant Pointer to store the device variant. + * @param fpga_revision Pointer to store the FPGA revision. + * @param bootloader_version Pointer to store the bootloader version. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_get_version (d64_device_variant_t *device_variant, uint16_t *fpga_revision, uint32_t *bootloader_version) { if (d64_ll_ci_wait()) { return true; @@ -52,6 +75,14 @@ bool d64_ll_get_version (d64_device_variant_t *device_variant, uint16_t *fpga_re return d64_ll_ci_wait(); } +/** + * @brief Set the persistent variable storage on the 64drive. + * + * @param quick_reboot Flag indicating whether to enable quick reboot. + * @param force_tv_type The TV type to force. + * @param cic_seed The CIC seed value. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_set_persistent_variable_storage (bool quick_reboot, d64_tv_type_t force_tv_type, uint8_t cic_seed) { if (d64_ll_ci_wait()) { return true; @@ -60,6 +91,12 @@ bool d64_ll_set_persistent_variable_storage (bool quick_reboot, d64_tv_type_t fo return d64_ll_ci_wait(); } +/** + * @brief Set the save type on the 64drive. + * + * @param save_type The save type. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_set_save_type (d64_save_type_t save_type) { if (d64_ll_ci_wait()) { return true; @@ -68,6 +105,12 @@ bool d64_ll_set_save_type (d64_save_type_t save_type) { return d64_ll_ci_cmd(CMD_ID_SET_SAVE_TYPE); } +/** + * @brief Enable or disable save writeback on the 64drive. + * + * @param enabled Flag indicating whether to enable save writeback. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_enable_save_writeback (bool enabled) { if (d64_ll_ci_wait()) { return true; @@ -75,6 +118,12 @@ bool d64_ll_enable_save_writeback (bool enabled) { return d64_ll_ci_cmd(enabled ? CMD_ID_ENABLE_SAVE_WRITEBACK : CMD_ID_DISABLE_SAVE_WRITEBACK); } +/** + * @brief Enable or disable cart ROM writes on the 64drive. + * + * @param enabled Flag indicating whether to enable cart ROM writes. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_enable_cartrom_writes (bool enabled) { if (d64_ll_ci_wait()) { return true; @@ -82,6 +131,12 @@ bool d64_ll_enable_cartrom_writes (bool enabled) { return d64_ll_ci_cmd(enabled ? CMD_ID_ENABLE_CARTROM_WRITES : CMD_ID_DISABLE_CARTROM_WRITES); } +/** + * @brief Enable or disable extended mode on the 64drive. + * + * @param enabled Flag indicating whether to enable extended mode. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_enable_extended_mode (bool enabled) { d64_ll_ci_wait(); if (enabled) { @@ -93,6 +148,12 @@ bool d64_ll_enable_extended_mode (bool enabled) { return d64_ll_ci_wait(); } +/** + * @brief Write EEPROM contents to the 64drive. + * + * @param contents Pointer to the EEPROM contents. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_write_eeprom_contents (void *contents) { if (d64_ll_ci_wait()) { return true; @@ -101,6 +162,12 @@ bool d64_ll_write_eeprom_contents (void *contents) { return d64_ll_ci_wait(); } +/** + * @brief Write the save writeback LBA list to the 64drive. + * + * @param list Pointer to the LBA list. + * @return true if a timeout occurred, false otherwise. + */ bool d64_ll_write_save_writeback_lba_list (void *list) { if (d64_ll_ci_wait()) { return true; diff --git a/src/flashcart/64drive/64drive_ll.h b/src/flashcart/64drive/64drive_ll.h index 696b028a..55a03ca0 100644 --- a/src/flashcart/64drive/64drive_ll.h +++ b/src/flashcart/64drive/64drive_ll.h @@ -7,11 +7,9 @@ #ifndef FLASHCART_64DRIVE_LL_H__ #define FLASHCART_64DRIVE_LL_H__ - #include #include - /** * @addtogroup 64drive * @{ @@ -19,40 +17,40 @@ /** @brief Registers Structure. */ typedef struct { - uint8_t BUFFER[512]; - uint32_t STATUS; - uint32_t __unused_1; - uint32_t COMMAND; - uint32_t __unused_2; - uint32_t LBA; - uint32_t __unused_3; - uint32_t LENGTH; - uint32_t __unused_4; - uint32_t RESULT; + uint8_t BUFFER[512]; /**< General buffer */ + uint32_t STATUS; /**< Status register */ + uint32_t __unused_1; /**< Unused */ + uint32_t COMMAND; /**< Command register */ + uint32_t __unused_2; /**< Unused */ + uint32_t LBA; /**< Logical Block Address register */ + uint32_t __unused_3; /**< Unused */ + uint32_t LENGTH; /**< Length register */ + uint32_t __unused_4; /**< Unused */ + uint32_t RESULT; /**< Result register */ - uint32_t __unused_5[49]; + uint32_t __unused_5[49]; /**< Unused */ - uint32_t SDRAM_SIZE; - uint32_t MAGIC; - uint32_t VARIANT; - uint32_t PERSISTENT; - uint32_t BUTTON_UPGRADE; - uint32_t REVISION; + uint32_t SDRAM_SIZE; /**< SDRAM size register */ + uint32_t MAGIC; /**< Magic register */ + uint32_t VARIANT; /**< Variant register */ + uint32_t PERSISTENT; /**< Persistent register */ + uint32_t BUTTON_UPGRADE; /**< Button upgrade register */ + uint32_t REVISION; /**< Revision register */ - uint32_t __unused_6[64]; + uint32_t __unused_6[64]; /**< Unused */ - uint32_t USB_COMMAND_STATUS; - uint32_t USB_PARAM_RESULT[2]; + uint32_t USB_COMMAND_STATUS; /**< USB command status register */ + uint32_t USB_PARAM_RESULT[2]; /**< USB parameter result registers */ - uint32_t __unused_7[5]; + uint32_t __unused_7[5]; /**< Unused */ - uint32_t WIFI_COMMAND_STATUS; - uint32_t WIFI_PARAM_RESULT[2]; + uint32_t WIFI_COMMAND_STATUS; /**< WiFi command status register */ + uint32_t WIFI_PARAM_RESULT[2]; /**< WiFi parameter result registers */ - uint32_t __unused_8[757]; + uint32_t __unused_8[757]; /**< Unused */ - uint8_t EEPROM[2048]; - uint32_t WRITEBACK[256]; + uint8_t EEPROM[2048]; /**< EEPROM buffer */ + uint32_t WRITEBACK[256]; /**< Writeback buffer */ } d64_regs_t; /** @brief Registers Base Address. */ @@ -63,41 +61,98 @@ typedef struct { /** @brief Device Variant Enumeration. */ typedef enum { - DEVICE_VARIANT_UNKNOWN = 0x0000, - DEVICE_VARIANT_A = 0x4100, - DEVICE_VARIANT_B = 0x4200, + DEVICE_VARIANT_UNKNOWN = 0x0000, /**< Unknown device variant */ + DEVICE_VARIANT_A = 0x4100, /**< Device variant A */ + DEVICE_VARIANT_B = 0x4200, /**< Device variant B */ } d64_device_variant_t; /** @brief TV Type Enumeration. */ typedef enum { - TV_TYPE_PAL = 0, - TV_TYPE_NTSC = 1, - TV_TYPE_MPAL = 2, - TV_TYPE_UNKNOWN = 3, + TV_TYPE_PAL = 0, /**< PAL TV type */ + TV_TYPE_NTSC = 1, /**< NTSC TV type */ + TV_TYPE_MPAL = 2, /**< MPAL TV type */ + TV_TYPE_UNKNOWN = 3, /**< Unknown TV type */ } d64_tv_type_t; /** @brief Save Type Enumeration. */ typedef enum { - SAVE_TYPE_NONE, - SAVE_TYPE_EEPROM_4KBIT, - SAVE_TYPE_EEPROM_16KBIT, - SAVE_TYPE_SRAM_256KBIT, - SAVE_TYPE_FLASHRAM_1MBIT, - SAVE_TYPE_SRAM_BANKED, - SAVE_TYPE_FLASHRAM_PKST2, + SAVE_TYPE_NONE, /**< No save type */ + SAVE_TYPE_EEPROM_4KBIT, /**< EEPROM 4Kbit */ + SAVE_TYPE_EEPROM_16KBIT, /**< EEPROM 16Kbit */ + SAVE_TYPE_SRAM_256KBIT, /**< SRAM 256Kbit */ + SAVE_TYPE_FLASHRAM_1MBIT, /**< FlashRAM 1Mbit */ + SAVE_TYPE_SRAM_BANKED, /**< SRAM Banked */ + SAVE_TYPE_FLASHRAM_PKST2, /**< FlashRAM PKST2 */ } d64_save_type_t; +/** + * @brief Get the 64drive version. + * + * @param device_variant Pointer to store the device variant. + * @param fpga_revision Pointer to store the FPGA revision. + * @param bootloader_version Pointer to store the bootloader version. + * @return true if successful, false otherwise. + */ +bool d64_ll_get_version(d64_device_variant_t *device_variant, uint16_t *fpga_revision, uint32_t *bootloader_version); -bool d64_ll_get_version (d64_device_variant_t *device_variant, uint16_t *fpga_revision, uint32_t *bootloader_version); -bool d64_ll_set_persistent_variable_storage (bool quick_reboot, d64_tv_type_t force_tv_type, uint8_t cic_seed); -bool d64_ll_set_save_type (d64_save_type_t save_type); -bool d64_ll_enable_save_writeback (bool enabled); -bool d64_ll_enable_cartrom_writes (bool enabled); -bool d64_ll_enable_extended_mode (bool enabled); -bool d64_ll_write_eeprom_contents (void *contents); -bool d64_ll_write_save_writeback_lba_list (void *list); +/** + * @brief Set the persistent variable storage. + * + * @param quick_reboot Enable or disable quick reboot. + * @param force_tv_type TV type to force. + * @param cic_seed CIC seed value. + * @return true if successful, false otherwise. + */ +bool d64_ll_set_persistent_variable_storage(bool quick_reboot, d64_tv_type_t force_tv_type, uint8_t cic_seed); + +/** + * @brief Set the save type. + * + * @param save_type The save type to set. + * @return true if successful, false otherwise. + */ +bool d64_ll_set_save_type(d64_save_type_t save_type); + +/** + * @brief Enable or disable save writeback. + * + * @param enabled True to enable, false to disable. + * @return true if successful, false otherwise. + */ +bool d64_ll_enable_save_writeback(bool enabled); + +/** + * @brief Enable or disable cart ROM writes. + * + * @param enabled True to enable, false to disable. + * @return true if successful, false otherwise. + */ +bool d64_ll_enable_cartrom_writes(bool enabled); + +/** + * @brief Enable or disable extended mode. + * + * @param enabled True to enable, false to disable. + * @return true if successful, false otherwise. + */ +bool d64_ll_enable_extended_mode(bool enabled); + +/** + * @brief Write EEPROM contents. + * + * @param contents Pointer to the EEPROM contents. + * @return true if successful, false otherwise. + */ +bool d64_ll_write_eeprom_contents(void *contents); + +/** + * @brief Write save writeback LBA list. + * + * @param list Pointer to the LBA list. + * @return true if successful, false otherwise. + */ +bool d64_ll_write_save_writeback_lba_list(void *list); /** @} */ /* 64drive */ - -#endif +#endif /* FLASHCART_64DRIVE_LL_H__ */ diff --git a/src/flashcart/64drive/README.md b/src/flashcart/64drive/README.md index 6c6859c0..6809afcc 100644 --- a/src/flashcart/64drive/README.md +++ b/src/flashcart/64drive/README.md @@ -1,4 +1,4 @@ -# 64drive developer notes +## 64drive developer notes ### Official documentation diff --git a/src/flashcart/ed64/ed64_vseries.c b/src/flashcart/ed64/ed64_vseries.c index 02ec3f76..ea07b5d1 100644 --- a/src/flashcart/ed64/ed64_vseries.c +++ b/src/flashcart/ed64/ed64_vseries.c @@ -9,6 +9,7 @@ #include "utils/utils.h" #include "../flashcart_utils.h" +#include "ed64_vseries_ll.h" #include "ed64_vseries.h" typedef enum { @@ -23,6 +24,18 @@ typedef enum { /* ED64 ROM location base address */ #define ROM_ADDRESS (0xB0000000) +static flashcart_firmware_version_t ed64_vseries_get_firmware_version (void) { + flashcart_firmware_version_t version_info; + // FIXME: get version from ll + version_info.major = 1; + version_info.minor = 1; + version_info.revision = 0; + + //ed64_ll_get_version(&version_info.major, &version_info.minor, &version_info.revision); + + return version_info; +} + static flashcart_err_t ed64_vseries_init (void) { return FLASHCART_OK; } @@ -140,7 +153,7 @@ static flashcart_t flashcart_ed64_vseries = { .init = ed64_vseries_init, .deinit = ed64_vseries_deinit, .has_feature = ed64_vseries_has_feature, - .get_firmware_version = NULL, // FIXME: show the returned firmware version info. + .get_firmware_version = ed64_vseries_get_firmware_version, .load_rom = ed64_vseries_load_rom, .load_file = ed64_vseries_load_file, .load_save = ed64_vseries_load_save, @@ -148,6 +161,7 @@ static flashcart_t flashcart_ed64_vseries = { .load_64dd_disk = NULL, .set_save_type = ed64_vseries_set_save_type, .set_save_writeback = NULL, + .set_next_boot_mode = NULL, }; diff --git a/src/flashcart/ed64/ed64_vseries_ll.h b/src/flashcart/ed64/ed64_vseries_ll.h new file mode 100644 index 00000000..34614bf8 --- /dev/null +++ b/src/flashcart/ed64/ed64_vseries_ll.h @@ -0,0 +1,14 @@ +/** + * @file ed64_vseries_ll.h + * @brief ed64v flashcart low level access + * @ingroup flashcart + */ + +#ifndef FLASHCART_ED64_VSERIES_LL_H__ +#define FLASHCART_ED64_VSERIES_LL_H__ + + +/** @} */ /* ed64_vseries_ll */ + + +#endif diff --git a/src/flashcart/ed64/ed64_xseries.c b/src/flashcart/ed64/ed64_xseries.c new file mode 100644 index 00000000..da2bee4d --- /dev/null +++ b/src/flashcart/ed64/ed64_xseries.c @@ -0,0 +1,174 @@ +#include +#include +#include + +#include +#include + +#include "utils/fs.h" +#include "utils/utils.h" + +#include "../flashcart_utils.h" +#include "ed64_xseries_ll.h" +#include "ed64_xseries.h" + +typedef enum { + // potentially handle if the firmware supports it... + ED64_X5_0 = 550, + ED64_X7_0 = 570, + ED64_UKNOWN = 0, +} ed64_xseries_device_variant_t; + +/* ED64 save location base address */ +#define SRAM_ADDRESS (0xA8000000) +/* ED64 ROM location base address */ +#define ROM_ADDRESS (0xB0000000) + +static flashcart_firmware_version_t ed64_xseries_get_firmware_version (void) { + flashcart_firmware_version_t version_info; + // FIXME: get version from ll + version_info.major = 1; + version_info.minor = 1; + version_info.revision = 0; + + //ed64_ll_get_version(&version_info.major, &version_info.minor, &version_info.revision); + + return version_info; +} + +static flashcart_err_t ed64_xseries_init (void) { + + return FLASHCART_OK; +} + +static flashcart_err_t ed64_xseries_deinit (void) { + + return FLASHCART_OK; +} + +static ed64_xseries_device_variant_t get_cart_model() { + ed64_xseries_device_variant_t variant = ED64_X7_0; // FIXME: check cart model from ll for better feature handling. + return variant; +} + +static bool ed64_xseries_has_feature (flashcart_features_t feature) { + bool is_model_x7 = (get_cart_model() == ED64_X7_0); + switch (feature) { + case FLASHCART_FEATURE_RTC: return is_model_x7 ? true : false; + case FLASHCART_FEATURE_USB: return is_model_x7 ? true : false; + case FLASHCART_FEATURE_64DD: return false; + case FLASHCART_FEATURE_AUTO_CIC: return true; + case FLASHCART_FEATURE_AUTO_REGION: return true; + default: return false; + } +} + +static flashcart_err_t ed64_xseries_load_rom (char *rom_path, flashcart_progress_callback_t *progress) { + FIL fil; + UINT br; + + if (f_open(&fil, strip_fs_prefix(rom_path), FA_READ) != FR_OK) { + return FLASHCART_ERR_LOAD; + } + + fatfs_fix_file_size(&fil); + + size_t rom_size = f_size(&fil); + + if (rom_size > MiB(64)) { + f_close(&fil); + return FLASHCART_ERR_LOAD; + } + + size_t sdram_size = MiB(64); + + size_t chunk_size = KiB(128); + for (int offset = 0; offset < sdram_size; offset += chunk_size) { + size_t block_size = MIN(sdram_size - offset, chunk_size); + if (f_read(&fil, (void *) (ROM_ADDRESS + offset), block_size, &br) != FR_OK) { + f_close(&fil); + return FLASHCART_ERR_LOAD; + } + if (progress) { + progress(f_tell(&fil) / (float) (f_size(&fil))); + } + } + if (f_tell(&fil) != rom_size) { + f_close(&fil); + return FLASHCART_ERR_LOAD; + } + + if (f_close(&fil) != FR_OK) { + return FLASHCART_ERR_LOAD; + } + + return FLASHCART_OK; +} + +static flashcart_err_t ed64_xseries_load_file (char *file_path, uint32_t rom_offset, uint32_t file_offset) { + FIL fil; + UINT br; + + if (f_open(&fil, strip_fs_prefix(file_path), FA_READ) != FR_OK) { + return FLASHCART_ERR_LOAD; + } + + fatfs_fix_file_size(&fil); + + size_t file_size = f_size(&fil) - file_offset; + + if (file_size > (MiB(64) - rom_offset)) { + f_close(&fil); + return FLASHCART_ERR_ARGS; + } + + if (f_lseek(&fil, file_offset) != FR_OK) { + f_close(&fil); + return FLASHCART_ERR_LOAD; + } + + if (f_read(&fil, (void *) (ROM_ADDRESS + rom_offset), file_size, &br) != FR_OK) { + f_close(&fil); + return FLASHCART_ERR_LOAD; + } + if (br != file_size) { + f_close(&fil); + return FLASHCART_ERR_LOAD; + } + + if (f_close(&fil) != FR_OK) { + return FLASHCART_ERR_LOAD; + } + + return FLASHCART_OK; +} + +static flashcart_err_t ed64_xseries_load_save (char *save_path) { + // FIXME: the savetype will be none. + return FLASHCART_OK; +} + +static flashcart_err_t ed64_xseries_set_save_type (flashcart_save_type_t save_type) { + // FIXME: the savetype will be none. + return FLASHCART_OK; +} + +static flashcart_t flashcart_ed64_xseries = { + .init = ed64_xseries_init, + .deinit = ed64_xseries_deinit, + .has_feature = ed64_xseries_has_feature, + .get_firmware_version = ed64_xseries_get_firmware_version, + .load_rom = ed64_xseries_load_rom, + .load_file = ed64_xseries_load_file, + .load_save = ed64_xseries_load_save, + .load_64dd_ipl = NULL, + .load_64dd_disk = NULL, + .set_save_type = ed64_xseries_set_save_type, + .set_save_writeback = NULL, + .set_next_boot_mode = NULL, +}; + + +flashcart_t *ed64_xseries_get_flashcart (void) { + return &flashcart_ed64_xseries; +} diff --git a/src/flashcart/ed64/ed64_xseries.h b/src/flashcart/ed64/ed64_xseries.h index a6bf497c..4dfad0c4 100644 --- a/src/flashcart/ed64/ed64_xseries.h +++ b/src/flashcart/ed64/ed64_xseries.h @@ -16,7 +16,7 @@ * @{ */ -flashcart_t *ed64xseries_get_flashcart (void); +flashcart_t *ed64_xseries_get_flashcart (void); /** @} */ /* ED64_Xseries */ diff --git a/src/flashcart/ed64/ed64_xseries_ll.h b/src/flashcart/ed64/ed64_xseries_ll.h new file mode 100644 index 00000000..eb3bb717 --- /dev/null +++ b/src/flashcart/ed64/ed64_xseries_ll.h @@ -0,0 +1,14 @@ +/** + * @file ed64_xseries_ll.h + * @brief ed64x flashcart low level access + * @ingroup flashcart + */ + +#ifndef FLASHCART_ED64_XSERIES_LL_H__ +#define FLASHCART_ED64_XSERIES_LL_H__ + + +/** @} */ /* ed64_xseries_ll */ + + +#endif diff --git a/src/flashcart/flashcart.c b/src/flashcart/flashcart.c index 6b634cac..48d0b2fe 100644 --- a/src/flashcart/flashcart.c +++ b/src/flashcart/flashcart.c @@ -1,20 +1,24 @@ -#include +/** + * @file flashcart.c + * @brief Flashcart functions implementation + * @ingroup flashcart + */ +#include #include #include #include #include "utils/fs.h" #include "utils/utils.h" - #include "flashcart.h" #include "flashcart_utils.h" - #include "ed64/ed64_vseries.h" +#include "ed64/ed64_xseries.h" #include "64drive/64drive.h" #include "sc64/sc64.h" - +/** @brief Save sizes for different flashcart save types. */ static const size_t SAVE_SIZE[__FLASHCART_SAVE_TYPE_END] = { 0, 512, @@ -26,11 +30,21 @@ static const size_t SAVE_SIZE[__FLASHCART_SAVE_TYPE_END] = { KiB(128), }; - +/** + * @brief Dummy initialization function for flashcart. + * + * @return flashcart_err_t Error code. + */ static flashcart_err_t dummy_init (void) { return FLASHCART_OK; } +/** + * @brief Dummy function to check if a feature is supported by the flashcart. + * + * @param feature The feature to check. + * @return true if the feature is supported, false otherwise. + */ static bool dummy_has_feature (flashcart_features_t feature) { switch (feature) { default: @@ -38,22 +52,50 @@ static bool dummy_has_feature (flashcart_features_t feature) { } } +/** + * @brief Dummy function to load a ROM into the flashcart. + * + * @param rom_path Path to the ROM file. + * @param progress Progress callback function. + * @return flashcart_err_t Error code. + */ static flashcart_err_t dummy_load_rom (char *rom_path, flashcart_progress_callback_t *progress) { return FLASHCART_OK; } +/** + * @brief Dummy function to load a file into the flashcart. + * + * @param file_path Path to the file. + * @param rom_offset ROM offset. + * @param file_offset File offset. + * @return flashcart_err_t Error code. + */ static flashcart_err_t dummy_load_file (char *file_path, uint32_t rom_offset, uint32_t file_offset) { return FLASHCART_OK; } +/** + * @brief Dummy function to load a save file into the flashcart. + * + * @param save_path Path to the save file. + * @return flashcart_err_t Error code. + */ static flashcart_err_t dummy_load_save (char *save_path) { return FLASHCART_OK; } +/** + * @brief Dummy function to set the save type for the flashcart. + * + * @param save_type The save type. + * @return flashcart_err_t Error code. + */ static flashcart_err_t dummy_set_save_type (flashcart_save_type_t save_type) { return FLASHCART_OK; } +/** @brief Flashcart structure with dummy functions. */ static flashcart_t *flashcart = &((flashcart_t) { .init = dummy_init, .deinit = NULL, @@ -65,6 +107,7 @@ static flashcart_t *flashcart = &((flashcart_t) { .load_64dd_disk = NULL, .set_save_type = dummy_set_save_type, .set_save_writeback = NULL, + .set_next_boot_mode = NULL, }); #ifdef NDEBUG @@ -74,7 +117,12 @@ static flashcart_t *flashcart = &((flashcart_t) { bool debug_init_sdfs (const char *prefix, int npart); #endif - +/** + * @brief Convert a flashcart error code to a human-readable message. + * + * @param err The flashcart error code. + * @return char* The error message. + */ char *flashcart_convert_error_message (flashcart_err_t err) { switch (err) { case FLASHCART_OK: return "No error"; @@ -89,6 +137,12 @@ char *flashcart_convert_error_message (flashcart_err_t err) { } } +/** + * @brief Initialize the flashcart. + * + * @param storage_prefix Pointer to the storage prefix. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_init (const char **storage_prefix) { flashcart_err_t err; @@ -109,10 +163,9 @@ flashcart_err_t flashcart_init (const char **storage_prefix) { flashcart = d64_get_flashcart(); break; - // FIXME: this is commented out awaiting a fix from libcart. - // case CART_EDX: // Series X EverDrive-64 - // flashcart = ed64_xseries_get_flashcart(); - // break; + case CART_EDX: // Official EverDrive 64 Series X + flashcart = ed64_xseries_get_flashcart(); + break; case CART_ED: // Series V EverDrive-64 or clone flashcart = ed64_vseries_get_flashcart(); @@ -144,6 +197,11 @@ flashcart_err_t flashcart_init (const char **storage_prefix) { return FLASHCART_OK; } +/** + * @brief Deinitialize the flashcart. + * + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_deinit (void) { if (flashcart->deinit) { return flashcart->deinit(); @@ -152,14 +210,33 @@ flashcart_err_t flashcart_deinit (void) { return FLASHCART_OK; } +/** + * @brief Check if the flashcart has a specific feature. + * + * @param feature The feature to check. + * @return true if the feature is supported, false otherwise. + */ bool flashcart_has_feature (flashcart_features_t feature) { return flashcart->has_feature(feature); } +/** + * @brief Get the firmware version of the flashcart. + * + * @return flashcart_firmware_version_t The firmware version. + */ flashcart_firmware_version_t flashcart_get_firmware_version (void) { return flashcart->get_firmware_version(); } +/** + * @brief Load a ROM into the flashcart. + * + * @param rom_path Path to the ROM file. + * @param byte_swap Flag indicating whether to byte swap the ROM. + * @param progress Progress callback function. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_rom (char *rom_path, bool byte_swap, flashcart_progress_callback_t *progress) { flashcart_err_t err; @@ -174,6 +251,14 @@ flashcart_err_t flashcart_load_rom (char *rom_path, bool byte_swap, flashcart_pr return err; } +/** + * @brief Load a file into the flashcart. + * + * @param file_path Path to the file. + * @param rom_offset ROM offset. + * @param file_offset File offset. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_file (char *file_path, uint32_t rom_offset, uint32_t file_offset) { if ((file_path == NULL) || ((file_offset % FS_SECTOR_SIZE) != 0)) { return FLASHCART_ERR_ARGS; @@ -182,6 +267,13 @@ flashcart_err_t flashcart_load_file (char *file_path, uint32_t rom_offset, uint3 return flashcart->load_file(file_path, rom_offset, file_offset); } +/** + * @brief Load a save file into the flashcart. + * + * @param save_path Path to the save file. + * @param save_type The save type. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_save (char *save_path, flashcart_save_type_t save_type) { flashcart_err_t err; @@ -221,6 +313,13 @@ flashcart_err_t flashcart_load_save (char *save_path, flashcart_save_type_t save return flashcart->set_save_writeback(save_path); } +/** + * @brief Load the 64DD IPL into the flashcart. + * + * @param ipl_path Path to the IPL file. + * @param progress Progress callback function. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_64dd_ipl (char *ipl_path, flashcart_progress_callback_t *progress) { if (!flashcart->load_64dd_ipl) { return FLASHCART_ERR_FUNCTION_NOT_SUPPORTED; @@ -233,6 +332,13 @@ flashcart_err_t flashcart_load_64dd_ipl (char *ipl_path, flashcart_progress_call return flashcart->load_64dd_ipl(ipl_path, progress); } +/** + * @brief Load a 64DD disk into the flashcart. + * + * @param disk_path Path to the disk file. + * @param disk_parameters Pointer to the disk parameters. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_64dd_disk (char *disk_path, flashcart_disk_parameters_t *disk_parameters) { if (!flashcart->load_64dd_disk) { return FLASHCART_ERR_FUNCTION_NOT_SUPPORTED; @@ -244,3 +350,11 @@ flashcart_err_t flashcart_load_64dd_disk (char *disk_path, flashcart_disk_parame return flashcart->load_64dd_disk(disk_path, disk_parameters); } + +flashcart_err_t flashcart_set_next_boot_mode (flashcart_reboot_mode_t boot_mode) { + if (!flashcart->set_next_boot_mode) { + return FLASHCART_ERR_FUNCTION_NOT_SUPPORTED; + } + + return flashcart->set_next_boot_mode(boot_mode); +} diff --git a/src/flashcart/flashcart.h b/src/flashcart/flashcart.h index 4a191290..65812414 100644 --- a/src/flashcart/flashcart.h +++ b/src/flashcart/flashcart.h @@ -7,63 +7,71 @@ #ifndef FLASHCART_H__ #define FLASHCART_H__ - #include #include - /** @brief Flashcart error enumeration */ typedef enum { - FLASHCART_OK, - FLASHCART_ERR_OUTDATED, - FLASHCART_ERR_SD_CARD, - FLASHCART_ERR_BBFS, - FLASHCART_ERR_ARGS, - FLASHCART_ERR_LOAD, - FLASHCART_ERR_INT, - FLASHCART_ERR_FUNCTION_NOT_SUPPORTED, + FLASHCART_OK, /**< No error */ + FLASHCART_ERR_OUTDATED, /**< Outdated firmware error */ + FLASHCART_ERR_SD_CARD, /**< SD card error */ + FLASHCART_ERR_BBFS, /**< BBFS error */ + FLASHCART_ERR_ARGS, /**< Argument error */ + FLASHCART_ERR_LOAD, /**< Load error */ + FLASHCART_ERR_INT, /**< Internal error */ + FLASHCART_ERR_FUNCTION_NOT_SUPPORTED, /**< Function not supported error */ } flashcart_err_t; /** @brief List of optional supported flashcart features */ typedef enum { - FLASHCART_FEATURE_64DD, - FLASHCART_FEATURE_RTC, - FLASHCART_FEATURE_USB, - FLASHCART_FEATURE_AUTO_CIC, - FLASHCART_FEATURE_AUTO_REGION, - FLASHCART_FEATURE_DIAGNOSTIC_DATA, - FLASHCART_FEATURE_BIOS_UPDATE_FROM_MENU, - FLASHCART_FEATURE_SAVE_WRITEBACK + FLASHCART_FEATURE_64DD, /**< 64DD support */ + FLASHCART_FEATURE_RTC, /**< Real-time clock support */ + FLASHCART_FEATURE_USB, /**< USB support */ + FLASHCART_FEATURE_AUTO_CIC, /**< Automatic CIC detection */ + FLASHCART_FEATURE_AUTO_REGION, /**< Automatic region detection */ + FLASHCART_FEATURE_DIAGNOSTIC_DATA, /**< Diagnostic data support */ + FLASHCART_FEATURE_BIOS_UPDATE_FROM_MENU, /**< BIOS update from menu support */ + FLASHCART_FEATURE_SAVE_WRITEBACK, /**< Save writeback support */ + FLASHCART_FEATURE_ROM_REBOOT_FAST /**< Fast ROM reboot support */ } flashcart_features_t; /** @brief Flashcart save type enumeration */ typedef enum { - FLASHCART_SAVE_TYPE_NONE, - FLASHCART_SAVE_TYPE_EEPROM_4KBIT, - FLASHCART_SAVE_TYPE_EEPROM_16KBIT, - FLASHCART_SAVE_TYPE_SRAM_256KBIT, - FLASHCART_SAVE_TYPE_SRAM_BANKED, - FLASHCART_SAVE_TYPE_SRAM_1MBIT, - FLASHCART_SAVE_TYPE_FLASHRAM_1MBIT, - FLASHCART_SAVE_TYPE_FLASHRAM_PKST2, - __FLASHCART_SAVE_TYPE_END + FLASHCART_SAVE_TYPE_NONE, /**< No save type */ + FLASHCART_SAVE_TYPE_EEPROM_4KBIT, /**< EEPROM 4Kbit */ + FLASHCART_SAVE_TYPE_EEPROM_16KBIT, /**< EEPROM 16Kbit */ + FLASHCART_SAVE_TYPE_SRAM_256KBIT, /**< SRAM 256Kbit */ + FLASHCART_SAVE_TYPE_SRAM_BANKED, /**< SRAM Banked */ + FLASHCART_SAVE_TYPE_SRAM_1MBIT, /**< SRAM 1Mbit */ + FLASHCART_SAVE_TYPE_FLASHRAM_1MBIT, /**< FlashRAM 1Mbit */ + FLASHCART_SAVE_TYPE_FLASHRAM_PKST2, /**< FlashRAM PKST2 */ + __FLASHCART_SAVE_TYPE_END /**< End of save types */ } flashcart_save_type_t; +/** @brief Flashcart save type enumeration */ +typedef enum { + /** @brief The flashcart will reboot into the menu on soft reboot (using the RESET button) */ + FLASHCART_REBOOT_MODE_MENU, + /** @brief The flashcart will reboot into the previous ROM on soft reboot (using the RESET button) */ + FLASHCART_REBOOT_MODE_ROM, +} flashcart_reboot_mode_t; + /** @brief Flashcart Disk Parameter Structure. */ typedef struct { - bool development_drive; - uint8_t disk_type; - bool bad_system_area_lbas[24]; - uint8_t defect_tracks[16][12]; + bool development_drive; /**< Development drive flag */ + uint8_t disk_type; /**< Disk type */ + bool bad_system_area_lbas[24]; /**< Bad system area LBAs */ + uint8_t defect_tracks[16][12]; /**< Defect tracks */ } flashcart_disk_parameters_t; /** @brief Flashcart Firmware version Structure. */ typedef struct { - uint16_t major; - uint16_t minor; - uint32_t revision; + uint16_t major; /**< Major version */ + uint16_t minor; /**< Minor version */ + uint32_t revision; /**< Revision */ } flashcart_firmware_version_t; +/** @brief Flashcart progress callback type */ typedef void flashcart_progress_callback_t (float progress); /** @brief Flashcart Structure */ @@ -90,19 +98,94 @@ typedef struct { flashcart_err_t (*set_save_type) (flashcart_save_type_t save_type); /** @brief The flashcart set save writeback function */ flashcart_err_t (*set_save_writeback) (char *save_path); + /** @brief The flashcart set boot mode function */ + flashcart_err_t (*set_next_boot_mode) (flashcart_reboot_mode_t boot_mode); } flashcart_t; - +/** + * @brief Convert a flashcart error code to a human-readable error message. + * + * @param err The flashcart error code. + * @return char* The human-readable error message. + */ char *flashcart_convert_error_message (flashcart_err_t err); + +/** + * @brief Initialize the flashcart. + * + * @param storage_prefix Pointer to the storage prefix. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_init (const char **storage_prefix); + +/** + * @brief Deinitialize the flashcart. + * + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_deinit (void); + +/** + * @brief Check if the flashcart has a specific feature. + * + * @param feature The flashcart feature to check. + * @return bool True if the feature is supported, false otherwise. + */ bool flashcart_has_feature (flashcart_features_t feature); + +/** + * @brief Get the flashcart firmware version. + * + * @return flashcart_firmware_version_t The firmware version. + */ flashcart_firmware_version_t flashcart_get_firmware_version (void); + +/** + * @brief Load a ROM onto the flashcart. + * + * @param rom_path The path to the ROM file. + * @param byte_swap Whether to byte swap the ROM. + * @param progress Callback function for progress updates. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_rom (char *rom_path, bool byte_swap, flashcart_progress_callback_t *progress); + +/** + * @brief Load a file onto the flashcart. + * + * @param file_path The path to the file. + * @param rom_offset The ROM offset. + * @param file_offset The file offset. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_file (char *file_path, uint32_t rom_offset, uint32_t file_offset); + +/** + * @brief Load a save file onto the flashcart. + * + * @param save_path The path to the save file. + * @param save_type The type of save. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_save (char *save_path, flashcart_save_type_t save_type); + +/** + * @brief Load the 64DD IPL (BIOS) onto the flashcart. + * + * @param ipl_path The path to the IPL file. + * @param progress Callback function for progress updates. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_64dd_ipl (char *ipl_path, flashcart_progress_callback_t *progress); + +/** + * @brief Load a 64DD disk onto the flashcart. + * + * @param disk_path The path to the disk file. + * @param disk_parameters Pointer to the disk parameters structure. + * @return flashcart_err_t Error code. + */ flashcart_err_t flashcart_load_64dd_disk (char *disk_path, flashcart_disk_parameters_t *disk_parameters); +flashcart_err_t flashcart_set_next_boot_mode (flashcart_reboot_mode_t boot_mode); - -#endif +#endif /* FLASHCART_H__ */ diff --git a/src/flashcart/flashcart_utils.c b/src/flashcart/flashcart_utils.c index cfc714da..a68ac8de 100644 --- a/src/flashcart/flashcart_utils.c +++ b/src/flashcart/flashcart_utils.c @@ -1,16 +1,35 @@ +/** + * @file flashcart_utils.c + * @brief Flashcart utility functions implementation + * @ingroup flashcart + */ + #include #include "flashcart_utils.h" #include "utils/fs.h" #include "utils/utils.h" - +/** + * @brief Perform a DMA read operation from the PI (Peripheral Interface). + * + * @param src Source address. + * @param dst Destination address. + * @param length Length of data to read. + */ void pi_dma_read_data (void *src, void *dst, size_t length) { data_cache_hit_writeback_invalidate(dst, length); dma_read_async(dst, (uint32_t) (src), length); dma_wait(); } +/** + * @brief Perform a DMA write operation to the PI (Peripheral Interface). + * + * @param src Source address. + * @param dst Destination address. + * @param length Length of data to write. + */ void pi_dma_write_data (void *src, void *dst, size_t length) { assert((((uint32_t) (src)) & 0x07) == 0); assert((((uint32_t) (dst)) & 0x01) == 0); @@ -21,6 +40,11 @@ void pi_dma_write_data (void *src, void *dst, size_t length) { dma_wait(); } +/** + * @brief Align the file size to the SD sector size to prevent partial sector load. + * + * @param fil Pointer to the file object. + */ void fatfs_fix_file_size (FIL *fil) { // HACK: Align file size to the SD sector size to prevent FatFs from doing partial sector load. // We are relying on direct transfer from SD to SDRAM without CPU intervention. @@ -28,6 +52,15 @@ void fatfs_fix_file_size (FIL *fil) { fil->obj.objsize = ALIGN(f_size(fil), FS_SECTOR_SIZE); } +/** + * @brief Get the file sectors in the FAT filesystem. + * + * @param path Path to the file. + * @param address Pointer to store the address of the file sectors. + * @param type The type of address (memory or PI). + * @param max_sectors Maximum number of sectors. + * @return true if an error occurred, false otherwise. + */ bool fatfs_get_file_sectors (char *path, uint32_t *address, address_type_t type, uint32_t max_sectors) { FATFS *fs; FIL fil; diff --git a/src/flashcart/flashcart_utils.h b/src/flashcart/flashcart_utils.h index c0b5d6d8..dc55a550 100644 --- a/src/flashcart/flashcart_utils.h +++ b/src/flashcart/flashcart_utils.h @@ -7,27 +7,56 @@ #ifndef FLASHCART_UTILS_H__ #define FLASHCART_UTILS_H__ - #include #include #include #include - #define SAVE_WRITEBACK_MAX_SECTORS (256) - +/** + * @brief Address types for DMA operations. + */ typedef enum { - ADDRESS_TYPE_MEM, - ADDRESS_TYPE_PI, + ADDRESS_TYPE_MEM, /**< Memory address type. */ + ADDRESS_TYPE_PI, /**< Peripheral Interface address type. */ } address_type_t; - +/** + * @brief Perform a DMA read operation from the PI (Peripheral Interface). + * + * @param src Source address. + * @param dst Destination address. + * @param length Length of data to read. + */ void pi_dma_read_data (void *src, void *dst, size_t length); + +/** + * @brief Perform a DMA write operation to the PI (Peripheral Interface). + * + * @param src Source address. + * @param dst Destination address. + * @param length Length of data to write. + */ void pi_dma_write_data (void *src, void *dst, size_t length); + +/** + * @brief Fix the file size in the FAT filesystem. + * + * @param fil Pointer to the file object. + */ void fatfs_fix_file_size (FIL *fil); + +/** + * @brief Get the file sectors in the FAT filesystem. + * + * @param path Path to the file. + * @param address Pointer to store the address of the file sectors. + * @param address_type The type of address (memory or PI). + * @param max_sectors Maximum number of sectors. + * @return true if successful, false otherwise. + */ bool fatfs_get_file_sectors (char *path, uint32_t *address, address_type_t address_type, uint32_t max_sectors); - -#endif +#endif /* FLASHCART_UTILS_H__ */ diff --git a/src/flashcart/sc64/README.md b/src/flashcart/sc64/README.md index fe313411..5071466f 100644 --- a/src/flashcart/sc64/README.md +++ b/src/flashcart/sc64/README.md @@ -1,4 +1,4 @@ -# SummerCart64 developer notes +## SummerCart64 developer notes ### Official documentation diff --git a/src/flashcart/sc64/sc64.c b/src/flashcart/sc64/sc64.c index e53c3e27..66261c75 100644 --- a/src/flashcart/sc64/sc64.c +++ b/src/flashcart/sc64/sc64.c @@ -1,3 +1,9 @@ +/** + * @file sc64.c + * @brief SummerCart64 functions implementation + * @ingroup flashcart + */ + #include #include #include @@ -12,7 +18,6 @@ #include "sc64_ll.h" #include "sc64.h" - #define SRAM_FLASHRAM_ADDRESS (0x08000000) #define ROM_ADDRESS (0x10000000) #define IPL_ADDRESS (0x13BC0000) @@ -39,7 +44,6 @@ #define THB_UNMAPPED (0xFFFFFFFF) #define THB_WRITABLE_FLAG (1 << 31) - static const struct { uint8_t head; uint8_t sector_length; @@ -63,6 +67,7 @@ static const struct { { 1, 128, 149, 912 }, { 1, 112, 114, 1061 }, }; + static const uint8_t vzone_to_pzone[DISK_TYPES][DISK_ZONES] = { {0, 1, 2, 9, 8, 3, 4, 5, 6, 7, 15, 14, 13, 12, 11, 10}, {0, 1, 2, 3, 10, 9, 8, 4, 5, 6, 7, 15, 14, 13, 12, 11}, @@ -72,9 +77,19 @@ static const uint8_t vzone_to_pzone[DISK_TYPES][DISK_ZONES] = { {0, 1, 2, 3, 4, 5, 6, 7, 14, 13, 12, 11, 10, 9, 8, 15}, {0, 1, 2, 3, 4, 5, 6, 7, 15, 14, 13, 12, 11, 10, 9, 8}, }; + static const uint8_t rom_zones[DISK_TYPES] = { 5, 7, 9, 11, 13, 15, 16 }; - +/** + * @brief Load data to flash memory. + * + * @param fil Pointer to the file object. + * @param address Address to load data to. + * @param size Size of the data to load. + * @param br Pointer to store the number of bytes read. + * @param progress Progress callback function. + * @return flashcart_err_t Error code. + */ static flashcart_err_t load_to_flash (FIL *fil, void *address, size_t size, UINT *br, flashcart_progress_callback_t *progress) { size_t erase_block_size; UINT bp; @@ -107,7 +122,14 @@ static flashcart_err_t load_to_flash (FIL *fil, void *address, size_t size, UINT return FLASHCART_OK; } - +/** + * @brief Check if a disk zone track is bad. + * + * @param zone Zone number. + * @param track Track number. + * @param disk_parameters Pointer to the disk parameters. + * @return true if the track is bad, false otherwise. + */ static bool disk_zone_track_is_bad (uint8_t zone, uint8_t track, flashcart_disk_parameters_t *disk_parameters) { for (int i = 0; i < DISK_BAD_TRACKS_PER_ZONE; i++) { if (disk_parameters->defect_tracks[zone][i] == track) { @@ -118,6 +140,13 @@ static bool disk_zone_track_is_bad (uint8_t zone, uint8_t track, flashcart_disk_ return false; } +/** + * @brief Check if a system LBA is bad. + * + * @param lba Logical block address. + * @param disk_parameters Pointer to the disk parameters. + * @return true if the LBA is bad, false otherwise. + */ static bool disk_system_lba_is_bad (uint16_t lba, flashcart_disk_parameters_t *disk_parameters) { if (lba < DISK_SYSTEM_LBA_COUNT) { return disk_parameters->bad_system_area_lbas[lba]; @@ -126,6 +155,17 @@ static bool disk_system_lba_is_bad (uint16_t lba, flashcart_disk_parameters_t *d return false; } +/** + * @brief Set the THB mapping for a disk. + * + * @param offset Offset for the THB mapping. + * @param track Track number. + * @param head Head number. + * @param block Block number. + * @param valid Valid flag. + * @param writable Writable flag. + * @param file_offset File offset. + */ static void disk_set_thb_mapping (uint32_t offset, uint16_t track, uint8_t head, uint8_t block, bool valid, bool writable, int file_offset) { uint32_t index = (track << 2) | (head << 1) | (block); uint32_t mapping = valid ? ((writable ? THB_WRITABLE_FLAG : 0) | (file_offset & ~(THB_WRITABLE_FLAG))) : THB_UNMAPPED; @@ -133,6 +173,13 @@ static void disk_set_thb_mapping (uint32_t offset, uint16_t track, uint8_t head, io_write(ROM_ADDRESS + offset + (index * sizeof(uint32_t)), mapping); } +/** + * @brief Load the THB table for a disk. + * + * @param disk_parameters Pointer to the disk parameters. + * @param thb_table_offset Pointer to store the THB table offset. + * @param current_offset Pointer to the current offset. + */ static void disk_load_thb_table (flashcart_disk_parameters_t *disk_parameters, uint32_t *thb_table_offset, uint32_t *current_offset) { int file_offset = 0; @@ -176,6 +223,14 @@ static void disk_load_thb_table (flashcart_disk_parameters_t *disk_parameters, u *current_offset += (DISK_TRACKS * DISK_HEADS * DISK_BLOCKS * sizeof(uint32_t)); } +/** + * @brief Load the sector table for a disk. + * + * @param path Path to the disk file. + * @param sector_table_offset Pointer to store the sector table offset. + * @param current_offset Pointer to the current offset. + * @return true if an error occurred, false otherwise. + */ static bool disk_load_sector_table (char *path, uint32_t *sector_table_offset, uint32_t *current_offset) { if (fatfs_get_file_sectors(path, (uint32_t *) (ROM_ADDRESS + *current_offset), ADDRESS_TYPE_PI, DISK_MAX_SECTORS)) { return true; @@ -187,6 +242,11 @@ static bool disk_load_sector_table (char *path, uint32_t *sector_table_offset, u return false; } +/** + * @brief Get the firmware version of the SummerCart64. + * + * @return flashcart_firmware_version_t The firmware version. + */ static flashcart_firmware_version_t sc64_get_firmware_version (void) { flashcart_firmware_version_t version_info; @@ -195,7 +255,11 @@ static flashcart_firmware_version_t sc64_get_firmware_version (void) { return version_info; } - +/** + * @brief Initialize the SummerCart64. + * + * @return flashcart_err_t Error code. + */ static flashcart_err_t sc64_init (void) { uint16_t major; uint16_t minor; @@ -249,6 +313,11 @@ static flashcart_err_t sc64_init (void) { return FLASHCART_OK; } +/** + * @brief Deinitialize the SummerCart64. + * + * @return flashcart_err_t Error code. + */ static flashcart_err_t sc64_deinit (void) { sc64_ll_set_config(CFG_ID_ROM_WRITE_ENABLE, false); @@ -257,6 +326,12 @@ static flashcart_err_t sc64_deinit (void) { return FLASHCART_OK; } +/** + * @brief Check if the SummerCart64 has a specific feature. + * + * @param feature The feature to check. + * @return true if the feature is supported, false otherwise. + */ static bool sc64_has_feature (flashcart_features_t feature) { switch (feature) { case FLASHCART_FEATURE_64DD: return true; @@ -266,10 +341,18 @@ static bool sc64_has_feature (flashcart_features_t feature) { case FLASHCART_FEATURE_AUTO_REGION: return true; case FLASHCART_FEATURE_DIAGNOSTIC_DATA: return true; case FLASHCART_FEATURE_SAVE_WRITEBACK: return true; + case FLASHCART_FEATURE_ROM_REBOOT_FAST: return true; default: return false; } } +/** + * @brief Load a ROM into the SummerCart64. + * + * @param rom_path Path to the ROM file. + * @param progress Progress callback function. + * @return flashcart_err_t Error code. + */ static flashcart_err_t sc64_load_rom (char *rom_path, flashcart_progress_callback_t *progress) { FIL fil; UINT br; @@ -351,6 +434,14 @@ static flashcart_err_t sc64_load_rom (char *rom_path, flashcart_progress_callbac return FLASHCART_OK; } +/** + * @brief Load a file into the SummerCart64. + * + * @param file_path Path to the file. + * @param rom_offset ROM offset. + * @param file_offset File offset. + * @return flashcart_err_t Error code. + */ static flashcart_err_t sc64_load_file (char *file_path, uint32_t rom_offset, uint32_t file_offset) { FIL fil; UINT br; @@ -575,6 +666,25 @@ static flashcart_err_t sc64_set_save_writeback (char *save_path) { return FLASHCART_OK; } +static flashcart_err_t sc64_set_bootmode (flashcart_reboot_mode_t boot_mode) { + + sc64_boot_mode_t type = BOOT_MODE_MENU; + + switch (boot_mode) { + case FLASHCART_REBOOT_MODE_ROM: + type = BOOT_MODE_ROM; + break; + default: + type = BOOT_MODE_MENU; + break; + } + if (sc64_ll_set_config(CFG_ID_BOOT_MODE, type) != SC64_OK) { + return FLASHCART_ERR_INT; + } + + return FLASHCART_OK; +} + static flashcart_t flashcart_sc64 = { .init = sc64_init, @@ -588,6 +698,7 @@ static flashcart_t flashcart_sc64 = { .load_64dd_disk = sc64_load_64dd_disk, .set_save_type = sc64_set_save_type, .set_save_writeback = sc64_set_save_writeback, + .set_next_boot_mode = sc64_set_bootmode, }; diff --git a/src/flashcart/sc64/sc64_ll.c b/src/flashcart/sc64/sc64_ll.c index 1ab65bd1..9ed81e33 100644 --- a/src/flashcart/sc64/sc64_ll.c +++ b/src/flashcart/sc64/sc64_ll.c @@ -1,15 +1,20 @@ +/** + * @file sc64_ll.c + * @brief Low-level functions for SummerCart64 + * @ingroup flashcart + */ + #include #include "../flashcart_utils.h" #include "sc64_ll.h" - /** @brief SummerCart64 Registers Structure. */ typedef struct { - uint32_t SR_CMD; - uint32_t DATA[2]; - uint32_t IDENTIFIER; - uint32_t KEY; + uint32_t SR_CMD; /**< Command Status Register. */ + uint32_t DATA[2]; /**< Data Registers. */ + uint32_t IDENTIFIER; /**< Identifier Register. */ + uint32_t KEY; /**< Key Register. */ } sc64_regs_t; #define SC64_REGS_BASE (0x1FFF0000UL) @@ -20,7 +25,7 @@ typedef struct { #define SC64_KEY_LOCK (0xFFFFFFFFUL) - +/** @brief SummerCart64 Command IDs. */ typedef enum { CMD_ID_VERSION_GET = 'V', CMD_ID_CONFIG_GET = 'c', @@ -34,12 +39,17 @@ typedef enum { /** @brief SummerCart64 Commands Structure. */ typedef struct { - sc64_cmd_id_t id; - uint32_t arg[2]; - uint32_t rsp[2]; + sc64_cmd_id_t id; /**< Command ID. */ + uint32_t arg[2]; /**< Command arguments. */ + uint32_t rsp[2]; /**< Command response. */ } sc64_cmd_t; - +/** + * @brief Execute a command on the SummerCart64. + * + * @param cmd Pointer to the command structure. + * @return sc64_error_t Error code. + */ static sc64_error_t sc64_ll_execute_cmd (sc64_cmd_t *cmd) { io_write((uint32_t) (&SC64_REGS->DATA[0]), cmd->arg[0]); io_write((uint32_t) (&SC64_REGS->DATA[1]), cmd->arg[1]); @@ -61,11 +71,21 @@ static sc64_error_t sc64_ll_execute_cmd (sc64_cmd_t *cmd) { return SC64_OK; } - +/** + * @brief Lock the SummerCart64. + */ void sc64_ll_lock (void) { io_write((uint32_t) (&SC64_REGS->KEY), SC64_KEY_LOCK); } +/** + * @brief Get the firmware version of the SummerCart64. + * + * @param major Pointer to store the major version. + * @param minor Pointer to store the minor version. + * @param revision Pointer to store the revision number. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_get_version (uint16_t *major, uint16_t *minor, uint32_t *revision) { sc64_cmd_t cmd = { .id = CMD_ID_VERSION_GET @@ -77,6 +97,13 @@ sc64_error_t sc64_ll_get_version (uint16_t *major, uint16_t *minor, uint32_t *re return error; } +/** + * @brief Get a configuration value from the SummerCart64. + * + * @param id Configuration ID. + * @param value Pointer to store the configuration value. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_get_config (sc64_cfg_id_t id, uint32_t *value) { sc64_cmd_t cmd = { .id = CMD_ID_CONFIG_GET, @@ -87,6 +114,13 @@ sc64_error_t sc64_ll_get_config (sc64_cfg_id_t id, uint32_t *value) { return error; } +/** + * @brief Set a configuration value on the SummerCart64. + * + * @param id Configuration ID. + * @param value Configuration value. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_set_config (sc64_cfg_id_t id, uint32_t value) { sc64_cmd_t cmd = { .id = CMD_ID_CONFIG_SET, @@ -95,6 +129,12 @@ sc64_error_t sc64_ll_set_config (sc64_cfg_id_t id, uint32_t value) { return sc64_ll_execute_cmd(&cmd); } +/** + * @brief Set the disk mapping on the SummerCart64. + * + * @param disk_mapping Pointer to the disk mapping structure. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_set_disk_mapping (sc64_disk_mapping_t *disk_mapping) { int disk_count = disk_mapping->count; @@ -121,6 +161,12 @@ sc64_error_t sc64_ll_set_disk_mapping (sc64_disk_mapping_t *disk_mapping) { return sc64_ll_execute_cmd(&cmd); } +/** + * @brief Check if there are pending writebacks on the SummerCart64. + * + * @param pending Pointer to store the pending status. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_writeback_pending (bool *pending) { sc64_cmd_t cmd = { .id = CMD_ID_WRITEBACK_PENDING @@ -130,6 +176,12 @@ sc64_error_t sc64_ll_writeback_pending (bool *pending) { return error; } +/** + * @brief Enable writeback on the SummerCart64. + * + * @param address Address to enable writeback. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_writeback_enable (void *address) { sc64_cmd_t cmd = { .id = CMD_ID_WRITEBACK_SD_INFO, @@ -138,6 +190,11 @@ sc64_error_t sc64_ll_writeback_enable (void *address) { return sc64_ll_execute_cmd(&cmd); } +/** + * @brief Wait for the flash to become idle on the SummerCart64. + * + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_flash_wait_busy (void) { sc64_cmd_t cmd = { .id = CMD_ID_FLASH_WAIT_BUSY, @@ -146,6 +203,12 @@ sc64_error_t sc64_ll_flash_wait_busy (void) { return sc64_ll_execute_cmd(&cmd); } +/** + * @brief Get the flash erase block size on the SummerCart64. + * + * @param erase_block_size Pointer to store the erase block size. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_flash_get_erase_block_size (size_t *erase_block_size) { sc64_cmd_t cmd = { .id = CMD_ID_FLASH_WAIT_BUSY, @@ -156,6 +219,12 @@ sc64_error_t sc64_ll_flash_get_erase_block_size (size_t *erase_block_size) { return error; } +/** + * @brief Erase a flash block on the SummerCart64. + * + * @param address Address of the block to erase. + * @return sc64_error_t Error code. + */ sc64_error_t sc64_ll_flash_erase_block (void *address) { sc64_cmd_t cmd = { .id = CMD_ID_FLASH_ERASE_BLOCK, diff --git a/src/flashcart/sc64/sc64_ll.h b/src/flashcart/sc64/sc64_ll.h index ce3a5aae..356bb161 100644 --- a/src/flashcart/sc64/sc64_ll.h +++ b/src/flashcart/sc64/sc64_ll.h @@ -7,11 +7,9 @@ #ifndef FLASHCART_SC64_LL_H__ #define FLASHCART_SC64_LL_H__ - #include #include - /** * @addtogroup sc64 * @{ @@ -19,10 +17,10 @@ /** @brief The SC64 buffers structure. */ typedef struct { - uint8_t BUFFER[8192]; - uint8_t EEPROM[2048]; - uint8_t DD_SECTOR[256]; - uint8_t FLASHRAM[128]; + uint8_t BUFFER[8192]; /**< General buffer */ + uint8_t EEPROM[2048]; /**< EEPROM buffer */ + uint8_t DD_SECTOR[256]; /**< Disk Drive sector buffer */ + uint8_t FLASHRAM[128]; /**< FlashRAM buffer */ } sc64_buffers_t; #define SC64_BUFFERS_BASE (0x1FFE0000UL) @@ -30,110 +28,185 @@ typedef struct { /** @brief The SC64 State Enumeration. */ typedef enum { - SC64_OK, - SC64_ERROR_BAD_ARGUMENT, - SC64_ERROR_BAD_ADDRESS, - SC64_ERROR_BAD_CONFIG_ID, - SC64_ERROR_TIMEOUT, - SC64_ERROR_SD_CARD, - SC64_ERROR_UNKNOWN_CMD = -1 + SC64_OK, /**< No error */ + SC64_ERROR_BAD_ARGUMENT, /**< Bad argument error */ + SC64_ERROR_BAD_ADDRESS, /**< Bad address error */ + SC64_ERROR_BAD_CONFIG_ID, /**< Bad config ID error */ + SC64_ERROR_TIMEOUT, /**< Timeout error */ + SC64_ERROR_SD_CARD, /**< SD card error */ + SC64_ERROR_UNKNOWN_CMD = -1 /**< Unknown command error */ } sc64_error_t; +/** @brief The SC64 Configuration ID Enumeration. */ typedef enum { - CFG_ID_BOOTLOADER_SWITCH, - CFG_ID_ROM_WRITE_ENABLE, - CFG_ID_ROM_SHADOW_ENABLE, - CFG_ID_DD_MODE, - CFG_ID_ISV_ADDRESS, - CFG_ID_BOOT_MODE, - CFG_ID_SAVE_TYPE, - CFG_ID_CIC_SEED, - CFG_ID_TV_TYPE, - CFG_ID_DD_SD_ENABLE, - CFG_ID_DD_DRIVE_TYPE, - CFG_ID_DD_DISK_STATE, - CFG_ID_BUTTON_STATE, - CFG_ID_BUTTON_MODE, - CFG_ID_ROM_EXTENDED_ENABLE, + CFG_ID_BOOTLOADER_SWITCH, /**< Bootloader switch config */ + CFG_ID_ROM_WRITE_ENABLE, /**< ROM write enable config */ + CFG_ID_ROM_SHADOW_ENABLE, /**< ROM shadow enable config */ + CFG_ID_DD_MODE, /**< Disk Drive mode config */ + CFG_ID_ISV_ADDRESS, /**< ISV address config */ + CFG_ID_BOOT_MODE, /**< Boot mode config */ + CFG_ID_SAVE_TYPE, /**< Save type config */ + CFG_ID_CIC_SEED, /**< CIC seed config */ + CFG_ID_TV_TYPE, /**< TV type config */ + CFG_ID_DD_SD_ENABLE, /**< Disk Drive SD enable config */ + CFG_ID_DD_DRIVE_TYPE, /**< Disk Drive type config */ + CFG_ID_DD_DISK_STATE, /**< Disk Drive disk state config */ + CFG_ID_BUTTON_STATE, /**< Button state config */ + CFG_ID_BUTTON_MODE, /**< Button mode config */ + CFG_ID_ROM_EXTENDED_ENABLE /**< ROM extended enable config */ } sc64_cfg_id_t; +/** @brief The SC64 Disk Drive Mode Enumeration. */ typedef enum { - DD_MODE_DISABLED = 0, - DD_MODE_REGS = 1, - DD_MODE_IPL = 2, - DD_MODE_FULL = 3 + DD_MODE_DISABLED = 0, /**< Disk Drive disabled */ + DD_MODE_REGS = 1, /**< Disk Drive registers mode */ + DD_MODE_IPL = 2, /**< Disk Drive IPL mode */ + DD_MODE_FULL = 3 /**< Disk Drive full mode */ } sc64_dd_mode_t; /** @brief The SC64 Boot Mode Enumeration. */ typedef enum { - BOOT_MODE_MENU = 0, - BOOT_MODE_ROM = 1, - BOOT_MODE_DDIPL = 2, - BOOT_MODE_DIRECT_ROM = 3, - BOOT_MODE_DIRECT_DDIPL = 4, + BOOT_MODE_MENU = 0, /**< Boot to menu */ + BOOT_MODE_ROM = 1, /**< Boot to ROM */ + BOOT_MODE_DDIPL = 2, /**< Boot to Disk Drive IPL */ + BOOT_MODE_DIRECT_ROM = 3, /**< Direct boot to ROM */ + BOOT_MODE_DIRECT_DDIPL = 4 /**< Direct boot to Disk Drive IPL */ } sc64_boot_mode_t; /** @brief The SC64 Save Type Enumeration. */ typedef enum { - SAVE_TYPE_NONE, - SAVE_TYPE_EEPROM_4KBIT, - SAVE_TYPE_EEPROM_16KBIT, - SAVE_TYPE_SRAM_256KBIT, - SAVE_TYPE_FLASHRAM_1MBIT, - SAVE_TYPE_SRAM_BANKED, - SAVE_TYPE_SRAM_1MBIT, + SAVE_TYPE_NONE, /**< No save type */ + SAVE_TYPE_EEPROM_4KBIT, /**< EEPROM 4Kbit */ + SAVE_TYPE_EEPROM_16KBIT, /**< EEPROM 16Kbit */ + SAVE_TYPE_SRAM_256KBIT, /**< SRAM 256Kbit */ + SAVE_TYPE_FLASHRAM_1MBIT, /**< FlashRAM 1Mbit */ + SAVE_TYPE_SRAM_BANKED, /**< SRAM Banked */ + SAVE_TYPE_SRAM_1MBIT /**< SRAM 1Mbit */ } sc64_save_type_t; +/** @brief The SC64 CIC Seed Enumeration. */ typedef enum { - CIC_SEED_AUTO = 0xFFFF + CIC_SEED_AUTO = 0xFFFF /**< Automatic CIC seed */ } sc64_cic_seed_t; +/** @brief The SC64 TV Type Enumeration. */ typedef enum { - TV_TYPE_PAL = 0, - TV_TYPE_NTSC = 1, - TV_TYPE_MPAL = 2, - TV_TYPE_PASSTHROUGH = 3 + TV_TYPE_PAL = 0, /**< PAL TV type */ + TV_TYPE_NTSC = 1, /**< NTSC TV type */ + TV_TYPE_MPAL = 2, /**< MPAL TV type */ + TV_TYPE_PASSTHROUGH = 3 /**< Passthrough TV type */ } sc64_tv_type_t; +/** @brief The SC64 Drive Type Enumeration. */ typedef enum { - DRIVE_TYPE_RETAIL, - DRIVE_TYPE_DEVELOPMENT, + DRIVE_TYPE_RETAIL, /**< Retail drive type */ + DRIVE_TYPE_DEVELOPMENT /**< Development drive type */ } sc64_drive_type_t; +/** @brief The SC64 Disk State Enumeration. */ typedef enum { - DISK_STATE_EJECTED, - DISK_STATE_INSERTED, - DISK_STATE_CHANGED, + DISK_STATE_EJECTED, /**< Disk ejected */ + DISK_STATE_INSERTED, /**< Disk inserted */ + DISK_STATE_CHANGED /**< Disk state changed */ } sc64_disk_state_t; +/** @brief The SC64 Button Mode Enumeration. */ typedef enum { - BUTTON_MODE_NONE, - BUTTON_MODE_N64_IRQ, - BUTTON_MODE_USB_PACKET, - BUTTON_MODE_DD_DISK_SWAP, + BUTTON_MODE_NONE, /**< No button mode */ + BUTTON_MODE_N64_IRQ, /**< N64 IRQ button mode */ + BUTTON_MODE_USB_PACKET, /**< USB packet button mode */ + BUTTON_MODE_DD_DISK_SWAP /**< Disk Drive disk swap button mode */ } sc64_button_mode_t; +/** @brief The SC64 Disk Mapping Structure. */ typedef struct { - int count; + int count; /**< Number of disks */ struct { - uint32_t thb_table; - uint32_t sector_table; - } disks[4]; + uint32_t thb_table; /**< THB table */ + uint32_t sector_table; /**< Sector table */ + } disks[4]; /**< Array of disks */ } sc64_disk_mapping_t; +/** + * @brief Lock the SC64. + */ +void sc64_ll_lock(void); -void sc64_ll_lock (void); -sc64_error_t sc64_ll_get_version (uint16_t *major, uint16_t *minor, uint32_t *revision); -sc64_error_t sc64_ll_get_config (sc64_cfg_id_t cfg, uint32_t *value); -sc64_error_t sc64_ll_set_config (sc64_cfg_id_t cfg, uint32_t value); -sc64_error_t sc64_ll_set_disk_mapping (sc64_disk_mapping_t *disk_mapping); -sc64_error_t sc64_ll_writeback_pending (bool *pending); -sc64_error_t sc64_ll_writeback_enable (void *address); -sc64_error_t sc64_ll_flash_wait_busy (void); -sc64_error_t sc64_ll_flash_get_erase_block_size (size_t *erase_block_size); -sc64_error_t sc64_ll_flash_erase_block (void *address); +/** + * @brief Get the SC64 version. + * + * @param major Pointer to store the major version. + * @param minor Pointer to store the minor version. + * @param revision Pointer to store the revision. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_get_version(uint16_t *major, uint16_t *minor, uint32_t *revision); + +/** + * @brief Get the SC64 configuration. + * + * @param cfg Configuration ID. + * @param value Pointer to store the configuration value. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_get_config(sc64_cfg_id_t cfg, uint32_t *value); + +/** + * @brief Set the SC64 configuration. + * + * @param cfg Configuration ID. + * @param value Configuration value. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_set_config(sc64_cfg_id_t cfg, uint32_t value); + +/** + * @brief Set the SC64 disk mapping. + * + * @param disk_mapping Pointer to the disk mapping structure. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_set_disk_mapping(sc64_disk_mapping_t *disk_mapping); + +/** + * @brief Check if writeback is pending. + * + * @param pending Pointer to store the pending status. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_writeback_pending(bool *pending); + +/** + * @brief Enable writeback. + * + * @param address Address to enable writeback. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_writeback_enable(void *address); + +/** + * @brief Wait for flash to be not busy. + * + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_flash_wait_busy(void); + +/** + * @brief Get the flash erase block size. + * + * @param erase_block_size Pointer to store the erase block size. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_flash_get_erase_block_size(size_t *erase_block_size); + +/** + * @brief Erase a flash block. + * + * @param address Address of the block to erase. + * @return sc64_error_t Error code. + */ +sc64_error_t sc64_ll_flash_erase_block(void *address); /** @} */ /* sc64 */ - -#endif +#endif // FLASHCART_SC64_LL_H__ diff --git a/src/libs/miniz b/src/libs/miniz index 0f4cbb8c..0c30a001 160000 --- a/src/libs/miniz +++ b/src/libs/miniz @@ -1 +1 @@ -Subproject commit 0f4cbb8c27a5dc48967e5a7d3b68f8666d8f96d4 +Subproject commit 0c30a001bc3c70770a8742ff00899e662f040c75 diff --git a/src/menu/actions.c b/src/menu/actions.c index 4cafbce7..659c134d 100644 --- a/src/menu/actions.c +++ b/src/menu/actions.c @@ -22,6 +22,8 @@ static void actions_clear (menu_t *menu) { menu->actions.options = false; menu->actions.settings = false; menu->actions.lz_context = false; + menu->actions.previous_tab = false; + menu->actions.next_tab = false; } static void actions_update_direction (menu_t *menu) { @@ -109,6 +111,10 @@ static void actions_update_buttons (menu_t *menu) { menu->actions.settings = true; } else if (pressed.l || pressed.z) { menu->actions.lz_context = true; + } else if (pressed.c_left) { + menu->actions.previous_tab = true; + } else if (pressed.c_right) { + menu->actions.next_tab = true; } } diff --git a/src/menu/actions.h b/src/menu/actions.h index f10a83ce..6b144529 100644 --- a/src/menu/actions.h +++ b/src/menu/actions.h @@ -7,14 +7,18 @@ #ifndef ACTIONS_H__ #define ACTIONS_H__ - #include "menu_state.h" /** - * @brief Initialize the actions module + * @brief Initialize the actions module. */ void actions_init (void); + +/** + * @brief Update the actions based on the current menu state. + * + * @param menu Pointer to the menu structure. + */ void actions_update (menu_t *menu); - -#endif +#endif /* ACTIONS_H__ */ diff --git a/src/menu/bookkeeping.c b/src/menu/bookkeeping.c new file mode 100644 index 00000000..82808266 --- /dev/null +++ b/src/menu/bookkeeping.c @@ -0,0 +1,289 @@ +/** + * @file bookkeeping.c + * @brief Bookkeeping functions for history and favorites + * @ingroup menu + */ + +#include +#include + +#include "bookkeeping.h" +#include "utils/fs.h" +#include "path.h" + +static char *history_path = NULL; +static path_t *empty_path = NULL; +static bookkeeping_t init; + +/** + * @brief Initialize the bookkeeping system with the specified path. + * + * @param path Path to the history file. + */ +void bookkeeping_init (char *path) { + if (history_path) { + free(history_path); + } + history_path = strdup(path); + empty_path = path_create(""); +} + +/** + * @brief Load a list of bookkeeping items from an INI file. + * + * @param list Pointer to the list of bookkeeping items. + * @param count Number of items in the list. + * @param ini Pointer to the INI file structure. + * @param group Name of the group in the INI file. + */ +void bookkeeping_ini_load_list(bookkeeping_item_t *list, int count, mini_t *ini, const char *group) { + char buf[64]; + for(int i = 0; i < count; i++) { + sprintf(buf, "%d_primary_path", i); + list[i].primary_path = path_create(mini_get_string(ini, group, buf, "")); + + sprintf(buf, "%d_secondary_path", i); + list[i].secondary_path = path_create(mini_get_string(ini, group, buf, "")); + + sprintf(buf, "%d_type", i); + list[i].bookkeeping_type = mini_get_int(ini, group, buf, BOOKKEEPING_TYPE_EMPTY); + } +} + +/** + * @brief Load the bookkeeping history and favorites from the history file. + * + * @param history Pointer to the bookkeeping structure. + */ +void bookkeeping_load (bookkeeping_t *history) { + if (!file_exists(history_path)) { + bookkeeping_save(&init); + } + + mini_t *bookkeeping_ini = mini_try_load(history_path); + bookkeeping_ini_load_list(history->history_items, HISTORY_COUNT, bookkeeping_ini, "history"); + bookkeeping_ini_load_list(history->favorite_items, FAVORITES_COUNT, bookkeeping_ini, "favorite"); + + mini_free(bookkeeping_ini); +} + +/** + * @brief Save a list of bookkeeping items to an INI file. + * + * @param list Pointer to the list of bookkeeping items. + * @param count Number of items in the list. + * @param ini Pointer to the INI file structure. + * @param group Name of the group in the INI file. + */ +static void bookkeeping_ini_save_list(bookkeeping_item_t *list, int count, mini_t *ini, const char *group) { + char buf[64]; + for(int i = 0; i < count; i++) { + sprintf(buf, "%d_primary_path", i); + path_t* path = list[i].primary_path; + mini_set_string(ini, group, buf, path != NULL ? path_get(path) : ""); + + sprintf(buf, "%d_secondary_path", i); + path = list[i].secondary_path; + mini_set_string(ini, group, buf, path != NULL ? path_get(path) : ""); + + sprintf(buf, "%d_type", i); + mini_set_int(ini, group, buf, list[i].bookkeeping_type); + } +} + +/** + * @brief Save the bookkeeping history and favorites to the history file. + * + * @param history Pointer to the bookkeeping structure. + */ +void bookkeeping_save (bookkeeping_t *history) { + mini_t *bookkeeping_ini = mini_create(history_path); + + bookkeeping_ini_save_list(history->history_items, HISTORY_COUNT, bookkeeping_ini, "history"); + bookkeeping_ini_save_list(history->favorite_items, FAVORITES_COUNT, bookkeeping_ini, "favorite"); + + mini_save(bookkeeping_ini, MINI_FLAGS_SKIP_EMPTY_GROUPS); + mini_free(bookkeeping_ini); +} + +/** + * @brief Check if two bookkeeping items match. + * + * @param left Pointer to the first bookkeeping item. + * @param right Pointer to the second bookkeeping item. + * @return true if the items match, false otherwise. + */ +static bool bookkeeping_item_match(bookkeeping_item_t *left, bookkeeping_item_t *right) { + if(left != NULL && right != NULL) { + return path_are_match(left->primary_path, right->primary_path) && path_are_match(left->secondary_path, right->secondary_path) && left->bookkeeping_type == right->bookkeeping_type; + } + + return false; +} + +/** + * @brief Clear a bookkeeping item. + * + * @param item Pointer to the bookkeeping item. + * @param leave_null Flag indicating whether to leave the paths as NULL. + */ +static void bookkeeping_clear_item(bookkeeping_item_t *item, bool leave_null) { + if(item->primary_path != NULL){ + path_free(item->primary_path); + + if(leave_null) { + item->primary_path = NULL; + } else { + item->primary_path = path_create(""); + } + } + if(item->secondary_path != NULL){ + path_free(item->secondary_path); + + if(leave_null) { + item->secondary_path = NULL; + } else { + item->secondary_path = path_create(""); + } + } + item->bookkeeping_type = BOOKKEEPING_TYPE_EMPTY; +} + +/** + * @brief Copy a bookkeeping item. + * + * @param source Pointer to the source bookkeeping item. + * @param destination Pointer to the destination bookkeeping item. + */ +static void bookkeeping_copy_item(bookkeeping_item_t *source, bookkeeping_item_t *destination) { + bookkeeping_clear_item(destination, true); + + destination->primary_path = source->primary_path != NULL ? path_clone(source->primary_path) : path_create(""); + destination->secondary_path = source->secondary_path != NULL ? path_clone(source->secondary_path) : path_create(""); + destination->bookkeeping_type = source->bookkeeping_type; +} + +/** + * @brief Move bookkeeping items down in the list. + * + * @param list Pointer to the list of bookkeeping items. + * @param start Start index. + * @param end End index. + */ +static void bookkeeping_move_items_down(bookkeeping_item_t *list, int start, int end) { + int current = end; + + do { + if(current <= start || current < 0) { + break; + } + + bookkeeping_copy_item(&list[current - 1], &list[current]); + current--; + } while(true); +} + +/** + * @brief Move bookkeeping items up in the list. + * + * @param list Pointer to the list of bookkeeping items. + * @param start Start index. + * @param end End index. + */ +static void bookkeeping_move_items_up(bookkeeping_item_t *list, int start, int end) { + int current = start; + + do { + if(current >= end) { + break; + } + + bookkeeping_copy_item(&list[current + 1], &list[current]); + current++; + } while(true); +} + +/** + * @brief Insert a bookkeeping item at the top of the list. + * + * @param list Pointer to the list of bookkeeping items. + * @param count Number of items in the list. + * @param new_item Pointer to the new bookkeeping item. + */ +static void bookkeeping_insert_top(bookkeeping_item_t *list, int count, bookkeeping_item_t *new_item) { + // if it matches the top of the list already then nothing to do + if(bookkeeping_item_match(&list[0], new_item)) { + return; + } + + // if the top isn't empty then we need to move things around + if(list[0].bookkeeping_type != BOOKKEEPING_TYPE_EMPTY) { + int found_at = -1; + for(int i = 1; i < count; i++) { + if(bookkeeping_item_match(&list[i], new_item)){ + found_at = i; + break; + } + } + + if(found_at == -1) { + bookkeeping_move_items_down(list, 0, count - 1); + } else { + bookkeeping_move_items_down(list, 0, found_at); + } + } + + bookkeeping_copy_item(new_item, &list[0]); +} + +/** + * @brief Add a new item to the bookkeeping history. + * + * @param bookkeeping Pointer to the bookkeeping structure. + * @param primary_path Pointer to the primary path. + * @param secondary_path Pointer to the secondary path. + * @param type The type of the bookkeeping item. + */ +void bookkeeping_history_add(bookkeeping_t *bookkeeping, path_t *primary_path, path_t *secondary_path, bookkeeping_item_types_t type) { + bookkeeping_item_t new_item = { + .primary_path = primary_path, + .secondary_path = secondary_path, + .bookkeeping_type = type + }; + + bookkeeping_insert_top(bookkeeping->history_items, HISTORY_COUNT, &new_item); + bookkeeping_save(bookkeeping); +} + +/** + * @brief Add a new item to the bookkeeping favorites. + * + * @param bookkeeping Pointer to the bookkeeping structure. + * @param primary_path Pointer to the primary path. + * @param secondary_path Pointer to the secondary path. + * @param type The type of the bookkeeping item. + */ +void bookkeeping_favorite_add(bookkeeping_t *bookkeeping, path_t *primary_path, path_t *secondary_path, bookkeeping_item_types_t type) { + bookkeeping_item_t new_item = { + .primary_path = primary_path, + .secondary_path = secondary_path, + .bookkeeping_type = type + }; + + bookkeeping_insert_top(bookkeeping->favorite_items, FAVORITES_COUNT, &new_item); + bookkeeping_save(bookkeeping); +} + +/** + * @brief Remove an item from the bookkeeping favorites. + * + * @param bookkeeping Pointer to the bookkeeping structure. + * @param selection Index of the item to remove. + */ +void bookkeeping_favorite_remove(bookkeeping_t *bookkeeping, int selection) { + if(bookkeeping->favorite_items[selection].bookkeeping_type != BOOKKEEPING_TYPE_EMPTY) { + bookkeeping_move_items_up(bookkeeping->favorite_items, selection, FAVORITES_COUNT - 1); + bookkeeping_clear_item(&bookkeeping->favorite_items[FAVORITES_COUNT - 1], false); + bookkeeping_save(bookkeeping); + } +} \ No newline at end of file diff --git a/src/menu/bookkeeping.h b/src/menu/bookkeeping.h new file mode 100644 index 00000000..9ed3edff --- /dev/null +++ b/src/menu/bookkeeping.h @@ -0,0 +1,84 @@ +/** + * @file bookkeeping.h + * @brief Bookkeeping of loaded ROMs. + * @ingroup menu + */ + +#ifndef BOOKKEEPING_H__ +#define BOOKKEEPING_H__ + +#include "path.h" + +#define FAVORITES_COUNT 8 /**< Maximum number of favorite items */ +#define HISTORY_COUNT 8 /**< Maximum number of history items */ + +/** @brief Bookkeeping item types enumeration */ +typedef enum { + BOOKKEEPING_TYPE_EMPTY, /**< Empty item */ + BOOKKEEPING_TYPE_ROM, /**< ROM item */ + BOOKKEEPING_TYPE_DISK, /**< Disk item */ +} bookkeeping_item_types_t; + +/** @brief Bookkeeping item structure */ +typedef struct { + path_t *primary_path; /**< Primary path */ + path_t *secondary_path; /**< Secondary path */ + bookkeeping_item_types_t bookkeeping_type; /**< Bookkeeping item type */ +} bookkeeping_item_t; + +/** @brief ROM bookkeeping structure */ +typedef struct { + bookkeeping_item_t history_items[HISTORY_COUNT]; /**< History items */ + bookkeeping_item_t favorite_items[FAVORITES_COUNT]; /**< Favorite items */ +} bookkeeping_t; + +/** + * @brief Initialize ROM bookkeeping path. + * + * @param path The path to initialize. + */ +void bookkeeping_init(char *path); + +/** + * @brief Load ROM bookkeeping. + * + * @param history Pointer to the bookkeeping structure to load. + */ +void bookkeeping_load(bookkeeping_t *history); + +/** + * @brief Save ROM bookkeeping. + * + * @param history Pointer to the bookkeeping structure to save. + */ +void bookkeeping_save(bookkeeping_t *history); + +/** + * @brief Add a ROM to the history. + * + * @param bookkeeping The bookkeeping structure. + * @param primary_path The primary path of the ROM. + * @param secondary_path The secondary path of the ROM. + * @param type The type of the bookkeeping item. + */ +void bookkeeping_history_add(bookkeeping_t *bookkeeping, path_t *primary_path, path_t *secondary_path, bookkeeping_item_types_t type); + +/** + * @brief Add a ROM to the favorites. + * + * @param bookkeeping The bookkeeping structure. + * @param primary_path The primary path of the ROM. + * @param secondary_path The secondary path of the ROM. + * @param type The type of the bookkeeping item. + */ +void bookkeeping_favorite_add(bookkeeping_t *bookkeeping, path_t *primary_path, path_t *secondary_path, bookkeeping_item_types_t type); + +/** + * @brief Remove a ROM from the favorites. + * + * @param bookkeeping The bookkeeping structure. + * @param selection The index of the favorite item to remove. + */ +void bookkeeping_favorite_remove(bookkeeping_t *bookkeeping, int selection); + +#endif /* BOOKKEEPING_H__ */ diff --git a/src/menu/cart_load.c b/src/menu/cart_load.c index 054102ed..2fa52b2b 100644 --- a/src/menu/cart_load.c +++ b/src/menu/cart_load.c @@ -1,7 +1,11 @@ +/** + * @file cart_load.c + * @brief Cart loading functions + * @ingroup menu + */ + #include - #include - #include "cart_load.h" #include "path.h" #include "utils/fs.h" @@ -17,13 +21,23 @@ #define EMU_LOCATION "/menu/emulators" #endif - +/** + * @brief Check if the 64DD is connected. + * + * @return true if the 64DD is connected, false otherwise. + */ static bool is_64dd_connected (void) { bool is_64dd_io_present = ((io_read(0x05000540) & 0x0000FFFF) == 0x0000); bool is_64dd_ipl_present = (io_read(0x06001010) == 0x2129FFF8); return (is_64dd_io_present || is_64dd_ipl_present); } +/** + * @brief Create the saves subdirectory. + * + * @param path Pointer to the path structure. + * @return true if an error occurred, false otherwise. + */ static bool create_saves_subdirectory (path_t *path) { path_t *save_folder_path = path_clone(path); path_pop(save_folder_path); @@ -33,6 +47,12 @@ static bool create_saves_subdirectory (path_t *path) { return error; } +/** + * @brief Convert the ROM save type to the flashcart save type. + * + * @param save_type The ROM save type. + * @return flashcart_save_type_t The flashcart save type. + */ static flashcart_save_type_t convert_save_type (rom_save_type_t save_type) { switch (save_type) { case SAVE_TYPE_EEPROM_4KBIT: return FLASHCART_SAVE_TYPE_EEPROM_4KBIT; @@ -46,19 +66,25 @@ static flashcart_save_type_t convert_save_type (rom_save_type_t save_type) { } } - +/** + * @brief Convert the cart load error code to a human-readable message. + * + * @param err The cart load error code. + * @return char* The error message. + */ char *cart_load_convert_error_message (cart_load_err_t err) { switch (err) { case CART_LOAD_OK: return "Cart load OK"; case CART_LOAD_ERR_ROM_LOAD_FAIL: return "Error occured during ROM loading"; case CART_LOAD_ERR_SAVE_LOAD_FAIL: return "Error occured during save loading"; + case CART_LOAD_ERR_BOOT_MODE_FAIL: return "Error occured during boot mode setting"; case CART_LOAD_ERR_64DD_PRESENT: return "64DD accessory is connected to the N64"; case CART_LOAD_ERR_64DD_IPL_NOT_FOUND: return "Required 64DD IPL file was not found"; - case CART_LOAD_ERR_64DD_IPL_LOAD_FAIL: return "Error occured during 64DD IPL loading"; - case CART_LOAD_ERR_64DD_DISK_LOAD_FAIL: return "Error occured during 64DD disk loading"; + case CART_LOAD_ERR_64DD_IPL_LOAD_FAIL: return "Error occurred during 64DD IPL loading"; + case CART_LOAD_ERR_64DD_DISK_LOAD_FAIL: return "Error occurred during 64DD disk loading"; case CART_LOAD_ERR_EMU_NOT_FOUND: return "Required emulator file was not found"; - case CART_LOAD_ERR_EMU_LOAD_FAIL: return "Error occured during emulator ROM loading"; - case CART_LOAD_ERR_EMU_ROM_LOAD_FAIL: return "Error occured during emulated ROM loading"; + case CART_LOAD_ERR_EMU_LOAD_FAIL: return "Error occurred during emulator ROM loading"; + case CART_LOAD_ERR_EMU_ROM_LOAD_FAIL: return "Error occurred during emulated ROM loading"; case CART_LOAD_ERR_CREATE_SAVES_SUBDIR_FAIL: return "Couldn't create saves subdirectory"; case CART_LOAD_ERR_EXP_PAK_NOT_FOUND: return "Mandatory Expansion Pak accessory was not found"; case CART_LOAD_ERR_FUNCTION_NOT_SUPPORTED: return "Your flashcart doesn't support required functionality"; @@ -66,6 +92,13 @@ char *cart_load_convert_error_message (cart_load_err_t err) { } } +/** + * @brief Load an N64 ROM and its save file. + * + * @param menu Pointer to the menu structure. + * @param progress Progress callback function. + * @return cart_load_err_t Error code. + */ cart_load_err_t cart_load_n64_rom_and_save (menu_t *menu, flashcart_progress_callback_t progress) { path_t *path = path_clone(menu->load.rom_path); @@ -93,11 +126,29 @@ cart_load_err_t cart_load_n64_rom_and_save (menu_t *menu, flashcart_progress_cal return CART_LOAD_ERR_SAVE_LOAD_FAIL; } + if (menu->settings.rom_fast_reboot_enabled) { + if (!flashcart_has_feature(FLASHCART_FEATURE_ROM_REBOOT_FAST)) { + return CART_LOAD_ERR_FUNCTION_NOT_SUPPORTED; + } + menu->flashcart_err = flashcart_set_next_boot_mode(FLASHCART_REBOOT_MODE_ROM); + if (menu->flashcart_err != FLASHCART_OK) { + path_free(path); + return CART_LOAD_ERR_BOOT_MODE_FAIL; + } + } + path_free(path); return CART_LOAD_OK; } +/** + * @brief Load the 64DD IPL and disk. + * + * @param menu Pointer to the menu structure. + * @param progress Progress callback function. + * @return cart_load_err_t Error code. + */ cart_load_err_t cart_load_64dd_ipl_and_disk (menu_t *menu, flashcart_progress_callback_t progress) { if (!flashcart_has_feature(FLASHCART_FEATURE_64DD)) { return CART_LOAD_ERR_FUNCTION_NOT_SUPPORTED; @@ -152,6 +203,14 @@ cart_load_err_t cart_load_64dd_ipl_and_disk (menu_t *menu, flashcart_progress_ca return CART_LOAD_OK; } +/** + * @brief Load an emulator and its ROM. + * + * @param menu Pointer to the menu structure. + * @param emu_type The type of emulator to load. + * @param progress Progress callback function. + * @return cart_load_err_t Error code. + */ cart_load_err_t cart_load_emulator (menu_t *menu, cart_load_emu_type_t emu_type, flashcart_progress_callback_t progress) { path_t *path = path_init(menu->storage_prefix, EMU_LOCATION); @@ -170,11 +229,11 @@ cart_load_err_t cart_load_emulator (menu_t *menu, cart_load_emu_type_t emu_type, break; case CART_LOAD_EMU_TYPE_GAMEBOY: path_push(path, "gb.v64"); - save_type = FLASHCART_SAVE_TYPE_FLASHRAM_1MBIT; + save_type = FLASHCART_SAVE_TYPE_SRAM_BANKED; //FLASHCART_SAVE_TYPE_FLASHRAM_NONCOMPLIANT; break; case CART_LOAD_EMU_TYPE_GAMEBOY_COLOR: path_push(path, "gbc.v64"); - save_type = FLASHCART_SAVE_TYPE_FLASHRAM_1MBIT; + save_type = FLASHCART_SAVE_TYPE_SRAM_BANKED; //FLASHCART_SAVE_TYPE_FLASHRAM_NONCOMPLIANT; break; case CART_LOAD_EMU_TYPE_SEGA_GENERIC_8BIT: path_push(path, "smsPlus64.z64"); diff --git a/src/menu/cart_load.h b/src/menu/cart_load.h index ad4d34a1..ec37cd0f 100644 --- a/src/menu/cart_load.h +++ b/src/menu/cart_load.h @@ -7,7 +7,6 @@ #ifndef CART_LOAD_H__ #define CART_LOAD_H__ - #include "disk_info.h" #include "flashcart/flashcart.h" #include "menu_state.h" @@ -21,6 +20,8 @@ typedef enum { CART_LOAD_ERR_ROM_LOAD_FAIL, /** @brief Failed to load the save correctly. */ CART_LOAD_ERR_SAVE_LOAD_FAIL, + /** @brief Failed to set the next boot mode. */ + CART_LOAD_ERR_BOOT_MODE_FAIL, /** @brief The 64DD is available for use. */ CART_LOAD_ERR_64DD_PRESENT, /** @brief Failed to find the 64DD IPL (BIOS) file. */ @@ -33,6 +34,7 @@ typedef enum { CART_LOAD_ERR_EMU_NOT_FOUND, /** @brief Failed to load the emulator required. */ CART_LOAD_ERR_EMU_LOAD_FAIL, + /** @brief Failed to load the emulator ROM. */ CART_LOAD_ERR_EMU_ROM_LOAD_FAIL, /** @brief Failed to create the save sub-directory. */ CART_LOAD_ERR_CREATE_SAVES_SUBDIR_FAIL, @@ -58,11 +60,40 @@ typedef enum { CART_LOAD_EMU_TYPE_FAIRCHILD_CHANNELF, } cart_load_emu_type_t; +/** + * @brief Convert a cart load error code to a human-readable error message. + * + * @param err The cart load error code. + * @return char* The human-readable error message. + */ +char *cart_load_convert_error_message(cart_load_err_t err); -char *cart_load_convert_error_message (cart_load_err_t err); -cart_load_err_t cart_load_n64_rom_and_save (menu_t *menu, flashcart_progress_callback_t progress); -cart_load_err_t cart_load_64dd_ipl_and_disk (menu_t *menu, flashcart_progress_callback_t progress); -cart_load_err_t cart_load_emulator (menu_t *menu, cart_load_emu_type_t emu_type, flashcart_progress_callback_t progress); +/** + * @brief Load an N64 ROM and its save data. + * + * @param menu Pointer to the menu structure. + * @param progress Callback function for progress updates. + * @return cart_load_err_t Error code. + */ +cart_load_err_t cart_load_n64_rom_and_save(menu_t *menu, flashcart_progress_callback_t progress); +/** + * @brief Load the 64DD IPL (BIOS) and disk. + * + * @param menu Pointer to the menu structure. + * @param progress Callback function for progress updates. + * @return cart_load_err_t Error code. + */ +cart_load_err_t cart_load_64dd_ipl_and_disk(menu_t *menu, flashcart_progress_callback_t progress); -#endif +/** + * @brief Load an emulator and its ROM. + * + * @param menu Pointer to the menu structure. + * @param emu_type The type of emulator to load. + * @param progress Callback function for progress updates. + * @return cart_load_err_t Error code. + */ +cart_load_err_t cart_load_emulator(menu_t *menu, cart_load_emu_type_t emu_type, flashcart_progress_callback_t progress); + +#endif /* CART_LOAD_H__ */ diff --git a/src/menu/disk_info.c b/src/menu/disk_info.c index 5c2c7388..2affc184 100644 --- a/src/menu/disk_info.c +++ b/src/menu/disk_info.c @@ -1,3 +1,9 @@ +/** + * @file disk_info.c + * @brief Disk Information component implementation + * @ingroup menu + */ + #include #include #include @@ -6,7 +12,6 @@ #include "disk_info.h" #include "utils/fs.h" - #define SECTORS_PER_BLOCK (85) #define DISK_ZONES (16) #define DISK_BAD_TRACKS_PER_ZONE (12) @@ -27,7 +32,6 @@ #define GET_U32(b) (((b)[0] << 24) | ((b)[1] << 16) | ((b)[2] << 8) | (b)[3]) - static const int tracks_per_zone[DISK_ZONES] = { 158, 158, 149, 149, 149, 149, 149, 114, 158, 158, 149, 149, 149, 149, 149, 114 }; @@ -38,7 +42,14 @@ static const int disk_id_lbas[DISK_ID_LBA_COUNT] = { 15, 14 }; - +/** + * @brief Load a system area LBA from the disk. + * + * @param f File pointer to the disk image. + * @param lba Logical block address to load. + * @param buffer Buffer to store the loaded data. + * @return true if an error occurred, false otherwise. + */ static bool load_system_area_lba (FILE *f, int lba, uint8_t *buffer) { if (lba >= SYSTEM_AREA_LBA_COUNT) { return true; @@ -52,6 +63,13 @@ static bool load_system_area_lba (FILE *f, int lba, uint8_t *buffer) { return false; } +/** + * @brief Verify the integrity of a system area LBA. + * + * @param buffer Buffer containing the LBA data. + * @param sector_length Length of each sector in the LBA. + * @return true if the LBA is valid, false otherwise. + */ static bool verify_system_area_lba (uint8_t *buffer, int sector_length) { for (int sector = 1; sector < SECTORS_PER_BLOCK; sector++) { for (int i = 0; i < sector_length; i++) { @@ -63,6 +81,12 @@ static bool verify_system_area_lba (uint8_t *buffer, int sector_length) { return true; } +/** + * @brief Verify the integrity of a system data LBA. + * + * @param buffer Buffer containing the LBA data. + * @return true if the LBA is valid, false otherwise. + */ static bool verify_system_data_lba (uint8_t *buffer) { return ( (buffer[4] == 0x10) && @@ -72,6 +96,13 @@ static bool verify_system_data_lba (uint8_t *buffer) { ); } +/** + * @brief Set the defect tracks for the disk. + * + * @param buffer Buffer containing the defect track data. + * @param disk_info Pointer to the disk information structure. + * @return true if the defect tracks were set successfully, false otherwise. + */ static bool set_defect_tracks (uint8_t *buffer, disk_info_t *disk_info) { for (int head_zone = 0; head_zone < DISK_ZONES; head_zone++) { uint8_t start = ((head_zone == 0) ? 0 : buffer[7 + head_zone]); @@ -90,6 +121,11 @@ static bool set_defect_tracks (uint8_t *buffer, disk_info_t *disk_info) { return true; } +/** + * @brief Update the bad system area LBAs for the disk. + * + * @param disk_info Pointer to the disk information structure. + */ static void update_bad_system_area_lbas (disk_info_t *disk_info) { if (disk_info->region == DISK_REGION_DEVELOPMENT) { disk_info->bad_system_area_lbas[0] = true; @@ -109,6 +145,13 @@ static void update_bad_system_area_lbas (disk_info_t *disk_info) { } } +/** + * @brief Load and verify the system data LBA from the disk. + * + * @param f File pointer to the disk image. + * @param disk_info Pointer to the disk information structure. + * @return disk_err_t Error code. + */ static disk_err_t load_and_verify_system_data_lba (FILE *f, disk_info_t *disk_info) { uint8_t buffer[SYSTEM_AREA_LBA_LENGTH]; int sector_length; @@ -151,6 +194,13 @@ static disk_err_t load_and_verify_system_data_lba (FILE *f, disk_info_t *disk_in return valid_system_data_lba_found ? DISK_OK : DISK_ERR_INVALID; } +/** + * @brief Load and verify the disk ID LBA from the disk. + * + * @param f File pointer to the disk image. + * @param disk_info Pointer to the disk information structure. + * @return disk_err_t Error code. + */ static disk_err_t load_and_verify_disk_id_lba (FILE *f, disk_info_t *disk_info) { uint8_t buffer[SYSTEM_AREA_LBA_LENGTH]; @@ -175,7 +225,13 @@ static disk_err_t load_and_verify_disk_id_lba (FILE *f, disk_info_t *disk_info) return valid_disk_id_lba_found ? DISK_OK : DISK_ERR_INVALID; } - +/** + * @brief Load the disk information from the specified path. + * + * @param path Pointer to the path structure. + * @param disk_info Pointer to the disk information structure. + * @return disk_err_t Error code. + */ disk_err_t disk_info_load (path_t *path, disk_info_t *disk_info) { FILE *f; disk_err_t err; diff --git a/src/menu/hdmi.h b/src/menu/hdmi.h index ce59b5a4..5ca4130d 100644 --- a/src/menu/hdmi.h +++ b/src/menu/hdmi.h @@ -1,12 +1,29 @@ +/** + * @file hdmi.h + * @brief Header file for HDMI-related functions. + * @ingroup menu + */ + #ifndef HDMI_H__ #define HDMI_H__ - #include "boot/boot.h" +/** + * @brief Clears the game ID from the HDMI interface. + * + * This function clears the current game ID from the HDMI interface. + */ +void hdmi_clear_game_id(void); -void hdmi_clear_game_id (void); -void hdmi_send_game_id (boot_params_t *boot_params); +/** + * @brief Sends the game ID to the HDMI interface. + * + * This function sends the provided game ID to the HDMI interface using the + * specified boot parameters. + * + * @param boot_params A pointer to the boot parameters containing the game ID. + */ +void hdmi_send_game_id(boot_params_t *boot_params); - -#endif +#endif // HDMI_H__ diff --git a/src/menu/menu.c b/src/menu/menu.c index 48d59166..f0213df5 100644 --- a/src/menu/menu.c +++ b/src/menu/menu.c @@ -1,3 +1,9 @@ +/** + * @file menu.c + * @brief Menu system implementation + * @ingroup menu + */ + #include #include #include @@ -19,23 +25,32 @@ #include "utils/fs.h" #include "views/views.h" +#define MENU_DIRECTORY "/menu" +#define MENU_SETTINGS_FILE "config.ini" +#define MENU_CUSTOM_FONT_FILE "custom.font64" +#define MENU_ROM_LOAD_HISTORY_FILE "history.ini" -#define MENU_DIRECTORY "/menu" -#define MENU_SETTINGS_FILE "config.ini" -#define MENU_CUSTOM_FONT_FILE "custom.font64" - -#define MENU_CACHE_DIRECTORY "cache" -#define BACKGROUND_CACHE_FILE "background.data" - -#define INTERLACED (true) -#define FPS_LIMIT (30.0f) +#define MENU_CACHE_DIRECTORY "cache" +#define BACKGROUND_CACHE_FILE "background.data" +#define FPS_LIMIT (30.0f) static menu_t *menu; + +/** FIXME: These are used for overriding libdragon's global variables for TV type to allow PAL60 compatibility + * with hardware mods that don't really understand the VI output. + **/ static tv_type_t tv_type; +extern int __boot_tvtype; +/* -- */ -extern tv_type_t __boot_tvtype; +static bool interlaced = true; +/** + * @brief Initialize the menu system. + * + * @param boot_params Pointer to the boot parameters structure. + */ static void menu_init (boot_params_t *boot_params) { menu = calloc(1, sizeof(menu_t)); assert(menu != NULL); @@ -72,19 +87,32 @@ static void menu_init (boot_params_t *boot_params) { settings_load(&menu->settings); path_pop(path); + path_push(path, MENU_ROM_LOAD_HISTORY_FILE); + bookkeeping_init(path_get(path)); + bookkeeping_load(&menu->bookkeeping); + menu->load.load_history = -1; + menu->load.load_favorite = -1; + path_pop(path); + + if (menu->settings.pal60_compatibility_mode) { // hardware VI mods that dont really understand the output + tv_type = get_tv_type(); + if (tv_type == TV_PAL && menu->settings.pal60_enabled) { + // HACK: Set TV type to NTSC, so PAL console would output 60 Hz signal instead. + __boot_tvtype = (int)TV_NTSC; + } + } + + // Force interlacing off in VI settings for TVs and other devices that struggle with interlaced video input. + interlaced = !menu->settings.force_progressive_scan; + resolution_t resolution = { .width = 640, .height = 480, - .interlaced = INTERLACED ? INTERLACE_HALF : INTERLACE_OFF, + .interlaced = interlaced ? INTERLACE_HALF : INTERLACE_OFF, + .pal60 = menu->settings.pal60_enabled, // this may be overridden by the PAL60 compatibility mode. }; - tv_type = get_tv_type(); - if (tv_type == TV_PAL && menu->settings.pal60_enabled) { - // HACK: Set TV type to NTSC, so PAL console would output 60 Hz signal instead. - __boot_tvtype = TV_NTSC; - } - - display_init(resolution, DEPTH_16_BPP, 2, GAMMA_NONE, INTERLACED ? FILTERS_DISABLED : FILTERS_RESAMPLE); + display_init(resolution, DEPTH_16_BPP, 2, GAMMA_NONE, interlaced ? FILTERS_DISABLED : FILTERS_RESAMPLE); display_set_fps_limit(FPS_LIMIT); path_push(path, MENU_CUSTOM_FONT_FILE); @@ -108,8 +136,12 @@ static void menu_init (boot_params_t *boot_params) { } } +/** + * @brief Deinitialize the menu system. + * + * @param menu Pointer to the menu structure. + */ static void menu_deinit (menu_t *menu) { - __boot_tvtype = tv_type; hdmi_send_game_id(menu->boot_params); ui_components_background_free(); @@ -136,10 +168,13 @@ static void menu_deinit (menu_t *menu) { flashcart_deinit(); } +/** + * @brief View structure containing initialization and display functions. + */ typedef const struct { - menu_mode_t id; - void (*init) (menu_t *menu); - void (*show) (menu_t *menu, surface_t *display); + menu_mode_t id; /**< View ID */ + void (*init) (menu_t *menu); /**< Initialization function */ + void (*show) (menu_t *menu, surface_t *display); /**< Display function */ } view_t; static view_t menu_views[] = { @@ -159,8 +194,16 @@ static view_t menu_views[] = { { MENU_MODE_LOAD_EMULATOR, view_load_emulator_init, view_load_emulator_display }, { MENU_MODE_ERROR, view_error_init, view_error_display }, { MENU_MODE_FAULT, view_fault_init, view_fault_display }, + { MENU_MODE_FAVORITE, view_favorite_init, view_favorite_display }, + { MENU_MODE_HISTORY, view_history_init, view_history_display } }; +/** + * @brief Get the view structure for the specified menu mode. + * + * @param id The menu mode ID. + * @return view_t* Pointer to the view structure. + */ static view_t *menu_get_view (menu_mode_t id) { for (int i = 0; i < sizeof(menu_views) / sizeof(view_t); i++) { if (menu_views[i].id == id) { @@ -170,7 +213,11 @@ static view_t *menu_get_view (menu_mode_t id) { return NULL; } - +/** + * @brief Run the menu system. + * + * @param boot_params Pointer to the boot parameters structure. + */ void menu_run (boot_params_t *boot_params) { menu_init(boot_params); diff --git a/src/menu/menu.h b/src/menu/menu.h index a5cd14d4..01ded861 100644 --- a/src/menu/menu.h +++ b/src/menu/menu.h @@ -1,17 +1,22 @@ /** * @file menu.h * @brief Menu Subsystem - * @ingroup menu + * @ingroup menu */ #ifndef MENU_H__ #define MENU_H__ - #include "boot/boot.h" +/** + * @brief Runs the menu subsystem. + * + * This function initializes and runs the menu subsystem using the provided + * boot parameters. + * + * @param boot_params A pointer to the boot parameters. + */ +void menu_run(boot_params_t *boot_params); -void menu_run (boot_params_t *boot_params); - - -#endif +#endif // MENU_H__ diff --git a/src/menu/menu_state.h b/src/menu/menu_state.h index b34b6d1a..1be91bb7 100644 --- a/src/menu/menu_state.h +++ b/src/menu/menu_state.h @@ -16,6 +16,7 @@ #include "path.h" #include "rom_info.h" #include "settings.h" +#include "bookkeeping.h" /** @brief Menu mode enumeration */ @@ -38,6 +39,8 @@ typedef enum { MENU_MODE_ERROR, MENU_MODE_FAULT, MENU_MODE_BOOT, + MENU_MODE_FAVORITE, + MENU_MODE_HISTORY } menu_mode_t; /** @brief File entry type enumeration */ @@ -67,6 +70,7 @@ typedef struct { const char *storage_prefix; settings_t settings; + bookkeeping_t bookkeeping; boot_params_t *boot_params; char *error_message; @@ -86,6 +90,8 @@ typedef struct { bool options; bool settings; bool lz_context; + bool previous_tab; + bool next_tab; } actions; struct { @@ -103,6 +109,8 @@ typedef struct { rom_info_t rom_info; path_t *disk_path; disk_info_t disk_info; + int load_history; + int load_favorite; bool combined_disk_rom; } load; diff --git a/src/menu/mp3_player.c b/src/menu/mp3_player.c index b41a170c..87a110d5 100644 --- a/src/menu/mp3_player.c +++ b/src/menu/mp3_player.c @@ -1,3 +1,9 @@ +/** + * @file mp3_player.c + * @brief MP3 Player component implementation + * @ingroup ui_components + */ + #include #include @@ -13,34 +19,34 @@ #include #include - #define SEEK_PREDECODE_FRAMES (5) - /** @brief MP3 File Information Structure. */ typedef struct { - bool loaded; + bool loaded; /**< Indicates if the MP3 file is loaded */ - FILE *f; - size_t file_size; - size_t data_start; - uint8_t buffer[16 * 1024]; - uint8_t *buffer_ptr; - size_t buffer_left; + FILE *f; /**< File pointer */ + size_t file_size; /**< Size of the file */ + size_t data_start; /**< Start position of the data */ + uint8_t buffer[16 * 1024]; /**< Buffer for reading data */ + uint8_t *buffer_ptr; /**< Pointer to the current position in the buffer */ + size_t buffer_left; /**< Amount of data left in the buffer */ - mp3dec_t dec; - mp3dec_frame_info_t info; + mp3dec_t dec; /**< MP3 decoder */ + mp3dec_frame_info_t info; /**< MP3 frame information */ - int seek_predecode_frames; - float duration; - float bitrate; + int seek_predecode_frames; /**< Number of frames to pre-decode when seeking */ + float duration; /**< Duration of the MP3 file */ + float bitrate; /**< Bitrate of the MP3 file */ - waveform_t wave; + waveform_t wave; /**< Waveform structure for playback */ } mp3player_t; static mp3player_t *p = NULL; - +/** + * @brief Reset the MP3 decoder. + */ static void mp3player_reset_decoder (void) { mp3dec_init(&p->dec); p->seek_predecode_frames = 0; @@ -48,6 +54,9 @@ static void mp3player_reset_decoder (void) { p->buffer_left = 0; } +/** + * @brief Fill the buffer with data from the MP3 file. + */ static void mp3player_fill_buffer (void) { if (feof(p->f)) { return; @@ -65,6 +74,15 @@ static void mp3player_fill_buffer (void) { p->buffer_left += fread(p->buffer + p->buffer_left, 1, sizeof(p->buffer) - p->buffer_left, p->f); } +/** + * @brief Read waveform data for playback. + * + * @param ctx Context pointer. + * @param sbuf Sample buffer. + * @param wpos Write position. + * @param wlen Write length. + * @param seeking Indicates if seeking is in progress. + */ static void mp3player_wave_read (void *ctx, samplebuffer_t *sbuf, int wpos, int wlen, bool seeking) { while (wlen > 0) { mp3player_fill_buffer(); @@ -100,6 +118,11 @@ static void mp3player_wave_read (void *ctx, samplebuffer_t *sbuf, int wpos, int } } +/** + * @brief Calculate the duration of the MP3 file. + * + * @param samples Number of samples. + */ static void mp3player_calculate_duration (int samples) { uint32_t frames; int delay, padding; @@ -114,7 +137,9 @@ static void mp3player_calculate_duration (int samples) { } } - +/** + * @brief Initialize the MP3 player mixer. + */ void mp3player_mixer_init (void) { // NOTE: Deliberately setting max_frequency to twice of actual maximum samplerate of mp3 file. // It's tricking mixer into creating buffer long enough for appending data created by mp3dec_decode_frame. @@ -122,6 +147,11 @@ void mp3player_mixer_init (void) { mixer_ch_set_limits(SOUND_MP3_PLAYER_CHANNEL, 16, 96000, 0); } +/** + * @brief Initialize the MP3 player. + * + * @return mp3player_err_t Error code. + */ mp3player_err_t mp3player_init (void) { p = calloc(1, sizeof(mp3player_t)); @@ -147,12 +177,21 @@ mp3player_err_t mp3player_init (void) { return MP3PLAYER_OK; } +/** + * @brief Deinitialize the MP3 player. + */ void mp3player_deinit (void) { mp3player_unload(); free(p); p = NULL; } +/** + * @brief Load an MP3 file. + * + * @param path Path to the MP3 file. + * @return mp3player_err_t Error code. + */ mp3player_err_t mp3player_load (char *path) { if (p->loaded) { mp3player_unload(); @@ -217,6 +256,9 @@ mp3player_err_t mp3player_load (char *path) { return MP3PLAYER_ERR_INVALID_FILE; } +/** + * @brief Unload the MP3 file. + */ void mp3player_unload (void) { mp3player_stop(); if (p->loaded) { @@ -225,6 +267,11 @@ void mp3player_unload (void) { } } +/** + * @brief Process the MP3 player. + * + * @return mp3player_err_t Error code. + */ mp3player_err_t mp3player_process (void) { if (ferror(p->f)) { mp3player_unload(); @@ -238,14 +285,29 @@ mp3player_err_t mp3player_process (void) { return MP3PLAYER_OK; } +/** + * @brief Check if the MP3 player is playing. + * + * @return true if playing, false otherwise. + */ bool mp3player_is_playing (void) { return mixer_ch_playing(SOUND_MP3_PLAYER_CHANNEL); } +/** + * @brief Check if the MP3 player has finished playing. + * + * @return true if finished, false otherwise. + */ bool mp3player_is_finished (void) { return p->loaded && feof(p->f) && (p->buffer_left == 0); } +/** + * @brief Play the MP3 file. + * + * @return mp3player_err_t Error code. + */ mp3player_err_t mp3player_play (void) { if (!p->loaded) { return MP3PLAYER_ERR_NO_FILE; @@ -262,12 +324,20 @@ mp3player_err_t mp3player_play (void) { return MP3PLAYER_OK; } +/** + * @brief Stop the MP3 player. + */ void mp3player_stop (void) { if (mp3player_is_playing()) { mixer_ch_stop(SOUND_MP3_PLAYER_CHANNEL); } } +/** + * @brief Toggle the MP3 player between play and stop. + * + * @return mp3player_err_t Error code. + */ mp3player_err_t mp3player_toggle (void) { if (mp3player_is_playing()) { mp3player_stop(); @@ -277,11 +347,22 @@ mp3player_err_t mp3player_toggle (void) { return MP3PLAYER_OK; } +/** + * @brief Mute or unmute the MP3 player. + * + * @param mute True to mute, false to unmute. + */ void mp3player_mute (bool mute) { float volume = mute ? 0.0f : 1.0f; mixer_ch_set_vol(SOUND_MP3_PLAYER_CHANNEL, volume, volume); } +/** + * @brief Seek to a specific position in the MP3 file. + * + * @param seconds Number of seconds to seek. + * @return mp3player_err_t Error code. + */ mp3player_err_t mp3player_seek (int seconds) { // NOTE: Rough approximation using average bitrate to calculate number of bytes to be skipped. // Good enough but not very accurate for variable bitrate files. @@ -316,6 +397,11 @@ mp3player_err_t mp3player_seek (int seconds) { return MP3PLAYER_OK; } +/** + * @brief Get the duration of the MP3 file. + * + * @return float Duration in seconds. + */ float mp3player_get_duration (void) { if (!p->loaded) { return 0.0f; @@ -324,6 +410,11 @@ float mp3player_get_duration (void) { return p->duration; } +/** + * @brief Get the bitrate of the MP3 file. + * + * @return float Bitrate in kbps. + */ float mp3player_get_bitrate (void) { if (!p->loaded) { return 0.0f; @@ -332,6 +423,11 @@ float mp3player_get_bitrate (void) { return p->bitrate; } +/** + * @brief Get the sample rate of the MP3 file. + * + * @return int Sample rate in Hz. + */ int mp3player_get_samplerate (void) { if (!p->loaded) { return 0; @@ -340,6 +436,11 @@ int mp3player_get_samplerate (void) { return p->info.hz; } +/** + * @brief Get the progress of the MP3 file playback. + * + * @return float Progress as a percentage. + */ float mp3player_get_progress (void) { // NOTE: Rough approximation using file pointer instead of processed samples. // Good enough but not very accurate for variable bitrate files. diff --git a/src/menu/path.c b/src/menu/path.c index 59f622f2..086b10e0 100644 --- a/src/menu/path.c +++ b/src/menu/path.c @@ -1,14 +1,24 @@ +/** + * @file path.c + * @brief Path manipulation functions + * @ingroup menu + */ + #include #include #include #include "path.h" - #define PATH_CAPACITY_INITIAL 255 #define PATH_CAPACITY_ALIGNMENT 32 - +/** + * @brief Resize the path buffer to accommodate the specified minimum length. + * + * @param path Pointer to the path structure. + * @param min_length Minimum length to accommodate. + */ static void path_resize (path_t *path, size_t min_length) { path->capacity = min_length > PATH_CAPACITY_INITIAL ? min_length : PATH_CAPACITY_INITIAL; size_t alignment = path->capacity % PATH_CAPACITY_ALIGNMENT; @@ -19,7 +29,13 @@ static void path_resize (path_t *path, size_t min_length) { assert(path->buffer != NULL); } -static path_t *path_create (const char *string) { +/** + * @brief Create a new path structure. + * + * @param string Initial path string. + * @return path_t* Pointer to the created path structure. + */ +path_t *path_create (const char *string) { if (string == NULL) { string = ""; } @@ -32,6 +48,12 @@ static path_t *path_create (const char *string) { return path; } +/** + * @brief Append a string to the path. + * + * @param path Pointer to the path structure. + * @param string String to append. + */ static void path_append (path_t *path, char *string) { size_t buffer_length = strlen(path->buffer); size_t string_length = strlen(string); @@ -42,7 +64,13 @@ static void path_append (path_t *path, char *string) { strcat(path->buffer, string); } - +/** + * @brief Initialize a new path structure with a prefix and an initial string. + * + * @param prefix Path prefix. + * @param string Initial path string. + * @return path_t* Pointer to the initialized path structure. + */ path_t *path_init (const char *prefix, char *string) { path_t *path = path_create(prefix); size_t prefix_length = strlen(prefix); @@ -56,6 +84,11 @@ path_t *path_init (const char *prefix, char *string) { return path; } +/** + * @brief Free the memory allocated for the path structure. + * + * @param path Pointer to the path structure. + */ void path_free (path_t *path) { if (path != NULL) { free(path->buffer); @@ -63,31 +96,67 @@ void path_free (path_t *path) { } } +/** + * @brief Clone the path structure. + * + * @param path Pointer to the path structure to clone. + * @return path_t* Pointer to the cloned path structure. + */ path_t *path_clone (path_t *path) { path_t *cloned = path_create(path->buffer); cloned->root = cloned->buffer + (path->root - path->buffer); return cloned; } +/** + * @brief Clone the path structure and push a string to the cloned path. + * + * @param path Pointer to the path structure to clone. + * @param string String to push to the cloned path. + * @return path_t* Pointer to the cloned and modified path structure. + */ path_t *path_clone_push (path_t *path, char *string) { path_t *cloned = path_clone(path); path_push(cloned, string); return cloned; } +/** + * @brief Get the current path string. + * + * @param path Pointer to the path structure. + * @return char* Pointer to the current path string. + */ char *path_get (path_t *path) { return path->buffer; } +/** + * @brief Get the last component of the path. + * + * @param path Pointer to the path structure. + * @return char* Pointer to the last component of the path. + */ char *path_last_get (path_t *path) { char *last_slash = strrchr(path->root, '/'); return (last_slash == NULL) ? path->root : (last_slash + 1); } +/** + * @brief Check if the path is the root path. + * + * @param path Pointer to the path structure. + * @return true if the path is the root path, false otherwise. + */ bool path_is_root (path_t *path) { return (strcmp(path->root, "/") == 0); } +/** + * @brief Pop the last component from the path. + * + * @param path Pointer to the path structure. + */ void path_pop (path_t *path) { if (path_is_root(path)) { return; @@ -100,6 +169,12 @@ void path_pop (path_t *path) { } } +/** + * @brief Push a string to the path. + * + * @param path Pointer to the path structure. + * @param string String to push to the path. + */ void path_push (path_t *path, char *string) { if (path->buffer[strlen(path->buffer) - 1] != '/') { path_append(path, "/"); @@ -110,6 +185,12 @@ void path_push (path_t *path, char *string) { path_append(path, string); } +/** + * @brief Push a subdirectory to the path. + * + * @param path Pointer to the path structure. + * @param string Subdirectory string to push to the path. + */ void path_push_subdir (path_t *path, char *string) { char *file = path_last_get(path); char *tmp = alloca(strlen(file) + 1); @@ -119,6 +200,12 @@ void path_push_subdir (path_t *path, char *string) { path_push(path, tmp); } +/** + * @brief Get the file extension from the path. + * + * @param path Pointer to the path structure. + * @return char* Pointer to the file extension. + */ char *path_ext_get (path_t *path) { char *buffer = path_last_get(path); char *last_dot = strrchr(buffer, '.'); @@ -128,6 +215,11 @@ char *path_ext_get (path_t *path) { return NULL; } +/** + * @brief Remove the file extension from the path. + * + * @param path Pointer to the path structure. + */ void path_ext_remove (path_t *path) { char *buffer = path_last_get(path); char *last_dot = strrchr(buffer, '.'); @@ -136,8 +228,46 @@ void path_ext_remove (path_t *path) { } } +/** + * @brief Replace the file extension in the path. + * + * @param path Pointer to the path structure. + * @param ext New file extension. + */ void path_ext_replace (path_t *path, char *ext) { path_ext_remove(path); path_append(path, "."); path_append(path, ext); } + +/** + * @brief Check if the path has a value. + * + * @param path Pointer to the path structure. + * @return true if the path has a value, false otherwise. + */ +bool path_has_value(path_t *path) { + if(path != NULL) { + if(strlen(path->buffer) > 0) { + return true; + } + } + return false; +} + +/** + * @brief Check if two paths match. + * + * @param left Pointer to the first path structure. + * @param right Pointer to the second path structure. + * @return true if the paths match, false otherwise. + */ +bool path_are_match(path_t *left, path_t *right) { + if(!path_has_value(left) && !path_has_value(right)) { + return true; + } else if(path_has_value(left) && path_has_value(right)) { + return (strcmp(path_get(left), path_get(right)) == 0); + } else { + return false; + } +} \ No newline at end of file diff --git a/src/menu/path.h b/src/menu/path.h index df2672d2..48809893 100644 --- a/src/menu/path.h +++ b/src/menu/path.h @@ -7,32 +7,147 @@ #ifndef PATH_H__ #define PATH_H__ - #include #include - -/** @brief Path Structure */ +/** + * @brief Path Structure + */ typedef struct { - char *buffer; - char *root; - size_t capacity; + char *buffer; /**< Buffer for the path */ + char *root; /**< Root directory */ + size_t capacity; /**< Capacity of the buffer */ } path_t; +/** + * @brief Create a new path object + * + * @param string Initial path string + * @return path_t* Pointer to the created path object + */ +path_t *path_create(const char *string); -path_t *path_init (const char *prefix, char *string); -void path_free (path_t *path); -path_t *path_clone (path_t *string); -path_t *path_clone_push (path_t *path, char *string); -char *path_get (path_t *path); -char *path_last_get (path_t *path); -bool path_is_root (path_t *path); -void path_pop (path_t *path); -void path_push (path_t *path, char *string); -void path_push_subdir (path_t *path, char *string); -char *path_ext_get (path_t *path); -void path_ext_remove (path_t *path); -void path_ext_replace (path_t *path, char *ext); +/** + * @brief Initialize a path object with a prefix and string + * + * @param prefix Prefix for the path + * @param string Initial path string + * @return path_t* Pointer to the initialized path object + */ +path_t *path_init(const char *prefix, char *string); +/** + * @brief Free a path object + * + * @param path Pointer to the path object to be freed + */ +void path_free(path_t *path); -#endif +/** + * @brief Clone a path object + * + * @param string Path object to be cloned + * @return path_t* Pointer to the cloned path object + */ +path_t *path_clone(path_t *string); + +/** + * @brief Clone a path object and push a string onto it + * + * @param path Path object to be cloned + * @param string String to be pushed onto the cloned path + * @return path_t* Pointer to the cloned and modified path object + */ +path_t *path_clone_push(path_t *path, char *string); + +/** + * @brief Get the string representation of a path + * + * @param path Path object + * @return char* String representation of the path + */ +char *path_get(path_t *path); + +/** + * @brief Get the last component of a path + * + * @param path Path object + * @return char* Last component of the path + */ +char *path_last_get(path_t *path); + +/** + * @brief Check if the path is the root directory + * + * @param path Path object + * @return true If the path is the root directory + * @return false Otherwise + */ +bool path_is_root(path_t *path); + +/** + * @brief Pop the last component from the path + * + * @param path Path object + */ +void path_pop(path_t *path); + +/** + * @brief Push a string onto the path + * + * @param path Path object + * @param string String to be pushed onto the path + */ +void path_push(path_t *path, char *string); + +/** + * @brief Push a subdirectory onto the path + * + * @param path Path object + * @param string Subdirectory to be pushed onto the path + */ +void path_push_subdir(path_t *path, char *string); + +/** + * @brief Get the file extension from the path + * + * @param path Path object + * @return char* File extension + */ +char *path_ext_get(path_t *path); + +/** + * @brief Remove the file extension from the path + * + * @param path Path object + */ +void path_ext_remove(path_t *path); + +/** + * @brief Replace the file extension of the path + * + * @param path Path object + * @param ext New file extension + */ +void path_ext_replace(path_t *path, char *ext); + +/** + * @brief Check if the path has a value + * + * @param path Path object + * @return true If the path has a value + * @return false Otherwise + */ +bool path_has_value(path_t *path); + +/** + * @brief Check if two paths match + * + * @param left First path object + * @param right Second path object + * @return true If the paths match + * @return false Otherwise + */ +bool path_are_match(path_t *left, path_t *right); + +#endif // PATH_H__ diff --git a/src/menu/png_decoder.c b/src/menu/png_decoder.c index 14dbf8ed..872179f5 100644 --- a/src/menu/png_decoder.c +++ b/src/menu/png_decoder.c @@ -1,29 +1,33 @@ +/** + * @file png_decoder.c + * @brief PNG Decoder component implementation + * @ingroup ui_components + */ + #include - #include - #include "png_decoder.h" #include "utils/fs.h" - /** @brief PNG File Information Structure. */ typedef struct { - FILE *f; - - spng_ctx *ctx; - struct spng_ihdr ihdr; - - surface_t *image; - uint8_t *row_buffer; - int decoded_rows; - - png_callback_t *callback; - void *callback_data; + FILE *f; /**< File pointer */ + spng_ctx *ctx; /**< SPNG context */ + struct spng_ihdr ihdr; /**< SPNG image header */ + surface_t *image; /**< Image surface */ + uint8_t *row_buffer; /**< Row buffer */ + int decoded_rows; /**< Number of decoded rows */ + png_callback_t *callback; /**< Callback function */ + void *callback_data; /**< Callback data */ } png_decoder_t; static png_decoder_t *decoder; - +/** + * @brief Deinitialize the PNG decoder. + * + * @param free_image Flag indicating whether to free the image. + */ static void png_decoder_deinit (bool free_image) { if (decoder != NULL) { fclose(decoder->f); @@ -42,7 +46,16 @@ static void png_decoder_deinit (bool free_image) { } } - +/** + * @brief Start decoding a PNG file. + * + * @param path Path to the PNG file. + * @param max_width Maximum width of the image. + * @param max_height Maximum height of the image. + * @param callback Callback function to be called upon completion. + * @param callback_data Data to be passed to the callback function. + * @return png_err_t Error code. + */ png_err_t png_decoder_start (char *path, int max_width, int max_height, png_callback_t *callback, void *callback_data) { if (decoder != NULL) { return PNG_ERR_BUSY; @@ -122,10 +135,18 @@ png_err_t png_decoder_start (char *path, int max_width, int max_height, png_call return PNG_OK; } +/** + * @brief Abort the PNG decoding process. + */ void png_decoder_abort (void) { png_decoder_deinit(true); } +/** + * @brief Get the progress of the PNG decoding process. + * + * @return float Progress as a percentage. + */ float png_decoder_get_progress (void) { if (!decoder) { return 0.0f; @@ -134,6 +155,9 @@ float png_decoder_get_progress (void) { return (float) (decoder->decoded_rows) / (decoder->ihdr.height); } +/** + * @brief Poll the PNG decoder to process the next row. + */ void png_decoder_poll (void) { if (!decoder) { return; diff --git a/src/menu/rom_info.c b/src/menu/rom_info.c index b313950c..3ab16284 100644 --- a/src/menu/rom_info.c +++ b/src/menu/rom_info.c @@ -1,3 +1,10 @@ +/** + * @file rom_info.c + * @brief ROM Information component implementation + * @ingroup menu + */ + + #include #include #include @@ -47,92 +54,46 @@ typedef struct __attribute__((packed)) { /** @brief ROM Information Match Type Enumeration. */ typedef enum { - // Check only game code - MATCH_TYPE_ID, - - // Check game code and region - MATCH_TYPE_ID_REGION, - - // Check game code, region and version - MATCH_TYPE_ID_REGION_VERSION, - - // Check game check code - MATCH_TYPE_CHECK_CODE, - - // Check for homebrew header ID - MATCH_TYPE_HOMEBREW_HEADER, - - // List end marker - MATCH_TYPE_END + MATCH_TYPE_ID, /**< Check only game code */ + MATCH_TYPE_ID_REGION, /**< Check game code and region */ + MATCH_TYPE_ID_REGION_VERSION, /**< Check game code, region and version */ + MATCH_TYPE_CHECK_CODE, /**< Check game check code */ + MATCH_TYPE_HOMEBREW_HEADER, /**< Check for homebrew header ID */ + MATCH_TYPE_END /**< List end marker */ } match_type_t; +/** @brief ROM Features Enumeration. */ typedef enum { - // No features supported - FEAT_NONE = 0, - - // Controller Pak - FEAT_CPAK = (1 << 0), - - // Rumble Pak - FEAT_RPAK = (1 << 1), - - // Transfer Pak - FEAT_TPAK = (1 << 2), - - // Voice Recognition Unit - FEAT_VRU = (1 << 3), - - // Real Time Clock - FEAT_RTC = (1 << 4), - - // Expansion Pak (for games that will not work without it inserted into the console) - FEAT_EXP_PAK_REQUIRED = (1 << 5), - - // Expansion Pak (for games with game play enhancements) - FEAT_EXP_PAK_RECOMMENDED = (1 << 6), - - // Expansion Pak (for games with visual (or other) enhancements) - FEAT_EXP_PAK_ENHANCED = (1 << 7), - - // No Expansion Pak (for games "broken" with it inserted into the console) - FEAT_EXP_PAK_BROKEN = (1 << 8), - - // 64DD disk to ROM conversion - FEAT_64DD_CONVERSION = (1 << 9), - - // Combo ROM + Disk games - FEAT_64DD_ENHANCED = (1 << 10), + FEAT_NONE = 0, /**< No features supported */ + FEAT_CPAK = (1 << 0), /**< Controller Pak */ + FEAT_RPAK = (1 << 1), /**< Rumble Pak */ + FEAT_TPAK = (1 << 2), /**< Transfer Pak */ + FEAT_VRU = (1 << 3), /**< Voice Recognition Unit */ + FEAT_RTC = (1 << 4), /**< Real Time Clock */ + FEAT_EXP_PAK_REQUIRED = (1 << 5), /**< Expansion Pak required */ + FEAT_EXP_PAK_RECOMMENDED = (1 << 6), /**< Expansion Pak recommended */ + FEAT_EXP_PAK_ENHANCED = (1 << 7), /**< Expansion Pak enhanced */ + FEAT_EXP_PAK_BROKEN = (1 << 8), /**< Expansion Pak broken */ + FEAT_64DD_CONVERSION = (1 << 9), /**< 64DD disk to ROM conversion */ + FEAT_64DD_ENHANCED = (1 << 10) /**< Combo ROM + Disk games */ } feat_t; +/** @brief ROM Match Structure. */ typedef struct { - // Which fields to check - match_type_t type; - - // Fields to check for matching + match_type_t type; /**< Match type */ union { struct { - // Game code (with media type and optional region) or unique ID - const char *id; - - // Game version - uint8_t version; + const char *id; /**< Game code or unique ID */ + uint8_t version; /**< Game version */ }; - - // Game check code - uint64_t check_code; + uint64_t check_code; /**< Game check code */ } fields; - - // Matched game metadata struct { - // Save type (only cartridge save types) - rom_save_type_t save; - - // Supported features - feat_t feat; + rom_save_type_t save; /**< Save type */ + feat_t feat; /**< Supported features */ } data; } match_t; - #define MATCH_ID(i, s, f) { .type = MATCH_TYPE_ID, .fields = { .id = i }, .data = { .save = s, .feat = f } } #define MATCH_ID_REGION(i, s, f) { .type = MATCH_TYPE_ID_REGION, .fields = { .id = i }, .data = { .save = s, .feat = f } } #define MATCH_ID_REGION_VERSION(i, v, s, f) { .type = MATCH_TYPE_ID_REGION_VERSION, .fields = { .id = i, .version = v }, .data = { .save = s, .feat = f } } @@ -792,95 +753,109 @@ static void extract_rom_info (match_t *match, rom_header_t *rom_header, rom_info } else { rom_info->features.expansion_pak = EXPANSION_PAK_NONE; } + + rom_info->metadata.description[0] = '\0'; + rom_info->settings.cheats_enabled = false; + rom_info->settings.patches_enabled = false; } -static void load_overrides (path_t *path, rom_info_t *rom_info) { - path_t *overrides_path = path_clone(path); +static void load_rom_info_from_file (path_t *path, rom_info_t *rom_info) { + path_t *rom_info_path = path_clone(path); - path_ext_replace(overrides_path, "ini"); + path_ext_replace(rom_info_path, "ini"); - mini_t *ini = mini_load(path_get(overrides_path)); + mini_t *rom_info_ini = mini_load(path_get(rom_info_path)); - rom_info->override.cic = false; - rom_info->override.save = false; - rom_info->override.tv = false; + const char *rom_description = "None.\n"; - if (ini) { - rom_info->override.cic_type = mini_get_int(ini, NULL, "cic_type", ROM_CIC_TYPE_AUTOMATIC); - if (rom_info->override.cic_type != ROM_CIC_TYPE_AUTOMATIC) { - rom_info->override.cic = true; + rom_info->boot_override.cic = false; + rom_info->boot_override.save = false; + rom_info->boot_override.tv = false; + + if (rom_info_ini) { + rom_description = mini_get_string(rom_info_ini, "metadata", "description", "None.\n"); //FIXME: only supports LF (UNIX) line endings. CRLF will not work. + + rom_info->boot_override.cic_type = mini_get_int(rom_info_ini, "custom_boot", "cic_type", ROM_CIC_TYPE_AUTOMATIC); + if (rom_info->boot_override.cic_type != ROM_CIC_TYPE_AUTOMATIC) { + rom_info->boot_override.cic = true; } - rom_info->override.save_type = mini_get_int(ini, NULL, "save_type", SAVE_TYPE_AUTOMATIC); - if (rom_info->override.save_type != SAVE_TYPE_AUTOMATIC) { - rom_info->override.save = true; + rom_info->boot_override.save_type = mini_get_int(rom_info_ini, "custom_boot", "save_type", SAVE_TYPE_AUTOMATIC); + if (rom_info->boot_override.save_type != SAVE_TYPE_AUTOMATIC) { + rom_info->boot_override.save = true; } - rom_info->override.tv_type = mini_get_int(ini, NULL, "tv_type", ROM_TV_TYPE_AUTOMATIC); - if (rom_info->override.tv_type != ROM_TV_TYPE_AUTOMATIC) { - rom_info->override.tv = true; + rom_info->boot_override.tv_type = mini_get_int(rom_info_ini, "custom_boot", "tv_type", ROM_TV_TYPE_AUTOMATIC); + if (rom_info->boot_override.tv_type != ROM_TV_TYPE_AUTOMATIC) { + rom_info->boot_override.tv = true; } - mini_free(ini); + rom_info->settings.cheats_enabled = mini_get_bool(rom_info_ini, NULL, "cheats_enabled", false); + rom_info->settings.patches_enabled = mini_get_bool(rom_info_ini, NULL, "patches_enabled", false); + + mini_free(rom_info_ini); } - path_free(overrides_path); + strncpy(rom_info->metadata.description, rom_description, sizeof(rom_info->metadata.description)-1); + rom_info->metadata.description[sizeof(rom_info->metadata.description) - 1] = '\0'; + + path_free(rom_info_path); } static rom_err_t save_override (path_t *path, const char *id, int value, int default_value) { - path_t *overrides_path = path_clone(path); + path_t *rom_info_path = path_clone(path); - path_ext_replace(overrides_path, "ini"); + path_ext_replace(rom_info_path, "ini"); - mini_t *ini = mini_try_load(path_get(overrides_path)); + mini_t *rom_info_ini = mini_try_load(path_get(rom_info_path)); - if (!ini) { - path_free(overrides_path); + if (!rom_info_ini) { + path_free(rom_info_path); return ROM_ERR_SAVE_IO; } int mini_err; if (value == default_value) { - mini_err = mini_delete_value(ini, NULL, id); + mini_err = mini_delete_value(rom_info_ini, "custom_boot", id); } else { - mini_err = mini_set_int(ini, NULL, id, value); + mini_err = mini_set_int(rom_info_ini, "custom_boot", id, value); } if ((mini_err != MINI_OK) && (mini_err != MINI_VALUE_NOT_FOUND)) { - path_free(overrides_path); - mini_free(ini); + path_free(rom_info_path); + mini_free(rom_info_ini); return ROM_ERR_SAVE_IO; } - bool empty = mini_empty(ini); + bool empty = mini_empty(rom_info_ini); if (!empty) { - if (mini_save(ini, MINI_FLAGS_NONE) != MINI_OK) { - path_free(overrides_path); - mini_free(ini); + if (mini_save(rom_info_ini, MINI_FLAGS_NONE) != MINI_OK) { + path_free(rom_info_path); + mini_free(rom_info_ini); return ROM_ERR_SAVE_IO; } } - mini_free(ini); + mini_free(rom_info_ini); if (empty) { - if (remove(path_get(overrides_path)) && (errno != ENOENT)) { - path_free(overrides_path); + if (remove(path_get(rom_info_path)) && (errno != ENOENT)) { + path_free(rom_info_path); return ROM_ERR_SAVE_IO; } } - path_free(overrides_path); + path_free(rom_info_path); return ROM_OK; } rom_cic_type_t rom_info_get_cic_type (rom_info_t *rom_info) { - if (rom_info->override.cic) { - return rom_info->override.cic_type; + if (rom_info->boot_override.cic) { + return rom_info->boot_override.cic_type; } else { return rom_info->cic_type; } @@ -908,44 +883,44 @@ bool rom_info_get_cic_seed (rom_info_t *rom_info, uint8_t *seed) { *seed = cic_get_seed(cic_type); - return (!rom_info->override.cic); + return (!rom_info->boot_override.cic); } rom_err_t rom_info_override_cic_type (path_t *path, rom_info_t *rom_info, rom_cic_type_t cic_type) { - rom_info->override.cic = (cic_type != ROM_CIC_TYPE_AUTOMATIC); - rom_info->override.cic_type = cic_type; + rom_info->boot_override.cic = (cic_type != ROM_CIC_TYPE_AUTOMATIC); + rom_info->boot_override.cic_type = cic_type; - return save_override(path, "cic_type", rom_info->override.cic_type, ROM_CIC_TYPE_AUTOMATIC); + return save_override(path, "cic_type", rom_info->boot_override.cic_type, ROM_CIC_TYPE_AUTOMATIC); } rom_save_type_t rom_info_get_save_type (rom_info_t *rom_info) { - if (rom_info->override.save) { - return rom_info->override.save_type; + if (rom_info->boot_override.save) { + return rom_info->boot_override.save_type; } else { return rom_info->save_type; } } rom_err_t rom_info_override_save_type (path_t *path, rom_info_t *rom_info, rom_save_type_t save_type) { - rom_info->override.save = (save_type != SAVE_TYPE_AUTOMATIC); - rom_info->override.save_type = save_type; + rom_info->boot_override.save = (save_type != SAVE_TYPE_AUTOMATIC); + rom_info->boot_override.save_type = save_type; - return save_override(path, "save_type", rom_info->override.save_type, SAVE_TYPE_AUTOMATIC); + return save_override(path, "save_type", rom_info->boot_override.save_type, SAVE_TYPE_AUTOMATIC); } rom_tv_type_t rom_info_get_tv_type (rom_info_t *rom_info) { - if (rom_info->override.tv) { - return rom_info->override.tv_type; + if (rom_info->boot_override.tv) { + return rom_info->boot_override.tv_type; } else { return rom_info->tv_type; } } rom_err_t rom_info_override_tv_type (path_t *path, rom_info_t *rom_info, rom_tv_type_t tv_type) { - rom_info->override.tv = (tv_type != ROM_TV_TYPE_AUTOMATIC); - rom_info->override.tv_type = tv_type; + rom_info->boot_override.tv = (tv_type != ROM_TV_TYPE_AUTOMATIC); + rom_info->boot_override.tv_type = tv_type; - return save_override(path, "tv_type", rom_info->override.tv_type, ROM_TV_TYPE_AUTOMATIC); + return save_override(path, "tv_type", rom_info->boot_override.tv_type, ROM_TV_TYPE_AUTOMATIC); } rom_err_t rom_info_load (path_t *path, rom_info_t *rom_info) { @@ -970,7 +945,7 @@ rom_err_t rom_info_load (path_t *path, rom_info_t *rom_info) { extract_rom_info(&match, &rom_header, rom_info); - load_overrides(path, rom_info); + load_rom_info_from_file(path, rom_info); return ROM_OK; } diff --git a/src/menu/rom_info.h b/src/menu/rom_info.h index 731c6553..890a3f4b 100644 --- a/src/menu/rom_info.h +++ b/src/menu/rom_info.h @@ -8,234 +8,237 @@ #ifndef ROM_INFO_H__ #define ROM_INFO_H__ - #include #include #include "path.h" - /** @brief ROM error enumeration. */ typedef enum { - ROM_OK, - ROM_ERR_LOAD_IO, - ROM_ERR_SAVE_IO, - ROM_ERR_NO_FILE, + ROM_OK, /**< No error */ + ROM_ERR_LOAD_IO, /**< Load I/O error */ + ROM_ERR_SAVE_IO, /**< Save I/O error */ + ROM_ERR_NO_FILE, /**< No file error */ } rom_err_t; /** @brief ROM endian enumeration. */ typedef enum { - /** @brief Is Big Endian. */ - ENDIANNESS_BIG, - /** @brief Is Little Endian. */ - ENDIANNESS_LITTLE, - /** @brief Is Byte Swapped Endian. */ - ENDIANNESS_BYTE_SWAP, + ENDIANNESS_BIG, /**< Big Endian */ + ENDIANNESS_LITTLE, /**< Little Endian */ + ENDIANNESS_BYTE_SWAP, /**< Byte Swapped Endian */ } rom_endianness_t; /** @brief ROM media type enumeration. */ typedef enum { - /** @brief Is a stand alone Cartridge program. */ - N64_CART = 'N', - /** @brief Is a stand alone Disk Drive program. */ - N64_DISK = 'D', - /** @brief Is a Cartridge program that could use an extra Disk Drive program to expand its capabilities. */ - N64_CART_EXPANDABLE = 'C', - /** @brief Is a Disk Drive program that could use an extra Cartridge program to expand its capabilities. */ - N64_DISK_EXPANDABLE = 'E', - /** @brief Is an Aleck64 program. */ - N64_ALECK64 = 'Z' + N64_CART = 'N', /**< Stand alone Cartridge program */ + N64_DISK = 'D', /**< Stand alone Disk Drive program */ + N64_CART_EXPANDABLE = 'C', /**< Cartridge program that could use an extra Disk Drive program */ + N64_DISK_EXPANDABLE = 'E', /**< Disk Drive program that could use an extra Cartridge program */ + N64_ALECK64 = 'Z' /**< Aleck64 program */ } rom_category_type_t; /** @brief ROM market region & language type enumeration. */ typedef enum { - /** @brief The ROM is designed for Japanese and "English" languages. */ - MARKET_JAPANESE_MULTI = 'A', // 1080 Snowboarding JPN is the only ROM that uses this? possibily a mistake, or the fact it also includes American English!. - /** @brief The ROM is designed for Brazil (Portuguese) language. */ - MARKET_BRAZILIAN = 'B', - /** @brief The ROM is designed for Chinese language. */ - MARKET_CHINESE = 'C', - /** @brief The ROM is designed for German language. */ - MARKET_GERMAN = 'D', - /** @brief The ROM is designed for North American "English" language. */ - MARKET_NORTH_AMERICA = 'E', - /** @brief The ROM is designed for French language. */ - MARKET_FRENCH = 'F', - /** @brief The ROM is designed for a NTSC Gateway 64. */ - MARKET_GATEWAY64_NTSC = 'G', - /** @brief The ROM is designed for Dutch language. */ - MARKET_DUTCH = 'H', - /** @brief The ROM is designed for Italian language. */ - MARKET_ITALIAN = 'I', - /** @brief The ROM is designed for Japanese language. */ - MARKET_JAPANESE = 'J', - /** @brief The ROM is designed for Korean language. */ - MARKET_KOREAN = 'K', - /** @brief The ROM is designed for a PAL Gateway 64. */ - MARKET_GATEWAY64_PAL = 'L', - /** @brief The ROM is designed for Canada region (English and French) language. */ - MARKET_CANADIAN = 'N', - /** @brief The ROM is designed for European market and languages (must at minimum include English). */ - MARKET_EUROPEAN_BASIC = 'P', // Sometimes used for Australian region ROMs as well. - /** @brief The ROM is designed for Spanish language */ - MARKET_SPANISH = 'S', - /** @brief The ROM is designed for Australia (English) language. */ - MARKET_AUSTRALIAN = 'U', - /** @brief The ROM is designed for Scandinavian (Swedish, Norwegian, Finnish, etc.) languages. */ - MARKET_SCANDINAVIAN = 'W', - /** @brief The ROM is designed for an undefined region and TBD language(s). */ - MARKET_OTHER_X = 'X', // many EU ROM's, Top Gear Rally (Asia) and HSV Racing (AUS) ROM uses this. - /** @brief The ROM is designed for a European region and language(s). */ - MARKET_OTHER_Y = 'Y', // many EU ROM's uses this. - /** @brief The ROM is designed for an undefined region and TBD language(s). */ - MARKET_OTHER_Z = 'Z' // no known ROM's use this. + MARKET_JAPANESE_MULTI = 'A', /**< Japanese and "English" languages */ + MARKET_BRAZILIAN = 'B', /**< Brazilian (Portuguese) language */ + MARKET_CHINESE = 'C', /**< Chinese language */ + MARKET_GERMAN = 'D', /**< German language */ + MARKET_NORTH_AMERICA = 'E', /**< North American "English" language */ + MARKET_FRENCH = 'F', /**< French language */ + MARKET_GATEWAY64_NTSC = 'G', /**< NTSC Gateway 64 */ + MARKET_DUTCH = 'H', /**< Dutch language */ + MARKET_ITALIAN = 'I', /**< Italian language */ + MARKET_JAPANESE = 'J', /**< Japanese language */ + MARKET_KOREAN = 'K', /**< Korean language */ + MARKET_GATEWAY64_PAL = 'L', /**< PAL Gateway 64 */ + MARKET_CANADIAN = 'N', /**< Canada region (English and French) language */ + MARKET_EUROPEAN_BASIC = 'P', /**< European market and languages (must include English) */ + MARKET_SPANISH = 'S', /**< Spanish language */ + MARKET_AUSTRALIAN = 'U', /**< Australian (English) language */ + MARKET_SCANDINAVIAN = 'W', /**< Scandinavian (Swedish, Norwegian, Finnish, etc.) languages */ + MARKET_OTHER_X = 'X', /**< Undefined region and TBD language(s) */ + MARKET_OTHER_Y = 'Y', /**< European region and language(s) */ + MARKET_OTHER_Z = 'Z' /**< Undefined region and TBD language(s) */ } rom_destination_type_t; /** @brief ROM CIC type enumeration. */ typedef enum { - ROM_CIC_TYPE_UNKNOWN = 0, // No known CIC type detected - ROM_CIC_TYPE_5101 = 5101, // Aleck64 CIC-5101 - ROM_CIC_TYPE_5167 = 5167, // 64DD ROM conversion CIC-5167 - ROM_CIC_TYPE_6101 = 6101, // NTSC CIC-6101 - ROM_CIC_TYPE_7102 = 7102, // PAL CIC-7102 - ROM_CIC_TYPE_x102 = 6102, // NTSC CIC-6102 / PAL CIC-7101 - ROM_CIC_TYPE_x103 = 6103, // NTSC CIC-6103 / PAL CIC-7103 - ROM_CIC_TYPE_x105 = 6105, // NTSC CIC-6105 / PAL CIC-7105 - ROM_CIC_TYPE_x106 = 6106, // NTSC CIC-6106 / PAL CIC-7106 - ROM_CIC_TYPE_8301 = 8301, // NDDJ0 64DD IPL - ROM_CIC_TYPE_8302 = 8302, // NDDJ1 64DD IPL - ROM_CIC_TYPE_8303 = 8303, // NDDJ2 64DD IPL - ROM_CIC_TYPE_8401 = 8401, // NDXJ0 64DD IPL - ROM_CIC_TYPE_8501 = 8501, // NDDE0 64DD IPL - ROM_CIC_TYPE_AUTOMATIC = -1, // Guess CIC from IPL3 + ROM_CIC_TYPE_UNKNOWN = 0, /**< No known CIC type detected */ + ROM_CIC_TYPE_5101 = 5101, /**< Aleck64 CIC-5101 */ + ROM_CIC_TYPE_5167 = 5167, /**< 64DD ROM conversion CIC-5167 */ + ROM_CIC_TYPE_6101 = 6101, /**< NTSC CIC-6101 */ + ROM_CIC_TYPE_7102 = 7102, /**< PAL CIC-7102 */ + ROM_CIC_TYPE_x102 = 6102, /**< NTSC CIC-6102 / PAL CIC-7101 */ + ROM_CIC_TYPE_x103 = 6103, /**< NTSC CIC-6103 / PAL CIC-7103 */ + ROM_CIC_TYPE_x105 = 6105, /**< NTSC CIC-6105 / PAL CIC-7105 */ + ROM_CIC_TYPE_x106 = 6106, /**< NTSC CIC-6106 / PAL CIC-7106 */ + ROM_CIC_TYPE_8301 = 8301, /**< NDDJ0 64DD IPL */ + ROM_CIC_TYPE_8302 = 8302, /**< NDDJ1 64DD IPL */ + ROM_CIC_TYPE_8303 = 8303, /**< NDDJ2 64DD IPL */ + ROM_CIC_TYPE_8401 = 8401, /**< NDXJ0 64DD IPL */ + ROM_CIC_TYPE_8501 = 8501, /**< NDDE0 64DD IPL */ + ROM_CIC_TYPE_AUTOMATIC = -1, /**< Guess CIC from IPL3 */ } rom_cic_type_t; /** @brief ROM save type enumeration. */ typedef enum { - /** @brief There is no expected save type. */ - SAVE_TYPE_NONE = 0, - SAVE_TYPE_EEPROM_4KBIT = 1, - SAVE_TYPE_EEPROM_16KBIT = 2, - SAVE_TYPE_SRAM_256KBIT = 3, - SAVE_TYPE_SRAM_BANKED = 4, - SAVE_TYPE_SRAM_1MBIT = 5, - SAVE_TYPE_FLASHRAM_1MBIT = 6, - SAVE_TYPE_FLASHRAM_PKST2 = 7, - SAVE_TYPE_AUTOMATIC = -1, + SAVE_TYPE_NONE = 0, /**< No expected save type */ + SAVE_TYPE_EEPROM_4KBIT = 1, /**< EEPROM 4Kbit */ + SAVE_TYPE_EEPROM_16KBIT = 2, /**< EEPROM 16Kbit */ + SAVE_TYPE_SRAM_256KBIT = 3, /**< SRAM 256Kbit */ + SAVE_TYPE_SRAM_BANKED = 4, /**< SRAM Banked */ + SAVE_TYPE_SRAM_1MBIT = 5, /**< SRAM 1Mbit */ + SAVE_TYPE_FLASHRAM_1MBIT = 6, /**< FlashRAM 1Mbit */ + SAVE_TYPE_FLASHRAM_PKST2 = 7, /**< FlashRAM PKST2 */ + SAVE_TYPE_AUTOMATIC = -1, /**< Automatic save type detection */ } rom_save_type_t; +/** @brief ROM TV type enumeration. */ typedef enum { - ROM_TV_TYPE_PAL = 0, - ROM_TV_TYPE_NTSC = 1, - ROM_TV_TYPE_MPAL = 2, - ROM_TV_TYPE_UNKNOWN = 3, - ROM_TV_TYPE_AUTOMATIC = -1, + ROM_TV_TYPE_PAL = 0, /**< PAL TV type */ + ROM_TV_TYPE_NTSC = 1, /**< NTSC TV type */ + ROM_TV_TYPE_MPAL = 2, /**< MPAL TV type */ + ROM_TV_TYPE_UNKNOWN = 3, /**< Unknown TV type */ + ROM_TV_TYPE_AUTOMATIC = -1, /**< Automatic TV type detection */ } rom_tv_type_t; /** @brief ROM memory requirements enumeration. */ typedef enum { - /** @brief The ROM is happy with 4MB of memory. */ - EXPANSION_PAK_NONE, - - /** @brief The ROM requires 8MB of memory. */ - EXPANSION_PAK_REQUIRED, - - /** @brief The ROM recommends 8MB of memory. */ - EXPANSION_PAK_RECOMMENDED, - - /** @brief The ROM suggests 8MB of memory. */ - EXPANSION_PAK_SUGGESTED, - - /** @brief The ROM is faulty when using 8MB of memory. */ - EXPANSION_PAK_FAULTY, + EXPANSION_PAK_NONE, /**< Happy with 4MB of memory */ + EXPANSION_PAK_REQUIRED, /**< Requires 8MB of memory */ + EXPANSION_PAK_RECOMMENDED, /**< Recommends 8MB of memory */ + EXPANSION_PAK_SUGGESTED, /**< Suggests 8MB of memory */ + EXPANSION_PAK_FAULTY, /**< Faulty with 8MB of memory */ } rom_expansion_pak_t; /** @brief ROM Information Structure. */ typedef struct { - /** @brief The file endian. */ - rom_endianness_t endianness; - - /** @brief The clock rate defined in the ROM's header. */ - float clock_rate; - - /** @brief The boot address defined in the ROM's header. */ - uint32_t boot_address; + rom_endianness_t endianness; /**< The file endian */ + float clock_rate; /**< The clock rate defined in the ROM's header */ + uint32_t boot_address; /**< The boot address defined in the ROM's header */ struct { - /** @brief The SDK version defined in the ROM's header. */ - uint8_t version; - /** @brief The SDK revision defined in the ROM's header. */ - char revision; + uint8_t version; /**< The SDK version defined in the ROM's header */ + char revision; /**< The SDK revision defined in the ROM's header */ } libultra; - /** @brief The check code defined in the ROM's header. */ - uint64_t check_code; - - /** @brief The title defined in the ROM's header. */ - char title[20]; + uint64_t check_code; /**< The check code defined in the ROM's header */ + char title[20]; /**< The title defined in the ROM's header */ union { - /** @brief The game code defined in the ROM's header. */ - char game_code[4]; + char game_code[4]; /**< The game code defined in the ROM's header */ struct { - /** @brief The game media type. */ - rom_category_type_t category_code : 8; - /** @brief The game unique identifier. */ - char unique_code[2]; - /** @brief The game region and or market. */ - rom_destination_type_t destination_code : 8; + rom_category_type_t category_code : 8; /**< The game media type */ + char unique_code[2]; /**< The game unique identifier */ + rom_destination_type_t destination_code : 8; /**< The game region and or market */ }; }; - /** @brief The ROM version defined in the ROM's header. */ - uint8_t version; + uint8_t version; /**< The ROM version defined in the ROM's header */ + rom_cic_type_t cic_type; /**< The CIC type required by the ROM */ + rom_save_type_t save_type; /**< The save type required by the ROM */ + rom_tv_type_t tv_type; /**< The TV type required by the ROM */ - /** @brief The CIC type required by the ROM. */ - rom_cic_type_t cic_type; - - /** @brief The save type required by the ROM. */ - rom_save_type_t save_type; - - /** @brief The TV type required by the ROM. */ - rom_tv_type_t tv_type; - - /** @brief Overrides of auto-detected CIC/save/TV types. */ struct { - bool cic; - rom_cic_type_t cic_type; + bool cic; /**< Override CIC type */ + rom_cic_type_t cic_type; /**< CIC type */ + bool save; /**< Override save type */ + rom_save_type_t save_type; /**< Save type */ + bool tv; /**< Override TV type */ + rom_tv_type_t tv_type; /**< TV type */ + } boot_override; /**< Overrides the auto-detected CIC/save/TV types during ROM boot */ - bool save; - rom_save_type_t save_type; - - bool tv; - rom_tv_type_t tv_type; - } override; - - /** @brief The supported ROM accessories. */ struct { - bool controller_pak; - bool rumble_pak; - bool transfer_pak; - bool voice_recognition_unit; - bool real_time_clock; - bool disk_conversion; - bool combo_rom_disk_game; - rom_expansion_pak_t expansion_pak; - } features; + bool controller_pak; /**< Supports Controller Pak */ + bool rumble_pak; /**< Supports Rumble Pak */ + bool transfer_pak; /**< Supports Transfer Pak */ + bool voice_recognition_unit; /**< Supports Voice Recognition Unit */ + bool real_time_clock; /**< Supports Real Time Clock */ + bool disk_conversion; /**< Supports Disk Conversion */ + bool combo_rom_disk_game; /**< Supports Combo ROM/Disk Game */ + rom_expansion_pak_t expansion_pak; /**< Expansion Pak requirements */ + } features; /**< The supported ROM accessories */ + + struct { + bool cheats_enabled; /**< Cheats enabled */ + bool patches_enabled; /**< Patches enabled */ + } settings; /**< The ROM settings */ + + struct { + char description[300]; /**< ROM description */ + } metadata; /**< The ROM metadata */ } rom_info_t; +/** + * @brief Get the CIC seed for the ROM. + * + * @param rom_info Pointer to the ROM information structure + * @param seed Pointer to the seed value + * @return true if successful, false otherwise + */ +bool rom_info_get_cic_seed(rom_info_t *rom_info, uint8_t *seed); -rom_cic_type_t rom_info_get_cic_type (rom_info_t *rom_info); -bool rom_info_get_cic_seed (rom_info_t *rom_info, uint8_t *seed); -rom_err_t rom_info_override_cic_type (path_t *path, rom_info_t *rom_info, rom_cic_type_t cic_type); +/** + * @brief Load ROM information from a file. + * + * @param path Pointer to the path structure + * @param rom_info Pointer to the ROM information structure + * @return rom_err_t Error code + */ +rom_err_t rom_info_load(path_t *path, rom_info_t *rom_info); -rom_save_type_t rom_info_get_save_type (rom_info_t *rom_info); -rom_err_t rom_info_override_save_type (path_t *path, rom_info_t *rom_info, rom_save_type_t save_type); +/** + * @brief Get the CIC type for the ROM. + * + * @param rom_info Pointer to the ROM information structure + * @return rom_cic_type_t CIC type + */ +rom_cic_type_t rom_info_get_cic_type(rom_info_t *rom_info); -rom_tv_type_t rom_info_get_tv_type (rom_info_t *rom_info); -rom_err_t rom_info_override_tv_type (path_t *path, rom_info_t *rom_info, rom_tv_type_t tv_type); +/** + * @brief Override the CIC type for the ROM. + * + * @param path Pointer to the path structure + * @param rom_info Pointer to the ROM information structure + * @param cic_type CIC type to override + * @return rom_err_t Error code + */ +rom_err_t rom_info_override_cic_type(path_t *path, rom_info_t *rom_info, rom_cic_type_t cic_type); -rom_err_t rom_info_load (path_t *path, rom_info_t *rom_info); +/** + * @brief Get the save type for the ROM. + * + * @param rom_info Pointer to the ROM information structure + * @return rom_save_type_t Save type + */ +rom_save_type_t rom_info_get_save_type(rom_info_t *rom_info); +/** + * @brief Override the save type for the ROM. + * + * @param path Pointer to the path structure + * @param rom_info Pointer to the ROM information structure + * @param save_type Save type to override + * @return rom_err_t Error code + */ +rom_err_t rom_info_override_save_type(path_t *path, rom_info_t *rom_info, rom_save_type_t save_type); -#endif +/** + * @brief Get the TV type for the ROM. + * + * @param rom_info Pointer to the ROM information structure + * @return rom_tv_type_t TV type + */ +rom_tv_type_t rom_info_get_tv_type(rom_info_t *rom_info); + +/** + * @brief Override the TV type for the ROM. + * + * @param path Pointer to the path structure + * @param rom_info Pointer to the ROM information structure + * @param tv_type TV type to override + * @return rom_err_t Error code + */ +rom_err_t rom_info_override_tv_type(path_t *path, rom_info_t *rom_info, rom_tv_type_t tv_type); + +#endif // ROM_INFO_H__ diff --git a/src/menu/settings.c b/src/menu/settings.c index 703871aa..e81e24eb 100644 --- a/src/menu/settings.c +++ b/src/menu/settings.c @@ -9,12 +9,18 @@ static char *settings_path = NULL; static settings_t init = { + .schema_revision = 1, + .first_run = true, .pal60_enabled = false, + .pal60_compatibility_mode = true, + .force_progressive_scan = false, .show_protected_entries = false, .default_directory = "/", .use_saves_folder = true, .soundfx_enabled = false, + .loading_progress_bar_enabled = true, .rom_autoload_enabled = false, + .rom_fast_reboot_enabled = false, .rom_autoload_path = "", .rom_autoload_filename = "", @@ -38,13 +44,19 @@ void settings_load (settings_t *settings) { mini_t *ini = mini_try_load(settings_path); + settings->schema_revision = mini_get_int(ini, "menu", "schema_revision", init.schema_revision); + settings->first_run = mini_get_bool(ini, "menu", "first_run", init.first_run); settings->pal60_enabled = mini_get_bool(ini, "menu", "pal60", init.pal60_enabled); // TODO: consider changing file setting name + settings->pal60_compatibility_mode = mini_get_bool(ini, "menu", "pal60_compatibility_mode", init.pal60_compatibility_mode); + settings->force_progressive_scan = mini_get_bool(ini, "menu", "force_progressive_scan", init.force_progressive_scan); settings->show_protected_entries = mini_get_bool(ini, "menu", "show_protected_entries", init.show_protected_entries); settings->default_directory = strdup(mini_get_string(ini, "menu", "default_directory", init.default_directory)); settings->use_saves_folder = mini_get_bool(ini, "menu", "use_saves_folder", init.use_saves_folder); settings->soundfx_enabled = mini_get_bool(ini, "menu", "soundfx_enabled", init.soundfx_enabled); + settings->loading_progress_bar_enabled = mini_get_bool(ini, "menu", "loading_progress_bar_enabled", init.loading_progress_bar_enabled); settings->rom_autoload_enabled = mini_get_bool(ini, "menu", "autoload_rom_enabled", init.rom_autoload_enabled); + settings->rom_fast_reboot_enabled = mini_get_bool(ini, "menu", "reboot_rom_enabled", init.rom_fast_reboot_enabled); settings->rom_autoload_path = strdup(mini_get_string(ini, "autoload", "rom_path", init.rom_autoload_path)); settings->rom_autoload_filename = strdup(mini_get_string(ini, "autoload", "rom_filename", init.rom_autoload_filename)); @@ -58,12 +70,18 @@ void settings_load (settings_t *settings) { void settings_save (settings_t *settings) { mini_t *ini = mini_create(settings_path); + mini_set_int(ini, "menu", "schema_revision", settings->schema_revision); + mini_set_bool(ini, "menu", "first_run", settings->first_run); mini_set_bool(ini, "menu", "pal60", settings->pal60_enabled); + mini_set_bool(ini, "menu", "pal60_compatibility_mode", settings->pal60_compatibility_mode); + mini_set_bool(ini, "menu", "force_progressive_scan", settings->force_progressive_scan); mini_set_bool(ini, "menu", "show_protected_entries", settings->show_protected_entries); mini_set_string(ini, "menu", "default_directory", settings->default_directory); mini_set_bool(ini, "menu", "use_saves_folder", settings->use_saves_folder); mini_set_bool(ini, "menu", "soundfx_enabled", settings->soundfx_enabled); + mini_set_bool(ini, "menu", "loading_progress_bar_enabled", settings->loading_progress_bar_enabled); mini_set_bool(ini, "menu", "autoload_rom_enabled", settings->rom_autoload_enabled); + mini_set_bool(ini, "menu", "reboot_rom_enabled", settings->rom_fast_reboot_enabled); mini_set_string(ini, "autoload", "rom_path", settings->rom_autoload_path); mini_set_string(ini, "autoload", "rom_filename", settings->rom_autoload_filename); diff --git a/src/menu/settings.h b/src/menu/settings.h index 26454412..ad9a815d 100644 --- a/src/menu/settings.h +++ b/src/menu/settings.h @@ -10,8 +10,20 @@ /** @brief Settings Structure */ typedef struct { + /** @brief Settings version */ + int schema_revision; + + /** @brief First run of the menu */ + bool first_run; + /** @brief Use 60 Hz refresh rate on a PAL console */ bool pal60_enabled; + + /** @brief Use 60 Hz refresh rate on a PAL console with certain mods that do not properly the video output */ + bool pal60_compatibility_mode; + + /** @brief Direct the VI to force progressive scan output at 240p. Meant for TVs and other devices which struggle to display interlaced video. */ + bool force_progressive_scan; /** @brief Show files/directories that are filtered in the browser */ bool show_protected_entries; @@ -25,15 +37,21 @@ typedef struct { /** @brief Enable Background music */ bool bgm_enabled; - /** @brief Enable Sounds */ + /** @brief Enable Sound effects within the menu */ bool soundfx_enabled; - /** @brief Enable rumble feedback */ + /** @brief Enable rumble feedback within the menu */ bool rumble_enabled; - /** @brief Enable the ability to bypass the menu and instantly load a ROM */ + /** @brief Show progress bar when loading a ROM */ + bool loading_progress_bar_enabled; + + /** @brief Enable the ability to bypass the menu and instantly load a ROM on power and reset button */ bool rom_autoload_enabled; + /** @brief Enable the ability to bypass the menu and instantly load a ROM on reset button */ + bool rom_fast_reboot_enabled; + /** @brief A path to the autoloaded ROM */ char *rom_autoload_path; diff --git a/src/menu/sound.c b/src/menu/sound.c index ea088447..f988ef8c 100644 --- a/src/menu/sound.c +++ b/src/menu/sound.c @@ -1,22 +1,28 @@ +/** + * @file sound.c + * @brief Sound component implementation + * @ingroup ui_components + */ + #include - #include - #include "mp3_player.h" #include "sound.h" - #define DEFAULT_FREQUENCY (44100) #define NUM_BUFFERS (4) #define NUM_CHANNELS (3) static wav64_t sfx_cursor, sfx_error, sfx_enter, sfx_exit, sfx_setting; - static bool sound_initialized = false; static bool sfx_enabled = false; - +/** + * @brief Reconfigure the sound system with the specified frequency. + * + * @param frequency The audio frequency. + */ static void sound_reconfigure (int frequency) { if ((frequency > 0) && (audio_get_frequency() != frequency)) { if (sound_initialized) { @@ -30,16 +36,23 @@ static void sound_reconfigure (int frequency) { } } - +/** + * @brief Initialize the default sound system. + */ void sound_init_default (void) { sound_reconfigure(DEFAULT_FREQUENCY); } +/** + * @brief Initialize the sound system for MP3 playback. + */ void sound_init_mp3_playback (void) { sound_reconfigure(mp3player_get_samplerate()); } - +/** + * @brief Initialize the sound effects. + */ void sound_init_sfx (void) { mixer_ch_set_vol(SOUND_SFX_CHANNEL, 0.5f, 0.5f); wav64_open(&sfx_cursor, "rom:/cursorsound.wav64"); @@ -50,15 +63,20 @@ void sound_init_sfx (void) { sfx_enabled = true; } +/** + * @brief Enable or disable sound effects. + * + * @param state True to enable, false to disable. + */ void sound_use_sfx(bool state) { - if (state) { - sfx_enabled = true; - } - else { - sfx_enabled = false; - } + sfx_enabled = state; } +/** + * @brief Play a sound effect. + * + * @param sfx The sound effect to play. + */ void sound_play_effect(sound_effect_t sfx) { if(sfx_enabled) { switch (sfx) { @@ -83,7 +101,9 @@ void sound_play_effect(sound_effect_t sfx) { } } - +/** + * @brief Deinitialize the sound system. + */ void sound_deinit (void) { if (sound_initialized) { if (sfx_enabled) { @@ -99,6 +119,9 @@ void sound_deinit (void) { } } +/** + * @brief Poll the sound system to process audio playback. + */ void sound_poll (void) { if (sound_initialized) { mixer_try_play(); diff --git a/src/menu/sound.h b/src/menu/sound.h index 97d83d23..f0fee92e 100644 --- a/src/menu/sound.h +++ b/src/menu/sound.h @@ -52,16 +52,31 @@ void sound_init_sfx(void); /** * @brief Enable or disable sound effects. + * * @param enable True to enable sound effects, false to disable. */ -void sound_use_sfx(bool); +void sound_use_sfx(bool enable); /** * @brief Play a specified sound effect. + * * @param sfx The sound effect to play, as defined in sound_effect_t. */ void sound_play_effect(sound_effect_t sfx); -void sound_deinit (void); -void sound_poll (void); + +/** + * @brief Deinitialize the sound system. + * + * This function deinitializes the sound system, releasing any resources + * that were allocated. + */ +void sound_deinit(void); + +/** + * @brief Poll the sound system. + * + * This function polls the sound system, updating its state as necessary. + */ +void sound_poll(void); #endif /* SOUND_H__ */ diff --git a/src/menu/ui_components.h b/src/menu/ui_components.h index f0dc6060..4eb6775d 100644 --- a/src/menu/ui_components.h +++ b/src/menu/ui_components.h @@ -50,6 +50,11 @@ void ui_components_box_draw(int x0, int y0, int x1, int y1, color_t color); */ void ui_components_border_draw(int x0, int y0, int x1, int y1); +/** + * @brief Draw the layout component with tabs. + */ +void ui_components_layout_draw_tabbed(void); + /** * @brief Draw the layout component. */ @@ -252,4 +257,21 @@ void ui_components_boxart_free(component_boxart_t *b); */ void ui_components_boxart_draw(component_boxart_t *b); +/** + * @brief Draw the tabs component. + * + * @param text Array of tab labels. + * @param count Number of tabs. + * @param selected Index of the selected tab. + * @param width Width of the tabs. + */ +void ui_components_tabs_draw(const char **text, int count, int selected, float width ); + +/** + * @brief Draw the common part of the tabs component. + * + * @param selected Index of the selected tab. + */ +void ui_components_tabs_common_draw(int selected); + #endif /* UI_COMPONENTS_H__ */ diff --git a/src/menu/ui_components/background.c b/src/menu/ui_components/background.c index 548bc0f0..0963ef9b 100644 --- a/src/menu/ui_components/background.c +++ b/src/menu/ui_components/background.c @@ -1,3 +1,9 @@ +/** + * @file background.c + * @brief Background component implementation + * @ingroup ui_components + */ + #include #include @@ -5,27 +11,30 @@ #include "constants.h" #include "utils/fs.h" - #define CACHE_METADATA_MAGIC (0x424B4731) - +/** @brief Background component structure */ typedef struct { - char *cache_location; - surface_t *image; - rspq_block_t *image_display_list; + char *cache_location; /**< Cache location */ + surface_t *image; /**< Image surface */ + rspq_block_t *image_display_list; /**< Image display list */ } component_background_t; +/** @brief Cache metadata structure */ typedef struct { - uint32_t magic; - uint32_t width; - uint32_t height; - uint32_t size; + uint32_t magic; /**< Magic number */ + uint32_t width; /**< Image width */ + uint32_t height; /**< Image height */ + uint32_t size; /**< Image size */ } cache_metadata_t; - static component_background_t *background = NULL; - +/** + * @brief Load background image from cache. + * + * @param c Pointer to the background component structure. + */ static void load_from_cache (component_background_t *c) { if (!c->cache_location) { return; @@ -69,6 +78,11 @@ static void load_from_cache (component_background_t *c) { fclose(f); } +/** + * @brief Save background image to cache. + * + * @param c Pointer to the background component structure. + */ static void save_to_cache (component_background_t *c) { if (!c->cache_location || !c->image) { return; @@ -93,6 +107,11 @@ static void save_to_cache (component_background_t *c) { fclose(f); } +/** + * @brief Prepare the background image for display. + * + * @param c Pointer to the background component structure. + */ static void prepare_background (component_background_t *c) { if (!c->image || c->image->width == 0 || c->image->height == 0) { return; @@ -152,11 +171,20 @@ static void prepare_background (component_background_t *c) { c->image_display_list = rspq_block_end(); } +/** + * @brief Free the display list. + * + * @param arg Pointer to the display list. + */ static void display_list_free (void *arg) { rspq_block_free((rspq_block_t *) (arg)); } - +/** + * @brief Initialize the background component. + * + * @param cache_location The cache location. + */ void ui_components_background_init (char *cache_location) { if (!background) { background = calloc(1, sizeof(component_background_t)); @@ -166,6 +194,9 @@ void ui_components_background_init (char *cache_location) { } } +/** + * @brief Free the background component. + */ void ui_components_background_free (void) { if (background) { if (background->image) { @@ -185,6 +216,11 @@ void ui_components_background_free (void) { } } +/** + * @brief Replace the background image. + * + * @param image The new background image. + */ void ui_components_background_replace_image (surface_t *image) { if (!background) { return; @@ -206,6 +242,9 @@ void ui_components_background_replace_image (surface_t *image) { prepare_background(background); } +/** + * @brief Draw the background. + */ void ui_components_background_draw (void) { if (background && background->image_display_list) { rspq_block_run(background->image_display_list); diff --git a/src/menu/ui_components/boxart.c b/src/menu/ui_components/boxart.c index 16070523..bcb95493 100644 --- a/src/menu/ui_components/boxart.c +++ b/src/menu/ui_components/boxart.c @@ -1,3 +1,9 @@ +/** + * @file boxart.c + * @brief Boxart component implementation + * @ingroup ui_components + */ + #include #include "../ui_components.h" @@ -6,17 +12,29 @@ #include "constants.h" #include "utils/fs.h" - #define BOXART_DIRECTORY "menu/boxart" - +/** + * @brief PNG decoder callback function. + * + * @param err PNG decoder error code. + * @param decoded_image Pointer to the decoded image surface. + * @param callback_data Pointer to the callback data. + */ static void png_decoder_callback (png_err_t err, surface_t *decoded_image, void *callback_data) { component_boxart_t *b = (component_boxart_t *) (callback_data); b->loading = false; b->image = decoded_image; } - +/** + * @brief Initialize the boxart component. + * + * @param storage_prefix The storage prefix. + * @param game_code The game code. + * @param current_image_view The current image view type. + * @return component_boxart_t* Pointer to the initialized boxart component. + */ component_boxart_t *ui_components_boxart_init (const char *storage_prefix, char *game_code, file_image_type_t current_image_view) { component_boxart_t *b; char boxart_id_path[8]; @@ -70,8 +88,7 @@ component_boxart_t *ui_components_boxart_init (const char *storage_prefix, char return b; } } - } - else { // compatibility mode + } else { // compatibility mode char file_name[9]; @@ -98,8 +115,7 @@ component_boxart_t *ui_components_boxart_init (const char *storage_prefix, char path_free(path); return b; } - } - else { + } else { path_pop(path); snprintf(file_name, sizeof(file_name), "%c%c.png", game_code[1], game_code[2]); @@ -120,6 +136,11 @@ component_boxart_t *ui_components_boxart_init (const char *storage_prefix, char return NULL; } +/** + * @brief Free the boxart component. + * + * @param b Pointer to the boxart component. + */ void ui_components_boxart_free (component_boxart_t *b) { if (b) { if (b->loading) { @@ -133,11 +154,16 @@ void ui_components_boxart_free (component_boxart_t *b) { } } +/** + * @brief Draw the boxart component. + * + * @param b Pointer to the boxart component. + */ void ui_components_boxart_draw (component_boxart_t *b) { int box_x = BOXART_X; int box_y = BOXART_Y; - if (b && b->image && b->image->width <= BOXART_WIDTH_MAX && b->image->height <= BOXART_HEIGHT_MAX) { + if (b && b->image && b->image->width <= BOXART_WIDTH_MAX && b->image->height <= BOXART_HEIGHT_MAX) { rdpq_mode_push(); rdpq_set_mode_copy(false); if (b->image->height == BOXART_HEIGHT_MAX) { diff --git a/src/menu/ui_components/common.c b/src/menu/ui_components/common.c index dec31885..bed87b3f 100644 --- a/src/menu/ui_components/common.c +++ b/src/menu/ui_components/common.c @@ -1,30 +1,85 @@ +/** + * @file common.c + * @brief Common UI components implementation + * @ingroup ui_components + */ + #include #include "../ui_components.h" #include "../fonts.h" #include "constants.h" - +/** + * @brief Draw a box with the specified color. + * + * @param x0 The x-coordinate of the top-left corner. + * @param y0 The y-coordinate of the top-left corner. + * @param x1 The x-coordinate of the bottom-right corner. + * @param y1 The y-coordinate of the bottom-right corner. + * @param color The color of the box. + */ void ui_components_box_draw (int x0, int y0, int x1, int y1, color_t color) { rdpq_mode_push(); rdpq_set_mode_fill(color); - rdpq_fill_rectangle(x0, y0, x1, y1); rdpq_mode_pop(); } -void ui_components_border_draw (int x0, int y0, int x1, int y1) { +/** + * @brief Draw a border with the specified color. + * + * @param x0 The x-coordinate of the top-left corner. + * @param y0 The y-coordinate of the top-left corner. + * @param x1 The x-coordinate of the bottom-right corner. + * @param y1 The y-coordinate of the bottom-right corner. + * @param color The color of the border. + */ +static void ui_components_border_draw_internal (int x0, int y0, int x1, int y1, color_t color) { rdpq_mode_push(); - rdpq_set_mode_fill(BORDER_COLOR); - + rdpq_set_mode_fill(color); rdpq_fill_rectangle(x0 - BORDER_THICKNESS, y0 - BORDER_THICKNESS, x1 + BORDER_THICKNESS, y0); rdpq_fill_rectangle(x0 - BORDER_THICKNESS, y1, x1 + BORDER_THICKNESS, y1 + BORDER_THICKNESS); - rdpq_fill_rectangle(x0 - BORDER_THICKNESS, y0, x0, y1); rdpq_fill_rectangle(x1, y0, x1 + BORDER_THICKNESS, y1); rdpq_mode_pop(); } +/** + * @brief Draw a border with the default border color. + * + * @param x0 The x-coordinate of the top-left corner. + * @param y0 The y-coordinate of the top-left corner. + * @param x1 The x-coordinate of the bottom-right corner. + * @param y1 The y-coordinate of the bottom-right corner. + */ +void ui_components_border_draw (int x0, int y0, int x1, int y1) { + ui_components_border_draw_internal(x0, y0, x1, y1, BORDER_COLOR); +} + +/** + * @brief Draw the layout with tabs. + */ +void ui_components_layout_draw_tabbed (void) { + ui_components_border_draw( + VISIBLE_AREA_X0, + VISIBLE_AREA_Y0 + TAB_HEIGHT + BORDER_THICKNESS, + VISIBLE_AREA_X1, + VISIBLE_AREA_Y1 + ); + + ui_components_box_draw( + VISIBLE_AREA_X0, + LAYOUT_ACTIONS_SEPARATOR_Y, + VISIBLE_AREA_X1, + LAYOUT_ACTIONS_SEPARATOR_Y + BORDER_THICKNESS, + BORDER_COLOR + ); +} + +/** + * @brief Draw the layout. + */ void ui_components_layout_draw (void) { ui_components_border_draw( VISIBLE_AREA_X0, @@ -41,6 +96,15 @@ void ui_components_layout_draw (void) { ); } +/** + * @brief Draw a progress bar. + * + * @param x0 The x-coordinate of the top-left corner. + * @param y0 The y-coordinate of the top-left corner. + * @param x1 The x-coordinate of the bottom-right corner. + * @param y1 The y-coordinate of the bottom-right corner. + * @param progress The progress value (0.0 to 1.0). + */ void ui_components_progressbar_draw (int x0, int y0, int x1, int y1, float progress) { float progress_width = progress * (x1 - x0); @@ -48,6 +112,11 @@ void ui_components_progressbar_draw (int x0, int y0, int x1, int y1, float progr ui_components_box_draw(x0 + progress_width, y0, x1, y1, PROGRESSBAR_BG_COLOR); } +/** + * @brief Draw a seek bar. + * + * @param position The position value (0.0 to 1.0). + */ void ui_components_seekbar_draw (float position) { int x0 = SEEKBAR_X; int y0 = SEEKBAR_Y; @@ -58,6 +127,11 @@ void ui_components_seekbar_draw (float position) { ui_components_progressbar_draw(x0, y0, x1, y1, position); } +/** + * @brief Draw a loader. + * + * @param progress The progress value (0.0 to 1.0). + */ void ui_components_loader_draw (float progress) { int x0 = LOADER_X; int y0 = LOADER_Y; @@ -68,6 +142,17 @@ void ui_components_loader_draw (float progress) { ui_components_progressbar_draw(x0, y0, x1, y1, progress); } +/** + * @brief Draw a scrollbar. + * + * @param x The x-coordinate of the top-left corner. + * @param y The y-coordinate of the top-left corner. + * @param width The width of the scrollbar. + * @param height The height of the scrollbar. + * @param position The current position. + * @param items The total number of items. + * @param visible_items The number of visible items. + */ void ui_components_scrollbar_draw (int x, int y, int width, int height, int position, int items, int visible_items) { if (items <= 1 || items <= visible_items) { ui_components_box_draw(x, y, x + width, y + height, SCROLLBAR_INACTIVE_COLOR); @@ -80,6 +165,13 @@ void ui_components_scrollbar_draw (int x, int y, int width, int height, int posi } } +/** + * @brief Draw a list scrollbar. + * + * @param position The current position. + * @param items The total number of items. + * @param visible_items The number of visible items. + */ void ui_components_list_scrollbar_draw (int position, int items, int visible_items) { ui_components_scrollbar_draw( LIST_SCROLLBAR_X, @@ -92,6 +184,12 @@ void ui_components_list_scrollbar_draw (int position, int items, int visible_ite ); } +/** + * @brief Draw a dialog box. + * + * @param width The width of the dialog box. + * @param height The height of the dialog box. + */ void ui_components_dialog_draw (int width, int height) { int x0 = DISPLAY_CENTER_X - (width / 2); int y0 = DISPLAY_CENTER_Y - (height / 2); @@ -102,6 +200,12 @@ void ui_components_dialog_draw (int width, int height) { ui_components_box_draw(x0, y0, x1, y1, DIALOG_BG_COLOR); } +/** + * @brief Draw a message box with formatted text. + * + * @param fmt The format string. + * @param ... The format arguments. + */ void ui_components_messagebox_draw (char *fmt, ...) { char buffer[512]; size_t nbytes = sizeof(buffer); @@ -136,6 +240,14 @@ void ui_components_messagebox_draw (char *fmt, ...) { rdpq_paragraph_free(paragraph); } +/** + * @brief Draw the main text with formatted content. + * + * @param align The horizontal alignment. + * @param valign The vertical alignment. + * @param fmt The format string. + * @param ... The format arguments. + */ void ui_components_main_text_draw (rdpq_align_t align, rdpq_valign_t valign, char *fmt, ...) { char buffer[1024]; size_t nbytes = sizeof(buffer); @@ -166,6 +278,14 @@ void ui_components_main_text_draw (rdpq_align_t align, rdpq_valign_t valign, cha } } +/** + * @brief Draw the actions bar text with formatted content. + * + * @param align The horizontal alignment. + * @param valign The vertical alignment. + * @param fmt The format string. + * @param ... The format arguments. + */ void ui_components_actions_bar_text_draw (rdpq_align_t align, rdpq_valign_t valign, char *fmt, ...) { char buffer[256]; size_t nbytes = sizeof(buffer); @@ -195,3 +315,81 @@ void ui_components_actions_bar_text_draw (rdpq_align_t align, rdpq_valign_t vali free(formatted); } } + +/** + * @brief Draw the tabs. + * + * @param text Array of tab text. + * @param count Number of tabs. + * @param selected Index of the selected tab. + * @param width Width of each tab. + */ +void ui_components_tabs_draw(const char **text, int count, int selected, float width ) { + float starting_x = VISIBLE_AREA_X0; + + float x = starting_x; + float y = OVERSCAN_HEIGHT; + float height = TAB_HEIGHT; + + // first draw the tabs that are not selected + for(int i=0;i< count;i++) { + if(i != selected) { + ui_components_box_draw( + x, + y, + x + width, + y + height, + TAB_INACTIVE_BACKGROUND_COLOR + ); + + ui_components_border_draw_internal( + x, + y, + x + width, + y + height, + TAB_INACTIVE_BORDER_COLOR + ); + } + x += width; + } + + // draw the selected tab (so it shows up on top of the others) + if(selected >= 0 && selected < count) { + x = starting_x + (width * selected); + + ui_components_box_draw( + x, + y, + x + width, + y + height, + TAB_ACTIVE_BACKGROUND_COLOR + ); + + ui_components_border_draw_internal( + x, + y, + x + width, + y + height, + TAB_ACTIVE_BORDER_COLOR + ); + } + + // write the text on the tabs + rdpq_textparms_t tab_textparms = { + .width = width, + .height = 24, + .align = ALIGN_CENTER, + .wrap = WRAP_NONE + }; + x = starting_x; + for(int i=0;i< count;i++) { + rdpq_text_print( + &tab_textparms, + FNT_DEFAULT, + x, + y, + text[i] + ); + x += width; + } +} diff --git a/src/menu/ui_components/constants.h b/src/menu/ui_components/constants.h index c468a327..42893a9d 100644 --- a/src/menu/ui_components/constants.h +++ b/src/menu/ui_components/constants.h @@ -7,6 +7,12 @@ #ifndef COMPONENTS_CONSTANTS_H__ #define COMPONENTS_CONSTANTS_H__ +/** @brief The height of the tabs in the main menu. */ +#define TAB_HEIGHT (20) + +/** @brief The thickness of borders. */ +#define BORDER_THICKNESS (4) + /** @brief The display width. */ #define DISPLAY_WIDTH (640) /** @brief The display height. */ @@ -36,9 +42,7 @@ /** @brief The height of the visible display. */ #define VISIBLE_AREA_HEIGHT (VISIBLE_AREA_Y1 - VISIBLE_AREA_Y0) -/** @brief The thickness of borders. */ -#define BORDER_THICKNESS (4) - +/** @brief The layout actions separator Y position. */ #define LAYOUT_ACTIONS_SEPARATOR_Y (400) /** @brief The seek bar height. */ @@ -64,9 +68,13 @@ /** @brief The margin of a message box. */ #define MESSAGEBOX_MARGIN (32) +/** @brief The horizontal text margin. */ #define TEXT_MARGIN_HORIZONTAL (10) +/** @brief The vertical text margin. */ #define TEXT_MARGIN_VERTICAL (6) +/** @brief The vertical text offset. */ #define TEXT_OFFSET_VERTICAL (1) +/** @brief The text line spacing adjustment. */ #define TEXT_LINE_SPACING_ADJUST (0) /** @brief The boxart picture width. */ @@ -76,7 +84,7 @@ /** @brief The boxart picture width (64DD). */ #define BOXART_WIDTH_DD (129) -/** @brief The boxart picture height. */ +/** @brief The boxart picture height (64DD). */ #define BOXART_HEIGHT_DD (112) /** @brief The boxart picture maximum width. */ @@ -88,12 +96,12 @@ #define BOXART_X (VISIBLE_AREA_X1 - BOXART_WIDTH - 24) /** @brief The box art position on the Y axis. */ #define BOXART_Y (LAYOUT_ACTIONS_SEPARATOR_Y - BOXART_HEIGHT - 24) -/** @brief The box art position on the X axis for japanese caratules.*/ +/** @brief The box art position on the X axis for Japanese caratules. */ #define BOXART_X_JP (VISIBLE_AREA_X1 - BOXART_WIDTH_MAX + 21) -/** @brief The box art position on the Y axis for japanese caratules. */ +/** @brief The box art position on the Y axis for Japanese caratules. */ #define BOXART_Y_JP (LAYOUT_ACTIONS_SEPARATOR_Y - BOXART_HEIGHT_MAX - 24) -/** @brief The box art position on the X axis for 64DD caratules.*/ +/** @brief The box art position on the X axis for 64DD caratules. */ #define BOXART_X_DD (VISIBLE_AREA_X1 - BOXART_WIDTH_DD - 23) /** @brief The box art position on the Y axis for 64DD caratules. */ #define BOXART_Y_DD (LAYOUT_ACTIONS_SEPARATOR_Y - BOXART_HEIGHT_DD - 24) @@ -101,17 +109,19 @@ /** @brief The scroll bar width. */ #define LIST_SCROLLBAR_WIDTH (12) /** @brief The scroll bar height. */ -#define LIST_SCROLLBAR_HEIGHT (LAYOUT_ACTIONS_SEPARATOR_Y - OVERSCAN_HEIGHT) +#define LIST_SCROLLBAR_HEIGHT (LAYOUT_ACTIONS_SEPARATOR_Y - OVERSCAN_HEIGHT - TAB_HEIGHT - BORDER_THICKNESS) /** @brief The scroll bar position on the X axis. */ #define LIST_SCROLLBAR_X (VISIBLE_AREA_X1 - LIST_SCROLLBAR_WIDTH) /** @brief The scroll bar position on the Y axis. */ -#define LIST_SCROLLBAR_Y (VISIBLE_AREA_Y0) +#define LIST_SCROLLBAR_Y (VISIBLE_AREA_Y0 + TAB_HEIGHT + BORDER_THICKNESS) /** @brief The maximum amount of file list entries. */ -#define LIST_ENTRIES (19) +#define LIST_ENTRIES (18) /** @brief The maximum width available for a file list entry. */ #define FILE_LIST_MAX_WIDTH (480) +/** @brief The file list highlight width. */ #define FILE_LIST_HIGHLIGHT_WIDTH (VISIBLE_AREA_X1 - VISIBLE_AREA_X0 - LIST_SCROLLBAR_WIDTH) +/** @brief The file list highlight X position. */ #define FILE_LIST_HIGHLIGHT_X (VISIBLE_AREA_X0) /** @brief The default background colour. */ @@ -140,11 +150,19 @@ /** @brief The boxart loading colour. */ #define BOXART_LOADING_COLOR RGBA32(0x3F, 0x3F, 0x3F, 0xFF) -/** @brief The filelist highlight colour. */ +/** @brief The file list highlight colour. */ #define FILE_LIST_HIGHLIGHT_COLOR RGBA32(0x3F, 0x3F, 0x3F, 0xFF) /** @brief The menu highlight colour. */ #define CONTEXT_MENU_HIGHLIGHT_COLOR RGBA32(0x3F, 0x3F, 0x3F, 0xFF) +/** @brief The tab inactive border colour. */ +#define TAB_INACTIVE_BORDER_COLOR RGBA32(0x5F, 0x5F, 0x5F, 0xFF) +/** @brief The tab active border colour. */ +#define TAB_ACTIVE_BORDER_COLOR RGBA32(0xFF, 0xFF, 0xFF, 0xFF) +/** @brief The tab inactive background colour. */ +#define TAB_INACTIVE_BACKGROUND_COLOR RGBA32(0x3F, 0x3F, 0x3F, 0xFF) +/** @brief The tab active background colour. */ +#define TAB_ACTIVE_BACKGROUND_COLOR RGBA32(0x6F, 0x6F, 0x6F, 0xFF) -#endif +#endif /* COMPONENTS_CONSTANTS_H__ */ diff --git a/src/menu/ui_components/context_menu.c b/src/menu/ui_components/context_menu.c index b08085fc..d9adbd3e 100644 --- a/src/menu/ui_components/context_menu.c +++ b/src/menu/ui_components/context_menu.c @@ -1,9 +1,20 @@ +/** + * @file context_menu.c + * @brief Context menu component implementation + * @ingroup ui_components + */ + #include "../ui_components.h" #include "../fonts.h" #include "../sound.h" #include "constants.h" - +/** + * @brief Get the current submenu. + * + * @param cm Pointer to the context menu component. + * @return component_context_menu_t* Pointer to the current submenu. + */ static component_context_menu_t *get_current_submenu (component_context_menu_t *cm) { while (cm->submenu != NULL) { cm = cm->submenu; @@ -11,7 +22,11 @@ static component_context_menu_t *get_current_submenu (component_context_menu_t * return cm; } - +/** + * @brief Initialize the context menu component. + * + * @param cm Pointer to the context menu component. + */ void ui_components_context_menu_init (component_context_menu_t *cm) { cm->row_selected = -1; cm->row_count = 0; @@ -22,11 +37,23 @@ void ui_components_context_menu_init (component_context_menu_t *cm) { } } +/** + * @brief Show the context menu component. + * + * @param cm Pointer to the context menu component. + */ void ui_components_context_menu_show (component_context_menu_t *cm) { cm->row_selected = 0; cm->submenu = NULL; } +/** + * @brief Process the context menu actions. + * + * @param menu Pointer to the menu structure. + * @param cm Pointer to the context menu component. + * @return true if the context menu is processed, false otherwise. + */ bool ui_components_context_menu_process (menu_t *menu, component_context_menu_t *cm) { if (!cm || (cm->row_selected < 0)) { return false; @@ -71,6 +98,11 @@ bool ui_components_context_menu_process (menu_t *menu, component_context_menu_t return true; } +/** + * @brief Draw the context menu component. + * + * @param cm Pointer to the context menu component. + */ void ui_components_context_menu_draw (component_context_menu_t *cm) { if (!cm || (cm->row_selected < 0)) { return; diff --git a/src/menu/ui_components/file_list.c b/src/menu/ui_components/file_list.c index af10e3a0..45348aab 100644 --- a/src/menu/ui_components/file_list.c +++ b/src/menu/ui_components/file_list.c @@ -1,13 +1,24 @@ +/** + * @file file_list.c + * @brief File list component implementation + * @ingroup ui_components + */ + #include #include "../ui_components.h" #include "../fonts.h" #include "constants.h" - static const char *dir_prefix = "/"; - +/** + * @brief Format the file size into a human-readable string. + * + * @param buffer Buffer to store the formatted string. + * @param size Size of the file. + * @return int Number of characters written to the buffer. + */ static int format_file_size (char *buffer, int64_t size) { if (size < 0) { return sprintf(buffer, "unknown"); @@ -24,7 +35,13 @@ static int format_file_size (char *buffer, int64_t size) { } } - +/** + * @brief Draw the file list component. + * + * @param list Pointer to the list of entries. + * @param entries Number of entries in the list. + * @param selected Index of the currently selected entry. + */ void ui_components_file_list_draw (entry_t *list, int entries, int selected) { int starting_position = 0; @@ -40,6 +57,7 @@ void ui_components_file_list_draw (entry_t *list, int entries, int selected) { if (entries == 0) { ui_components_main_text_draw( ALIGN_LEFT, VALIGN_TOP, + "\n" "^%02X** empty directory **", STL_GRAY ); @@ -115,7 +133,7 @@ void ui_components_file_list_draw (entry_t *list, int entries, int selected) { layout = rdpq_paragraph_builder_end(); int highlight_height = (layout->bbox.y1 - layout->bbox.y0) / layout->nlines; - int highlight_y = VISIBLE_AREA_Y0 + TEXT_MARGIN_VERTICAL + TEXT_OFFSET_VERTICAL + ((selected - starting_position) * highlight_height); + int highlight_y = VISIBLE_AREA_Y0 + TAB_HEIGHT + TEXT_MARGIN_VERTICAL + TEXT_OFFSET_VERTICAL + ((selected - starting_position) * highlight_height); ui_components_box_draw( FILE_LIST_HIGHLIGHT_X, @@ -128,7 +146,7 @@ void ui_components_file_list_draw (entry_t *list, int entries, int selected) { rdpq_paragraph_render( layout, VISIBLE_AREA_X0 + TEXT_MARGIN_HORIZONTAL, - VISIBLE_AREA_Y0 + TEXT_MARGIN_VERTICAL + TEXT_OFFSET_VERTICAL + VISIBLE_AREA_Y0 + TEXT_MARGIN_VERTICAL + TAB_HEIGHT + TEXT_OFFSET_VERTICAL ); rdpq_paragraph_free(layout); @@ -166,7 +184,7 @@ void ui_components_file_list_draw (entry_t *list, int entries, int selected) { rdpq_paragraph_render( layout, VISIBLE_AREA_X0 + TEXT_MARGIN_HORIZONTAL, - VISIBLE_AREA_Y0 + TEXT_MARGIN_VERTICAL + TEXT_OFFSET_VERTICAL + VISIBLE_AREA_Y0 + TEXT_MARGIN_VERTICAL + TAB_HEIGHT + TEXT_OFFSET_VERTICAL ); rdpq_paragraph_free(layout); diff --git a/src/menu/ui_components/tabs.c b/src/menu/ui_components/tabs.c new file mode 100644 index 00000000..5ec90604 --- /dev/null +++ b/src/menu/ui_components/tabs.c @@ -0,0 +1,28 @@ +/** + * @file tabs.c + * @brief Tabs component implementation + * @ingroup ui_components + */ + +#include "../ui_components.h" +#include "constants.h" + +/** @brief Common tabs used for the main menu */ +static const char *tabs[] = { + "Files", + "History", + "Favorites", + NULL +}; + +/** + * @brief Draws the common tabs used for the main menu. + * + * @param selected The index of the currently selected tab. + */ +void ui_components_tabs_common_draw(int selected) +{ + uint8_t tabs_count = 3; + float width = (VISIBLE_AREA_X1 - VISIBLE_AREA_X0 - 8.0f) / (tabs_count + 1 * 0.5f); + ui_components_tabs_draw(tabs, tabs_count, selected, width); +} \ No newline at end of file diff --git a/src/menu/usb_comm.c b/src/menu/usb_comm.c index 2cf7cf8a..7801ce47 100644 --- a/src/menu/usb_comm.c +++ b/src/menu/usb_comm.c @@ -1,3 +1,9 @@ +/** + * @file usb_comm.c + * @brief USB communication component implementation + * @ingroup ui_components + */ + // NOTE: This code doesn't implement EverDrive-64 USB protocol. // Main use of these functions is to aid menu development // (for example replace files on the SD card or reboot menu). @@ -10,10 +16,8 @@ #include "usb_comm.h" #include "utils/utils.h" - #define MAX_FILE_SIZE MiB(4) - /** @brief The supported USB commands structure. */ typedef struct { /** @brief The command identifier. */ @@ -23,7 +27,11 @@ typedef struct { void (*op) (menu_t *menu); } usb_comm_command_t; - +/** + * @brief Get a character from the USB input. + * + * @return int The character read, or -1 if no character is available. + */ static int usb_comm_get_char (void) { char c; @@ -36,6 +44,14 @@ static int usb_comm_get_char (void) { return (int) (c); } +/** + * @brief Read a string from the USB input. + * + * @param string Buffer to store the string. + * @param length Maximum length of the string. + * @param end Character indicating the end of the string. + * @return true if the string was read successfully, false otherwise. + */ static bool usb_comm_read_string (char *string, int length, char end) { for (int i = 0; i < length; i++) { int c = usb_comm_get_char(); @@ -59,12 +75,21 @@ static bool usb_comm_read_string (char *string, int length, char end) { return false; } +/** + * @brief Send an error message over USB. + * + * @param message The error message. + */ static void usb_comm_send_error (const char *message) { usb_purge(); usb_write(DATATYPE_TEXT, message, strlen(message)); } - +/** + * @brief Reboot the system. + * + * @param menu Pointer to the menu structure. + */ static void command_reboot (menu_t *menu) { menu->next_mode = MENU_MODE_BOOT; @@ -72,8 +97,13 @@ static void command_reboot (menu_t *menu) { menu->boot_params->tv_type = BOOT_TV_TYPE_PASSTHROUGH; menu->boot_params->detect_cic_seed = true; menu->boot_params->cheat_list = NULL; -}; +} +/** + * @brief Receive a file over USB and save it to the storage. + * + * @param menu Pointer to the menu structure. + */ static void command_send_file (menu_t *menu) { FILE *f; char buffer[256]; @@ -132,7 +162,11 @@ static usb_comm_command_t commands[] = { { .id = NULL }, }; - +/** + * @brief Poll the USB input for commands. + * + * @param menu Pointer to the menu structure. + */ void usb_comm_poll (menu_t *menu) { uint32_t header = usb_poll(); diff --git a/src/menu/views/browser.c b/src/menu/views/browser.c index 62ff2129..37c61dc7 100644 --- a/src/menu/views/browser.c +++ b/src/menu/views/browser.c @@ -36,6 +36,52 @@ static const char *hidden_paths[] = { NULL, }; +struct substr { const char *str; size_t len; }; +#define substr(str) ((struct substr){ str, sizeof(str) - 1 }) + +static const struct substr hidden_basenames[] = { + substr("desktop.ini"), // Windows Explorer settings + substr("Thumbs.db"), // Windows Explorer thumbnails + substr(".DS_Store"), // macOS Finder settings +}; +#define HIDDEN_BASENAMES_COUNT (sizeof(hidden_basenames) / sizeof(hidden_basenames[0])) + +static const struct substr hidden_prefixes[] = { + substr("._"), // macOS "AppleDouble" metadata files +}; +#define HIDDEN_PREFIXES_COUNT (sizeof(hidden_prefixes) / sizeof(hidden_prefixes[0])) + + +static bool path_is_hidden (path_t *path) { + char *stripped_path = strip_fs_prefix(path_get(path)); + + // Check for hidden files based on full path + for (int i = 0; hidden_paths[i] != NULL; i++) { + if (strcmp(stripped_path, hidden_paths[i]) == 0) { + return true; + } + } + + char *basename = file_basename(stripped_path); + int basename_len = strlen(basename); + + // Check for hidden files based on filename + for (int i = 0; i < HIDDEN_BASENAMES_COUNT; i++) { + if (basename_len == hidden_basenames[i].len && + strncmp(basename, hidden_basenames[i].str, hidden_basenames[i].len) == 0) { + return true; + } + } + // Check for hidden files based on filename prefix + for (int i = 0; i < HIDDEN_PREFIXES_COUNT; i++) { + if (basename_len > hidden_prefixes[i].len && + strncmp(basename, hidden_prefixes[i].str, hidden_prefixes[i].len) == 0) { + return true; + } + } + + return false; +} static int compare_entry (const void *pa, const void *pb) { entry_t *a = (entry_t *) (pa); @@ -108,14 +154,7 @@ static bool load_directory (menu_t *menu) { if (!menu->settings.show_protected_entries) { path_push(path, info.d_name); - - for (int i = 0; hidden_paths[i] != NULL; i++) { - if (strcmp(strip_fs_prefix(path_get(path)), hidden_paths[i]) == 0) { - hide = true; - break; - } - } - + hide = path_is_hidden(path); path_pop(path); } @@ -358,16 +397,21 @@ static void process (menu_t *menu) { } else if (menu->actions.settings) { ui_components_context_menu_show(&settings_context_menu); sound_play_effect(SFX_SETTING); + } else if (menu->actions.next_tab) { + menu->next_mode = MENU_MODE_HISTORY; + } else if (menu->actions.previous_tab) { + menu->next_mode = MENU_MODE_FAVORITE; } } - static void draw (menu_t *menu, surface_t *d) { rdpq_attach(d, NULL); ui_components_background_draw(); - ui_components_layout_draw(); + ui_components_tabs_common_draw(0); + + ui_components_layout_draw_tabbed(); ui_components_file_list_draw(menu->browser.list, menu->browser.entries, menu->browser.selected); @@ -395,7 +439,7 @@ static void draw (menu_t *menu, surface_t *d) { ui_components_actions_bar_text_draw( ALIGN_RIGHT, VALIGN_TOP, - "Start: Settings\n" + "^%02XStart: Settings^00\n" "^%02XR: Options^00", menu->browser.entries == 0 ? STL_GRAY : STL_DEFAULT ); @@ -403,10 +447,16 @@ static void draw (menu_t *menu, surface_t *d) { if (menu->current_time >= 0) { ui_components_actions_bar_text_draw( ALIGN_CENTER, VALIGN_TOP, - "\n" + "\n" "%s", ctime(&menu->current_time) ); + } else { + ui_components_actions_bar_text_draw( + ALIGN_CENTER, VALIGN_TOP, + "\n" + "\n" + ); } ui_components_context_menu_draw(&entry_context_menu); diff --git a/src/menu/views/credits.c b/src/menu/views/credits.c index e4ddb9c3..9ed6cc55 100644 --- a/src/menu/views/credits.c +++ b/src/menu/views/credits.c @@ -36,14 +36,14 @@ static void draw (menu_t *menu, surface_t *d) { "Menu version: %s\n" "Build timestamp: %s\n" "\n" - "Github:\n" + "Github - Website:\n" " https://github.com/Polprzewodnikowy/N64FlashcartMenu\n" "Authors:\n" " Robin Jones / NetworkFusion\n" " Mateusz Faderewski / Polprzewodnikowy\n" - "Credits:\n" - " N64Brew / libDragon contributors\n" - "\n" + "Contributors:\n" + " Thank you to ALL project contributors,\n" + " no matter how small the commit.\n" "OSS software used:\n" " libdragon (UNLICENSE License)\n" " libspng (BSD 2-Clause License)\n" diff --git a/src/menu/views/flashcart_info.c b/src/menu/views/flashcart_info.c index 64ee2060..2a5c968c 100644 --- a/src/menu/views/flashcart_info.c +++ b/src/menu/views/flashcart_info.c @@ -70,6 +70,7 @@ static void draw (menu_t *menu, surface_t *d) { " Region Detection: %s.\n" " Save Writeback: %s.\n" " Auto F/W Updates: %s.\n" + " Fast ROM Reboots: %s.\n" "\n\n", format_cart_type(), format_cart_version(), @@ -79,7 +80,8 @@ static void draw (menu_t *menu, surface_t *d) { format_boolean_type(flashcart_has_feature(FLASHCART_FEATURE_AUTO_CIC)), format_boolean_type(flashcart_has_feature(FLASHCART_FEATURE_AUTO_REGION)), format_boolean_type(flashcart_has_feature(FLASHCART_FEATURE_SAVE_WRITEBACK)), - format_boolean_type(flashcart_has_feature(FLASHCART_FEATURE_BIOS_UPDATE_FROM_MENU)) + format_boolean_type(flashcart_has_feature(FLASHCART_FEATURE_BIOS_UPDATE_FROM_MENU)), + format_boolean_type(flashcart_has_feature(FLASHCART_FEATURE_ROM_REBOOT_FAST)) //TODO: display the battery and temperature information (if available). //format_diagnostic_data(flashcart_has_feature(FLASHCART_FEATURE_DIAGNOSTIC_DATA)) diff --git a/src/menu/views/history_favorites.c b/src/menu/views/history_favorites.c new file mode 100644 index 00000000..10e0c72e --- /dev/null +++ b/src/menu/views/history_favorites.c @@ -0,0 +1,217 @@ +#include +#include "views.h" +#include "../bookkeeping.h" +#include "../fonts.h" +#include "../ui_components/constants.h" +#include "../sound.h" + + +typedef enum { + BOOKKEEPING_TAB_CONTEXT_HISTORY, + BOOKKEEPING_TAB_CONTEXT_FAVORITE, + BOOKKEEPING_TAB_CONTEXT_NONE +} bookkeeping_tab_context_t; + + +static bookkeeping_tab_context_t tab_context = BOOKKEEPING_TAB_CONTEXT_NONE; +static int selected_item = -1; +static bookkeeping_item_t *item_list; +static int item_max; + + +static void reset_selected(menu_t *menu) { + selected_item = -1; + + for(unsigned int i=0; i= item_max) { + selected_item = last; + break; + } else if(item_list[selected_item].bookkeeping_type != BOOKKEEPING_TYPE_EMPTY) { + sound_play_effect(SFX_CURSOR); + break; + } + } while (true); +} + +static void move_back() { + int last = selected_item; + do + { + selected_item--; + + if(selected_item < 0) { + selected_item = last; + break; + } else if(item_list[selected_item].bookkeeping_type != BOOKKEEPING_TYPE_EMPTY) { + sound_play_effect(SFX_CURSOR); + break; + } + } while (true); +} + +static void process(menu_t *menu) { + if(menu->actions.go_down) { + move_next(); + } else if(menu->actions.go_up) { + move_back(); + } else if(menu->actions.enter && selected_item != -1) { + + if(tab_context == BOOKKEEPING_TAB_CONTEXT_FAVORITE) { + menu->load.load_favorite = selected_item; + } else if(tab_context == BOOKKEEPING_TAB_CONTEXT_HISTORY) { + menu->load.load_history = selected_item; + } + + if(item_list[selected_item].bookkeeping_type == BOOKKEEPING_TYPE_DISK) { + menu->next_mode = MENU_MODE_LOAD_DISK; + sound_play_effect(SFX_ENTER); + } else if(item_list[selected_item].bookkeeping_type == BOOKKEEPING_TYPE_ROM) { + menu->next_mode = MENU_MODE_LOAD_ROM; + sound_play_effect(SFX_ENTER); + } + } else if (menu->actions.previous_tab) { + if(tab_context == BOOKKEEPING_TAB_CONTEXT_FAVORITE) { + menu->next_mode = MENU_MODE_HISTORY; + } else if(tab_context == BOOKKEEPING_TAB_CONTEXT_HISTORY) { + menu->next_mode = MENU_MODE_BROWSER; + } + } else if (menu->actions.next_tab) { + if(tab_context == BOOKKEEPING_TAB_CONTEXT_FAVORITE) { + menu->next_mode = MENU_MODE_BROWSER; + } else if(tab_context == BOOKKEEPING_TAB_CONTEXT_HISTORY) { + menu->next_mode = MENU_MODE_FAVORITE; + } + }else if(tab_context == BOOKKEEPING_TAB_CONTEXT_FAVORITE && menu->actions.options && selected_item != -1) { + bookkeeping_favorite_remove(&menu->bookkeeping, selected_item); + reset_selected(menu); + sound_play_effect(SFX_SETTING); + } +} + +static void draw_list(menu_t *menu, surface_t *display) { + if(selected_item != -1) { + float highlight_y = VISIBLE_AREA_Y0 + TEXT_MARGIN_VERTICAL + TAB_HEIGHT + TEXT_OFFSET_VERTICAL + (selected_item * 20 * 2); + + ui_components_box_draw( + VISIBLE_AREA_X0, + highlight_y, + VISIBLE_AREA_X0 + FILE_LIST_HIGHLIGHT_WIDTH + LIST_SCROLLBAR_WIDTH, + highlight_y + 40, + FILE_LIST_HIGHLIGHT_COLOR + ); + } + + char buffer[1024]; + buffer[0] = 0; + + for(unsigned int i=0; i < item_max; i++) { + if(path_has_value(item_list[i].primary_path)) { + sprintf(buffer, "%s%d : %s\n",buffer ,(i+1), path_last_get(item_list[i].primary_path)); + } else { + sprintf(buffer, "%s%d : \n",buffer ,(i+1)); + } + + if(path_has_value(item_list[i].secondary_path)) { + sprintf(buffer, "%s %s\n", buffer, path_last_get(item_list[i].secondary_path)); + } else { + sprintf(buffer, "%s\n", buffer); + } + } + + int nbytes = strlen(buffer); + rdpq_text_printn( + &(rdpq_textparms_t) { + .width = VISIBLE_AREA_WIDTH - (TEXT_MARGIN_HORIZONTAL * 2), + .height = LAYOUT_ACTIONS_SEPARATOR_Y - OVERSCAN_HEIGHT - (TEXT_MARGIN_VERTICAL * 2), + .align = ALIGN_LEFT, + .valign = VALIGN_TOP, + .wrap = WRAP_ELLIPSES, + .line_spacing = TEXT_OFFSET_VERTICAL, + }, + FNT_DEFAULT, + VISIBLE_AREA_X0 + TEXT_MARGIN_HORIZONTAL, + VISIBLE_AREA_Y0 + TEXT_MARGIN_VERTICAL + TAB_HEIGHT + TEXT_OFFSET_VERTICAL, + buffer, + nbytes + ); +} + +static void draw(menu_t *menu, surface_t *display) { + rdpq_attach(display, NULL); + + ui_components_background_draw(); + + if(tab_context == BOOKKEEPING_TAB_CONTEXT_FAVORITE) { + ui_components_tabs_common_draw(2); + } else if(tab_context == BOOKKEEPING_TAB_CONTEXT_HISTORY) { + ui_components_tabs_common_draw(1); + } + + ui_components_layout_draw_tabbed(); + + draw_list(menu, display); + + if(selected_item != -1) { + ui_components_actions_bar_text_draw( + ALIGN_LEFT, VALIGN_TOP, + "A: Load Game\n" + "\n" + ); + + if(tab_context == BOOKKEEPING_TAB_CONTEXT_FAVORITE && selected_item != -1) { + ui_components_actions_bar_text_draw( + ALIGN_RIGHT, VALIGN_TOP, + "R: Remove item\n" + "\n" + ); + } + } + + ui_components_actions_bar_text_draw( + ALIGN_CENTER, VALIGN_TOP, + "\n" + "\n" + ); + + rdpq_detach_show(); +} + +void view_favorite_init (menu_t *menu) { + tab_context = BOOKKEEPING_TAB_CONTEXT_FAVORITE; + item_list = menu->bookkeeping.favorite_items; + item_max = FAVORITES_COUNT; + + reset_selected(menu); +} + +void view_favorite_display (menu_t *menu, surface_t *display) { + process(menu); + draw(menu, display); +} + +void view_history_init (menu_t *menu) { + tab_context = BOOKKEEPING_TAB_CONTEXT_HISTORY; + item_list = menu->bookkeeping.history_items; + item_max = HISTORY_COUNT; + + reset_selected(menu); +} + +void view_history_display (menu_t *menu, surface_t *display) { + process(menu); + draw(menu, display); +} diff --git a/src/menu/views/load_disk.c b/src/menu/views/load_disk.c index f266021b..0fb5129c 100644 --- a/src/menu/views/load_disk.c +++ b/src/menu/views/load_disk.c @@ -3,9 +3,10 @@ #include "boot/boot.h" #include "../sound.h" #include "views.h" +#include "../bookkeeping.h" static component_boxart_t *boxart; - +static char *disk_filename; static char *convert_error_message (disk_err_t err) { switch (err) { @@ -26,7 +27,21 @@ static char *format_disk_region (disk_region_t region) { } +static void add_favorite (menu_t *menu, void *arg) { + bookkeeping_favorite_add(&menu->bookkeeping, menu->load.disk_path, menu->load.rom_path, BOOKKEEPING_TYPE_DISK); +} + +static component_context_menu_t options_context_menu = { .list = { + { .text = "Add to favorites", .action = add_favorite }, + COMPONENT_CONTEXT_MENU_LIST_END, +}}; + + static void process (menu_t *menu) { + if (ui_components_context_menu_process(menu, &options_context_menu)) { + return; + } + if (menu->actions.enter) { menu->boot_pending.disk_file = true; menu->load.combined_disk_rom = false; @@ -37,6 +52,9 @@ static void process (menu_t *menu) { } else if (menu->actions.back) { sound_play_effect(SFX_EXIT); menu->next_mode = MENU_MODE_BROWSER; + } else if (menu->actions.options) { + ui_components_context_menu_show(&options_context_menu); + sound_play_effect(SFX_SETTING); } } @@ -55,45 +73,64 @@ static void draw (menu_t *menu, surface_t *d) { "64DD disk information\n" "\n" "%s", - menu->browser.entry->name + disk_filename ); ui_components_main_text_draw( ALIGN_LEFT, VALIGN_TOP, + "\n\n\n\n" + "%s%s\n", + menu->load.rom_path ? "Loaded ROM:\t" : "", + menu->load.rom_path ? path_last_get(menu->load.rom_path) : "" + ); + + ui_components_main_text_draw( + ALIGN_LEFT, VALIGN_TOP, + "\n\n\n\n\n\n" + "Description:\n\t%s\n", + "None." + ); + + ui_components_main_text_draw( + ALIGN_LEFT, VALIGN_TOP, + "\n\n\n\n\n\n\n\n\n\n\n\n" + " Region:\t\t%s\n" + " Unique ID:\t%.4s\n" + " Version:\t%hhu\n" + " Disk type:\t%d\n" "\n" - "\n" - "\n" - "\n" - " Region: %s\n" - " Unique ID: %.4s\n" - " Version: %hhu\n" - " Disk type: %d\n" - "\n" - " %s%s", + , format_disk_region(menu->load.disk_info.region), menu->load.disk_info.id, menu->load.disk_info.version, - menu->load.disk_info.disk_type, - menu->load.rom_path ? "ROM: " : "", - menu->load.rom_path ? path_last_get(menu->load.rom_path) : "" + menu->load.disk_info.disk_type ); ui_components_actions_bar_text_draw( ALIGN_LEFT, VALIGN_TOP, "A: Load and run 64DD disk\n" - "B: Exit" + "B: Exit\n" ); if (menu->load.rom_path) { ui_components_actions_bar_text_draw( ALIGN_RIGHT, VALIGN_TOP, "L|Z: Load with ROM\n" + "R: Options\n" + ); + } else { + ui_components_actions_bar_text_draw( + ALIGN_RIGHT, VALIGN_TOP, + "\n" + "R: Options\n" ); } if (boxart != NULL) { ui_components_boxart_draw(boxart); } + + ui_components_context_menu_draw(&options_context_menu); } rdpq_detach_show(); @@ -130,6 +167,7 @@ static void load (menu_t *menu) { return; } + bookkeeping_history_add(&menu->bookkeeping, menu->load.disk_path, menu->load.rom_path, BOOKKEEPING_TYPE_DISK); menu->next_mode = MENU_MODE_BOOT; if (menu->load.combined_disk_rom) { @@ -154,6 +192,27 @@ static void deinit (void) { ui_components_boxart_free(boxart); } +static bool load_rom(menu_t* menu, path_t* rom_path) { + if(path_has_value(rom_path)) { + if (menu->load.rom_path) { + path_free(menu->load.rom_path); + menu->load.rom_path = NULL; + } + + menu->load.rom_path = path_clone(rom_path); + + rom_err_t err = rom_info_load(rom_path, &menu->load.rom_info); + if (err != ROM_OK) { + path_free(menu->load.rom_path); + menu->load.rom_path = NULL; + menu_show_error(menu, convert_error_message(err)); + return false; + } + } + + return true; +} + void view_load_disk_init (menu_t *menu) { if (menu->load.disk_path) { path_free(menu->load.disk_path); @@ -162,14 +221,41 @@ void view_load_disk_init (menu_t *menu) { menu->boot_pending.disk_file = false; - menu->load.disk_path = path_clone_push(menu->browser.directory, menu->browser.entry->name); + if(menu->load.load_history != -1 || menu->load.load_favorite != -1) { + int id = -1; + bookkeeping_item_t* items; + if(menu->load.load_history != -1) { + id = menu->load.load_history; + items = menu->bookkeeping.history_items; + } else if (menu->load.load_favorite != -1) { + id = menu->load.load_favorite; + items = menu->bookkeeping.favorite_items; + } + + menu->load.load_history = -1; + menu->load.load_favorite = -1; + + menu->load.disk_path = path_clone(items[id].primary_path); + if(!load_rom(menu, items[id].secondary_path)) { + return; + } + + } else { + menu->load.disk_path = path_clone_push(menu->browser.directory, menu->browser.entry->name); + } + + menu->load.load_favorite = -1; + menu->load.load_history = -1; + + disk_filename = path_last_get(menu->load.disk_path); disk_err_t err = disk_info_load(menu->load.disk_path, &menu->load.disk_info); if (err != DISK_OK) { menu_show_error(menu, convert_error_message(err)); return; } + ui_components_context_menu_init(&options_context_menu); boxart = ui_components_boxart_init(menu->storage_prefix, menu->load.disk_info.id, IMAGE_BOXART_FRONT); } diff --git a/src/menu/views/load_rom.c b/src/menu/views/load_rom.c index fb95003f..9fb97458 100644 --- a/src/menu/views/load_rom.c +++ b/src/menu/views/load_rom.c @@ -5,9 +5,11 @@ #include "views.h" #include #include "utils/fs.h" +#include "../bookkeeping.h" static bool show_extra_info_message = false; static component_boxart_t *boxart; +static char *rom_filename = NULL; static char *convert_error_message (rom_err_t err) { switch (err) { @@ -118,6 +120,10 @@ static const char *format_cic_type (rom_cic_type_t cic_type) { } } +static inline const char *format_boolean_type (bool bool_value) { + return bool_value ? "On" : "Off"; +} + static void set_cic_type (menu_t *menu, void *arg) { rom_cic_type_t cic_type = (rom_cic_type_t) (arg); rom_err_t err = rom_info_override_cic_type(menu->load.rom_path, &menu->load.rom_info, cic_type); @@ -156,6 +162,10 @@ static void set_autoload_type (menu_t *menu, void *arg) { menu->browser.reload = true; } +static void add_favorite (menu_t *menu, void *arg) { + bookkeeping_favorite_add(&menu->bookkeeping, menu->load.rom_path, NULL, BOOKKEEPING_TYPE_ROM); +} + static component_context_menu_t set_cic_type_context_menu = { .list = { {.text = "Automatic", .action = set_cic_type, .arg = (void *) (ROM_CIC_TYPE_AUTOMATIC) }, {.text = "CIC-6101", .action = set_cic_type, .arg = (void *) (ROM_CIC_TYPE_6101) }, @@ -199,6 +209,7 @@ static component_context_menu_t options_context_menu = { .list = { { .text = "Set Save Type", .submenu = &set_save_type_context_menu }, { .text = "Set TV Type", .submenu = &set_tv_type_context_menu }, { .text = "Set ROM to autoload", .action = set_autoload_type }, + { .text = "Add to favorites", .action = add_favorite }, COMPONENT_CONTEXT_MENU_LIST_END, }}; @@ -230,7 +241,7 @@ static void draw (menu_t *menu, surface_t *d) { ui_components_background_draw(); - if (menu->boot_pending.rom_file) { + if (menu->boot_pending.rom_file && menu->settings.loading_progress_bar_enabled) { ui_components_loader_draw(0.0f); } else { ui_components_layout_draw(); @@ -239,39 +250,44 @@ static void draw (menu_t *menu, surface_t *d) { ALIGN_CENTER, VALIGN_TOP, "N64 ROM information\n" "\n" - "%s", - menu->browser.entry->name + "%s\n", + rom_filename ); ui_components_main_text_draw( ALIGN_LEFT, VALIGN_TOP, - "\n" - "\n" - "\n" - "\n" - "Description:\n None.\n\n\n\n\n\n\n\n" - "Expansion PAK: %s\n" - "TV type: %s\n" - "CIC: %s\n" - "GS/AR Cheats: Off\n" - "Patches: Off\n" - "Save type: %s\n", + "\n\n\n\n" + "Description:\n\t%s\n", + menu->load.rom_info.metadata.description + ); + + ui_components_main_text_draw( + ALIGN_LEFT, VALIGN_TOP, + "\n\n\n\n\n\n\n\n\n\n\n\n\n" + "Expansion PAK:\t%s\n" + "TV type:\t\t\t%s\n" + "CIC:\t\t\t\t%s\n" + "Datel Cheats:\t%s\n" + "Patches:\t\t\t%s\n" + "Save type:\t\t%s\n", format_rom_expansion_pak_info(menu->load.rom_info.features.expansion_pak), format_rom_tv_type(rom_info_get_tv_type(&menu->load.rom_info)), format_cic_type(rom_info_get_cic_type(&menu->load.rom_info)), + format_boolean_type(menu->load.rom_info.settings.cheats_enabled), + format_boolean_type(menu->load.rom_info.settings.patches_enabled), format_rom_save_type(rom_info_get_save_type(&menu->load.rom_info), menu->load.rom_info.features.controller_pak) ); ui_components_actions_bar_text_draw( ALIGN_LEFT, VALIGN_TOP, "A: Load and run ROM\n" - "B: Back" + "B: Back\n" ); ui_components_actions_bar_text_draw( ALIGN_RIGHT, VALIGN_TOP, "L|Z: Extra Info\n" - "R: Options" + "R: Options\n" ); if (boxart != NULL) { @@ -327,13 +343,20 @@ static void draw_progress (float progress) { } static void load (menu_t *menu) { - cart_load_err_t err = cart_load_n64_rom_and_save(menu, draw_progress); + cart_load_err_t err; + if (!menu->settings.loading_progress_bar_enabled) { + err = cart_load_n64_rom_and_save(menu, NULL); + } else { + err = cart_load_n64_rom_and_save(menu, draw_progress); + } if (err != CART_LOAD_OK) { menu_show_error(menu, cart_load_convert_error_message(err)); return; } + bookkeeping_history_add(&menu->bookkeeping, menu->load.rom_path, NULL, BOOKKEEPING_TYPE_ROM); + menu->next_mode = MENU_MODE_BOOT; menu->boot_params->device_type = BOOT_DEVICE_TYPE_ROM; @@ -359,8 +382,19 @@ void view_load_rom_init (menu_t *menu) { path_free(menu->load.rom_path); } - menu->load.rom_path = path_clone_push(menu->browser.directory, menu->browser.entry->name); - } + if(menu->load.load_history != -1) { + menu->load.rom_path = path_clone(menu->bookkeeping.history_items[menu->load.load_history].primary_path); + } else if(menu->load.load_favorite != -1) { + menu->load.rom_path = path_clone(menu->bookkeeping.favorite_items[menu->load.load_favorite].primary_path); + } else { + menu->load.rom_path = path_clone_push(menu->browser.directory, menu->browser.entry->name); + } + + rom_filename = path_last_get(menu->load.rom_path); + } + + menu->load.load_favorite = -1; + menu->load.load_history = -1; rom_err_t err = rom_info_load(menu->load.rom_path, &menu->load.rom_info); if (err != ROM_OK) { diff --git a/src/menu/views/rtc.c b/src/menu/views/rtc.c index 3becf6c4..80796998 100644 --- a/src/menu/views/rtc.c +++ b/src/menu/views/rtc.c @@ -5,9 +5,13 @@ #include "../sound.h" #include "views.h" -#define MAX(a,b) (((a) > (b)) ? (a) : (b)) -#define MIN(a,b) (((a) < (b)) ? (a) : (b)) +#define MAX(a,b) ({ typeof(a) _a = a; typeof(b) _b = b; _a > _b ? _a : _b; }) +#define MIN(a,b) ({ typeof(a) _a = a; typeof(b) _b = b; _a < _b ? _a : _b; }) #define CLAMP(x, min, max) (MIN(MAX((x), (min)), (max))) +#define WRAP(x, min, max) ({ \ + typeof(x) _x = x; typeof(min) _min = min; typeof(max) _max = max; \ + _x < _min ? _max : _x > _max ? _min : _x; \ +}) #define YEAR_MIN 1996 #define YEAR_MAX 2095 @@ -27,44 +31,27 @@ static struct tm rtc_tm = {0}; static bool is_editing_mode; static rtc_field_t editing_field_type; -int wrap( int val, uint16_t min, uint16_t max ) { - if( val < min ) return max; - if( val > max ) return min; - return val; -} - -rtc_time_t rtc_time_from_tm( struct tm *time ) { - return(rtc_time_t){ - .year = CLAMP(time->tm_year + 1900, YEAR_MIN, YEAR_MAX), - .month = CLAMP(time->tm_mon, 1, 12), - .day = CLAMP(time->tm_mday, 1, 31), - .hour = CLAMP(time->tm_hour, 0, 23), - .min = CLAMP(time->tm_min, 0, 59), - .sec = CLAMP(time->tm_sec, 0, 59), - .week_day = CLAMP(time->tm_wday, 0, 6), - }; -} void adjust_rtc_time( struct tm *t, int incr ) { switch(editing_field_type) { case RTC_EDIT_YEAR: - t->tm_year = wrap( t->tm_year + incr, YEAR_MIN - 1900, YEAR_MAX - 1900 ); + t->tm_year = WRAP( t->tm_year + incr, YEAR_MIN - 1900, YEAR_MAX - 1900 ); break; case RTC_EDIT_MONTH: - t->tm_mon = wrap( t->tm_mon + incr, 0, 11 ); + t->tm_mon = WRAP( t->tm_mon + incr, 0, 11 ); break; case RTC_EDIT_DAY: - t->tm_mday = wrap( t->tm_mday + incr, 1, 31 ); + t->tm_mday = WRAP( t->tm_mday + incr, 1, 31 ); break; case RTC_EDIT_HOUR: - t->tm_hour = wrap( t->tm_hour + incr, 0, 23 ); + t->tm_hour = WRAP( t->tm_hour + incr, 0, 23 ); break; case RTC_EDIT_MIN: - t->tm_min = wrap( t->tm_min + incr, 0, 59 ); + t->tm_min = WRAP( t->tm_min + incr, 0, 59 ); break; case RTC_EDIT_SEC: - t->tm_sec = wrap( t->tm_sec + incr, 0, 59 ); + t->tm_sec = WRAP( t->tm_sec + incr, 0, 59 ); break; } // Recalculate day-of-week and day-of-year @@ -79,13 +66,13 @@ void rtc_ui_component_editdatetime_draw ( struct tm t, rtc_field_t selected_fiel char current_selection_chars[30]; snprintf( full_dt, sizeof(full_dt), ">%04d|%02d|%02d|%02d|%02d|%02d< %s", - t.tm_year + 1900, - t.tm_mon + 1, - t.tm_mday, - t.tm_hour, - t.tm_min, - t.tm_sec, - DAYS_OF_WEEK[t.tm_wday] + CLAMP(t.tm_year + 1900, YEAR_MIN, YEAR_MAX), + CLAMP(t.tm_mon + 1, 1, 12), + CLAMP(t.tm_mday, 1, 31), + CLAMP(t.tm_hour, 0, 23), + CLAMP(t.tm_min, 0, 59), + CLAMP(t.tm_sec, 0, 59), + DAYS_OF_WEEK[CLAMP(t.tm_wday, 0, 6)] ); switch(selected_field) @@ -140,14 +127,11 @@ static void process (menu_t *menu) { adjust_rtc_time( &rtc_tm, -1 ); } else if (menu->actions.options) { // R button = save - if(rtc_is_writable()) { - // FIXME: settimeofday is not available in libdragon yet. - // struct timeval new_time = { .tv_sec = mktime(&rtc_tm) }; - // int res = settimeofday(&new_time, NULL); + if( rtc_get_source() == RTC_SOURCE_JOYBUS && rtc_is_source_available( RTC_SOURCE_DD ) ) { + struct timeval new_time = { .tv_sec = mktime(&rtc_tm) }; + int res = settimeofday(&new_time, NULL); - rtc_time_t rtc_time = rtc_time_from_tm(&rtc_tm); - int res = rtc_set(&rtc_time); - if (res != 1) { + if (res != 0) { menu_show_error(menu, "Failed to set RTC time"); } } @@ -235,6 +219,8 @@ static void draw (menu_t *menu, surface_t *d) { void view_rtc_init (menu_t *menu) { + /* Resync the time from the hardware RTC */ + rtc_set_source( rtc_get_source() ); is_editing_mode = false; editing_field_type = RTC_EDIT_YEAR; } diff --git a/src/menu/views/settings_editor.c b/src/menu/views/settings_editor.c index a5c3acca..4779cf28 100644 --- a/src/menu/views/settings_editor.c +++ b/src/menu/views/settings_editor.c @@ -29,12 +29,22 @@ static void set_soundfx_enabled_type (menu_t *menu, void *arg) { settings_save(&menu->settings); } +static void set_use_rom_fast_reboot_enabled_type (menu_t *menu, void *arg) { + menu->settings.rom_fast_reboot_enabled = (bool)(uintptr_t)(arg); + settings_save(&menu->settings); +} + #ifdef BETA_SETTINGS static void set_pal60_type (menu_t *menu, void *arg) { menu->settings.pal60_enabled = (bool)(uintptr_t)(arg); settings_save(&menu->settings); } +static void set_mod_pal60_compatibility_type (menu_t *menu, void *arg) { + menu->settings.pal60_compatibility_mode = (bool)(uintptr_t)(arg); + settings_save(&menu->settings); +} + static void set_bgm_enabled_type (menu_t *menu, void *arg) { menu->settings.bgm_enabled = (bool)(uintptr_t)(arg); settings_save(&menu->settings); @@ -51,7 +61,6 @@ static void set_rumble_enabled_type (menu_t *menu, void *arg) { // } #endif - static component_context_menu_t set_protected_entries_type_context_menu = { .list = { {.text = "On", .action = set_protected_entries_type, .arg = (void *)(uintptr_t)(true) }, {.text = "Off", .action = set_protected_entries_type, .arg = (void *)(uintptr_t)(false) }, @@ -70,10 +79,22 @@ static component_context_menu_t set_use_saves_folder_type_context_menu = { .list COMPONENT_CONTEXT_MENU_LIST_END, }}; +static component_context_menu_t set_use_rom_fast_reboot_context_menu = { .list = { + {.text = "On", .action = set_use_rom_fast_reboot_enabled_type, .arg = (void *)(uintptr_t)(true) }, + {.text = "Off", .action = set_use_rom_fast_reboot_enabled_type, .arg = (void *)(uintptr_t)(false) }, + COMPONENT_CONTEXT_MENU_LIST_END, +}}; + #ifdef BETA_SETTINGS static component_context_menu_t set_pal60_type_context_menu = { .list = { {.text = "On", .action = set_pal60_type, .arg = (void *)(uintptr_t)(true) }, - {.text = "Off", .action = set_pal60_type, .arg = (void *) (false) }, + {.text = "Off", .action = set_pal60_type, .arg = (void *)(uintptr_t)(false) }, + COMPONENT_CONTEXT_MENU_LIST_END, +}}; + +static component_context_menu_t set_pal60_mod_compatibility_type_context_menu = { .list = { + {.text = "On", .action = set_mod_pal60_compatibility_type, .arg = (void *)(uintptr_t)(true) }, + {.text = "Off", .action = set_mod_pal60_compatibility_type, .arg = (void *)(uintptr_t)(false) }, COMPONENT_CONTEXT_MENU_LIST_END, }}; @@ -94,8 +115,10 @@ static component_context_menu_t options_context_menu = { .list = { { .text = "Show Hidden Files", .submenu = &set_protected_entries_type_context_menu }, { .text = "Sound Effects", .submenu = &set_soundfx_enabled_type_context_menu }, { .text = "Use Saves Folder", .submenu = &set_use_saves_folder_type_context_menu }, + { .text = "Fast Reboot ROM", .submenu = &set_use_rom_fast_reboot_context_menu }, #ifdef BETA_SETTINGS { .text = "PAL60 Mode", .submenu = &set_pal60_type_context_menu }, + { .text = "PAL60 Compatibility", .submenu = &set_pal60_mod_compatibility_type_context_menu }, { .text = "Background Music", .submenu = &set_bgm_enabled_type_context_menu }, { .text = "Rumble Feedback", .submenu = &set_rumble_enabled_type_context_menu }, // { .text = "Restore Defaults", .action = set_use_default_settings }, @@ -136,13 +159,16 @@ static void draw (menu_t *menu, surface_t *d) { ALIGN_LEFT, VALIGN_TOP, "\n\n" " Default Directory : %s\n\n" - " Autoload ROM : %s\n\n" + " Autoload ROM : %s\n" + " ROM Loading Bar : %s\n\n" "To change the following menu settings, press 'A':\n" + " Fast Reboot ROM : %s\n" " Show Hidden Files : %s\n" " Use Saves folder : %s\n" " Sound Effects : %s\n" #ifdef BETA_SETTINGS "* PAL60 Mode : %s\n" + "* PAL60 Mod Compat : %s\n" " Background Music : %s\n" " Rumble Feedback : %s\n" "\n\n" @@ -152,12 +178,15 @@ static void draw (menu_t *menu, surface_t *d) { , menu->settings.default_directory, format_switch(menu->settings.rom_autoload_enabled), + format_switch(menu->settings.loading_progress_bar_enabled), + format_switch(menu->settings.rom_fast_reboot_enabled), format_switch(menu->settings.show_protected_entries), format_switch(menu->settings.use_saves_folder), format_switch(menu->settings.soundfx_enabled) #ifdef BETA_SETTINGS , format_switch(menu->settings.pal60_enabled), + format_switch(menu->settings.pal60_compatibility_mode), format_switch(menu->settings.bgm_enabled), format_switch(menu->settings.rumble_enabled) #endif diff --git a/src/menu/views/startup.c b/src/menu/views/startup.c index c12a9045..e8ff7c9a 100644 --- a/src/menu/views/startup.c +++ b/src/menu/views/startup.c @@ -30,7 +30,14 @@ void view_startup_init (menu_t *menu) { return; } - menu->next_mode = MENU_MODE_BROWSER; + if (menu->settings.first_run) { + menu->settings.first_run = false; + settings_save(&menu->settings); + menu->next_mode = MENU_MODE_CREDITS; + } + else { + menu->next_mode = MENU_MODE_BROWSER; + } } void view_startup_display (menu_t *menu, surface_t *display) { diff --git a/src/menu/views/text_viewer.c b/src/menu/views/text_viewer.c index b3cdb559..33e61c81 100644 --- a/src/menu/views/text_viewer.c +++ b/src/menu/views/text_viewer.c @@ -1,3 +1,9 @@ +/** + * @file text_viewer.c + * @brief Text Viewer component implementation + * @ingroup ui_components + */ + #include #include @@ -7,23 +13,26 @@ #include "utils/utils.h" #include "views.h" - #define MAX_FILE_SIZE KiB(128) - +/** @brief Text file structure */ typedef struct { - FILE *f; - char *contents; - size_t length; - int lines; - int current_line; - int offset; - bool vertical_scroll_possible; + FILE *f; /**< File pointer */ + char *contents; /**< File contents */ + size_t length; /**< File length */ + int lines; /**< Number of lines */ + int current_line; /**< Current line */ + int offset; /**< Offset in the file */ + bool vertical_scroll_possible; /**< Flag indicating if vertical scroll is possible */ } text_file_t; static text_file_t *text; - +/** + * @brief Perform vertical scroll in the text file. + * + * @param lines Number of lines to scroll. + */ static void perform_vertical_scroll (int lines) { if (!text->vertical_scroll_possible) { return; @@ -52,7 +61,11 @@ static void perform_vertical_scroll (int lines) { } } - +/** + * @brief Process user actions for the text viewer. + * + * @param menu Pointer to the menu structure. + */ static void process (menu_t *menu) { if (menu->actions.back) { sound_play_effect(SFX_EXIT); @@ -66,6 +79,12 @@ static void process (menu_t *menu) { } } +/** + * @brief Draw the text viewer. + * + * @param menu Pointer to the menu structure. + * @param d Pointer to the display surface. + */ static void draw (menu_t *menu, surface_t *d) { rdpq_attach(d, NULL); @@ -91,6 +110,9 @@ static void draw (menu_t *menu, surface_t *d) { rdpq_detach_show(); } +/** + * @brief Deinitialize the text viewer. + */ static void deinit (void) { if (text) { if (text->f) { @@ -104,7 +126,11 @@ static void deinit (void) { } } - +/** + * @brief Initialize the text viewer. + * + * @param menu Pointer to the menu structure. + */ void view_text_viewer_init (menu_t *menu) { if ((text = calloc(1, sizeof(text_file_t))) == NULL) { return menu_show_error(menu, "Couldn't allocate memory for the text file"); @@ -163,6 +189,12 @@ void view_text_viewer_init (menu_t *menu) { text->vertical_scroll_possible = (text->lines > LIST_ENTRIES); } +/** + * @brief Display the text viewer. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ void view_text_viewer_display (menu_t *menu, surface_t *display) { process(menu); diff --git a/src/menu/views/views.h b/src/menu/views/views.h index 8c475280..984c0a24 100644 --- a/src/menu/views/views.h +++ b/src/menu/views/views.h @@ -7,67 +7,292 @@ #ifndef VIEWS_H__ #define VIEWS_H__ - #include "../ui_components.h" #include "../menu_state.h" - /** * @addtogroup view * @{ */ -void view_startup_init (menu_t *menu); -void view_startup_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the startup view. + * + * @param menu Pointer to the menu structure. + */ +void view_startup_init(menu_t *menu); -void view_browser_init (menu_t *menu); -void view_browser_display (menu_t *menu, surface_t *display); +/** + * @brief Display the startup view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_startup_display(menu_t *menu, surface_t *display); -void view_file_info_init (menu_t *menu); -void view_file_info_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the browser view. + * + * @param menu Pointer to the menu structure. + */ +void view_browser_init(menu_t *menu); -void view_system_info_init (menu_t *menu); -void view_system_info_display (menu_t *menu, surface_t *display); +/** + * @brief Display the browser view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_browser_display(menu_t *menu, surface_t *display); -void view_image_viewer_init (menu_t *menu); -void view_image_viewer_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the file info view. + * + * @param menu Pointer to the menu structure. + */ +void view_file_info_init(menu_t *menu); -void view_text_viewer_init (menu_t *menu); -void view_text_viewer_display (menu_t *menu, surface_t *display); +/** + * @brief Display the file info view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_file_info_display(menu_t *menu, surface_t *display); -void view_music_player_init (menu_t *menu); -void view_music_player_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the system info view. + * + * @param menu Pointer to the menu structure. + */ +void view_system_info_init(menu_t *menu); -void view_credits_init (menu_t *menu); -void view_credits_display (menu_t *menu, surface_t *display); +/** + * @brief Display the system info view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_system_info_display(menu_t *menu, surface_t *display); -void view_settings_init (menu_t *menu); -void view_settings_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the image viewer view. + * + * @param menu Pointer to the menu structure. + */ +void view_image_viewer_init(menu_t *menu); -void view_rtc_init (menu_t *menu); -void view_rtc_display (menu_t *menu, surface_t *display); +/** + * @brief Display the image viewer view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_image_viewer_display(menu_t *menu, surface_t *display); -void view_flashcart_info_init (menu_t *menu); -void view_flashcart_info_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the text viewer view. + * + * @param menu Pointer to the menu structure. + */ +void view_text_viewer_init(menu_t *menu); -void view_load_rom_init (menu_t *menu); -void view_load_rom_display (menu_t *menu, surface_t *display); +/** + * @brief Display the text viewer view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_text_viewer_display(menu_t *menu, surface_t *display); -void view_load_disk_init (menu_t *menu); -void view_load_disk_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the music player view. + * + * @param menu Pointer to the menu structure. + */ +void view_music_player_init(menu_t *menu); -void view_load_emulator_init (menu_t *menu); -void view_load_emulator_display (menu_t *menu, surface_t *display); +/** + * @brief Display the music player view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_music_player_display(menu_t *menu, surface_t *display); -void view_error_init (menu_t *menu); -void view_error_display (menu_t *menu, surface_t *display); +/** + * @brief Initialize the credits view. + * + * @param menu Pointer to the menu structure. + */ +void view_credits_init(menu_t *menu); -void view_fault_init (menu_t *menu); -void view_fault_display (menu_t *menu, surface_t *display); +/** + * @brief Display the credits view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_credits_display(menu_t *menu, surface_t *display); -void menu_show_error (menu_t *menu, char *error_message); +/** + * @brief Initialize the settings view. + * + * @param menu Pointer to the menu structure. + */ +void view_settings_init(menu_t *menu); + +/** + * @brief Display the settings view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_settings_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the RTC view. + * + * @param menu Pointer to the menu structure. + */ +void view_rtc_init(menu_t *menu); + +/** + * @brief Display the RTC view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_rtc_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the flashcart info view. + * + * @param menu Pointer to the menu structure. + */ +void view_flashcart_info_init(menu_t *menu); + +/** + * @brief Display the flashcart info view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_flashcart_info_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the load ROM view. + * + * @param menu Pointer to the menu structure. + */ +void view_load_rom_init(menu_t *menu); + +/** + * @brief Display the load ROM view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_load_rom_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the load disk view. + * + * @param menu Pointer to the menu structure. + */ +void view_load_disk_init(menu_t *menu); + +/** + * @brief Display the load disk view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_load_disk_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the load emulator view. + * + * @param menu Pointer to the menu structure. + */ +void view_load_emulator_init(menu_t *menu); + +/** + * @brief Display the load emulator view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_load_emulator_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the error view. + * + * @param menu Pointer to the menu structure. + */ +void view_error_init(menu_t *menu); + +/** + * @brief Display the error view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_error_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the fault view. + * + * @param menu Pointer to the menu structure. + */ +void view_fault_init(menu_t *menu); + +/** + * @brief Display the fault view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_fault_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the favorite view. + * + * @param menu Pointer to the menu structure. + */ +void view_favorite_init(menu_t *menu); + +/** + * @brief Display the favorite view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_favorite_display(menu_t *menu, surface_t *display); + +/** + * @brief Initialize the history view. + * + * @param menu Pointer to the menu structure. + */ +void view_history_init(menu_t *menu); + +/** + * @brief Display the history view. + * + * @param menu Pointer to the menu structure. + * @param display Pointer to the display surface. + */ +void view_history_display(menu_t *menu, surface_t *display); + +/** + * @brief Show an error message in the menu. + * + * @param menu Pointer to the menu structure. + * @param error_message Error message to be displayed. + */ +void menu_show_error(menu_t *menu, char *error_message); /** @} */ /* view */ - -#endif +#endif // VIEWS_H__ diff --git a/src/utils/fs.c b/src/utils/fs.c index b02b2e2c..607e2025 100644 --- a/src/utils/fs.c +++ b/src/utils/fs.c @@ -17,6 +17,10 @@ char *strip_fs_prefix (char *path) { return path; } +char *file_basename (char *path) { + char *base = strrchr(path, '/'); + return base ? base + 1 : path; +} bool file_exists (char *path) { struct stat st; diff --git a/src/utils/fs.h b/src/utils/fs.h index 88f81a7a..5883520b 100644 --- a/src/utils/fs.h +++ b/src/utils/fs.h @@ -1,25 +1,109 @@ #ifndef UTILS_FS_H__ #define UTILS_FS_H__ - #include #include #include - #define FS_SECTOR_SIZE (512) +/** + * @file fs.h + * @brief File system utility functions. + * @ingroup utils + */ -char *strip_fs_prefix (char *path); +/** + * @brief Strips the file system prefix from the given path. + * + * This function removes the file system prefix from the provided path. + * + * @param path The path from which to strip the prefix. + * @return A pointer to the path without the prefix. + */ +char *strip_fs_prefix(char *path); -bool file_exists (char *path); -int64_t file_get_size (char *path); -bool file_allocate (char *path, size_t size); -bool file_fill (char *path, uint8_t value); -bool file_has_extensions (char *path, const char *extensions[]); +/** + * @brief Gets the basename of the given path. + * + * This function returns the basename of the provided path. + * + * @param path The path from which to get the basename. + * @return A pointer to the basename of the path. + */ +char *file_basename(char *path); -bool directory_exists (char *path); -bool directory_create (char *path); +/** + * @brief Checks if a file exists at the given path. + * + * This function checks if a file exists at the specified path. + * + * @param path The path to the file. + * @return true if the file exists, false otherwise. + */ +bool file_exists(char *path); +/** + * @brief Gets the size of the file at the given path. + * + * This function returns the size of the file at the specified path. + * + * @param path The path to the file. + * @return The size of the file in bytes, or -1 if the file does not exist. + */ +int64_t file_get_size(char *path); -#endif +/** + * @brief Allocates a file of the specified size at the given path. + * + * This function creates a file of the specified size at the provided path. + * + * @param path The path to the file. + * @param size The size of the file to create. + * @return true if the file was successfully created, false otherwise. + */ +bool file_allocate(char *path, size_t size); + +/** + * @brief Fills a file with the specified value. + * + * This function fills the file at the given path with the specified value. + * + * @param path The path to the file. + * @param value The value to fill the file with. + * @return true if the file was successfully filled, false otherwise. + */ +bool file_fill(char *path, uint8_t value); + +/** + * @brief Checks if a file has one of the specified extensions. + * + * This function checks if the file at the given path has one of the specified extensions. + * + * @param path The path to the file. + * @param extensions An array of extensions to check. + * @return true if the file has one of the specified extensions, false otherwise. + */ +bool file_has_extensions(char *path, const char *extensions[]); + +/** + * @brief Checks if a directory exists at the given path. + * + * This function checks if a directory exists at the specified path. + * + * @param path The path to the directory. + * @return true if the directory exists, false otherwise. + */ +bool directory_exists(char *path); + +/** + * @brief Creates a directory at the given path. + * + * This function creates a directory at the specified path. + * + * @param path The path to the directory. + * @return true if the directory was successfully created, false otherwise. + */ +bool directory_create(char *path); + +#endif // UTILS_FS_H__ diff --git a/src/utils/utils.h b/src/utils/utils.h index efef1366..cde8ada1 100644 --- a/src/utils/utils.h +++ b/src/utils/utils.h @@ -1,14 +1,63 @@ #ifndef UTILS_H__ #define UTILS_H__ +/** + * @file utils.h + * @brief Utility macros and functions. + * @ingroup utils + */ -#define ALIGN(x, a) (((x) + ((typeof(x))(a) - 1)) & ~((typeof(x))(a) - 1)) +/** + * @brief Aligns a value to the specified alignment. + * + * This macro aligns the given value `x` to the specified alignment `a`. + * + * @param x The value to align. + * @param a The alignment boundary. + * @return The aligned value. + */ +#define ALIGN(x, a) (((x) + ((typeof(x))(a) - 1)) & ~((typeof(x))(a) - 1)) +/** + * @brief Returns the maximum of two values. + * + * This macro returns the maximum of the two provided values `a` and `b`. + * + * @param a The first value. + * @param b The second value. + * @return The maximum of `a` and `b`. + */ #define MAX(a,b) ({ typeof(a) _a = a; typeof(b) _b = b; _a > _b ? _a : _b; }) + +/** + * @brief Returns the minimum of two values. + * + * This macro returns the minimum of the two provided values `a` and `b`. + * + * @param a The first value. + * @param b The second value. + * @return The minimum of `a` and `b`. + */ #define MIN(a,b) ({ typeof(a) _a = a; typeof(b) _b = b; _a < _b ? _a : _b; }) +/** + * @brief Converts a value to kibibytes. + * + * This macro converts the given value `x` to kibibytes. + * + * @param x The value to convert. + * @return The value in kibibytes. + */ #define KiB(x) ((x) * 1024) + +/** + * @brief Converts a value to mebibytes. + * + * This macro converts the given value `x` to mebibytes. + * + * @param x The value to convert. + * @return The value in mebibytes. + */ #define MiB(x) ((x) * 1024 * 1024) - -#endif +#endif // UTILS_H__