Mpython conn

来自Labplus盛思维基百科
跳转至: 导航搜索

概述

  掌控板上可以运行 microPython 程序,尽管 microPython 有着和 Python 3.x 一样的语法,但在 microPython 中无法使用原生 Python 强大的第三方资源支持。mpython_conn 是一个用于在 Python 3.x 中控制掌控板的连接库,上位机运行 Python 程序,而掌控板作为下位机完成输入输出任务。目前 mpython_conn 只支持通过 USB 线的方式连接掌控板,今后可能会推出基于 WiFi 的无线控制方式。

安装与准备

安装mpython_conn库

  Linux / Mac OS:

   sudo pip3 install mpython_conn

  Windows: 管理员身份运行 cmd,输入

   pip3 install mpython_conn

连接准备

  将掌控板通过 USB 线连接到 PC 或者嵌入式系统的 USB 口上。

导入包并建立连接对象

导入包:

   from mpython_conn import controller

建立连接:

   m = controller()

Python会自动从当前的串口设备中发现掌控板,如果连接了多个掌控板,也可以通过port参数手动指定串口,如:

   m = controller(port='COM11')

PIN口基本输入输出

设置PIN口数字输出值

   m.set_digital(pin, value)

其中pin参数为引脚号,可用的引脚包括:0, 1, 8, 9, 13, 14, 15, 16

value参数为数字值,接受0或者1

设置PIN口PWM模拟输出值

   m.set_analog(pin, value)

其中pin参数为引脚号,可用的引脚包括:0, 1, 8, 9, 13, 14, 15, 16

value参数为模拟值,范围为0~1023

获取PIN口数字值

   digital_value = m.get_digital(pin)

其中pin参数为引脚号,可用的引脚包括:0, 1, 2, 8, 9, 13, 14, 15, 16

返回值包括:0(低电平)或1(高电平)

获取PIN口模拟值

   analog_value = m.get_analog(pin)

其中pin参数为引脚号,可用的引脚包括:0, 1, 2

返回值范围:0~4095

舵机与电机控制

设置舵机角度

   m.set_servo(pin, value)

其中pin参数为连接舵机的引脚号,可用的引脚包括:0, 1, 8, 9, 13, 14, 15, 16

value参数为舵机角度,范围从0~180

驱动掌控宝马达M1、M2

   m.set_motor_power(motor_id, power)

参数motor_id为马达序号,取值包括1或者2,分别表示M1/M2

power参数为马达功率,取值范围为-100~100,大于0正转,小于0反转,0停止

马达停止

   m.set_motor_stop(motor_id)

参数motor_id为马达序号,取值包括1或者2,分别表示M1/M2

板载LED彩灯控制

设置彩灯颜色

   m.set_rgb(r, g, b, index)

参数r、g、b分别为红色、绿色、蓝色分量,取值范围为0~255

参数index指定哪一盏灯,从左到右分别为0、1、2,如果index=-1或缺省,则表示对全部三盏灯生效。

关闭彩灯

   m.set_rgb_off(index)

参数index指定关闭哪一盏灯,从左到右分别为0、1、2,如果index=-1或缺省,则表示关闭全部三盏灯。

OLED显示控制

在指定行显示文本

   m.oled_display_line(text, line)

参数text为需要显示的字符串,可以包括中英文,遇中文标点符号会转换为英文标点符号。

line参数为显示的行号,包括1、2、3、4

在指定位置显示文本

   m.oled_display_text(text, x, y)

参数text为需要显示的字符串,可以包括中英文,遇中文标点符号会转换为英文标点符号。

参数x、y为OLED屏幕坐标,坐标原点为左上角,右为x正方向,下为右、正方向。x取值范围为0~127,y取值为0~63

清除OLED屏所有显示信息

   m.oled_clear()

清除OLED屏指定行的显示信息

   m.oled_clear_line(line)

line参数为显示的行号,包括1、2、3、4

在OLED屏指定位置绘制或擦除点

   m.oled_draw_point(x, y, mode)

参数x、y为OLED屏幕坐标,坐标原点为左上角,右为x正方向,下为右、正方向。x取值范围为0~127,y取值为0~63

参数mode默认值是1,即绘制。如果要擦除,则需要指定mode=0

在OLED屏绘制或擦除连接线

   m.oled_draw_line(x1, y1, x2, y2, mode)

x1,y1与x2,y2分别表示连接线的起始坐标与结束坐标。

参数mode默认值是1,即绘制。如果要擦除,则需要指定mode=0

在OLED屏指定位置绘制或擦除指定长度的水平线或垂直线

   m.oled_draw_vhline(x, y, len, dir, mode)

参数x、y为起始点的屏幕坐标

len为线段长度,以像素为单位

dir参数默认值为'h',即水平线,如果dir='v'则表示绘制垂直线

参数mode默认值是1,即绘制。如果要擦除,则需要指定mode=0

在OLED屏中绘制或擦除矩形

   m.oled_draw_rectangle(x, y, w, h, fill, mode)

参数x、y为矩形的左上角的屏幕坐标

参数w、h分别为矩形的宽和高

fill默认为0,即表示不填充(空心),如果fill=1则表示填充(实心)

参数mode默认值是1,即绘制。如果要擦除,则需要指定mode=0

在OLED屏中绘制或擦除圆

   m.oled_draw_circle(x, y, r, fill, mode)

参数x、y为圆心的屏幕坐标

参数r为圆的半径

fill默认为0,即表示不填充(空心),如果fill=1则表示填充(实心)

参数mode默认值是1,即绘制。如果要擦除,则需要指定mode=0

在OLED屏中绘制或擦除三角形

   m.oled_draw_triangle(x1, y1, x2, y2, x3, y3, fill, mode)

x1,y1、x2,y2、x3,y3分别表示三角形的三个顶点坐标

fill默认为0,即表示不填充(空心),如果fill=1则表示填充(实心)

参数mode默认值是1,即绘制。如果要擦除,则需要指定mode=0

蜂鸣器发声

发出特定频率声音

   m.play_tone(pitch)

参数pitch表示发出声音的频率,一般频率取值范围为20~20000赫兹

播放单个音符

   m.play_tone(note)

参数note表示一个音符,比如"C3:1"

停止发出声音(静音)

   m.stop_music()

获取板载传感器值

获取三轴加速度值

   acc = m.get_acceleration(axis)

参数axis表示获取哪个方向上的加速度值,可取值为 'X'、'Y'、'Z'

加速度的返回值单位为重力加速度g,一般g值可以取9.8m/s^2

获取光线传感器值

   val = m.get_light()

返回值表示环境光线值的强弱

获取声音传感器值

   val = m.get_sound()

返回值表示环境声音的强弱

获取按键状态

获取按键A/B/P/Y/T/H/O/N状态

   status = m.get_button(button)

参数button指定哪个按键,可接受参数包括:'P', 'Y', 'T', 'H', 'O', 'N', 'A', 'B'

返回值为按键的状态,1表示按下,0表示释放

事件回调

  事件回调用于“当掌控板怎么样”的时候让程序处理什么事情,支持的事件包括:

   on_a_pressed()    # A 键按下事件
   on_a_released()   # A 键释放事件
   on_b_pressed()    # B 键按下事件
   on_b_released()   # B 键释放事件
   on_p_pressed()    # P 键按下事件
   on_p_released()   # P 键释放事件
   on_y_pressed()    # Y 键按下事件
   on_y_released()   # Y 键释放事件
   on_t_pressed()    # T 键按下事件
   on_t_released()   # T 键释放事件
   on_h_pressed()    # H 键按下事件
   on_h_released()   # H 键释放事件
   on_o_pressed()    # O 键按下事件
   on_o_released()   # O 键释放事件
   on_n_pressed()    # N 键按下事件
   on_n_released()   # N 键释放事件
   on_shaken()       # 掌控板摇晃事件
   on_jumped()       # 掌控板抛起事件
   on_tilt_forward() # 掌控板向前倾斜事件
   on_tilt_back()    # 掌控板向后倾斜事件
   on_tilt_left()    # 掌控板向左倾斜事件
   on_tilt_right()   # 掌控板向右倾斜事件
   on_tilt_none()    # 掌控板平放事件(默认不触发,只在其他倾斜事件发生后才触发)

事件回调示例:

   from mpython_conn import controller
   import time
   m = controller()
   def shake():
       m.oled_display_line('摇一摇', 1)
       m.set_rgb(255, 0, 0)
       time.sleep(1)
       m.set_rgb_off()
   m.on_shaken = shake		#事件绑定

  以上程序运行后,当掌控板摇晃时,会在OLED屏上显示“摇一摇”,并让所有的板载LED彩灯亮起1秒钟。

断开连接

   m.disconnect()