To use the Hummingbird Bit with Python, you should first complete the Set Up Hummingbird steps below. Your computer must have Bluetooth capability to program the Hummingbird in Python.
From there, you have two choices:
- Run in Browser: The easiest option is to program the Hummingbird in the browser through brython.birdbraintechnologies.com, as shown in the Run in Browser instructions. This website is compatible with Chromebooks as well as Mac/Windows/Linux computers. Choose this option if you are using a Chromebook, are unable to download software, or just want to keep things simple.
- Download Software: These instructions will show you how to use the Hummingbird with an offline Python IDE on Mac/Windows computers. Choose this option to use an IDE such as IDLE that will enable you to use the Hummingbird with a wider range of Python libraries.
Download this file and drag it onto the micro:bit. Your device should start to flash three letters on its display. You will only need to complete this step once for each Hummingbird – as long as your device is flashing its initials, you are ready to connect via Bluetooth.
After dragging the file onto the micro:bit, remove the USB cord. You won’t need it to use Python.
From here, you have two choices:
- The easiest option is to program the Hummingbird in the browser through brython.birdbraintechnologies.com, as shown in the Run in Browser instructions. This website is compatible with Chromebooks as well as Mac/Windows/Linux computers.
- The Download Software instructions will show you how to use the Hummingbird with an offline Python IDE on Mac/Windows computers.
This module will show you how to use a browser-based web app to program the Hummingbird. Start by going to brython.birdbraintechnologies.com. You can use this website with Chromebooks or any Windows/Mac/Linux computer with built-in Bluetooth.
Click Find Robots. You will see a list of devices that start with FN (Finch), BB (Hummingbird), or MB (micro:bit). You may see one robot or many, depending on how many are nearby. If you don’t know which robot is yours, write down the first device name on the list, i.e. BB5AE67. Then click that device. Once you know which Finch is connected, use masking tape to label it with the device name you wrote down. This will help you connect to the correct device in the future.
This section will show you how to use an offline Python editor with the Hummingbird on Mac/Windows computers. Start by installing Python and any offline Python editor. The screenshots here will show the IDLE Python editor, which is automatically installed on your computer with Python.
Next, install the BlueBird Connector. This software will handle the Bluetooth connection with the Hummingbird. You must run it in the background while you are programming the Hummingbird in Python.
Open the BlueBird Connector. It will begin finding the robots around you. Click on the name of your robot. Each robot is flashing its initials on the micro:bit to help you figure out which is which.
You will hear a sound as your device connects, and the initials will stop flashing on the device. The name of your robot should appear under Connected.
Now you are ready to start writing your own Python programs with the Hummingbird! These lessons will help you to get started, and this reference summarizes the functions that are available in the Hummingbird Python library.
Make sure to store your programs in the BirdBrainPython folder so that they can find the BirdBrain library (BirdBrain.py). If you wish to store programs in a different folder, just make a copy of BirdBrain.py and move it to the desired folder.