SSD1306指令集

2024-03-19 11:14:40

一、基本命令

1.页地址模式下设置列起始地址低位(Set Lower Column Start Address For Page Addressing Mode)(00h~0Fh)

此指令用于在页地址模式下设置GDDRAM的列起始地址(8位)的低4位, 页地址会在数据访问后递增

 

2.页地址模式下设置列起始地址高位(Set Higher Column Start Address For Page Addressing Mode)(10h~1Fh)

此指令用于在页地址模式下设置GDDRAM的列起始地址(8位)的高4位, 页地址会在数据访问后递增

 

3.设置内存地址模式(Set Memory Addressing Mode)(20h)

在SSD1306中有三种地址模式: 页地址模式, 水平地址模式和垂直地址模式, 此命令用于将地址模式设置为以上三种之一

 

  • 页地址模式(A[1:0]=10b)

当处于此模式时, 在GDDRAM访问后(读/写), 列地址指针将自动增加1。如果列地址指针到达列终止地址, 列地址指针将复位到列起始地址, 但页地址指针不会改变。

 

为了访问GDDRAM中下一页的内容, 用户必须设置新的页地址和列地址。页地址模式下页以及列地址指针的行为如下图所示 ：

SSD1306指令集

通常在页地址模式下访问GDDRAM, 需要如下步骤来定义起始RAM访问指针指向:

    1. 通过命令(B0h-B7h)设置目标显示位置页起始地址
    2. 通过命令(00h-0Fh)设置列起始地址低位
    3. 通过命令(10h-1Fh)设置列起始地址高位

 

例如, 如果页地址是B2h, 列地址低位是03h, 列地址高位是10h, 起始列将为PAGE2的SEG3, GDDRAM访问指针的指向如下图所示:

SSD1306指令集

 

  • 水平地址模式(A[1:0]=00b)

当处于此模式时, 在GDDRAM访问后(读/写), 列地址指针将自动增加1。如果列地址指针到达列终止地址, 列地址指针将复位到列起始地址, 且页地址指针将自动增加1。

 

水平地址模式下页以及列地址指针的行为如下图所示, 如果列地址指针和页地址指针都到达各自的终止地址时, 他们都将复位到各自的起始地址。(图中虚线)

SSD1306指令集

  • 垂直地址模式(A[1:0]=01b)

当处于此模式时, 在GDDRAM访问后(读/写), 页地址指针将自动增加1。如果页地址指针到达页终止地址, 页地址指针将复位到页起始地址, 且列地址指针将自动增加1。

 

垂直地址模式下页以及列地址指针的行为如下图所示, 如果列地址指针和页地址指针都到达各自的终止地址时, 他们都将复位到各自的起始地址。(图中虚线)

SSD1306指令集

通常在(垂直/水平)地址模式下访问GDDRAM, 需要如下步骤来定义起始RAM访问指针指向:

    • 通过命令(21h)设置目标显示位置列起始地址以及列终止地址
    • 通过命令(22h)设置目标显示位置页起始地址以及页终止地址

 

4.设置列地址(Set Column Address)(21h)

此指令用于设置GDDRAM的列起始地址和列结束地址, 并使列地址指针(指向GDDRAM中当前访问的列地址)指向列起始地址。

若内存地址模式为水平地址模式, 在访问一列数据后, 列地址指针将增加到下一个列地址。当结束访问终止列地址时, 列地址指针将复位至列起始地址, 且行地址指针将增加到下一行。

 

5.设置页地址(Set Page Address)(22h)

此指令用于设置GDDRAM的页起始地址和页结束地址, 并使页地址指针(指向GDDRAM中当前访问的页地址)指向页起始地址。

若内存地址模式为垂直地址模式, 在访问一页数据后, 页地址指针将增加到下一个页地址。当结束访问终止页地址时, 页地址指针将复位至页起始地址。

 

下图展示了例子中列地址指针和页地址指针的移动方式: 列起始地址设为2, 列终止地址设为125, 页起始地址设为1, 页终止地址设为6, 并使用水平地址模式。

 

在此情况下, GDDRAM数据可范围范围在列2-列125, 页1-页6之内。同时列地址指针被设为2, 页地址指针被设为1。在访问数据后, 列地址自动增加1, 以访问下一数据(图中实线)

 

当结束访问终止列地址(125)时, 列地址指针复位到列2, 页地址指针自动增加1(图中实线), 当访问终止页地址6和终止列地址125所在数据后, 页地址指针复位到1, 列地址指针复位到2(图中虚线)

SSD1306指令集

6.设置屏幕起始行(Set Display Start Line)(40h-7Fh)

此命令用于设置屏幕起始行寄存器以设置GDDRAM起始地址, 取值范围为[0, 63]。若值为0, 则RAM第0行映射至COM0, 若值为1, 则RAM第1行映射到COM0, 以此类推。

 

7.设置对比度(Set Contrast Control for BANK0)(81h)

此命令用于设置屏幕对比度。此芯片有256级对比度(从00h至FFh)。段输出电流和对比度值同增同减。

 

8.设置段重映射(Set Segment Re-map)(A0h/A1h)

此指令用于改变屏幕数据列地址和段驱动器间的映射关系, 这增强和OLED模块设计的可伸缩性。

此命令只影响其后的数据输入, 已存储在GDDRAM中的数据将保持不变。

A0:左右反置

A1:正常

 

9.全屏点亮(Entire Display ON)(A4h/A5h)

命令A4h启用输出GDDRAM中的数据

如果命令A5h已被调用, 通过A4h指令, 可以将屏幕显示从全屏点亮状态中恢复

命令A5h通过忽略GDDRAM中的数据以点亮全屏

A5:点亮所有像素

A4:恢复正常模式

 

10.设置正常/反转显示(A6h/A7h)

此命令用于设置显示是否反转, 正常模式下, RAM中的数据1表示点亮像素; 在反转模式下, RAM中的数据0表示点亮像素

A7:反选

A6:正常

 

11.设置复用率(A8h)

此命令用于将默认的63复用率更改至任何范围为[16, 63]的值, COM0~COM64输出将切换到正确的输出信号

 

12.设置屏幕开启/关闭(AEh/AFh)

此指令用于开启或关闭OLED屏幕

当屏幕开启时, 设置主机配置命令(Set Master Configuration)选择的电路将被连通。

当屏幕关闭时, 这些电路将被断开, 且段和公共的输出都被分别置为Vss和高阻态。

此指令设置屏幕状态为以下二者的其中之一:

AE: 关闭屏幕

AF: 开启屏幕

SSD1306指令集

 

13.页地址模式下设置页起始地址

此指令用于设置在页地址模式下GDDRAM的页起始地址, 取值范围为[0, 7]

 

14.设置列输出扫描方向(Set COM Output Scan Direction)(C0h/C8h)

此指令用于设置列输出的扫描方向, 增强了OLED模块设计的布局的伸缩性。

注意, 此指令会立即生效。例如当屏幕正常显示时调用此指令, 屏幕将会立刻垂直翻转。

 

15.设置显示偏移(Set Display Offset)(D3h)

此命令为双字节命令, 第二个字节用于设置屏幕起始行为COM0~COM63之一(假设COM0为屏幕起始行, 那么屏幕起始行寄存器值为0)

例如, 要使COM16向COM0方向移动16行, 第二个字节的值应该为010000b; 向COM0相反方向移动16行, 第二个的值应该为64-16, 即100000b, 下表展示了调用指令C0h/C8h和D3h的例子

SSD1306指令集

SSD1306指令集

SSD1306指令集

SSD1306指令集

SSD1306指令集

16.设置显示时钟分频值/震荡频率(Set Display Clock Divide Ration/Oscillator Frequency)(D5h)

此指令包括两个功能:

  1. 设置显示时钟分频值(D)(A[3:0])

由于设置从CLK分频得到的DCLK(显示时钟, Display clock)的分频值, 分频值取值范围为[1, 16], 初始值为1, (Please refer to Secion 8.3 for more details)

  1. 设置震荡频率(A[7:4])

如果CLS脚被拉高, 可用于编程震荡频率。 默认值为1000b

 

17.设置预充电周期(Set Pre-charge Period)(D9h)

此指令用于设置预充电周期的时长, 此周期单位为一DCLK的周期, 复位值为2 DCLK

 

18.设置列引脚硬件配置(Set COM Pins Hardware Configuration)(DAh)

此指令用于设置列信号引脚配置来适应OLED面板的硬件布局。下表展示了在不同条件下的列引脚配置效果。(图中芯片金手指向上)

 

二、图形加速命令

1.序列的列引脚配置(DAh A[4]=0), 列输出扫描方向从COM0到COM63(C0h), 禁用列左/右映射(DAh A[5]=0)

SSD1306指令集

2.序列的列引脚配置(DAh A[4]=0), 列输出扫描方向从COM0到COM63(C0h), 启用列左/右映射(DAh A[5]=1)

SSD1306指令集

3.序列的列引脚配置(DAh A[4]=0), 列输出扫描方向从COM0到COM63(C8h), 禁用列左/右映射(DAh A[5]=0)

SSD1306指令集

4.序列的列引脚配置(DAh A[4]=0), 列输出扫描方向从COM63到COM0(C8h), 启用列左/右映射(DAh A[5]=1)

SSD1306指令集

5.备选的列引脚配置(DAh A[4]=1), 列输出扫描方向从COM63到COM0(C0h), 禁用列左/右映射(DAh A[5]=0)

SSD1306指令集

6.备选的列引脚配置(DAh A[4]=1), 列输出扫描方向从COM0到COM63(C0h), 启用列左/右映射(DAh A[5]=1)

SSD1306指令集

7.备选的列引脚配置(DAh A[4]=1), 列输出扫描方向从COM63到COM0(C8h), 禁用列左/右映射(DAh A[5]=0)

SSD1306指令集

8.备选的列引脚配置(DAh A[4]=1), 列输出扫描方向从COM63到COM0(C8h), 启用列左/右映射(DAh A[5]=1)

SSD1306指令集

19.设置VCOMH反压值(Set VCOMH Deselect Level)(DBh)

此指令用于调整VCOMH输出

 

20.空指令(NOP)(E3h)

不产生作用的指令

 

21.读取状态寄存器(Status register Read)

在读取数据时将D/C#拉低以调用此指令, MCU可用此指令读取芯片内部状态。

 

图形加速命令

1.水平滚动配置(Horizontal Scroll Setup)(26h/27h)

此指令用于配置水平滚动参数和确定滚动起始页、终止页和滚动速度

水平滚动需要在调用此命令前禁用(2Eh), 否则RAM中的内容将会出错

 

SSD1306的水平滚动设计来为128列滚动, 以下是使用水平滚动的例子

向右滚动一列

SSD1306指令集

向左滚动一列

SSD1306指令集

水平滚动配置例子

SSD1306指令集

2.垂直和水平滚动配置(Continuos Vertical and Horizontal Scroll Setup)(29h/2Ah)

此指令用于配置垂直和水平滚动参数和确定滚动起始页、终止页、滚动速度和垂直滚动偏移

B[2:0], C[2:0], D[2:0]用于配置垂直滚动, E[5:0]用于配置垂直滚动偏移, 所有这些字节用于设置斜线(Diagonal, 垂直滚动+水平滚动)

如果垂直滚动偏移为0, 那么只将发生水平滚动(和命令26/27h一样)

滚动需要在调用此命令前禁用(2Eh), 否则RAM中的内容将会出错

以下是使用垂直和水平滚动的例子:

SSD1306指令集

3.禁用滚动(Deactivate Scroll)(2Eh)

此指令用于停止滚动, 在调用命令2Eh后, RAM的数据需要被重写

 

4.启用滚动(Activate Scroll)(2Fh)

此指令用于启动滚动, 并且只能在滚动配置参数经过调用命令26h/27h/29h/2Ah后调用。最后调用滚动参数命令时的配置将覆盖之间调用过时设置的配置

 

以下操作会在启用滚动后被禁止

-1.对RAM的访问

-2.改变水平滚动配置参数

 

5.设置垂直滚动区(Set Vertical Scroll Area)(A3h)

此指令用于设置垂直滚动区, 对于垂直滚动功能(29/2Ah), 垂直滚动的行数可以大于或小于复用率(MUX ratio)

上一篇：16 SQL Mode


下一篇：使用STM32的CUBEMX库来驱动OLED(128x64)(128x32)(SSD1306)含库U8g2库