# micro : bit Block Guide
## micro:bit V2 Mainboard  
### Matrix  
#### Display Image ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M1.png)

Used to display the specified pattern from the drop-down list on the micro:bit mainboard.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M2.png)

#### Display Icon ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M3.png)

Used to display manually drawn patterns on the micro:bit mainboard

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M4.png)

#### Display String ( )  
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M5.png)

Used to display the input string on the micro:bit mainboard.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M6.png)

#### Scroll Display String ( )  
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M7.png)

Used to scroll and display the string on the micro:bit mainboard.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M8.png)

#### Set Pixel x( ) y( ) Brightness ( )  
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M9.png)

Allows you to set the brightness of the pixel at coordinates x, y.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M10.png)

#### Clear Display
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M11.png)

Clears the display content on the dot matrix.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M12.png)

### Sensor
#### When Button ( ) Pressed
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M13.png)

Check if the selected button is pressed.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M14.png)

#### Brightness
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M15.png)

Returns the current environmental brightness.  
Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M16.png)

#### Temperature  
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M17.png)

Returns the current environmental temperature.  
Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M18.png)

#### Sound
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M19.png)

Returns the current environmental sound.  
Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M20.png)

#### Compass Calibrate
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M21.png)

Calibrate the internal compass of the micro:bit.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M22.png)

#### Compass Heading
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M23.png)

The micro:bit has a compass sensor that can measure its orientation or azimuth angle based on magnetic north.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M24.png)

#### Magnetic Strength（ ）
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M25.png)

<font style="color:rgb(38, 38, 38);background-color:rgb(245, 246, 248);"></font>You can use the compass as a magnetometer to measure the magnetic field strength. It can do this in 3 dimensions and can simultaneously measure the overall magnetic field strength in all dimensions.  

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M26.png)

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M27.png)

#### **( ) Gesture**
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M28.png)

Determines whether a specific gesture is detected.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M29.png)

#### Acceleration ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M30.png)

Get the acceleration along the three axes (X, Y, Z).  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M31.png)	

### Music
#### Play Music( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M32.png)

Play the selected music

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M33.png)

#### Set Playback Speed ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M34.png)

You can set the rhythm or speed of the music played on the micro:bit:

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M35.png)

#### Tone Frequency ( ) Continuous Play  
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M36.png)

The micro:bit can play sounds defined by frequency or pitch.  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M37.png)

#### Stop Continuous Play
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M38.png)

Stop Continuous Sound Playback  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M39.png)

#### 语音 说（）
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M40.png)

Control the micro:bit to speak the input text using speech.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M41.png)

#### Play Expressive Sound ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M42.png)

Control the micro:bit to play expressive sounds.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M43.png)

#### Set Volume（ ）
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M44.png)

Set volume of the sound played

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M45.png)

#### （ ）Speaker
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M46.png)

Turn Off/On the Speaker

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M47.png)

## micro:bit V2 Peripheral
#### Long Range Photoelectric Sensor ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M48.png)

Get the value of the long-distance photoelectric sensor

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M49.png)

#### Potentiometer ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M50.png)

Get the potentiometer's return value

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M51.png)

#### Gray Level Sensor（ ）
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M52.png)

Get the grayscale sensor value

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M53.png)

#### Photosensitive Sensor ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M54.png)
Get the photosensitive sensor value

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M55.png)

#### Flame Sensor ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M56.png)

Get the flame sensor value.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M57.png)

#### Water Level Sensor( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M58.png)

Get the water level sensor value.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M59.png)

#### MQ-2 Gas Sensor （ ）
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M60.png)

Get the MQ-2 gas sensor value.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M61.png)

#### Soil Moisture Sensor ( )
 <!-- 这是一张图片，ocr 内容为： -->
![](IMG/M62.png)
Get the soil moisture sensor value.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M63.png)

#### Temperature Sensor ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M64.png)

Get the temperature sensor value.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M65.png)

#### Hall Sensor ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M66.png)

Get the hall sensor value.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M67.png)

#### Button Sensor ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M68.png)

Get the button sensor value.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M69.png)

#### Ultrasonic Sensor (P13, P0) Unit cm
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M70.png)

Get the value obtained by the ultrasonic sensor.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M71.png)

#### Detect Rocker（ ）
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M72.png)

Determine the direction of the detected joystick.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M73.png)

#### Rocker ( ) Direction
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M74.png)

Return the detected joystick direction.  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M75.png)

### Action
#### Servo ( ) Angle ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M76.png)

Control the servo to rotate to a specific angle.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M77.png)

#### Motor ( ) Angle ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M78.png)

Control the Motor to Rotate at a Specified Speed  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M79.png)

#### Fan ( ) Switch to ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M80.png)

Control the Fan to Toggle Between On/Off States

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M81.png)

#### Electromagnet ( ) Switch to ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M82.png)

Control the Electromagnet to Toggle Between On/Off States  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M83.png)

#### Read（ ）Motor Position
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M84.png)

Get the position of different motors.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M85.png)

#### **Left Motor Set to ( ) Right Motor Set to ( )**
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M86.png)

Assign different colors to different motors

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M87.png)

#### Dual Motors at ( ) ( ) Speed Rotate ( ) Seconds
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M88.png)

Control each motor in the dual motor setup to rotate at the specified speed for a given time.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M89.png)

#### Dual Motors at ( ) ( ) Speed Rotate ( ) Degrees
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M90.png)

Control Each Motor in Dual Motor Setup to Rotate at a Specified Speed for a Given Angle

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M91.png)

#### Dual Motors at ( ) ( ) Speed Rotate
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M92.png)

Control Each Motor in Dual Motor Setup to Rotate Continuously at Given Speed

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M93.png)

#### Motor at ( ) Speed Rotate ( ) Degrees
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M94.png)

Control different colored motors to rotate at a given speed and a specified angle.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M95.png)

#### ( ) Motor at ( ) Speed Rotate ( ) Seconds
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M96.png)

Control different colored motors to rotate at a given speed for a specified time.  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M97.png)

#### ( ) Motor at ( ) Speed Go to ( ) Position
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M98.png)

Control the specified motor to rotate at a given speed to a specified position.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M99.png)

#### ( ) Motor at ( ) Speed Rotate
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M100.png)

Control the motor of a specified color to rotate at a specified speed.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M101.png)

### Light & Sound
#### LED（ ）Switch to ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M102.png)

Control LED to toggle between on/off states.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M103.png)

#### Light Ring ( ) Set Brightness ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M104.png)

Set the brightness of the specified light ring.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M105.png)

#### Light Ring ( ) Display Color ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M106.png)

Set the specified light ring to display a color.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M107.png)

#### Initialize OLED
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M108.png)

Used to initialize the OLED module.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M109.png)

#### Display Text ( ) at X ( ) Y ( ) with Color Mode ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M110.png)

Set the text content, display position, and display mode.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M111.png)

#### Clear OLED
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M112.png)

Clear the OLED display.  

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M113.png)

#### Laser ( ) Switch to ( )
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M114.png)

Control the laser module to switch between on and off states

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M115.png)

#### Recording Module-Play（ ）
<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M116.png)

Control the Recording Module to Play a Specified Sound.

Example:

<!-- 这是一张图片，ocr 内容为： -->
![](IMG/M117.png)