SSD1306+tinydraw屏幕更新过慢及无延时无法更新问题咨询

问题背景 #

你当前的代码通过GP17引脚的按键输入，切换SSD1306屏幕上的空心/实心圆，但遇到两个问题：

1. 循环末尾必须加延时，否则屏幕无法更新；
2. 延时过长导致更新延迟高，过短又失效。

你的代码如下：

package main

import (
  "machine"
  "time"
  "image/color"
  
  "tinygo.org/x/drivers/ssd1306"
  "tinygo.org/x/tinydraw"
)

func main() {

  UP := machine.GP17
  UP.Configure(machine.PinConfig{
    Mode: machine.PinInputPullup,
  })

  // configure the display 
  machine.I2C0.Configure(machine.I2CConfig{Frequency: machine.TWI_FREQ_400KHZ, SCL: 1, SDA: 0 })

  display := ssd1306.NewI2C(machine.I2C0)
    display.Configure(ssd1306.Config{Width: 128, Height: 64, Address: ssd1306.Address_128_32, VccState: ssd1306.SWITCHCAPVCC})

 for {
  if UP.Get(){
      display.ClearDisplay()
        tinydraw.Circle(&display, 64, 48, 8, color.RGBA{1, 1, 1, 255})
  }else{
    tinydraw.FilledCircle(&display, 64, 48, 8, color.RGBA{1, 1, 1, 255})
  }
  
    // blip on screen
    display.Display()

    // timer, without time it doens work
    time.Sleep(time.Millisecond * 300)
  }
}

为什么必须加延时？ #

核心原因有两个：

1. I2C通信时序限制：display.Display()是把显存数据通过I2C总线发送到SSD1306，这个过程需要一定时间完成。如果循环太快，前一次的I2C传输还没结束，下一次又发起新的传输，会导致总线冲突，屏幕无法正确接收数据，最终更新失败。
2. 按键机械抖动干扰：按键按下/松开时会有几十毫秒的机械抖动，快速循环会反复读取到高低电平，导致屏幕频繁执行ClearDisplay()和绘制操作，挤占I2C通信的时间窗口，同样会让屏幕无法正常更新。

如何加快屏幕更新速度？ #

1. 优化按键读取：加入软件消抖，减少无效更新 #

不用全局延时，而是跟踪按键状态的稳定时间，只有当状态稳定后才更新屏幕，避免频繁触发绘制和I2C传输。

2. 调高I2C通信速率 #

SSD1306多数支持最高1MHz的I2C速率（默认你用的是400KHz），如果硬件（开发板、排线）支持，可尝试调高，加快数据传输速度。

3. 减少不必要的显存操作 #

只在按键状态变化时才重新绘制，而不是每次循环都执行ClearDisplay()和绘制，减少显存写入和I2C传输的次数。

4. 直接操作显存（替代tinydraw） #

tinydraw是封装好的绘图库，方便但有一定开销。如果追求极致速度，可以直接操作display.Buffer()返回的字节数组（每个字节对应8个像素），手动计算像素位置并修改显存，再调用Display()更新。

优化后的示例代码 #

package main

import (
	"image/color"
	"machine"
	"time"

	"tinygo.org/x/drivers/ssd1306"
	"tinygo.org/x/tinydraw"
)

func main() {
	UP := machine.GP17
	UP.Configure(machine.PinConfig{
		Mode: machine.PinInputPullup,
	})

	// 尝试将I2C速率调高到1MHz（需确认屏幕支持）
	machine.I2C0.Configure(machine.I2CConfig{
		Frequency: 1000000,
		SCL:       1,
		SDA:       0,
	})

	display := ssd1306.NewI2C(machine.I2C0)
	display.Configure(ssd1306.Config{
		Width:     128,
		Height:    64,
		Address:   ssd1306.Address_128_32,
		VccState:  ssd1306.SWITCHCAPVCC,
	})

	// 按键状态跟踪变量
	lastKeyState := true
	stableKeyState := true
	lastStateChangeTime := time.Now()
	const debounceDuration = 50 * time.Millisecond // 50ms消抖时间

	// 初始绘制一次实心圆
	tinydraw.FilledCircle(&display, 64, 48, 8, color.RGBA{1, 1, 1, 255})
	display.Display()

	for {
		currentState := UP.Get()
		now := time.Now()

		// 检测按键状态变化，记录时间
		if currentState != lastKeyState {
			lastStateChangeTime = now
			lastKeyState = currentState
		}

		// 状态稳定超过消抖时间，才更新屏幕
		if now.Sub(lastStateChangeTime) > debounceDuration && currentState != stableKeyState {
			stableKeyState = currentState
			display.ClearDisplay()
			if stableKeyState {
				tinydraw.Circle(&display, 64, 48, 8, color.RGBA{1, 1, 1, 255})
			} else {
				tinydraw.FilledCircle(&display, 64, 48, 8, color.RGBA{1, 1, 1, 255})
			}
			display.Display()
		}

		// 短暂延时，避免CPU空转，同时给I2C留足传输时间
		time.Sleep(10 * time.Millisecond)
	}
}

内容的提问来源于stack exchange，提问作者NoLoop