Level 1¶
micro:bit¶
-
class
bluezero.microbit.
Microbit
(device_addr, adapter_addr=None, accelerometer_service=True, button_service=True, led_service=True, magnetometer_service=False, pin_service=False, temperature_service=True, uart_service=False)¶ Class to simplify interacting with a micro:bit over Bluetooth Low Energy
-
accelerometer
¶ Read the values of the accelerometer on the microbit :return: return a list in the order of x, y & z
-
bearing
¶ Compass bearing in degrees from North. :return: degrees in integer
Read the state of button A on a micro:bit 3 button states are defined and represented by a simple numeric enumeration: 0 = not pressed, 1 = pressed, 2 = long press. :return: integer representing button value
Read the state of button B on a micro:bit 3 button states are defined and represented by a simple numeric enumeration: 0 = not pressed, 1 = pressed, 2 = long press. :return: integer representing button value
-
calibrate
()¶ Request a calibration of the magnetometer
-
clear_display
()¶ Clear the LED display on the microbit
-
connect
()¶ Connect to the specified micro:bit for this instance
-
connected
¶ Indicate whether the remote device is currently connected.
-
disconnect
()¶ Disconnect from the micro:bit
-
magnetometer
¶ Exposes magnetometer data. A magnetometer measures a magnetic field such as the earth’s magnetic field in 3 axes. :return: List of x, y & z value
-
pin_values
¶ Get the values of all the pins that are set as inputs :return: Dictionary (keys are pins)
-
pixels
¶ Returns a list of 5 binary numbers. Each number represents a row from top to bottom :return: Example [0b01110, 0b01000, 0b10000, 0b10000, 0b01110]
-
quit_async
()¶ Stops asynchronose mode :return:
-
run_async
()¶ Puts the code into asynchronous mode :return:
-
scroll_delay
¶ Specifies a millisecond delay to wait for in between showing each character on the display.
-
set_pin
(pin_number, pin_input, pin_analogue)¶ For a given pin, set the direction and type for the microbit pin.
Parameters: - pin_number – Pin number of the microbit
- pin_input – False for output, True for input
- pin_analogue – False for digital, True for analogue
Returns:
Execute user_callback on Button A being press on micro:bit :param user_callback: User callback method receiving the button state :return:
Execute user_callback on Button B being press on micro:bit :param user_callback: User callback method receiving the button state :return:
-
subscribe_calibrate
(user_callback)¶ Execute user_callback when calibration of magnetometer is complete :param user_callback: :return:
-
subscribe_pins
(user_callback)¶ Execute user_callback on input pin being changed on micro:bit :param user_callback: :return:
-
subscribe_uart
(user_callback)¶ Execute user_callback on data being received on UART service
Parameters: user_callback – Returns:
-
temperature
¶ Temperature from sensors in micro:bit processors :return: Integer of temperature in Celsius
-
text
¶ Specify text to be displayed. Limit of 20 characters. The content will be restricted to that number of characters. :param words:
-
uart
¶ Write string to micro:bit UART service. To read from UART, use
Returns:
-
-
class
bluezero.microbit.
MIpower
(device_addr, adapter_addr=None, accelerometer_service=True, button_service=True, led_service=True, magnetometer_service=False, pin_service=False, temperature_service=True)¶ -
beep
(duration=1)¶ If a buzzer is attached to pin 0 then a beep will be played :param duration: time in seconds
-
-
class
bluezero.microbit.
BitBot
(device_addr, adapter_addr=None, accelerometer_service=False, button_service=True, led_service=True, magnetometer_service=False, pin_service=True, temperature_service=False)¶ Class to simplify interacting with a microbit attached to a bit:bot over Bluetooth Low Energy The bit:bot is a micro:bit robot available from 4tronix.co.uk
-
buzzer_off
()¶ Stop the buzzer
-
buzzer_on
()¶ Play the buzzer
-
clean_up
()¶ Stop bitbot and turn buzzer is off :return:
-
connect
()¶ Connect to the bit:bot
-
connected
¶ Returns true if bit:bot is connected
-
disconnect
()¶ Disconnect from the bit:bot
-
drive
(left=100, right=100)¶ Set the drive power of both wheels at same time :param left: percentage of power (negative numbers are reverse) :param right: percentage of power (negative numbers are reverse)
-
forward
()¶ Spin both wheels forward
-
left_light_sensor
¶ Get the value of the left light sensor
-
left_line_senor
¶ Value ofthe left line sensor :return: False = No line True = Line
-
line_sensors
¶ Get the value of both line sensors :return: (left, right)
-
reverse
()¶ Spin both wheels backwards
-
right_light_sensor
¶ Get the value of the left light sensor
-
right_line_sensor
¶ Value of the right line sensor :return: False = No line True = Line
-
spin_left
()¶ Spin left wheel forward and right wheel backwards so bit:bot spins
-
spin_right
()¶ Spin right wheel forward and left wheel backwards so bit:bot spins
-
stop
()¶ Stop both wheels of the bit:bot
-
Eddystone¶
-
class
bluezero.eddystone_beacon.
EddystoneURL
(url, tx_power=8)¶ Create and start broadcasting a Eddystone URL beacon
The Eddystone-URL frame broadcasts a URL using a compressed encoding format in order to fit more within the limited advertisement packet. :Example:
>>> from bluezero import eddystone_beacon >>> eddystone_beacon.EddystoneURL('https://github.com/ukBaz')
Parameters: - url – String containing URL e.g. (‘http://camjam.me’)
- tx_power – Value of Tx Power of advertisement (Not implemented)