Overview

docs
package

Rewritten Python Library for Birdbrain Technologies Hummingbird Bit and Finch 2

Rewrite inspired by https://github.com/BirdBrainTechnologies/BirdBrain-Python-Library

• Free software: GNU Lesser General Public License v3 (LGPLv3)

Installation

pip install robot-birdbrain

You can also install the in-development version with:

pip install https://github.com/fmorton/robot-birdbrain/archive/main.zip

Hummingbird Example

from robot.hummingbird import Hummingbird
from time import sleep

hummingbird = Hummingbird('A')

for i in range(0, 10):
  hummingbird.led(1, 100)
  sleep(0.1)

  hummingbird.led(1, 0)
  sleep(0.1)

  hummingbird.stop_all()

Finch Example

from robot.finch import Finch
from time import sleep

finch = Finch('A')

for i in range(0, 10):
  finch.beak(100, 100, 100)
  sleep(0.1)

  finch.beak(0, 0, 0)
  sleep(0.1)

finch.stop_all()

Tasks Example

from robot.hummingbird import Hummingbird
from robot.tasks import Tasks

async def task_1(bird):
  while True:
    print("task_1 running")

    await Tasks.yield_task(1.0)


async def task_2(bird):
  while True:
    print("task_2 running")

    await Tasks.yield_task(0.5)


bird = Hummingbird("A")

tasks = Tasks()

tasks.create_task(task_1(bird))
tasks.create_task(task_2(bird))

tasks.run()

Original Documentation

The original documentation from Birdbrain Technolgies can be found at:

Finch: https://learn.birdbraintechnologies.com/finch/python/library/

Hummingbird: https://learn.birdbraintechnologies.com/hummingbirdbit/python/library/

Testing

To run all the tests run (hummingbird (with micro:bit v2) on 'A' and finch on 'B'):

pytest