OLED1306 显示器

OLED1306 显示器积木属于 micro:bit 的扩展模组，可以控制 OLED 显示单色的英文字和数字，弥补 micro:bit 的 5x5 LED 无法显示较多英文和数字的限制，OLED1306 分辨率为 128 x 64，也可绘制一些简单的几何造型，做出有趣的应用。

OLED1306 显示器积木有几个分类：初始化 OLED、显示数字、显示文字、绘制四边形、绘制垂直 / 水平直线、绘制像素、反转颜色、清除画面、关闭 / 打开屏幕、缩放画面。

micro:bit 连接 OLED1306 显示器

按照下图，使用“扩充板、杜邦线、面包板”，将 micro:bit 连接 OLED1306 显示器。

OLED1306 为单色显示器，如果是标榜“双色”，表示显示器的上方为黄色，下方为蓝色，并非可以同一个位置显示两种不同颜色。

加入 OLED1306 显示器积木

打开 MakeCode 的扩展功能，搜索“oled”，从搜索结果中选择“OLED12864_I2C”的项目，点选加入 OLED1306 显示器积木。

推荐 OLED12864_I2C 这个项目，因为它的功能较为完整好用。

加入后，在积木清单里就会出现“OLED12864_I2C”的选项。

初始化 OLED ( init OLED )

OLED1306 是 I2C 的装置，I2C 装置都有一个位址 ( Address )，可以让 micro:bit 进行识别和通讯，在使用 OLED1306 之前，必须要设定位址，这组积木可使用的位址有 60 和 61，默认直接用 60 就能初始化并进行控制。

通常初始化只需要设定一次，因此这个积木会直接放在“当启动时”积木里。

显示数字 ( show a number )

“显示数字”积木可以让 OLED 在指定的座标显示数字，可修改 xy 座标、显示的数字 number 和数字颜色，若数字长度超过一行的显示范围，会自动折行到第二行。

• “显示数字”的座标并非真正的“座标”，而是字元大小，座标的范围取决于画面是否缩放。

  • 放大模式 ( zoom: true )：x 范围 0～63，y 范围 0～31。
  • 正常模式 ( zoom: false )：x 范围 0～127，y 范围 0～63。

• 数字颜色只能填入 1 和 0，1 为白色 ( 或蓝色 )，0 为黑色 ( 背景白色或蓝色 )。

因为 OLED 显示数字是采用“覆盖”的做法，以下图的例子，如果要按下 A 或 B 按钮切换数字，可先放入“清除画面”积木，避免数字互相重叠。

显示文字 ( show a string )

“显示文字”积木可以指定 LCD 显示器的显示座标，显示对应的文字，可修改 xy 座标、显示的文字 string 和文字颜色，若文字长度超过一行的显示范围，会自动折行到第二行。

• “显示文字”的座标并非真正的“座标”，而是字元大小，座标的范围取决于画面是否缩放。

  • 放大模式 ( zoom: true )：x 范围 0～11，y 范围 0～3。
  • 正常模式 ( zoom: false )：x 范围 0～23，y 范围 0～7。

• 文字颜色只能填入 1 和 0，1 为白色 ( 或蓝色 )，0 为黑色 ( 背景白色或蓝色 )。

因为 OLED 显示文字是采用“覆盖”的做法，以下图的例子，如果要按下 A 或 B 按钮切换文字，可先放入“清除画面”积木，避免文字互相重叠。

绘制四边形 ( draw a rectangle )

“绘制四边形”积木可以指定“左上”( x1,y1 ) 与“右下”(x2,y2) 的座标，绘制一个“空心”的四边形。

下图的例子，按下 A 按钮时，OLED 就会画出四个逐渐往右下移动的四边形。

• 注意，OLED 默认采用 zoom:true ( 放大 ) 模式，所以数值会乘以 2 显示。
• 注意，OLED 绘图的 x 与 y 必须是“正整数”。

绘制垂直 / 水平直线 ( draw a line )

“绘制垂直 / 水平直线”积木可以指定线段的“起点”和“长度”，绘制垂直或水平的直线。

下图的例子，micro:bit 启动后，OLED 会由中心点画出十字形状 ( 上到下一直线、左到右一直线 )。

• 注意，OLED 默认采用 zoom:true ( 放大 ) 模式，所以数值会乘以 2 显示。
• 注意，OLED 绘图的 x 与 y 必须是“正整数”。

绘制像素 ( draw pixel )

“绘制像素”积木可以让 OLED 在指定的座标绘制“单一像素”( 一个点 )，是相当方便好用的积木。

下图的例子，micro:bit 启动后，OLED 会画出一个 X 的形状 ( 左上到右下一直线、右上到左下一直线 )。

• 注意，OLED 默认采用 zoom:true ( 放大 ) 模式，所以数值会乘以 2 显示。
• 注意，OLED 绘图的 x 与 y 必须是“正整数”。

反转颜色 ( invert display )

“反转颜色”积木若设定 true，会将 OLED 的白色 ( 或蓝色 ) 变成黑色，黑色变成白色，默认 false。

清除画面 ( clear )

“清除画面”积木可以将 OLED 的画面内容清空。

关闭 / 打开屏幕 ( turn on / off )

“关闭 / 打开屏幕”积木可以关闭或打开 OLED，和清除画面不同，关闭 OLED 时，内容仍然存在，打开 OLED 之后又可以看见内容。

缩放画面 ( zoom )

“缩放画面”积木可以针对 OLED 分辨率进行缩放，默认使用 true。

• true：放大模式，分辨率从 128x64 变成 64x32。
• false：正常模式，分辨率 128x64。

下图的例子，micro:bit 启动后，OLED 会显示 hello 文字，按下 A 或 B 按钮可以进行缩放。

意见反馈