Toggle search
Toggle menu
10.3K
13.2K
1.2K
203.4K
GameBrew
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

BlocksDS

From GameBrew
More actions
Revision as of 10:18, 21 October 2023 by HydeWing (talk | contribs)
BlocksDS
Ndspc2.png
General
AuthorAntonioND
TypeDevelopment Tools
Version0.9.1
LicenseMixed
Last Updated2023/10/19
Links
Download
Website
Source

BlocksDS SDK is an SDK for Nintendo DS. It's built on the hard work of many talented individuals. Here are its goals:

  • Create a user-friendly NDS software development kit based on GCC, with minimal dependencies.
  • Encourage developers to tinker and enhance the SDK by providing them with its complete source code. It also demonstrates how straightforward it is to build the entire codebase. The only exception is the tolchain, which can be tricky to build. To simplify things, we use Wonderful Toolchains instead of asking users to build it themselves.
  • Strive to maintain compatibility with existing C projects. Ideally, replacing the makefile with one from BlocksDS should be sufficient to build any project that utilizes libnds.

This project is currently in beta stage, and most features are working. Please, check the libc port documentation for more information about the supported libc functions.

If you want to port a project built with devkitPro, follow this guide for instructions.

For detailed information about the design of BlocksDS, check this other document.

For licensing information, check this.

Changelog

v0.9.1

  • Revert changes in maxmod that duplicated some symbols.

v0.9.0

  • SDK:
    • Native windows support added. Wonderful toolchains now distribute native Windows binaries, and the only required change in BlocksDS was to change a library used by Grit. Thanks you, Generic and asie!
    • The stdio implementation of picolibc provided by Wonderful Toolchains has been patched by asie and this has substantially improved direct SD card read and write speeds.
    • The RTC interrupt is no longer used in any test, example or template. Users are now expected to timer interrupt instead because the RTC interrupt isn't supported on 3DS in DS/DSi mode or most emulators. Check the new code to see how to adapt old code. The RTC interrupt functions will still be supported to preserve compatibility with old projects that aren't updated.
    • Document the ARM9 <-> ARM7 boot synchronization routine.
    • In the dockerfile, set a locale to be able to pass UTF-8 characters to ndstool to appear in the title of the NDS ROM.
    • Add a test to ensure that the libnds modules that use the ARM9 <-> ARM7 transfer memory region don't break.
    • New examples:
      • Getting key input state.
      • Using NitroFAT, DLDI and DSi SD in the same program.
      • Send a buffer in main RAM to the ARM7 from the ARM9.
      • Read battery status.
      • Set the real time clock of the NDS.
  • libnds:
    • RTC:
      • Add new helpers to get and set the date. They use typedefs to move values between functions instead of byte arrays.
      • The old helpers that use byte arrays have been deprecated.
      • Using the RTC interrupt as a way to update the time every second has been deprecated.
      • Documentation:
      • Document values returned by the battery read function.
      • Document RTC helpers.
      • Add some ARM7 modules to the front page of the Doxygen documentation.
    • Memory:
      • Disable data cache and instruction fetch access to DTCM.
      • Rumble detection functions won't try to detect anything on DSi.
      • Change location of transfer region area on DSi so that it's uncached.
      • Import safe DMA helpers written by Gericom and use them from all DMA helpers.
    • Video:
      • Make glGetInt() wait for the GPU to be idle when getting the polygon and vertices count. It is common for developers to forget to wait.
      • Cleanup some helpers and add some missing VRAM definitions.
      • Document hardware bug of the DMA in GFX FIFO mode.
    • Other:
      • FatFs updated to R0.15p3.
      • Support the debug button (only available in emulators and debug consoles).
      • Switch to using ARM unified syntax (UAL).
  • Grit:
    • Switch from libfreeimage to libplum. This allows us to build Grit on Windows easier.

v0.8.1

  • libnds:
    • Fix NitroFAT in emulators. It only worked when DLDI was initialized correctly, which isn't the case in emulators like no$gba.
    • Set the right CPU as owner of the Slot-1 bus in NitroFAT handling functions.
  • SDK:
    • Update build systems to generate Maxmod soundbanks in the NitroFAT filesystem if the filesystem is used. This isn't supported by ARM9 + ARM7 makefiles for now, only by ARM9 makefiles.
    • Fix segmentation fault in mkfatimg when not enough arguments are provided.
    • Stop relying on make -j in Makefiles. It is passed by make to any sub-make, so it isn't required.
    • Add basic Maxmod and Maxmod + NitroFAT examples.

v0.8

  • libnds:
    • Document MPU setup code properly.
    • Cleanup exception handling code.
    • Add asynchronous math functions to complement the previous synchronous ones.
    • Support redirecting stdout and stderr to user functions.
    • Fix code that selects the default filesystem (DSi SD or DLDI).
    • Fix leaking file handlers in truncate().
    • Fix memory leaks in image and pcx modules.
    • Support more rumble packs.
  • ndstool:
    • Fix warnings.
    • Remove non-homebrew-related functionality.
  • SDK:
    • Automatically link with libc and libstdc++ rather than forcing users to do it explicitly.
    • Support *.arm.c and *.arm.cpp filenames for compatibility with devkitARM.
    • Correctly initialize TLS in the ARM7.
    • Improve bin2c.
    • Update libc documentation.
    • Improve and cleanup some examples.

v0.7

  • libnds:
    • Unify all coding and documentation style of the codebase.
    • Change license of GL2D to Zlib (with the author's permission).
    • Improve sassert() so that it can exit to the loader instead of locking the application.
    • Keyboard:
      • Fix initialization glitch where it would blink for a frame.
      • Fix backspace handling.
      • Make it use cothread functions so that it never blocks the application.
    • cothread:
      • Fixed stack alignment
      • Fixed stack size of the scheduler thread.
    • libc:
      • Fix no$gba debug messages on the ARM9.
      • Add support of no$gba debug messages to the ARM7.
  • mmutil:
    • Fix segfault with samples with implied zero loop.
  • SDK:
    • Improve some old examples. Fix memory leaks in all examples that used
    • getcwd().
    • Fix ARM9 linkerscript to place ITCM sections in ITCM correctly.
    • Add new examples: Exception handling, assertions, no$gba debug console.
    • Prevent mkfatimg from generating FAT images that are so small that FatFs
    • can't mount them.
    • Improve installation instructions.

v0.6

  • libnds:
    • Document MPU setup steps and CP15 registers.
    • Enable more warnings in the Makefile and fix them.
    • FIFO subsystem:
      • The FIFO subsystem has been cleaned up and documented.
      • Some bugs in the FIFO subsystem have been fixed (the stress test still fails, though).
      • Prevent using cothread_yield() in the ARM7.
    • libc:
      • Alignment of thread local storage sections has been fixed.
      • Support stat() in the root directory of a filesystem.
      • Support statvfs() and fstatvfs().
    • Avoid including the default keyboard data if it isn't used.
    • Allow setting the duration of the lid sleep check, and to disable it completely.
    • Build release versions of the library as well as debug.
  • ndstool:
    • Support multiple languages in the banner.
    • Support more file formats for icons (GIF, PNG).
    • Support animated icons (from GIF files).
  • SDK:
    • Refactor install targets of the SDK components. Now, all components can
    • be installed on their own, and they copy the licenses of the components to
    • the installation directory.
    • Emulate behaviour of bin2s of devkitPro more closely with bin2c.
    • Use SPDX license identifiers in all libraries and components that end up in
    • the NDS application binary.
    • Some cleanup of code formatting.
    • Added a DLDI driver template.

v0.5

  • Define a default location for BlocksDS: /opt/blocksds/
  • Use mkfatimg (distributed with FatFs) instead of imgbuild.sh to reduce
  • the number of dependencies.
  • Fix mmutil target in Makefiles in parallel builds.
  • Cleanup of GBA slot peripherals drivers.
  • Integrate libxm7 as a core library.
  • Fix exit to loader code from the ARM7. It has been simplified a bit.
  • Document exit to loader code.

v0.4

  • Use Wonderful Toolchains to get full C++ standard library support.
  • Remove picolibc and avr-libstdcpp as submodules (all previous history has been condensed to one commit).
  • Multithreading:
    • Add cooperative multithreading scheduler.
    • Enable scheduler in the ARM9 by default.
    • Add examples of having multiple threads, mutexes, and asynchronous file
    • loading.
    • Support thread local storage.
  • Added mutexes to problematic parts of libnds and FatFs.
  • Add initial support and example of DSi camera (thanks, asie!).
  • Support malloc() in the ARM7.
  • Simplify build system of tests and examples.
  • Bugfixes.

Credits

This project wouldn't have been possible without:

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=BlocksDS&oldid=136161’

Advertising: