idelvall / nand-mines

Minesweeper for the Hack machine implemented in Jack language (http://www.nand2tetris.org)

NAND Mines

Minesweeper for the Hack machine implemented in Jack language.

Video: https://youtu.be/SpAAYjXAtJ0

Nand2Tetris is an online, self-teachable course on Building a Modern Computer from First Principles http://www.nand2tetris.org/.

This was my project submission for the module 9, a game implemented in the Jack language, a minimalist high level, OO language we have implemented for the Hack machine, a 16-bit hardware machine we had previously built starting from the very ground: logical NAND gates.

Table of Contents

• General execution instructions
• Acknowledgements
• Support bugs and requests
• Authors
• License

General execution instructions

• Download and install the Nand2tetris Software Suite (http://www.nand2tetris.org/software.php)
• Compile the src folder with the JackCompiler tool.
• Start the VMEmulator.
• Using File -> Load Program, select the application's directory and click the "Load Program" button.
• Click the "Yes" button to the Confirmation Message pop-up.
• Set the Animate: drop-down to "No animation".
• Set the speed slider to "Fast".
• Press "F5" to run.

Acknowledgements

• Thanks to all the nand2tetris crew for this amazing learning experience!.
• This game makes use of some classes of Nand2Tetris-Games_and_Demos for image generation. Thanks Gavin Stewart for sharing your great work!
• Thanks to Golan Parashi for the Sokoban bitmap editor!

Support bugs and requests

https://github.com/idelvall/nand-mines/issues

Authors

• Ignacio del Valle Alles (https://github.com/idelvall/)

Contributions are always welcome and greatly appreciated!

License

Apache License, Version 2.0

nand-mines's Issues

-32768 isn't a valid value in Jack

Could you please add a test for 0000 0000 0000 0001 and ensure it is coded as ~32767 instead of -32768 since -32768 is not a valid input value in Jack.
The problem is that -32768 generates the VM code:

push 32768
neg 

which in turn produces the assembly command

@32768

which fails because the binary for an @ command is 0 followed by a 15 bit value and 32768 uses the 16th bit.

Eg.a quick fix would be to insert at line 163:

if (value == -32768) 
    generateCode.value = generateCode.value + "\tdo Memory.poke(memAddress+" + row*32 + ", ~32767);\n"; 
else
    generateCode.value = generateCode.value + GenerateCodeLine(i, value);

and delete line 164. Or the same test could be moved to the GenerateCodeLine function.

Note that this is a bug in the original version of the Sokoban bitmap editor also.