Program

First, use this tutorial to switch your Hummingbird into micro:bit mode.

Next, attach the micro:bit shield to the bottom side of the Hummingbird.

Insert the micro:bit into the shield. Connect the AC power adapter to the Hummingbird board and the micro:bit USB cord to the micro:bit.

Go to makecode.microbit.org. If you need a new, empty project, go to Projects and then select New Project. Give your project a name in the text box at the bottom-middle of the screen.

Click on Advanced at the bottom of the list of MakeCode menus, and then scroll down to select Extensions.

Enter the website https://github.com/BirdBrainTechnologies/pxt-hummingbird-duo in the search bar and press enter. Then click the hummingbird package to add it.

Now you have a Hummingbird menu in MakeCode! You are ready to start writing programs that use both micro:bit and Hummingbird.

The micro:bit simulation is not compatible with the Hummingbird, so we suggest that you minimize the picture of the micro:bit to leave more room for your programs.

To write a program in MakeCode, you first select a menu, then a block from that menu. The block will appear in the Scripts area, and you can add it to one of your scripts. Script is just another word for a program that you write for Hummingbird and micro:bit.

A new MakeCode program for micro:bit automatically contains two items from the Basic menu. Blocks inside on start will run when you download the code to the micro:bit or turn the micro:bit on. After that, blocks inside forever will run over and over as long as the micro:bit has power.

IMPORTANT: Any MakeCode program that uses the Hummingbird must include the Start Hummingbird block from the Hummingbird menu. The Start Hummingbird block must be placed inside on start.

To download a program onto the micro:bit, click the purple Download button at the bottom of the screen. If the .hex file does not download directly onto the drive labelled MICROBIT on your computer, you will need to move the .hex file to this drive.

First, you will learn to use the lights, which are also called LEDs. The Hummingbird kit contains two types of LEDs, single color LEDs and tri-color LEDs. Single color LEDs have two wires, while tri-color LEDs have four wires.

There are also LEDs on the micro:bit itself. The surface of the micro:bit contains 25 tiny LEDs that you can use to make pictures and patterns!

In the Basic menu, there are two blocks that enable you to create simple pictures using the 25 tiny LEDs on the micro:bit. The show icon block allows you to select from a list of pictures, while the show leds block lets you pick which LEDs should be on and which should be off.

For example, this code will display a heart on the micro:bit. Here, we have chosen to place the show icon block inside on start because we only need that block to be executed once. As long as nothing else is happening with the LEDs, all we need to do is to turn on the pattern at the beginning of the program.

A single color Hummingbird LED can be connected to one of four ports labeled “LEDS” on the Hummingbird board. Since you have four ports, you can connect up to four single color LEDs. The black LED wire should be connected to the ‘-’ terminal, while the colored wire should be connected to the ‘+’ terminal.

The Set LED block on the Hummingbird menu is used to control a single color LED.

To use this block, first select the port to which the LED is attached (one to four). Then set the brightness of the LED from 0% and 100%. 0% means that the LED is off, and 100% means that the LED is at maximum brightness. The code below will set an LED in port 1 to maximum brightness.

To blink an LED, we need the Set LED block and also a pause block, which can be found on the Basic menu. The pause block pauses the program for a certain number of milliseconds.

Add a Set LED block and a pause block to the forever block. Turn the LED on at maximum brightness for half a second.

Next, add a second Set LED and a second pause block to turn the LED off for half a second. Now your program will repeatedly turn the LED on for half a second and then turn it off for half a second. This should make the LED blink! Upload the program to give it a try.

Once you have uploaded your program, the LED should continue to blink even when you unplug the USB cord. This is because your program is actually running on the microcontroller in the micro:bit! However, the Hummingbird and micro:bit do need power, so you will still need the power adapter or a battery pack. As long as the board has power, the program will continue to run until you upload a new program to replace it.

A tri-color LED can be attached to one of the two ports labeled “TRI-COLOR” on the Hummingbird board. The four wires of the tri-color LED are red, green, blue, and black. The black wire should be connected to the ‘-’ terminal. The red wire should be connected to the ‘R’ terminal, the green to the ‘G’ terminal, and the blue to the ‘B’ terminal.

The tri-color LED actually has three tiny lights inside it. One is red, one is green, and one is blue. This is important for programming the tri-color LED with the Set Tri-LED block on the Hummingbird menu. This block requires four pieces of information, or parameters. The top drop-down menu is used to select the number of the port to which the tri-color LED is attached (One or Two). The other parameters control the amount of red, green, and blue light from 0 to 100. As an example, the block below makes a tri-color LED in port 1 blink between green and red.

The micro:bit has two buttons labelled ‘A’ and ‘B.’ You can write scripts that will run when one button is pressed, or when both are pressed together.

To do this, use the on button pressed block on the Input menu.

This block has a drop down menu that allows you to select button A, button B, or both (A+B). Any blocks inside the on button pressed will run each time the selected button or buttons are pushed.

For example, when the A button is pressed, this script display a smiley face on the micro:bit for 1 second. Note that to use the button more than once, we need to turn the LEDs off at the end of the script.

The Hummingbird kit works with three different kinds of motors: vibration motors, servo motors, and gear motors.

A vibration motor can be attached to one of the two ports labeled “VIBRATION” on the Hummingbird board. It does not matter which wire is attached to ‘+’ and which is attached to ‘-.’

The Set Vibration Motor block is used to control the vibration motor. This block requires two parameters. The first is the port attached to the vibration motor (One or Two) and the second is the intensity of vibration from 0% to 100%. The code below will turn on the vibration motor at half the maximum intensity when the program starts.

The gear motor can be attached to either of the ports labeled “MOTORS” on the Hummingbird board. It does not matter which wire is attached to ‘+’ and which is attached to ‘-.’

Important Note: Do not cut the zip ties off your motors. Without the zip tie, the wires may break off the motor.

The Set Motor block is used to control the gear motor. This block requires two parameters. The first is the port attached to the motor. The second is the motor speed. This number can be any whole number from -100 to 100.

As an example, the script below repeatedly turns the motor on for two seconds and then off for two seconds.

A servo motor is a motor that moves to a particular angle. The Hummingbird servo motor can rotate to any angle from 0° to 180°.

The servo motor has a small plug. This plug should be connected to one of the four sets of pins in the “SERVOS” section of the Hummingbird board. Each set of three pins is one servo port. The black wire should be connected to the ‘-’ pin, the red wire to the ‘+,’ and the yellow wire to the ‘S.’

Use hot glue to attach a popsicle stick to the white plastic circle on the servo motor. This will help you to see the movement of the servo motor more easily. If you don’t want to use hot glue, you can tape a feather to the plastic circle.

The Set Servo block is used to move the servo motor. It requires two parameters. The first parameter is the port attached to the servo (One to Four) and the second is the angle (0° to 180°). For example, the script below will move the servo back and forth between 0° and 90°.

The main forever block in MakeCode is a loop, a programming structure that repeats actions within a program. The forever loop is great for blinking an LED, but another type of loop can be helpful to get a fading effect. This loop is called a for loop, and you can find it on the Loops menu.

The for block uses a variable. A variable is just a name that represents a value. By default, the name of the variable is “index,” though you can click the drop-down menu for an option to rename it. The parameter determines the number of times that the for loop repeats the blocks inside it.

An example program using the for block is shown below. Try out this program and see your LED repeatedly increase in brightness. You can find the red index block on the Variables menu.

The for block uses the index variable to keep track of how many times the commands inside the loop have been repeated. The logic of the loop is shown in the flowchart below. When the program reaches the for block, it sets the variable index to 0 and then checks if the value of index is less than or equal to the maximum, which is 100 here. If it is, the blocks inside the for are executed, and the value of index is increased by 1. Then the program returns to the test at the top of the loop and checks again whether index is less than or equal to 100. This process continues until that test fails. When index is not less than or equal to 100, the loop ends and the program moves on to the block below the for block. In this case, the program pauses for two seconds, and then the for loop starts all over again.

The LEDs and motors are output devices. Programs send commands to these devices to make something happen. The Hummingbird sensors, on the other hand, are input devices. They send information to the program. The program can use this information to control a light or a motor or to make a decision. The micro:bit also contains sensors; for example, the micro:bit accelerometer senses when you tilt the device.

The LEDs and motors are output devices. Programs send commands to these devices to make something happen. The Hummingbird sensors, on the other hand, are input devices. They send information to the program. The program can use this information to control a light or a motor or to make a decision. The micro:bit also contains sensors; for example, the micro:bit accelerometer senses when you tilt the device.

All sensors use the Get Sensor block on the Hummingbird menu. This block requires only one parameter, the port of the sensor. This block has a different shape because it measures a value and passes that value back to the program. In computer science, passing a value back to the program is called returning a value. The value of the Get Sensor block is always in the range 0-100 (arbitrary units). This value represents a voltage between 0 and 5 V.

Because the Get Sensor block returns a number between 0 and 100, you can place it inside the Set LED block to set the intensity of the light.

The rotary knob is useful for controlling the LEDs because the range of the Get Sensor block (0-100) is the same as the input range for these components. If you place the knob block inside the Set Servo block as shown, the servo will only move from 0° to 100°.

You can make the servo move from 0° to 180° using arithmetic blocks from the Math menu. These blocks enable you to add, subtract, multiply, and divide numbers.

Use the Get Sensor block to produce an angle between 0° and 180° by multiplying it by 1.8.

You can also use the micro:bit accelerometer to control LEDs and motors. You can measure the micro:bit’s acceleration using the acceleration block on the Input menu. The accelerometer can measure the tilt of the micro:bit in three directions, which are called x, y, and z. You can use the drop-down menu in the acceleration block to select one of these directions.

The value of the acceleration block is always between 0 and 1024. To use it to control a Hummingbird output, you need to use the division operator to reduce this value to a range within 0 to 100. For example, the script below will use the three directions of acceleration to control the three light elements of the tri-color LED.

The light sensor measures the amount of light around it. Like the rotary knob, you can find its value with the Get Sensor block on the Hummingbird menu. This value will be between 0 and 100. To see the value of the light sensor, you can use the show number block from the Basic menu. This script will scroll the sensor value across the micro:bit LED array each time you press the button A.

You can use a sensor to enable a robot to make a decision. For example, suppose you want to turn on an LED if the light sensor detects that it is dark. The if then else block on the Logic menu is a decision block. To explain how this block works, consider this example.

The if then else block has three parts. At the top beside the if is a Boolean block, which is a block that can be either true or false. You can create a Boolean block using the comparison operators from the Logic menu.

The Boolean block in our sample program checks whether the value of the light sensor is less than 20. If this is true, the block inside the then section of the if then else is executed, and the LED turns on. If the Boolean block is false, the block inside the else section of the if then else is executed, and the LED turns off. The value that a Boolean block uses to make a decision is called the threshold. In the sample program, the threshold is 20. If the value of the light sensor is less than this threshold, the program decides that it is dark.

The Hummingbird distance sensor emits infrared waves. If there is an object near the sensor, infrared waves bounce off the object and return to the sensor. The angle of reflection is used to measure how far away the object is (more info here).

An if then else uses a Boolean block to choose one of two possibilities. You can also use Boolean blocks in loops, such as the while do block (Loops menu) in MakeCode. The while do block uses a Boolean block to determine how many times the blocks inside it will be executed. The blocks inside the loop will be repeated as long as the Boolean block is true. When the Boolean block is false, the program will move on to whatever block is below the while loop.

For example, the loop below will blink a tri-color LED as long as nothing is close to the distance sensor. When the value of the sensor is greater than or equal to 20, the LED will stop blinking and turn green.

If you have two or more micro:bits, they can communicate with each other! This means that you can create robots that interact with one another. To do this, you will use the blocks in the Radio menu.

To send radio messages to one another, two (or more) micro:bits must be set to the same radio group. In the on start block for each micro:bit, use the radio set group block to assign both micro:bits the same radio number. Here, the radio group number is 120.

A micro:bit can send a message using the radio send string block or the radio send value block. Assume that for the script below, the Hummingbird light sensor is attached to port 1. When the light sensor detects that it is dark, the micro:bit sends the string “dark.” Otherwise, it sends the string “light.”

A second micro:bit can listen for the messages sent by the first one. If the first micro:bit is using radio send string, then the second should use the on radio received receivedString to listen for messages. When it receives a string, it can check to see which of the two possible messages it has received. The script below turns on an LED when it receives the message “dark.” The LED turns off if it receives the message “bright.”