Skip to content

Commit bd1f3a1

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 bd1f3a1

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

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

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

133+
> [!TIP]
134+
> Display content might become corrupted for many reasons, including electrical or RF interference. Some people reported
135+
> mixing of multiple devices with a different [SPI mode](/components/spi#spi-modes) on a single bus as a contributing
136+
> factor. While the chip's datasheet suggests that the SSD1306 uses `MODE3`, other (non-ESPHome) drivers successfully
137+
> use `MODE0` for accessing the display. Using `spi_mode: MODE0` might therefore help reduce glitching.
138+
133139
### Configuration variables
134140

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

0 commit comments

Comments
 (0)