Skip to main content

blue:bit modules library for mPython(blue:bit掌控板驱动库)

Project description

blue:bit套装 掌控板驱动库


extboard



该repository提供bluebit套件的掌控板库.

blue:bit http://wiki.labplus.cn/index.php?title=Bluebit

库的安装方法

可通过以下任一方法进行安装。

  1. 将项目中的bluebit.py 拷到掌控板文件系统上
  2. 在掌控板REPL界面中,使用upip安装,步骤如下:
    • 前置条件需要掌控板连接网络
    • 导入upip模块,执行import upip
    • 执行`upip.install('mPython-bluebit')
>>> import upip
>>> upip.install('mPython-bluebit')

API 说明

模块 函数 功能说明 参数
LM35 LM35() 构建对象 /
LM35.getTemper(pin) 获取温度值,单位摄氏度 pin:引脚
四按键 joyButton() 构建对象
joyButton.getVal(pin) 获取按键值 pin:引脚
温湿度 SHT20(i2c=i2c) 构建对象 i2c:I2C实例
SHT20.temperature() 获取温度值,单位摄氏度 /
SHT20.humidity() 获取湿度值,单位% /
颜色 Color(i2c=i2c) 构建对象 i2c:I2C实例
Color.getRGB() 获取颜色的(r,g,b)3元组 /
Color.getHSV() 获取颜色的(h,s,v)3元组 /
数字光线 AmbientLight(i2c=i2c) 构建对象 i2c:I2C实例
AmbientLight.getLight() 获取光线值,单位lux /
超声波 Ultrasonic(i2c=i2c) 构建对象 i2c:I2C实例
Ultrasonic.distance() 获取测距,单位cm /
4段数码管 SEGdisplay(i2c=i2c) 构建对象 i2c:I2C实例
SEGdisplay.numbers(x) 显示数字,范围-999~9999 x:数字,-999~9999
SEGdisplay.Clear() 清除 /
点阵8x8 Matrix(i2c=i2c) 构建对象 i2c:I2C实例
Matrix.blink_rate(rate=None) 设置闪烁 rate:闪烁频率,模式不闪烁,单位秒
Matrix.brightness(brightness) 设置亮度级 brightness:0~15
Matrix.fill(color) 全部填充 color:1为点亮,0为熄灭
Matrix.bitmap(bitmap) bitmap图案 bitmap:8x8的数组
Matrix.pixel(x,y,c) 显示像素 x,y:坐标: c:颜色,1为亮,0,为灭
Matrix.text(s,x,y,c) 显示英文字符 s:字符;x,y:坐标; c:颜色,1为亮,0,为灭;
Matrix.show() 显示生效,注意修改缓存后,都是使用show()才能生效
LCD1602 LCD1602(i2c=i2c) 构建对象 i2c:I2C实例
LCD1602.Print(str) 显示英文字符串 str:文本
LCD1602.Clear() 清屏 /
LCD1602.setCursor(col, row) 设置光标位置 col:列;row:行
LCD1602.Cursor(show) 光标使能 show:1为显示,0为不显示
LCD1602.Blink(blink) 闪烁使能 blink:1为闪烁,0为不闪烁
LCD1602.display(enable) 显示使能 enable:1为显示,0为不显示
LCD1602.move_left() 左滚动一列 /
LCD1602.move_right() 右滚动一列 /
LCD1602.text_direction 文本方向 LCD1602.text_direction=LEFT_TO_RIGHT or RIGHT_TO_LEFT
LCD1602.createChar(location, charmap) 自定义字符 http://www.quinapalus.com/hd44780udg.html
LCD1602.Home() 光标返回屏幕原点
电子琴 MIDI(tx) 构建对象 tx:UART,tx引脚
MIDI.volume 设置音量或返回音量 范围0~127
MIDI.instrument 设置音色或返回音色 /
MIDI.note(note, on_off) 播放音符 note:音符;on_off:使能;
端口扩展 extIO(i2c=i2c) 构建对象 i2c:I2C实例
extIO.IOInit(pin, mode) 引脚初始化 pin:引脚0~7 ;mode:extIO.OUTPUT、extIO.INPUT
extIO.readIO(pin) 读引脚 pin:引脚0~7
extIO.writeIO(pin) 写引脚 pin:引脚0~7
MP3 MP3(tx) 构建对象 tx:UART,tx引脚
MP3.play_song(num) 播放指定歌曲 num:编号
MP3.play() 播放 /
MP3.playNext() 播放下首 /
MP3.playPrev() 播放上首 /
MP3.pause() 暂停 /
MP3.stop() 停止 /
MP3.volumeInc() 增加音量 /
MP3.volume 设置音量或者返回音量 /
MP3.loop(songNo) 指定序号歌曲循环播放 /
MP3.resetDevice() 重启MP3 /
OLED bluebit_OLED(rx,tx) 构建对象 rx,tx:UART,rx、tx引脚
bluebit_OLED.print(str,x,y,font=font_song16) 显示字符串 str:字符串;x,y:坐标;
font:font_5x7、font_song16、font_song24、font_consol32
bluebit_OLED.clear(x0=0,y0=0,x1=127,y1=63) 清除,默认全屏清除 x0,y0:起点坐标;x1,y1:终点坐标;
bluebit_OLED.show() 显示生效
bluebit_OLED.Bitmap( x, y, bitmap, w, h,c) 显示图案 x, y:坐标 ;bitmap:图案bitmap数组 ;
w, h:图案宽高 ;c:颜色0/1 ;
红外接收 IRRecv(rx) 构建对象 rx:UART,rx引脚
IRRecv.recv() 红外接收 返回一字节16进制数据
红外发送 IRTrans(tx) 构建对象 tx:UART,tx引脚
IRRecv.transmit(data) 发送 data:发送一字节数据

执照

所有代码均在MIT许可下发布。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mPython-bluebit, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size mPython-bluebit-0.1.1.tar.gz (9.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page