# Getting Started with HalloWing for Hackaday Supercon Attendees ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/064/893/medium800/feather_unnamed-6.jpg?1541085469) ## Welcome to CircuitPython! Hello Hackaday Supercon Fans - we wanted to have a fun _electronic_ item, that does more than just a sticker! What you have in your hand is a Hallowing M0 Express with special thanks to Digi-Key for making it possible for 400 of these to make it to the event! [**THANK YOU Digi-Key!**](https://www.digikey.com/) ## Python Powered? Yep! This hardware comes pre-loaded with [CircuitPython](https://www.adafruit.com/category/956)! CircuitPython is Adafruit's branch of MicroPython designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to get prototyping by requiring no upfront desktop software downloads. With CircuitPython you can write clean and simple Python 3 code to control hardware instead of having to use complex low-level languages like C or C++ (what Arduino uses for programming). It's great for beginners and is powerful for experts. **Simply plug the board into your computer or laptop and edit the code and files on the disk drive that appears.** ## What You Get Each attendee will get a kit of the following: ### Adafruit HalloWing M0 Express [Adafruit HalloWing M0 Express](https://www.adafruit.com/product/3900) [This is Hallowing..this is Hallowing... Hallowing! Hallowing! ](https://www.youtube.com/watch?v=kGiYxCUAhks&t=39s) Are you the kind of person who doesn't like taking down the skeletons and spiders until after January? Well, we've got the development board for... In Stock [Buy Now](https://www.adafruit.com/product/3900) [Related Guides to the Product](https://learn.adafruit.com/products/3900/guides) ![Video of a blinking eye on a Adafruit HalloWing M0 Express.](https://cdn-shop.adafruit.com/product-videos/640x480/3900-07.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) ### Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh [Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh](https://www.adafruit.com/product/3898) Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of **400mAh** for a total of about 1.9 Wh. If you need a larger (or smaller!)... In Stock [Buy Now](https://www.adafruit.com/product/3898) [Related Guides to the Product](https://learn.adafruit.com/products/3898/guides) ![Slim Lithium Ion Polymer Battery 3.7v 400mAh with JST 2-PH connector and short cable](https://cdn-shop.adafruit.com/640x480/3898-05.jpg) ## What Code Am I running? ### On the device are images and code to get started: - **code.py** is the default code, its a slideshow that runs any 128 x 128 bitmap in the `/images` folder on the device. - **slideshow\_code.py** is a copy of the above in case you lose it - **qr\_code.py** makes the URL in the code a QR code to display, handy for your personal site or repo! Note this takes a few seconds to generate in pure python so give it some time. - **touchslideshow\_code.py** is a version of the slide show that has forward and back and brightness by touching the metal teeth. Whichever file is named **code.py** is the one that runs, change the name to change the program. Once saved the device automatically restarted and runs that code! Also included is a sample chapter from "[Getting Started with Adafruit Circuit Playground Express: The Multipurpose Learning and Development Board from Adafruit" 1st Edition by Mike Barela](https://amzn.to/2CMD3vZ) Info: ## Your HalloWing Hardware at a glance You can get a lot more details on every part and pinout by visiting the Hallowing guide at [https://learn.adafruit.com/adafruit-hallowing](https://learn.adafruit.com/adafruit-hallowing) **A built in battery charger will keep the Lipoly topped-up while plugged into USB.** ![](https://cdn-learn.adafruit.com/assets/assets/000/064/736/medium800/feather_3900-06.png?1540706844) ## CircuitPython Quick Start Changing the code is as easy as editing **code.py** in your favorite text editor. [Our recommended editor is Mu](https://learn.adafruit.com/welcome-to-circuitpython/installing-mu-editor), which is great for simple projects, and comes with a built in REPL serial viewer! It is available for Mac, Windows & Linux [https://learn.adafruit.com/welcome-to-circuitpython/installing-mu-editor/](https://learn.adafruit.com/welcome-to-circuitpython/installing-mu-editor/) [https://codewith.mu/](https://codewith.mu/) After the file is saved, CircuitPython will automatically reload the latest code. Connecting to the serial port will give you access to sensor information, better error messages and an interactive CircuitPython (known as the REPL). On Windows we recommend Mu, Tera Term or PuTTY. On Mac OSX and Linux, use Mu or 'screen' can be used from a terminal. ![](https://cdn-learn.adafruit.com/assets/assets/000/064/734/medium800/feather_400.jpg?1540706060) # Getting Started with HalloWing for Hackaday Supercon Attendees ## Slide Shows ![](https://cdn-learn.adafruit.com/assets/assets/000/064/744/medium800/feather_lcds___displays_tinymuse_0290_2k.jpg?1540707284) Your HalloWing is pre-loaded with a CircuitPython program that uses the Image SlideShow library. If you need to re-download the files that were pre-loaded on your HalloWing, [here's the repo](https://github.com/adafruit/CircuitPython_Badge_README/tree/master/final_versions/HACKADAY_SUPERCON_2018). Running a slideshow in CircuitPython on the HalloWing is dead easy! Here's the example code which automatically plays through all .bmp images in the `/images` directory on the board. ## Change from when this guide was first written To make new slideshows, Adafruit suggests following this more recent slideshow guide: [Creating Slideshows in CircuitPython](https://learn.adafruit.com/creating-slideshows-in-circuitpython/overview) That code uses an updated version of the SlideShow library using new display drivers using the CircuitPython `DisplayIO` library. This makes it compatible with a wide range of displays. Danger: This code is only left in to show you the code for the original Hackaday Badge. Pleas follow the guide link above to make more modern slide shows with the same ease. https://github.com/adafruit/CircuitPython_Badge_README/blob/master/final_versions/HACKADAY_SUPERCON_2018/code.py # Making Images for Your Slide Show Warning: ![](https://cdn-learn.adafruit.com/assets/assets/000/064/895/medium800/feather_hackaday.bmp?1541085579) ## BMPs in Windows Microsoft Paint works really well! Make your 128x128 image, ![feather_image.png](https://cdn-learn.adafruit.com/assets/assets/000/064/891/medium640/feather_image.png?1541084958) **Save as...** BMP picture ![feather_image.png](https://cdn-learn.adafruit.com/assets/assets/000/064/890/medium640/feather_image.png?1541084981) Save it to the badge filesystem `/images` folder as **24-bit Bitmap (\*.bmp)** and make sure the file name ends with **.bmp** as well ![feather_image.png](https://cdn-learn.adafruit.com/assets/assets/000/064/892/medium640/feather_image.png?1541085073) ## BMPs in Mac, Linux, etc. There are several online image conversion websites which convert a file from one format to another. We'll show you one below but you can experiment with either other websites or Mac/Linux 3rd party image programs which may output BMP files. We've used [https://image.online-convert.com/convert-to-bmp](https://image.online-convert.com/convert-to-bmp) to convert images to BMP format on the web. Take your 128x128 pixel color image file on your computer and drag/choose the file where indicated on the website. ![feather_Capture.jpg](https://cdn-learn.adafruit.com/assets/assets/000/064/896/medium640/feather_Capture.jpg?1541087450)   Press the Start Conversion button below the file box.   If you need to tweak the settings, the site allows you options but it's best that you already have a color 128x128 pixel image to convert via the web. ![feather_Capture.png](https://cdn-learn.adafruit.com/assets/assets/000/064/902/medium640/feather_Capture.png?1541088339) When the conversion is done, a dialog should pop up in the browser to say where would you like to save the file (now converted with a .bmp file name extension). ![feather_Capture.jpg](https://cdn-learn.adafruit.com/assets/assets/000/064/898/medium640/feather_Capture.jpg?1541087830) Now you have a BMP file! To load onto your HalloWing, use your finder or linux file manager. Plug in your HalloWing to your computer via a good data USB cable. The board should show up as a flash drive named **CIRCUITPY**. Now copy the BMP into the directory on **CIRCUITPY** named **/images**. There you go, done!. You can go into the **images** directory and add / change / delete BMPs as you wish. # Getting Started with HalloWing for Hackaday Supercon Attendees ## More Project Ideas ![](https://cdn-learn.adafruit.com/assets/assets/000/064/894/medium800thumb/feather_arduino_compatibles_ezgif-5-df6cc681f2.jpg?1541085549) The [full HalloWing guide](https://learn.adafruit.com/adafruit-hallowing) is a great place to dive into details on your board. It will give you info on [pinouts](https://learn.adafruit.com/adafruit-hallowing/pinouts), powering the board, onboard sensors and more. There, you'll also learn about setting up the HalloWing for use with [Arduino IDE](https://learn.adafruit.com/adafruit-hallowing/setup) and [CircuitPython](https://learn.adafruit.com/adafruit-hallowing/circuitpython). ## Specialized Firmware If you'd like to fire up the HalloWing in bootloader mode and drag on some fun, ready-to-go firmware .uf2 files, we've got you covered: - [Spooky Eyes](https://learn.adafruit.com/adafruit-hallowing/spooky-eyes) Includes Human, Dragon, No Sclera, Newt, and Terminator flavors!) - [Spirit Board](https://learn.adafruit.com/hallowing-spirit-board/software) the Not-so-Mystifying oracle - [Minotaur Maze](https://learn.adafruit.com/hallowing-minotaur-maze/software) ray-cast 3D(ish) Graphics demo - [Last Minute Halloween Accoutrements](https://learn.adafruit.com/last-minute-halloween-accoutrements-with-hallowing) Star Trek badge and Mario Jump prop (you'll need a speaker to hear the sound effects) All of these projects can be customized and built from source as well if you'd like, there are details in each guide. ![](https://cdn-learn.adafruit.com/assets/assets/000/064/742/medium800/feather_microcontrollers_Spirit-Board-Banner.jpg?1540707036) ## Find a Friend Want to team up with one of your new found friends at Supercon and create a pair of synced eyeballs on two HalloWings? You can do it over I2C, as detailed in the [Synchronized Eyes with Two HalloWings](https://learn.adafruit.com/synchronized-eyes-with-two-hallowings) guide. ![](https://cdn-learn.adafruit.com/assets/assets/000/064/743/medium800/feather_graphic_tfts_hallowing-link-1bat-stemma.jpg?1540707085) # Getting Started with HalloWing for Hackaday Supercon Attendees ## Custom Cases Here are a selection of case ideas for when you get in front of your 3D printer. Full information on how to print them is contained in the respective guide linked on this page.  ![](https://cdn-learn.adafruit.com/assets/assets/000/064/885/medium800thumb/feather_3d_printing_hero-green-loop.jpg?1541023452) Want to jump on one of the Design Lab's 3D printers and make a case for your HalloWing? Here are a couple of designs: [HalloWing Case](https://learn.adafruit.com/hallowing-case/overview) ![](https://cdn-learn.adafruit.com/assets/assets/000/064/878/medium800/feather_3d_printing_3d-parts.jpg?1541023205) [Nine Ball Case](https://cdn-learn.adafruit.com/assets/assets/000/062/273/original/nine_ball_models.zip?1537508374) ![](https://cdn-learn.adafruit.com/assets/assets/000/064/879/medium800/feather_sensors_IMG_4968_2k.jpg?1541023258) [HalloWing Wearable Case](https://www.thingiverse.com/thing:3108276) ![](https://cdn-learn.adafruit.com/assets/assets/000/064/882/medium800/feather_201faecc6a03402b37cb6d49c0fc6c91_preview_featured.jpg?1541023335) ## Featured Products ### Adafruit HalloWing M0 Express [Adafruit HalloWing M0 Express](https://www.adafruit.com/product/3900) [This is Hallowing..this is Hallowing... Hallowing! Hallowing! ](https://www.youtube.com/watch?v=kGiYxCUAhks&t=39s) Are you the kind of person who doesn't like taking down the skeletons and spiders until after January? Well, we've got the development board for... In Stock [Buy Now](https://www.adafruit.com/product/3900) [Related Guides to the Product](https://learn.adafruit.com/products/3900/guides) ### AdaBox009 - HalloWing [AdaBox009 - HalloWing](https://www.adafruit.com/product/3956) Are you the kind of person who doesn't like taking down the skeletons and spiders until after January? Well, we've got the ADABOX for you. This is electronics at its _most spooky!_ ADABOX 009 is Halloween themed, for all of us who love scares, costumes, and (of... No Longer Stocked [Buy Now](https://www.adafruit.com/product/3956) [Related Guides to the Product](https://learn.adafruit.com/products/3956/guides) ### 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) ### Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh [Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh](https://www.adafruit.com/product/3898) Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of **400mAh** for a total of about 1.9 Wh. If you need a larger (or smaller!)... In Stock [Buy Now](https://www.adafruit.com/product/3898) [Related Guides to the Product](https://learn.adafruit.com/products/3898/guides) ## Related Guides - [Adafruit Hallowing M0](https://learn.adafruit.com/adafruit-hallowing.md) - [HalloWing Flapping Bat](https://learn.adafruit.com/hallowing-flapping-bat.md) - [Tiny Museum Tour Device](https://learn.adafruit.com/tiny-museum-tour-device.md) - [Terminator Eyeball Upgrade](https://learn.adafruit.com/terminator-eyeball-upgrade.md) - [Hallowing Minotaur Maze](https://learn.adafruit.com/hallowing-minotaur-maze.md) - [HalloWing Jump Scare Trap](https://learn.adafruit.com/hallowing-jump-scare-trap.md) - [GPS Tour Guide](https://learn.adafruit.com/gps-tour-guide.md) - [Creating Custom Symbol Fonts for Adafruit GFX Library](https://learn.adafruit.com/creating-custom-symbol-font-for-adafruit-gfx-library.md) - [Introducing Adafruit Feather](https://learn.adafruit.com/adafruit-feather.md) - [Last-Minute Halloween Accoutrements with HalloWing](https://learn.adafruit.com/last-minute-halloween-accoutrements-with-hallowing.md) - [HalloWing Light Paintstick](https://learn.adafruit.com/hallowing-light-paintstick.md) - [Glowing Mirror Mask](https://learn.adafruit.com/glowing-mirror-mask.md) - [Hocus Pocus Book - Hallowing Eye](https://learn.adafruit.com/hocus-pocus-book-eye.md) - [HalloWing Badge Image Viewer](https://learn.adafruit.com/hallowing-badge.md) - [HalloWing Lightsabers](https://learn.adafruit.com/hallowing-lightsaber.md)