nanoFramework.Iot.Device.Ssd13xx 1.3.384

SSD13xx/SSD1306/SSD1327 & SSH1106 - OLED 显示器系列

SSD1306/SSH1106 是一款单芯片 CMOS OLED/PLED 驱动器，具有有机/聚合物发光二极管点阵图形显示系统的控制器。它由 128 段和 64 个公共端组成。此 IC 专为共阴极 OLED 面板设计。

文档

• IoT NanoFramework SSD1306/SSH1106 驱动器
• SSD1306 数据表
• SSD1327 数据表

相关设备

• Adafruit PiOLED - Raspberry Pi 的 128x32 单色 OLED 添加板
• HiLetgo 1.3" SPI 128x64 SSH1106 OLED LCD 显示屏 LCD
• SunFounder 0.96" 英寸蓝色 I2C IIC 串行 128x64 OLED LCD LED SSD1306 模块
• Diymall 0.96" 英寸蓝色和黄色 I2c IIC 串行 Oled LCD LED 模块 12864 128X64 for Arduino 显示 Raspberry PI 51 Msp420 Stim32 SCR

板

在 I2C 总线上的地址：Ssd1306.DefaultI2cAddress 0x3C

具有 7 引脚 I2C/SPI 的版本

在 I2C 总线上的地址：Ssd1306.SecondaryI2cAddress 0x3D

连接电阻

• I2C — R1, R4, R8;
• SPI — R3, R4.

仅 I2C

连接表

绑定说明

当前此绑定仅支持命令和原始数据。最终，计划创建一个图形库，可以将文本和图像发送到设备。因此，此库只是个起点，您将在示例中找到更多高级命令。

此绑定支持以下连接类型。

• I2C
• SPI

使用说明

有两种绘图方法。

1. 各种专用绘图方法，可逐像素绘图，如下

   • DrawPixel(...)：绘制一个像素
   • DrawHorizontalLine(...)：绘制水平线
   • DrawVerticalLine(...)：绘制垂直线
   • DrawFilledRectangle(...)：绘制填充矩形
   • DrawBitmap(...)：绘制位图
   • DrawString(...)：使用预设字体绘制字符串

   使用这些方法，您无需关心驱动程序显示您的绘图指令所使用的技术。

2. 允许通过内部表示块的块（屏幕缓冲区）修改屏幕内容的方法

   • DrawDirectAligned(...)：使用给定的内容覆盖屏幕缓冲区
   • ClearDirectAligned(...)：清除（使用0x00）屏幕缓冲区的给定部分

   这些方法允许快速（大约100倍）显示访问，但有一些限制。

   • 此处传递的位图必须采用适当的格式（请参阅SSD13xx文档中的“GDDRAM”和“水平寻址模式”）。
   • 不执行对现有缓冲区数据（通过其他方式绘制的像素）的位操作，新数据将覆盖新绘制内容下面的像素。
   • “y”坐标和位图高度必须与屏幕缓冲区字节对齐（请参阅上述文档）。

两组的使用可以自由混合（例如，通过DrawString(...)显示文本，以下通过DrawDirectAligned(...)显示图像）

1.的示例可以在samples文件夹中找到。

2.的示例如下。

// There are superb online helpers like the one below which are able to
// create an appropriate byte array from an image in code use ready format.
// https://www.mischianti.org/images-to-byte-array-online-converter-cpp-arduino/
// On the site above use these settings to get bytes needed here:
// - "plain bytes"
// - "vertical - 1 bit per pixel"
var buffer = new byte[] { ... }; 
var width = 16;
var height = 16;

// instantiation example
var ssd1306 = new Ssd1306(
    I2cDevice.Create(
        new I2cConnectionSettings(
            1, 
            Ssd1306.DefaultI2cAddress, 
            I2cBusSpeed.FastMode)), 
    Ssd13xx.DisplayResolution.OLED128x64);

// this line sends the image data to the screen
ssd1306.DrawDirectAligned(x, y, width, height, buffer);

// this one wipes its place to blank
ssd1306.ClearDirectAligned(x, y, width, height);

要显示双字节字体（例如亚洲语言的字体），必须将字体设置为DoubleByteFont()，如下所示

device.Font = new DoubleByteFont();
device.DrawString(2, 2, "功夫＄", 2, false);
device.DrawString(2, 34, "８９ＡＢ功夫＄", 1, true);
device.Display();

显示输出的以下内容

字体

可以使用IFont实现来使用字体。

提供有示例字体，既在样本目录中，也在附加字体中。还提供了一个名为Bitmap2Font的工具，它可以帮助自动生成Font类。简而言之，它可以从任何给定固定大小的黑白字体图像生成Font类。更多信息在这里。

IotByteFont: .NET点阵字体创建工具

IotByteFont是一个.NET点阵字体创建工具。它可以加载您喜欢的字体文件，并生成自定义点阵字体代码。

安装

您可以使用以下命令安装IotByteFont工具

dotnet tool install -g IotByteFont

使用方法

以下是IotByteFont工具的命令行选项

示例

创建字体时，需要指定字体文件或字体名称、字体中包含的字符以及字体大小。您还可以指定字体的宽度、y偏移量和输出类的名称。打开调试模式可以打印调试信息和最终的字体位图。

IotByteFont --char "abcde功夫＄" --size 8
IotByteFont --font ms.ttf --char chars.txt --yoffset 0.6 --name MyFont --debug