RISC-V技术论坛
直播中

cszzlsw

10年用户 247经验值
擅长:嵌入式技术
私信 关注
[经验]

【嘉楠堪智K230开发板试用体验】第一弹:迟到的OLED屏幕驱动,巨坑解决

一.前言

首先非常感谢发烧友和01Studio给我机会使用这款强大的K230开发板,作为一名老玩家,几次在逛淘宝的时候都看到过这款板子,有个侄子要学人工智能,给他推荐了,然后我自己想着等他有空了给我寄过来玩,然后还没等到他玩过,我就收到发烧友的使用活动,最后还中了,还是非常的惊喜的.
刚收到板子,就进了玩家交流群,板子还没收到,就看到有群友发布求助信息,说要驱动ssd1306的OLED屏:
image.png
我一看这不是我强项吗,以前用esp32的MicroPython库,几分钟就把oled屏幕搞出来了,这个板子比esp32强大,搞个oled还不是分分钟,结果这一夸下海口不要紧,把我折腾的一点脾气没有

二.首先是开箱,刷系统

这个步骤没得说的,参考官方的文档即可:https://wiki.01studio.cc/docs/category/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA-1,这篇文档讲的比较详细,这里不多说了,卡的话自己找一张以前用过的卡,很快啊,系统就刷好了.

三.找出我的OLED屏,准备玩转

找出OLED屏幕,把之前esp32的驱动文件拿过来,顺利的写到系统中去了,然后发现不对劲,i2c一直也不行,找不到对应的器件,一遍郁闷,一遍骂骂咧咧翻出了许多的i2c器件,结果发现无一例外不行,结果还是在管理员的提示下,用硬件初始化把i2c接口初始化了才行,关键问题是这个语法,在任何一篇文档中都找不到,你说这咋玩,翻了01Studio的文档,压根没有i2c的,再找嘉楠的文档,有i2c的,但是没提要硬件复用的内容:https://www.kendryte.com/k230_canmv/zh/main/zh/api/machine/K230_CanMV_I2C%E6%A8%A1%E5%9D%97API%E6%89%8B%E5%86%8C.html
这个是截图,先留个证据哈哈:
image.png

后来还是在群里厂家工程师的帮助下知道了要这样写:
163cafc8f5eb2b0ae3cc64522a4295a.png

那个6,8,9行就是关键的硬件初始化代码,这里就加上之后i2c就通了.

三,调试OLED库

调试OLED这里用的是SSD1306库,网上找到的,之前的esp32上用的是OK的,这里直接拿来用,先是创建一个ssd1306文件,写上内容:

from micropython import const
import framebuf


# register definitions
SET_CONTRAST = const(0x81)
SET_ENTIRE_ON = const(0xA4)
SET_NORM_INV = const(0xA6)
SET_DISP = const(0xAE)
SET_MEM_ADDR = const(0x20)
SET_COL_ADDR = const(0x21)
SET_PAGE_ADDR = const(0x22)
SET_DISP_START_LINE = const(0x40)
SET_SEG_REMAP = const(0xA0)
SET_MUX_RATIO = const(0xA8)
SET_COM_OUT_DIR = const(0xC0)
SET_DISP_OFFSET = const(0xD3)
SET_COM_PIN_CFG = const(0xDA)
SET_DISP_CLK_DIV = const(0xD5)
SET_PRECHARGE = const(0xD9)
SET_VCOM_DESEL = const(0xDB)
SET_CHARGE_PUMP = const(0x8D)

# Subclassing FrameBuffer provides support for graphics primitives
# http://docs.micropython.org/en/latest/pyboard/library/framebuf.html
class SSD1306(framebuf.FrameBuffer):
    def __init__(self, width, height, external_vcc):
        self.width = width
        self.height = height
        self.external_vcc = external_vcc
        self.pages = self.height // 8
        self.buffer = bytearray(self.pages * self.width)
        super().__init__(self.buffer, self.width, self.height, framebuf.MONO_VLSB)
        self.init_display()

    def init_display(self):
        for cmd in (
            SET_DISP | 0x00,  # off
            # address setting
            SET_MEM_ADDR,
            0x00,  # horizontal
            # resolution and layout
            SET_DISP_START_LINE | 0x00,
            SET_SEG_REMAP | 0x01,  # column addr 127 mapped to SEG0
            SET_MUX_RATIO,
            self.height - 1,
            SET_COM_OUT_DIR | 0x08,  # scan from COM[N] to COM0
            SET_DISP_OFFSET,
            0x00,
            SET_COM_PIN_CFG,
            0x02 if self.width > 2 * self.height else 0x12,
            # timing and driving scheme
            SET_DISP_CLK_DIV,
            0x80,
            SET_PRECHARGE,
            0x22 if self.external_vcc else 0xF1,
            SET_VCOM_DESEL,
            0x30,  # 0.83*Vcc
            # display
            SET_CONTRAST,
            0xFF,  # maximum
            SET_ENTIRE_ON,  # output follows RAM contents
            SET_NORM_INV,  # not inverted
            # charge pump
            SET_CHARGE_PUMP,
            0x10 if self.external_vcc else 0x14,
            SET_DISP | 0x01,
        ):  # on
            self.write_cmd(cmd)
        self.fill(0)
        self.show()

    def poweroff(self):
        self.write_cmd(SET_DISP | 0x00)

    def poweron(self):
        self.write_cmd(SET_DISP | 0x01)

    def contrast(self, contrast):
        self.write_cmd(SET_CONTRAST)
        self.write_cmd(contrast)

    def invert(self, invert):
        self.write_cmd(SET_NORM_INV | (invert & 1))

    def show(self):
        x0 = 0
        x1 = self.width - 1
        if self.width == 64:
            # displays with width of 64 pixels are shifted by 32
            x0 += 32
            x1 += 32
        self.write_cmd(SET_COL_ADDR)
        self.write_cmd(x0)
        self.write_cmd(x1)
        self.write_cmd(SET_PAGE_ADDR)
        self.write_cmd(0)
        self.write_cmd(self.pages - 1)
        self.write_data(self.buffer)


class SSD1306_I2C(SSD1306):
    def __init__(self, width, height, i2c, addr=0x3C, external_vcc=False):
        self.i2c = i2c
        self.addr = addr
        self.temp = bytearray(2)
        self.write_list = [b"\x40", None]  # Co=0, D/C#=1
        super().__init__(width, height, external_vcc)

    def write_cmd(self, cmd):
        self.temp[0] = 0x80  # Co=1, D/C#=0
        self.temp[1] = cmd
        self.i2c.writeto(self.addr, self.temp)

    def write_data(self, buf):
        self.write_list[1] = buf
        self.i2c.writevto(self.addr, self.write_list)


class SSD1306_SPI(SSD1306):
    def __init__(self, width, height, spi, dc, res, cs, external_vcc=False):
        self.rate = 10 * 1024 * 1024
        dc.init(dc.OUT, value=0)
        res.init(res.OUT, value=0)
        cs.init(cs.OUT, value=1)
        self.spi = spi
        self.dc = dc
        self.res = res
        self.cs = cs
        import time

        self.res(1)
        time.sleep_ms(1)
        self.res(0)
        time.sleep_ms(10)
        self.res(1)
        super().__init__(width, height, external_vcc)

    def write_cmd(self, cmd):
        self.spi.init(baudrate=self.rate, polarity=0, phase=0)
        self.cs(1)
        self.dc(0)
        self.cs(0)
        self.spi.write(bytearray([cmd]))
        self.cs(1)

    def write_data(self, buf):
        self.spi.init(baudrate=self.rate, polarity=0, phase=0)
        self.cs(1)
        self.dc(1)
        self.cs(0)
        self.spi.write(buf)
        self.cs(1)

然后就是在主文件里使用这个库:

import ssd1306 as ssd1306
from machine import I2C
import machine

fpioa = machine.FPIOA()
fpioa.set_function(11, machine.FPIOA.IIC2_SCL)
fpioa.set_function(12, machine.FPIOA.IIC2_SDA)

i2c2 = I2C(2,scl=11, sda=12,freq=400000)
oled = ssd1306.SSD1306_I2C(128,64,i2c2)
oled.init_display()
oled.poweron()

oled.fill(0)
oled.text("smart lock",20,0,0xffff)
oled.hline(0, 9, 128, 0xffff)
oled.text("hello world",0,10,0xffff)
oled.show()

然后调试出来是这个界面:
f9624e1a3c6518360119246bf628bbf.jpg

就这个状态一直也不好,调试了好久也不见好,然后就出差了,结果今天在调试的时候发现可能是这个i2c.writevto这个函数有问题,因为可以看到write_list的结构是这样:
image.png
是数组套数组,但是之前在esp32上就是这么玩的,可以是esp32的底层库写的更灵活吧,咱们这个板子还解析不了这种数据.
所以花了点时间把代码改了一下:

def write_data(self, buf):
        self.write_list[1] = buf

        new_ba = bytearray([0x40]) + buf

        self.i2c.writevto(self.addr, [new_ba])

然后就神奇的好了,看看效果:
2bab972ba07b65f7fc350c86b6ea4c6.jpg

就这样,OLED就可以玩转起来了,大家也可以用这个方法试试.

四.总结

本次OLED屏幕驱动体验结束,总结一下:官方的文档还需完善一下,尤其这个硬件引脚服用的问题,如果不是有官方人员帮忙,纯靠自己应该是搞不定的.
其次是对接驱动时候,还是要仔细查看代码,MicroPython是抽象的库,每家的实现不一样,还是不能够直接生搬硬套.
好嘞,本篇就先到这啦,祝大家都能成功.

更多回帖

发帖
×
20
完善资料,
赚取积分