Skip to content
A brainf--k interpreter written for NES cartridge to be played on real NES hardware.
Assembly Brainfuck Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources
src
.gitignore
CHANGELOG.md
LICENSE
Makefile
README.md
SHA256SUMS.txt

README.md

DC26-6502 (Brainf--k Interpreter NES Cartridge)

A brainf--k interpreter written for NES cartridge to be played on real NES hardware.

DC26-6502 was created by Vi Grey and is licensed under the BSD 2-Clause License.

Description:

This NES game is an interpreter for the brainf--k programming language, a programming language that uses only 8 symbols. The standard NES controller is used to create and run programs using only the power of the NES hardware CPU.

Platforms:

  • GNU/Linux

Build Dependencies:

  • asm6 (You'll probably have to build asm6 from source. Make sure the asm6 binary is named asm and that the binary is executable and accessible in your PATH. The source code can be found at http://3dscapture.com/NES/asm6.zip or in the included directory resources/asm6.zip)
  • zip

Build NES ROM:

From a terminal, go to the the main directory of this project (the directory this README.md file exists in), you can then build the NES ROM with the following command.

$ make

The resulting NES ROM will be located at bin/dc26-6502.nes and should have the SHA-256 hash of c3bcbe82aa4fddc4e686a46cb6ec0311b3c01bbc3e0a97987695dcdfafe6a409

Cleaning Build Environment:

If you used make to build the NES ROM, you can run the following command to clean up the build environment.

$ make clean

Controls:

  • A + Up: +
  • A + Down: -
  • A + Left: <
  • A + Right: >
  • B + Up: .
  • B + Down: ,
  • B + Left: [
  • B + Right: ]
  • Start: Run
  • Select: Backspace

Specifications:

  • 1024 Byte Instruction Buffer ($0200-$05FF)
  • 512 Byte Memory Tape ($0600-$0FFF)
  • 28 x 19 Print Screen Size (7 bit ASCII Characters)

Screenshots:

DC26-6502 "READY" Screenshot

(READY Screen)

DC26-6502 Brainf--k Code Written Screenshot

(Brainf--k Code Written Out)

DC26-6502 "Finished Interpreting" Screenshot

(FINISHED Interpreting Screen)

Extras:

  • Unzipping the ROM:

    The compiled NES ROM file at bin/dc26-6502.nes will also be a functioning ZIP file that contains 2 files, bfinterpreter.py and ascii2bf.py.

  • Interpreting the ROM:

    This NES ROM is also a functional brainf--k file. Using python3 bfinterpreter.py dc26-6502.nes will allow you to interpret the brainf--k file content of the NES ROM.

  • Creating Brainf--k Programs:

    An included tool, ascii2bf.py allows you to create a brainf--k program for any file that is a multiple of 8 bits long. To create a brainf--k program, use python3 ascii2bf.py filename where filename is the path to the file you want to create a brainf--k program for.

  • NES Mapper:

    This NES ROM runs as an NROM-256 ROM, but can also work as an NROM-128 ROM.

  • ^ ^ v v < > < > B A

License:

Copyright (C) 2018, Vi Grey
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

    1. Redistributions of source code must retain the above copyright
       notice, this list of conditions and the following disclaimer.
    2. Redistributions in binary form must reproduce the above copyright
       notice, this list of conditions and the following disclaimer in the
       documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS \`\`AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
You can’t perform that action at this time.