04 - Robotbit MicroPython API

Robotbit
April 19, 2022
Anny Xu

Go back to product documents navigation

Go back to Robotbit Documents Navigation

Motor

Run the motor

robotbit.motor(motor number, speed, runtime)

motor number: 0 (all motors), 1~4 (corresponds to M1A, M1B, M2A, M2B respectively)
speed: -255~255, the negative number means to reverse the motor
runtime: stop the motor after a period of time (ms); if set 0, then the motor won't stop.

import robotbit
robotbit.motor(0, 255, 0)

Stop the motor

robotbit.motorstop(motor number)

motor number: stop the corresponding motor immediately; 0 (all motors), 1~4 (corresponds to M1A, M1B, M2A, M2B respectively)

import robotbit
robotbit.motorstop(0)

Servo

robotbit.servo(servo number, servo angle)

servo number: 0~7 correspond to S1~S8 respectively
servo angle: 0~180 correspond to the regular 9g servo (180°)
If you're using Kittenbot geekservo (-45°~225°) and 2KG servo (0°~360°), then refer to the code below

import robotbit
robotbit.servo(0, 90)

# geekservo
robotbit.servo(0, int((servo angle-90)/1.5+90))
# 2KG
robotbit.servo(0, int((servo angle-180)*50/9+1500))

Stepper Motor

robotbit.stepper(stepper motor M1 angle, stepper motor M2 angle)

the program would not run to the next step if the stepper motor does not turn to the set degree
360 means that the stepper motor turns 360°. The stepper motor here is 28byj.

import robotbit
robotbit.stepper(0, 360)

RGB LED

import microbit
import neopixel

np = neopixel.NeoPixel(microbit.pin16, 4)
# the RGB LEDs on Robotbit are controlled by micro:bit pin16, so here we define the pin as pin16 and we need to use all the 4 LEDs on the board

np[0] = (255, 0, 0)
# Set the first LED color as red. Three parameters correspond red, green, and blue.

np.show()
# show the color you set. If not adding this line, the LED won't show the color.

Buzzer

We use the official mocro:bit library here. The default is P0.
music.pitch(frequency, duration)
frequency-pitch reference

import music
music.pitch(262， 500)
# this is the DO in the middle and lasts for 500ms

music.play(note)

note = NOTE[octave][:duration]

import music
music.play('c4:4')
# c4:1 correspond to octave:duration. There are two points that affects the duration: ticks and bpm.
# default duration = 600000/bpm/ticks, default bpm = 120, tick = 4, so c4:1 means that the DO in the fourth octave sounds for 500 ms
# If music.play('c') has the same effect as c4:4, it is because the default octave = 4, duration = 4
# there are also some built-in melodies in the music library, like music.play(music.FUNK)

Built-in melodies:

DADADADUM、ENTERTAINER、PRELUDE、ODE、NYAN、RINGTONE、FUNK、BLUES、BIRTHDAY、WEDDING、FUNERAL、PUNCHLINE、PYTHON、BADDY、CHASE、BA_DING、WAWAWAWAA、JUMP_UP、JUMP_DOWN、POWER_UP、POWER_DOWN

Run the official sample program and enjoy the melody:

from microbit import *
import music

# play Prelude in C.
notes = [
'c4:1', 'e', 'g', 'c5', 'e5', 'g4', 'c5', 'e5', 'c4', 'e', 'g', 'c5', 'e5', 'g4', 'c5', 'e5',
'c4', 'd', 'a', 'd5', 'f5', 'a4', 'd5', 'f5', 'c4', 'd', 'a', 'd5', 'f5', 'a4', 'd5', 'f5',
'b3', 'd4', 'g', 'd5', 'f5', 'g4', 'd5', 'f5', 'b3', 'd4', 'g', 'd5', 'f5', 'g4', 'd5', 'f5',
'c4', 'e', 'g', 'c5', 'e5', 'g4', 'c5', 'e5', 'c4', 'e', 'g', 'c5', 'e5', 'g4', 'c5', 'e5',
'c4', 'e', 'a', 'e5', 'a5', 'a4', 'e5', 'a5', 'c4', 'e', 'a', 'e5', 'a5', 'a4', 'e5', 'a5',
'c4', 'd', 'f#', 'a', 'd5', 'f#4', 'a', 'd5', 'c4', 'd', 'f#', 'a', 'd5', 'f#4', 'a', 'd5',
'b3', 'd4', 'g', 'd5', 'g5', 'g4', 'd5', 'g5', 'b3', 'd4', 'g', 'd5', 'g5', 'g4', 'd5', 'g5',
'b3', 'c4', 'e', 'g', 'c5', 'e4', 'g', 'c5', 'b3', 'c4', 'e', 'g', 'c5', 'e4', 'g', 'c5',
'a3', 'c4', 'e', 'g', 'c5', 'e4', 'g', 'c5', 'a3', 'c4', 'e', 'g', 'c5', 'e4', 'g', 'c5',
'd3', 'a', 'd4', 'f#', 'c5', 'd4', 'f#', 'c5', 'd3', 'a', 'd4', 'f#', 'c5', 'd4', 'f#', 'c5',
'g3', 'b', 'd4', 'g', 'b', 'd', 'g', 'b', 'g3', 'b3', 'd4', 'g', 'b', 'd', 'g', 'b'
]

music.play(notes)