# NeoTrellis M4 Animated Dice Roller ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/066/106/medium800thumb/gaming_demo.jpg?1542413106) In this project we'll take the NeoTrellisM4 and use it to make a dice roller. We want to be able to select between 1 and 8 dice to roll, and the type of dice: 4, 6, 8, 10, 12, or 20 sided. To keep the interface simply, we can't mix types of dice. The number of dice is selected using the top row of buttons: 1-8 starting from the left. As the count is selected, a bar fills in from the left. The type of die is selected by buttons on the second row. Each type of die is assigned a unique color that is used to display the result of rolls as well as the associated selection button when a die is selected. Button use and color is shown below. ![](https://cdn-learn.adafruit.com/assets/assets/000/066/107/medium800/gaming_dd.png?1542413132) Once the number and type of dice are selected, shaking the Trellis will roll the dice and display the result. ![](https://cdn-learn.adafruit.com/assets/assets/000/066/081/medium800/gaming_circuitpython_blinka-small.png?1542398768) We'll be using CircuitPython for this project. Are you new to using CircuitPython? No worries, [there is a full getting started guide here](https://learn.adafruit.com/welcome-to-circuitpython). Adafruit suggests using the Mu editor to edit your code and have an interactive REPL in CircuitPython. [You can learn about Mu and its installation in this tutorial](https://learn.adafruit.com/welcome-to-circuitpython/installing-mu-editor). There's a guide to get you up and running with [CircuitPython specifically for the NeoTrellisM4](https://learn.adafruit.com/adafruit-neotrellis-m4/circuitpython). You should read it before starting to get the most recent CircuitPython build for the NeoTrellisM4 installed and running along with the required libraries. ## Parts ### Adafruit NeoTrellis M4 with Enclosure and Buttons Kit Pack [Adafruit NeoTrellis M4 with Enclosure and Buttons Kit Pack](https://www.adafruit.com/product/4020) So you've got a cool/witty name for your band, a Soundcloud account, [a 3D-printed Daft Punk helmet](https://learn.adafruit.com/3d-printed-daft-punk-helmet-with-bluetooth)... so what could be missing from your road to stardom? The **NeoTrellis M4 Kit...** Out of Stock [Buy Now](https://www.adafruit.com/product/4020) [Related Guides to the Product](https://learn.adafruit.com/products/4020/guides) ![Demo Video of Hands pressing buttons on lit up NeoTrellis M4.](https://cdn-shop.adafruit.com/product-videos/640x480/4020-00.jpg) ### USB cable - USB A to Micro-B [USB cable - USB A to Micro-B](https://www.adafruit.com/product/592) This here is your standard A to micro-B USB cable, for USB 1.1 or 2.0. Perfect for connecting a PC to your Metro, Feather, Raspberry Pi or other dev-board or microcontroller Approximately 3 feet / 1 meter long In Stock [Buy Now](https://www.adafruit.com/product/592) [Related Guides to the Product](https://learn.adafruit.com/products/592/guides) ![USB cable - USB A to Micro-B - 3 foot long](https://cdn-shop.adafruit.com/640x480/592-01.jpg) - [Next Page](https://learn.adafruit.com/neotrellis-dice/code-tour.md) ## Featured Products ### Adafruit NeoTrellis M4 with Enclosure and Buttons Kit Pack [Adafruit NeoTrellis M4 with Enclosure and Buttons Kit Pack](https://www.adafruit.com/product/4020) So you've got a cool/witty name for your band, a Soundcloud account, [a 3D-printed Daft Punk helmet](https://learn.adafruit.com/3d-printed-daft-punk-helmet-with-bluetooth)... so what could be missing from your road to stardom? The **NeoTrellis M4 Kit...** Out of Stock [Buy Now](https://www.adafruit.com/product/4020) [Related Guides to the Product](https://learn.adafruit.com/products/4020/guides) ### Adafruit NeoTrellis M4 Mainboard - featuring SAMD51 [Adafruit NeoTrellis M4 Mainboard - featuring SAMD51](https://www.adafruit.com/product/3938) We got a big ol' blender and tossed in an ItsyBitsy M4, two NeoTrellis boards and an electret mic amp - turned on the 'mix' button and out came the NeoTrellis M4 - a super fun dev board for anyone who likes to squish buttons, see pretty lights and maybe make a tune or... In Stock [Buy Now](https://www.adafruit.com/product/3938) [Related Guides to the Product](https://learn.adafruit.com/products/3938/guides) ### NeoTrellis M4 Acrylic Enclosure Kit [NeoTrellis M4 Acrylic Enclosure Kit](https://www.adafruit.com/product/3963) So you've got your [Adafruit NeoTrellis M4](https://www.adafruit.com/product/3938), a cool/witty name for your band, a Soundcloud account, [a 3D-printed Daft Punk helmet](https://learn.adafruit.com/3d-printed-daft-punk-helmet-with-bluetooth)... so what... Out of Stock [Buy Now](https://www.adafruit.com/product/3963) [Related Guides to the Product](https://learn.adafruit.com/products/3963/guides) ### Silicone Elastomer 4x4 Button Keypad - for 3mm LEDs [Silicone Elastomer 4x4 Button Keypad - for 3mm LEDs](https://www.adafruit.com/product/1611) So squishy! These silicone elastomer keypads are just waiting for your fingers to press them. Go ahead, squish all you like! (They're durable and easy to clean, just wipe with mild soap and water) These are just like the light up rubber buttons you find on stuff like appliances and tools,... Out of Stock [Buy Now](https://www.adafruit.com/product/1611) [Related Guides to the Product](https://learn.adafruit.com/products/1611/guides) ### USB Patterned Fabric Cable - A/MicroB [USB Patterned Fabric Cable - A/MicroB](https://www.adafruit.com/product/2008) Oooh it's so soft! And that beautiful pattern! If you have to have visible cables then you might as well have the nicest fabric bound cable with a eye-catching snake-like pattern.  That's why we now carry this standard A to micro-B USB cable for USB 1.1 or 2.0.... No Longer Stocked [Buy Now](https://www.adafruit.com/product/2008) [Related Guides to the Product](https://learn.adafruit.com/products/2008/guides) ### Little Rubber Bumper Feet - Pack of 4 [Little Rubber Bumper Feet - Pack of 4](https://www.adafruit.com/product/550) Keep your electronics from going barefoot, give them little rubber feet! These small sticky bumpers are our favorite accessory for any electronic kit or device. They are sticky, but not impossible to remove. They're small enough to fit onto any board, and have just enough height to give... In Stock [Buy Now](https://www.adafruit.com/product/550) [Related Guides to the Product](https://learn.adafruit.com/products/550/guides) ## Related Guides - [Adafruit NeoTrellis M4 Express](https://learn.adafruit.com/adafruit-neotrellis-m4.md) - [Christmas Soundboard with NeoTrellis M4](https://learn.adafruit.com/xmas-sound-board.md) - [UNTZtrument: a Trellis MIDI Instrument](https://learn.adafruit.com/untztrument-trellis-midi-instrument.md) - [Trellis M4 Audio Filter Visualizer](https://learn.adafruit.com/trellis-m4-audio-visualizer-and-filter.md) - [Mu Keyboard Shortcut Cheat Sheets](https://learn.adafruit.com/mu-keyboard-shortcut-cheat-sheets.md) - [NeoTrellis M4 Memory Game](https://learn.adafruit.com/neotrellis-m4-memory-game.md) - [Neotrellis M4 Live Launcher](https://learn.adafruit.com/neotrellis-live-launcher.md) - [Classic MIDI Synth Control with Trellis M4](https://learn.adafruit.com/classic-midi-synth-control-with-trellis-m4.md) - [Star Trek Soundboard with NeoTrellis](https://learn.adafruit.com/star-trek-sound-board-with-neotrellism4.md) - [NeoTrellis M4 MIDI File Synthesizer](https://learn.adafruit.com/neotrellism4-midi-file-player-synthesizer.md) - [NeoTrellis Sound Board](https://learn.adafruit.com/neotrellis-soundboard.md) - [Make It Talk](https://learn.adafruit.com/make-it-talk.md) - [Launch Deck Trellis M4](https://learn.adafruit.com/launch-deck-trellis-m4.md) - [Introducing Adafruit Trellis ](https://learn.adafruit.com/adafruit-trellis-diy-open-source-led-keypad.md) - [Portable Trellis Sound Board](https://learn.adafruit.com/portable-trellis-sound-board.md)