class device.OLED
device.OLED 类是device模块下面的一个硬件类，用于对OLED显示屏模块的配置和控制，并提供对OLED设备的操作方法。
常量
| 类型 |
常量名称 |
含义 |
| 颜色 |
OLED.BLUE |
蓝色显示 |
|
OLED.YELLOW |
黄色显示 |
| 屏幕状态 |
OLED.ON |
点亮屏幕 |
|
OLED.OFF |
熄灭屏幕 |
| 滚动方向 |
OLED.HORIZONTAL_R |
水平向右滚动 |
|
OLED.HORIZONTAL_L |
水平向左滚动 |
|
OLED.VERTICAL_D |
垂直向下滚动 |
|
OLED.VERTICAL_U |
垂直向上滚动 |
| 排列方式 |
OLED.VERTICAL_CROSS |
竖置横排 |
|
OLED.VERTICAL_VERTICAL |
竖置竖排 |
|
OLED.CROSS_VERTICAL |
横置竖排 |
|
OLED.CROSS_CROSS |
横置横排 |
| 字节位顺序 |
OLED.HIGH_FIRST |
一个字节的高位代表点阵左面/上面的点 |
|
OLED.LOW_FIRST |
一个字节的低位代表点阵左面/上面的点 |
构造函数
| 构造函数 |
class device.OLED() |
| 功能 |
构造一个OLED对象 |
| 参数说明 |
无 |
| 返回值 |
返回创建的OLED对象 |
| 其他说明 |
构造时会对OLED进行初始化，也可在init方法中进行初始化，该初始化应针对不同的硬件有不同的驱动进行对应设备的初始化动作。 |
实例方法
device.OLED类包括如下实例方法
| 方法名 |
说明 |
| OLED.init() |
初始化OLED对象 |
| OLED.deinit() |
关闭OLED对象 |
| OLED.light() |
点亮/熄灭屏幕 |
| OLED.contrast() |
获取/设置对比度 |
| OLED.fill() |
按指定颜色填充整个屏幕 |
| OLED.clear() |
清屏 |
| OLED.pixel() |
在指定位置填充指定颜色 |
| OLED.text() |
在指定起始位置按点阵进行描点 |
| OLED.invert() |
设置反转显示模式 |
| OLED. scroll() |
设置指定位置滚动显示 |
| OLED. scroll_stop() |
关闭滚动 |
| OLED.modelname() |
获取模块厂家及型号 |
详细说明如下：
| 方法名称 |
OLED.init() |
| 功能 |
初始化OLED模块 |
| 参数说明 |
无 |
| 返回值 |
固定返回None |
注：该初始化动作应包括总线初始化设置对OLED进行初始化配置
| 方法名称 |
OLED.deinit() |
| 功能 |
关闭OLED对象，并关闭OLED显示屏 |
| 参数说明 |
无参数 |
| 返回值 |
固定返回None |
注：关闭OLED对象后，需重新init才能正常使用OLED对象。
| 方法名称 |
OLED.light([mode]) |
| 功能 |
点亮/熄灭屏幕 |
| 参数说明 |
[mode]为可选参数，不传入时，返回当前OLED屏幕状态，传入参数时，根据参数控制OLED屏幕状态，可选参数见OLED常量屏幕状态部分相关常量 |
| 返回值 |
不传入参数时返回OLED屏幕状态，其他固定返回None |
| 方法名称 |
OLED.contrast([contrast]) |
| 功能 |
获取/设置对比度 |
| 参数说明 |
[contrast]为可选参数，若不传入该参数，则为获取当前OLED对比度，若传入参数，则为设置OLED对比度，可传入范围为0~255 |
| 返回值 |
若未传入参数，则返回当前对比度 若传入参数，则返回None |
| 方法名称 |
OLED.fill(color=OLED.BLUE) |
| 功能 |
按指定颜色填充整个屏幕 |
| 参数说明 |
color：可选参数为OLED常量color部分相关常量 对单色OLED，该方法只需实现单色填充即可 |
| 返回值 |
固定返回None |
| 方法名称 |
OLED.clear([x,y,w,h]) |
| 功能 |
按指定范围清屏 |
| 参数说明 |
若不传入参数，清除整个屏幕 若传入参数，按起始坐标(x,y)指定的高度和宽度的矩形范围清屏 |
| 返回值 |
固定返回None |
| 方法名称 |
OLED.pixel(x, y,w=1,h=1,col=OLED.BLUE) |
| 功能 |
在指定位置填充指定颜色 |
| 参数说明 |
x：位置像素横坐标，可选范围0~127； y：位置像素纵坐标，可选范围0~63； w：填充宽度，默认一个像素； h：填充高度，默认一个像素； col：可选参数为OLED常量color部分相关常量 |
| 返回值 |
固定返回None |
| 方法名称 |
OLED.text(bytes, x, y, col=OLED.BLUE w=8, arrmode= OLED.VERTICAL_CROSS, sequence= OLED.LOW_FIRST ) |
| 功能 |
在指定起始位置按点阵进行描点 |
| 参数说明 |
bytes：像素点阵的字节串； x：位置起始像素横坐标，可选范围0~127； y：位置起始像素纵坐标，可选范围0~63； col：可选参数为OLED常量color部分相关常量； w：点阵数据的宽度； arrmode：点阵的排列方式； sequence：点阵的字节位顺序； |
| 返回值 |
固定返回None |
注：传入的bytes为欲显示字符串转化后的像素点阵的字节串，该点阵可通过字库模块获取。
| 方法名称 |
OLED. invert(invert) |
| 功能 |
设置反转显示模式 |
| 参数说明 |
Invert：设置是否翻转显示，即暗点变亮点，亮点变暗点。False为关闭反转，True为开启反转 |
| 返回值 |
固定返回None |
| 方法名称 |
OLED.scroll(x, y, w, h, direction, speed[,circle=False]) |
| 功能 |
在指定位置滚动显示 |
| 参数说明 |
x，y：为滚动区域起始坐标 w，h：滚动区域高度和宽度 direction：设置滚动方向，可选OLED常量中滚动方向部分相关常量。 speed：设置滚动速度，单位：帧/像素 [circle]：设置是否循环滚动 |
| 返回值 |
固定返回None |
| 方法名称 |
OLED.scroll_stop() |
| 功能 |
关闭滚动 |
| 参数说明 |
无 |
| 返回值 |
固定返回None |
| 方法名称 |
OLED.modelname() |
| 功能 |
获取模块厂家及型号 |
| 参数说明 |
无 |
| 返回值 |
返回模块厂家名称及型号 |
