Build Instructions

Collapse

• 1

  Prerequisites

  A CircuitPython bootloader must be installed on the device. This is very easy to do. This has already been covered by many guides in the past, but I would recommend this one for starters: https://learn.adafruit.com/welcome-to-circuitpython

  Next, a few libraries need to be copied to the device. These are compiled MicroPython files made by Adafruit/CircuitPython to help with interpreting the signals from the accelerometer. The following items will need to be copied to the device to get the accelerometer to work, which are in this zip folder: https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/download/20201229/adafruit-circuitpython-bundle-6.x-mpy-20201229.zip

  Download the zip file, extract it, and copy over the lib/adafruit_bus_device/ (the entire folder) and the file lib/adafruit_lis3dh.mpy into the lib folder on the device. To copy any files onto the device with CircuitPython installed, you should be able to simply drag and drop the file or folder onto the drive that shows up when you plug in the device to your computer. Once any file transfer is complete the device will restart automatically.

• 2

  Audio

  This is the class that generates tones. Tones can have a frequency in Hertz or can be specified in pitch/octave notation. For example, the call play_note("C4", 0.5) will play middle C for half a second. Alternatively, play_note("R", 1.0) will play nothing (rest) for one second. Tones are generated using a sine wave, and the CircuitPython AudioIO class is used to play the raw wave. Sequencing is done using a queue of notes and their timing, and every time the tick function is called (code.py calls this in its main loop) the queue is popped. Note timing uses CircuitPython’s built-in time.monotonic() which returns an ever increasing count of seconds. Timing is done using the difference in the current call to that function and a previous check. Due to the nature of the device clock, note timing is not very accurate, but this isn’t much of a problem for a small game. This class is initialized with the audioio.AudioOut object in the constructor, to know where to send the raw signal.

• 3

  Draw

  This class handles all CircuitPython DisplayIO related screen drawing using bitmaps. For more information on screen drawing and bitmaps, this is a great resource. In this implementation, there are two bitmaps which are stored a single group, which is sent to the display. The main bitmap, display_bitmap handles the drawn image. Every time the cursor is moved, it draws a square of the current cursor size in the current cursor position, then changes the tuple the current position to reflect the direction moved.

  The second bitmap, cursor_bitmap is more simple. It is the size of the largest possible cursor size, and on display_cursor it draws a square of the current cursor size either in the current color, or the “off” color – this is set to the index of black by code.py. This function is called with alternating values for the display parameter in the main program loop to make the blink. The rest of the cursor bitmap is filled with the index for an “invisible” color – this is an index outside of the bitmap palette that looks invisible and allows the display bitmap underneath to be visible even if the cursor bitmap is overlapping.

  There is a custom value for offIdx passed to this constructor which should be the index of black in the rgbColors list. This is used for a special case where if the current cursor color is black, the cursor should flash white (or whatever is the first color in the colors list). This color is also used as the reset color when the bitmap should be cleared, which is triggered by shaking the device. If you would like to use any other color as the background, this would be the parameter to change. The other parameters passed to the class constructor are board_display, the pin to send DisplayIO messages to – this should come from board.DISPLAY, and rgb_colors, a list of RGB colors. This should be a list of lists in the form of [[R0, G0, B0], [R1,G1,B1]… ]. Each of R, G, B represents a value of red, green, and blue between 0-255.

  Some example colors:

  White: [255, 255, 255]
  Red: [255, 0, 0]
  Yellow: [255, 180, 0]
  Black: [0, 0, 0] 

  For more colors, Google has a color picker that can be found by searching for "color picker"

View all 6 instructions