Welcome to Building:bit Superkit repository
3.Micro:bit handle control
Microbit handle control
Microbit handle control1. Learning objectives2. Building blocks3. Motor wiring4. Code analysis4.1 Catapult4.2 Handle5. Write and download the program6. Experimental phenomenon
1. Learning objectives
In this course, we mainly learn how to use Python programming to remotely control the catapult with the micro:bit handle.
2. Building blocks
For the building blocks steps, please refer to the installation drawings of [Assembly course]-[Mobile shooter] in the materials or the building blocks installation album.
3. Motor wiring
Insert the motor wiring on the left side of the car into the M1 interface of the Super:bit expansion board, and the black wire is close to the battery side;
Insert the motor wiring on the right side of the car into the M3 interface of the Super:bit expansion board, and the black wire is close to the battery side;
Insert the building blocks servo wiring into the S1 interface of the Super:bit expansion board, and the orange servo wiring is inserted into the yellow pin of S1.
As shown in the figure below:

! Notes:
When taking a course related to the building block servo for the first time, we need to remove the large gear installed on the servo and upload the program of this course to the micro:bit; then turn on the power switch of the Super:bit expansion board and wait for the building block servo to turn to the initial position; then, we can turn off the power, adjust the angle of the car projection rod to be parallel to the ground, and then install the servo gear. (If you have used the catapult and servo related programs before, you can skip this step)

4. Code analysis
4.1 Catapult
For the program, please refer to the Mobile shooter code.py file.
from microbit import *import superbitimport radioimport neopixelFirst, import the libraries needed for this lesson from microbit: the superbit library is dedicated to the superbit expansion board; neopixel is used to control RGB lights; radio is used for the wireless communication function of micro:bit.
xRed = (255, 0, 0)Orange = (255, 165, 0)Yellow = (255, 255, 0)Green = (0, 255, 0)Blue = (0, 0, 255)Violet = (148, 0, 211)White = (255, 255, 255)color_lib = { 'Red': Red, 'Orange': Orange, 'Yellow': Yellow, 'Green': Green, 'Blue': Blue, 'Violet': Violet, 'White': White}def RGBLight_more_show(first, num, color): global np np.clear() for i in range(first, first + num): np[i] = color_lib[color] np.show()This section of the program is used to define different colors of RGB lights, and define the function RGBLight_more_show to control the color of the RGB light. This function will be called in the following main loop.
xxxxxxxxxxnp = neopixel.NeoPixel(pin12, 4)display.show(Image.HEART)radio.on()radio.config(group=1)superbit.servo270(superbit.S1, 105)display.show(Image.HAPPY): Display a smiley face pattern on the microbit dot matrix;
np = neopixel.NeoPixel(pin12, 4): Initialize the RGB lights. There are 4 RGB lights in total, connected to the P12 pin of the microbit motherboard (check the hardware interface manual);
radio.on(): Turn on the wireless function. Because the wireless function consumes more power and occupies more memory, it is turned off by default. You can also use radio.off() to turn off the wireless function;
radio.config(group=1): Configure wireless group=1, so that other microbit devices with wireless group=1 can communicate with each other. The default is 0, and the selectable group is 0~255. The set group value needs to be consistent with the handle setting, otherwise it will not communicate normally; superbit.servo270(superbit.S1, 105): Initialize the servo to rotate to 105° (reset the projection rod).
xxxxxxxxxxwhile True:incoming = radio.receive()if incoming == 'up':superbit.motor_control(superbit.M1, 255, 0)superbit.motor_control(superbit.M3, 255, 0)...In the main loop, determine whether the car receives the command sent by the handle, and control the movement state of the car and the color of the RGB light.
incoming = radio.receive(): Receive the data transmitted wirelessly and save it to the incoming variable; if incoming is 'up', the catapult moves forward, 'down' makes the catapult move backward, 'left' makes the catapult rotate left, 'right' makes the catapult rotate again, and 'stop' makes the catapult stop;
If incoming is 'R', the body RGB lights up red and the projection rod is launched, 'G' makes the body RGB light up green, 'B' makes the body RGB light up blue, 'Y' makes the body RGB light up yellow, and the projection rod is reset.
! Note:
The incoming value must correspond to the value sent by the handle. Only the same value can receive and execute commands.
4.2 Handle
Please refer to the Handle code.py file for the program.
xxxxxxxxxxfrom microbit import display, Imageimport ghandleimport radioFirst, import the libraries needed for this lesson from microbit: the ghandle library is dedicated to the micro:bit hand; radio is used for the wireless communication function of micro:bit.
xxxxxxxxxxdisplay.show(Image.HEART)radio.on()radio.config(group=1)display.show(Image.HEART): Display a heart pattern on the microbit dot matrix;
radio.on(): Turn on the wireless function. Because the wireless function consumes more power and occupies more memory, it is turned off by default. You can also use radio.off() to turn off the wireless function;
radio.config(group=1): Configure wireless group=1, so that other microbit devices with wireless group=1 can communicate with each other. The default is 0, and the selectable group is 0~255. The set group value needs to be consistent with the handle setting, otherwise it will not communicate normally;
xxxxxxxxxxwhile True:if ghandle.rocker(ghandle.up):radio.send('up')display.show(Image.ARROW_N)elif ghandle.rocker(ghandle.down):radio.send('down') display.show(Image.ARROW_S) elif ghandle.rocker(ghandle.left): radio.send('left') display.show(Image.ARROW_W) elif ghandle.rocker(ghandle.right): radio.send('right') display.show(Image.ARROW_E) elif ghandle.rocker(ghandle.pressed): radio.send('turn_off') display.show(Image.NO) else: radio.send('stop') display.clear()If ghandle.rocker(ghandle.up) is True, it means that the joystick of the handle is pushed up, so that the wireless sends the 'up' command and displays an upward icon;
If ghandle.rocker(ghandle.down) is True, it means that the joystick of the handle is pushed down, so that the wireless sends the 'down' command and displays a downward icon;
If ghandle.rocker(ghandle.left) is True, it means that the joystick of the handle is pushed to the left, so that the wireless sends the 'left' command and displays a left icon;
If ghandle.rocker(ghandle.right) is True, it means that the joystick of the handle is pushed to the right, so that the wireless sends the 'right' command and displays a right icon;
If ghandle.rocker(ghandle. pressed) is True, it means that the joystick of the handle is pressed, so the wireless sends the 'pressed' command and displays the 'X' icon;
If the remote control has no operation, it sends 'stop' and clears the display;
xxxxxxxxxxif ghandle.B1_is_pressed():radio.send('R')display.show("R")if ghandle.B2_is_pressed():radio.send('G')display.show("G")if ghandle.B3_is_pressed():radio.send('B')display.show("B")if ghandle.B4_is_pressed():radio.send('Y')display.show("Y")Next, detect the button and send R', 'G', 'B', 'Y' commands corresponding to B1 (red), B2 (green), B3 (blue), and B4 (yellow).
5. Write and download the program
- Open the Mu software and enter the code in the editing window. Note! All English and symbols should be entered in English, use the Tab key for indentation, and the last line ends with a blank program.
- Click the thumb 'Check' button to check if there are any errors in our code. If a cursor or underline appears in a line, it means a syntax error. Please check and modify it. If there is no error, the lower left corner will prompt that there is no problem with the detection.

- Click the 'REPL' button to check whether the Superbit library has been downloaded. If not, please refer to [Preparation before class] --> [2.4 Python Programming Guide].

- After the program is written, connect the computer and microbit mainboard with a microUSB data cable, please click the 'Flash' button to download the program to the micro:bit mainboard. (You need to click the 'REPL' button again to turn off the import library file function before you can download the program normally).

- If the download fails, please confirm whether the microbit is connected to the computer normally via the microUSB data cable and the Superbit Python library has been imported.
6. Experimental phenomenon
We need to download the Mobile shooter code.py file to the micro:bit mainboard of the catapult, turn on the power switch of the catapult, and we can see a smiley face pattern displayed on the micro:bit dot matrix;
Download the Handle code.py file to the micro:bit mainboard of the handle, turn on the power switch of the handle, and we can see that the micro:bit dot matrix will be initialized to display a heart pattern, and then an "X" pattern will be displayed, indicating that the handle is in the default state and no data is sent.
The two will automatically complete the pairing, and then we can start remote control of the catapult.
The handle functions are as follows.
