BlocksDS
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Linux

This is the easiest option, but you may not get the latest version of the SDK right away.

  1. You will also need to install the ARM toolchain of Wonderful Toolchains. Follow the instructions in this link: https://wonderful.asie.pl/docs/getting-started/#linux

  2. Add the BlocksDS repository to wf-pacman:

    export PATH=/opt/wonderful/bin:$PATH
    
    wf-pacman -Syu wf-tools
    wf-config repo enable blocksds
    wf-pacman -Syu
    
  3. Now, install the ARM toolchain of Wonderful Toolchains, as well as BlocksDS:

    wf-pacman -S blocksds-toolchain
    

    To install the documentation and examples you can install:

    wf-pacman -S blocksds-docs
    

    Install the following if you plan to develop binaries for the DSP of the DSi:

    wf-pacman -S toolchain-llvm-teak-llvm
    
  4. (Optional step) You can also install some third party libraries like NightFox’s Lib and Nitro Engine using wf-pacman:

    wf-pacman -S blocksds-nflib blocksds-nitroengine
    

    You can get a full list of packages by running:

    wf-pacman -Sl
    
  5. wf-pacman installs BlocksDS in /opt/wonderful/thirdparty/blocksds/. This isn’t the standard location (wf-pacman can only write files to /opt/wonderful/) so you need to do one of the two following options:

    1. Create a symlink:

      ln -s /opt/wonderful/thirdparty/blocksds /opt/blocksds
      
    2. Set your environment variables correctly:

      export BLOCKSDS=/opt/wonderful/thirdparty/blocksds/core
      export BLOCKSDSEXT=/opt/wonderful/thirdparty/blocksds/external
      
  6. Whenever you need to update the SDK, run:

    wf-pacman -Syu
    
  7. Now you can try to build one of the BlocksDS examples. They are available at path /opt/wonderful/thirdparty/blocksds/core/examples/. From there, for example, go to graphics_3d/volumetric_shadow and type make. This will generate a NDS ROM that you can try with an emulator or a flashcart.

    You can also try one of the open source projects made with BlocksDS that are listed here.

    If you get an error like “command not found: make”, you need to install it from the packages of your system:

    sudo apt-get install -y --no-install-recommends build-essential
    

    If you want to know how to debug your programs, check the guide here.