No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
.gitignore
Makefile
README.md
hummingbird.ts
icon.png
pxt.json
test.ts
tsconfig.json

README.md

Hummingbird Micro:bit Library

A library for using the Hummingbird Duo with a Micro:bit

To use this package, go to https://makecode.microbit.org/, select "Advanced" and then "Add Package" and copy the package URL - https://github.com/BirdBrainTechnologies/pxt-hummingbird - in the resulting dialog.

Usage

This package adds blocks for controlling Hummingbird sensor and output ports

Micro:bit Pins Used

  • P0 -- Connected to Headphone Jack
  • P14 -- Serial Rx to Hummingbird
  • P15 -- Serial Tx to Hummingbird

Start Hummingbird

Starts communication with the Hummingbird by redirecting serial to P14/P15, typically placed in "On Start"

Set LED

Sets an LED on ports 1 to 4 to a brightness value from 0 to 100

Set Tri-LED

Sets a Tri-color LED on ports 1 or 2 to the color specified by red, green, and blue brightness values. The values range from 0 to 100

Set Servo

Sets a servo on ports 1 to 4 to an angle from 0 to 180 degrees

Set Motor

Sets a motor on ports 1 or 2 to a speed from -100 to 100

Set Vibration Motor

Sets a vibration motor on ports 1 or 2 to an intensity from 0 to 100

Get Sensor

Reads the value of the sensor on ports 1 to 4. Readings range from 0 to 100 and linearly correspond to a voltage from 0 to 5 volts on the sensor port

Examples

Example: Control LED with potentiometer sensor

The Hummingbird has a potentiometer, or rotary knob. This example simply dims the LED on port 1 based on the reading of a sensor on port 1. Any sensor will work, but the potentiometer is easiest to use in this case.

// Starts communication with Hummingbird
hummingbird.startHummingbird()

// Sets LED on port 1 to the value of the sensor (ranges from 0 to 100)
basic.forever(() => {
    hummingbird.setLED(FourPort.One, hummingbird.getSensor(FourPort.One))
})

License

MIT

Supported targets

  • for PXT/microbit (The metadata above is needed for package search.)