Python: Installation for Hummingbird Bit

Installation

Python is a great text-based language for beginning programmers because it is powerful but easy to learn and use. If you are ready to move from block-based to text-based programming, give it a try! Our Python library allows students to use Python to read sensors and set motors and LEDs with the Hummingbird Bit. To use Python with the Hummingbird Bit, you must connect to the Hummingbird Bit via bluetooth with the BlueBird Connector. You will need a bluetooth dongle

Download & Install

Need links to the BlueBird Connector for Mac

Need links to the BlueBird Connector for Windows

Preparing the Hummingbird Bit

Insert a micro:bit into the Hummingbird Bit. Connect the Bit to power (battery pack or AC power adapter), and connect the micro:bit to the computer with the USB cable.

The micro:bit will appear as an external device on your computer. Download this file and drag it onto the micro:bit. 

The micro:bit will begin flashing three letters on its LED screen. At this point, you can unplug the USB cable from the micro:bit. You won’t need it because you will be using bluetooth to connect to the Hummingbird Bit.

Connecting to the Hummingbird Bit

Insert the bluetooth dongle into your computer. The bluetooth dongle is required, even if your computer has built-in bluetooth.

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.

When you connect to your Bit, you will hear a series of tones, and the robot will show up in the purple “CONNECTED” section of the BlueBird Connector.

Now you are ready to start programming in Python! You can minimize the BlueBird Connector, but you should leave it open the entire time that you are using the Bit. If at any point you have trouble with your robot, you should come back to the BlueBird Connector to check your bluetooth connection. You can also check your battery level in the BlueBird Connector.

Using Python with Hummingbird Bit

You can use any Python IDE with the Bit. The screenshots here will show IDLE as an example.

Download the Python library. This folder contains the main library (HummingbirdBit.py) and a test file (HummingbirdTest.py). To test that everything is working properly, connect a single-color LED to port 1 of the Hummingbird. Then open HummingbirdTest.py in your IDE. To run the test program in IDLE, choose Run/Run Module. The single-color LED should blink 10 times.

Now you are ready to start writing your own Python programs with the Hummingbird! You can use these videos to help you connect lights, motors, and sensors to your Hummingbird Bit. Once you have some parts connected, use this reference to learn more about what functions are available in the Hummingbird Python library.

Make sure to store your programs in the HummingbirdPython folder so that they can find the Hummingbird library (HummingbirdBit.py). If you wish to store programs in a different folder, just make a copy of HummingbirdBit.py and move it to the desired folder.