Skip to content

Commit e098c33

Browse files
committed
[ssd1306] suggest a different SPI mode to reduce visual glitching
I'm not a huge fan of these weasel words, but I have seen visual glitches on this display when combined with other SPI devices (see esphome/esphome#13683). On Discord, people have suggested experimenting with a different SPI mode, and indeed, that solved the problem for me. I am not suggesting to change this chip's SPI mode (the picture in the datasheet is not 100% correct, but there are strong hints that mode3 is the intended mode). At the same time, other implementations like the Adafruit one use mode 0 successfully. So, at a suggestion of @swoboda1337, let's at least document these findings.
1 parent d9dedb0 commit e098c33

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

src/content/docs/components/display/ssd1306.mdx

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,11 @@ display:
130130
it.print(0, 0, id(font), "Hello World!");
131131
```
132132

133+
Under certain scenarios, the display content might become corrupted. It was suggested that presence of other SPI devices
134+
using a different [SPI mode](/components/spi#spi-modes) might contribute to the corruption. While the chip's datasheet
135+
suggests that the SSD1306 uses `MODE3`, other (non-esphome) drivers successfully use `MODE0` for accessing the display.
136+
Some users reported that adding a manual `spi_mode: MODE0` helps reduce glitching.
137+
133138
### Configuration variables
134139

135140
- **model** (**Required**): The model of the display. Options are:

0 commit comments

Comments
 (0)