Xtron Python 指南¶
开始编程前，首先需要导入必要的库：
from microbit import *
from ovobot import *
以下是使用python给Xtron三合一掌机编程的快速参考，如果你是第一次给Xtron掌机编程请先阅读接下来的部分：
灯光¶
-
pyb.ledx.action()¶ Xtron板载上有2个LED灯，分别为led1、led2，可以分别控制两个灯的点亮和熄灭 这两个LED灯还用来作为状态的指示灯，比如充电时led1亮红灯，下载代码时led1闪红灯，开机时led2亮蓝灯后熄灭。
- 参数
ledx (int) – x可以为1或2，分别用来选择控制led1或者led2点亮和熄灭。
action (int) – off：熄灭，on：点亮。
例子：
import pyb
import time
pyb.led_1.on()
time.sleep(0.5)
pyb.led_1.off()
time.sleep(0.5)
pyb.led_2.on()
解析：当xtron启动时，点亮板载上的led1灯，等待0.5秒后，熄灭板载上的led1灯，再等待0.5秒后，点亮板载上的led2灯。
-
pyb.ledx.toggle()¶ 电平反转就是数字电路的某个端口（输入或者输出）的状态从一个状态转换到另一个状态，如从“1”变化到“0”, 数字电路的状态转换时间非常短，理想认为转换时间为0，这个变化过程就叫电平转换。 即Xtron的led灯从点亮变为熄灭，或者从熄灭变为点亮。 板载上有两个led灯，分别为led1、led2，可以分别控制两个led灯进行电平反转。
- 参数
ledx (int) – x可以为1或2，分别用来选择控制led1或者led2电平反转。
例子：
import pyb
import time
pyb.led_1.on()
time.sleep(2)
pyb.led_1.toggle()
解析：当xtron启动时，点亮板载上的led1灯，等待2秒后，熄灭板载上的led1灯电平反转，即Xtron的led1灯从点亮变为熄灭。
-
pyb.ledx.intensity(value)¶ 设置Xtron板载的led灯的亮度，数值范围为0~255。 在点亮LED之后再设置亮度才生效，而且只调节前面程序里已经点亮的LED灯的亮度值。
- 参数
ledx (int) – x可以为1或2，分别用来选择控制led1或者led2的亮度。
value (int) – 设置板载上对应led的亮度，数值范围为0~255，数值越大，对应的光亮度越高。
例子：
from button import Button
import pyb
def xtron_button_a_pressed(pin):
pyb.led_2.on()
pyb.led_2.intensity(255)
button_a = Button('A',callback=xtron_button_a_pressed)
解析：当xtron的A键被按下时，点亮板载上的led2灯，并且调节灯光亮度至255，led的亮度，数值范围为0~255。
-
setrgbhexcolor(rgbledIndex, color)¶ Xtron上有4个RGB彩灯，可以分别设置不同的颜色，通过颜色、饱和度、亮度来调节颜色，数值范围均为0~100。 点击颜色下方的【滴管图标】还可以从已有的角色中一键获取角色上的任意颜色。
- 参数
rgbledIndex (int) – 选择控制板载上彩色灯，从左往右依次为1-2-3-4。
color (int) – 设置颜色值，例如”#ff0000”代表红色，”#000000”代表黑色.
例子：
import pyb
from neopixel import *
setrgbhexcolor(1,'#1dc83a')
setrgbhexcolor(2,'#000000')
setrgbhexcolor(3,'#ff0000')
setrgbhexcolor(4,'#ffffff')
解析：Xtron上有4个RGB彩灯，可以分别设置不同的颜色。 当xtron启动时，板载上的RGB灯被点亮，颜色分别为绿色、黑色、红色、白色。
-
setAllcolor(color)¶ Xtron上有4个RGB彩灯，可以分别设置不同的颜色，通过颜色、饱和度、亮度来调节颜色，数值范围均为0~100。 同样的，还可以从选择的角色中一键吸取已有的颜色。 和上面的程序块的区别是，上面的是单独设置某一个RGB灯，这个程序块则是同时设置所有的RGB灯。
- 参数
color (int) – 选择控制板载上所有led彩灯的颜色。
例子：
import pyb
from neopixel import *
import time
setrgbhexcolor(1,'#1dc83a')
setrgbhexcolor(2,'#000000')
setrgbhexcolor(3,'#ff0000')
setrgbhexcolor(4,'#ffffff')
time.sleep(3)
setAllcolor('#e244d1')
解析：Xtron上有4个RGB彩灯，可以分别设置不同的颜色。当xtron启动时，板载上的RGB彩灯被点亮， 颜色分别为绿色、黑色、红色、白色。等待3秒后，板载上的4个RGB彩灯颜色全部变为紫色。
-
setbrightness(value)¶ 用来设置Xtron板载的RGB灯的亮度。 设置亮度值之后，再设置RGB灯的颜色，亮度值才生效。 如果你想改变亮度值的话，你需要设置亮度值之后，再次设置一下对应的RGB灯颜色。
- 参数
value (int) – 设置Xtron板载的RGB彩灯的亮度。
例子：
import pyb
from neopixel import *
setbrightness(0.5)
setrgbhexcolor(1,'#1dc83a')
setrgbhexcolor(2,'#000000')
setrgbhexcolor(3,'#ff0000')
setrgbhexcolor(4,'#ffffff')
解析：设置Xtron板载的RGB彩灯的亮度，只有先设置好亮度值，再设置RGB彩灯的颜色，亮度值才生效。 当xtron启动时，板载上的RGB彩灯被点亮，颜色分别为绿色、黑色、红色、白色。
-
colour_rgb(red, green, blue)¶ 颜色值动态设置，分别设置red红色、green绿色、blue蓝色的数值，数值范围为0~255。
- 参数
red green blue (int) – 设置板载上对应RGB彩灯的数值，数值范围为0~255。
显示¶
-
lcd.clearScreen()¶ 用来清空LCD屏幕上之前显示的所有内容。在同一个位置显示不同的内容，如果不清空，会和之后显示的内容重叠。
例子：
import pyb
import lcd
import time
lcd.drawText(2,2,'Hello',2)
time.sleep(0.5)
lcd.clearScreen()
lcd.drawText(2,2,'Friend',2)
time.sleep(0.5)
lcd.clearScreen()
解析：当xtron启动时，在坐标轴（x=2，y=2）处，显示文本内容：”Hello”，颜色为红色。 等待0.5秒后，清空这个文本，然后在相同位置显示下一文本内容：”Friend”，颜色同样为红色。再等待0.5秒后，清空这个文本。
-
lcd.setBgColor(colorIndex)¶ 该积木块可以设置屏幕的背景色，一共有16个颜色可以选择，其中第一个颜色是透明色。
- 参数
colorIndex (int) – 设置屏幕的背景色，一共有16个颜色可以选择，其中第一个颜色是透明色。。
-
lcd.show()¶ 在设置好屏幕背景以及屏幕显示内容后，加上显示生效积木块，屏幕上才会显示我们设置好的背景及内容。
-
lcd.drawText(x, y, string, colorIndex)¶ 把文本内容显示在某个坐标（x，y）处。 文本内容可以是字母、数字，暂时不支持中文显示。 坐标的范围是X：0~160， Y: 0~128 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x y (int) – 通过x轴和y轴的距离，将文本显示在特定的坐标（x，y）上，坐标的范围是X：0~160， Y: 0~128。
string (int) – 文本内容可以是字母、数字，暂时不支持中文显示。
colorIndex (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.drawHline(x, y, len, color)¶ 绘制线一条水平的线段，在某个坐标（x，y）绘制一条水平的线段，线的长度≤显示屏的长度。 坐标的范围是X：0~160， Y: 0~128，线段长度+ X的坐标<160，否则线段显示不完整。 所有绘制的图案，都要加上显示生效积木块，才会在屏幕上显示出来。 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x y (int) – 在某个坐标（x，y）绘制一条水平的线段，坐标的范围是X：0~160， Y: 0~128。
len (int) – 线的长度≤显示屏的长度。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.drawVline(x, y, len, color)¶ 绘制线一条垂直的线段，在某个坐标（x，y）绘制一条垂直的线段，线的长度≤显示屏的长度。 坐标的范围是X：0~160， Y: 0~128，线段长度+ Y的坐标<128，否则线段显示不完整。 所有绘制的图案，都要加上显示生效积木块，才会在屏幕上显示出来。 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x y (int) – 在某个坐标（x，y）绘制一条垂直的线段，坐标的范围是X：0~160， Y: 0~128。
len (int) – 线的长度≤显示屏的长度。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.drawLine(x1, y1, x2, y2, color)¶ 绘制一条线段，绘制一条从一个坐标（x1，y1）到另一个坐标（x2，y2）的线段。 坐标的范围是X：0~160， Y: 0~128 和上一个积木块的区别是，这个积木块绘制的线段是任意的方向，上一个只能是水平或者垂直方向。 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x1 y1 x2 y2 (int) – 确定坐标1（x1，y1）和坐标2（x2，y2）的位置，坐标的范围是X：0~160， Y: 0~128。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.drawRect(x, y, width, height, color)¶ 绘制一个空心矩形，在某个坐标（x，y）处绘制一个矩形，通过设置矩形的宽和高来设置矩形的大小。 坐标的范围是X：0~160， Y: 0~128。 如果坐标值加上矩形大小，超过了显示范围，会显示不完整。 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x y (int) – 在某个坐标（x，y）处绘制一个空心矩形，坐标的范围是X：0~160， Y: 0~128，如果坐标值加上矩形大小，超过了显示范围，会显示不完整。
width (int) – 设置空心矩形的宽。
height (int) – 设置空心矩形的高。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.fillRect(x, y, width, height, color)¶ 绘制一个实心矩形，在某个坐标（x，y）处绘制一个实心矩形，通过设置矩形的宽和高来设置矩形的大小。 坐标的范围是X：0~160， Y: 0~128。 如果坐标值加上矩形大小，超过了显示范围，会显示不完整。 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x y (int) – 在某个坐标（x，y）处绘制一个实心矩形，坐标的范围是X：0~160， Y: 0~128，如果坐标值加上矩形大小，超过了显示范围，会显示不完整。
width (int) – 设置实心矩形的宽。
height (int) – 设置实心矩形的高。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.circle(x, y, radius, color)¶ 绘制一个空心圆形，在某个坐标（x，y）绘制一个空心圆形，通过设置圆的半径来改变圆的大小。 坐标的范围是X：0~160， Y: 0~128 如果坐标值加上圆形大小，超过了显示范围，会显示不完整。 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x y (int) – 在某个坐标（x，y）绘制一个空心圆形，通过设置圆的半径来改变圆的大小。坐标的范围是X：0~160， Y: 0~128。
radius (int) – 确定好空心圆的圆心（x，y）后，通过设置圆的半径来改变圆的大小。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.fill_circle(x, y, radius, color)¶ 绘制一个实心圆形，在某个坐标（x，y）绘制一个实心圆形，通过设置圆的半径来改变圆的大小。 坐标的范围是X：0~160， Y: 0~128 如果坐标值加上圆形大小，超过了显示范围，会显示不完整。 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x y (int) – 在某个坐标（x，y）绘制一个实心圆形，通过设置圆的半径来改变圆的大小。坐标的范围是X：0~160， Y: 0~128。
radius (int) – 确定好实心圆的圆心（x，y）后，通过设置圆的半径来改变圆的大小。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.triangle(x1, y1, x2, y2, x3, y3，color)¶ 绘制一个空心三角形，通过设置三个点的坐标（x1，y1）、（x2，y2）、（x3，y3）来绘制一个空心三角形。 设置三角形三个点的坐标，如果坐标值加上三角形大小，超过了显示范围，会显示不完整。 坐标的范围是X：0~160， Y: 0~128 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x1 y1 x2 y2 x3 y3 (int) – 通过设置三角形三个点的坐标（x1，y1）、（x2，y2）、（x3，y3）来绘制一个空心三角形。坐标的范围是X：0~160， Y: 0~128。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
lcd.fill_triangle(x1, y1, x2, y2, x3, y3，color)¶ 绘制一个实心三角形，通过设置三个点的坐标（x1，y1）、（x2，y2）、（x3，y3）来绘制一个实心三角形。 设置三角形三个点的坐标，如果坐标值加上三角形大小，超过了显示范围，会显示不完整。 坐标的范围是X：0~160， Y: 0~128 文本内容有16个颜色可选，其中第一个颜色是透明色。
- 参数
x1 y1 x2 y2 x3 y3 (int) – 通过设置三角形三个点的坐标（x1，y1）、（x2，y2）、（x3，y3）来绘制一个实心三角形。坐标的范围是X：0~160， Y: 0~128。
color (int) – 文本内容有16个颜色可选，其中第一个颜色是透明色。
-
(colour_rgb(value, value, value) 用来设置RGB的颜色，在设置屏幕颜色或者画笔颜色的时候，可以用指定的RGB的值来设置颜色。 红绿蓝三种颜色的数值范围分别为0~255。 比如红色有很多种：粉红（255,192,203），深红（220,20,60），淡紫红（255,240,245），弱紫罗兰红（219,112,147）， 深粉红（255,20,147）等，我们通过设置不同的RGB值就可以精确的显示不同的颜色。
- 参数
value (int) – 红绿蓝三种颜色的数值范围分别为0~255。
声音¶
-
music.pitch(频率，持续时间= -1，pin = microbit.pin0，wait = True)¶ 该积木块可以播放音符，音符以及节拍长度可以在下拉框里选择。 点击音符，显示的是中央C的音调，可以用左右两边的箭头来切换高低音，左边是低音，右边是高音。 详情请参考：https://microbit-micropython.readthedocs.io/en/latest/music.html
C调中，C、D、E、F、G、A、B分别对应简谱中的1、2、3、4、5、6、7，一个唱名为四分音符持续1个节拍，下方有一个横杠的是八分音符持续1/2节拍， 音符后有一个横杠的为二分音符持续2个节拍，同学们按照音符和节拍数编写整段音乐。
- 参数
note (int) – 默认选择播放的音符为0，即代表暂停播放。
beat (int) – 音符播放的节拍数，节拍数为500的倍数，倍数范围为1/16~4。
例子：
from microbit import *
import music
music.pitch(262 , 500 , pin=pin0 , wait=True)
music.pitch(330 , 1000 , pin=pin0 , wait=True)
解析：当绿旗被点击时，播放C音符持续一个节拍，然后播放E音符持续一个节拍。
-
music.stop(pin = microbit.pin0)¶ 在给定的引脚上停止所有音乐播放，例如：music.stop(pin1)。 如果没有给出引脚，例如：music.stop()假设为pin0。
- 参数
note (int) – 默认选择播放的音符为0，即代表暂停播放。
beat (int) – 音符播放的节拍数，节拍数为500的倍数，倍数范围为1/16~4。
-
music.stopPlay()¶ 停止播放所有声音。
事件¶
-
import pyb -
pass()¶ 当启动Xtron三合一掌机时，执行此模块下方的程序。
例子：
import pyb
import music
music.pitch(262 , 500 , pin=pin0 , wait=True)
解析：当启动Xtron三合一掌机时，播放C音符持续一个节拍。
-
from button import Button -
def xtron_button_x_pressed(pin): -
pass() -
button_x = Button('ID',callback=xtron_button_x_pressed) 选择xtron按键触发事件的回调函数。当对应Xtron的按钮被按下时，执行此模块下方的程序。
- 参数
x (int) – 按钮回调事件，返回按键事件实例，x包括”a”A键，”b”B键，”up”方向键上，”down”方向键下， “left”方向键左，”right”方向键右，”menue”菜单键。
ID (int) – 注册回调事件，ID为按钮唯一标识符，ID包括”a”A键，”b”B键，”up”方向键上，”down”方向键下， “left”方向键左，”right”方向键右，”menue”菜单键。
控制¶
-
import time -
time.sleep(n)¶ 等待n秒后执行其下方的程序，n可以是整数或浮点数。
- 参数
n (int) – 控制xtron执行的指令停止执行指定的时间（秒）。
-
for count in range(n): 重复执行其内部程序n次，n只能是整数。
- 参数
n (int) – 控制xtron重复执行其内部程序n次。
-
while True: 重复执行程序块内部包含的程序。
-
if False: 当下面的程序条件满足时，执行程序块内部的程序。
-
if False: -
pass() -
else: 当下面的程序条件满足时，执行那么内部的程序，不满足时执行否则内部的程序。
-
while not False: 等待直到条件为真时才继续执行接下来的程序。
-
while not False: 重复执行其内部的程序，直到下面的程序条件满足时，才执行程序下方的程序。